Collaboration diagram for Configuration:

Topics
	Config implementations

Files
file	config-test-suite.cc
	Config test suite.

file	config.h
	Declaration of the various ns3::Config functions and classes.

file	names-test-suite.cc
	Object Names test suite.

file	names.cc
	ns3::Names, ns3::NamesNode and ns3::NamePriv implementations.

file	names.h
	Declaration of class ns3::Names.

Namespaces
namespace	ns3::Config
	Namespace for the various functions implementing the Config system.

Classes
class	ns3::Config::MatchContainer
	hold a set of objects which match a specific search string. More...

class	ns3::NameNode
	Node in the naming tree. More...

class	ns3::Names
	A directory of name and Ptr<Object> associations that allows us to give any ns3 Object a name. More...

class	ns3::NamesPriv
	The singleton root Names object. More...

Functions
void	ns3::Config::Connect (std::string path, const CallbackBase &cb)

bool	ns3::Config::ConnectFailSafe (std::string path, const CallbackBase &cb)

void	ns3::Config::ConnectWithoutContext (std::string path, const CallbackBase &cb)

bool	ns3::Config::ConnectWithoutContextFailSafe (std::string path, const CallbackBase &cb)

void	ns3::Config::Disconnect (std::string path, const CallbackBase &cb)

void	ns3::Config::DisconnectWithoutContext (std::string path, const CallbackBase &cb)

Ptr< Object >	ns3::Config::GetRootNamespaceObject (uint32_t i)

std::size_t	ns3::Config::GetRootNamespaceObjectN ()

MatchContainer	ns3::Config::LookupMatches (std::string path)

void	ns3::Config::RegisterRootNamespaceObject (Ptr< Object > obj)

void	ns3::Config::Reset ()
	Reset the initial value of every attribute as well as the value of every global to what they were before any call to SetDefault and SetGlobal.

void	ns3::Config::Set (std::string path, const AttributeValue &value)

void	ns3::Config::SetDefault (std::string name, const AttributeValue &value)

bool	ns3::Config::SetDefaultFailSafe (std::string name, const AttributeValue &value)

bool	ns3::Config::SetFailSafe (std::string path, const AttributeValue &value)

void	ns3::Config::SetGlobal (std::string name, const AttributeValue &value)

bool	ns3::Config::SetGlobalFailSafe (std::string name, const AttributeValue &value)

void	ns3::Config::UnregisterRootNamespaceObject (Ptr< Object > obj)

Detailed Description

Configuration of simulation parameters and tracing.

Function Documentation

◆ Connect()

void ns3::Config::Connect	(	std::string	path,
		const CallbackBase &	cb )

Parameters

[in]	path	A path to match trace sources.
[in]	cb	The callback to connect to the matching trace sources.

This function will attempt to find all trace sources which match the input path and will then connect the input callback to them in such a way that the callback will receive an extra context string upon trace event notification. If no matching trace sources are found, this method will throw a fatal error. Use ConnectFailSafe if the absence of matching trace sources should not be fatal.

Definition at line 967 of file config.cc.

References ns3::Config::ConnectFailSafe(), NS_FATAL_ERROR, and NS_LOG_FUNCTION.

Here is the call graph for this function:

◆ ConnectFailSafe()

bool ns3::Config::ConnectFailSafe	(	std::string	path,
		const CallbackBase &	cb )

Parameters

[in]	path	A path to match trace sources.
[in]	cb	The callback to connect to the matching trace sources.

This function will attempt to find all trace sources which match the input path and will then connect the input callback to them in such a way that the callback will receive an extra context string upon trace event notification.

Returns: true if any trace sources could be connected.

Definition at line 977 of file config.cc.

References ns3::Config::ConfigImpl::ConnectFailSafe(), ns3::Singleton< ConfigImpl >::Get(), and NS_LOG_FUNCTION.

