A Discrete-Event Network Simulator
API
udp-client.cc
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2007,2008,2009 INRIA, UDCAST
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: Amine Ismail <amine.ismail@sophia.inria.fr>
19  * <amine.ismail@udcast.com>
20  */
21 #include "ns3/log.h"
22 #include "ns3/ipv4-address.h"
23 #include "ns3/nstime.h"
24 #include "ns3/inet-socket-address.h"
25 #include "ns3/inet6-socket-address.h"
26 #include "ns3/socket.h"
27 #include "ns3/simulator.h"
28 #include "ns3/socket-factory.h"
29 #include "ns3/packet.h"
30 #include "ns3/uinteger.h"
31 #include "udp-client.h"
32 #include "seq-ts-header.h"
33 #include <cstdlib>
34 #include <cstdio>
35 
36 namespace ns3 {
37 
38 NS_LOG_COMPONENT_DEFINE ("UdpClient");
39 
40 NS_OBJECT_ENSURE_REGISTERED (UdpClient);
41 
42 TypeId
44 {
45  static TypeId tid = TypeId ("ns3::UdpClient")
47  .SetGroupName("Applications")
48  .AddConstructor<UdpClient> ()
49  .AddAttribute ("MaxPackets",
50  "The maximum number of packets the application will send",
51  UintegerValue (100),
53  MakeUintegerChecker<uint32_t> ())
54  .AddAttribute ("Interval",
55  "The time to wait between packets", TimeValue (Seconds (1.0)),
57  MakeTimeChecker ())
58  .AddAttribute ("RemoteAddress",
59  "The destination Address of the outbound packets",
60  AddressValue (),
63  .AddAttribute ("RemotePort", "The destination port of the outbound packets",
64  UintegerValue (100),
66  MakeUintegerChecker<uint16_t> ())
67  .AddAttribute ("PacketSize",
68  "Size of packets generated. The minimum packet size is 12 bytes which is the size of the header carrying the sequence number and the time stamp.",
69  UintegerValue (1024),
71  MakeUintegerChecker<uint32_t> (12,65507))
72  ;
73  return tid;
74 }
75 
77 {
78  NS_LOG_FUNCTION (this);
79  m_sent = 0;
80  m_totalTx = 0;
81  m_socket = 0;
82  m_sendEvent = EventId ();
83 }
84 
86 {
87  NS_LOG_FUNCTION (this);
88 }
89 
90 void
92 {
93  NS_LOG_FUNCTION (this << ip << port);
94  m_peerAddress = ip;
95  m_peerPort = port;
96 }
97 
98 void
100 {
101  NS_LOG_FUNCTION (this << addr);
102  m_peerAddress = addr;
103 }
104 
105 void
107 {
108  NS_LOG_FUNCTION (this);
110 }
111 
112 void
114 {
115  NS_LOG_FUNCTION (this);
116 
117  if (m_socket == 0)
118  {
119  TypeId tid = TypeId::LookupByName ("ns3::UdpSocketFactory");
122  {
123  if (m_socket->Bind () == -1)
124  {
125  NS_FATAL_ERROR ("Failed to bind socket");
126  }
128  }
129  else if (Ipv6Address::IsMatchingType(m_peerAddress) == true)
130  {
131  if (m_socket->Bind6 () == -1)
132  {
133  NS_FATAL_ERROR ("Failed to bind socket");
134  }
136  }
138  {
139  if (m_socket->Bind () == -1)
140  {
141  NS_FATAL_ERROR ("Failed to bind socket");
142  }
144  }
146  {
147  if (m_socket->Bind6 () == -1)
148  {
149  NS_FATAL_ERROR ("Failed to bind socket");
150  }
152  }
153  else
154  {
155  NS_ASSERT_MSG (false, "Incompatible address type: " << m_peerAddress);
156  }
157  }
158 
159 #ifdef NS3_LOG_ENABLE
160  std::stringstream peerAddressStringStream;
162  {
163  peerAddressStringStream << Ipv4Address::ConvertFrom (m_peerAddress);
164  }
166  {
167  peerAddressStringStream << Ipv6Address::ConvertFrom (m_peerAddress);
168  }
170  {
171  peerAddressStringStream << InetSocketAddress::ConvertFrom (m_peerAddress).GetIpv4 ();
172  }
174  {
175  peerAddressStringStream << Inet6SocketAddress::ConvertFrom (m_peerAddress).GetIpv6 ();
176  }
177  m_peerAddressString = peerAddressStringStream.str();
178 #endif // NS3_LOG_ENABLE
179 
181  m_socket->SetAllowBroadcast (true);
183 }
184 
185 void
187 {
188  NS_LOG_FUNCTION (this);
190 }
191 
192 void
194 {
195  NS_LOG_FUNCTION (this);
197  SeqTsHeader seqTs;
198  seqTs.SetSeq (m_sent);
199  Ptr<Packet> p = Create<Packet> (m_size-(8+4)); // 8+4 : the size of the seqTs header
200  p->AddHeader (seqTs);
201 
202  if ((m_socket->Send (p)) >= 0)
203  {
204  ++m_sent;
205  m_totalTx += p->GetSize ();
206 #ifdef NS3_LOG_ENABLE
207  NS_LOG_INFO ("TraceDelay TX " << m_size << " bytes to "
208  << m_peerAddressString << " Uid: "
209  << p->GetUid () << " Time: "
210  << (Simulator::Now ()).As (Time::S));
211 #endif // NS3_LOG_ENABLE
212  }
213 #ifdef NS3_LOG_ENABLE
214  else
215  {
216  NS_LOG_INFO ("Error while sending " << m_size << " bytes to "
218  }
219 #endif // NS3_LOG_ENABLE
220 
221  if (m_sent < m_count)
222  {
224  }
225 }
226 
227 
228 uint64_t
230 {
231  return m_totalTx;
232 }
233 
234 
235 } // Namespace ns3
ns3::TypeId
a unique identifier for an interface.
Definition: type-id.h:59
NS_LOG_COMPONENT_DEFINE
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:205
ns3::InetSocketAddress
an Inet address class
Definition: inet-socket-address.h:41
ns3::Inet6SocketAddress::IsMatchingType
static bool IsMatchingType(const Address &addr)
If the address match.
Definition: inet6-socket-address.cc:89
ns3::UdpClient::m_peerPort
uint16_t m_peerPort
Remote peer port.
Definition: udp-client.h:94
ns3::Socket::SetAllowBroadcast
virtual bool SetAllowBroadcast(bool allowBroadcast)=0
Configure whether broadcast datagram transmissions are allowed.
ns3::Ipv6Address::IsMatchingType
static bool IsMatchingType(const Address &address)
If the Address matches the type.
Definition: ipv6-address.cc:827
NS_OBJECT_ENSURE_REGISTERED
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Definition: object-base.h:45
udp-client.h
NS_ASSERT
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file,...
Definition: assert.h:67
ns3::InetSocketAddress::IsMatchingType
static bool IsMatchingType(const Address &address)
Definition: inet-socket-address.cc:103
ns3::MakeTimeChecker
Ptr< const AttributeChecker > MakeTimeChecker(const Time min, const Time max)
Helper to make a Time checker with bounded range.
Definition: time.cc:533
ns3::Socket::Bind
virtual int Bind(const Address &address)=0
Allocate a local endpoint for this socket.
ns3::UdpClient::m_size
uint32_t m_size
Size of the sent packet (including the SeqTsHeader)
Definition: udp-client.h:88
ns3::Ipv4Address::IsMatchingType
static bool IsMatchingType(const Address &address)
Definition: ipv4-address.cc:350
ns3::EventId
An identifier for simulation events.
Definition: event-id.h:54
ns3::UdpClient::UdpClient
UdpClient()
Definition: udp-client.cc:76
ns3::Packet::GetSize
uint32_t GetSize(void) const
Returns the the size in bytes of the packet (including the zero-filled initial payload).
Definition: packet.h:852
ns3::Packet::AddHeader
void AddHeader(const Header &header)
Add header to this packet.
Definition: packet.cc:256
ns3::MakeAddressAccessor
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
ns3::Simulator::Now
static Time Now(void)
Return the current simulation virtual time.
Definition: simulator.cc:195
ns3
Every class exported by the ns3 library is enclosed in the ns3 namespace.
ns3::UdpClient
A Udp client.
Definition: udp-client.h:44
ns3::UdpClient::m_peerAddressString
std::string m_peerAddressString
Remote peer address string.
Definition: udp-client.h:97
ns3::SeqTsHeader::SetSeq
void SetSeq(uint32_t seq)
Definition: seq-ts-header.cc:41
ns3::UdpClient::StartApplication
virtual void StartApplication(void)
Application specific startup code.
Definition: udp-client.cc:113
ns3::AddressValue
AttributeValue implementation for Address.
Definition: address.h:278
ns3::Socket::Bind6
virtual int Bind6()=0
Allocate a local IPv6 endpoint for this socket.
ns3::Application::DoDispose
virtual void DoDispose(void)
Destructor implementation.
Definition: application.cc:83
ns3::Simulator::Schedule
static EventId Schedule(Time const &delay, FUNC f, Ts &&... args)
Schedule an event to expire after delay.
Definition: simulator.h:557
ns3::UdpClient::m_sendEvent
EventId m_sendEvent
Event to send the next packet.
Definition: udp-client.h:95
ns3::InetSocketAddress::ConvertFrom
static InetSocketAddress ConvertFrom(const Address &address)
Returns an InetSocketAddress which corresponds to the input Address.
Definition: inet-socket-address.cc:126
ns3::TypeId::SetParent
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Definition: type-id.cc:923
ns3::MakeNullCallback
Callback< R, Ts... > MakeNullCallback(void)
Definition: callback.h:1682
ns3::UdpClient::DoDispose
virtual void DoDispose(void)
Destructor implementation.
Definition: udp-client.cc:106
ns3::UdpClient::m_socket
Ptr< Socket > m_socket
Socket.
Definition: udp-client.h:92
ns3::Inet6SocketAddress::ConvertFrom
static Inet6SocketAddress ConvertFrom(const Address &addr)
Convert the address to a InetSocketAddress.
Definition: inet6-socket-address.cc:110
ns3::UdpClient::GetTotalTx
uint64_t GetTotalTx() const
Definition: udp-client.cc:229
ns3::Ptr< Socket >
NS_FATAL_ERROR
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
Definition: fatal-error.h:165
ns3::MakeAddressChecker
Ptr< const AttributeChecker > MakeAddressChecker(void)
Definition: address.cc:172
ns3::UdpClient::m_sent
uint32_t m_sent
Counter for sent packets.
Definition: udp-client.h:90
ns3::Socket::Send
virtual int Send(Ptr< Packet > p, uint32_t flags)=0
Send data (or dummy data) to the remote host.
ns3::UdpClient::Send
void Send(void)
Send a packet.
Definition: udp-client.cc:193
ns3::Socket::SetRecvCallback
void SetRecvCallback(Callback< void, Ptr< Socket > > receivedData)
Notify application when new data is available to be read.
Definition: socket.cc:128
ns3::Address
a polymophic address class
Definition: address.h:91
ns3::Simulator::Cancel
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:268
NS_LOG_INFO
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Definition: log.h:281
ns3::InetSocketAddress::GetIpv4
Ipv4Address GetIpv4(void) const
Definition: inet-socket-address.cc:71
ns3::Ipv6Address::ConvertFrom
static Ipv6Address ConvertFrom(const Address &address)
Convert the Address object into an Ipv6Address ones.
Definition: ipv6-address.cc:846
ns3::UdpClient::StopApplication
virtual void StopApplication(void)
Application specific shutdown code.
Definition: udp-client.cc:186
ns3::UdpClient::m_count
uint32_t m_count
Maximum number of packets the application will send.
Definition: udp-client.h:86
NS_ASSERT_MSG
#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:88
ns3::Inet6SocketAddress::GetIpv6
Ipv6Address GetIpv6(void) const
Get the IPv6 address.
Definition: inet6-socket-address.cc:77
ns3::UdpClient::m_totalTx
uint64_t m_totalTx
Total bytes sent.
Definition: udp-client.h:91
ns3::Socket::Connect
virtual int Connect(const Address &address)=0
Initiate a connection to a remote host.
ns3::UdpClient::GetTypeId
static TypeId GetTypeId(void)
Get the type ID.
Definition: udp-client.cc:43
ns3::Seconds
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1289
ns3::Inet6SocketAddress
An Inet6 address class.
Definition: inet6-socket-address.h:37
ns3::SeqTsHeader
Packet header to carry sequence number and timestamp.
Definition: seq-ts-header.h:45
ns3::Time::S
@ S
second
Definition: nstime.h:115
ns3::TimeValue
AttributeValue implementation for Time.
Definition: nstime.h:1353
NS_LOG_FUNCTION
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
Definition: log-macros-enabled.h:244
ns3::UdpClient::~UdpClient
virtual ~UdpClient()
Definition: udp-client.cc:85
ns3::UintegerValue
Hold an unsigned integer type.
Definition: uinteger.h:44
ns3::Application::GetNode
Ptr< Node > GetNode() const
Definition: application.cc:104
ns3::Socket::CreateSocket
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
seq-ts-header.h
ns3::MakeUintegerAccessor
Ptr< const AttributeAccessor > MakeUintegerAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method.
Definition: uinteger.h:45
ns3::Application
The base class for all ns3 applications.
Definition: application.h:61
ns3::TypeId::LookupByName
static TypeId LookupByName(std::string name)
Get a TypeId by name.
Definition: type-id.cc:830
ns3::UdpClient::m_interval
Time m_interval
Packet inter-send time.
Definition: udp-client.h:87
ns3::UdpClient::m_peerAddress
Address m_peerAddress
Remote peer address.
Definition: udp-client.h:93
ns3::Ipv4Address::ConvertFrom
static Ipv4Address ConvertFrom(const Address &address)
Definition: ipv4-address.cc:370
ns3::UdpClient::SetRemote
void SetRemote(Address ip, uint16_t port)
set the remote address and port
Definition: udp-client.cc:91
ns3::MakeTimeAccessor
Ptr< const AttributeAccessor > MakeTimeAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method.
Definition: nstime.h:1354
ns3::EventId::IsExpired
bool IsExpired(void) const
This method is syntactic sugar for the ns3::Simulator::IsExpired method.
Definition: event-id.cc:65
ns3::Packet::GetUid
uint64_t GetUid(void) const
Returns the packet's Uid.
Definition: packet.cc:390
port
uint16_t port
Definition: dsdv-manet.cc:45