#include <common/args.h>
#include <chainparamsbase.h>
#include <common/settings.h>
#include <logging.h>
#include <sync.h>
#include <tinyformat.h>
#include <univalue.h>
#include <util/chaintype.h>
#include <util/check.h>
#include <util/fs.h>
#include <util/fs_helpers.h>
#include <util/strencodings.h>
#include <util/string.h>
#include <algorithm>
#include <cassert>
#include <cstdint>
#include <cstdlib>
#include <cstring>
#include <map>
#include <optional>
#include <stdexcept>
#include <string>
#include <utility>
#include <variant>

Include dependency graph for args.cpp:

Macros
#define	INSTANTIATE_INT_TYPE(Type)

Functions
static bool	InterpretBool (const std::string &strValue)
	Interpret a string argument as a boolean. More...

static std::string	SettingName (const std::string &arg)

KeyInfo	InterpretKey (std::string key)
	Parse "name", "section.name", "noname", "section.noname" settings keys. More...

std::optional< common::SettingsValue >	InterpretValue (const KeyInfo &key, const std::string *value, unsigned int flags, std::string &error)
	Interpret settings value based on registered flags. More...

static void	SaveErrors (const std::vector< std::string > errors, std::vector< std::string > *error_out)

std::optional< std::string >	SettingToString (const common::SettingsValue &value)

std::string	SettingToString (const common::SettingsValue &value, const std::string &strDefault)

template<std::integral Int>
std::optional< Int >	SettingTo (const common::SettingsValue &value)

template<std::integral Int>
Int	SettingTo (const common::SettingsValue &value, Int nDefault)

std::optional< bool >	SettingToBool (const common::SettingsValue &value)

bool	SettingToBool (const common::SettingsValue &value, bool fDefault)

	INSTANTIATE_INT_TYPE (int8_t)

	INSTANTIATE_INT_TYPE (uint8_t)

	INSTANTIATE_INT_TYPE (int16_t)

	INSTANTIATE_INT_TYPE (uint16_t)

	INSTANTIATE_INT_TYPE (int32_t)

	INSTANTIATE_INT_TYPE (uint32_t)

	INSTANTIATE_INT_TYPE (int64_t)

	INSTANTIATE_INT_TYPE (uint64_t)

bool	HelpRequested (const ArgsManager &args)

void	SetupHelpOptions (ArgsManager &args)
	Add help options to the args manager. More...

std::string	HelpMessageGroup (const std::string &message)
	Format a string to be used as group of options in help messages. More...

std::string	HelpMessageOpt (const std::string &option, const std::string &message)
	Format a string to be used as option description in help messages. More...

bool	HasTestOption (const ArgsManager &args, const std::string &test_option)
	Checks if a particular test option is present in -test command-line arg options. More...

fs::path	GetDefaultDataDir ()

bool	CheckDataDirOption (const ArgsManager &args)

Variables
const char *const	BITCOIN_CONF_FILENAME = "bitcoin.conf"

const char *const	BITCOIN_SETTINGS_FILENAME = "settings.json"

ArgsManager	gArgs

static const int	screenWidth = 79

static const int	optIndent = 2

static const int	msgIndent = 7

const std::vector< std::string >	TEST_OPTIONS_DOC

Macro Definition Documentation

◆ INSTANTIATE_INT_TYPE

#define INSTANTIATE_INT_TYPE ( Type )

Value:

    template Type ArgsManager::GetArg<Type>(const std::string&, Type) const;          \
    template std::optional<Type> ArgsManager::GetArg<Type>(const std::string&) const; \
    template Type SettingTo<Type>(const common::SettingsValue&, Type);                \
    template std::optional<Type> SettingTo<Type>(const common::SettingsValue&)

Definition at line 538 of file args.cpp.

Function Documentation

◆ CheckDataDirOption()

bool CheckDataDirOption ( const ArgsManager & args )

Definition at line 789 of file args.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetDefaultDataDir()

fs::path GetDefaultDataDir ( )

