Create an application which sends a UDP packet and waits for an echo of this packet. More...

#include "udp-echo-helper.h"

Public Member Functions
	UdpEchoClientHelper (Address ip, uint16_t port)
	Create UdpEchoClientHelper which will make life easier for people trying to set up simulations with echos. More...

	UdpEchoClientHelper (Address addr)
	Create UdpEchoClientHelper which will make life easier for people trying to set up simulations with echos. More...

ApplicationContainer	Install (Ptr< Node > node) const
	Create a udp echo client application on the specified node. More...

ApplicationContainer	Install (std::string nodeName) const
	Create a udp echo client application on the specified node. More...

ApplicationContainer	Install (NodeContainer c) const

void	SetAttribute (std::string name, const AttributeValue &value)
	Record an attribute to be set in each Application after it is is created. More...

void	SetFill (Ptr< Application > app, std::string fill)
	Given a pointer to a UdpEchoClient application, set the data fill of the packet (what is sent as data to the server) to the contents of the fill string (including the trailing zero terminator). More...

void	SetFill (Ptr< Application > app, uint8_t fill, uint32_t dataLength)
	Given a pointer to a UdpEchoClient application, set the data fill of the packet (what is sent as data to the server) to the contents of the fill byte. More...

void	SetFill (Ptr< Application > app, uint8_t *fill, uint32_t fillLength, uint32_t dataLength)
	Given a pointer to a UdpEchoClient application, set the data fill of the packet (what is sent as data to the server) to the contents of the fill buffer, repeated as many times as is required. More...

Private Member Functions
Ptr< Application >	InstallPriv (Ptr< Node > node) const
	Install an ns3::UdpEchoClient on the node configured with all the attributes set with SetAttribute. More...

Private Attributes
ObjectFactory	m_factory
	Object factory. More...

Detailed Description

Create an application which sends a UDP packet and waits for an echo of this packet.

Definition at line 106 of file udp-echo-helper.h.

Constructor & Destructor Documentation

◆ UdpEchoClientHelper() [1/2]

ns3::UdpEchoClientHelper::UdpEchoClientHelper	(	Address	ip,
		uint16_t	port
	)

Create UdpEchoClientHelper which will make life easier for people trying to set up simulations with echos.

Use this variant with addresses that do not include a port value (e.g., Ipv4Address and Ipv6Address).

Parameters

ip	The IP address of the remote udp echo server
port	The port number of the remote udp echo server

Definition at line 76 of file udp-echo-helper.cc.

References first::address, ns3::UdpEchoClient::GetTypeId(), m_factory, port, SetAttribute(), and ns3::ObjectFactory::SetTypeId().

◆ UdpEchoClientHelper() [2/2]

ns3::UdpEchoClientHelper::UdpEchoClientHelper ( Address addr )

Create UdpEchoClientHelper which will make life easier for people trying to set up simulations with echos.

Use this variant with addresses that do include a port value (e.g., InetSocketAddress and Inet6SocketAddress).

Parameters

addr	The address of the remote udp echo server

Definition at line 83 of file udp-echo-helper.cc.

References first::address, ns3::UdpEchoClient::GetTypeId(), m_factory, SetAttribute(), and ns3::ObjectFactory::SetTypeId().

Member Function Documentation

◆ Install() [1/3]

ApplicationContainer ns3::UdpEchoClientHelper::Install ( Ptr< Node > node ) const

Create a udp echo client application on the specified node.

The Node is provided as a Ptr<Node>.

Parameters

node	The Ptr<Node> on which to create the UdpEchoClientApplication.

Returns: An ApplicationContainer that holds a Ptr<Application> to the application created

Definition at line 116 of file udp-echo-helper.cc.

References InstallPriv().

Referenced by LteIpv6RoutingTestCase::DoRun(), and experiment().

◆ Install() [2/3]

ApplicationContainer ns3::UdpEchoClientHelper::Install ( std::string nodeName ) const

Create a udp echo client application on the specified node.

The Node is provided as a string name of a Node that has been previously associated using the Object Name Service.

Parameters

nodeName The name of the node on which to create the UdpEchoClientApplication

Returns: An ApplicationContainer that holds a Ptr<Application> to the application created

Definition at line 122 of file udp-echo-helper.cc.

References InstallPriv().

◆ Install() [3/3]

ApplicationContainer ns3::UdpEchoClientHelper::Install ( NodeContainer c ) const

Parameters

c the nodes

Create one udp echo client application on each of the input nodes

Returns: the applications created, one application per input node.

Definition at line 129 of file udp-echo-helper.cc.

