Implementation of the UDP protocol. More...

#include <udp-l4-protocol.h>

Inheritance diagram for ns3::UdpL4Protocol:

Collaboration diagram for ns3::UdpL4Protocol:

Public Member Functions
	UdpL4Protocol ()
virtual	~UdpL4Protocol ()
Ipv4EndPoint *	Allocate (void)
Ipv4EndPoint *	Allocate (Ipv4Address address)
Ipv4EndPoint *	Allocate (uint16_t port)
Ipv4EndPoint *	Allocate (Ipv4Address address, uint16_t port)
Ipv4EndPoint *	Allocate (Ipv4Address localAddress, uint16_t localPort, Ipv4Address peerAddress, uint16_t peerPort)
Ipv6EndPoint *	Allocate6 (void)
Ipv6EndPoint *	Allocate6 (Ipv6Address address)
Ipv6EndPoint *	Allocate6 (uint16_t port)
Ipv6EndPoint *	Allocate6 (Ipv6Address address, uint16_t port)
Ipv6EndPoint *	Allocate6 (Ipv6Address localAddress, uint16_t localPort, Ipv6Address peerAddress, uint16_t peerPort)
Ptr< Socket >	CreateSocket (void)
void	DeAllocate (Ipv4EndPoint *endPoint)
void	DeAllocate (Ipv6EndPoint *endPoint)
virtual IpL4Protocol::DownTargetCallback	GetDownTarget (void) const
virtual IpL4Protocol::DownTargetCallback6	GetDownTarget6 (void) const
virtual int	GetProtocolNumber (void) const
virtual enum IpL4Protocol::RxStatus	Receive (Ptr< Packet > p, Ipv4Header const &header, Ptr< Ipv4Interface > interface)
	Receive a packet up the protocol stack.
virtual enum IpL4Protocol::RxStatus	Receive (Ptr< Packet > p, Ipv6Address &src, Ipv6Address &dst, Ptr< Ipv6Interface > interface)
virtual void	ReceiveIcmp (Ipv4Address icmpSource, uint8_t icmpTtl, uint8_t icmpType, uint8_t icmpCode, uint32_t icmpInfo, Ipv4Address payloadSource, Ipv4Address payloadDestination, const uint8_t payload[8])
	Receive an ICMP packet.
virtual void	ReceiveIcmp (Ipv6Address icmpSource, uint8_t icmpTtl, uint8_t icmpType, uint8_t icmpCode, uint32_t icmpInfo, Ipv6Address payloadSource, Ipv6Address payloadDestination, const uint8_t payload[8])
void	Send (Ptr< Packet > packet, Ipv4Address saddr, Ipv4Address daddr, uint16_t sport, uint16_t dport)
	Send a packet via UDP.
void	Send (Ptr< Packet > packet, Ipv4Address saddr, Ipv4Address daddr, uint16_t sport, uint16_t dport, Ptr< Ipv4Route > route)
void	Send (Ptr< Packet > packet, Ipv6Address saddr, Ipv6Address daddr, uint16_t sport, uint16_t dport)
void	Send (Ptr< Packet > packet, Ipv6Address saddr, Ipv6Address daddr, uint16_t sport, uint16_t dport, Ptr< Ipv6Route > route)
virtual void	SetDownTarget (IpL4Protocol::DownTargetCallback cb)
virtual void	SetDownTarget6 (IpL4Protocol::DownTargetCallback6 cb)
void	SetNode (Ptr< Node > node)
Public Member Functions inherited from ns3::IpL4Protocol
virtual	~IpL4Protocol ()
Public Member Functions inherited from ns3::Object
	Object ()
virtual	~Object ()
void	AggregateObject (Ptr< Object > other)
void	Dispose (void)
AggregateIterator	GetAggregateIterator (void) const
virtual TypeId	GetInstanceTypeId (void) const
template<typename T >
Ptr< T >	GetObject (void) const
template<typename T >
Ptr< T >	GetObject (TypeId tid) const
void	Start (void)
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
	SimpleRefCount ()
	SimpleRefCount (const SimpleRefCount &o)