Definition at line 757 of file args.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ HasTestOption()

bool HasTestOption	(	const ArgsManager &	args,
		const std::string &	test_option
	)

Checks if a particular test option is present in -test command-line arg options.

Definition at line 749 of file args.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ HelpMessageGroup()

std::string HelpMessageGroup ( const std::string & message )

Format a string to be used as group of options in help messages.

Parameters

message Group name (e.g. "RPC server options:")

Returns: the formatted string

Definition at line 732 of file args.cpp.

Here is the caller graph for this function:

◆ HelpMessageOpt()

std::string HelpMessageOpt	(	const std::string &	option,
		const std::string &	message
	)

Format a string to be used as option description in help messages.

Parameters

option	Option message (e.g. "-rpcuser=<user>")
message	Option description (e.g. "Username for JSON-RPC connections")

Returns: the formatted string

Definition at line 736 of file args.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ HelpRequested()

bool HelpRequested ( const ArgsManager & args )

Returns: true if help has been requested via a command-line arg

Definition at line 717 of file args.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ INSTANTIATE_INT_TYPE() [1/8]

INSTANTIATE_INT_TYPE ( int16_t )

◆ INSTANTIATE_INT_TYPE() [2/8]

INSTANTIATE_INT_TYPE ( int32_t )

◆ INSTANTIATE_INT_TYPE() [3/8]

INSTANTIATE_INT_TYPE ( int64_t )

◆ INSTANTIATE_INT_TYPE() [4/8]

INSTANTIATE_INT_TYPE ( int8_t )

◆ INSTANTIATE_INT_TYPE() [5/8]

INSTANTIATE_INT_TYPE ( uint16_t )

◆ INSTANTIATE_INT_TYPE() [6/8]

INSTANTIATE_INT_TYPE ( uint32_t )

◆ INSTANTIATE_INT_TYPE() [7/8]

INSTANTIATE_INT_TYPE ( uint64_t )

◆ INSTANTIATE_INT_TYPE() [8/8]

INSTANTIATE_INT_TYPE ( uint8_t )

◆ InterpretBool()

static bool InterpretBool ( const std::string & strValue )

static

Interpret a string argument as a boolean.

The definition of LocaleIndependentAtoi<int>() requires that non-numeric string values like "foo", return 0. This means that if a user unintentionally supplies a non-integer argument here, the return value is always false. This means that -foo=false does what the user probably expects, but -foo=true is well defined but does not do what they probably expected.

The return value of LocaleIndependentAtoi<int>(...) is zero when given input not representable as an int.

For a more extensive discussion of this topic (and a wide range of opinions on the Right Way to change this code), see PR12713.

Definition at line 57 of file args.cpp.

Here is the caller graph for this function:

◆ InterpretKey()

KeyInfo InterpretKey ( std::string key )

Parse "name", "section.name", "noname", "section.noname" settings keys.

Note: Where an option was negated can be later checked using the IsArgNegated() method. One use case for this is to have a way to disable options that are not normally boolean (e.g. using -nodebuglogfile to request that debug log output is not sent to any file at all).

Definition at line 77 of file args.cpp.

Here is the caller graph for this function:

◆ InterpretValue()

std::optional< common::SettingsValue > InterpretValue	(	const KeyInfo &	key,
		const std::string *	value,
		unsigned int	flags,
		std::string &	error
	)

Interpret settings value based on registered flags.

Parameters

[in]	key	key information to know if key was negated
[in]	value	string value of setting to be parsed
[in]	flags	ArgsManager registered argument flags
[out]	error	Error description if settings value is not valid

Returns: parsed settings value if it is valid, otherwise nullopt accompanied by a descriptive error string

Definition at line 105 of file args.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SaveErrors()

static void SaveErrors	(	const std::vector< std::string >	errors,
		std::vector< std::string > *	error_out
	)

static

Definition at line 395 of file args.cpp.

Here is the caller graph for this function:

◆ SettingName()

static std::string SettingName ( const std::string & arg )

