Gecko [ www.hotel.chaabi.me ]

Name	Size	Permission	Date
aes.h	1.05 KB	-rw-r--r--	2026-08-13 18:53
app.h	10.23 KB	-rw-r--r--	2026-08-13 18:53
assertions.h	2.84 KB	-rw-r--r--	2026-08-13 18:53
atomic.h	4.07 KB	-rw-r--r--	2026-08-13 18:53
backtrace.h	3.8 KB	-rw-r--r--	2026-08-13 18:53
base32.h	4.35 KB	-rw-r--r--	2026-08-13 18:53
base64.h	2.8 KB	-rw-r--r--	2026-08-13 18:53
bind9.h	830 B	-rw-r--r--	2026-08-13 18:53
boolean.h	594 B	-rw-r--r--	2026-08-13 18:53
buffer.h	25.65 KB	-rw-r--r--	2026-08-13 18:53
bufferlist.h	1.42 KB	-rw-r--r--	2026-08-13 18:53
cmocka.h	1.35 KB	-rw-r--r--	2026-08-13 18:53
commandline.h	1.67 KB	-rw-r--r--	2026-08-13 18:53
condition.h	1.57 KB	-rw-r--r--	2026-08-13 18:53
counter.h	1.88 KB	-rw-r--r--	2026-08-13 18:53
crc64.h	998 B	-rw-r--r--	2026-08-13 18:53
deprecated.h	623 B	-rw-r--r--	2026-08-13 18:53
dir.h	1.56 KB	-rw-r--r--	2026-08-13 18:53
endian.h	4.67 KB	-rw-r--r--	2026-08-13 18:53
entropy.h	10.13 KB	-rw-r--r--	2026-08-13 18:53
errno.h	659 B	-rw-r--r--	2026-08-13 18:53
error.h	1.4 KB	-rw-r--r--	2026-08-13 18:53
event.h	2.98 KB	-rw-r--r--	2026-08-13 18:53
eventclass.h	1.35 KB	-rw-r--r--	2026-08-13 18:53
file.h	11.39 KB	-rw-r--r--	2026-08-13 18:53
formatcheck.h	893 B	-rw-r--r--	2026-08-13 18:53
fsaccess.h	7.27 KB	-rw-r--r--	2026-08-13 18:53
hash.h	7.48 KB	-rw-r--r--	2026-08-13 18:53
heap.h	5.14 KB	-rw-r--r--	2026-08-13 18:53
hex.h	2.74 KB	-rw-r--r--	2026-08-13 18:53
hmacmd5.h	1.75 KB	-rw-r--r--	2026-08-13 18:53
hmacsha.h	4.41 KB	-rw-r--r--	2026-08-13 18:53
ht.h	4.29 KB	-rw-r--r--	2026-08-13 18:53
httpd.h	2.26 KB	-rw-r--r--	2026-08-13 18:53
int.h	1.06 KB	-rw-r--r--	2026-08-13 18:53
interfaceiter.h	3.05 KB	-rw-r--r--	2026-08-13 18:53
iterated_hash.h	1.02 KB	-rw-r--r--	2026-08-13 18:53
json.h	1.42 KB	-rw-r--r--	2026-08-13 18:53
keyboard.h	989 B	-rw-r--r--	2026-08-13 18:53
lang.h	637 B	-rw-r--r--	2026-08-13 18:53
lex.h	9.54 KB	-rw-r--r--	2026-08-13 18:53
lfsr.h	2.89 KB	-rw-r--r--	2026-08-13 18:53
lib.h	1.04 KB	-rw-r--r--	2026-08-13 18:53
likely.h	818 B	-rw-r--r--	2026-08-13 18:53
list.h	5.62 KB	-rw-r--r--	2026-08-13 18:53
log.h	28.06 KB	-rw-r--r--	2026-08-13 18:53
magic.h	994 B	-rw-r--r--	2026-08-13 18:53
md5.h	2.32 KB	-rw-r--r--	2026-08-13 18:53
mem.h	20.62 KB	-rw-r--r--	2026-08-13 18:53
meminfo.h	710 B	-rw-r--r--	2026-08-13 18:53
msgcat.h	2.66 KB	-rw-r--r--	2026-08-13 18:53
msgs.h	8.22 KB	-rw-r--r--	2026-08-13 18:53
mutex.h	972 B	-rw-r--r--	2026-08-13 18:53
mutexblock.h	1.34 KB	-rw-r--r--	2026-08-13 18:53
net.h	10.29 KB	-rw-r--r--	2026-08-13 18:53
netaddr.h	4.48 KB	-rw-r--r--	2026-08-13 18:53
netdb.h	863 B	-rw-r--r--	2026-08-13 18:53
netscope.h	967 B	-rw-r--r--	2026-08-13 18:53
offset.h	700 B	-rw-r--r--	2026-08-13 18:53
once.h	651 B	-rw-r--r--	2026-08-13 18:53
ondestroy.h	2.73 KB	-rw-r--r--	2026-08-13 18:53
os.h	671 B	-rw-r--r--	2026-08-13 18:53
parseint.h	1.51 KB	-rw-r--r--	2026-08-13 18:53
platform.h	9.44 KB	-rw-r--r--	2026-08-13 18:53
pool.h	3.42 KB	-rw-r--r--	2026-08-13 18:53
portset.h	3.22 KB	-rw-r--r--	2026-08-13 18:53
print.h	2.42 KB	-rw-r--r--	2026-08-13 18:53
queue.h	5.08 KB	-rw-r--r--	2026-08-13 18:53
quota.h	2.38 KB	-rw-r--r--	2026-08-13 18:53
radix.h	6.34 KB	-rw-r--r--	2026-08-13 18:53
random.h	3.5 KB	-rw-r--r--	2026-08-13 18:53
ratelimiter.h	3.42 KB	-rw-r--r--	2026-08-13 18:53
refcount.h	8 KB	-rw-r--r--	2026-08-13 18:53
regex.h	767 B	-rw-r--r--	2026-08-13 18:53
region.h	1.99 KB	-rw-r--r--	2026-08-13 18:53
resource.h	2.79 KB	-rw-r--r--	2026-08-13 18:53
result.h	4.87 KB	-rw-r--r--	2026-08-13 18:53
resultclass.h	1.56 KB	-rw-r--r--	2026-08-13 18:53
rwlock.h	3.72 KB	-rw-r--r--	2026-08-13 18:53
safe.h	1.32 KB	-rw-r--r--	2026-08-13 18:53
serial.h	1.34 KB	-rw-r--r--	2026-08-13 18:53
sha1.h	1.52 KB	-rw-r--r--	2026-08-13 18:53
sha2.h	5.6 KB	-rw-r--r--	2026-08-13 18:53
siphash.h	734 B	-rw-r--r--	2026-08-13 18:53
sockaddr.h	5.9 KB	-rw-r--r--	2026-08-13 18:53
socket.h	35.8 KB	-rw-r--r--	2026-08-13 18:53
stat.h	806 B	-rw-r--r--	2026-08-13 18:53
stats.h	3.62 KB	-rw-r--r--	2026-08-13 18:53
stdatomic.h	5.13 KB	-rw-r--r--	2026-08-13 18:53
stdio.h	1.75 KB	-rw-r--r--	2026-08-13 18:53
stdlib.h	704 B	-rw-r--r--	2026-08-13 18:53
stdtime.h	1.04 KB	-rw-r--r--	2026-08-13 18:53
strerror.h	777 B	-rw-r--r--	2026-08-13 18:53
string.h	5.88 KB	-rw-r--r--	2026-08-13 18:53
symtab.h	4.22 KB	-rw-r--r--	2026-08-13 18:53
syslog.h	844 B	-rw-r--r--	2026-08-13 18:53
task.h	21.04 KB	-rw-r--r--	2026-08-13 18:53
taskpool.h	3.62 KB	-rw-r--r--	2026-08-13 18:53
thread.h	962 B	-rw-r--r--	2026-08-13 18:53
time.h	8.67 KB	-rw-r--r--	2026-08-13 18:53
timer.h	10.54 KB	-rw-r--r--	2026-08-13 18:53
tm.h	895 B	-rw-r--r--	2026-08-13 18:53
types.h	5.64 KB	-rw-r--r--	2026-08-13 18:53
utf8.h	928 B	-rw-r--r--	2026-08-13 18:53
util.h	10.29 KB	-rw-r--r--	2026-08-13 18:53
version.h	689 B	-rw-r--r--	2026-08-13 18:53
xml.h	1.07 KB	-rw-r--r--	2026-08-13 18:53