uint32_t	GetReferenceCount (void) const
SimpleRefCount &	operator= (const SimpleRefCount &o)
void	Ref (void) const
void	Unref (void) const
Public Member Functions inherited from ns3::ObjectBase
virtual	~ObjectBase ()
void	GetAttribute (std::string name, AttributeValue &value) const
bool	GetAttributeFailSafe (std::string name, AttributeValue &attribute) const
void	SetAttribute (std::string name, const AttributeValue &value)
bool	SetAttributeFailSafe (std::string name, const AttributeValue &value)
bool	TraceConnect (std::string name, std::string context, const CallbackBase &cb)
bool	TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
bool	TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
bool	TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)

Static Public Member Functions
static TypeId	GetTypeId (void)
	This method returns the TypeId associated to ns3::UdpL4Protocol.

Static Public Attributes
static const uint8_t	PROT_NUMBER = 17

Protected Member Functions
virtual void	DoDispose (void)
virtual void	NotifyNewAggregate ()

Private Member Functions
	UdpL4Protocol (const UdpL4Protocol &o)
UdpL4Protocol &	operator= (const UdpL4Protocol &o)

Private Attributes
IpL4Protocol::DownTargetCallback	m_downTarget
IpL4Protocol::DownTargetCallback6	m_downTarget6
Ipv4EndPointDemux *	m_endPoints
Ipv6EndPointDemux *	m_endPoints6
Ptr< Node >	m_node
std::vector< Ptr< UdpSocketImpl > >	m_sockets

Additional Inherited Members
Public Types inherited from ns3::IpL4Protocol
typedef Callback< void, Ptr < Packet >, Ipv4Address, Ipv4Address, uint8_t, Ptr < Ipv4Route > >	DownTargetCallback
typedef Callback< void, Ptr < Packet >, Ipv6Address, Ipv6Address, uint8_t, Ptr < Ipv6Route > >	DownTargetCallback6
enum	RxStatus { RX_OK, RX_CSUM_FAILED, RX_ENDPOINT_CLOSED, RX_ENDPOINT_UNREACH }

Detailed Description

Implementation of the UDP protocol.

Definition at line 48 of file udp-l4-protocol.h.

Constructor & Destructor Documentation

ns3::UdpL4Protocol::UdpL4Protocol ( )

Definition at line 66 of file udp-l4-protocol.cc.

References NS_LOG_FUNCTION_NOARGS.

ns3::UdpL4Protocol::~UdpL4Protocol ( )

virtual

Definition at line 72 of file udp-l4-protocol.cc.

References NS_LOG_FUNCTION_NOARGS.

ns3::UdpL4Protocol::UdpL4Protocol ( const UdpL4Protocol & o )

private

Member Function Documentation

Ipv4EndPoint * ns3::UdpL4Protocol::Allocate ( void )

Definition at line 173 of file udp-l4-protocol.cc.

References ns3::Ipv4EndPointDemux::Allocate(), m_endPoints, and NS_LOG_FUNCTION_NOARGS.

Referenced by ns3::UdpSocketImpl::Bind().

Here is the call graph for this function:

Here is the caller graph for this function:

Ipv4EndPoint * ns3::UdpL4Protocol::Allocate ( Ipv4Address address )

Definition at line 180 of file udp-l4-protocol.cc.

References ns3::Ipv4EndPointDemux::Allocate(), m_endPoints, and NS_LOG_FUNCTION.

Here is the call graph for this function:

Ipv4EndPoint * ns3::UdpL4Protocol::Allocate ( uint16_t port )

Definition at line 187 of file udp-l4-protocol.cc.

References ns3::Ipv4EndPointDemux::Allocate(), m_endPoints, and NS_LOG_FUNCTION.

Here is the call graph for this function:

Ipv4EndPoint * ns3::UdpL4Protocol::Allocate	(	Ipv4Address	address,
		uint16_t	port
	)

Definition at line 194 of file udp-l4-protocol.cc.

References ns3::Ipv4EndPointDemux::Allocate(), m_endPoints, and NS_LOG_FUNCTION.

Here is the call graph for this function:

Ipv4EndPoint * ns3::UdpL4Protocol::Allocate	(	Ipv4Address	localAddress,
		uint16_t	localPort,
		Ipv4Address	peerAddress,
		uint16_t	peerPort
	)

Definition at line 200 of file udp-l4-protocol.cc.

References ns3::Ipv4EndPointDemux::Allocate(), m_endPoints, and NS_LOG_FUNCTION.

Here is the call graph for this function:

Ipv6EndPoint * ns3::UdpL4Protocol::Allocate6 ( void )

Definition at line 216 of file udp-l4-protocol.cc.

References ns3::Ipv6EndPointDemux::Allocate(), m_endPoints6, and NS_LOG_FUNCTION_NOARGS.

Referenced by ns3::UdpSocketImpl::Bind(), and ns3::UdpSocketImpl::Bind6().

Here is the call graph for this function:

Here is the caller graph for this function:

Ipv6EndPoint * ns3::UdpL4Protocol::Allocate6 ( Ipv6Address address )

Definition at line 223 of file udp-l4-protocol.cc.

References ns3::Ipv6EndPointDemux::Allocate(), m_endPoints6, and NS_LOG_FUNCTION.

Here is the call graph for this function:

Ipv6EndPoint * ns3::UdpL4Protocol::Allocate6 ( uint16_t port )

Definition at line 230 of file udp-l4-protocol.cc.

References ns3::Ipv6EndPointDemux::Allocate(), m_endPoints6, and NS_LOG_FUNCTION.

Here is the call graph for this function:

Ipv6EndPoint * ns3::UdpL4Protocol::Allocate6	(	Ipv6Address	address,
		uint16_t	port
	)

Definition at line 237 of file udp-l4-protocol.cc.

References ns3::Ipv6EndPointDemux::Allocate(), m_endPoints6, and NS_LOG_FUNCTION.

Here is the call graph for this function:

Ipv6EndPoint * ns3::UdpL4Protocol::Allocate6	(	Ipv6Address	localAddress,
		uint16_t	localPort,
		Ipv6Address	peerAddress,
		uint16_t	peerPort
	)

Definition at line 243 of file udp-l4-protocol.cc.

References ns3::Ipv6EndPointDemux::Allocate(), m_endPoints6, and NS_LOG_FUNCTION.

Here is the call graph for this function:

Ptr< Socket > ns3::UdpL4Protocol::CreateSocket ( void )

Returns: A smart Socket pointer to a UdpSocket, allocated by this instance of the UDP protocol

Definition at line 162 of file udp-l4-protocol.cc.

References m_node, m_sockets, NS_LOG_FUNCTION_NOARGS, ns3::UdpSocketImpl::SetNode(), and ns3::UdpSocketImpl::SetUdp().

Referenced by ns3::UdpSocketFactoryImpl::CreateSocket().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::UdpL4Protocol::DeAllocate ( Ipv4EndPoint * endPoint )

Definition at line 209 of file udp-l4-protocol.cc.

References ns3::Ipv4EndPointDemux::DeAllocate(), m_endPoints, and NS_LOG_FUNCTION.

Referenced by ns3::UdpSocketImpl::~UdpSocketImpl().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::UdpL4Protocol::DeAllocate ( Ipv6EndPoint * endPoint )

Definition at line 252 of file udp-l4-protocol.cc.

References ns3::Ipv6EndPointDemux::DeAllocate(), m_endPoints6, and NS_LOG_FUNCTION.

Here is the call graph for this function:

void ns3::UdpL4Protocol::DoDispose ( void )

protectedvirtual

This method is called by Object::Dispose or by the object's destructor, whichever comes first.

