A Discrete-Event Network Simulator
API
ns3::PcapHelperForDevice Class Referenceabstract

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

#include "trace-helper.h"

+ Inheritance diagram for ns3::PcapHelperForDevice:

Public Member Functions

 PcapHelperForDevice ()
 Construct a PcapHelperForDevice. More...
 
virtual ~PcapHelperForDevice ()
 Destroy a PcapHelperForDevice. More...
 
void EnablePcap (std::string prefix, NetDeviceContainer d, bool promiscuous=false)
 Enable pcap output on each device in the container which is of the appropriate type. More...
 
void EnablePcap (std::string prefix, NodeContainer n, bool promiscuous=false)
 Enable pcap output on each device (which is of the appropriate type) in the nodes provided in the container. More...
 
void EnablePcap (std::string prefix, Ptr< NetDevice > nd, bool promiscuous=false, bool explicitFilename=false)
 Enable pcap output the indicated net device. More...
 
void EnablePcap (std::string prefix, std::string ndName, bool promiscuous=false, bool explicitFilename=false)
 Enable pcap output the indicated net device using a device previously named using the ns-3 object name service. More...
 
void EnablePcap (std::string prefix, uint32_t nodeid, uint32_t deviceid, bool promiscuous=false)
 Enable pcap output on the device specified by a global node-id (of a previously created node) and associated device-id. More...
 
void EnablePcapAll (std::string prefix, bool promiscuous=false)
 Enable pcap output on each device (which is of the appropriate type) in the set of all nodes created in the simulation. More...
 
virtual void EnablePcapInternal (std::string prefix, Ptr< NetDevice > nd, bool promiscuous, bool explicitFilename)=0
 Enable pcap output the indicated net device. More...
 

Detailed Description

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

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

Constructor & Destructor Documentation

◆ PcapHelperForDevice()

ns3::PcapHelperForDevice::PcapHelperForDevice ( )
inline

Construct a PcapHelperForDevice.

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

◆ ~PcapHelperForDevice()

virtual ns3::PcapHelperForDevice::~PcapHelperForDevice ( )
inlinevirtual

Destroy a PcapHelperForDevice.

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

Member Function Documentation

◆ EnablePcap() [1/5]

void ns3::PcapHelperForDevice::EnablePcap ( std::string  prefix,
NetDeviceContainer  d,
bool  promiscuous = false 
)

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

Parameters
prefixFilename prefix to use for pcap files.
dcontainer of devices of type ns3::CsmaNetDevice
promiscuousIf true capture all possible packets available at the device.

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

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

+ Here is the call graph for this function:

◆ EnablePcap() [2/5]

void ns3::PcapHelperForDevice::EnablePcap ( std::string  prefix,
NodeContainer  n,
bool  promiscuous = false 
)

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

Parameters
prefixFilename prefix to use for pcap files.
ncontainer of nodes.
promiscuousIf true capture all possible packets available at the device.

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

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

+ Here is the call graph for this function:

◆ EnablePcap() [3/5]

void ns3::PcapHelperForDevice::EnablePcap ( std::string  prefix,
Ptr< NetDevice nd,
bool  promiscuous = false,
bool  explicitFilename = false 
)

Enable pcap output the indicated net device.

Parameters
prefixFilename prefix to use for pcap files.
ndNet device for which you want to enable tracing.
promiscuousIf true capture all possible packets available at the device.
explicitFilenameTreat the prefix as an explicit filename if true

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

References EnablePcapInternal().

Referenced by WaveNetDeviceExample::CreateWaveNodes(), WifiMsduAggregatorThroughputTest::DoRun(), EnablePcap(), and EnablePcapAll().

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

◆ EnablePcap() [4/5]

void ns3::PcapHelperForDevice::EnablePcap ( std::string  prefix,
std::string  ndName,
bool  promiscuous = false,
bool  explicitFilename = false 
)

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

Parameters
prefixfilename prefix to use for pcap files.
ndNameThe name of the net device in which you want to enable tracing.
promiscuousIf true capture all possible packets available at the device.
explicitFilenameTreat the prefix as an explicit filename if true

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

References EnablePcap().

+ Here is the call graph for this function:

◆ EnablePcap() [5/5]

void ns3::PcapHelperForDevice::EnablePcap ( std::string  prefix,
uint32_t  nodeid,
uint32_t  deviceid,
bool  promiscuous = false 
)

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

Parameters
prefixFilename prefix to use for pcap files.
nodeidthe node id
deviceidthe device id
promiscuousIf true capture all possible packets available at the device.

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

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

+ Here is the call graph for this function:

◆ EnablePcapAll()

void ns3::PcapHelperForDevice::EnablePcapAll ( std::string  prefix,
bool  promiscuous = false 
)

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

Parameters
prefixFilename prefix to use for pcap files.
promiscuousIf true capture all possible packets available at the device.

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

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

Referenced by ns3::PointToPointEpcHelper::AddEnb(), ns3::NoBackhaulEpcHelper::AddX2Interface(), AodvExample::CreateDevices(), ChainRegressionTest::CreateDevices(), TracerouteExample::CreateDevices(), HwmpProactiveRegressionTest::CreateDevices(), HwmpReactiveRegressionTest::CreateDevices(), HwmpSimplestRegressionTest::CreateDevices(), HwmpDoRfRegressionTest::CreateDevices(), PeerManagementProtocolRegressionTest::CreateDevices(), FlameRegressionTest::CreateDevices(), DsdvManetExample::CreateDevices(), MeshTest::CreateNodes(), Ns3TcpLossTestCase::DoRun(), Ns3TcpStateTestCase::DoRun(), and VanetRoutingExperiment::SetupAdhocDevices().

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

◆ EnablePcapInternal()

virtual void ns3::PcapHelperForDevice::EnablePcapInternal ( std::string  prefix,
Ptr< NetDevice nd,
bool  promiscuous,
bool  explicitFilename 
)
pure virtual

Enable pcap output the indicated net device.

Parameters
prefixFilename prefix to use for pcap files.
ndNet device for which you want to enable tracing.
promiscuousIf true capture all possible packets available at the device.
explicitFilenameTreat the prefix as an explicit filename if true

Implemented in ns3::WifiPhyHelper, ns3::YansWavePhyHelper, ns3::PointToPointHelper, ns3::LrWpanHelper, ns3::FdNetDeviceHelper, ns3::CsmaHelper, and ns3::WimaxHelper.

Referenced by EnablePcap().

+ Here is the caller graph for this function:

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