A Discrete-Event Network Simulator
API
Loading...
Searching...
No Matches
ns3::UdpSocketImpl Class Reference

A sockets interface to UDP. More...

#include "udp-socket-impl.h"

+ Inheritance diagram for ns3::UdpSocketImpl:
+ Collaboration diagram for ns3::UdpSocketImpl:

Public Member Functions

 UdpSocketImpl ()
 Create an unbound udp socket.
 
 ~UdpSocketImpl () override
 
int Bind () override
 Allocate a local IPv4 endpoint for this socket.
 
int Bind (const Address &address) override
 Allocate a local endpoint for this socket.
 
int Bind6 () override
 Allocate a local IPv6 endpoint for this socket.
 
void BindToNetDevice (Ptr< NetDevice > netdevice) override
 Bind a socket to specific device.
 
int Close () override
 Close a socket.
 
int Connect (const Address &address) override
 Initiate a connection to a remote host.
 
bool GetAllowBroadcast () const override
 Query whether broadcast datagram transmissions are allowed.
 
SocketErrno GetErrno () const override
 Get last error number.
 
Ptr< NodeGetNode () const override
 Return the node this socket is associated with.
 
int GetPeerName (Address &address) const override
 Get the peer address of a connected socket.
 
uint32_t GetRxAvailable () const override
 Return number of bytes which can be returned from one or multiple calls to Recv.
 
SocketType GetSocketType () const override
 
int GetSockName (Address &address) const override
 Get socket address.
 
uint32_t GetTxAvailable () const override
 Returns the number of bytes which can be sent in a single call to Send.
 
void Ipv6JoinGroup (Ipv6Address address, Socket::Ipv6MulticastFilterMode filterMode, std::vector< Ipv6Address > sourceAddresses) override
 Joins a IPv6 multicast group.
 
int Listen () override
 Listen for incoming connections.
 
int MulticastJoinGroup (uint32_t interfaceIndex, const Address &groupAddress) override
 Corresponds to socket option MCAST_JOIN_GROUP.
 
int MulticastLeaveGroup (uint32_t interfaceIndex, const Address &groupAddress) override
 Corresponds to socket option MCAST_LEAVE_GROUP.
 
Ptr< PacketRecv (uint32_t maxSize, uint32_t flags) override
 Read data from the socket.
 
Ptr< PacketRecvFrom (uint32_t maxSize, uint32_t flags, Address &fromAddress) override
 Read a single packet from the socket and retrieve the sender address.
 
int Send (Ptr< Packet > p, uint32_t flags) override
 Send data (or dummy data) to the remote host.
 
int SendTo (Ptr< Packet > p, uint32_t flags, const Address &address) override
 Send data to a specified peer.
 
bool SetAllowBroadcast (bool allowBroadcast) override
 Configure whether broadcast datagram transmissions are allowed.
 
void SetNode (Ptr< Node > node)
 Set the associated node.
 
void SetUdp (Ptr< UdpL4Protocol > udp)
 Set the associated UDP L4 protocol.
 
int ShutdownRecv () override
 
int ShutdownSend () override
 
- Public Member Functions inherited from ns3::UdpSocket
 UdpSocket ()
 
 ~UdpSocket () override
 
virtual int MulticastJoinGroup (uint32_t interface, const Address &groupAddress)=0
 Corresponds to socket option MCAST_JOIN_GROUP.
 
virtual int MulticastLeaveGroup (uint32_t interface, const Address &groupAddress)=0
 Corresponds to socket option MCAST_LEAVE_GROUP.
 
- Public Member Functions inherited from ns3::Socket
 Socket ()
 
 ~Socket () override
 
virtual int Bind ()=0
 Allocate a local IPv4 endpoint for this socket.
 
virtual int Bind (const Address &address)=0
 Allocate a local endpoint for this socket.
 
virtual int Bind6 ()=0
 Allocate a local IPv6 endpoint for this socket.
 
virtual void BindToNetDevice (Ptr< NetDevice > netdevice)
 Bind a socket to specific device.
 
virtual int Close ()=0
 Close a socket.
 
virtual int Connect (const Address &address)=0
 Initiate a connection to a remote host.
 
virtual bool GetAllowBroadcast () const =0
 Query whether broadcast datagram transmissions are allowed.
 
Ptr< NetDeviceGetBoundNetDevice ()
 Returns socket's bound NetDevice, if any.
 
virtual Socket::SocketErrno GetErrno () const =0
 Get last error number.
 
uint8_t GetIpTos () const
 Query the value of IP Type of Service of this socket.
 
virtual uint8_t GetIpTtl () const
 Query the value of IP Time to Live field of this socket.
 
virtual uint8_t GetIpv6HopLimit () const
 Query the value of IP Hop Limit field of this socket.
 
uint8_t GetIpv6Tclass () const
 Query the value of IPv6 Traffic Class field of this socket.
 
virtual Ptr< NodeGetNode () const =0
 Return the node this socket is associated with.
 
virtual int GetPeerName (Address &address) const =0
 Get the peer address of a connected socket.
 
uint8_t GetPriority () const
 Query the priority value of this socket.
 
virtual uint32_t GetRxAvailable () const =0
 Return number of bytes which can be returned from one or multiple calls to Recv.
 
virtual Socket::SocketType GetSocketType () const =0
 
virtual int GetSockName (Address &address) const =0
 Get socket address.
 
virtual uint32_t GetTxAvailable () const =0
 Returns the number of bytes which can be sent in a single call to Send.
 
virtual void Ipv6JoinGroup (Ipv6Address address)
 Joins a IPv6 multicast group without filters.
 
virtual void Ipv6JoinGroup (Ipv6Address address, Ipv6MulticastFilterMode filterMode, std::vector< Ipv6Address > sourceAddresses)
 Joins a IPv6 multicast group.
 
virtual void Ipv6LeaveGroup ()
 Leaves IPv6 multicast group this socket is joined to.
 
bool IsIpRecvTos () const
 Ask if the socket is currently passing information about IP Type of Service up the stack.
 
bool IsIpRecvTtl () const
 Ask if the socket is currently passing information about IP_TTL up the stack.
 
bool IsIpv6RecvHopLimit () const
 Ask if the socket is currently passing information about IPv6 Hop Limit up the stack.
 
bool IsIpv6RecvTclass () const
 Ask if the socket is currently passing information about IPv6 Traffic Class up the stack.
 
bool IsRecvPktInfo () const
 Get status indicating whether enable/disable packet information to socket.
 
virtual int Listen ()=0
 Listen for incoming connections.
 
Ptr< PacketRecv ()
 Read a single packet from the socket.
 
virtual Ptr< PacketRecv (uint32_t maxSize, uint32_t flags)=0
 Read data from the socket.
 
int Recv (uint8_t *buf, uint32_t size, uint32_t flags)
 Recv data (or dummy data) from the remote host.
 
Ptr< PacketRecvFrom (Address &fromAddress)
 Read a single packet from the socket and retrieve the sender address.
 
virtual Ptr< PacketRecvFrom (uint32_t maxSize, uint32_t flags, Address &fromAddress)=0
 Read a single packet from the socket and retrieve the sender address.
 
int RecvFrom (uint8_t *buf, uint32_t size, uint32_t flags, Address &fromAddress)
 Read a single packet from the socket and retrieve the sender address.
 
int Send (const uint8_t *buf, uint32_t size, uint32_t flags)
 Send data (or dummy data) to the remote host.
 
int Send (Ptr< Packet > p)
 Send data (or dummy data) to the remote host.
 
virtual int Send (Ptr< Packet > p, uint32_t flags)=0
 Send data (or dummy data) to the remote host.
 
int SendTo (const uint8_t *buf, uint32_t size, uint32_t flags, const Address &address)
 Send data to a specified peer.
 
virtual int SendTo (Ptr< Packet > p, uint32_t flags, const Address &toAddress)=0
 Send data to a specified peer.
 
void SetAcceptCallback (Callback< bool, Ptr< Socket >, const Address & > connectionRequest, Callback< void, Ptr< Socket >, const Address & > newConnectionCreated)
 Accept connection requests from remote hosts.
 
virtual bool SetAllowBroadcast (bool allowBroadcast)=0
 Configure whether broadcast datagram transmissions are allowed.
 
void SetCloseCallbacks (Callback< void, Ptr< Socket > > normalClose, Callback< void, Ptr< Socket > > errorClose)
 Detect socket recv() events such as graceful shutdown or error.
 
void SetConnectCallback (Callback< void, Ptr< Socket > > connectionSucceeded, Callback< void, Ptr< Socket > > connectionFailed)
 Specify callbacks to allow the caller to determine if the connection succeeds of fails.
 
void SetDataSentCallback (Callback< void, Ptr< Socket >, uint32_t > dataSent)
 Notify application when a packet has been sent from transport protocol (non-standard socket call)
 
void SetIpRecvTos (bool ipv4RecvTos)
 Tells a socket to pass information about IP Type of Service up the stack.
 
void SetIpRecvTtl (bool ipv4RecvTtl)
 Tells a socket to pass information about IP_TTL up the stack.
 
void SetIpTos (uint8_t ipTos)
 Manually set IP Type of Service field.
 
virtual void SetIpTtl (uint8_t ipTtl)
 Manually set IP Time to Live field.
 
virtual void SetIpv6HopLimit (uint8_t ipHopLimit)
 Manually set IPv6 Hop Limit.
 
void SetIpv6RecvHopLimit (bool ipv6RecvHopLimit)
 Tells a socket to pass information about IPv6 Hop Limit up the stack.
 
void SetIpv6RecvTclass (bool ipv6RecvTclass)
 Tells a socket to pass information about IPv6 Traffic Class up the stack.
 
void SetIpv6Tclass (int ipTclass)
 Manually set IPv6 Traffic Class field.
 
void SetPriority (uint8_t priority)
 Manually set the socket priority.
 
void SetRecvCallback (Callback< void, Ptr< Socket > > receivedData)
 Notify application when new data is available to be read.
 
void SetRecvPktInfo (bool flag)
 Enable/Disable receive packet information to socket.
 
void SetSendCallback (Callback< void, Ptr< Socket >, uint32_t > sendCb)
 Notify application when space in transmit buffer is added.
 
virtual int ShutdownRecv ()=0
 
virtual int ShutdownSend ()=0
 
- Public Member Functions inherited from ns3::Object
 Object ()
 Constructor.
 
 ~Object () override
 Destructor.
 
void AggregateObject (Ptr< Object > other)
 Aggregate two Objects together.
 
void Dispose ()
 Dispose of this Object.
 
AggregateIterator GetAggregateIterator () const
 Get an iterator to the Objects aggregated to this one.
 
TypeId GetInstanceTypeId () const override
 Get the most derived TypeId for this Object.
 
template<typename T >
Ptr< T > GetObject () const
 Get a pointer to the requested aggregated Object.
 
template<>
Ptr< ObjectGetObject () const
 Specialization of () for objects of type ns3::Object.
 
template<typename T >
Ptr< T > GetObject (TypeId tid) const
 Get a pointer to the requested aggregated Object by TypeId.
 
template<>
Ptr< ObjectGetObject (TypeId tid) const
 Specialization of (TypeId tid) for objects of type ns3::Object.
 
void Initialize ()
 Invoke DoInitialize on all Objects aggregated to this one.
 
bool IsInitialized () const
 Check if the object has been initialized.
 
- Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
 SimpleRefCount ()
 Default constructor.
 
 SimpleRefCount (const SimpleRefCount &o)
 Copy constructor.
 
uint32_t GetReferenceCount () const
 Get the reference count of the object.
 
SimpleRefCountoperator= (const SimpleRefCount &o)
 Assignment operator.
 
void Ref () const
 Increment the reference count.
 
void Unref () const
 Decrement the reference count.
 
- Public Member Functions inherited from ns3::ObjectBase
virtual ~ObjectBase ()
 Virtual destructor.
 
void GetAttribute (std::string name, AttributeValue &value) const
 Get the value of an attribute, raising fatal errors if unsuccessful.
 
bool GetAttributeFailSafe (std::string name, AttributeValue &value) const
 Get the value of an attribute without raising errors.
 
virtual TypeId GetInstanceTypeId () const =0
 Get the most derived TypeId for this Object.
 
void SetAttribute (std::string name, const AttributeValue &value)
 Set a single attribute, raising fatal errors if unsuccessful.
 
bool SetAttributeFailSafe (std::string name, const AttributeValue &value)
 Set a single attribute without raising errors.
 
bool TraceConnect (std::string name, std::string context, const CallbackBase &cb)
 Connect a TraceSource to a Callback with a context.
 
bool TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
 Connect a TraceSource to a Callback without a context.
 
bool TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
 Disconnect from a TraceSource a Callback previously connected with a context.
 
bool TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)
 Disconnect from a TraceSource a Callback previously connected without a context.
 

Static Public Member Functions

static TypeId GetTypeId ()
 Get the type ID.
 
- Static Public Member Functions inherited from ns3::UdpSocket
static TypeId GetTypeId ()
 Get the type ID.
 
- Static Public Member Functions inherited from ns3::Socket
static Ptr< SocketCreateSocket (Ptr< Node > node, TypeId tid)
 This method wraps the creation of sockets that is performed on a given node by a SocketFactory specified by TypeId.
 
static TypeId GetTypeId ()
 Get the type ID.
 
static uint8_t IpTos2Priority (uint8_t ipTos)
 Return the priority corresponding to a given TOS value.
 
- Static Public Member Functions inherited from ns3::Object
static TypeId GetTypeId ()
 Register this type.
 
- Static Public Member Functions inherited from ns3::ObjectBase
static TypeId GetTypeId ()
 Get the type ID.
 

Private Member Functions

void DeallocateEndPoint ()
 Deallocate m_endPoint and m_endPoint6.
 
void Destroy ()
 Kill this socket by zeroing its attributes (IPv4)
 
void Destroy6 ()
 Kill this socket by zeroing its attributes (IPv6)
 
int DoSend (Ptr< Packet > p)
 Send a packet.
 
int DoSendTo (Ptr< Packet > p, Ipv4Address daddr, uint16_t dport, uint8_t tos)
 Send a packet to a specific destination and port (IPv4)
 
int DoSendTo (Ptr< Packet > p, Ipv6Address daddr, uint16_t dport)
 Send a packet to a specific destination and port (IPv6)
 
int FinishBind ()
 Finish the binding process.
 
void ForwardIcmp (Ipv4Address icmpSource, uint8_t icmpTtl, uint8_t icmpType, uint8_t icmpCode, uint32_t icmpInfo)
 Called by the L3 protocol when it received an ICMP packet to pass on to TCP.
 
void ForwardIcmp6 (Ipv6Address icmpSource, uint8_t icmpTtl, uint8_t icmpType, uint8_t icmpCode, uint32_t icmpInfo)
 Called by the L3 protocol when it received an ICMPv6 packet to pass on to TCP.
 
void ForwardUp (Ptr< Packet > packet, Ipv4Header header, uint16_t port, Ptr< Ipv4Interface > incomingInterface)
 Called by the L3 protocol when it received a packet to pass on to TCP.
 
void ForwardUp6 (Ptr< Packet > packet, Ipv6Header header, uint16_t port, Ptr< Ipv6Interface > incomingInterface)
 Called by the L3 protocol when it received a packet to pass on to TCP.
 
int32_t GetIpMulticastIf () const override
 Get the IP multicast interface.
 
bool GetIpMulticastLoop () const override
 Get the IP multicast loop capability.
 
uint8_t GetIpMulticastTtl () const override
 Get the IP multicast TTL.
 
bool GetMtuDiscover () const override
 Get the MTU discover capability.
 
uint32_t GetRcvBufSize () const override
 Get the receiving buffer size.
 
void SetIpMulticastIf (int32_t ipIf) override
 Set the IP multicast interface.
 
void SetIpMulticastLoop (bool loop) override
 Set the IP multicast loop capability.
 
void SetIpMulticastTtl (uint8_t ipTtl) override
 Set the IP multicast TTL.
 
void SetMtuDiscover (bool discover) override
 Set the MTU discover capability.
 
void SetRcvBufSize (uint32_t size) override
 Set the receiving buffer size.
 

Private Attributes

bool m_allowBroadcast
 Allow send broadcast packets.
 
bool m_connected
 Connection established.
 
Address m_defaultAddress
 Default address.
 
uint16_t m_defaultPort
 Default port.
 
std::queue< std::pair< Ptr< Packet >, Address > > m_deliveryQueue
 Queue for incoming packets.
 
TracedCallback< Ptr< const Packet > > m_dropTrace
 Trace for dropped packets.
 
Ipv4EndPointm_endPoint
 the IPv4 endpoint
 
Ipv6EndPointm_endPoint6
 the IPv6 endpoint
 
SocketErrno m_errno
 Socket error code.
 
Callback< void, Ipv4Address, uint8_t, uint8_t, uint8_t, uint32_tm_icmpCallback
 ICMP callback.
 
Callback< void, Ipv6Address, uint8_t, uint8_t, uint8_t, uint32_tm_icmpCallback6
 ICMPv6 callback.
 
int32_t m_ipMulticastIf
 Multicast Interface.
 
bool m_ipMulticastLoop
 Allow multicast loop.
 
uint8_t m_ipMulticastTtl
 Multicast TTL.
 
bool m_mtuDiscover
 Allow MTU discovery.
 
Ptr< Nodem_node
 the associated node
 
uint32_t m_rcvBufSize
 Receive buffer size.
 
uint32_t m_rxAvailable
 Number of available bytes to be received.
 
bool m_shutdownRecv
 Receive no longer allowed.
 
bool m_shutdownSend
 Send no longer allowed.
 
Ptr< UdpL4Protocolm_udp
 the associated UDP L4 protocol
 

Related Functions

(Note that these are not member functions.)

class UdpSocketFactory
 UdpSocketFactory friend class.
 

Additional Inherited Members

- Public Types inherited from ns3::Socket
enum  Ipv6MulticastFilterMode { INCLUDE = 1 , EXCLUDE }
 Enumeration of the possible filter of a socket. More...
 
enum  SocketErrno {
  ERROR_NOTERROR , ERROR_ISCONN , ERROR_NOTCONN , ERROR_MSGSIZE ,
  ERROR_AGAIN , ERROR_SHUTDOWN , ERROR_OPNOTSUPP , ERROR_AFNOSUPPORT ,
  ERROR_INVAL , ERROR_BADF , ERROR_NOROUTETOHOST , ERROR_NODEV ,
  ERROR_ADDRNOTAVAIL , ERROR_ADDRINUSE , SOCKET_ERRNO_LAST
}
 Enumeration of the possible errors returned by a socket. More...
 
enum  SocketPriority {
  NS3_PRIO_BESTEFFORT = 0 , NS3_PRIO_FILLER = 1 , NS3_PRIO_BULK = 2 , NS3_PRIO_INTERACTIVE_BULK = 4 ,
  NS3_PRIO_INTERACTIVE = 6 , NS3_PRIO_CONTROL = 7
}
 Enumeration of the possible socket priorities. More...
 
enum  SocketType { NS3_SOCK_STREAM , NS3_SOCK_SEQPACKET , NS3_SOCK_DGRAM , NS3_SOCK_RAW }
 Enumeration of the possible socket types. More...
 
- Protected Member Functions inherited from ns3::Socket
void DoDispose () override
 Destructor implementation.
 
bool IsManualIpTtl () const
 Checks if the socket has a specific IPv4 TTL set.
 
bool IsManualIpv6HopLimit () const
 Checks if the socket has a specific IPv6 Hop Limit set.
 
bool IsManualIpv6Tclass () const
 Checks if the socket has a specific IPv6 Tclass set.
 
void NotifyConnectionFailed ()
 Notify through the callback (if set) that the connection has not been established due to an error.
 
bool NotifyConnectionRequest (const Address &from)
 Notify through the callback (if set) that an incoming connection is being requested by a remote host.
 
void NotifyConnectionSucceeded ()
 Notify through the callback (if set) that the connection has been established.
 
void NotifyDataRecv ()
 Notify through the callback (if set) that some data have been received.
 
void NotifyDataSent (uint32_t size)
 Notify through the callback (if set) that some data have been sent.
 
void NotifyErrorClose ()
 Notify through the callback (if set) that the connection has been closed due to an error.
 
void NotifyNewConnectionCreated (Ptr< Socket > socket, const Address &from)
 Notify through the callback (if set) that a new connection has been created.
 
void NotifyNormalClose ()
 Notify through the callback (if set) that the connection has been closed.
 
void NotifySend (uint32_t spaceAvailable)
 Notify through the callback (if set) that some data have been sent.
 
- Protected Member Functions inherited from ns3::Object
 Object (const Object &o)
 Copy an Object.
 
virtual void DoDispose ()
 Destructor implementation.
 
virtual void DoInitialize ()
 Initialize() implementation.
 
virtual void NotifyNewAggregate ()
 Notify all Objects aggregated to this one of a new Object being aggregated.
 
- Protected Member Functions inherited from ns3::ObjectBase
void ConstructSelf (const AttributeConstructionList &attributes)
 Complete construction of ObjectBase; invoked by derived classes.
 
virtual void NotifyConstructionCompleted ()
 Notifier called once the ObjectBase is fully constructed.
 
- Protected Attributes inherited from ns3::Socket
Ptr< NetDevicem_boundnetdevice
 the device this socket is bound to (might be null).
 
Ipv6Address m_ipv6MulticastGroupAddress
 IPv6 multicast group address.
 
bool m_recvPktInfo
 if the socket should add packet info tags to the packet forwarded to L4.
 

Detailed Description

A sockets interface to UDP.

This class subclasses ns3::UdpSocket, and provides a socket interface to ns3's implementation of UDP.

For IPv4 packets, the TOS is set according to the following rules:

  • if the socket is connected, the TOS set for the socket is used
  • if the socket is not connected, the TOS specified in the destination address passed to SendTo is used, while the TOS set for the socket is ignored In both cases, a SocketIpTos tag is only added to the packet if the resulting TOS is non-null. The Bind and Connect operations set the TOS for the socket to the value specified in the provided address. If the TOS determined for a packet (as described above) is not null, the packet is assigned a priority based on that TOS value (according to the Socket::IpTos2Priority function). Otherwise, the priority set for the socket is assigned to the packet. Setting a TOS for a socket also sets a priority for the socket (according to the Socket::IpTos2Priority function). A SocketPriority tag is only added to the packet if the resulting priority is non-null.

Config Paths

ns3::UdpSocketImpl is accessible through the following paths with Config::Set and Config::Connect:

  • "/NodeList/[i]/$ns3::UdpL4Protocol/SocketList/[i]"

Attributes

  • IcmpCallback: Callback invoked whenever an icmp error is received on this socket.
  • IcmpCallback6: Callback invoked whenever an icmpv6 error is received on this socket.

Attributes defined in parent class ns3::UdpSocket

  • IpMulticastIf: interface index for outgoing multicast on this socket; -1 indicates to use default interface
    • Set with class: ns3::IntegerValue
    • Underlying type: int32_t -2147483648:2147483647
    • Initial value: -1
    • Flags: constructwriteread
  • IpMulticastLoop: whether outgoing multicast sent also to loopback interface
    • Set with class: ns3::BooleanValue
    • Underlying type: bool
    • Initial value: false
    • Flags: constructwriteread
  • IpMulticastTtl: socket-specific TTL for multicast IP packets (if non-zero)
    • Set with class: ns3::UintegerValue
    • Underlying type: uint8_t 0:255
    • Initial value: 0
    • Flags: constructwriteread
  • IpTtl: socket-specific TTL for unicast IP packets (if non-zero)
    • Set with class: ns3::UintegerValue
    • Underlying type: uint8_t 0:255
    • Initial value: 0
    • Flags: constructwriteread
  • MtuDiscover: If enabled, every outgoing ip packet will have the DF flag set.
    • Set with class: ns3::BooleanValue
    • Underlying type: bool
    • Initial value: false
    • Flags: constructwriteread
  • RcvBufSize: UdpSocket maximum receive buffer size (bytes)
    • Set with class: ns3::UintegerValue
    • Underlying type: uint32_t 0:4294967295
    • Initial value: 131072
    • Flags: constructwriteread

TraceSources

Size of this type is 352 bytes (on a 64-bit architecture).

Definition at line 71 of file udp-socket-impl.h.

Constructor & Destructor Documentation

◆ UdpSocketImpl()

ns3::UdpSocketImpl::UdpSocketImpl ( )

Create an unbound udp socket.

Definition at line 82 of file udp-socket-impl.cc.

References m_allowBroadcast, and NS_LOG_FUNCTION.

◆ ~UdpSocketImpl()

ns3::UdpSocketImpl::~UdpSocketImpl ( )
override
Todo:
leave any multicast groups that have been joined

Note: actually this function is called AFTER UdpSocketImpl::Destroy or UdpSocketImpl::Destroy6 so the code below is unnecessary in normal operations

Note that this piece of code is a bit tricky: when DeAllocate is called, it will call into Ipv4EndPointDemux::Deallocate which triggers a delete of the associated endPoint which triggers in turn a call to the method UdpSocketImpl::Destroy below will will zero the m_endPoint field.

Note that this piece of code is a bit tricky: when DeAllocate is called, it will call into Ipv4EndPointDemux::Deallocate which triggers a delete of the associated endPoint which triggers in turn a call to the method UdpSocketImpl::Destroy below will will zero the m_endPoint field.

Definition at line 97 of file udp-socket-impl.cc.

References m_endPoint, m_endPoint6, m_node, m_udp, NS_ASSERT, and NS_LOG_FUNCTION.

Member Function Documentation

◆ Bind() [1/2]

int ns3::UdpSocketImpl::Bind ( )
overridevirtual

Allocate a local IPv4 endpoint for this socket.

Returns
0 on success, -1 on failure.

Implements ns3::Socket.

Definition at line 248 of file udp-socket-impl.cc.

References ns3::Ipv4EndPoint::BindToNetDevice(), FinishBind(), ns3::Socket::m_boundnetdevice, m_endPoint, m_udp, and NS_LOG_FUNCTION.

Referenced by DoSend(), and DoSendTo().

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

◆ Bind() [2/2]

◆ Bind6()

int ns3::UdpSocketImpl::Bind6 ( )
overridevirtual

Allocate a local IPv6 endpoint for this socket.

Returns
0 on success, -1 on failure.

Implements ns3::Socket.

Definition at line 260 of file udp-socket-impl.cc.

References ns3::Ipv6EndPoint::BindToNetDevice(), FinishBind(), ns3::Socket::m_boundnetdevice, m_endPoint6, m_udp, and NS_LOG_FUNCTION.

Referenced by DoSend(), and DoSendTo().

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

◆ BindToNetDevice()

void ns3::UdpSocketImpl::BindToNetDevice ( Ptr< NetDevice netdevice)
overridevirtual

Bind a socket to specific device.

This method corresponds to using setsockopt() SO_BINDTODEVICE of real network or BSD sockets. If set on a socket, this option will force packets to leave the bound device regardless of the device that IP routing would naturally choose. In the receive direction, only packets received from the bound interface will be delivered.

This option has no particular relationship to binding sockets to an address via Socket::Bind (). It is possible to bind sockets to a specific IP address on the bound interface by calling both Socket::Bind (address) and Socket::BindToNetDevice (device), but it is also possible to bind to mismatching device and address, even if the socket can not receive any packets as a result.

Parameters
netdevicePointer to NetDevice of desired interface

Reimplemented from ns3::Socket.

Definition at line 980 of file udp-socket-impl.cc.

References ns3::Ipv4EndPoint::BindToNetDevice(), ns3::Ipv6EndPoint::BindToNetDevice(), ns3::Socket::BindToNetDevice(), ns3::Ipv6EndPoint::GetLocalAddress(), ns3::Object::GetObject(), ns3::Ipv6Address::IsMulticast(), ns3::Socket::m_boundnetdevice, m_endPoint, m_endPoint6, m_node, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ Close()

int ns3::UdpSocketImpl::Close ( )
overridevirtual

Close a socket.

Returns
zero on success, -1 on failure.

After the Close call, the socket is no longer valid, and cannot safely be used for subsequent operations.

Implements ns3::Socket.

Definition at line 395 of file udp-socket-impl.cc.

References DeallocateEndPoint(), ns3::Socket::ERROR_BADF, ns3::Socket::Ipv6LeaveGroup(), m_errno, m_shutdownRecv, m_shutdownSend, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ Connect()

◆ DeallocateEndPoint()

void ns3::UdpSocketImpl::DeallocateEndPoint ( )
private

Deallocate m_endPoint and m_endPoint6.

Definition at line 199 of file udp-socket-impl.cc.

References m_endPoint, m_endPoint6, and m_udp.

Referenced by Close().

+ Here is the caller graph for this function:

◆ Destroy()

void ns3::UdpSocketImpl::Destroy ( )
private

Kill this socket by zeroing its attributes (IPv4)

This is a callback function configured to m_endpoint in SetupCallback(), invoked when the endpoint is destroyed.

Definition at line 176 of file udp-socket-impl.cc.

References m_endPoint, m_udp, and NS_LOG_FUNCTION.

Referenced by FinishBind().

+ Here is the caller graph for this function:

◆ Destroy6()

void ns3::UdpSocketImpl::Destroy6 ( )
private

Kill this socket by zeroing its attributes (IPv6)

This is a callback function configured to m_endpoint in SetupCallback(), invoked when the endpoint is destroyed.

Definition at line 187 of file udp-socket-impl.cc.

References m_endPoint6, m_udp, and NS_LOG_FUNCTION.

Referenced by FinishBind().

+ Here is the caller graph for this function:

◆ DoSend()

int ns3::UdpSocketImpl::DoSend ( Ptr< Packet p)
private

Send a packet.

Parameters
ppacket
Returns
0 on success, -1 on failure

Definition at line 462 of file udp-socket-impl.cc.

References Bind(), Bind6(), ns3::Ipv4Address::ConvertFrom(), ns3::Ipv6Address::ConvertFrom(), DoSendTo(), ns3::Socket::ERROR_AFNOSUPPORT, ns3::Socket::ERROR_SHUTDOWN, ns3::Socket::GetIpTos(), ns3::Ipv4Address::IsMatchingType(), ns3::Ipv6Address::IsMatchingType(), m_defaultAddress, m_defaultPort, m_endPoint, m_endPoint6, m_errno, m_shutdownSend, NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by Send().

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

◆ DoSendTo() [1/2]

int ns3::UdpSocketImpl::DoSendTo ( Ptr< Packet p,
Ipv4Address  daddr,
uint16_t  dport,
uint8_t  tos 
)
private

Send a packet to a specific destination and port (IPv4)

Parameters
ppacket
daddrdestination address
dportdestination port
tosToS
Returns
0 on success, -1 on failure

Definition at line 503 of file udp-socket-impl.cc.

References Bind(), ns3::SocketSetDontFragmentTag::Disable(), ns3::SocketSetDontFragmentTag::Enable(), ns3::Socket::ERROR_MSGSIZE, ns3::Socket::ERROR_NOROUTETOHOST, ns3::Socket::ERROR_OPNOTSUPP, ns3::Socket::ERROR_SHUTDOWN, ns3::Ipv4Address::GetAny(), ns3::Ipv4InterfaceAddress::GetBroadcast(), ns3::Ipv4Header::GetDestination(), ns3::Socket::GetIpTtl(), ns3::Ipv4InterfaceAddress::GetLocal(), ns3::Ipv4EndPoint::GetLocalAddress(), ns3::Ipv4EndPoint::GetLocalPort(), ns3::Object::GetObject(), ns3::Socket::GetPriority(), ns3::Ipv4Header::GetSource(), GetTxAvailable(), ns3::Socket::IpTos2Priority(), ns3::Ipv4Address::IsBroadcast(), ns3::Socket::IsManualIpTtl(), ns3::Ipv4Address::IsMulticast(), m_allowBroadcast, ns3::Socket::m_boundnetdevice, m_endPoint, m_errno, m_ipMulticastTtl, m_mtuDiscover, m_node, m_shutdownSend, m_udp, ns3::Socket::NotifyDataSent(), ns3::Socket::NotifySend(), NS_ASSERT, NS_LOG_ERROR, NS_LOG_FUNCTION, NS_LOG_LOGIC, port, ns3::UdpL4Protocol::PROT_NUMBER, ns3::Ipv4Header::SetDestination(), ns3::SocketPriorityTag::SetPriority(), ns3::Ipv4Header::SetProtocol(), ns3::Ipv4Header::SetSource(), ns3::SocketIpTosTag::SetTos(), and ns3::SocketIpTtlTag::SetTtl().

Referenced by DoSend(), DoSendTo(), and SendTo().

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

◆ DoSendTo() [2/2]

◆ FinishBind()

int ns3::UdpSocketImpl::FinishBind ( )
private

◆ ForwardIcmp()

void ns3::UdpSocketImpl::ForwardIcmp ( Ipv4Address  icmpSource,
uint8_t  icmpTtl,
uint8_t  icmpType,
uint8_t  icmpCode,
uint32_t  icmpInfo 
)
private

Called by the L3 protocol when it received an ICMP packet to pass on to TCP.

Parameters
icmpSourcethe ICMP source address
icmpTtlthe ICMP Time to Live
icmpTypethe ICMP Type
icmpCodethe ICMP Code
icmpInfothe ICMP Info

Definition at line 1154 of file udp-socket-impl.cc.

References m_icmpCallback, and NS_LOG_FUNCTION.

Referenced by FinishBind().

+ Here is the caller graph for this function:

◆ ForwardIcmp6()

void ns3::UdpSocketImpl::ForwardIcmp6 ( Ipv6Address  icmpSource,
uint8_t  icmpTtl,
uint8_t  icmpType,
uint8_t  icmpCode,
uint32_t  icmpInfo 
)
private

Called by the L3 protocol when it received an ICMPv6 packet to pass on to TCP.

Parameters
icmpSourcethe ICMP source address
icmpTtlthe ICMP Time to Live
icmpTypethe ICMP Type
icmpCodethe ICMP Code
icmpInfothe ICMP Info

Definition at line 1169 of file udp-socket-impl.cc.

References m_icmpCallback6, and NS_LOG_FUNCTION.

Referenced by FinishBind().

+ Here is the caller graph for this function:

◆ ForwardUp()

void ns3::UdpSocketImpl::ForwardUp ( Ptr< Packet packet,
Ipv4Header  header,
uint16_t  port,
Ptr< Ipv4Interface incomingInterface 
)
private

Called by the L3 protocol when it received a packet to pass on to TCP.

Parameters
packetthe incoming packet
headerthe packet's IPv4 header
portthe remote port
incomingInterfacethe incoming interface

Definition at line 1029 of file udp-socket-impl.cc.

References ns3::Ipv4Header::GetDestination(), ns3::Ipv4Header::GetSource(), ns3::Ipv4Header::GetTos(), ns3::Ipv4Header::GetTtl(), ns3::Socket::IsIpRecvTos(), ns3::Socket::IsIpRecvTtl(), ns3::Socket::IsRecvPktInfo(), m_deliveryQueue, m_dropTrace, m_rcvBufSize, m_rxAvailable, m_shutdownRecv, ns3::Socket::NotifyDataRecv(), NS_LOG_FUNCTION, NS_LOG_WARN, port, ns3::Ipv4PacketInfoTag::SetAddress(), ns3::Ipv4PacketInfoTag::SetRecvIf(), ns3::SocketIpTosTag::SetTos(), ns3::Ipv4PacketInfoTag::SetTtl(), and ns3::SocketIpTtlTag::SetTtl().

Referenced by FinishBind().

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

◆ ForwardUp6()

void ns3::UdpSocketImpl::ForwardUp6 ( Ptr< Packet packet,
Ipv6Header  header,
uint16_t  port,
Ptr< Ipv6Interface incomingInterface 
)
private

◆ GetAllowBroadcast()

bool ns3::UdpSocketImpl::GetAllowBroadcast ( ) const
overridevirtual

Query whether broadcast datagram transmissions are allowed.

This method corresponds to using getsockopt() SO_BROADCAST of real network or BSD sockets.

Returns
true if broadcast is allowed, false otherwise

Implements ns3::Socket.

Definition at line 1251 of file udp-socket-impl.cc.

References m_allowBroadcast.

◆ GetErrno()

Socket::SocketErrno ns3::UdpSocketImpl::GetErrno ( ) const
overridevirtual

Get last error number.

Returns
the errno associated to the last call which failed in this socket. Each socket's errno is initialized to zero when the socket is created.

Implements ns3::Socket.

Definition at line 156 of file udp-socket-impl.cc.

References m_errno, and NS_LOG_FUNCTION.

◆ GetIpMulticastIf()

int32_t ns3::UdpSocketImpl::GetIpMulticastIf ( ) const
overrideprivatevirtual

Get the IP multicast interface.

Returns
the IP multicast interface

Implements ns3::UdpSocket.

Definition at line 1214 of file udp-socket-impl.cc.

References m_ipMulticastIf.

◆ GetIpMulticastLoop()

bool ns3::UdpSocketImpl::GetIpMulticastLoop ( ) const
overrideprivatevirtual

Get the IP multicast loop capability.

This means that the socket will receive the packets sent by itself on a multicast address. Equivalent to setsockopt IP_MULTICAST_LOOP

Returns
the IP multicast loop capability

Implements ns3::UdpSocket.

Definition at line 1226 of file udp-socket-impl.cc.

References m_ipMulticastLoop.

◆ GetIpMulticastTtl()

uint8_t ns3::UdpSocketImpl::GetIpMulticastTtl ( ) const
overrideprivatevirtual

Get the IP multicast TTL.

Returns
the IP multicast TTL

Implements ns3::UdpSocket.

Definition at line 1202 of file udp-socket-impl.cc.

References m_ipMulticastTtl.

◆ GetMtuDiscover()

bool ns3::UdpSocketImpl::GetMtuDiscover ( ) const
overrideprivatevirtual

Get the MTU discover capability.

Returns
the MTU discover capability

Implements ns3::UdpSocket.

Definition at line 1238 of file udp-socket-impl.cc.

References m_mtuDiscover.

◆ GetNode()

Ptr< Node > ns3::UdpSocketImpl::GetNode ( ) const
overridevirtual

Return the node this socket is associated with.

Returns
the node

Implements ns3::Socket.

Definition at line 169 of file udp-socket-impl.cc.

References m_node, and NS_LOG_FUNCTION.

◆ GetPeerName()

int ns3::UdpSocketImpl::GetPeerName ( Address address) const
overridevirtual

Get the peer address of a connected socket.

Parameters
addressthe address this socket is connected to.
Returns
0 if success, -1 otherwise

Implements ns3::Socket.

Definition at line 921 of file udp-socket-impl.cc.

References ns3::Ipv4Address::ConvertFrom(), ns3::Ipv6Address::ConvertFrom(), ns3::Socket::ERROR_NOTCONN, ns3::Socket::GetIpTos(), ns3::Ipv4Address::IsMatchingType(), ns3::Ipv6Address::IsMatchingType(), m_connected, m_defaultAddress, m_defaultPort, m_errno, NS_ASSERT_MSG, NS_LOG_FUNCTION, and ns3::InetSocketAddress::SetTos().

+ Here is the call graph for this function:

◆ GetRcvBufSize()

uint32_t ns3::UdpSocketImpl::GetRcvBufSize ( ) const
overrideprivatevirtual

Get the receiving buffer size.

Returns
the buffer size

Implements ns3::UdpSocket.

Definition at line 1190 of file udp-socket-impl.cc.

References m_rcvBufSize.

◆ GetRxAvailable()

uint32_t ns3::UdpSocketImpl::GetRxAvailable ( ) const
overridevirtual

Return number of bytes which can be returned from one or multiple calls to Recv.

Must be possible to call this method from the Recv callback.

Returns
the number of bytes which can be returned from one or multiple Recv calls.

Implements ns3::Socket.

Definition at line 856 of file udp-socket-impl.cc.

References m_rxAvailable, and NS_LOG_FUNCTION.

◆ GetSocketType()

Socket::SocketType ns3::UdpSocketImpl::GetSocketType ( ) const
overridevirtual
Returns
the socket type, analogous to getsockopt (SO_TYPE)

Implements ns3::Socket.

Definition at line 163 of file udp-socket-impl.cc.

References ns3::Socket::NS3_SOCK_DGRAM.

◆ GetSockName()

int ns3::UdpSocketImpl::GetSockName ( Address address) const
overridevirtual

Get socket address.

Parameters
addressthe address name this socket is associated with.
Returns
0 if success, -1 otherwise

Implements ns3::Socket.

Definition at line 900 of file udp-socket-impl.cc.

References ns3::Ipv4EndPoint::GetLocalAddress(), ns3::Ipv6EndPoint::GetLocalAddress(), ns3::Ipv4EndPoint::GetLocalPort(), ns3::Ipv6EndPoint::GetLocalPort(), ns3::Ipv4Address::GetZero(), m_endPoint, m_endPoint6, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ GetTxAvailable()

uint32_t ns3::UdpSocketImpl::GetTxAvailable ( ) const
overridevirtual

Returns the number of bytes which can be sent in a single call to Send.

For datagram sockets, this returns the number of bytes that can be passed atomically through the underlying protocol.

For stream sockets, this returns the available space in bytes left in the transmit buffer.

Returns
The number of bytes which can be sent in a single Send call.

Implements ns3::Socket.

Definition at line 825 of file udp-socket-impl.cc.

References ns3::MAX_IPV4_UDP_DATAGRAM_SIZE, and NS_LOG_FUNCTION.

Referenced by DoSendTo().

+ Here is the caller graph for this function:

◆ GetTypeId()

TypeId ns3::UdpSocketImpl::GetTypeId ( )
static

Get the type ID.

Returns
the object TypeId

Definition at line 58 of file udp-socket-impl.cc.

References m_dropTrace, m_icmpCallback, m_icmpCallback6, ns3::MakeCallbackAccessor(), ns3::MakeCallbackChecker(), ns3::MakeTraceSourceAccessor(), and ns3::TypeId::SetParent().

+ Here is the call graph for this function:

◆ Ipv6JoinGroup()

void ns3::UdpSocketImpl::Ipv6JoinGroup ( Ipv6Address  address,
Socket::Ipv6MulticastFilterMode  filterMode,
std::vector< Ipv6Address sourceAddresses 
)
overridevirtual

Joins a IPv6 multicast group.

Based on the filter mode and source addresses this can be interpreted as a join, leave, or modification to source filtering on a multicast group.

Mind that a socket can join only one multicast group. Any attempt to join another group will remove the old one.

Parameters
addressRequested multicast address.
filterModeSocket filtering mode (INCLUDE | EXCLUDE).
sourceAddressesAll the source addresses on which socket is interested or not interested.

Reimplemented from ns3::Socket.

Definition at line 1257 of file udp-socket-impl.cc.

References ns3::Object::GetObject(), ns3::Socket::INCLUDE, ns3::Ipv6Address::IsAny(), ns3::Socket::m_boundnetdevice, ns3::Socket::m_ipv6MulticastGroupAddress, m_node, NS_ASSERT_MSG, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ Listen()

int ns3::UdpSocketImpl::Listen ( )
overridevirtual

Listen for incoming connections.

Returns
0 on success, -1 on error (in which case errno is set).

Implements ns3::Socket.

Definition at line 441 of file udp-socket-impl.cc.

References ns3::Socket::ERROR_OPNOTSUPP, and m_errno.

◆ MulticastJoinGroup()

int ns3::UdpSocketImpl::MulticastJoinGroup ( uint32_t  interface,
const Address groupAddress 
)
overridevirtual

Corresponds to socket option MCAST_JOIN_GROUP.

Parameters
interfaceinterface number, or 0
groupAddressmulticast group address
Returns
on success, zero is returned. On error, -1 is returned, and errno is set appropriately

Enable reception of multicast datagrams for this socket on the interface number specified. If zero is specified as the interface, then a single local interface is chosen by system. In the future, this function will generate trigger IGMP joins as necessary when IGMP is implemented, but for now, this just enables multicast datagram reception in the system if not already enabled for this interface/groupAddress combination.

Attention
IGMP is not yet implemented in ns-3

This function may be called repeatedly on a given socket but each join must be for a different multicast address, or for the same multicast address but on a different interface from previous joins. This enables host multihoming, and the ability to join the same group on different interfaces.

Implements ns3::UdpSocket.

Definition at line 952 of file udp-socket-impl.cc.

References NS_LOG_FUNCTION.

◆ MulticastLeaveGroup()

int ns3::UdpSocketImpl::MulticastLeaveGroup ( uint32_t  interface,
const Address groupAddress 
)
overridevirtual

Corresponds to socket option MCAST_LEAVE_GROUP.

Parameters
interfaceinterface number, or 0
groupAddressmulticast group address
Returns
on success, zero is returned. On error, -1 is returned, and errno is set appropriately

Disable reception of multicast datagrams for this socket on the interface number specified. If zero is specified as the interfaceIndex, then a single local interface is chosen by system. In the future, this function will generate trigger IGMP leaves as necessary when IGMP is implemented, but for now, this just disables multicast datagram reception in the system if this socket is the last for this interface/groupAddress combination.

Attention
IGMP is not yet implemented in ns-3

Implements ns3::UdpSocket.

Definition at line 966 of file udp-socket-impl.cc.

References NS_LOG_FUNCTION.

◆ Recv()

Ptr< Packet > ns3::UdpSocketImpl::Recv ( uint32_t  maxSize,
uint32_t  flags 
)
overridevirtual

Read data from the socket.

This function matches closely in semantics to the recv() function call in the standard C library (libc): ssize_t recv (int s, void *buf, size_t len, int flags); except that the receive I/O is asynchronous. This is the primary Recv method at this low-level API and must be implemented by subclasses.

This method is normally used only on a connected socket. In a typical blocking sockets model, this call would block until at least one byte is returned or the connection closes. In ns-3 at this API, the call returns immediately in such a case and returns 0 if nothing is available to be read. However, an application can set a callback, ns3::SetRecvCallback, to be notified of data being available to be read (when it conceptually unblocks); this is an asynchronous I/O model for recv().

This variant of Recv() uses class ns3::Packet to encapsulate data, rather than providing a raw pointer and length field. This allows an ns-3 application to attach tags if desired (such as a flow ID) and may allow the simulator to avoid some data copies. Despite the appearance of receiving Packets on a stream socket, just think of it as a fancy byte buffer with streaming semantics.

The semantics depend on the type of socket. For a datagram socket, each Recv() returns the data from at most one Send(), and order is not necessarily preserved. For a stream socket, the bytes are delivered in order, and on-the-wire packet boundaries are not preserved.

The flags argument is formed by or'ing one or more of the values: MSG_OOB process out-of-band data MSG_PEEK peek at incoming message None of these flags are supported for now.

Some variants of Recv() are supported as additional API, including RecvFrom(), overloaded Recv() without arguments, and variants that use raw character buffers.

Parameters
maxSizereader will accept packet up to maxSize
flagsSocket control flags
Returns
Ptr<Packet> of the next in-sequence packet. Returns 0 if the socket cannot return a next in-sequence packet conforming to the maxSize and flags.
See also
SetRecvCallback

Implements ns3::Socket.

Definition at line 865 of file udp-socket-impl.cc.

References NS_LOG_FUNCTION, and RecvFrom().

+ Here is the call graph for this function:

◆ RecvFrom()

Ptr< Packet > ns3::UdpSocketImpl::RecvFrom ( uint32_t  maxSize,
uint32_t  flags,
Address fromAddress 
)
overridevirtual

Read a single packet from the socket and retrieve the sender address.

Calls Recv(maxSize, flags) with maxSize implicitly set to maximum sized integer, and flags set to zero.

This method has similar semantics to Recv () but subclasses may want to provide checks on socket state, so the implementation is pushed to subclasses.

Parameters
maxSizereader will accept packet up to maxSize
flagsSocket control flags
fromAddressoutput parameter that will return the address of the sender of the received packet, if any. Remains untouched if no packet is received.
Returns
Ptr<Packet> of the next in-sequence packet. Returns 0 if the socket cannot return a next in-sequence packet.

Implements ns3::Socket.

Definition at line 875 of file udp-socket-impl.cc.

References ns3::Socket::ERROR_AGAIN, m_deliveryQueue, m_errno, m_rxAvailable, and NS_LOG_FUNCTION.

Referenced by Recv().

+ Here is the caller graph for this function:

◆ Send()

int ns3::UdpSocketImpl::Send ( Ptr< Packet p,
uint32_t  flags 
)
overridevirtual

Send data (or dummy data) to the remote host.

This function matches closely in semantics to the send() function call in the standard C library (libc): ssize_t send (int s, const void *msg, size_t len, int flags); except that the send I/O is asynchronous. This is the primary Send method at this low-level API and must be implemented by subclasses.

In a typical blocking sockets model, this call would block upon lack of space to hold the message to be sent. In ns-3 at this API, the call returns immediately in such a case, but the callback registered with SetSendCallback() is invoked when the socket has space (when it conceptually unblocks); this is an asynchronous I/O model for send().

This variant of Send() uses class ns3::Packet to encapsulate data, rather than providing a raw pointer and length field. This allows an ns-3 application to attach tags if desired (such as a flow ID) and may allow the simulator to avoid some data copies. Despite the appearance of sending Packets on a stream socket, just think of it as a fancy byte buffer with streaming semantics.

If either the message buffer within the Packet is too long to pass atomically through the underlying protocol (for datagram sockets), or the message buffer cannot entirely fit in the transmit buffer (for stream sockets), -1 is returned and SocketErrno is set to ERROR_MSGSIZE. If the packet does not fit, the caller can split the Packet (based on information obtained from GetTxAvailable) and reattempt to send the data.

The flags argument is formed by or'ing one or more of the values: MSG_OOB process out-of-band data MSG_DONTROUTE bypass routing, use direct interface These flags are unsupported as of ns-3.1.

Parameters
pns3::Packet to send
flagsSocket control flags
Returns
the number of bytes accepted for transmission if no error occurs, and -1 otherwise.
See also
SetSendCallback

Implements ns3::Socket.

Definition at line 448 of file udp-socket-impl.cc.

References DoSend(), ns3::Socket::ERROR_NOTCONN, m_connected, m_errno, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ SendTo()

int ns3::UdpSocketImpl::SendTo ( Ptr< Packet p,
uint32_t  flags,
const Address toAddress 
)
overridevirtual

Send data to a specified peer.

This method has similar semantics to Send () but subclasses may want to provide checks on socket state, so the implementation is pushed to subclasses.

Parameters
ppacket to send
flagsSocket control flags
toAddressIP Address of remote host
Returns
-1 in case of error or the number of bytes copied in the internal buffer and accepted for transmission.

Implements ns3::Socket.

Definition at line 834 of file udp-socket-impl.cc.

References ns3::Inet6SocketAddress::ConvertFrom(), ns3::InetSocketAddress::ConvertFrom(), DoSendTo(), ns3::InetSocketAddress::GetIpv4(), ns3::Inet6SocketAddress::GetIpv6(), ns3::InetSocketAddress::GetPort(), ns3::Inet6SocketAddress::GetPort(), ns3::InetSocketAddress::GetTos(), ns3::Inet6SocketAddress::IsMatchingType(), ns3::InetSocketAddress::IsMatchingType(), NS_LOG_FUNCTION, and port.

+ Here is the call graph for this function:

◆ SetAllowBroadcast()

bool ns3::UdpSocketImpl::SetAllowBroadcast ( bool  allowBroadcast)
overridevirtual

Configure whether broadcast datagram transmissions are allowed.

This method corresponds to using setsockopt() SO_BROADCAST of real network or BSD sockets. If set on a socket, this option will enable or disable packets to be transmitted to broadcast destination addresses.

Parameters
allowBroadcastWhether broadcast is allowed
Returns
true if operation succeeds

Implements ns3::Socket.

Definition at line 1244 of file udp-socket-impl.cc.

References m_allowBroadcast.

◆ SetIpMulticastIf()

void ns3::UdpSocketImpl::SetIpMulticastIf ( int32_t  ipIf)
overrideprivatevirtual

Set the IP multicast interface.

Parameters
ipIfthe IP multicast interface

Implements ns3::UdpSocket.

Definition at line 1208 of file udp-socket-impl.cc.

References m_ipMulticastIf.

◆ SetIpMulticastLoop()

void ns3::UdpSocketImpl::SetIpMulticastLoop ( bool  loop)
overrideprivatevirtual

Set the IP multicast loop capability.

This means that the socket will receive the packets sent by itself on a multicast address. Equivalent to setsockopt IP_MULTICAST_LOOP

Parameters
loopthe IP multicast loop capability

Implements ns3::UdpSocket.

Definition at line 1220 of file udp-socket-impl.cc.

References m_ipMulticastLoop.

◆ SetIpMulticastTtl()

void ns3::UdpSocketImpl::SetIpMulticastTtl ( uint8_t  ipTtl)
overrideprivatevirtual

Set the IP multicast TTL.

Parameters
ipTtlthe IP multicast TTL

Implements ns3::UdpSocket.

Definition at line 1196 of file udp-socket-impl.cc.

References m_ipMulticastTtl.

◆ SetMtuDiscover()

void ns3::UdpSocketImpl::SetMtuDiscover ( bool  discover)
overrideprivatevirtual

Set the MTU discover capability.

Parameters
discoverthe MTU discover capability

Implements ns3::UdpSocket.

Definition at line 1232 of file udp-socket-impl.cc.

References m_mtuDiscover.

◆ SetNode()

