A Discrete-Event Network Simulator
API
udp-client.cc
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2007,2008,2009 INRIA, UDCAST
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License version 2 as
6  * published by the Free Software Foundation;
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU General Public License for more details.
12  *
13  * You should have received a copy of the GNU General Public License
14  * along with this program; if not, write to the Free Software
15  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16  *
17  * Author: Amine Ismail <amine.ismail@sophia.inria.fr>
18  * <amine.ismail@udcast.com>
19  */
20 #include "udp-client.h"
21 
22 #include "seq-ts-header.h"
23 
24 #include "ns3/inet-socket-address.h"
25 #include "ns3/inet6-socket-address.h"
26 #include "ns3/ipv4-address.h"
27 #include "ns3/log.h"
28 #include "ns3/nstime.h"
29 #include "ns3/packet.h"
30 #include "ns3/simulator.h"
31 #include "ns3/socket-factory.h"
32 #include "ns3/socket.h"
33 #include "ns3/uinteger.h"
34 
35 #include <cstdio>
36 #include <cstdlib>
37 
38 namespace ns3
39 {
40 
41 NS_LOG_COMPONENT_DEFINE("UdpClient");
42 
44 
45 TypeId
47 {
48  static TypeId tid =
49  TypeId("ns3::UdpClient")
51  .SetGroupName("Applications")
52  .AddConstructor<UdpClient>()
53  .AddAttribute(
54  "MaxPackets",
55  "The maximum number of packets the application will send (zero means infinite)",
56  UintegerValue(100),
58  MakeUintegerChecker<uint32_t>())
59  .AddAttribute("Interval",
60  "The time to wait between packets",
61  TimeValue(Seconds(1.0)),
64  .AddAttribute("RemoteAddress",
65  "The destination Address of the outbound packets",
66  AddressValue(),
67  MakeAddressAccessor(&UdpClient::m_peerAddress),
68  MakeAddressChecker())
69  .AddAttribute("RemotePort",
70  "The destination port of the outbound packets",
71  UintegerValue(100),
73  MakeUintegerChecker<uint16_t>())
74  .AddAttribute("PacketSize",
75  "Size of packets generated. The minimum packet size is 12 bytes which is "
76  "the size of the header carrying the sequence number and the time stamp.",
77  UintegerValue(1024),
79  MakeUintegerChecker<uint32_t>(12, 65507))
80  .AddTraceSource("Tx",
81  "A new packet is created and sent",
83  "ns3::Packet::TracedCallback")
84  .AddTraceSource("TxWithAddresses",
85  "A new packet is created and sent",
87  "ns3::Packet::TwoAddressTracedCallback");
88  return tid;
89 }
90 
92 {
93  NS_LOG_FUNCTION(this);
94  m_sent = 0;
95  m_totalTx = 0;
96  m_socket = nullptr;
97  m_sendEvent = EventId();
98 }
99 
101 {
102  NS_LOG_FUNCTION(this);
103 }
104 
105 void
107 {
108  NS_LOG_FUNCTION(this << ip << port);
109  m_peerAddress = ip;
110  m_peerPort = port;
111 }
112 
113 void
115 {
116  NS_LOG_FUNCTION(this << addr);
117  m_peerAddress = addr;
118 }
119 
120 void
122 {
123  NS_LOG_FUNCTION(this);
125 }
126 
127 void
129 {
130  NS_LOG_FUNCTION(this);
131 
132  if (!m_socket)
133  {
134  TypeId tid = TypeId::LookupByName("ns3::UdpSocketFactory");
137  {
138  if (m_socket->Bind() == -1)
139  {
140  NS_FATAL_ERROR("Failed to bind socket");
141  }
142  m_socket->Connect(
144  }
146  {
147  if (m_socket->Bind6() == -1)
148  {
149  NS_FATAL_ERROR("Failed to bind socket");
150  }
151  m_socket->Connect(
153  }
155  {
156  if (m_socket->Bind() == -1)
157  {
158  NS_FATAL_ERROR("Failed to bind socket");
159  }
161  }
163  {
164  if (m_socket->Bind6() == -1)
165  {
166  NS_FATAL_ERROR("Failed to bind socket");
167  }
169  }
170  else
171  {
172  NS_ASSERT_MSG(false, "Incompatible address type: " << m_peerAddress);
173  }
174  }
175 
176 #ifdef NS3_LOG_ENABLE
177  std::stringstream peerAddressStringStream;
179  {
180  peerAddressStringStream << Ipv4Address::ConvertFrom(m_peerAddress);
181  }
183  {
184  peerAddressStringStream << Ipv6Address::ConvertFrom(m_peerAddress);
185  }
187  {
188  peerAddressStringStream << InetSocketAddress::ConvertFrom(m_peerAddress).GetIpv4();
189  }
191  {
192  peerAddressStringStream << Inet6SocketAddress::ConvertFrom(m_peerAddress).GetIpv6();
193  }
194  m_peerAddressString = peerAddressStringStream.str();
195 #endif // NS3_LOG_ENABLE
196 
200 }
201 
202 void
204 {
205  NS_LOG_FUNCTION(this);
207 }
208 
209 void
211 {
212  NS_LOG_FUNCTION(this);
214 
215  Address from;
216  Address to;
217  m_socket->GetSockName(from);
218  m_socket->GetPeerName(to);
219  SeqTsHeader seqTs;
220  seqTs.SetSeq(m_sent);
222  Ptr<Packet> p = Create<Packet>(m_size - seqTs.GetSerializedSize());
223 
224  // Trace before adding header, for consistency with PacketSink
225  m_txTrace(p);
226  m_txTraceWithAddresses(p, from, to);
227 
228  p->AddHeader(seqTs);
229 
230  if ((m_socket->Send(p)) >= 0)
231  {
232  ++m_sent;
233  m_totalTx += p->GetSize();
234 #ifdef NS3_LOG_ENABLE
235  NS_LOG_INFO("TraceDelay TX " << m_size << " bytes to " << m_peerAddressString << " Uid: "
236  << p->GetUid() << " Time: " << (Simulator::Now()).As(Time::S));
237 #endif // NS3_LOG_ENABLE
238  }
239 #ifdef NS3_LOG_ENABLE
240  else
241  {
242  NS_LOG_INFO("Error while sending " << m_size << " bytes to " << m_peerAddressString);
243  }
244 #endif // NS3_LOG_ENABLE
245 
246  if (m_sent < m_count || m_count == 0)
247  {
249  }
250 }
251 
252 uint64_t
254 {
255  return m_totalTx;
256 }
257 
258 } // Namespace ns3
a polymophic address class
Definition: address.h:101
The base class for all ns3 applications.
Definition: application.h:62
void DoDispose() override
Destructor implementation.
Definition: application.cc:86
Ptr< Node > GetNode() const
Definition: application.cc:108
An identifier for simulation events.
Definition: event-id.h:55
bool IsExpired() const
This method is syntactic sugar for the ns3::Simulator::IsExpired method.
Definition: event-id.cc:69
An Inet6 address class.
static Inet6SocketAddress ConvertFrom(const Address &addr)
Convert the address to a InetSocketAddress.
static bool IsMatchingType(const Address &addr)
If the address match.
Ipv6Address GetIpv6() const
Get the IPv6 address.
an Inet address class
static bool IsMatchingType(const Address &address)
Ipv4Address GetIpv4() const
static InetSocketAddress ConvertFrom(const Address &address)
Returns an InetSocketAddress which corresponds to the input Address.
static Ipv4Address ConvertFrom(const Address &address)
static bool IsMatchingType(const Address &address)
static Ipv6Address ConvertFrom(const Address &address)
Convert the Address object into an Ipv6Address ones.
static bool IsMatchingType(const Address &address)
If the Address matches the type.
void AddHeader(const Header &header)
Add header to this packet.
Definition: packet.cc:268
uint32_t GetSize() const
Returns the the size in bytes of the packet (including the zero-filled initial payload).
Definition: packet.h:861
uint64_t GetUid() const
Returns the packet's Uid.
Definition: packet.cc:412
Packet header to carry sequence number and timestamp.
Definition: seq-ts-header.h:45
void SetSeq(uint32_t seq)
uint32_t GetSerializedSize() const override
static EventId Schedule(const Time &delay, FUNC f, Ts &&... args)
Schedule an event to expire after delay.
Definition: simulator.h:571
static void Cancel(const EventId &id)
Set the cancel bit on this event: the event's associated function will not be invoked when it expires...
Definition: simulator.cc:285
static Time Now()
Return the current simulation virtual time.
Definition: simulator.cc:208
virtual int Send(Ptr< Packet > p, uint32_t flags)=0
Send data (or dummy data) to the remote host.
virtual bool SetAllowBroadcast(bool allowBroadcast)=0
Configure whether broadcast datagram transmissions are allowed.
void SetRecvCallback(Callback< void, Ptr< Socket >> receivedData)
Notify application when new data is available to be read.
Definition: socket.cc:128
virtual int Bind6()=0
Allocate a local IPv6 endpoint for this socket.
virtual int GetPeerName(Address &address) const =0
Get the peer address of a connected socket.
virtual int Connect(const Address &address)=0
Initiate a connection to a remote host.
virtual int GetSockName(Address &address) const =0
Get socket address.
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:72
virtual int Bind(const Address &address)=0
Allocate a local endpoint for this socket.
@ S
second
Definition: nstime.h:116
a unique identifier for an interface.
Definition: type-id.h:59
static TypeId LookupByName(std::string name)
Get a TypeId by name.
Definition: type-id.cc:835
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Definition: type-id.cc:931
A Udp client.
Definition: udp-client.h:45
Time m_interval
Packet inter-send time.
Definition: udp-client.h:93
void DoDispose() override
Destructor implementation.
Definition: udp-client.cc:121
uint64_t GetTotalTx() const
Definition: udp-client.cc:253
uint64_t m_totalTx
Total bytes sent.
Definition: udp-client.h:97
~UdpClient() override
Definition: udp-client.cc:100
uint32_t m_sent
Counter for sent packets.
Definition: udp-client.h:96
Ptr< Socket > m_socket
Socket.
Definition: udp-client.h:98
TracedCallback< Ptr< const Packet >, const Address &, const Address & > m_txTraceWithAddresses
Callbacks for tracing the packet Tx events, includes source and destination addresses.
Definition: udp-client.h:90
uint16_t m_peerPort
Remote peer port.
Definition: udp-client.h:100
void Send()
Send a packet.
Definition: udp-client.cc:210
static TypeId GetTypeId()
Get the type ID.
Definition: udp-client.cc:46
EventId m_sendEvent
Event to send the next packet.
Definition: udp-client.h:101
uint32_t m_size
Size of the sent packet (including the SeqTsHeader)
Definition: udp-client.h:94
uint32_t m_count
Maximum number of packets the application will send.
Definition: udp-client.h:92
void SetRemote(Address ip, uint16_t port)
set the remote address and port
Definition: udp-client.cc:106
Address m_peerAddress
Remote peer address.
Definition: udp-client.h:99
TracedCallback< Ptr< const Packet > > m_txTrace
Traced Callback: transmitted packets.
Definition: udp-client.h:87
void StartApplication() override
Application specific startup code.
Definition: udp-client.cc:128
void StopApplication() override
Application specific shutdown code.
Definition: udp-client.cc:203
std::string m_peerAddressString
Remote peer address string.
Definition: udp-client.h:104
Hold an unsigned integer type.
Definition: uinteger.h:45
uint16_t port
Definition: dsdv-manet.cc:44
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file,...
Definition: assert.h:66
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
Definition: assert.h:86
Callback< R, Args... > MakeNullCallback()
Definition: callback.h:747
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
Definition: fatal-error.h:179
#define NS_ABORT_IF(cond)
Abnormal program termination if a condition is true.
Definition: abort.h:76
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:202
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Definition: log.h:275
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Definition: object-base.h:46
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1326
Ptr< const TraceSourceAccessor > MakeTraceSourceAccessor(T a)
Create a TraceSourceAccessor which will control access to the underlying trace source.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
Ptr< const AttributeAccessor > MakeTimeAccessor(T1 a1)
Definition: nstime.h:1414
Ptr< const AttributeChecker > MakeTimeChecker(const Time min, const Time max)
Helper to make a Time checker with bounded range.
Definition: time.cc:533
Ptr< const AttributeAccessor > MakeUintegerAccessor(T1 a1)
Definition: uinteger.h:46