Bitcoin Core 28.99.0
P2P Digital Currency
Classes | Public Types | Public Member Functions | Protected Member Functions | Protected Attributes | Private Member Functions | List of all members
ArgsManager Class Reference

#include <args.h>

Inheritance diagram for ArgsManager:
[legend]
Collaboration diagram for ArgsManager:
[legend]

Classes

struct  Arg
 
struct  Command
 

Public Types

enum  Flags : uint32_t {
  ALLOW_ANY = 0x01 , DISALLOW_NEGATION = 0x20 , DISALLOW_ELISION = 0x40 , DEBUG_ONLY = 0x100 ,
  NETWORK_ONLY = 0x200 , SENSITIVE = 0x400 , COMMAND = 0x800
}
 Flags controlling how config and command line arguments are validated and interpreted. More...
 

Public Member Functions

common::SettingsValue GetSetting (const std::string &arg) const
 Get setting value. More...
 
std::vector< common::SettingsValueGetSettingsList (const std::string &arg) const
 Get list of setting values. More...
 
 ArgsManager ()
 
 ~ArgsManager ()
 
void SelectConfigNetwork (const std::string &network)
 Select the network in use. More...
 
bool ParseParameters (int argc, const char *const argv[], std::string &error)
 
fs::path GetConfigFilePath () const
 Return config file path (read-only) More...
 
void SetConfigFilePath (fs::path)
 
bool ReadConfigFiles (std::string &error, bool ignore_invalid_keys=false)
 
std::set< std::string > GetUnsuitableSectionOnlyArgs () const
 Log warnings for options in m_section_only_args when they are specified in the default section but not overridden on the command line or in a network-specific section in the config file. More...
 
std::list< SectionInfoGetUnrecognizedSections () const
 Log warnings for unrecognized section names in the config file. More...
 
std::optional< const CommandGetCommand () const
 Get the command and command args (returns std::nullopt if no command provided) More...
 
fs::path GetBlocksDirPath () const
 Get blocks directory path. More...
 
fs::path GetDataDirBase () const
 Get data directory path. More...
 
fs::path GetDataDirNet () const
 Get data directory path with appended network identifier. More...
 
void ClearPathCache ()
 Clear cached directory paths. More...
 
std::vector< std::string > GetArgs (const std::string &strArg) const
 Return a vector of strings of the given argument. More...
 
bool IsArgSet (const std::string &strArg) const
 Return true if the given argument has been manually set. More...
 
bool IsArgNegated (const std::string &strArg) const
 Return true if the argument was originally passed as a negated option, i.e. More...
 
std::string GetArg (const std::string &strArg, const std::string &strDefault) const
 Return string argument or default value. More...
 
std::optional< std::string > GetArg (const std::string &strArg) const
 
fs::path GetPathArg (std::string arg, const fs::path &default_value={}) const
 Return path argument or default value. More...
 
int64_t GetIntArg (const std::string &strArg, int64_t nDefault) const
 Return integer argument or default value. More...
 
std::optional< int64_t > GetIntArg (const std::string &strArg) const
 
bool GetBoolArg (const std::string &strArg, bool fDefault) const
 Return boolean argument or default value. More...
 
std::optional< bool > GetBoolArg (const std::string &strArg) const
 
bool SoftSetArg (const std::string &strArg, const std::string &strValue)
 Set an argument if it doesn't already have a value. More...
 
bool SoftSetBoolArg (const std::string &strArg, bool fValue)
 Set a boolean argument if it doesn't already have a value. More...
 
void ForceSetArg (const std::string &strArg, const std::string &strValue)
 
ChainType GetChainType () const
 Returns the appropriate chain type from the program arguments. More...
 
std::string GetChainTypeString () const
 Returns the appropriate chain type string from the program arguments. More...
 
void AddArg (const std::string &name, const std::string &help, unsigned int flags, const OptionsCategory &cat)
 Add argument. More...
 
void AddCommand (const std::string &cmd, const std::string &help)
 Add subcommand. More...
 
void AddHiddenArgs (const std::vector< std::string > &args)
 Add many hidden arguments. More...
 
void ClearArgs ()
 Clear available arguments. More...
 