Referenced by ns3::PyViz::PyViz(), ns3::Config::Connect(), ns3::AnimationInterface::ConnectCallbacks(), ns3::RadioBearerStatsConnector::ConnectTracesDrbEnb(), and ns3::RadioBearerStatsConnector::ConnectTracesDrbUe().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ConnectWithoutContext()

void ns3::Config::ConnectWithoutContext	(	std::string	path,
		const CallbackBase &	cb )

Parameters

[in]	path	A path to match trace sources.
[in]	cb	The callback to connect to the matching trace sources.

This function will attempt to find all trace sources which match the input path and will then connect the input callback to them. If no matching trace sources are found, this method will throw a fatal error. Use ConnectWithoutContextFailSafe if the absence of matching trace sources should not be fatal.

Definition at line 943 of file config.cc.

References ns3::Config::ConnectWithoutContextFailSafe(), NS_FATAL_ERROR, and NS_LOG_FUNCTION.

Referenced by ns3::ApplicationPacketProbe::ConnectByPath(), ns3::BooleanProbe::ConnectByPath(), ns3::DoubleProbe::ConnectByPath(), ns3::Ipv4PacketProbe::ConnectByPath(), ns3::Ipv6PacketProbe::ConnectByPath(), ns3::PacketProbe::ConnectByPath(), ns3::TimeProbe::ConnectByPath(), ns3::Uinteger16Probe::ConnectByPath(), ns3::Uinteger32Probe::ConnectByPath(), ns3::Uinteger8Probe::ConnectByPath(), Ns3TcpCubicTestCase::ConnectCwndTrace(), ConnectSocketTraces(), CsmaBridgeTestCase::DoRun(), CsmaBroadcastTestCase::DoRun(), CsmaMulticastTestCase::DoRun(), CsmaOneSubnetTestCase::DoRun(), CsmaPingTestCase::DoRun(), CsmaRawIpSocketTestCase::DoRun(), CsmaStarTestCase::DoRun(), Ipv4DeduplicationTest::DoRun(), ns3::tests::ObjectVectorTraceConfigTestCase::DoRun(), Ns3TcpLossTestCase::DoRun(), WifiChannelSwitchingTest::DoRun(), WifiUseAvailBwTest::DoRun(), EmlsrOperationsTestBase::DoSetup(), MultiLinkOperationsTestBase::DoSetup(), OrigBlockAckWindowStalled::DoSetup(), ns3::WifiPhyHelper::EnableAsciiInternal(), ns3::SpectrumAnalyzerHelper::Install(), ScheduleN0PacketSinkConnection(), ScheduleN0TcpCwndTraceConnection(), ScheduleN0TcpRttTraceConnection(), ScheduleN1PacketSinkConnection(), ScheduleN1TcpCwndTraceConnection(), ScheduleN1TcpRttTraceConnection(), ScheduleSecondPacketSinkConnection(), ScheduleSecondTcpCwndTraceConnection(), ScheduleSecondTcpRttTraceConnection(), TraceCwnd(), TraceCwnd(), TraceCwnd(), TraceCwnd(), TraceCwnd(), TraceDroppingState(), TraceEveryDrop(), TraceQueueLength(), and TraceSojourn().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ConnectWithoutContextFailSafe()

bool ns3::Config::ConnectWithoutContextFailSafe	(	std::string	path,
		const CallbackBase &	cb )

Parameters

[in]	path	A path to match trace sources.
[in]	cb	The callback to connect to the matching trace sources.

This function will attempt to find all trace sources which match the input path and will then connect the input callback to them. If no matching trace sources are found, this method will return false; otherwise true.

Returns: true if any trace sources could be connected.

Definition at line 953 of file config.cc.

References ns3::Config::ConfigImpl::ConnectWithoutContextFailSafe(), ns3::Singleton< ConfigImpl >::Get(), and NS_LOG_FUNCTION.

