A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
ns3::Config Namespace Reference

Configuration of simulation parameters and tracing. More...

Classes

class  MatchContainer
 hold a set of objects which match a specific search string. More...
 

Functions

void Connect (std::string path, const CallbackBase &cb)
 
void ConnectWithoutContext (std::string path, const CallbackBase &cb)
 
void Disconnect (std::string path, const CallbackBase &cb)
 
void DisconnectWithoutContext (std::string path, const CallbackBase &cb)
 
Ptr< ObjectGetRootNamespaceObject (uint32_t i)
 
uint32_t GetRootNamespaceObjectN (void)
 
Config::MatchContainer LookupMatches (std::string path)
 
void RegisterRootNamespaceObject (Ptr< Object > obj)
 
void Reset (void)
 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. More...
 
void Set (std::string path, const AttributeValue &value)
 
void SetDefault (std::string name, const AttributeValue &value)
 
bool SetDefaultFailSafe (std::string name, const AttributeValue &value)
 
void SetGlobal (std::string name, const AttributeValue &value)
 
bool SetGlobalFailSafe (std::string name, const AttributeValue &value)
 
void UnregisterRootNamespaceObject (Ptr< Object > obj)
 

Detailed Description

Configuration of simulation parameters and tracing.

Function Documentation

void ns3::Config::Connect ( std::string  path,
const CallbackBase &  cb 
)
Parameters
patha path to match trace sources.
cbthe 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.

Definition at line 738 of file config.cc.

References ns3::Singleton< T >::Get(), and NS_LOG_FUNCTION.

Referenced by ns3::LteHelper::ActivateDataRadioBearer(), ns3::dsr::DsrRouting::ConnectCallbacks(), ns3::AnimationInterface::ConnectCallbacks(), ns3::RadioBearerStatsConnector::ConnectSrb0Traces(), ns3::RadioBearerStatsConnector::ConnectSrb1TracesUe(), ns3::RadioBearerStatsConnector::ConnectTracesEnb(), ns3::RadioBearerStatsConnector::ConnectTracesUe(), ns3::DoMakeTraceSourceAccessor(), ns3::aodv::LoopbackTestCase::DoRun(), WaypointMobilityModelNotifyTest::DoRun(), LteCqiGenerationTestCase::DoRun(), LteLinkAdaptationTestCase::DoRun(), Ipv4DynamicGlobalRoutingTestCase::DoRun(), Ns3TcpNoDelayTestCase::DoRun(), LteInterferenceTestCase::DoRun(), Ns3TcpSocketTestCase1::DoRun(), LteEnbAntennaTestCase::DoRun(), NscTcpLossTestCase1::DoRun(), LteRrcConnectionEstablishmentTestCase::DoRun(), Ns3TcpLossTestCase::DoRun(), Ns3TcpStateTestCase::DoRun(), LteUeMeasurementsTestCase::DoRun(), LteHandoverDelayTestCase::DoRun(), SpectrumIdealPhyTestCase::DoRun(), Ns3TcpInteroperabilityTestCase::DoRun(), LteDownlinkPowerControlRrcConnectionReconfigurationTestCase::DoRun(), LteCellSelectionTestCase::DoRun(), LteHandoverTargetTestCase::DoRun(), LteUeMeasurementsPiecewiseTestCase1::DoRun(), Ns3TcpSocketTestCase2::DoRun(), NscTcpLossTestCase2::DoRun(), LteUeMeasurementsPiecewiseTestCase2::DoRun(), Ns2MobilityHelperTest::DoRun(), LteUeMeasurementsHandoverTestCase::DoRun(), LteRrcConnectionEstablishmentErrorTestCase::DoRun(), ObjectVectorTraceConfigTestCase::DoRun(), CsmaPacketSocketTestCase::DoRun(), CsmaPingTestCase::DoRun(), ns3::UanHelper::EnableAscii(), ns3::WimaxHelper::EnableAsciiForConnection(), ns3::FdNetDeviceHelper::EnableAsciiInternal(), ns3::EmuHelper::EnableAsciiInternal(), ns3::PointToPointHelper::EnableAsciiInternal(), ns3::CsmaHelper::EnableAsciiInternal(), ns3::YansWifiPhyHelper::EnableAsciiInternal(), ns3::WimaxHelper::EnableAsciiInternal(), ns3::InternetStackHelper::EnableAsciiIpv4Internal(), ns3::InternetStackHelper::EnableAsciiIpv6Internal(), ns3::AthstatsHelper::EnableAthstats(), ns3::LteHelper::EnableDlMacTraces(), ns3::LteHelper::EnableDlPhyTraces(), ns3::LteHelper::EnableDlRxPhyTraces(), ns3::LteHelper::EnableDlTxPhyTraces(), ns3::LteHelper::EnableUlMacTraces(), ns3::LteHelper::EnableUlPhyTraces(), ns3::LteHelper::EnableUlRxPhyTraces(), ns3::LteHelper::EnableUlTxPhyTraces(), ns3::RadioBearerStatsConnector::EnsureConnected(), main(), OcbWifiMacTestCase::PostDeviceConfiguration(), ns3::PyViz::PyViz(), ns3::PyViz::RegisterCsmaLikeDevice(), ns3::PyViz::RegisterDropTracePath(), ns3::PyViz::RegisterPointToPointLikeDevice(), ns3::PyViz::RegisterWifiLikeDevice(), and WifiInterferenceTestCase::WifiSimpleInterference().

