A Discrete-Event Network Simulator
API
udp-l4-protocol.h
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2005,2006,2007 INRIA
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2 as
7  * published by the Free Software Foundation;
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17  *
18  * Author: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
19  */
20 
21 #ifndef UDP_L4_PROTOCOL_H
22 #define UDP_L4_PROTOCOL_H
23 
24 #include <stdint.h>
25 
26 #include "ns3/packet.h"
27 #include "ns3/ptr.h"
28 #include "ip-l4-protocol.h"
29 
30 namespace ns3 {
31 
32 class Node;
33 class Socket;
34 class Ipv4EndPointDemux;
35 class Ipv4EndPoint;
36 class Ipv6EndPointDemux;
37 class Ipv6EndPoint;
38 class UdpSocketImpl;
39 
60 class UdpL4Protocol : public IpL4Protocol {
61 public:
66  static TypeId GetTypeId (void);
67  static const uint8_t PROT_NUMBER;
68 
69  UdpL4Protocol ();
70  virtual ~UdpL4Protocol ();
71 
76  void SetNode (Ptr<Node> node);
77 
78  virtual int GetProtocolNumber (void) const;
79 
85 
90  Ipv4EndPoint *Allocate (void);
102  Ipv4EndPoint *Allocate (uint16_t port);
118  Ipv4EndPoint *Allocate (Ipv4Address localAddress, uint16_t localPort,
119  Ipv4Address peerAddress, uint16_t peerPort);
120 
125  Ipv6EndPoint *Allocate6 (void);
137  Ipv6EndPoint *Allocate6 (uint16_t port);
153  Ipv6EndPoint *Allocate6 (Ipv6Address localAddress, uint16_t localPort,
154  Ipv6Address peerAddress, uint16_t peerPort);
155 
160  void DeAllocate (Ipv4EndPoint *endPoint);
165  void DeAllocate (Ipv6EndPoint *endPoint);
166 
167  // called by UdpSocket.
176  void Send (Ptr<Packet> packet,
177  Ipv4Address saddr, Ipv4Address daddr,
178  uint16_t sport, uint16_t dport);
188  void Send (Ptr<Packet> packet,
189  Ipv4Address saddr, Ipv4Address daddr,
190  uint16_t sport, uint16_t dport, Ptr<Ipv4Route> route);
199  void Send (Ptr<Packet> packet,
200  Ipv6Address saddr, Ipv6Address daddr,
201  uint16_t sport, uint16_t dport);
211  void Send (Ptr<Packet> packet,
212  Ipv6Address saddr, Ipv6Address daddr,
213  uint16_t sport, uint16_t dport, Ptr<Ipv6Route> route);
214 
215  // inherited from Ipv4L4Protocol
217  Ipv4Header const &header,
218  Ptr<Ipv4Interface> interface);
220  Ipv6Header const &header,
221  Ptr<Ipv6Interface> interface);
222 
223  virtual void ReceiveIcmp (Ipv4Address icmpSource, uint8_t icmpTtl,
224  uint8_t icmpType, uint8_t icmpCode, uint32_t icmpInfo,
225  Ipv4Address payloadSource,Ipv4Address payloadDestination,
226  const uint8_t payload[8]);
227  virtual void ReceiveIcmp (Ipv6Address icmpSource, uint8_t icmpTtl,
228  uint8_t icmpType, uint8_t icmpCode, uint32_t icmpInfo,
229  Ipv6Address payloadSource,Ipv6Address payloadDestination,
230  const uint8_t payload[8]);
231 
232  // From IpL4Protocol
235  // From IpL4Protocol
236  virtual IpL4Protocol::DownTargetCallback GetDownTarget (void) const;
238 
239 protected:
240  virtual void DoDispose (void);
241  /*
242  * This function will notify other components connected to the node that a new stack member is now connected
243  * This will be used to notify Layer 3 protocol of layer 4 protocol stack to connect them together.
244  */
245  virtual void NotifyNewAggregate ();
246 private:
250 
256  UdpL4Protocol (const UdpL4Protocol &);
264 
265  std::vector<Ptr<UdpSocketImpl> > m_sockets;
268 
269 };
270 
271 } // namespace ns3
272 
273 #endif /* UDP_L4_PROTOCOL_H */
Packet header for IPv6.
Definition: ipv6-header.h:34
Ptr< Socket > CreateSocket(void)
virtual void DoDispose(void)
Destructor implementation.
virtual void SetDownTarget(IpL4Protocol::DownTargetCallback cb)
This method allows a caller to set the current down target callback set for this L4 protocol (IPv4 ca...
UdpL4Protocol & operator=(const UdpL4Protocol &)
Copy constructor.
Ptr< Node > m_node
the node this stack is associated with
virtual void SetDownTarget6(IpL4Protocol::DownTargetCallback6 cb)
This method allows a caller to set the current down target callback set for this L4 protocol (IPv6 ca...
RxStatus
Rx status codes.
void SetNode(Ptr< Node > node)
Set node associated with this stack.
uint16_t port
Definition: dsdv-manet.cc:44
Demultiplexes packets to various transport layer endpoints.
virtual int GetProtocolNumber(void) const
Returns the protocol number of this protocol.
Packet header for IPv4.
Definition: ipv4-header.h:33
virtual enum IpL4Protocol::RxStatus Receive(Ptr< Packet > p, Ipv4Header const &header, Ptr< Ipv4Interface > interface)
Called from lower-level layers to send the packet up in the stack.
Ipv4EndPoint * Allocate(void)
Allocate an IPv4 Endpoint.
static TypeId GetTypeId(void)
Get the type ID.
virtual IpL4Protocol::DownTargetCallback6 GetDownTarget6(void) const
This method allows a caller to get the current down target callback set for this L4 protocol (IPv6 ca...
Every class exported by the ns3 library is enclosed in the ns3 namespace.
virtual void ReceiveIcmp(Ipv4Address icmpSource, uint8_t icmpTtl, uint8_t icmpType, uint8_t icmpCode, uint32_t icmpInfo, Ipv4Address payloadSource, Ipv4Address payloadDestination, const uint8_t payload[8])
Called from lower-level layers to send the ICMP packet up in the stack.
Ipv6EndPointDemux * m_endPoints6
A list of IPv6 end points.
L4 Protocol abstract base class.
void DeAllocate(Ipv4EndPoint *endPoint)
Remove an IPv4 Endpoint.
IpL4Protocol::DownTargetCallback6 m_downTarget6
Callback to send packets over IPv6.
virtual IpL4Protocol::DownTargetCallback GetDownTarget(void) const
This method allows a caller to get the current down target callback set for this L4 protocol (IPv4 ca...
Describes an IPv6 address.
Definition: ipv6-address.h:48
Ipv4 addresses are stored in host order in this class.
Definition: ipv4-address.h:40
IpL4Protocol::DownTargetCallback m_downTarget
Callback to send packets over IPv4.
virtual void NotifyNewAggregate()
Notify all Objects aggregated to this one of a new Object being aggregated.
Implementation of the UDP protocol.
Demultiplexer for end points.
std::vector< Ptr< UdpSocketImpl > > m_sockets
list of sockets
A representation of an IPv6 endpoint/connection.
Ipv4EndPointDemux * m_endPoints
A list of IPv4 end points.
void Send(Ptr< Packet > packet, Ipv4Address saddr, Ipv4Address daddr, uint16_t sport, uint16_t dport)
Send a packet via UDP (IPv4)
Ipv6EndPoint * Allocate6(void)
Allocate an IPv6 Endpoint.
tuple address
Definition: first.py:37
a unique identifier for an interface.
Definition: type-id.h:58
static const uint8_t PROT_NUMBER
protocol number (0x11)
A representation of an internet endpoint/connection.