A Discrete-Event Network Simulator
API
packet-sink.cc
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright 2007 University of Washington
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: Tom Henderson (tomhend@u.washington.edu)
19  */
20 #include "ns3/address.h"
21 #include "ns3/address-utils.h"
22 #include "ns3/log.h"
23 #include "ns3/inet-socket-address.h"
24 #include "ns3/inet6-socket-address.h"
25 #include "ns3/node.h"
26 #include "ns3/socket.h"
27 #include "ns3/udp-socket.h"
28 #include "ns3/simulator.h"
29 #include "ns3/socket-factory.h"
30 #include "ns3/packet.h"
31 #include "ns3/trace-source-accessor.h"
32 #include "ns3/udp-socket-factory.h"
33 #include "packet-sink.h"
34 
35 namespace ns3 {
36 
37 NS_LOG_COMPONENT_DEFINE ("PacketSink");
38 
39 NS_OBJECT_ENSURE_REGISTERED (PacketSink);
40 
41 TypeId
43 {
44  static TypeId tid = TypeId ("ns3::PacketSink")
46  .SetGroupName("Applications")
47  .AddConstructor<PacketSink> ()
48  .AddAttribute ("Local",
49  "The Address on which to Bind the rx socket.",
50  AddressValue (),
53  .AddAttribute ("Protocol",
54  "The type id of the protocol to use for the rx socket.",
58  .AddTraceSource ("Rx",
59  "A packet has been received",
61  "ns3::Packet::AddressTracedCallback")
62  ;
63  return tid;
64 }
65 
67 {
68  NS_LOG_FUNCTION (this);
69  m_socket = 0;
70  m_totalRx = 0;
71 }
72 
74 {
75  NS_LOG_FUNCTION (this);
76 }
77 
78 uint64_t PacketSink::GetTotalRx () const
79 {
80  NS_LOG_FUNCTION (this);
81  return m_totalRx;
82 }
83 
86 {
87  NS_LOG_FUNCTION (this);
88  return m_socket;
89 }
90 
91 std::list<Ptr<Socket> >
93 {
94  NS_LOG_FUNCTION (this);
95  return m_socketList;
96 }
97 
99 {
100  NS_LOG_FUNCTION (this);
101  m_socket = 0;
102  m_socketList.clear ();
103 
104  // chain up
106 }
107 
108 
109 // Application Methods
110 void PacketSink::StartApplication () // Called at time specified by Start
111 {
112  NS_LOG_FUNCTION (this);
113  // Create the socket if not already
114  if (!m_socket)
115  {
117  if (m_socket->Bind (m_local) == -1)
118  {
119  NS_FATAL_ERROR ("Failed to bind socket");
120  }
121  m_socket->Listen ();
124  {
125  Ptr<UdpSocket> udpSocket = DynamicCast<UdpSocket> (m_socket);
126  if (udpSocket)
127  {
128  // equivalent to setsockopt (MCAST_JOIN_GROUP)
129  udpSocket->MulticastJoinGroup (0, m_local);
130  }
131  else
132  {
133  NS_FATAL_ERROR ("Error: joining multicast on a non-UDP socket");
134  }
135  }
136  }
137 
140  MakeNullCallback<bool, Ptr<Socket>, const Address &> (),
145 }
146 
147 void PacketSink::StopApplication () // Called at time specified by Stop
148 {
149  NS_LOG_FUNCTION (this);
150  while(!m_socketList.empty ()) //these are accepted sockets, close them
151  {
152  Ptr<Socket> acceptedSocket = m_socketList.front ();
153  m_socketList.pop_front ();
154  acceptedSocket->Close ();
155  }
156  if (m_socket)
157  {
158  m_socket->Close ();
160  }
161 }
162 
164 {
165  NS_LOG_FUNCTION (this << socket);
166  Ptr<Packet> packet;
167  Address from;
168  while ((packet = socket->RecvFrom (from)))
169  {
170  if (packet->GetSize () == 0)
171  { //EOF
172  break;
173  }
174  m_totalRx += packet->GetSize ();
176  {
177  NS_LOG_INFO ("At time " << Simulator::Now ().GetSeconds ()
178  << "s packet sink received "
179  << packet->GetSize () << " bytes from "
181  << " port " << InetSocketAddress::ConvertFrom (from).GetPort ()
182  << " total Rx " << m_totalRx << " bytes");
183  }
184  else if (Inet6SocketAddress::IsMatchingType (from))
185  {
186  NS_LOG_INFO ("At time " << Simulator::Now ().GetSeconds ()
187  << "s packet sink received "
188  << packet->GetSize () << " bytes from "
190  << " port " << Inet6SocketAddress::ConvertFrom (from).GetPort ()
191  << " total Rx " << m_totalRx << " bytes");
192  }
193  m_rxTrace (packet, from);
194  }
195 }
196 
197 
199 {
200  NS_LOG_FUNCTION (this << socket);
201 }
202 
204 {
205  NS_LOG_FUNCTION (this << socket);
206 }
207 
208 
210 {
211  NS_LOG_FUNCTION (this << s << from);
213  m_socketList.push_back (s);
214 }
215 
216 } // Namespace ns3
static TypeId GetTypeId(void)
Get the type ID.
Ipv6Address GetIpv6(void) const
Get the IPv6 address.
Ipv4Address GetIpv4(void) const
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
Address m_local
Local address to bind to.
Definition: packet-sink.h:129
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Definition: object-base.h:45
virtual int ShutdownSend(void)=0
bool IsMulticast(const Address &ad)
Address family-independent test for a multicast address.
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:201
TracedCallback< Ptr< const Packet >, const Address & > m_rxTrace
Traced Callback: received packets, source address.
Definition: packet-sink.h:134
uint32_t GetSize(void) const
Returns the the size in bytes of the packet (including the zero-filled initial payload).
Definition: packet.h:796
void SetCloseCallbacks(Callback< void, Ptr< Socket > > normalClose, Callback< void, Ptr< Socket > > errorClose)
Detect socket recv() events such as graceful shutdown or error.
Definition: socket.cc:94
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Definition: log.h:277
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
Definition: fatal-error.h:162
static TypeId GetTypeId(void)
Get the type ID.
Definition: packet-sink.cc:42
Callback< R > MakeNullCallback(void)
Definition: callback.h:1635
a polymophic address class
Definition: address.h:90
Ptr< const TraceSourceAccessor > MakeTraceSourceAccessor(T a)
Create a TraceSourceAccessor which will control access to the underlying trace source.
virtual int Listen(void)=0
Listen for incoming connections.
Ptr< const AttributeAccessor > MakeAddressAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
Definition: address.h:278
The base class for all ns3 applications.
Definition: application.h:60
Ptr< Node > GetNode() const
Definition: application.cc:104
void HandleRead(Ptr< Socket > socket)
Handle a packet received by the application.
Definition: packet-sink.cc:163
AttributeValue implementation for TypeId.
Definition: type-id.h:608
TypeId m_tid
Protocol TypeId.
Definition: packet-sink.h:131
Callback< R > MakeCallback(R(T::*memPtr)(void), OBJ objPtr)
Definition: callback.h:1489
virtual void StopApplication(void)
Application specific shutdown code.
Definition: packet-sink.cc:147
void SetRecvCallback(Callback< void, Ptr< Socket > >)
Notify application when new data is available to be read.
Definition: socket.cc:128
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 specif...
Definition: socket.cc:71
void HandlePeerClose(Ptr< Socket > socket)
Handle an connection close.
Definition: packet-sink.cc:198
virtual void DoDispose(void)
Destructor implementation.
Definition: application.cc:83
virtual int Bind(const Address &address)=0
Allocate a local endpoint for this socket.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
static InetSocketAddress ConvertFrom(const Address &address)
Returns an InetSocketAddress which corresponds to the input Address.
uint64_t m_totalRx
Total bytes received.
Definition: packet-sink.h:130
Ptr< const AttributeChecker > MakeAddressChecker(void)
Definition: address.cc:172
virtual ~PacketSink()
Definition: packet-sink.cc:73
static Time Now(void)
Return the current simulation virtual time.
Definition: simulator.cc:249
void SetAcceptCallback(Callback< bool, Ptr< Socket >, const Address & > connectionRequest, Callback< void, Ptr< Socket >, const Address & > newConnectionCreated)
Accept connection requests from remote hosts.
Definition: socket.cc:104
std::list< Ptr< Socket > > GetAcceptedSockets(void) const
Definition: packet-sink.cc:92
std::list< Ptr< Socket > > m_socketList
the accepted sockets
Definition: packet-sink.h:127
Ptr< const AttributeAccessor > MakeTypeIdAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
Definition: type-id.h:608
AttributeValue implementation for Address.
Definition: address.h:278
void HandleAccept(Ptr< Socket > socket, const Address &from)
Handle an incoming connection.
Definition: packet-sink.cc:209
void HandlePeerError(Ptr< Socket > socket)
Handle an connection error.
Definition: packet-sink.cc:203
static Inet6SocketAddress ConvertFrom(const Address &addr)
Convert the address to a InetSocketAddress.
static bool IsMatchingType(const Address &addr)
If the address match.
uint16_t GetPort(void) const
Get the port.
virtual void DoDispose(void)
Destructor implementation.
Definition: packet-sink.cc:98
uint16_t GetPort(void) const
virtual void StartApplication(void)
Application specific startup code.
Definition: packet-sink.cc:110
virtual Ptr< Packet > RecvFrom(uint32_t maxSize, uint32_t flags, Address &fromAddress)=0
Read a single packet from the socket and retrieve the sender address.
Receive and consume traffic generated to an IP address and port.
Definition: packet-sink.h:68
Ptr< Socket > m_socket
Listening socket.
Definition: packet-sink.h:126
virtual int Close(void)=0
Close a socket.
Ptr< const AttributeChecker > MakeTypeIdChecker(void)
Definition: type-id.cc:1224
uint64_t GetTotalRx() const
Definition: packet-sink.cc:78
a unique identifier for an interface.
Definition: type-id.h:58
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Definition: type-id.cc:914
static bool IsMatchingType(const Address &address)
Ptr< Socket > GetListeningSocket(void) const
Definition: packet-sink.cc:85