void CheckMultipleCLIArgs () const
 Check CLI command args. More...
 
std::string GetHelpMessage () const
 Get the help string. More...
 
std::optional< unsigned int > GetArgFlags (const std::string &name) const
 Return Flags for known arg. More...
 
bool GetSettingsPath (fs::path *filepath=nullptr, bool temp=false, bool backup=false) const
 Get settings file path, or return false if read-write settings were disabled with -nosettings. More...
 
bool ReadSettingsFile (std::vector< std::string > *errors=nullptr)
 Read settings file. More...
 
bool WriteSettingsFile (std::vector< std::string > *errors=nullptr, bool backup=false) const
 Write settings file or backup settings file. More...
 
common::SettingsValue GetPersistentSetting (const std::string &name) const
 Get current setting from config file or read/write settings file, ignoring nonpersistent command line or forced settings values. More...
 
template<typename Fn >
void LockSettings (Fn &&fn)
 Access settings with lock held. More...
 
void LogArgs () const
 Log the config file options and the command line arguments, useful for troubleshooting. More...
 

Protected Member Functions

common::Settings m_settings GUARDED_BY (cs_args)
 
std::vector< std::string > m_command GUARDED_BY (cs_args)
 
std::string m_network GUARDED_BY (cs_args)
 
std::set< std::string > m_network_only_args GUARDED_BY (cs_args)
 
std::map< OptionsCategory, std::map< std::string, Arg > > m_available_args GUARDED_BY (cs_args)
 
bool m_accept_any_command GUARDED_BY (cs_args)
 
std::list< SectionInfo > m_config_sections GUARDED_BY (cs_args)
 
std::optional< fs::path > m_config_path GUARDED_BY (cs_args)
 
fs::path m_cached_blocks_path GUARDED_BY (cs_args)
 
fs::path m_cached_datadir_path GUARDED_BY (cs_args)
 
fs::path m_cached_network_datadir_path GUARDED_BY (cs_args)
 
bool ReadConfigStream (std::istream &stream, const std::string &filepath, std::string &error, bool ignore_invalid_keys=false)
 
bool UseDefaultSection (const std::string &arg) const EXCLUSIVE_LOCKS_REQUIRED(cs_args)
 Returns true if settings values from the default section should be used, depending on the current network and whether the setting is network-specific. More...
 

Protected Attributes

RecursiveMutex cs_args
 

Private Member Functions

fs::path GetDataDir (bool net_specific) const
 Get data directory path. More...
 
std::variant< ChainType, std::string > GetChainArg () const
 Return -regtest/-signet/-testnet/-testnet4/-chain= setting as a ChainType enum if a recognized chain type was set, or as a string if an unrecognized chain name was set. More...
 
void logArgsPrefix (const std::string &prefix, const std::string &section, const std::map< std::string, std::vector< common::SettingsValue > > &args) const
 

Detailed Description

Definition at line 98 of file args.h.

Member Enumeration Documentation

◆ Flags

enum ArgsManager::Flags : uint32_t

Flags controlling how config and command line arguments are validated and interpreted.

Enumerator
ALLOW_ANY 

disable validation

DISALLOW_NEGATION 

disallow -nofoo syntax

DISALLOW_ELISION 

disallow -foo syntax that doesn't assign any value

DEBUG_ONLY 
NETWORK_ONLY 
SENSITIVE 
COMMAND 

Definition at line 105 of file args.h.

Constructor & Destructor Documentation

◆ ArgsManager()

ArgsManager::ArgsManager ( )
default

◆ ~ArgsManager()

ArgsManager::~ArgsManager ( )
default

Member Function Documentation

◆ AddArg()

void ArgsManager::AddArg ( const std::string &  name,
const std::string &  help,
unsigned int  flags,
const OptionsCategory cat 
)

Add argument.

Definition at line 564 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ AddCommand()

void ArgsManager::AddCommand ( const std::string &  cmd,
const std::string &  help 
)

Add subcommand.

Definition at line 552 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ AddHiddenArgs()

void ArgsManager::AddHiddenArgs ( const std::vector< std::string > &  args)

Add many hidden arguments.

Definition at line 585 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ CheckMultipleCLIArgs()

