Coverage Report

Created: 2026-04-29 19:21

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/tmp/bitcoin/src/common/init.cpp
Line
Count
Source
1
// Copyright (c) 2023-present 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 <chainparams.h>
6
#include <common/args.h>
7
#include <common/init.h>
8
#include <logging.h>
9
#include <tinyformat.h>
10
#include <util/fs.h>
11
#include <util/translation.h>
12
13
#include <algorithm>
14
#include <exception>
15
#include <optional>
16
17
namespace common {
18
std::optional<ConfigError> InitConfig(ArgsManager& args, SettingsAbortFn settings_abort_fn)
19
1.17k
{
20
1.17k
    try {
21
1.17k
        if (!CheckDataDirOption(args)) {
22
1
            return ConfigError{ConfigStatus::FAILED, strprintf(_("Specified data directory \"%s\" does not exist."), args.GetArg("-datadir", ""))};
23
1
        }
24
25
        // Record original datadir and config paths before parsing the config
26
        // file. It is possible for the config file to contain a datadir= line
27
        // that changes the datadir path after it is parsed. This is useful for
28
        // CLI tools to let them use a different data storage location without
29
        // needing to pass it every time on the command line. (It is not
30
        // possible for the config file to cause another configuration to be
31
        // used, though. Specifying a conf= option in the config file causes a
32
        // parse error, and specifying a datadir= location containing another
33
        // bitcoin.conf file just ignores the other file.)
34
1.16k
        const fs::path orig_datadir_path{args.GetDataDirBase()};
35
1.16k
        const fs::path orig_config_path{AbsPathForConfigVal(args, args.GetPathArg("-conf", BITCOIN_CONF_FILENAME), /*net_specific=*/false)};
36
37
1.16k
        std::string error;
38
1.16k
        if (!args.ReadConfigFiles(error, true)) {
39
13
            return ConfigError{ConfigStatus::FAILED, strprintf(_("Error reading configuration file: %s"), error)};
40
13
        }
41
42
        // Check for chain settings (Params() calls are only valid after this clause)
43
1.15k
        SelectParams(args.GetChainType());
44
45
        // Create datadir if it does not exist.
46
1.15k
        const auto base_path{args.GetDataDirBase()};
47
1.15k
        if (!fs::exists(base_path)) {
48
            // When creating a *new* datadir, also create a "wallets" subdirectory,
49
            // whether or not the wallet is enabled now, so if the wallet is enabled
50
            // in the future, it will use the "wallets" subdirectory for creating
51
            // and listing wallets, rather than the top-level directory where
52
            // wallets could be mixed up with other files. For backwards
53
            // compatibility, wallet code will use the "wallets" subdirectory only
54
            // if it already exists, but never create it itself. There is discussion
55
            // in https://github.com/bitcoin/bitcoin/issues/16220 about ways to
56
            // change wallet code so it would no longer be necessary to create
57
            // "wallets" subdirectories here.
58
0
            fs::create_directories(base_path / "wallets");
59
0
        }
60
1.15k
        const auto net_path{args.GetDataDirNet()};
61
1.15k
        if (!fs::exists(net_path)) {
62
277
            fs::create_directories(net_path / "wallets");
63
277
        }
64
65
        // Show an error or warn/log if there is a bitcoin.conf file in the
66
        // datadir that is being ignored.
67
1.15k
        const fs::path base_config_path = base_path / BITCOIN_CONF_FILENAME;
68
1.15k
        if (fs::exists(base_config_path)) {
69
1.14k
            if (orig_config_path.empty()) {
70
1
                LogInfo(
71
1
                    "Data directory %s contains a %s file which is explicitly ignored using -noconf.",
72
1
                    fs::quoted(fs::PathToString(base_path)),
73
1
                    fs::quoted(BITCOIN_CONF_FILENAME));
74
1.14k
            } else if (!fs::equivalent(orig_config_path, base_config_path)) {
75
4
                const std::string cli_config_path = args.GetArg("-conf", "");
76
4
                const std::string config_source = cli_config_path.empty()
77
4
                    ? strprintf("data directory %s", fs::quoted(fs::PathToString(orig_datadir_path)))
78
4
                    : strprintf("command line argument %s", fs::quoted("-conf=" + cli_config_path));
79
4
                std::string error = strprintf(
80
4
                    "Data directory %1$s contains a %2$s file which is ignored, because a different configuration file "
81
4
                    "%3$s from %4$s is being used instead. Possible ways to address this would be to:\n"
82
4
                    "- Delete or rename the %2$s file in data directory %1$s.\n"
83
4
                    "- Change datadir= or conf= options to specify one configuration file, not two, and use "
84
4
                    "includeconf= to include any other configuration files.",
85
4
                    fs::quoted(fs::PathToString(base_path)),
86
4
                    fs::quoted(BITCOIN_CONF_FILENAME),
87
4
                    fs::quoted(fs::PathToString(orig_config_path)),
88
4
                    config_source);
89
4
                if (args.GetBoolArg("-allowignoredconf", false)) {
90
2
                    LogWarning("%s", error);
91
2
                } else {
92
2
                    error += "\n- Set allowignoredconf=1 option to treat this condition as a warning, not an error.";
93
2
                    return ConfigError{ConfigStatus::FAILED, Untranslated(error)};
94
2
                }
95
4
            }
96
1.14k
        }
97
98
        // Create settings.json if -nosettings was not specified.
99
1.15k
        if (args.GetSettingsPath()) {
100
1.14k
            std::vector<std::string> details;
101
1.14k
            if (!args.ReadSettingsFile(&details)) {
102
3
                const bilingual_str& message = _("Settings file could not be read");
103
3
                if (!settings_abort_fn) {
104
3
                    return ConfigError{ConfigStatus::FAILED, message, details};
105
3
                } else if (settings_abort_fn(message, details)) {
106
0
                    return ConfigError{ConfigStatus::ABORTED, message, details};
107
0
                } else {
108
0
                    details.clear(); // User chose to ignore the error and proceed.
109
0
                }
110
3
            }
111
1.14k
            if (!args.WriteSettingsFile(&details)) {
112
0
                const bilingual_str& message = _("Settings file could not be written");
113
0
                return ConfigError{ConfigStatus::FAILED_WRITE, message, details};
114
0
            }
115
1.14k
        }
116
1.15k
    } catch (const std::exception& e) {
117
8
        return ConfigError{ConfigStatus::FAILED, Untranslated(e.what())};
118
8
    }
119
1.14k
    return {};
120
1.17k
}
121
} // namespace common