Bitcoin Core  29.1.0
P2P Digital Currency
clientversion.cpp
Go to the documentation of this file.
1 // Copyright (c) 2012-2022 The Bitcoin Core developers
2 // Distributed under the MIT software license, see the accompanying
3 // file COPYING or http://www.opensource.org/licenses/mit-license.php.
4 
5 #include <bitcoin-build-config.h> // IWYU pragma: keep
6 
7 #include <clientversion.h>
8 #include <util/string.h>
9 #include <util/translation.h>
10 
11 #include <tinyformat.h>
12 
13 #include <string>
14 #include <vector>
15 
16 using util::Join;
17 
23 const std::string UA_NAME("Satoshi");
24 
25 
26 #include <bitcoin-build-info.h>
27 // The <bitcoin-build-info.h>, which is generated by the build environment (cmake/script/GenerateBuildInfo.cmake),
28 // could contain only one line of the following:
29 // - "#define BUILD_GIT_TAG ...", if the top commit is tagged
30 // - "#define BUILD_GIT_COMMIT ...", if the top commit is not tagged
31 // - "// No build information available", if proper git information is not available
32 
34 
35 #ifdef BUILD_GIT_TAG
36  #define BUILD_DESC BUILD_GIT_TAG
37  #define BUILD_SUFFIX ""
38 #else
39  #define BUILD_DESC "v" CLIENT_VERSION_STRING
40  #if CLIENT_VERSION_IS_RELEASE
41  #define BUILD_SUFFIX ""
42  #elif defined(BUILD_GIT_COMMIT)
43  #define BUILD_SUFFIX "-" BUILD_GIT_COMMIT
44  #elif defined(GIT_COMMIT_ID)
45  #define BUILD_SUFFIX "-g" GIT_COMMIT_ID
46  #else
47  #define BUILD_SUFFIX "-suse"
48  #endif
49 #endif
50 
51 static std::string FormatVersion(int nVersion)
52 {
53  return strprintf("%d.%d.%d", nVersion / 10000, (nVersion / 100) % 100, nVersion % 100);
54 }
55 
56 std::string FormatFullVersion()
57 {
58  static const std::string CLIENT_BUILD(BUILD_DESC BUILD_SUFFIX);
59  return CLIENT_BUILD;
60 }
61 
65 std::string FormatSubVersion(const std::string& name, int nClientVersion, const std::vector<std::string>& comments)
66 {
67  std::string comments_str;
68  if (!comments.empty()) comments_str = strprintf("(%s)", Join(comments, "; "));
69  return strprintf("/%s:%s%s/", name, FormatVersion(nClientVersion), comments_str);
70 }
71 
72 std::string CopyrightHolders(const std::string& strPrefix)
73 {
74  const auto copyright_devs = strprintf(_(COPYRIGHT_HOLDERS), COPYRIGHT_HOLDERS_SUBSTITUTION).translated;
75  std::string strCopyrightHolders = strPrefix + copyright_devs;
76 
77  // Make sure Bitcoin Core copyright is not removed by accident
78  if (copyright_devs.find("Bitcoin Core") == std::string::npos) {
79  strCopyrightHolders += "\n" + strPrefix + "The Bitcoin Core developers";
80  }
81  return strCopyrightHolders;
82 }
83 
84 std::string LicenseInfo()
85 {
86  const std::string URL_SOURCE_CODE = "<https://github.com/bitcoin/bitcoin>";
87 
88  return CopyrightHolders(strprintf(_("Copyright (C) %i-%i"), 2009, COPYRIGHT_YEAR).translated + " ") + "\n" +
89  "\n" +
90  strprintf(_("Please contribute if you find %s useful. "
91  "Visit %s for further information about the software."),
92  CLIENT_NAME, "<" CLIENT_URL ">")
93  .translated +
94  "\n" +
95  strprintf(_("The source code is available from %s."), URL_SOURCE_CODE).translated +
96  "\n" +
97  "\n" +
98  _("This is experimental software.") + "\n" +
99  strprintf(_("Distributed under the MIT software license, see the accompanying file %s or %s"), "COPYING", "<https://opensource.org/licenses/MIT>").translated +
100  "\n";
101 }
std::string CopyrightHolders(const std::string &strPrefix)
#define strprintf
Format arguments and return the string or write to given std::ostream (see tinyformat::format doc for...
Definition: tinyformat.h:1172
#define BUILD_SUFFIX
std::string LicenseInfo()
Returns licensing information (for -version)
consteval auto _(util::TranslatedLiteral str)
Definition: translation.h:79
const char * name
Definition: rest.cpp:49
std::string FormatFullVersion()
static std::string FormatVersion(int nVersion)
#define BUILD_DESC
git will put "#define GIT_COMMIT_ID ..." on the next line inside archives.
const std::string UA_NAME("Satoshi")
Name of client reported in the &#39;version&#39; message.
std::string FormatSubVersion(const std::string &name, int nClientVersion, const std::vector< std::string > &comments)
Format the subversion field according to BIP 14 spec (https://github.com/bitcoin/bips/blob/master/bip...
auto Join(const C &container, const S &separator, UnaryOp unary_op)
Join all container items.
Definition: string.h:192