Referenced by ns3::Ipv4FlowProbe::Ipv4FlowProbe(), ns3::Ipv6FlowProbe::Ipv6FlowProbe(), ns3::AnimationInterface::ConnectCallbacks(), ns3::Config::ConnectWithoutContext(), ns3::MobilityHelper::EnableAscii(), ScheduleFirstDctcpTraceConnection(), ScheduleFirstPacketSinkConnection(), ScheduleFirstTcpCwndTraceConnection(), ScheduleFirstTcpRttTraceConnection(), and ScheduleSecondDctcpTraceConnection().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Disconnect()

void ns3::Config::Disconnect	(	std::string	path,
		const CallbackBase &	cb )

Parameters

[in]	path	A path to match trace sources.
[in]	cb	The callback to connect to the matching trace sources.

This function undoes the work of Config::ConnectWithContext.

Definition at line 984 of file config.cc.

References ns3::Config::ConfigImpl::Disconnect(), ns3::Singleton< ConfigImpl >::Get(), and NS_LOG_FUNCTION.

Here is the call graph for this function:

◆ DisconnectWithoutContext()

void ns3::Config::DisconnectWithoutContext	(	std::string	path,
		const CallbackBase &	cb )

Parameters

[in]	path	A path to match trace sources.
[in]	cb	The callback to disconnect to the matching trace sources.

This function undoes the work of Config::Connect.

Definition at line 960 of file config.cc.

References ns3::Config::ConfigImpl::DisconnectWithoutContext(), ns3::Singleton< ConfigImpl >::Get(), and NS_LOG_FUNCTION.

Here is the call graph for this function:

◆ GetRootNamespaceObject()

Ptr< Object > ns3::Config::GetRootNamespaceObject ( uint32_t i )

Parameters

[in] i The index of the requested object.

Returns: The requested root namespace object

Definition at line 1019 of file config.cc.

References ns3::Singleton< ConfigImpl >::Get(), ns3::Config::ConfigImpl::GetRootNamespaceObject(), and NS_LOG_FUNCTION.

Referenced by GetTypicalAggregations(), and ns3::AttributeIterator::Iterate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetRootNamespaceObjectN()

std::size_t ns3::Config::GetRootNamespaceObjectN ( )

Returns: The number of registered root namespace objects.

Definition at line 1012 of file config.cc.

References ns3::Singleton< ConfigImpl >::Get(), ns3::Config::ConfigImpl::GetRootNamespaceObjectN(), and NS_LOG_FUNCTION_NOARGS.

Referenced by GetTypicalAggregations(), and ns3::AttributeIterator::Iterate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ LookupMatches()

MatchContainer ns3::Config::LookupMatches ( std::string path )

Parameters

[in] path The path to perform a match against

Returns: A container which contains all the objects which match the input path.

Definition at line 991 of file config.cc.

References ns3::Singleton< ConfigImpl >::Get(), ns3::Config::ConfigImpl::LookupMatches(), and NS_LOG_FUNCTION.

Referenced by ns3::RandomVariableStreamHelper::AssignStreams(), ns3::LteStatsCalculator::FindCellIdFromEnbRlcPath(), ns3::LteStatsCalculator::FindImsiFromEnbRlcPath(), ns3::LteStatsCalculator::FindImsiFromLteNetDevice(), ns3::LteStatsCalculator::FindImsiFromUePhy(), ns3::RadioEnvironmentMapHelper::Install(), ns3::GnuplotHelper::PlotProbe(), and ns3::FileHelper::WriteProbe().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ RegisterRootNamespaceObject()

void ns3::Config::RegisterRootNamespaceObject ( Ptr< Object > obj )

Parameters

[in] obj A new root object

Each root object is used during path matching as the root of the path by Config::Connect, and Config::Set.

Definition at line 998 of file config.cc.

References ns3::Singleton< ConfigImpl >::Get(), NS_LOG_FUNCTION, and ns3::Config::ConfigImpl::RegisterRootNamespaceObject().