References ns3::ApplicationContainer::Add(), ns3::NodeContainer::Begin(), ns3::NodeContainer::End(), and InstallPriv().

◆ InstallPriv()

Ptr< Application > ns3::UdpEchoClientHelper::InstallPriv ( Ptr< Node > node ) const

private

Install an ns3::UdpEchoClient on the node configured with all the attributes set with SetAttribute.

Parameters

node	The node on which an UdpEchoClient will be installed.

Returns: Ptr to the application installed.

Definition at line 141 of file udp-echo-helper.cc.

References ns3::Node::AddApplication(), ns3::ObjectFactory::Create(), and m_factory.

Referenced by Install().

◆ SetAttribute()

void ns3::UdpEchoClientHelper::SetAttribute	(	std::string	name,
		const AttributeValue &	value
	)

Record an attribute to be set in each Application after it is is created.

Parameters

name	the name of the attribute to set
value	the value of the attribute to set

Definition at line 90 of file udp-echo-helper.cc.

References m_factory, and ns3::ObjectFactory::Set().

Referenced by LteIpv6RoutingTestCase::DoRun(), EpcS1uDlTestCase::DoRun(), LteEpcE2eDataTestCase::DoRun(), experiment(), and UdpEchoClientHelper().

◆ SetFill() [1/3]

void ns3::UdpEchoClientHelper::SetFill	(	Ptr< Application >	app,
		std::string	fill
	)

Given a pointer to a UdpEchoClient application, set the data fill of the packet (what is sent as data to the server) to the contents of the fill string (including the trailing zero terminator).

Warning: The size of resulting echo packets will be automatically adjusted to reflect the size of the fill string – this means that the PacketSize attribute may be changed as a result of this call.

Parameters

app	Smart pointer to the application (real type must be UdpEchoClient).
fill	The string to use as the actual echo data bytes.

Definition at line 98 of file udp-echo-helper.cc.

References ns3::Object::GetObject().

Referenced by SetFill().

◆ SetFill() [2/3]

void ns3::UdpEchoClientHelper::SetFill	(	Ptr< Application >	app,
		uint8_t	fill,
		uint32_t	dataLength
	)

Given a pointer to a UdpEchoClient application, set the data fill of the packet (what is sent as data to the server) to the contents of the fill byte.

The fill byte will be used to initialize the contents of the data packet.

Warning: The size of resulting echo packets will be automatically adjusted to reflect the dataLength parameter – this means that the PacketSize attribute may be changed as a result of this call.

Parameters

app	Smart pointer to the application (real type must be UdpEchoClient).
fill	The byte to be repeated in constructing the packet data..
dataLength	The desired length of the resulting echo packet data.

Definition at line 104 of file udp-echo-helper.cc.

References ns3::Object::GetObject(), and SetFill().

◆ SetFill() [3/3]

void ns3::UdpEchoClientHelper::SetFill	(	Ptr< Application >	app,
		uint8_t *	fill,
		uint32_t	fillLength,
		uint32_t	dataLength
	)

Given a pointer to a UdpEchoClient application, set the data fill of the packet (what is sent as data to the server) to the contents of the fill buffer, repeated as many times as is required.

Initializing the fill to the contents of a single buffer is accomplished by providing a complete buffer with fillLength set to your desired dataLength

Warning: The size of resulting echo packets will be automatically adjusted to reflect the dataLength parameter – this means that the PacketSize attribute of the Application may be changed as a result of this call.

Parameters

app	Smart pointer to the application (real type must be UdpEchoClient).
fill	The fill pattern to use when constructing packets.
fillLength	The number of bytes in the provided fill pattern.
dataLength	The desired length of the final echo data.

Definition at line 110 of file udp-echo-helper.cc.

References ns3::Object::GetObject(), and SetFill().

Member Data Documentation

◆ m_factory

ObjectFactory ns3::UdpEchoClientHelper::m_factory

private

Object factory.

Definition at line 227 of file udp-echo-helper.h.

Referenced by InstallPriv(), SetAttribute(), and UdpEchoClientHelper().

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

src/applications/helper/udp-echo-helper.h
src/applications/helper/udp-echo-helper.cc

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ UdpEchoClientHelper() [1/2]

◆ UdpEchoClientHelper() [2/2]

Member Function Documentation

◆ Install() [1/3]

◆ Install() [2/3]

◆ Install() [3/3]

◆ InstallPriv()

◆ SetAttribute()

◆ SetFill() [1/3]

◆ SetFill() [2/3]

◆ SetFill() [3/3]

Member Data Documentation

◆ m_factory