/usr/include/rutil/Time.hxx is in libresiprocate-1.11-dev 1:1.11.0~beta5-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 | #if !defined(RESIP_TIME_HXX)
#define RESIP_TIME_HXX
#include "rutil/Mutex.hxx"
#include <limits.h>
#include "rutil/ResipAssert.h"
namespace resip
{
void sleepMs(unsigned int ms);
void sleepSeconds(unsigned int seconds);
/** Clock used for timing in the Timer class and possibly other areas. Depending on the OS and compile settings this clock
may not be monotonic. Define _RESIP_MONOTONIC_CLOCK to enable monotonic timers.
The precision of this clock is available in microseconds, but the accuracy depends on other factors such as the OS and hardware.
The time values returned by this class should be considered independent of any other clock time,
including the system time (ie OS date/time,uptime,epoch,etc).
OS Specific notes:
<b>Windows</b>
When _RESIP_MONOTONIC_CLOCK is defined, timeGetTime() is currently used as the underyling time source.
The default resolution/accuracy of this timer on windows is usually the same as the system time clock.
To query resolution information use ResipClock::queryTimerInfo(). timeBeginPeriod() can be used to increase
the resolution of the timer and allow for up to 1ms accuracy. This will improve the accuracy of SIP related
timers governed by resip::Timer, but also has other OS wide implications, please refer to Microsoft's
documenation on timeBeginPeriod() for more information.
When _RESIP_MONOTONIC_CLOCK is not defined, ::GetSystemTime is used as the underlying time source. This
value can jump forward or backward (not monotonic) if the OS system time is adjusted. The default
resolution of this timer is the current system clock interrupt time and cannot be set to a higher resolution.
The resolution has been observed at approx 15ms on XP and 1ms on Vista.
<b>POSIX</b>
When _RESIP_MONOTONIC_CLOCK is defined, clock_gettime() is used with the CLOCK_MONOTONIC clock.
When _RESIP_MONOTONIC_CLOCK is not defined, gettimeofday() is used as the underyling clock.
<b>OS X</b>
A monotonic clock is currently not implemented for OS X. There appear to be a couple of choices.
http://www.wand.net.nz/~smr26/wordpress/2009/01/19/monotonic-time-in-mac-os-x/
http://www.meandmark.com/timing.pdf
http://developer.apple.com/qa/qa2004/qa1398.html
@see resiprocate.org devlist discussion "Timers: why system time?";
*/
class ResipClock
{
public:
ResipClock(void);
~ResipClock(void);
/** Returns the current clock time in microseconds.
*/
static UInt64 getTimeMicroSec()
{
return getSystemTime();
}
/** Returns the current clock time in milliseconds.
*/
static UInt64 getTimeMs()
{
return getSystemTime()/1000LL;
}
/** Returns the current clock time in seconds.
*/
static UInt64 getTimeSecs()
{
return getSystemTime()/1000000LL;
}
/** Returns an absolute time in ms that is between 50% and 90% of
passed in ms from now.
*/
static UInt64 getRandomFutureTimeMs( UInt64 futureMs );
/** Infinit time in future.
*/
static UInt64 getForever();
/** Some monotonic clock implementations may internally only return 32-bit values that will wrap.
* @see Timer::getMaxSystemTimeWaitMs()
*/
static unsigned getMaxSystemTimeWaitMs(void)
{
return mMaxSystemTimeWaitMs;
}
/** Gets the current clock's minimum, maximum and current/actual timer resolution and returns if the
clock is known to be monotonic.
If min, max or actual return 0 then that information is not available.
min max and actual are in units of microseconds.
*/
static void queryTimerInfo(unsigned &minRes, unsigned &maxRes, unsigned &actualRes, bool &isMonotonic);
private:
/** Returns the current clock time in microseconds. Does not guarantee that this is related to the actual
* OS system time (eg epoch or other time).
*/
static UInt64 getSystemTime();
static unsigned mMaxSystemTimeWaitMs;
#ifdef WIN32
private:
/** Responsible for returning a 64-bit monotonic clock value for timing. Currently implemented using
* timeGetTime. Precision of this class is milliseconds,
* accuracy is dependent on the windows timer resolution. Use timeBeginPeriod() to increase the resolution.
*/
class WinMonoClock
{
public:
WinMonoClock();
/** Returns a monotonic clock value in milliseconds. Currently this is the system uptime as reported
* by timeGetTime.
*/
static UInt64 GetClock64(void)
{
return mGTC64();
}
private:
static void Initialize(void);
/** Definition of a function that has no parameters and returns a 64-bit unsigned integer.
*/
typedef UInt64 (*PGTC64)(void);
/** Get Tick Count wrapper for 32-bit version of ::timeGetTime that is nearly lockless and handles 32-bit wraparound.
* _InterlockedExchange64 is used, which requires the CMPXCHG8B instruction. This instruction is found
* on pentium and later intel processors and K5 and later AMD processors.
*/
class GTCInterlocked
{
public:
static UInt64 GTC64(void);
/** The maximum time that can elapse when using this class as the timer for resip stack processing.
@see resip::SipStack::getTimeTillNextProcessMS().
*/
static UInt32 GetMaxWaitMs(void)
{
//Since the base time isn't updated on every call, need to ensure that it's updated once every 49.7 days.
//The base time will lag behind the current tick count, which means the lag time must be used
//to determine the max wait.
//Also need to add a cushion to this calculaton because ::timeGetTime may not be accurate to 1ms.
__int64 maxWait = (__int64)UINT_MAX - mBaseTimeUpdateInterval - mBaseTimeCushion;
if (maxWait <= 0)
{
resip_assert(0);
const_cast<UInt32 &>(mBaseTimeUpdateInterval) = 60000;
const_cast<UInt32 &>(mBaseTimeCushion) = 120000;
return UINT_MAX - mBaseTimeUpdateInterval - mBaseTimeCushion;
}
return static_cast<UInt32>(maxWait);
}
private:
/** Last stored time. Using InterlockedExchange (CMPXCHG8B) the alignment is not necessary, but it shouldn't hurt.
Align it on a cache line since it is rarely written and read often (to avoid false-sharing).
*/
static _declspec(align(128)) volatile UInt64 mBaseTime;
/** Max elapsed time since last GTC64 call, in milliseconds, before writing mBaseTime.
Cannot exceed UINT_MAX - mBaseTimeCushion.
*/
static const UInt32 mBaseTimeUpdateInterval = 60000;
static const UInt32 mBaseTimeCushion = 120000; //!< large cushion to be cautious
};
/** Get Tick Count wrapper for 32-bit version of ::timeGetTime that minimizes locking and handles 32-bit wraparound.
* Issues a mutex lock only during a 2 minute window around the 49.7 day threshold. The lock is issued for each call to
* GTC64 during this window and durinng this window only.
* Requires SipStack::getTimeTillNextProcessMS() to not return a value greater than 2 minutes.
*/
class GTCLockDuringRange
{
public:
static UInt64 GTC64(void);
static UInt32 GetMaxWaitMs(void)
{
return 120000;
}
private:
/** timeGetTime() returns DWORD - ms since system start
Therefore, the time will wrap around to zero if the system is run continuously for 49.7 days
if timer is called reasonable often we may manage wrap around by counter below
*/
static UInt32 mWrapCounter;
/** Last obtained tick to detect the need to increment mWrapCounter
*/
static DWORD mPrevTick;
/** we have to made it thread safe
*/
static Mutex mWrapCounterMutex;
};
/** Get Tick Count wrapper for 32-bit version of ::timeGetTime that locks on a mutex on every call to GTC64()
to safely handle 32-bit wraparound.
*/
class GTCLock
{
public:
static UInt64 GTC64(void);
private:
static ULARGE_INTEGER mBaseTime;
/** Primary lock that is executed on each call to GTC64().
*/
static Mutex mMutex;
};
static PGTC64 mGTC64;
};
#endif
};
}//namespace resip
#endif
/* ====================================================================
* The Vovida Software License, Version 1.0
*
* Copyright (c) 2000 Vovida Networks, Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The names "VOCAL", "Vovida Open Communication Application Library",
* and "Vovida Open Communication Application Library (VOCAL)" must
* not be used to endorse or promote products derived from this
* software without prior written permission. For written
* permission, please contact vocal@vovida.org.
*
* 4. Products derived from this software may not be called "VOCAL", nor
* may "VOCAL" appear in their name, without prior written
* permission of Vovida Networks, Inc.
*
* THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
* NON-INFRINGEMENT ARE DISCLAIMED. IN NO EVENT SHALL VOVIDA
* NETWORKS, INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT DAMAGES
* IN EXCESS OF $1,000, NOR FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
* OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
* USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*
* ====================================================================
*
* This software consists of voluntary contributions made by Vovida
* Networks, Inc. and many individuals on behalf of Vovida Networks,
* Inc. For more information on Vovida Networks, Inc., please see
* <http://www.vovida.org/>.
*
* vi: set shiftwidth=3 expandtab:
*/
|