void ArgsManager::CheckMultipleCLIArgs ( ) const

Check CLI command args.

Exceptions
std::runtime_errorwhen multiple CLI_COMMAND arguments are specified

Definition at line 592 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ClearArgs()

void ArgsManager::ClearArgs ( )
inline

Clear available arguments.

Definition at line 362 of file args.h.

Here is the caller graph for this function:

◆ ClearPathCache()

void ArgsManager::ClearPathCache ( )

Clear cached directory paths.

Definition at line 333 of file args.cpp.

Here is the caller graph for this function:

◆ ForceSetArg()

void ArgsManager::ForceSetArg ( const std::string &  strArg,
const std::string &  strValue 
)

Definition at line 546 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetArg() [1/2]

std::optional< std::string > ArgsManager::GetArg ( const std::string &  strArg) const

Definition at line 462 of file args.cpp.

Here is the call graph for this function:

◆ GetArg() [2/2]

std::string ArgsManager::GetArg ( const std::string &  strArg,
const std::string &  strDefault 
) const

Return string argument or default value.

Parameters
strArgArgument to get (e.g. "-foo")
strDefault(e.g. "1")
Returns
command-line argument or default value

Definition at line 457 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetArgFlags()

std::optional< unsigned int > ArgsManager::GetArgFlags ( const std::string &  name) const

Return Flags for known arg.

Return nullopt for unknown arg.

Definition at line 260 of file args.cpp.

Here is the caller graph for this function:

◆ GetArgs()

std::vector< std::string > ArgsManager::GetArgs ( const std::string &  strArg) const

Return a vector of strings of the given argument.

Parameters
strArgArgument to get (e.g. "-foo")
Returns
command-line arguments

Definition at line 362 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetBlocksDirPath()

fs::path ArgsManager::GetBlocksDirPath ( ) const

Get blocks directory path.

Returns
Blocks path which is network specific

Definition at line 282 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetBoolArg() [1/2]

std::optional< bool > ArgsManager::GetBoolArg ( const std::string &  strArg) const

Definition at line 512 of file args.cpp.

Here is the call graph for this function:

◆ GetBoolArg() [2/2]

bool ArgsManager::GetBoolArg ( const std::string &  strArg,
bool  fDefault 
) const

Return boolean argument or default value.

Parameters
strArgArgument to get (e.g. "-foo")
fDefault(true or false)
Returns
command-line argument or default value

Definition at line 507 of file args.cpp.

Here is the call graph for this function:

◆ GetChainArg()

std::variant< ChainType, std::string > ArgsManager::GetChainArg ( ) const
private

Return -regtest/-signet/-testnet/-testnet4/-chain= setting as a ChainType enum if a recognized chain type was set, or as a string if an unrecognized chain name was set.

Raise an exception if an invalid combination of flags was provided.

Definition at line 788 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetChainType()

ChainType ArgsManager::GetChainType ( ) const

Returns the appropriate chain type from the program arguments.

Returns
ChainType::MAIN by default; raises runtime error if an invalid combination, or unknown chain is given.

Definition at line 774 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetChainTypeString()

std::string ArgsManager::GetChainTypeString ( ) const

Returns the appropriate chain type string from the program arguments.

Returns
ChainType::MAIN string by default; raises runtime error if an invalid combination is given.

Definition at line 781 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetCommand()

std::optional< const ArgsManager::Command > ArgsManager::GetCommand ( ) const

Get the command and command args (returns std::nullopt if no command provided)

Definition at line 342 of file args.cpp.

◆ GetConfigFilePath()

fs::path ArgsManager::GetConfigFilePath ( ) const

Return config file path (read-only)

Definition at line 761 of file args.cpp.

Here is the caller graph for this function:

◆ GetDataDir()

fs::path ArgsManager::GetDataDir ( bool  net_specific) const
private

Get data directory path.

Parameters
net_specificAppend network identifier to the returned path
Returns
Absolute path on success, otherwise an empty path when a non-directory path would be returned

Definition at line 307 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetDataDirBase()

fs::path ArgsManager::GetDataDirBase ( ) const
inline

Get data directory path.

Returns
Absolute path on success, otherwise an empty path when a non-directory path would be returned