+ Here is the call graph for this function:

void ns3::Config::ConnectWithoutContext ( std::string  path,
const CallbackBase &  cb 
)
void ns3::Config::Disconnect ( std::string  path,
const CallbackBase &  cb 
)
Parameters
patha path to match trace sources.
cbthe callback to connect to the matching trace sources.

This function undoes the work of Config::ConnectWithContext.

Definition at line 744 of file config.cc.

References ns3::Singleton< T >::Get(), and NS_LOG_FUNCTION.

Referenced by ns3::RadioBearerStatsConnector::ConnectSrb0Traces(), and ns3::DoMakeTraceSourceAccessor().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::Config::DisconnectWithoutContext ( std::string  path,
const CallbackBase &  cb 
)
Parameters
patha path to match trace sources.
cbthe callback to disconnect to the matching trace sources.

This function undoes the work of Config::Connect.

Definition at line 732 of file config.cc.

References ns3::Singleton< T >::Get(), and NS_LOG_FUNCTION.

Referenced by ns3::TracedCallback< T1, T2, T3, T4, T5, T6, T7, T8 >::Disconnect(), and ns3::DoMakeTraceSourceAccessor().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

Ptr< Object > ns3::Config::GetRootNamespaceObject ( uint32_t  i)
Parameters
ithe index of the requested object.
Returns
the requested root namespace object

Definition at line 773 of file config.cc.

References ns3::Singleton< T >::Get(), and NS_LOG_FUNCTION.

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

uint32_t ns3::Config::GetRootNamespaceObjectN ( void  )
Returns
the number of registered root namespace objects.

Definition at line 767 of file config.cc.

References ns3::Singleton< T >::Get(), and NS_LOG_FUNCTION_NOARGS.

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

MatchContainer ns3::Config::LookupMatches ( std::string  path)
Parameters
paththe path to perform a match against
Returns
a container which contains all the objects which match the input path.

Definition at line 749 of file config.cc.

References ns3::Singleton< T >::Get(), 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:

void ns3::Config::RegisterRootNamespaceObject ( Ptr< Object >  obj)
Parameters
obja 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 755 of file config.cc.

References ns3::Singleton< T >::Get(), and NS_LOG_FUNCTION.

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::Config::Reset ( void  )

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 652 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().