void ns3::UdpSocketImpl::SetNode ( Ptr< Node node)

Set the associated node.

Parameters
nodethe node

Definition at line 142 of file udp-socket-impl.cc.

References m_node, and NS_LOG_FUNCTION.

◆ SetRcvBufSize()

void ns3::UdpSocketImpl::SetRcvBufSize ( uint32_t  size)
overrideprivatevirtual

Set the receiving buffer size.

Parameters
sizethe buffer size

Implements ns3::UdpSocket.

Definition at line 1184 of file udp-socket-impl.cc.

References m_rcvBufSize.

◆ SetUdp()

void ns3::UdpSocketImpl::SetUdp ( Ptr< UdpL4Protocol udp)

Set the associated UDP L4 protocol.

Parameters
udpthe UDP L4 protocol

Definition at line 149 of file udp-socket-impl.cc.

References m_udp, and NS_LOG_FUNCTION.

◆ ShutdownRecv()

int ns3::UdpSocketImpl::ShutdownRecv ( )
overridevirtual
Returns
zero on success, -1 on failure.

Do not allow any further Recv calls. This method is typically implemented for Tcp sockets by a half close.

Implements ns3::Socket.

Definition at line 379 of file udp-socket-impl.cc.

References m_endPoint, m_endPoint6, m_shutdownRecv, NS_LOG_FUNCTION, ns3::Ipv4EndPoint::SetRxEnabled(), and ns3::Ipv6EndPoint::SetRxEnabled().

+ Here is the call graph for this function:

◆ ShutdownSend()

int ns3::UdpSocketImpl::ShutdownSend ( )
overridevirtual
Returns
zero on success, -1 on failure.

Do not allow any further Send calls. This method is typically implemented for Tcp sockets by a half close.

Implements ns3::Socket.

Definition at line 371 of file udp-socket-impl.cc.

References m_shutdownSend, and NS_LOG_FUNCTION.

Friends And Related Function Documentation

◆ UdpSocketFactory

friend class UdpSocketFactory
friend

UdpSocketFactory friend class.

Definition at line 141 of file udp-socket-impl.h.

Member Data Documentation

◆ m_allowBroadcast

bool ns3::UdpSocketImpl::m_allowBroadcast
private

Allow send broadcast packets.

Definition at line 269 of file udp-socket-impl.h.

Referenced by UdpSocketImpl(), DoSendTo(), GetAllowBroadcast(), and SetAllowBroadcast().

◆ m_connected

bool ns3::UdpSocketImpl::m_connected
private

Connection established.

Definition at line 268 of file udp-socket-impl.h.

Referenced by Connect(), GetPeerName(), and Send().

◆ m_defaultAddress

Address ns3::UdpSocketImpl::m_defaultAddress
private

Default address.

Definition at line 261 of file udp-socket-impl.h.

Referenced by Connect(), DoSend(), and GetPeerName().

◆ m_defaultPort

uint16_t ns3::UdpSocketImpl::m_defaultPort
private

Default port.

Definition at line 262 of file udp-socket-impl.h.

Referenced by Connect(), DoSend(), and GetPeerName().

◆ m_deliveryQueue

std::queue<std::pair<Ptr<Packet>, Address> > ns3::UdpSocketImpl::m_deliveryQueue
private

Queue for incoming packets.

Definition at line 271 of file udp-socket-impl.h.

Referenced by ForwardUp(), ForwardUp6(), and RecvFrom().

◆ m_dropTrace

TracedCallback<Ptr<const Packet> > ns3::UdpSocketImpl::m_dropTrace
private

Trace for dropped packets.

Definition at line 263 of file udp-socket-impl.h.

Referenced by ForwardUp(), ForwardUp6(), and GetTypeId().

◆ m_endPoint

Ipv4EndPoint* ns3::UdpSocketImpl::m_endPoint
private

◆ m_endPoint6

Ipv6EndPoint* ns3::UdpSocketImpl::m_endPoint6
private

◆ m_errno

SocketErrno ns3::UdpSocketImpl::m_errno
mutableprivate

Socket error code.

Definition at line 265 of file udp-socket-impl.h.

Referenced by Bind(), Close(), DoSend(), DoSendTo(), GetErrno(), GetPeerName(), Listen(), RecvFrom(), and Send().

◆ m_icmpCallback

Callback<void, Ipv4Address, uint8_t, uint8_t, uint8_t, uint32_t> ns3::UdpSocketImpl::m_icmpCallback
private

ICMP callback.

Definition at line 257 of file udp-socket-impl.h.

Referenced by ForwardIcmp(), and GetTypeId().

◆ m_icmpCallback6

Callback<void, Ipv6Address, uint8_t, uint8_t, uint8_t, uint32_t> ns3::UdpSocketImpl::m_icmpCallback6
private

ICMPv6 callback.

Definition at line 259 of file udp-socket-impl.h.

Referenced by ForwardIcmp6(), and GetTypeId().

◆ m_ipMulticastIf

int32_t ns3::UdpSocketImpl::m_ipMulticastIf
private

Multicast Interface.

Definition at line 277 of file udp-socket-impl.h.

Referenced by GetIpMulticastIf(), and SetIpMulticastIf().

◆ m_ipMulticastLoop

bool ns3::UdpSocketImpl::m_ipMulticastLoop
private

Allow multicast loop.

Definition at line 278 of file udp-socket-impl.h.

Referenced by GetIpMulticastLoop(), and SetIpMulticastLoop().

◆ m_ipMulticastTtl

uint8_t ns3::UdpSocketImpl::m_ipMulticastTtl
private

Multicast TTL.

Definition at line 276 of file udp-socket-impl.h.

Referenced by DoSendTo(), GetIpMulticastTtl(), and SetIpMulticastTtl().

◆ m_mtuDiscover

bool ns3::UdpSocketImpl::m_mtuDiscover
private

Allow MTU discovery.

Definition at line 279 of file udp-socket-impl.h.

Referenced by DoSendTo(), GetMtuDiscover(), and SetMtuDiscover().

◆ m_node

Ptr<Node> ns3::UdpSocketImpl::m_node
private

the associated node

Definition at line 254 of file udp-socket-impl.h.

Referenced by ~UdpSocketImpl(), Bind(), BindToNetDevice(), DoSendTo(), GetNode(), Ipv6JoinGroup(), and SetNode().

◆ m_rcvBufSize

uint32_t ns3::UdpSocketImpl::m_rcvBufSize
private

Receive buffer size.

Definition at line 275 of file udp-socket-impl.h.

Referenced by ForwardUp(), ForwardUp6(), GetRcvBufSize(), and SetRcvBufSize().

◆ m_rxAvailable

uint32_t ns3::UdpSocketImpl::m_rxAvailable
private

Number of available bytes to be received.

Definition at line 272 of file udp-socket-impl.h.

Referenced by ForwardUp(), ForwardUp6(), GetRxAvailable(), and RecvFrom().

◆ m_shutdownRecv

bool ns3::UdpSocketImpl::m_shutdownRecv
private

Receive no longer allowed.

Definition at line 267 of file udp-socket-impl.h.

Referenced by Close(), FinishBind(), ForwardUp(), ForwardUp6(), and ShutdownRecv().

◆ m_shutdownSend

bool ns3::UdpSocketImpl::m_shutdownSend
private

Send no longer allowed.

Definition at line 266 of file udp-socket-impl.h.

Referenced by Close(), DoSend(), DoSendTo(), FinishBind(), and ShutdownSend().

◆ m_udp

Ptr<UdpL4Protocol> ns3::UdpSocketImpl::m_udp
private

the associated UDP L4 protocol

Definition at line 255 of file udp-socket-impl.h.

Referenced by ~UdpSocketImpl(), Bind(), Bind6(), DeallocateEndPoint(), Destroy(), Destroy6(), DoSendTo(), and SetUdp().


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