Definition at line 227 of file args.h.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetDataDirNet()

fs::path ArgsManager::GetDataDirNet ( ) const
inline

Get data directory path with appended network identifier.

Returns
Absolute path on success, otherwise an empty path when a non-directory path would be returned

Definition at line 234 of file args.h.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetHelpMessage()

std::string ArgsManager::GetHelpMessage ( ) const

Get the help string.

Definition at line 609 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetIntArg() [1/2]

std::optional< int64_t > ArgsManager::GetIntArg ( const std::string &  strArg) const

Definition at line 487 of file args.cpp.

Here is the call graph for this function:

◆ GetIntArg() [2/2]

int64_t ArgsManager::GetIntArg ( const std::string &  strArg,
int64_t  nDefault 
) const

Return integer argument or default value.

Parameters
strArgArgument to get (e.g. "-foo")
nDefault(e.g. 1)
Returns
command-line argument (0 if invalid number) or default value

Definition at line 482 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetPathArg()

fs::path ArgsManager::GetPathArg ( std::string  arg,
const fs::path default_value = {} 
) const

Return path argument or default value.

Parameters
argArgument to get a path from (e.g., "-datadir", "-blocksdir" or "-walletdir")
default_valueOptional default value to return instead of the empty path.
Returns
normalized path if argument is set, with redundant "." and ".." path components and trailing separators removed (see patharg unit test for examples or implementation for details). If argument is empty or not set, default_value is returned unchanged.

Definition at line 272 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetPersistentSetting()

common::SettingsValue ArgsManager::GetPersistentSetting ( const std::string &  name) const

Get current setting from config file or read/write settings file, ignoring nonpersistent command line or forced settings values.

Definition at line 445 of file args.cpp.

Here is the call graph for this function:

◆ GetSetting()

common::SettingsValue ArgsManager::GetSetting ( const std::string &  arg) const

Get setting value.

Result will be null if setting was unset, true if "-setting" argument was passed false if "-nosetting" argument was passed, and a string if a "-setting=value" argument was passed.

Definition at line 825 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetSettingsList()

std::vector< common::SettingsValue > ArgsManager::GetSettingsList ( const std::string &  arg) const

Get list of setting values.

Definition at line 833 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetSettingsPath()

bool ArgsManager::GetSettingsPath ( fs::path filepath = nullptr,
bool  temp = false,
bool  backup = false 
) const

Get settings file path, or return false if read-write settings were disabled with -nosettings.

Definition at line 376 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetUnrecognizedSections()

std::list< SectionInfo > ArgsManager::GetUnrecognizedSections ( ) const

Log warnings for unrecognized section names in the config file.

Definition at line 156 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetUnsuitableSectionOnlyArgs()

std::set< std::string > ArgsManager::GetUnsuitableSectionOnlyArgs ( ) const

Log warnings for options in m_section_only_args when they are specified in the default section but not overridden on the command line or in a network-specific section in the config file.

Definition at line 136 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GUARDED_BY() [1/11]

common::Settings m_settings ArgsManager::GUARDED_BY ( cs_args  )
protected

◆ GUARDED_BY() [2/11]

std::vector< std::string > m_command ArgsManager::GUARDED_BY ( cs_args  )
protected

◆ GUARDED_BY() [3/11]

std::string m_network ArgsManager::GUARDED_BY ( cs_args  )
protected

◆ GUARDED_BY() [4/11]

std::set< std::string > m_network_only_args ArgsManager::GUARDED_BY ( cs_args  )
protected

◆ GUARDED_BY() [5/11]

std::map< OptionsCategory, std::map< std::string, Arg > > m_available_args ArgsManager::GUARDED_BY ( cs_args  )
protected

◆ GUARDED_BY() [6/11]

bool m_accept_any_command ArgsManager::GUARDED_BY ( cs_args  )
inlineprotected

Definition at line 140 of file args.h.

◆ GUARDED_BY() [7/11]

std::list< SectionInfo > m_config_sections ArgsManager::GUARDED_BY ( cs_args  )
protected

◆ GUARDED_BY() [8/11]

std::optional< fs::path > m_config_path ArgsManager::GUARDED_BY ( cs_args  )
protected

◆ GUARDED_BY() [9/11]