Referenced by ns3::BuildingListPriv::DoGet(), ns3::ChannelListPriv::DoGet(), ns3::NodeListPriv::DoGet(), ns3::tests::ObjectVectorConfigTestCase::DoRun(), ns3::tests::ObjectVectorTraceConfigTestCase::DoRun(), ns3::tests::RootNamespaceConfigTestCase::DoRun(), ns3::tests::SearchAttributesOfParentObjectsTestCase::DoRun(), and ns3::tests::UnderRootNamespaceConfigTestCase::DoRun().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Reset()

void ns3::Config::Reset ( )

Reset the initial value of every attribute as well as the value of every global to what they were before any call to SetDefault and SetGlobal.

Definition at line 848 of file config.cc.

References ns3::GlobalValue::Begin(), ns3::GlobalValue::End(), ns3::TypeId::GetAttribute(), ns3::TypeId::GetAttributeN(), ns3::TypeId::GetRegistered(), ns3::TypeId::GetRegisteredN(), NS_LOG_FUNCTION_NOARGS, ns3::TypeId::AttributeInformation::originalInitialValue, and ns3::TypeId::SetAttributeInitialValue().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Set()

void ns3::Config::Set	(	std::string	path,
		const AttributeValue &	value )

Parameters

[in]	path	A path to match attributes.
[in]	value	The value to set in all matching attributes.

This function will attempt to find attributes which match the input path and will then set their value to the input value. If no such attributes are found, the function will throw a fatal error; use SetFailSafe if the lack of a match is to be permitted.

Definition at line 869 of file config.cc.

References ns3::Singleton< ConfigImpl >::Get(), NS_LOG_FUNCTION, and ns3::Config::ConfigImpl::Set().

Referenced by ns3::RawTextConfigLoad::Attributes(), ns3::XmlConfigLoad::Attributes(), IdealRateManagerChannelWidthTest::ChangeChannelWidth(), WifiChannelSwitchingTest::ChannelSwitch(), Bug730TestCase::DoRun(), DsssModulationTest::DoRun(), LteEpcE2eDataTestCase::DoRun(), ns3::tests::ObjectVectorConfigTestCase::DoRun(), ns3::tests::RootNamespaceConfigTestCase::DoRun(), ns3::tests::SearchAttributesOfParentObjectsTestCase::DoRun(), ns3::tests::UnderRootNamespaceConfigTestCase::DoRun(), QosFragmentationTestCase::DoRun(), SetChannelFrequencyTest::DoRun(), Experiment::IncrementCw(), NetAnimExperiment::IncrementCw(), Experiment::Run(), Experiment::Run(), TestInterBssConstantObssPdAlgo::RunOne(), IdealRateManagerMimoTest::SetApMimoSettings(), and IdealRateManagerMimoTest::SetStaMimoSettings().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetDefault()

void ns3::Config::SetDefault	(	std::string	name,
		const AttributeValue &	value )

Parameters

[in]	name	The full name of the attribute
[in]	value	The value to set.

This method overrides the initial value of the matching attribute. This method cannot fail: it will crash if the input attribute name or value is invalid.

Definition at line 883 of file config.cc.

References NS_FATAL_ERROR, NS_LOG_FUNCTION, and ns3::Config::SetDefaultFailSafe().

Here is the call graph for this function:

◆ SetDefaultFailSafe()

bool ns3::Config::SetDefaultFailSafe	(	std::string	name,
		const AttributeValue &	value )

Parameters

[in]	name	The full name of the attribute
[in]	value	The value to set.

Returns: true if the value was set successfully, false otherwise.

This method overrides the initial value of the matching attribute.

Definition at line 893 of file config.cc.

References ns3::TypeId::AttributeInformation::checker, ns3::TypeId::GetAttribute(), ns3::TypeId::GetAttributeN(), ns3::TypeId::LookupAttributeByName(), ns3::TypeId::LookupByNameFailSafe(), ns3::TypeId::AttributeInformation::name, NS_LOG_FUNCTION, and ns3::TypeId::SetAttributeInitialValue().