Subclasses are expected to implement their real destruction code in an overriden version of this method and chain up to their parent's implementation once they are done. i.e., for simplicity, the destructor of every subclass should be empty and its content should be moved to the associated DoDispose method.

It is safe to call GetObject from within this method.

Reimplemented from ns3::Object.

Definition at line 133 of file udp-l4-protocol.cc.

References m_downTarget, m_downTarget6, m_endPoints, m_endPoints6, m_node, m_sockets, NS_LOG_FUNCTION_NOARGS, and ns3::Callback< R, T1, T2, T3, T4, T5, T6, T7, T8, T9 >::Nullify().

Here is the call graph for this function:

IpL4Protocol::DownTargetCallback ns3::UdpL4Protocol::GetDownTarget ( void ) const

virtual

This method allows a caller to get the current down target callback set for this L4 protocol, for

Returns: current Callback for the L4 protocol

Implements ns3::IpL4Protocol.

Definition at line 508 of file udp-l4-protocol.cc.

References m_downTarget.

IpL4Protocol::DownTargetCallback6 ns3::UdpL4Protocol::GetDownTarget6 ( void ) const

virtual

Implements ns3::IpL4Protocol.

Definition at line 521 of file udp-l4-protocol.cc.

References m_downTarget6.

int ns3::UdpL4Protocol::GetProtocolNumber ( void ) const

virtual

Returns: the protocol number of this protocol.

Implements ns3::IpL4Protocol.

Definition at line 126 of file udp-l4-protocol.cc.

References PROT_NUMBER.

TypeId ns3::UdpL4Protocol::GetTypeId ( void )

static

This method returns the TypeId associated to ns3::UdpL4Protocol.

Attributes defined for this type:

SocketList: The list of sockets associated to this protocol.
- Set with class: ns3::ObjectPtrContainerValue
- Underlying type: ns3::Ptr< ns3::UdpSocketImpl >
- Flags: read

Attributes defined in parent class ns3::IpL4Protocol:

ProtocolNumber: The Ip protocol number.
- Set with class: ns3::UintegerValue
- Underlying type: int32_t 18446744071562067968:2147483647
- Flags: read

No TraceSources defined for this type.

Reimplemented from ns3::IpL4Protocol.

Definition at line 53 of file udp-l4-protocol.cc.

References m_sockets, ns3::MakeObjectVectorAccessor(), and ns3::TypeId::SetParent().

Here is the call graph for this function:

void ns3::UdpL4Protocol::NotifyNewAggregate ( void )

protectedvirtual

This method is invoked whenever two sets of objects are aggregated together. It is invoked exactly once for each object in both sets. This method can be overriden by subclasses who wish to be notified of aggregation events. These subclasses must chain up to their base class NotifyNewAggregate method. It is safe to call GetObject and AggregateObject from within this method.

This function must be implemented in the stack that needs to notify other stacks connected to the node of their presence in the node.

Reimplemented from ns3::Object.

Definition at line 89 of file udp-l4-protocol.cc.

References ns3::Object::AggregateObject(), ns3::Object::GetObject(), ns3::Callback< R, T1, T2, T3, T4, T5, T6, T7, T8, T9 >::IsNull(), m_downTarget, m_downTarget6, m_node, ns3::MakeCallback(), NS_LOG_FUNCTION, ns3::Ipv4::Send(), ns3::Ipv6L3Protocol::Send(), SetDownTarget(), SetDownTarget6(), and SetNode().

Here is the call graph for this function:

UdpL4Protocol& ns3::UdpL4Protocol::operator= ( const UdpL4Protocol & o )

private

enum IpL4Protocol::RxStatus ns3::UdpL4Protocol::Receive	(	Ptr< Packet >	p,
		Ipv4Header const &	header,
		Ptr< Ipv4Interface >	interface
	)

virtual

Receive a packet up the protocol stack.

Parameters

p	The Packet to dump the contents into
header	IPv4 Header information
interface	the interface from which the packet is coming.

