A Discrete-Event Network Simulator
API
wall-clock-synchronizer.h
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2008 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 
19 #ifndef WALL_CLOCK_CLOCK_SYNCHRONIZER_H
20 #define WALL_CLOCK_CLOCK_SYNCHRONIZER_H
21 
22 #include "system-condition.h"
23 #include "synchronizer.h"
24 
31 namespace ns3 {
32 
68 {
69 public:
74  static TypeId GetTypeId (void);
75 
79  virtual ~WallClockSynchronizer ();
80 
82  static const uint64_t US_PER_NS = (uint64_t)1000;
84  static const uint64_t US_PER_SEC = (uint64_t)1000000;
86  static const uint64_t NS_PER_SEC = (uint64_t)1000000000;
87 
88 protected:
101  bool SpinWait (uint64_t ns);
125  bool SleepWait (uint64_t ns);
126 
127  // Inherited from Synchronizer
128  virtual void DoSetOrigin (uint64_t ns);
129  virtual bool DoRealtime (void);
130  virtual uint64_t DoGetCurrentRealtime (void);
131  virtual bool DoSynchronize (uint64_t nsCurrent, uint64_t nsDelay);
132  virtual void DoSignal (void);
133  virtual void DoSetCondition (bool cond);
134  virtual int64_t DoGetDrift (uint64_t ns);
135  virtual void DoEventStart (void);
136  virtual uint64_t DoEventEnd (void);
137 
147  uint64_t DriftCorrect (uint64_t nsNow, uint64_t nsDelay);
148 
154  uint64_t GetRealtime (void);
160  uint64_t GetNormalizedRealtime (void);
161 
168  void NsToTimeval (int64_t ns, struct timeval *tv);
175  uint64_t TimevalToNs (struct timeval *tv);
176 
184  void TimevalAdd (
185  struct timeval *tv1,
186  struct timeval *tv2,
187  struct timeval *result);
188 
190  uint64_t m_jiffy;
192  uint64_t m_nsEventStart;
193 
196 };
197 
198 } // namespace ns3
199 
200 #endif /* WALL_CLOCK_SYNCHRONIZER_H */
uint64_t m_jiffy
Size of the system clock tick, as reported by clock_getres, in ns.
System-independent thread conditional wait.
uint64_t TimevalToNs(struct timeval *tv)
Convert a timeval to absolute time, in ns.
A class which provides a relatively platform-independent conditional-wait thread synchronization prim...
static const uint64_t NS_PER_SEC
Conversion constant between ns and s.
uint64_t m_nsEventStart
Time recorded by DoEventStart.
bool SleepWait(uint64_t ns)
Put our process to sleep for some number of nanoseconds.
static const uint64_t US_PER_NS
Conversion constant between μs and ns.
uint64_t GetRealtime(void)
Get the current absolute real time (in ns since the epoch).
virtual int64_t DoGetDrift(uint64_t ns)
Get the drift between the real time clock used to synchronize the simulation and the current simulati...
virtual bool DoRealtime(void)
Return true if this synchronizer is actually synchronizing to a realtime clock.
virtual uint64_t DoGetCurrentRealtime(void)
Retrieve the value of the origin of the underlying normalized wall clock time in Time resolution unit...
virtual bool DoSynchronize(uint64_t nsCurrent, uint64_t nsDelay)
Wait until the real time is in sync with the specified simulation time.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
virtual ~WallClockSynchronizer()
Destructor.
Base class used for synchronizing the simulation events to some real time "wall clock.".
Definition: synchronizer.h:51
virtual void DoSetOrigin(uint64_t ns)
Establish a correspondence between a simulation time and a wall-clock (real) time.
static const uint64_t US_PER_SEC
Conversion constant between μs and seconds.
ns3::Synchronizer declaration.
virtual void DoEventStart(void)
Record the normalized real time at which the current event is starting execution. ...
virtual void DoSetCondition(bool cond)
Set the condition variable to tell a possible simulator thread waiting in the Synchronize method that...
void NsToTimeval(int64_t ns, struct timeval *tv)
Convert an absolute time in ns to a timeval.
static TypeId GetTypeId(void)
Get the registered TypeId for this class.
void TimevalAdd(struct timeval *tv1, struct timeval *tv2, struct timeval *result)
Add two timeval.
SystemCondition m_condition
Thread synchronizer.
Class used for synchronizing the simulation events to a real-time "wall clock" using Posix clock func...
a unique identifier for an interface.
Definition: type-id.h:57
uint64_t GetNormalizedRealtime(void)
Get the current normalized real time, in ns.
bool SpinWait(uint64_t ns)
Do a busy-wait until the normalized realtime equals the argument or the condition variable becomes tr...
virtual void DoSignal(void)
Tell a possible simulator thread waiting in the DoSynchronize method that an event has happened which...
virtual uint64_t DoEventEnd(void)
Return the amount of real time elapsed since the last call to EventStart.
uint64_t DriftCorrect(uint64_t nsNow, uint64_t nsDelay)
Compute a correction to the nominal delay to account for realtime drift since the last DoSynchronize...