A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
bulk-send-application.cc
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2010 Georgia Institute of Technology
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: George F. Riley <riley@ece.gatech.edu>
19  */
20 
21 #include "ns3/log.h"
22 #include "ns3/address.h"
23 #include "ns3/node.h"
24 #include "ns3/nstime.h"
25 #include "ns3/socket.h"
26 #include "ns3/simulator.h"
27 #include "ns3/socket-factory.h"
28 #include "ns3/packet.h"
29 #include "ns3/uinteger.h"
30 #include "ns3/trace-source-accessor.h"
31 #include "ns3/tcp-socket-factory.h"
32 #include "bulk-send-application.h"
33 
34 NS_LOG_COMPONENT_DEFINE ("BulkSendApplication");
35 
36 namespace ns3 {
37 
38 NS_OBJECT_ENSURE_REGISTERED (BulkSendApplication);
39 
40 TypeId
42 {
43  static TypeId tid = TypeId ("ns3::BulkSendApplication")
45  .AddConstructor<BulkSendApplication> ()
46  .AddAttribute ("SendSize", "The amount of data to send each time.",
47  UintegerValue (512),
48  MakeUintegerAccessor (&BulkSendApplication::m_sendSize),
49  MakeUintegerChecker<uint32_t> (1))
50  .AddAttribute ("Remote", "The address of the destination",
51  AddressValue (),
52  MakeAddressAccessor (&BulkSendApplication::m_peer),
53  MakeAddressChecker ())
54  .AddAttribute ("MaxBytes",
55  "The total number of bytes to send. "
56  "Once these bytes are sent, "
57  "no data is sent again. The value zero means "
58  "that there is no limit.",
59  UintegerValue (0),
60  MakeUintegerAccessor (&BulkSendApplication::m_maxBytes),
61  MakeUintegerChecker<uint32_t> ())
62  .AddAttribute ("Protocol", "The type of protocol to use.",
64  MakeTypeIdAccessor (&BulkSendApplication::m_tid),
65  MakeTypeIdChecker ())
66  .AddTraceSource ("Tx", "A new packet is created and is sent",
68  ;
69  return tid;
70 }
71 
72 
74  : m_socket (0),
75  m_connected (false),
76  m_totBytes (0)
77 {
78  NS_LOG_FUNCTION (this);
79 }
80 
82 {
83  NS_LOG_FUNCTION (this);
84 }
85 
86 void
88 {
89  NS_LOG_FUNCTION (this << maxBytes);
90  m_maxBytes = maxBytes;
91 }
92 
95 {
96  NS_LOG_FUNCTION (this);
97  return m_socket;
98 }
99 
100 void
102 {
103  NS_LOG_FUNCTION (this);
104 
105  m_socket = 0;
106  // chain up
108 }
109 
110 // Application Methods
111 void BulkSendApplication::StartApplication (void) // Called at time specified by Start
112 {
113  NS_LOG_FUNCTION (this);
114 
115  // Create the socket if not already
116  if (!m_socket)
117  {
119 
120  // Fatal error if socket type is not NS3_SOCK_STREAM or NS3_SOCK_SEQPACKET
123  {
124  NS_FATAL_ERROR ("Using BulkSend with an incompatible socket type. "
125  "BulkSend requires SOCK_STREAM or SOCK_SEQPACKET. "
126  "In other words, use TCP instead of UDP.");
127  }
128 
130  {
131  m_socket->Bind6 ();
132  }
134  {
135  m_socket->Bind ();
136  }
137 
145  }
146  if (m_connected)
147  {
148  SendData ();
149  }
150 }
151 
152 void BulkSendApplication::StopApplication (void) // Called at time specified by Stop
153 {
154  NS_LOG_FUNCTION (this);
155 
156  if (m_socket != 0)
157  {
158  m_socket->Close ();
159  m_connected = false;
160  }
161  else
162  {
163  NS_LOG_WARN ("BulkSendApplication found null socket to close in StopApplication");
164  }
165 }
166 
167 
168 // Private helpers
169 
171 {
172  NS_LOG_FUNCTION (this);
173 
174  while (m_maxBytes == 0 || m_totBytes < m_maxBytes)
175  { // Time to send more
176  uint32_t toSend = m_sendSize;
177  // Make sure we don't send too many
178  if (m_maxBytes > 0)
179  {
180  toSend = std::min (m_sendSize, m_maxBytes - m_totBytes);
181  }
182  NS_LOG_LOGIC ("sending packet at " << Simulator::Now ());
183  Ptr<Packet> packet = Create<Packet> (toSend);
184  m_txTrace (packet);
185  int actual = m_socket->Send (packet);
186  if (actual > 0)
187  {
188  m_totBytes += actual;
189  }
190  // We exit this loop when actual < toSend as the send side
191  // buffer is full. The "DataSent" callback will pop when
192  // some buffer space has freed ip.
193  if ((unsigned)actual != toSend)
194  {
195  break;
196  }
197  }
198  // Check if time to close (all sent)
200  {
201  m_socket->Close ();
202  m_connected = false;
203  }
204 }
205 
207 {
208  NS_LOG_FUNCTION (this << socket);
209  NS_LOG_LOGIC ("BulkSendApplication Connection succeeded");
210  m_connected = true;
211  SendData ();
212 }
213 
215 {
216  NS_LOG_FUNCTION (this << socket);
217  NS_LOG_LOGIC ("BulkSendApplication, Connection Failed");
218 }
219 
221 {
222  NS_LOG_FUNCTION (this);
223 
224  if (m_connected)
225  { // Only send new data if the connection has completed
227  }
228 }
229 
230 
231 
232 } // Namespace ns3
void SendData()
Send data until the L4 transmission buffer is full.
uint32_t m_totBytes
Total bytes sent so far.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register the class in the ns-3 factory.
Definition: object-base.h:38
virtual int Bind6()=0
Allocate a local IPv6 endpoint for this socket.
void ConnectionFailed(Ptr< Socket > socket)
Connection Failed (called by Socket through a callback)
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:170
virtual int ShutdownRecv(void)=0
uint32_t m_maxBytes
Limit total number of bytes sent.
#define NS_FATAL_ERROR(msg)
fatal error handling
Definition: fatal-error.h:95
virtual void DoDispose(void)
This method is called by Object::Dispose or by the object's destructor, whichever comes first...
virtual void StopApplication(void)
Application specific shutdown code.
The base class for all ns3 applications.
Definition: application.h:60
virtual void StartApplication(void)
Application specific startup code.
Hold an unsigned integer type.
Definition: uinteger.h:46
Ptr< Node > GetNode() const
Definition: application.cc:103
hold objects of type ns3::TypeId
Callback< R > MakeCallback(R(T::*memPtr)(void), OBJ objPtr)
Definition: callback.h:1242
void SetMaxBytes(uint32_t maxBytes)
Set the upper bound for the total number of bytes to send.
void DataSend(Ptr< Socket >, uint32_t)
Send more data as soon as some has been transmitted.
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:70
virtual enum Socket::SocketType GetSocketType(void) const =0
#define NS_LOG_LOGIC(msg)
Use NS_LOG to output a message of level LOG_LOGIC.
Definition: log.h:233
TypeId m_tid
The type of protocol to use.
static TypeId GetTypeId(void)
Get the type ID.
virtual int Connect(const Address &address)=0
Initiate a connection to a remote host.
virtual void DoDispose(void)
This method is called by Object::Dispose or by the object's destructor, whichever comes first...
Definition: application.cc:82
virtual int Bind(const Address &address)=0
Allocate a local endpoint for this socket.
Ptr< const TraceSourceAccessor > MakeTraceSourceAccessor(T a)
static EventId ScheduleNow(MEM mem_ptr, OBJ obj)
Schedule an event to expire Now.
Definition: simulator.h:986
static Time Now(void)
Return the "current simulation time".
Definition: simulator.cc:180
void SetSendCallback(Callback< void, Ptr< Socket >, uint32_t > sendCb)
Notify application when space in transmit buffer is added.
Definition: socket.cc:120
Ptr< Socket > m_socket
Associated socket.
void ConnectionSucceeded(Ptr< Socket > socket)
Connection Succeeded (called by Socket through a callback)
hold objects of type ns3::Address
#define NS_LOG_WARN(msg)
Use NS_LOG to output a message of level LOG_WARN.
Definition: log.h:203
bool m_connected
True if connected.
Address m_peer
Peer address.
static bool IsMatchingType(const Address &addr)
If the address match.
static TypeId GetTypeId(void)
Get the type ID.
void SetConnectCallback(Callback< void, Ptr< Socket > > connectionSucceeded, Callback< void, Ptr< Socket > > connectionFailed)
Specify callbacks to allow the caller to determine if the connection succeeds of fails.
Definition: socket.cc:83
uint32_t m_sendSize
Size of data to send each time.
virtual int Send(Ptr< Packet > p, uint32_t flags)=0
Send data (or dummy data) to the remote host.
virtual int Close(void)=0
Close a socket.
Ptr< Socket > GetSocket(void) const
Get the socket this application is attached to.
TracedCallback< Ptr< const Packet > > m_txTrace
Traced Callback: sent packets.
a unique identifier for an interface.
Definition: type-id.h:49
TypeId SetParent(TypeId tid)
Definition: type-id.cc:610
static bool IsMatchingType(const Address &address)