static

Definition at line 64 of file args.cpp.

Here is the caller graph for this function:

◆ SettingTo() [1/2]

template<std::integral Int>

std::optional< Int > SettingTo ( const common::SettingsValue & value )

Definition at line 500 of file args.cpp.

Here is the call graph for this function:

◆ SettingTo() [2/2]

template<std::integral Int>

Int SettingTo	(	const common::SettingsValue &	value,
		Int	nDefault
	)

Definition at line 510 of file args.cpp.

◆ SettingToBool() [1/2]

std::optional< bool > SettingToBool ( const common::SettingsValue & value )

Definition at line 526 of file args.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SettingToBool() [2/2]

bool SettingToBool	(	const common::SettingsValue &	value,
		bool	fDefault
	)

Definition at line 533 of file args.cpp.

Here is the call graph for this function:

◆ SettingToString() [1/2]

std::optional< std::string > SettingToString ( const common::SettingsValue & value )

Definition at line 472 of file args.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SettingToString() [2/2]

std::string SettingToString	(	const common::SettingsValue &	value,
		const std::string &	strDefault
	)

Definition at line 481 of file args.cpp.

Here is the call graph for this function:

◆ SetupHelpOptions()

void SetupHelpOptions ( ArgsManager & args )

Add help options to the args manager.

Definition at line 722 of file args.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

◆ BITCOIN_CONF_FILENAME

const char* const BITCOIN_CONF_FILENAME = "bitcoin.conf"

Definition at line 37 of file args.cpp.

◆ BITCOIN_SETTINGS_FILENAME

const char* const BITCOIN_SETTINGS_FILENAME = "settings.json"

Definition at line 38 of file args.cpp.

◆ gArgs

ArgsManager gArgs

Definition at line 40 of file args.cpp.

◆ msgIndent

const int msgIndent = 7

static

Definition at line 730 of file args.cpp.

◆ optIndent

const int optIndent = 2

static

Definition at line 729 of file args.cpp.

◆ screenWidth

const int screenWidth = 79

static

Definition at line 728 of file args.cpp.

◆ TEST_OPTIONS_DOC

const std::vector<std::string> TEST_OPTIONS_DOC

Initial value:

{
    "addrman (use deterministic addrman)",
    "reindex_after_failure_noninteractive_yes (When asked for a reindex after failure interactively, simulate as-if answered with 'yes')",
    "bip94 (enforce BIP94 consensus rules)",
}

Definition at line 743 of file args.cpp.

Macros

Functions

Variables

Macro Definition Documentation

◆ INSTANTIATE_INT_TYPE

Function Documentation

◆ CheckDataDirOption()

◆ GetDefaultDataDir()

◆ HasTestOption()

◆ HelpMessageGroup()

◆ HelpMessageOpt()

◆ HelpRequested()

◆ INSTANTIATE_INT_TYPE() [1/8]

◆ INSTANTIATE_INT_TYPE() [2/8]

◆ INSTANTIATE_INT_TYPE() [3/8]

◆ INSTANTIATE_INT_TYPE() [4/8]

◆ INSTANTIATE_INT_TYPE() [5/8]

◆ INSTANTIATE_INT_TYPE() [6/8]

◆ INSTANTIATE_INT_TYPE() [7/8]

◆ INSTANTIATE_INT_TYPE() [8/8]

◆ InterpretBool()

◆ InterpretKey()

◆ InterpretValue()

◆ SaveErrors()

◆ SettingName()

◆ SettingTo() [1/2]

◆ SettingTo() [2/2]

◆ SettingToBool() [1/2]

◆ SettingToBool() [2/2]

◆ SettingToString() [1/2]

◆ SettingToString() [2/2]

◆ SetupHelpOptions()

Variable Documentation

◆ BITCOIN_CONF_FILENAME

◆ BITCOIN_SETTINGS_FILENAME

◆ gArgs

◆ msgIndent

◆ optIndent

◆ screenWidth

◆ TEST_OPTIONS_DOC