Referenced by LteInterferenceHardFrTestCase::DoRun(), LteCqiGenerationTestCase::DoRun(), LteLinkAdaptationTestCase::DoRun(), LteEnbAntennaTestCase::DoRun(), LteRrcConnectionEstablishmentTestCase::DoRun(), LteX2HandoverTestCase::DoRun(), LteInterferenceStrictFrTestCase::DoRun(), LteDownlinkPowerControlTestCase::DoRun(), LteUplinkOpenLoopPowerControlTestCase::DoRun(), LteHardFrTestCase::DoRun(), LteX2HandoverMeasuresTestCase::DoRun(), LteDownlinkPowerControlRrcConnectionReconfigurationTestCase::DoRun(), LteUplinkClosedLoopPowerControlAbsoluteModeTestCase::DoRun(), LteEpcE2eDataTestCase::DoRun(), LteUplinkClosedLoopPowerControlAccumulatedModeTestCase::DoRun(), LteStrictFrTestCase::DoRun(), LteStrictFrAreaTestCase::DoRun(), LteSoftFrAreaTestCase::DoRun(), LteSoftFfrAreaTestCase::DoRun(), LteEnhancedFfrAreaTestCase::DoRun(), LteDistributedFfrAreaTestCase::DoRun(), LteRrcConnectionEstablishmentErrorTestCase::DoRun(), NetworkNumberAllocatorTestCase::DoTeardown(), NetworkNumber6AllocatorTestCase::DoTeardown(), NetworkAllocatorHelperTestCase::DoTeardown(), IpAddressHelperTestCasev6::DoTeardown(), AddressAllocator6TestCase::DoTeardown(), AddressAllocatorHelperTestCase::DoTeardown(), AddressAllocatorTestCase::DoTeardown(), ResetAllocatorHelperTestCase::DoTeardown(), NetworkAndAddress6TestCase::DoTeardown(), NetworkAndAddressTestCase::DoTeardown(), ExampleAddress6GeneratorTestCase::DoTeardown(), IpAddressHelperTestCasev4::DoTeardown(), ExampleAddressGeneratorTestCase::DoTeardown(), AddressCollision6TestCase::DoTeardown(), and AddressCollisionTestCase::DoTeardown().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::Config::Set ( std::string  path,
const AttributeValue &  value 
)
Parameters
patha path to match attributes.
valuethe 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.

Definition at line 672 of file config.cc.

References ns3::Singleton< T >::Get(), and NS_LOG_FUNCTION.

Referenced by ns3::RawTextConfigLoad::Attributes(), ns3::XmlConfigLoad::Attributes(), LteEpcE2eDataTestCase::DoRun(), RootNamespaceConfigTestCase::DoRun(), UnderRootNamespaceConfigTestCase::DoRun(), ObjectVectorConfigTestCase::DoRun(), SearchAttributesOfParentObjectsTestCase::DoRun(), NetAnimExperiment::IncrementCw(), Experiment::IncrementCw(), and main().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::Config::SetDefault ( std::string  name,
const AttributeValue &  value 
)
Parameters
namethe full name of the attribute
valuethe 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 677 of file config.cc.

References NS_FATAL_ERROR, NS_LOG_FUNCTION, and SetDefaultFailSafe().

