configuration file parsing utility More...

#include <config-file.hpp>

Inheritance diagram for nfd::ConfigFile:

Collaboration diagram for nfd::ConfigFile:

Classes
class	Error

Public Member Functions
	ConfigFile (UnknownConfigSectionHandler unknownSectionCallback=throwErrorOnUnknownSection)

void	addSectionHandler (const std::string &sectionName, ConfigSectionHandler subscriber)
	setup notification of configuration file sections More...

void	parse (const std::string &filename, bool isDryRun)

void	parse (const std::string &input, bool isDryRun, const std::string &filename)

void	parse (std::istream &input, bool isDryRun, const std::string &filename)

void	parse (const ConfigSection &config, bool isDryRun, const std::string &filename)

Static Public Member Functions
static void	throwErrorOnUnknownSection (const std::string &filename, const std::string &sectionName, const ConfigSection &section, bool isDryRun)

static void	ignoreUnknownSection (const std::string &filename, const std::string &sectionName, const ConfigSection &section, bool isDryRun)

static bool	parseYesNo (const ConfigSection &node, const std::string &key, const std::string &sectionName)
	parse a config option that can be either "yes" or "no" More...

static bool	parseYesNo (const ConfigSection::value_type &option, const std::string &sectionName)

template<typename T >
static T	parseNumber (const ConfigSection &node, const std::string &key, const std::string &sectionName)
	parse a numeric (integral or floating point) config option More...

template<typename T >
static T	parseNumber (const ConfigSection::value_type &option, const std::string &sectionName)

Detailed Description

configuration file parsing utility

Definition at line 58 of file config-file.hpp.

Constructor & Destructor Documentation

nfd::ConfigFile::ConfigFile ( UnknownConfigSectionHandler unknownSectionCallback = throwErrorOnUnknownSection )

explicit

Definition at line 34 of file config-file.cpp.

Referenced by nfd::ConfigFile::Error::Error().

Member Function Documentation

void nfd::ConfigFile::throwErrorOnUnknownSection	(	const std::string &	filename,
		const std::string &	sectionName,
		const ConfigSection &	section,
		bool	isDryRun
	)

static

Definition at line 40 of file config-file.cpp.

Referenced by nfd::ConfigFile::Error::Error(), nfd::ignoreRibAndLogSections(), nfd::rib::Service::initialize(), and ns3::ndn::IgnoreSections::operator()().

void nfd::ConfigFile::ignoreUnknownSection	(	const std::string &	filename,
		const std::string &	sectionName,
		const ConfigSection &	section,
		bool	isDryRun
	)

static

Definition at line 50 of file config-file.cpp.

Referenced by nfd::ConfigFile::Error::Error(), nfd::rib::Service::initialize(), nfd::Nfd::initialize(), and nfd::Nfd::reloadConfigFile().

bool nfd::ConfigFile::parseYesNo	(	const ConfigSection &	node,
		const std::string &	key,
		const std::string &	sectionName
	)

static

parse a config option that can be either "yes" or "no"

Return values

true	"yes"
false	"no"

Exceptions

Error the value is neither "yes" nor "no"

Definition at line 59 of file config-file.cpp.

Referenced by nfd::ConfigFile::Error::Error(), nfd::rib::RibManager::onRibUpdateFailure(), parseYesNo(), nfd::face::WebSocketFactory::processConfig(), nfd::face::TcpFactory::processConfig(), nfd::face::EthernetFactory::processConfig(), and nfd::face::UdpFactory::processConfig().

static bool nfd::ConfigFile::parseYesNo	(	const ConfigSection::value_type &	option,
		const std::string &	sectionName
	)

inlinestatic

Definition at line 97 of file config-file.hpp.

References parseYesNo().

template<typename T >

static T nfd::ConfigFile::parseNumber	(	const ConfigSection &	node,
		const std::string &	key,
		const std::string &	sectionName
	)

inlinestatic

parse a numeric (integral or floating point) config option

Template Parameters

T	an arithmetic type

Returns: the numeric value of the parsed option

Exceptions

Error the value cannot be converted to the specified type

Definition at line 111 of file config-file.hpp.

References nfd::ConfigFile::Error::Error().

template<typename T >

static T nfd::ConfigFile::parseNumber	(	const ConfigSection::value_type &	option,
		const std::string &	sectionName
	)

inlinestatic

Definition at line 125 of file config-file.hpp.

References addSectionHandler(), and parse().

void nfd::ConfigFile::addSectionHandler	(	const std::string &	sectionName,
		ConfigSectionHandler	subscriber
	)

setup notification of configuration file sections

Definition at line 76 of file config-file.cpp.

Referenced by parseNumber(), nfd::CommandAuthenticator::setConfigFile(), nfd::rib::RibManager::setConfigFile(), nfd::TablesConfigSection::setConfigFile(), nfd::face::FaceSystem::setConfigFile(), and nfd::general::setConfigFile().

void nfd::ConfigFile::parse	(	const std::string &	filename,
		bool	isDryRun
	)

Parameters

filename	file to parse
isDryRun	true if performing a dry run of configuration, false otherwise

Exceptions

ConfigFile::Error	if file not found
ConfigFile::Error	if parse error

Definition at line 83 of file config-file.cpp.

Referenced by nfd::ignoreRibAndLogSections(), nfd::rib::Service::initialize(), nfd::Nfd::initialize(), parse(), parseNumber(), nfd::Nfd::reloadConfigFile(), and ns3::ndn::L3Protocol::setCsReplacementPolicy().

void nfd::ConfigFile::parse	(	const std::string &	input,
		bool	isDryRun,
		const std::string &	filename
	)

Parameters

input	configuration (as a string) to parse
isDryRun	true if performing a dry run of configuration, false otherwise
filename	logical filename of the config file, can appear in error messages

Exceptions

ConfigFile::Error	if file not found
ConfigFile::Error	if parse error

Definition at line 94 of file config-file.cpp.

References parse().

void nfd::ConfigFile::parse	(	std::istream &	input,
		bool	isDryRun,
		const std::string &	filename
	)

Parameters

input	stream to parse
isDryRun	true if performing a dry run of configuration, false otherwise
filename	logical filename of the config file, can appear in error messages

Exceptions

ConfigFile::Error if parse error

Definition at line 101 of file config-file.cpp.

References ndn::to_string().

void nfd::ConfigFile::parse	(	const ConfigSection &	config,
		bool	isDryRun,
		const std::string &	filename
	)

Parameters

config	ConfigSection that needs to be processed
isDryRun	true if performing a dry run of configuration, false otherwise
filename	logical filename of the config file, can appear in error messages

Exceptions

ConfigFile::Error if parse error

Definition at line 115 of file config-file.cpp.

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

ndnSIM/NFD/core/config-file.hpp
ndnSIM/NFD/core/config-file.cpp

Classes

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation