Base class providing common user-level ascii trace operations for helpers representing net devices. More...

#include <trace-helper.h>

Inheritance diagram for ns3::AsciiTraceHelperForDevice:

Public Member Functions
	AsciiTraceHelperForDevice ()
	Construct an AsciiTraceHelperForDevice.

virtual	~AsciiTraceHelperForDevice ()
	Destroy an AsciiTraceHelperForDevice.

void	EnableAscii (std::string prefix, Ptr< NetDevice > nd, bool explicitFilename=false)
	Enable ascii trace output on the indicated net device. More...

void	EnableAscii (Ptr< OutputStreamWrapper > stream, Ptr< NetDevice > nd)
	Enable ascii trace output on the indicated net device. More...

void	EnableAscii (std::string prefix, std::string ndName, bool explicitFilename=false)
	Enable ascii trace output the indicated net device using a device previously named using the ns-3 object name service. More...

void	EnableAscii (Ptr< OutputStreamWrapper > stream, std::string ndName)
	Enable ascii trace output the indicated net device using a device previously named using the ns-3 object name service. More...

void	EnableAscii (std::string prefix, NetDeviceContainer d)
	Enable ascii trace output on each device in the container which is of the appropriate type. More...

void	EnableAscii (Ptr< OutputStreamWrapper > stream, NetDeviceContainer d)
	Enable ascii trace output on each device in the container which is of the appropriate type. More...

void	EnableAscii (std::string prefix, NodeContainer n)
	Enable ascii trace output on each device (which is of the appropriate type) in the nodes provided in the container. More...

void	EnableAscii (Ptr< OutputStreamWrapper > stream, NodeContainer n)
	Enable ascii trace output on each device (which is of the appropriate type) in the nodes provided in the container. More...

void	EnableAscii (std::string prefix, uint32_t nodeid, uint32_t deviceid, bool explicitFilename)
	Enable ascii trace output on the device specified by a global node-id (of a previously created node) and associated device-id. More...

void	EnableAscii (Ptr< OutputStreamWrapper > stream, uint32_t nodeid, uint32_t deviceid)
	Enable ascii trace output on the device specified by a global node-id (of a previously created node) and associated device-id. More...

void	EnableAsciiAll (std::string prefix)
	Enable ascii trace output on each device (which is of the appropriate type) in the set of all nodes created in the simulation. More...

void	EnableAsciiAll (Ptr< OutputStreamWrapper > stream)
	Enable ascii trace output on each device (which is of the appropriate type) in the set of all nodes created in the simulation. More...

virtual void	EnableAsciiInternal (Ptr< OutputStreamWrapper > stream, std::string prefix, Ptr< NetDevice > nd, bool explicitFilename)=0
	Enable ascii trace output on the indicated net device. More...

Private Member Functions
void	EnableAsciiImpl (Ptr< OutputStreamWrapper > stream, std::string prefix, uint32_t nodeid, uint32_t deviceid, bool explicitFilename)

void	EnableAsciiImpl (Ptr< OutputStreamWrapper > stream, std::string prefix, NodeContainer n)

void	EnableAsciiImpl (Ptr< OutputStreamWrapper > stream, std::string prefix, NetDeviceContainer d)

void	EnableAsciiImpl (Ptr< OutputStreamWrapper > stream, std::string prefix, std::string ndName, bool explicitFilename)

void	EnableAsciiImpl (Ptr< OutputStreamWrapper > stream, std::string prefix, Ptr< NetDevice > nd, bool explicitFilename)

Detailed Description

Base class providing common user-level ascii trace operations for helpers representing net devices.

Definition at line 413 of file trace-helper.h.

Member Function Documentation

void ns3::AsciiTraceHelperForDevice::EnableAscii	(	std::string	prefix,
		Ptr< NetDevice >	nd,
		bool	explicitFilename = `false`
	)

Enable ascii trace output on the indicated net device.

Parameters

prefix	Filename prefix to use for ascii files.
nd	Net device for which you want to enable tracing.
explicitFilename	Treat the prefix as an explicit filename if true

Definition at line 462 of file trace-helper.cc.

References EnableAsciiInternal().

void ns3::AsciiTraceHelperForDevice::EnableAscii	(	Ptr< OutputStreamWrapper >	stream,
		Ptr< NetDevice >	nd
	)

Enable ascii trace output on the indicated net device.

Parameters

stream	An OutputStreamWrapper representing an existing file to use when writing trace data.
nd	Net device for which you want to enable tracing.

Definition at line 471 of file trace-helper.cc.

References EnableAsciiInternal().

void ns3::AsciiTraceHelperForDevice::EnableAscii	(	std::string	prefix,
		std::string	ndName,
		bool	explicitFilename = `false`
	)

Enable ascii trace output the indicated net device using a device previously named using the ns-3 object name service.

Parameters

prefix	filename prefix to use for ascii files.
ndName	The name of the net device in which you want to enable tracing.
explicitFilename	Treat the prefix as an explicit filename if true

Definition at line 480 of file trace-helper.cc.

References EnableAsciiImpl().

void ns3::AsciiTraceHelperForDevice::EnableAscii	(	Ptr< OutputStreamWrapper >	stream,
		std::string	ndName
	)

Enable ascii trace output the indicated net device using a device previously named using the ns-3 object name service.

Parameters

stream	An OutputStreamWrapper representing an existing file to use when writing trace data.
ndName	The name of the net device in which you want to enable tracing.

Definition at line 489 of file trace-helper.cc.

References EnableAsciiImpl().

void ns3::AsciiTraceHelperForDevice::EnableAscii	(	std::string	prefix,
		NetDeviceContainer	d
	)

Enable ascii trace output on each device in the container which is of the appropriate type.

Parameters

prefix	Filename prefix to use for ascii files.
d	container of devices of type ns3::CsmaNetDevice

Definition at line 512 of file trace-helper.cc.

References EnableAsciiImpl().

void ns3::AsciiTraceHelperForDevice::EnableAscii	(	Ptr< OutputStreamWrapper >	stream,
		NetDeviceContainer	d
	)

Enable ascii trace output on each device in the container which is of the appropriate type.

Parameters

stream	An OutputStreamWrapper representing an existing file to use when writing trace data.
d	container of devices of type ns3::CsmaNetDevice

Definition at line 521 of file trace-helper.cc.

References EnableAsciiImpl().

void ns3::AsciiTraceHelperForDevice::EnableAscii	(	std::string	prefix,
		NodeContainer	n
	)

Enable ascii trace output on each device (which is of the appropriate type) in the nodes provided in the container.

Parameters

prefix	Filename prefix to use for ascii files.
n	container of nodes.

Definition at line 543 of file trace-helper.cc.

References EnableAsciiImpl().

void ns3::AsciiTraceHelperForDevice::EnableAscii	(	Ptr< OutputStreamWrapper >	stream,
		NodeContainer	n
	)

Enable ascii trace output on each device (which is of the appropriate type) in the nodes provided in the container.

Parameters

stream	An OutputStreamWrapper representing an existing file to use when writing trace data.
n	container of nodes.

Definition at line 552 of file trace-helper.cc.

References EnableAsciiImpl().

void ns3::AsciiTraceHelperForDevice::EnableAscii	(	std::string	prefix,
		uint32_t	nodeid,
		uint32_t	deviceid,
		bool	explicitFilename
	)

Enable ascii trace output on the device specified by a global node-id (of a previously created node) and associated device-id.

Parameters

prefix	Filename prefix to use when creating ascii trace files
nodeid	The node identifier/number of the node on which to enable ascii tracing
deviceid	The device identifier/index of the device on which to enable ascii tracing
explicitFilename	Treat the prefix as an explicit filename if true

Definition at line 606 of file trace-helper.cc.

References EnableAsciiImpl().

void ns3::AsciiTraceHelperForDevice::EnableAscii	(	Ptr< OutputStreamWrapper >	stream,
		uint32_t	nodeid,
		uint32_t	deviceid
	)

Enable ascii trace output on the device specified by a global node-id (of a previously created node) and associated device-id.

Parameters

stream	An OutputStreamWrapper representing an existing file to use when writing trace data.
nodeid	The node identifier/number of the node on which to enable ascii tracing
deviceid	The device identifier/index of the device on which to enable ascii tracing

Definition at line 597 of file trace-helper.cc.

References EnableAsciiImpl().

void ns3::AsciiTraceHelperForDevice::EnableAsciiAll ( std::string prefix )

Enable ascii trace output on each device (which is of the appropriate type) in the set of all nodes created in the simulation.

Parameters

prefix Filename prefix to use for ascii files.

Definition at line 579 of file trace-helper.cc.