fs::path m_cached_blocks_path ArgsManager::GUARDED_BY ( cs_args  )
mutableprotected

◆ GUARDED_BY() [10/11]

fs::path m_cached_datadir_path ArgsManager::GUARDED_BY ( cs_args  )
mutableprotected

◆ GUARDED_BY() [11/11]

fs::path m_cached_network_datadir_path ArgsManager::GUARDED_BY ( cs_args  )
mutableprotected

◆ IsArgNegated()

bool ArgsManager::IsArgNegated ( const std::string &  strArg) const

Return true if the argument was originally passed as a negated option, i.e.

-nofoo.

Parameters
strArgArgument to get (e.g. "-foo")
Returns
true if the argument was passed negated

Definition at line 452 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ IsArgSet()

bool ArgsManager::IsArgSet ( const std::string &  strArg) const

Return true if the given argument has been manually set.

Parameters
strArgArgument to get (e.g. "-foo")
Returns
true if the argument has been set

Definition at line 371 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ LockSettings()

template<typename Fn >
void ArgsManager::LockSettings ( Fn &&  fn)
inline

Access settings with lock held.

Definition at line 413 of file args.h.

Here is the caller graph for this function:

◆ LogArgs()

void ArgsManager::LogArgs ( ) const

Log the config file options and the command line arguments, useful for troubleshooting.

Definition at line 856 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ logArgsPrefix()

void ArgsManager::logArgsPrefix ( const std::string &  prefix,
const std::string &  section,
const std::map< std::string, std::vector< common::SettingsValue > > &  args 
) const
private

Definition at line 839 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ParseParameters()

bool ArgsManager::ParseParameters ( int  argc,
const char *const  argv[],
std::string &  error 
)

Definition at line 179 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ReadConfigFiles()

bool ArgsManager::ReadConfigFiles ( std::string &  error,
bool  ignore_invalid_keys = false 
)

Definition at line 122 of file config.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ReadConfigStream()

bool ArgsManager::ReadConfigStream ( std::istream &  stream,
const std::string &  filepath,
std::string &  error,
bool  ignore_invalid_keys = false 
)
protected

Definition at line 93 of file config.cpp.

Here is the call graph for this function:

◆ ReadSettingsFile()

bool ArgsManager::ReadSettingsFile ( std::vector< std::string > *  errors = nullptr)

Read settings file.

Push errors to vector, or log them if null.

Definition at line 402 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ SelectConfigNetwork()

void ArgsManager::SelectConfigNetwork ( const std::string &  network)

Select the network in use.

Definition at line 173 of file args.cpp.

Here is the caller graph for this function:

◆ SetConfigFilePath()

void ArgsManager::SetConfigFilePath ( fs::path  path)

Definition at line 767 of file args.cpp.

Here is the call graph for this function:

◆ SoftSetArg()

bool ArgsManager::SoftSetArg ( const std::string &  strArg,
const std::string &  strValue 
)

Set an argument if it doesn't already have a value.

Parameters
strArgArgument to set (e.g. "-foo")
strValueValue (e.g. "1")
Returns
true if argument gets set, false if it already had a value

Definition at line 530 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ SoftSetBoolArg()

bool ArgsManager::SoftSetBoolArg ( const std::string &  strArg,
bool  fValue 
)

Set a boolean argument if it doesn't already have a value.

Parameters
strArgArgument to set (e.g. "-foo")
fValueValue (e.g. false)
Returns
true if argument gets set, false if it already had a value

Definition at line 538 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ UseDefaultSection()

bool ArgsManager::UseDefaultSection ( const std::string &  arg) const
protected

Returns true if settings values from the default section should be used, depending on the current network and whether the setting is network-specific.

Definition at line 820 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ WriteSettingsFile()

bool ArgsManager::WriteSettingsFile ( std::vector< std::string > *  errors = nullptr,
bool  backup = false 
) const

Write settings file or backup settings file.

Push errors to vector, or log them if null.

Definition at line 425 of file args.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

Member Data Documentation

◆ cs_args

RecursiveMutex ArgsManager::cs_args
mutableprotected

Definition at line 134 of file args.h.


The documentation for this class was generated from the following files: