Classes | Public Member Functions | Static Public Member Functions

ns3::Ipv4RawSocketImpl Class Reference

Inheritance diagram for ns3::Ipv4RawSocketImpl:
Inheritance graph
[legend]
Collaboration diagram for ns3::Ipv4RawSocketImpl:
Collaboration graph
[legend]

List of all members.

Classes

struct  Data

Public Member Functions

void SetNode (Ptr< Node > node)
virtual enum Socket::SocketErrno GetErrno (void) const
virtual Ptr< NodeGetNode (void) const
virtual int Bind (const Address &address)
virtual int Bind ()
virtual int GetSockName (Address &address) const
virtual int Close (void)
 Close a socket.
virtual int ShutdownSend (void)
virtual int ShutdownRecv (void)
virtual int Connect (const Address &address)
 Initiate a connection to a remote host.
virtual int Listen (void)
 Listen for incoming connections.
virtual uint32_t GetTxAvailable (void) const
 Returns the number of bytes which can be sent in a single call to Send.
virtual int Send (Ptr< Packet > p, uint32_t flags)
 Send data (or dummy data) to the remote host.
virtual int SendTo (Ptr< Packet > p, uint32_t flags, const Address &toAddress)
 Send data to a specified peer.
virtual uint32_t GetRxAvailable (void) const
virtual Ptr< PacketRecv (uint32_t maxSize, uint32_t flags)
 Read data from the socket.
virtual Ptr< PacketRecvFrom (uint32_t maxSize, uint32_t flags, Address &fromAddress)
 Read a single packet from the socket and retrieve the sender address.
void SetProtocol (uint16_t protocol)
bool ForwardUp (Ptr< const Packet > p, Ipv4Header ipHeader, Ptr< Ipv4Interface > incomingInterface)
virtual bool SetAllowBroadcast (bool allowBroadcast)
 Configure whether broadcast datagram transmissions are allowed.
virtual bool GetAllowBroadcast () const
 Query whether broadcast datagram transmissions are allowed.

Static Public Member Functions

static TypeId GetTypeId (void)
 This method returns the TypeId associated to ns3::Ipv4RawSocketImpl.

Member Function Documentation

virtual int ns3::Ipv4RawSocketImpl::Bind ( const Address address  )  [virtual]
Parameters:
address the address to try to allocate
Returns:
0 on success, -1 on failure.

Allocate a local endpoint for this socket.

Implements ns3::Socket.

virtual int ns3::Ipv4RawSocketImpl::Bind (  )  [virtual]

Allocate a local endpoint for this socket.

Returns:
0 on success, -1 on failure.

Implements ns3::Socket.

virtual int ns3::Ipv4RawSocketImpl::Close ( void   )  [virtual]

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.

virtual int ns3::Ipv4RawSocketImpl::Connect ( const Address address  )  [virtual]

Initiate a connection to a remote host.

Parameters:
address Address of remote.

Implements ns3::Socket.

virtual bool ns3::Ipv4RawSocketImpl::GetAllowBroadcast (  )  const [virtual]

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.

virtual enum Socket::SocketErrno ns3::Ipv4RawSocketImpl::GetErrno ( void   )  const [virtual]
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.

virtual Ptr<Node> ns3::Ipv4RawSocketImpl::GetNode ( void   )  const [virtual]
Returns:
the node this socket is associated with.

Implements ns3::Socket.

virtual uint32_t ns3::Ipv4RawSocketImpl::GetRxAvailable ( void   )  const [virtual]

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.

virtual int ns3::Ipv4RawSocketImpl::GetSockName ( Address address  )  const [virtual]
Parameters:
address the address name this socket is associated with.
Returns:
0 if success, -1 otherwise

Implements ns3::Socket.

virtual uint32_t ns3::Ipv4RawSocketImpl::GetTxAvailable ( void   )  const [virtual]

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.

static TypeId ns3::Ipv4RawSocketImpl::GetTypeId ( void   )  [static]

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

This object is accessible through the following paths with Config::Set and Config::Connect:

  • /NodeList/[i]/DeviceList/[i]/$ns3::AlohaNoackNetDevice/Phy/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::BaseStationNetDevice/BsIpcsPacketClassifier/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::BaseStationNetDevice/LinkManager/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::BaseStationNetDevice/SSManager/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::BaseStationNetDevice/ServiceFlowManager/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::NonCommunicatingNetDevice/Phy/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::SubscriberStationNetDevice/Classifier/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::SubscriberStationNetDevice/LinkManager/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::SubscriberStationNetDevice/SSScheduler/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::UanNetDevice/Channel/NoiseModel/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::UanNetDevice/Channel/PropagationModel/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::UanNetDevice/Mac/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::UanNetDevice/Phy/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::UanNetDevice/Transducer/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::WimaxNetDevice/$ns3::BaseStationNetDevice/BsIpcsPacketClassifier/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::WimaxNetDevice/$ns3::BaseStationNetDevice/LinkManager/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::WimaxNetDevice/$ns3::BaseStationNetDevice/SSManager/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::WimaxNetDevice/$ns3::BaseStationNetDevice/ServiceFlowManager/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::WimaxNetDevice/$ns3::SubscriberStationNetDevice/Classifier/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::WimaxNetDevice/$ns3::SubscriberStationNetDevice/LinkManager/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::WimaxNetDevice/$ns3::SubscriberStationNetDevice/SSScheduler/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::WimaxNetDevice/BandwidthManager/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::WimaxNetDevice/BurstProfileManager/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::WimaxNetDevice/Channel/$ns3::UanChannel/NoiseModel/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::WimaxNetDevice/Channel/$ns3::UanChannel/PropagationModel/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::WimaxNetDevice/ConnectionManager/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::WimaxNetDevice/Phy/Channel/$ns3::UanChannel/NoiseModel/$ns3::Ipv4RawSocketImpl
  • /NodeList/[i]/DeviceList/[i]/$ns3::WimaxNetDevice/Phy/Channel/$ns3::UanChannel/PropagationModel/$ns3::Ipv4RawSocketImpl

Attributes defined for this type:

  • Protocol: Protocol number to match.
  • IcmpFilter: Any icmp header whose type field matches a bit in this filter is dropped.
  • IpHeaderInclude: Include IP Header information (a.k.a setsockopt (IP_HDRINCL)).
    • Set with class: BooleanValue
    • Underlying type: bool
    • Initial value: false
    • Flags: construct write read

No TraceSources defined for this type.

Reimplemented from ns3::Object.

virtual int ns3::Ipv4RawSocketImpl::Listen ( void   )  [virtual]

Listen for incoming connections.

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

Implements ns3::Socket.

virtual Ptr<Packet> ns3::Ipv4RawSocketImpl::Recv ( uint32_t  maxSize,
uint32_t  flags 
) [virtual]

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:
maxSize reader will accept packet up to maxSize
flags Socket 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.

virtual Ptr<Packet> ns3::Ipv4RawSocketImpl::RecvFrom ( uint32_t  maxSize,
uint32_t  flags,
Address fromAddress 
) [virtual]

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:
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.
Returns:
Ptr<Packet> of the next in-sequence packet. Returns 0 if the socket cannot return a next in-sequence packet.

Implements ns3::Socket.

virtual int ns3::Ipv4RawSocketImpl::Send ( Ptr< Packet p,
uint32_t  flags 
) [virtual]

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:
p ns3::Packet to send
flags Socket control flags
Returns:
the number of bytes accepted for transmission if no error occurs, and -1 otherwise.
See also:
SetSendCallback

Implements ns3::Socket.

virtual int ns3::Ipv4RawSocketImpl::SendTo ( Ptr< Packet p,
uint32_t  flags,
const Address toAddress 
) [virtual]

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:
p packet to send
flags Socket control flags
toAddress IP 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.

virtual bool ns3::Ipv4RawSocketImpl::SetAllowBroadcast ( bool  allowBroadcast  )  [virtual]

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:
allowBroadcast Whether broadcast is allowed
Returns:
true if operation succeeds

Implements ns3::Socket.

virtual int ns3::Ipv4RawSocketImpl::ShutdownRecv ( void   )  [virtual]
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.

virtual int ns3::Ipv4RawSocketImpl::ShutdownSend ( void   )  [virtual]
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.


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