mir/bind
2
0
Fork 0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-08-31 14:35:26 +00:00
Code Issues Releases Wiki Activity

opaque isc_time_t; add isc_interval_t; UNIX-specific conversions

Browse Source
This commit is contained in:
Bob Halley
1998-10-23 23:01:41 +00:00
parent 49bcef9c9c
commit 4bed2e84a3
2 changed files with 282 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files

146
lib/isc/unix/include/isc/time.h
View File

@@ -4,21 +4,93 @@
#include <time.h>
#include <isc/result.h>
#include <isc/boolean.h>
/*
* This structure can be used both to represent absolute times, and to
* to represent intervals.
/***
*** Intervals
***/
/*
* The contents of this structure are private, and MUST NOT be accessed
* directly by callers.
*
* The contents are exposed only so that callers may avoid dynamic allocation
* and instead just declare a 'struct isc_interval'.
*/
typedef struct isc_interval {
unsigned int seconds;
unsigned int nanoseconds;
} *isc_interval_t;
void
isc_interval_set(isc_interval_t i,
unsigned int seconds, unsigned int nanoseconds);
/*
* Set 'i' to a value representing an interval of 'seconds' seconds and
* 'nanoseconds' nanoseconds, suitable for use in isc_time_add() and
* isc_time_subtract().
*
* Requires:
*
* 't' is a valid.
*
* nanoseconds < 1000000000
*/
isc_boolean_t
isc_interval_iszero(isc_interval_t i);
/*
* Returns ISC_TRUE iff. 'i' is the zero interval.
*
* Requires:
*
* 't' is a valid.
*
*/
/***
*** Absolute Times
***/
/*
* The contents of this structure are private, and MUST NOT be accessed
* directly by callers.
*
* The contents are exposed only so that callers may avoid dynamic allocation
* and instead just declare a 'struct isc_time'.
*/
typedef struct isc_time {
time_t seconds;
long nanoseconds;
time_t seconds;
unsigned int nanoseconds;
} *isc_time_t;
void
isc_time_settoepoch(isc_time_t t);
/*
* Set 't' to the time of the epoch.
*
* Requires:
*
* 't' is a valid.
*
*/
isc_boolean_t
isc_time_isepoch(isc_time_t t);
/*
* Returns ISC_TRUE iff. 't' is the epoch ("time zero").
*
* Requires:
*
* 't' is a valid.
*
*/
isc_result_t
isc_time_get(isc_time_t t);
/*
* Set 't' to the current absolute time (secs + nsec since January 1, 1970).
* Set 't' to the current absolute time.
*
* Requires:
*
@@ -47,25 +119,73 @@ isc_time_compare(isc_time_t t1, isc_time_t t2);
*/
void
isc_time_add(isc_time_t t1, isc_time_t t2, isc_time_t t3);
isc_time_add(isc_time_t t, isc_interval_t i, isc_time_t result);
/*
* Add 't1' to 't2', storing the result in 't3'.
* Add 'i' to 't', storing the result in 'result'.
*
* Requires:
*
* 't1', 't2', and 't3' are valid.
* 't', 'i', and 'result' are valid.
*/
void
isc_time_subtract(isc_time_t t1, isc_time_t t2, isc_time_t t3);
isc_time_subtract(isc_time_t t, isc_interval_t t2, isc_time_t result);
/*
* Subtract 't2' from 't1', storing the result in 't3'.
* Subtract 'i' from 't', storing the result in 'result'.
*
* Requires:
*
* 't1', 't2', and 't3' are valid.
* 't', 'i', and 'result' are valid.
*
* t >= epoch + i (comparing times, not pointers)
*/
/***
*** UNIX-only
***/
void
isc_time_fromtimeval(isc_time_t t, struct timeval *tv);
/*
* Set 't' to the time given by 'ts'.
*
* Requires:
*
* 't' and 'tv' are a valid.
*
*/
void
isc_time_totimeval(isc_time_t t, struct timeval *tv);
/*
* Convert 't' to a UNIX timeval.
*
* Requires:
*
* 't' and 'tv' are a valid.
*
*/
void
isc_time_fromtimespec(isc_time_t t, struct timespec *ts);
/*
* Set 't' to the time given by 'ts'.
*
* Requires:
*
* 't' and 'ts' are a valid.
*
*/
void
isc_time_totimespec(isc_time_t t, struct timespec *ts);
/*
* Convert 't' to a UNIX timespec.
*
* Requires:
*
* 't' and 'ts' are a valid.
*
* t1 >= t2 (comparing times, not pointers)
*/
#endif /* ISC_TIME_H */