Rename

/*
 * Copyright (C) Internet Systems Consortium, Inc. ("ISC")
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, you can obtain one at https://mozilla.org/MPL/2.0/.
 *
 * See the COPYRIGHT file distributed with this work for additional
 * information regarding copyright ownership.
 */

#ifndef ISC_TIME_H
#define ISC_TIME_H 1

/*! \file */

#include <inttypes.h>
#include <stdbool.h>

#include <isc/lang.h>
#include <isc/types.h>

/***
 *** Intervals
 ***/

/*!
 *  \brief
 * The contents of this structure are private, and MUST NOT be accessed
 * directly by callers.
 *
 * The contents are exposed only to allow callers to avoid dynamic allocation.
 */
struct isc_interval {
	unsigned int seconds;
	unsigned int nanoseconds;
};

extern const isc_interval_t * const isc_interval_zero;

/*
 * ISC_FORMATHTTPTIMESTAMP_SIZE needs to be 30 in C locale and potentially
 * more for other locales to handle longer national abbreviations when
 * expanding strftime's %a and %b.
 */
#define ISC_FORMATHTTPTIMESTAMP_SIZE 50

ISC_LANG_BEGINDECLS

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:
 *
 *\li	't' is a valid pointer.
 *\li	nanoseconds < 1000000000.
 */