References EnableAsciiImpl(), and ns3::NodeContainer::GetGlobal().

Referenced by Ns3TcpLossTestCase::DoRun(), and Ns3TcpStateTestCase::DoRun().

void ns3::AsciiTraceHelperForDevice::EnableAsciiAll ( Ptr< OutputStreamWrapper > stream )

Enable ascii trace output on each device (which is of the appropriate type) in the set of all nodes created in the simulation.

Parameters

stream An OutputStreamWrapper representing an existing file to use when writing trace data.

Definition at line 588 of file trace-helper.cc.

References EnableAsciiImpl(), and ns3::NodeContainer::GetGlobal().

void ns3::AsciiTraceHelperForDevice::EnableAsciiImpl	(	Ptr< OutputStreamWrapper >	stream,
		std::string	prefix,
		uint32_t	nodeid,
		uint32_t	deviceid,
		bool	explicitFilename
	)

private

Avoid code duplication.

Definition at line 619 of file trace-helper.cc.

References ns3::NodeContainer::Begin(), EnableAsciiInternal(), ns3::NodeContainer::End(), ns3::Node::GetDevice(), ns3::NodeContainer::GetGlobal(), ns3::Node::GetId(), ns3::Node::GetNDevices(), and NS_ABORT_MSG_IF.

Referenced by EnableAscii(), EnableAsciiAll(), and EnableAsciiImpl().

void ns3::AsciiTraceHelperForDevice::EnableAsciiImpl	(	Ptr< OutputStreamWrapper >	stream,
		std::string	prefix,
		NodeContainer	n
	)

private

Avoid code duplication.

Definition at line 561 of file trace-helper.cc.

References ns3::NetDeviceContainer::Add(), ns3::NodeContainer::Begin(), EnableAsciiImpl(), ns3::NodeContainer::End(), ns3::Node::GetDevice(), and ns3::Node::GetNDevices().

void ns3::AsciiTraceHelperForDevice::EnableAsciiImpl	(	Ptr< OutputStreamWrapper >	stream,
		std::string	prefix,
		NetDeviceContainer	d
	)

private

Avoid code duplication.

Definition at line 530 of file trace-helper.cc.

References ns3::NetDeviceContainer::Begin(), EnableAsciiInternal(), and ns3::NetDeviceContainer::End().

void ns3::AsciiTraceHelperForDevice::EnableAsciiImpl	(	Ptr< OutputStreamWrapper >	stream,
		std::string	prefix,
		std::string	ndName,
		bool	explicitFilename
	)

private

Avoid code duplication.

Definition at line 498 of file trace-helper.cc.

References EnableAsciiInternal().

void ns3::AsciiTraceHelperForDevice::EnableAsciiImpl	(	Ptr< OutputStreamWrapper >	stream,
		std::string	prefix,
		Ptr< NetDevice >	nd,
		bool	explicitFilename
	)

private

Avoid code duplication.

virtual void ns3::AsciiTraceHelperForDevice::EnableAsciiInternal	(	Ptr< OutputStreamWrapper >	stream,
		std::string	prefix,
		Ptr< NetDevice >	nd,
		bool	explicitFilename
	)

pure virtual

Enable ascii trace output on the indicated net device.

The implementation is expected to use a provided Ptr<OutputStreamWrapper> if it is non-null. If the OutputStreamWrapper is null, the implementation is expected to use a provided prefix to construct a new file name for each net device using the rules described in the class overview.

If the prefix is provided, there will be one file per net device created. In this case, adding a trace context to the file would be pointless, so the device implementation is expected to TraceConnectWithoutContext.

If the output stream object is provided, there may be many different devices writing to a single file. In this case, the device adding a trace context could be important, so the device implementation is expected to TraceConnect.

Parameters

stream	An OutputStreamWrapper representing an existing file to use when writing trace data.
prefix	Filename prefix to use for ascii trace files.
nd	Net device for which you want to enable tracing
explicitFilename	Treat the prefix as an explicit filename if true

Implemented in ns3::WimaxHelper, ns3::YansWifiPhyHelper, ns3::CsmaHelper, ns3::PointToPointHelper, ns3::EmuHelper, and ns3::FdNetDeviceHelper.

Referenced by EnableAscii(), and EnableAsciiImpl().

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

src/network/helper/trace-helper.h
src/network/helper/trace-helper.cc

Public Member Functions

Private Member Functions

Detailed Description

Member Function Documentation