Implements ns3::IpL4Protocol.

Definition at line 313 of file udp-l4-protocol.cc.

References ns3::Node::ChecksumEnabled(), ns3::Packet::Copy(), ns3::UdpHeader::EnableChecksums(), ns3::Ipv4Header::GetDestination(), ns3::UdpHeader::GetDestinationPort(), ns3::Ipv4Header::GetSource(), ns3::UdpHeader::GetSourcePort(), ns3::UdpHeader::InitializeChecksum(), ns3::UdpHeader::IsChecksumOk(), ns3::Ipv4EndPointDemux::Lookup(), m_endPoints, ns3::Ipv6Address::MakeIpv4MappedAddress(), NS_LOG_DEBUG, NS_LOG_FUNCTION, NS_LOG_INFO, NS_LOG_LOGIC, ns3::Packet::PeekHeader(), PROT_NUMBER, ns3::Packet::RemoveHeader(), ns3::IpL4Protocol::RX_CSUM_FAILED, ns3::IpL4Protocol::RX_ENDPOINT_UNREACH, and ns3::IpL4Protocol::RX_OK.

Here is the call graph for this function:

enum IpL4Protocol::RxStatus ns3::UdpL4Protocol::Receive	(	Ptr< Packet >	p,
		Ipv6Address &	src,
		Ipv6Address &	dst,
		Ptr< Ipv6Interface >	interface
	)

virtual

Implements ns3::IpL4Protocol.

Definition at line 369 of file udp-l4-protocol.cc.

References ns3::Node::ChecksumEnabled(), ns3::Packet::Copy(), ns3::UdpHeader::EnableChecksums(), ns3::UdpHeader::GetDestinationPort(), ns3::UdpHeader::GetSourcePort(), ns3::UdpHeader::InitializeChecksum(), ns3::UdpHeader::IsChecksumOk(), ns3::Ipv6Address::IsIpv4MappedAddress(), ns3::Ipv6EndPointDemux::Lookup(), m_endPoints6, NS_LOG_DEBUG, NS_LOG_FUNCTION, NS_LOG_INFO, NS_LOG_LOGIC, PROT_NUMBER, ns3::Packet::RemoveHeader(), ns3::IpL4Protocol::RX_CSUM_FAILED, ns3::IpL4Protocol::RX_ENDPOINT_UNREACH, and ns3::IpL4Protocol::RX_OK.

Here is the call graph for this function:

void ns3::UdpL4Protocol::ReceiveIcmp	(	Ipv4Address	icmpSource,
		uint8_t	icmpTtl,
		uint8_t	icmpType,
		uint8_t	icmpCode,
		uint32_t	icmpInfo,
		Ipv4Address	payloadSource,
		Ipv4Address	payloadDestination,
		const uint8_t	payload[8]
	)

virtual

Receive an ICMP packet.

Parameters

icmpSource	The IP address of the source of the packet.
icmpTtl	The time to live from the IP header
icmpType	The type of the message from the ICMP header
icmpCode	The message code from the ICMP header
icmpInfo	32-bit integer carrying informational value of varying semantics.
payloadSource	The IP source address from the IP header of the packet
payloadDestination	The IP destination address from the IP header of the packet
payload	Payload of the ICMP packet

Reimplemented from ns3::IpL4Protocol.

Definition at line 259 of file udp-l4-protocol.cc.

References ns3::Ipv4EndPoint::ForwardIcmp(), m_endPoints, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::Ipv4EndPointDemux::SimpleLookup().

Here is the call graph for this function:

void ns3::UdpL4Protocol::ReceiveIcmp	(	Ipv6Address	icmpSource,
		uint8_t	icmpTtl,
		uint8_t	icmpType,
		uint8_t	icmpCode,
		uint32_t	icmpInfo,
		Ipv6Address	payloadSource,
		Ipv6Address	payloadDestination,
		const uint8_t	payload[8]
	)