bool
isc_interval_iszero(const isc_interval_t *i);
/*%<
 * Returns true iff. 'i' is the zero interval.
 *
 * Requires:
 *
 *\li	'i' is a valid pointer.
 */

/***
 *** Absolute Times
 ***/

/*%
 * The contents of this structure are private, and MUST NOT be accessed
 * directly by callers.
 *
 * The contents are exposed only to allow callers to avoid dynamic allocation.
 */

struct isc_time {
	unsigned int	seconds;
	unsigned int	nanoseconds;
};

extern const isc_time_t * const isc_time_epoch;

void
isc_time_set(isc_time_t *t, unsigned int seconds, unsigned int nanoseconds);
/*%<
 * Set 't' to a value which represents the given number of seconds and
 * nanoseconds since 00:00:00 January 1, 1970, UTC.
 *
 * Notes:
 *\li	The Unix version of this call is equivalent to:
 *\code
 *	isc_time_settoepoch(t);
 *	isc_interval_set(i, seconds, nanoseconds);
 *	isc_time_add(t, i, t);
 *\endcode
 *
 * Requires:
 *\li	't' is a valid pointer.
 *\li	nanoseconds < 1000000000.
 */

void
isc_time_settoepoch(isc_time_t *t);
/*%<
 * Set 't' to the time of the epoch.
 *
 * Notes:
 *\li	The date of the epoch is platform-dependent.
 *
 * Requires:
 *
 *\li	't' is a valid pointer.
 */

bool
isc_time_isepoch(const isc_time_t *t);
/*%<
 * Returns true iff. 't' is the epoch ("time zero").
 *
 * Requires:
 *
 *\li	't' is a valid pointer.
 */

#ifdef CLOCK_BOOTTIME
isc_result_t
isc_time_boottime(isc_time_t *t);
/*%<
 * Set 't' to monotonic time from previous boot
 * it's not affected by system time change. It also
 * includes the time system was suspended
 *
 * Requires:
 *\li	't' is a valid pointer.
 *
 * Returns:
 *
 *\li	Success
 *\li	Unexpected error
 *		Getting the time from the system failed.
 */
#endif /* CLOCK_BOOTTIME */

isc_result_t
isc_time_now(isc_time_t *t);
/*%<
 * Set 't' to the current absolute time.
 *
 * Requires:
 *
 *\li	't' is a valid pointer.
 *
 * Returns:
 *
 *\li	Success
 *\li	Unexpected error
 *		Getting the time from the system failed.
 *\li	Out of range
 *		The time from the system is too large to be represented
 *		in the current definition of isc_time_t.
 */

isc_result_t
isc_time_nowplusinterval(isc_time_t *t, const isc_interval_t *i);
/*%<
 * Set *t to the current absolute time + i.
 *
 * Note:
 *\li	This call is equivalent to:
 *
 *\code
 *		isc_time_now(t);
 *		isc_time_add(t, i, t);
 *\endcode
 *
 * Requires:
 *
 *\li	't' and 'i' are valid pointers.
 *
 * Returns:
 *
 *\li	Success
 *\li	Unexpected error
 *		Getting the time from the system failed.
 *\li	Out of range
 *		The interval added to the time from the system is too large to
 *		be represented in the current definition of isc_time_t.
 */

int
isc_time_compare(const isc_time_t *t1, const isc_time_t *t2);
/*%<
 * Compare the times referenced by 't1' and 't2'
 *
 * Requires:
 *
 *\li	't1' and 't2' are valid pointers.
 *
 * Returns:
 *
 *\li	-1		t1 < t2		(comparing times, not pointers)
 *\li	0		t1 = t2
 *\li	1		t1 > t2
 */

isc_result_t
isc_time_add(const isc_time_t *t, const isc_interval_t *i, isc_time_t *result);
/*%<
 * Add 'i' to 't', storing the result in 'result'.
 *
 * Requires:
 *
 *\li	't', 'i', and 'result' are valid pointers.
 *
 * Returns:
 *\li	Success
 *\li	Out of range
 * 		The interval added to the time is too large to
 *		be represented in the current definition of isc_time_t.
 */

