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
|
/*
* Longclock operations
*
* Copyright (c) 2002 International Business Machines
* Author: Alan Robertson <alanr@unix.sh>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
*/
#ifndef _LONGCLOCK_H
# define _LONGCLOCK_H
/*
* A longclock_t object is a lot like a clock_t object, except that it
* won't wrap in the lifetime of the earth. It is guaranteed to be at
* least 64 bits. This means it should go for around 2 billion years.
*
* It is also supposed to be proof against changes in the local time on
* the computer. This is easy if you have a properly-working times(2)
* for us to use.
*
* longclock_t's are definitely not comparable between computers, and in
* some implementations, not even between processes on the same computer.
*
*
* The functions provided here are:
*
* unsigned long cl_times(void);
* A rational wrapper for the times(2) call
* for those cases where only the return value
* is wanted.
* longclock_t time_longclock(void);
* Returns current time as a longclock_t.
*
* longclock_t msto_longclock(unsigned long);
* Converts quantity in milliseconds to longclock_t
*
* unsigned long longclockto_ms(longclock_t);
* Converts quantity in longclock_t to milliseconds
* NOTE: Can overflow!
*
* unsigned long longclockto_long(longclock_t);
* Converts quantity in longclock_t to clock_t
* NOTE: Can overflow!
*
* longclock_t secsto_longclock(unsigned long);
* Converts quantity in seconds to longclock_t
*
* longclock_t add_longclock(longclock_t l, longclock_t r);
* Adds two longclock_t values
*
* int cmp_longclock(longclock_t l, longclock_t r);
* Returns negative, zero or positive value
*
* longclock_t sub_longclock(longclock_t l, longclock_t r);
* Subtracts two longclock_t values
* NOTE: Undefined if l is < r
*
* longclock_t dsecsto_longclock(double);
* Converts quantity in seconds (as a double)
* to a longclock_t
*
* unsigned hz_longclock(void);
* Returns frequency of longclock_t clock.
*
* We provide this constant:
*
* extern const longclock_t zero_longclock;
*/
extern unsigned long cl_times(void);
#ifdef CLOCK_T_IS_LONG_ENOUGH
# ifndef HAVE_LONGCLOCK_ARITHMETIC
# define HAVE_LONGCLOCK_ARITHMETIC
# endif
# include <sys/times.h>
typedef clock_t longclock_t;
#else /* clock_t isn't at least 64 bits */
typedef unsigned long long longclock_t;
#endif
longclock_t time_longclock(void);
extern const longclock_t zero_longclock;
unsigned hz_longclock(void);
longclock_t secsto_longclock(unsigned long);
longclock_t dsecsto_longclock(double);
longclock_t msto_longclock(unsigned long);
unsigned long longclockto_ms(longclock_t); /* Can overflow! */
long longclockto_long(longclock_t); /* May overflow! */
#ifndef HAVE_LONGCLOCK_ARITHMETIC
longclock_t add_longclock(longclock_t l, longclock_t r);
/* Undefined if l is < r according to cmp_longclock() */
longclock_t sub_longclock(longclock_t l, longclock_t r);
int cmp_longclock(longclock_t l, longclock_t r);
#else /* We HAVE_LONGCLOCK_ARITHMETIC */
# define longclockto_long(lc) ((long)(lc))
# define add_longclock(l,r) \
((longclock_t)(l) + (longclock_t)(r))
# define sub_longclock(l,r) \
((longclock_t)(l) - (longclock_t)(r))
# define cmp_longclock(l,r) \
(((longclock_t)(l) < (longclock_t)(r)) \
? -1 \
: (((longclock_t)(l) > (longclock_t)(r)) \
? +1 : 0))
#endif
/* N.B: Possibly not the best place for this, but it will do for now */
/* This is consistent with OpenBSD, and is a good choice anyway */
#define TIME_T unsigned long
#define TIME_F "%lu"
#define TIME_X "%lx"
#endif
|