Referenced by ns3::cell_edited_callback_config_default(), AttributeTestCase< T >::DoRun(), ns3::CommandLine::HandleAttribute(), and ns3::Config::SetDefault().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetFailSafe()

bool ns3::Config::SetFailSafe	(	std::string	path,
		const AttributeValue &	value )

Parameters

[in]	path	A path to match attributes.
[in]	value	The value to set in all matching attributes.

This function will attempt to find attributes which match the input path and will then set their value to the input value, and will return true if at least one such attribute is found.

Returns: true if any matching attributes could be set.

Definition at line 876 of file config.cc.

References ns3::Singleton< ConfigImpl >::Get(), NS_LOG_FUNCTION, and ns3::Config::ConfigImpl::SetFailSafe().

Here is the call graph for this function:

◆ SetGlobal()

void ns3::Config::SetGlobal	(	std::string	name,
		const AttributeValue &	value )

Parameters

[in]	name	The name of the requested GlobalValue.
[in]	value	The value to set

This method is equivalent to GlobalValue::Bind

Definition at line 929 of file config.cc.

References ns3::GlobalValue::Bind(), and NS_LOG_FUNCTION.

Referenced by LenaDataPhyErrorModelTestCase::DoRun(), LenaDlCtrlPhyErrorModelTestCase::DoRun(), LteCellSelectionTestCase::DoRun(), LtePrimaryCellChangeTestCase::DoRun(), LteRlcAmE2eTestCase::DoRun(), LteSecondaryCellSelectionTestCase::DoRun(), OfdmaAckSequenceTest::DoRun(), ThreeGppHttpObjectTestCase::DoRun(), ThreadedSimulatorEventsTestCase::DoSetup(), ThreadedSimulatorEventsTestCase::DoTeardown(), ns3::RawTextConfigLoad::Global(), ns3::XmlConfigLoad::Global(), ns3::RngSeedManager::SetRun(), and ns3::RngSeedManager::SetSeed().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetGlobalFailSafe()

bool ns3::Config::SetGlobalFailSafe	(	std::string	name,
		const AttributeValue &	value )

Parameters

[in]	name	The name of the requested GlobalValue.
[in]	value	The value to set

Returns: true if the GlobalValue could be set.

This method is equivalent to GlobalValue::BindFailSafe

Definition at line 936 of file config.cc.

References ns3::GlobalValue::BindFailSafe(), and NS_LOG_FUNCTION.

Referenced by ns3::CommandLine::HandleAttribute().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ UnregisterRootNamespaceObject()

void ns3::Config::UnregisterRootNamespaceObject ( Ptr< Object > obj )

Parameters

[in] obj A new root object

This function undoes the work of Config::RegisterRootNamespaceObject.

Definition at line 1005 of file config.cc.

References ns3::Singleton< ConfigImpl >::Get(), NS_LOG_FUNCTION, and ns3::Config::ConfigImpl::UnregisterRootNamespaceObject().

Referenced by ns3::BuildingListPriv::Delete(), ns3::ChannelListPriv::Delete(), and ns3::NodeListPriv::Delete().

Here is the call graph for this function:

Here is the caller graph for this function:

Topics

Files

Namespaces

Classes

Functions

Detailed Description

Function Documentation

◆ Connect()

◆ ConnectFailSafe()

◆ ConnectWithoutContext()

◆ ConnectWithoutContextFailSafe()

◆ Disconnect()

◆ DisconnectWithoutContext()

◆ GetRootNamespaceObject()

◆ GetRootNamespaceObjectN()

◆ LookupMatches()

◆ RegisterRootNamespaceObject()

◆ Reset()

◆ Set()

◆ SetDefault()

◆ SetDefaultFailSafe()

◆ SetFailSafe()

◆ SetGlobal()

◆ SetGlobalFailSafe()

◆ UnregisterRootNamespaceObject()