A PacketSocket is a link between an application and a net device. More...
#include "packet-socket.h"
Public Member Functions | |
PacketSocket () | |
~PacketSocket () override | |
int | Bind () override |
Bind the socket to the NetDevice and register the protocol handler. | |
int | Bind (const Address &address) override |
Bind the socket to the NetDevice and register the protocol handler specified in the address. | |
int | Bind6 () override |
Bind the socket to the NetDevice and register the protocol handler. | |
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< Node > | GetNode () 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. | |
int | Listen () override |
Listen for incoming connections. | |
Ptr< Packet > | Recv (uint32_t maxSize, uint32_t flags) override |
Read data from the socket. | |
Ptr< Packet > | RecvFrom (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 &toAddress) 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. | |
int | ShutdownRecv () override |
int | ShutdownSend () override |
Public Member Functions inherited from ns3::Socket | |
Socket () | |
~Socket () override | |
virtual void | BindToNetDevice (Ptr< NetDevice > netdevice) |
Bind a socket to specific device. | |
Ptr< NetDevice > | GetBoundNetDevice () |
Returns socket's bound NetDevice, if any. | |
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. | |
uint8_t | GetPriority () const |
Query the priority value of this socket. | |
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. | |
Ptr< Packet > | Recv () |
Read a single packet from the socket. | |
int | Recv (uint8_t *buf, uint32_t size, uint32_t flags) |
Recv data (or dummy data) from the remote host. | |
Ptr< Packet > | RecvFrom (Address &fromAddress) |
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. | |
int | SendTo (const uint8_t *buf, uint32_t size, uint32_t flags, const Address &address) |
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. | |
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. | |
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< Object > | GetObject () 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< Object > | GetObject (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. | |
void | UnidirectionalAggregateObject (Ptr< Object > other) |
Aggregate an Object to another Object. | |
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. | |
SimpleRefCount & | operator= (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, bool permissive=false) 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. | |
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::Socket | |
static Ptr< Socket > | CreateSocket (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 Types | |
enum | State { STATE_OPEN , STATE_BOUND , STATE_CONNECTED , STATE_CLOSED } |
States of the socket. More... | |
Private Member Functions | |
int | DoBind (const PacketSocketAddress &address) |
Bind the socket to the NetDevice and register the protocol handler specified in the address. | |
void | DoDispose () override |
Destructor implementation. | |
void | ForwardUp (Ptr< NetDevice > device, Ptr< const Packet > packet, uint16_t protocol, const Address &from, const Address &to, NetDevice::PacketType packetType) |
Called by the L3 protocol when it received a packet to pass on to TCP. | |
uint32_t | GetMinMtu (PacketSocketAddress ad) const |
Get the minimum MTU supported by the NetDevices bound to a specific address. | |
Private Attributes | |
std::queue< std::pair< Ptr< Packet >, Address > > | m_deliveryQueue |
Rx queue. | |
Address | m_destAddr |
Default destination address. | |
uint32_t | m_device |
index of the bound NetDevice | |
TracedCallback< Ptr< const Packet > > | m_dropTrace |
Traced callback: dropped packets. | |
SocketErrno | m_errno |
Socket error code. | |
bool | m_isSingleDevice |
Is bound to a single netDevice. | |
Ptr< Node > | m_node |
the associated node | |
uint16_t | m_protocol |
Socket protocol. | |
uint32_t | m_rcvBufSize |
Rx buffer size [Bytes]. | |
uint32_t | m_rxAvailable |
Rx queue size [Bytes]. | |
bool | m_shutdownRecv |
Receive no longer allowed. | |
bool | m_shutdownSend |
Send no longer allowed. | |
State | m_state |
Socket state. | |
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 | 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< NetDevice > | m_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. | |
Related Symbols inherited from ns3::ObjectBase | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. | |
A PacketSocket is a link between an application and a net device.
A PacketSocket can be used to connect an application to a net device. The application provides the buffers of data, the socket converts them to a raw packet and the net device then adds the protocol specific headers and trailers. This socket type is very similar to the linux and BSD "packet" sockets.
Here is a summary of the semantics of this class:
Socket data that is read from this socket using the methods returning an ns3::Packet object (i.e., Recv (), RecvMsg (), RecvFrom ()) will return Packet objects with three PacketTag objects attached. Applications may wish to read the extra out-of-band data provided in these tags, and may safely remove the tags from the Packet.
Definition at line 83 of file packet-socket.h.
|
private |
States of the socket.
Enumerator | |
---|---|
STATE_OPEN | |
STATE_BOUND | |
STATE_CONNECTED | |
STATE_CLOSED |
Definition at line 180 of file packet-socket.h.
ns3::PacketSocket::PacketSocket | ( | ) |
Definition at line 48 of file packet-socket.cc.
References ns3::Socket::ERROR_NOTERROR, m_device, m_errno, m_isSingleDevice, m_shutdownRecv, m_shutdownSend, m_state, NS_LOG_FUNCTION, and STATE_OPEN.
|
override |
Definition at line 67 of file packet-socket.cc.
References NS_LOG_FUNCTION.
|
overridevirtual |
Bind the socket to the NetDevice and register the protocol handler.
Implements ns3::Socket.
Definition at line 101 of file packet-socket.cc.
References DoBind(), and NS_LOG_FUNCTION.
Referenced by Bind6().
|
overridevirtual |
Bind the socket to the NetDevice and register the protocol handler specified in the address.
address | the packet socket address |
Implements ns3::Socket.
Definition at line 118 of file packet-socket.cc.
References ns3::PacketSocketAddress::ConvertFrom(), DoBind(), ns3::Socket::ERROR_INVAL, ns3::PacketSocketAddress::IsMatchingType(), m_errno, and NS_LOG_FUNCTION.
|
overridevirtual |
Bind the socket to the NetDevice and register the protocol handler.
Implements ns3::Socket.
Definition at line 111 of file packet-socket.cc.
References Bind(), and NS_LOG_FUNCTION.
|
overridevirtual |
Close a socket.
After the Close call, the socket is no longer valid, and cannot safely be used for subsequent operations.
Implements ns3::Socket.
Definition at line 191 of file packet-socket.cc.
References ns3::Socket::ERROR_BADF, ForwardUp(), m_errno, m_node, m_shutdownRecv, m_shutdownSend, m_state, ns3::MakeCallback(), NS_LOG_FUNCTION, STATE_BOUND, STATE_CLOSED, STATE_CONNECTED, and ns3::Node::UnregisterProtocolHandler().
|
overridevirtual |
Initiate a connection to a remote host.
address | Address of remote. |
Implements ns3::Socket.
Definition at line 210 of file packet-socket.cc.
References ns3::Socket::ERROR_AFNOSUPPORT, ns3::Socket::ERROR_BADF, ns3::Socket::ERROR_INVAL, ns3::Socket::ERROR_ISCONN, ns3::PacketSocketAddress::IsMatchingType(), m_destAddr, m_errno, m_state, ns3::Socket::NotifyConnectionFailed(), ns3::Socket::NotifyConnectionSucceeded(), NS_LOG_FUNCTION, STATE_CLOSED, STATE_CONNECTED, and STATE_OPEN.
|
private |
Bind the socket to the NetDevice and register the protocol handler specified in the address.
address | the packet socket address |
Definition at line 131 of file packet-socket.cc.
References ns3::Socket::ERROR_BADF, ns3::Socket::ERROR_INVAL, ForwardUp(), ns3::Node::GetDevice(), ns3::Socket::m_boundnetdevice, m_device, m_errno, m_isSingleDevice, m_node, m_protocol, m_state, ns3::MakeCallback(), NS_LOG_FUNCTION, ns3::Node::RegisterProtocolHandler(), STATE_BOUND, STATE_CLOSED, and STATE_CONNECTED.
Referenced by Bind(), and Bind().
|
overrideprivatevirtual |
Destructor implementation.
This method is called by Dispose() or by the Object's destructor, whichever comes first.
Subclasses are expected to implement their real destruction code in an overridden 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 73 of file packet-socket.cc.
References m_device, and NS_LOG_FUNCTION.
|
private |
Called by the L3 protocol when it received a packet to pass on to TCP.
device | the incoming NetDevice |
packet | the incoming packet |
protocol | the protocol |
from | sender address |
to | destination address |
packetType | packet type |
Definition at line 379 of file packet-socket.cc.
References m_deliveryQueue, m_dropTrace, m_rcvBufSize, m_rxAvailable, m_shutdownRecv, ns3::Socket::NotifyDataRecv(), NS_LOG_FUNCTION, NS_LOG_LOGIC, NS_LOG_WARN, ns3::PacketSocketTag::SetDestAddress(), ns3::DeviceNameTag::SetDeviceName(), and ns3::PacketSocketTag::SetPacketType().
Referenced by Close(), and DoBind().
|
overridevirtual |
Query whether broadcast datagram transmissions are allowed.
This method corresponds to using getsockopt() SO_BROADCAST of real network or BSD sockets.
Implements ns3::Socket.
Definition at line 516 of file packet-socket.cc.
References NS_LOG_FUNCTION.
|
overridevirtual |
Get last error number.
Implements ns3::Socket.
Definition at line 80 of file packet-socket.cc.
References m_errno, and NS_LOG_FUNCTION.
|
private |
Get the minimum MTU supported by the NetDevices bound to a specific address.
ad | the socket address to check for |
Definition at line 265 of file packet-socket.cc.
References ns3::Node::GetDevice(), ns3::Node::GetNDevices(), ns3::PacketSocketAddress::GetSingleDevice(), ns3::PacketSocketAddress::IsSingleDevice(), m_node, and NS_LOG_FUNCTION.
Referenced by GetTxAvailable(), and SendTo().
Return the node this socket is associated with.
Implements ns3::Socket.
Definition at line 94 of file packet-socket.cc.
References m_node, and NS_LOG_FUNCTION.
|
overridevirtual |
Get the peer address of a connected socket.
address | the address this socket is connected to. |
Implements ns3::Socket.
Definition at line 493 of file packet-socket.cc.
References ns3::Socket::ERROR_NOTCONN, m_destAddr, m_errno, m_state, NS_LOG_FUNCTION, and STATE_CONNECTED.
|
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.
Implements ns3::Socket.
Definition at line 427 of file packet-socket.cc.
References m_rxAvailable, and NS_LOG_FUNCTION.
|
overridevirtual |
Implements ns3::Socket.
Definition at line 87 of file packet-socket.cc.
References ns3::Socket::NS3_SOCK_RAW, and NS_LOG_FUNCTION.
|
overridevirtual |
Get socket address.
address | the address name this socket is associated with. |
Implements ns3::Socket.
Definition at line 470 of file packet-socket.cc.
References ns3::Node::GetDevice(), m_device, m_isSingleDevice, m_node, m_protocol, NS_LOG_FUNCTION, ns3::PacketSocketAddress::SetAllDevices(), ns3::PacketSocketAddress::SetPhysicalAddress(), ns3::PacketSocketAddress::SetProtocol(), and ns3::PacketSocketAddress::SetSingleDevice().
|
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.
Implements ns3::Socket.
Definition at line 286 of file packet-socket.cc.
References ns3::PacketSocketAddress::ConvertFrom(), GetMinMtu(), m_destAddr, m_state, NS_LOG_FUNCTION, and STATE_CONNECTED.
Referenced by SendTo().
|
static |
Get the type ID.
Definition at line 30 of file packet-socket.cc.
References m_dropTrace, m_rcvBufSize, ns3::MakeTraceSourceAccessor(), ns3::MakeUintegerAccessor(), ns3::MakeUintegerChecker(), and ns3::TypeId::SetParent().
|
overridevirtual |
Listen for incoming connections.
Implements ns3::Socket.
Definition at line 245 of file packet-socket.cc.
References ns3::Socket::ERROR_OPNOTSUPP, m_errno, and NS_LOG_FUNCTION.
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.
maxSize | reader will accept packet up to maxSize |
flags | Socket control flags |
Implements ns3::Socket.
Definition at line 436 of file packet-socket.cc.
References NS_LOG_FUNCTION, and RecvFrom().
|
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.
maxSize | reader will accept packet up to maxSize |
flags | Socket control flags |
fromAddress | output parameter that will return the address of the sender of the received packet, if any. Remains untouched if no packet is received. |
Implements ns3::Socket.
Definition at line 446 of file packet-socket.cc.
References m_deliveryQueue, m_rxAvailable, and NS_LOG_FUNCTION.
Referenced by Recv().
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.
p | ns3::Packet to send |
flags | Socket control flags |
Implements ns3::Socket.
Definition at line 253 of file packet-socket.cc.
References ns3::Socket::ERROR_NOTCONN, m_destAddr, m_errno, m_state, NS_LOG_FUNCTION, SendTo(), STATE_BOUND, and STATE_OPEN.
|
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.
Implements ns3::Socket.
Definition at line 299 of file packet-socket.cc.
References ns3::PacketSocketAddress::ConvertFrom(), ns3::Socket::ERROR_AFNOSUPPORT, ns3::Socket::ERROR_BADF, ns3::Socket::ERROR_INVAL, ns3::Socket::ERROR_MSGSIZE, ns3::Socket::ERROR_SHUTDOWN, ns3::Node::GetDevice(), GetMinMtu(), ns3::Node::GetNDevices(), ns3::PacketSocketAddress::GetPhysicalAddress(), ns3::Socket::GetPriority(), ns3::PacketSocketAddress::GetProtocol(), ns3::PacketSocketAddress::GetSingleDevice(), GetTxAvailable(), ns3::PacketSocketAddress::IsMatchingType(), ns3::PacketSocketAddress::IsSingleDevice(), m_errno, m_node, m_shutdownSend, m_state, ns3::Socket::NotifyDataSent(), ns3::Socket::NotifySend(), NS_LOG_FUNCTION, NS_LOG_LOGIC, pktSize, ns3::SocketPriorityTag::SetPriority(), and STATE_CLOSED.
Referenced by Send().
|
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.
allowBroadcast | Whether broadcast is allowed |
Implements ns3::Socket.
Definition at line 509 of file packet-socket.cc.
References NS_LOG_FUNCTION.
Set the associated node.
node | the node |
Definition at line 61 of file packet-socket.cc.
References m_node, and NS_LOG_FUNCTION.
|
overridevirtual |
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 178 of file packet-socket.cc.
References ns3::Socket::ERROR_BADF, m_errno, m_shutdownRecv, m_state, NS_LOG_FUNCTION, and STATE_CLOSED.
|
overridevirtual |
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 165 of file packet-socket.cc.
References ns3::Socket::ERROR_BADF, m_errno, m_shutdownSend, m_state, NS_LOG_FUNCTION, and STATE_CLOSED.
Rx queue.
Definition at line 198 of file packet-socket.h.
Referenced by ForwardUp(), and RecvFrom().
|
private |
Default destination address.
Definition at line 196 of file packet-socket.h.
Referenced by Connect(), GetPeerName(), GetTxAvailable(), and Send().
|
private |
index of the bound NetDevice
Definition at line 195 of file packet-socket.h.
Referenced by PacketSocket(), DoBind(), DoDispose(), and GetSockName().
|
private |
Traced callback: dropped packets.
Definition at line 202 of file packet-socket.h.
Referenced by ForwardUp(), and GetTypeId().
|
mutableprivate |
Socket error code.
Definition at line 189 of file packet-socket.h.
Referenced by PacketSocket(), Bind(), Close(), Connect(), DoBind(), GetErrno(), GetPeerName(), Listen(), Send(), SendTo(), ShutdownRecv(), and ShutdownSend().
|
private |
Is bound to a single netDevice.
Definition at line 194 of file packet-socket.h.
Referenced by PacketSocket(), DoBind(), and GetSockName().
the associated node
Definition at line 188 of file packet-socket.h.
Referenced by Close(), DoBind(), GetMinMtu(), GetNode(), GetSockName(), SendTo(), and SetNode().
|
private |
Socket protocol.
Definition at line 193 of file packet-socket.h.
Referenced by DoBind(), and GetSockName().
|
private |
Rx buffer size [Bytes].
Definition at line 205 of file packet-socket.h.
Referenced by ForwardUp(), and GetTypeId().
|
private |
Rx queue size [Bytes].
Definition at line 199 of file packet-socket.h.
Referenced by ForwardUp(), GetRxAvailable(), and RecvFrom().
|
private |
Receive no longer allowed.
Definition at line 191 of file packet-socket.h.
Referenced by PacketSocket(), Close(), ForwardUp(), and ShutdownRecv().
|
private |
Send no longer allowed.
Definition at line 190 of file packet-socket.h.
Referenced by PacketSocket(), Close(), SendTo(), and ShutdownSend().
|
private |
Socket state.
Definition at line 192 of file packet-socket.h.
Referenced by PacketSocket(), Close(), Connect(), DoBind(), GetPeerName(), GetTxAvailable(), Send(), SendTo(), ShutdownRecv(), and ShutdownSend().