isc_result_t
isc_time_subtract(const isc_time_t *t, const isc_interval_t *i,
		  isc_time_t *result);
/*%<
 * Subtract 'i' from 't', storing the result in 'result'.
 *
 * Requires:
 *
 *\li	't', 'i', and 'result' are valid pointers.
 *
 * Returns:
 *\li	Success
 *\li	Out of range
 *		The interval is larger than the time since the epoch.
 */

uint64_t
isc_time_microdiff(const isc_time_t *t1, const isc_time_t *t2);
/*%<
 * Find the difference in microseconds between time t1 and time t2.
 * t2 is the subtrahend of t1; ie, difference = t1 - t2.
 *
 * Requires:
 *
 *\li	't1' and 't2' are valid pointers.
 *
 * Returns:
 *\li	The difference of t1 - t2, or 0 if t1 <= t2.
 */

uint32_t
isc_time_seconds(const isc_time_t *t);
/*%<
 * Return the number of seconds since the epoch stored in a time structure.
 *
 * Requires:
 *
 *\li	't' is a valid pointer.
 */

isc_result_t
isc_time_secondsastimet(const isc_time_t *t, time_t *secondsp);
/*%<
 * Ensure the number of seconds in an isc_time_t is representable by a time_t.
 *
 * Notes:
 *\li	The number of seconds stored in an isc_time_t might be larger
 *	than the number of seconds a time_t is able to handle.  Since
 *	time_t is mostly opaque according to the ANSI/ISO standard
 *	(essentially, all you can be sure of is that it is an arithmetic type,
 *	not even necessarily integral), it can be tricky to ensure that
 *	the isc_time_t is in the range a time_t can handle.  Use this
 *	function in place of isc_time_seconds() any time you need to set a
 *	time_t from an isc_time_t.
 *
 * Requires:
 *\li	't' is a valid pointer.
 *
 * Returns:
 *\li	Success
 *\li	Out of range
 */

uint32_t
isc_time_nanoseconds(const isc_time_t *t);
/*%<
 * Return the number of nanoseconds stored in a time structure.
 *
 * Notes:
 *\li	This is the number of nanoseconds in excess of the number
 *	of seconds since the epoch; it will always be less than one
 *	full second.
 *
 * Requires:
 *\li	't' is a valid pointer.
 *
 * Ensures:
 *\li	The returned value is less than 1*10^9.
 */

void
isc_time_formattimestamp(const isc_time_t *t, char *buf, unsigned int len);
/*%<
 * Format the time 't' into the buffer 'buf' of length 'len',
 * using a format like "30-Aug-2000 04:06:47.997" and the local time zone.
 * If the text does not fit in the buffer, the result is indeterminate,
 * but is always guaranteed to be null terminated.
 *
 *  Requires:
 *\li      'len' > 0
 *\li      'buf' points to an array of at least len chars
 *
 */

void
isc_time_formathttptimestamp(const isc_time_t *t, char *buf, unsigned int len);
/*%<
 * Format the time 't' into the buffer 'buf' of length 'len',
 * using a format like "Mon, 30 Aug 2000 04:06:47 GMT"
 * If the text does not fit in the buffer, the result is indeterminate,
 * but is always guaranteed to be null terminated.
 *
 *  Requires:
 *\li      'len' > 0
 *\li      'buf' points to an array of at least len chars
 *
 */

isc_result_t
isc_time_parsehttptimestamp(char *input, isc_time_t *t);
/*%<
 * Parse the time in 'input' into the isc_time_t pointed to by 't',
 * expecting a format like "Mon, 30 Aug 2000 04:06:47 GMT"
 *
 *  Requires:
 *\li      'buf' and 't' are not NULL.
 */

void
isc_time_formatISO8601(const isc_time_t *t, char *buf, unsigned int len);
/*%<
 * Format the time 't' into the buffer 'buf' of length 'len',
 * using the ISO8601 format: "yyyy-mm-ddThh:mm:ssZ"
 * If the text does not fit in the buffer, the result is indeterminate,
 * but is always guaranteed to be null terminated.
 *
 *  Requires:
 *\li      'len' > 0
 *\li      'buf' points to an array of at least len chars
 *
 */

void
isc_time_formatISO8601ms(const isc_time_t *t, char *buf, unsigned int len);
/*%<
 * Format the time 't' into the buffer 'buf' of length 'len',
 * using the ISO8601 format: "yyyy-mm-ddThh:mm:ss.sssZ"
 * If the text does not fit in the buffer, the result is indeterminate,
 * but is always guaranteed to be null terminated.
 *
 *  Requires:
 *\li      'len' > 0
 *\li      'buf' points to an array of at least len chars
 *
 */

ISC_LANG_ENDDECLS

#endif /* ISC_TIME_H */