Referenced by BatteryLifetimeTest::ConstantLoadTest(), ns3::olsr::Bug780Test::CreateNodes(), ns3::RawTextConfigLoad::Default(), ns3::XmlConfigLoad::Default(), BasicEnergyDepletionTest::DepletionTestCase(), RttTestCase::DoRun(), OneUniformRandomVariableManyGetValueCallsTestCase::DoRun(), LenaMimoTestCase::DoRun(), ManyUniformRandomVariablesOneGetValueCallTestCase::DoRun(), FriisPropagationLossModelTestCase::DoRun(), LenaHarqTestCase::DoRun(), LenaRrFfMacSchedulerTestCase::DoRun(), LenaCqaFfMacSchedulerTestCase1::DoRun(), LteInterferenceHardFrTestCase::DoRun(), LenaDataPhyErrorModelTestCase::DoRun(), LteCqiGenerationTestCase::DoRun(), LenaPfFfMacSchedulerTestCase1::DoRun(), LteDownlinkDataSinrTestCase::DoRun(), LenaFdBetFfMacSchedulerTestCase1::DoRun(), LenaPssFfMacSchedulerTestCase1::DoRun(), LenaTdBetFfMacSchedulerTestCase1::DoRun(), LenaFdMtFfMacSchedulerTestCase::DoRun(), LenaTdMtFfMacSchedulerTestCase::DoRun(), LenaTdTbfqFfMacSchedulerTestCase1::DoRun(), LenaFdTbfqFfMacSchedulerTestCase1::DoRun(), LenaTtaFfMacSchedulerTestCase::DoRun(), LteLinkAdaptationTestCase::DoRun(), Ipv4DynamicGlobalRoutingTestCase::DoRun(), Ns3TcpNoDelayTestCase::DoRun(), LteInterferenceTestCase::DoRun(), LtePathlossModelSystemTestCase::DoRun(), LteEnbAntennaTestCase::DoRun(), LteRrcConnectionEstablishmentTestCase::DoRun(), LteX2HandoverTestCase::DoRun(), LteDownlinkCtrlSinrTestCase::DoRun(), LteInterferenceStrictFrTestCase::DoRun(), LenaPfFfMacSchedulerTestCase2::DoRun(), Ns3TcpLossTestCase::DoRun(), LenaCqaFfMacSchedulerTestCase2::DoRun(), LenaTdBetFfMacSchedulerTestCase2::DoRun(), LenaFdBetFfMacSchedulerTestCase2::DoRun(), Ns3TcpStateTestCase::DoRun(), LenaTdTbfqFfMacSchedulerTestCase2::DoRun(), LteDownlinkPowerControlTestCase::DoRun(), LenaPssFfMacSchedulerTestCase2::DoRun(), LteUeMeasurementsTestCase::DoRun(), LenaFdTbfqFfMacSchedulerTestCase2::DoRun(), LenaDlCtrlPhyErrorModelTestCase::DoRun(), LteUplinkOpenLoopPowerControlTestCase::DoRun(), LteHardFrTestCase::DoRun(), EpcS1uDlTestCase::DoRun(), LteX2HandoverMeasuresTestCase::DoRun(), LteDownlinkPowerControlRrcConnectionReconfigurationTestCase::DoRun(), LteUplinkClosedLoopPowerControlAbsoluteModeTestCase::DoRun(), LteEpcE2eDataTestCase::DoRun(), Ipv4FragmentationTest::DoRun(), LteUplinkClosedLoopPowerControlAccumulatedModeTestCase::DoRun(), LteStrictFrTestCase::DoRun(), LteHandoverTargetTestCase::DoRun(), LteUeMeasurementsPiecewiseTestCase1::DoRun(), TwoRayGroundPropagationLossModelTestCase::DoRun(), Ns3TcpSocketTestCase2::DoRun(), LteStrictFrAreaTestCase::DoRun(), LteSoftFrAreaTestCase::DoRun(), LteSoftFfrAreaTestCase::DoRun(), ChainRegressionTest::DoRun(), LteEnhancedFfrAreaTestCase::DoRun(), LteDistributedFfrAreaTestCase::DoRun(), LteUeMeasurementsPiecewiseTestCase2::DoRun(), LogDistancePropagationLossModelTestCase::DoRun(), EpcS1uUlTestCase::DoRun(), CsmaMulticastTestCase::DoRun(), AttributeTestCase< T >::DoRun(), LteUeMeasurementsHandoverTestCase::DoRun(), Bug555TestCase::DoRun(), Ns3TcpCwndTestCase2::DoRun(), RangePropagationLossModelTestCase::DoRun(), LteRrcConnectionEstablishmentErrorTestCase::DoRun(), CsmaPingTestCase::DoRun(), CsmaRawIpSocketTestCase::DoRun(), experiment(), main(), RoutingExperiment::Run(), BatteryLifetimeTest::VariableLoadTest(), and WifiInterferenceTestCase::WifiSimpleInterference().

+ Here is the call graph for this function:

bool ns3::Config::SetDefaultFailSafe ( std::string  name,
const AttributeValue &  value 
)
Parameters
namethe full name of the attribute
valuethe 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 685 of file config.cc.

References ns3::TypeId::AttributeInformation::checker, ns3::TypeId::GetAttribute(), ns3::TypeId::GetAttributeN(), 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::HandleArgument(), ns3::CommandLine::HandleAttribute(), and SetDefault().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::Config::SetGlobal ( std::string  name,
const AttributeValue &  value 
)
Parameters
namethe name of the requested GlobalValue.
valuethe value to set

This method is equivalent to GlobalValue::Bind

Definition at line 717 of file config.cc.

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

Referenced by LenaDataPhyErrorModelTestCase::DoRun(), LenaDlCtrlPhyErrorModelTestCase::DoRun(), LteCellSelectionTestCase::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:

bool ns3::Config::SetGlobalFailSafe ( std::string  name,
const AttributeValue &  value 
)
Parameters
namethe name of the requested GlobalValue.
valuethe value to set

This method is equivalent to GlobalValue::BindFailSafe

Definition at line 722 of file config.cc.

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

Referenced by ns3::CommandLine::HandleArgument(), and ns3::CommandLine::HandleAttribute().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::Config::UnregisterRootNamespaceObject ( Ptr< Object >  obj)
Parameters
obja new root object

This function undoes the work of Config::RegisterRootNamespaceObject.

Definition at line 761 of file config.cc.

References ns3::Singleton< T >::Get(), and NS_LOG_FUNCTION.

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: