NAME

timespec_get, timespec_getres - ISO C interface to clock and time functions

LIBRARY

Standard C library (libc, -lc),

SYNOPSIS

#include <time.h>

int timespec_get(struct timespec *res, int base);
int timespec_getres(struct timespec *tp, int base);

DESCRIPTION

timespec_get(tp, TIME_UTC) is defined as clock_gettime(CLOCK_REALTIME, tp).

timespec_getres(res, TIME_UTC) is equivalent to clock_getres(CLOCK_REALTIME, res).

TIME_UTC is universally guaranteed to be a valid base, and is the only one supported under Linux. Some other systems support different time bases.

RETURN VALUE

On success, base is returned. On error, -1 is returned.

ERRORS

Some C libraries may set errno to the same value as would be set by clock_gettime(2) or clock_getres(2). Neither C nor POSIX specify this, but they don't really indicate it shouldn't happen, either. Don't rely on this.

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).

STANDARDS

timespec_get()

TIME_UTC

C23 (though ISO C doesn't specify the time epoch), POSIX.1-2024.

timespec_getres()

C23.

HISTORY

timespec_get()

TIME_UTC

C11, POSIX.1-2024, glibc 2.16, musl 1.1.10.

timespec_getres()

C23, glibc 2.34.

SEE ALSO

clock_gettime(2), clock_getres(2)