A Discrete-Event Network Simulator
API
onoff-application.h
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 //
3 // Copyright (c) 2006 Georgia Tech Research Corporation
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 // ns3 - On/Off Data Source Application class
22 // George F. Riley, Georgia Tech, Spring 2007
23 // Adapted from ApplicationOnOff in GTNetS.
24 
25 #ifndef ONOFF_APPLICATION_H
26 #define ONOFF_APPLICATION_H
27 
28 #include "ns3/address.h"
29 #include "ns3/application.h"
30 #include "ns3/event-id.h"
31 #include "ns3/ptr.h"
32 #include "ns3/data-rate.h"
33 #include "ns3/traced-callback.h"
34 
35 namespace ns3 {
36 
37 class Address;
38 class RandomVariableStream;
39 class Socket;
40 
87 {
88 public:
93  static TypeId GetTypeId (void);
94 
96 
97  virtual ~OnOffApplication();
98 
107  void SetMaxBytes (uint64_t maxBytes);
108 
113  Ptr<Socket> GetSocket (void) const;
114 
122  int64_t AssignStreams (int64_t stream);
123 
124 protected:
125  virtual void DoDispose (void);
126 private:
127  // inherited from Application base class.
128  virtual void StartApplication (void); // Called at time specified by Start
129  virtual void StopApplication (void); // Called at time specified by Stop
130 
131  //helpers
135  void CancelEvents ();
136 
137  // Event handlers
141  void StartSending ();
145  void StopSending ();
149  void SendPacket ();
150 
153  bool m_connected;
158  uint32_t m_pktSize;
159  uint32_t m_residualBits;
161  uint64_t m_maxBytes;
162  uint64_t m_totBytes;
166 
169 
172 
173 private:
177  void ScheduleNextTx ();
181  void ScheduleStartEvent ();
185  void ScheduleStopEvent ();
190  void ConnectionSucceeded (Ptr<Socket> socket);
195  void ConnectionFailed (Ptr<Socket> socket);
196 };
197 
198 } // namespace ns3
199 
200 #endif /* ONOFF_APPLICATION_H */
void StopSending()
Start an Off period.
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:102
virtual void StartApplication(void)
Application specific startup code.
EventId m_sendEvent
Event id of pending "send packet" event.
Ptr< Socket > GetSocket(void) const
Return a pointer to associated socket.
uint32_t m_pktSize
Size of packets.
Forward calls to a chain of Callback.
void ScheduleStartEvent()
Schedule the next On period start.
void CancelEvents()
Cancel all pending events.
Generate traffic to a single destination according to an OnOff pattern.
void ScheduleStopEvent()
Schedule the next Off period start.
a polymophic address class
Definition: address.h:90
TracedCallback< Ptr< const Packet >, const Address &, const Address & > m_txTraceWithAddresses
Callbacks for tracing the packet Tx events, includes source and destination addresses.
DataRate m_cbrRateFailSafe
Rate that data is generated (check copy)
Class for representing data rates.
Definition: data-rate.h:88
virtual void DoDispose(void)
Destructor implementation.
EventId m_startStopEvent
Event id for next start or stop event.
void SendPacket()
Send a packet.
TypeId m_tid
Type of the socket used.
The base class for all ns3 applications.
Definition: application.h:60
Address m_peer
Peer address.
DataRate m_cbrRate
Rate that data is generated.
Ptr< RandomVariableStream > m_onTime
rng for On Time
uint64_t m_totBytes
Total bytes sent so far.
Ptr< Socket > m_socket
Associated socket.
int64_t AssignStreams(int64_t stream)
Assign a fixed random variable stream number to the random variables used by this model...
Ptr< RandomVariableStream > m_offTime
rng for Off Time
void SetMaxBytes(uint64_t maxBytes)
Set the total number of bytes to send.
TracedCallback< Ptr< const Packet > > m_txTrace
Traced Callback: transmitted packets.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
void ScheduleNextTx()
Schedule the next packet transmission.
void StartSending()
Start an On period.
void ConnectionSucceeded(Ptr< Socket > socket)
Handle a Connection Succeed event.
Time m_lastStartTime
Time last packet sent.
static TypeId GetTypeId(void)
Get the type ID.
An identifier for simulation events.
Definition: event-id.h:53
void ConnectionFailed(Ptr< Socket > socket)
Handle a Connection Failed event.
bool m_connected
True if connected.
virtual void StopApplication(void)
Application specific shutdown code.
a unique identifier for an interface.
Definition: type-id.h:58
uint32_t m_residualBits
Number of generated, but not sent, bits.
uint64_t m_maxBytes
Limit total number of bytes sent.