Manual Pages  — TIMESPEC_GET

timespec_get – get current calendar time

LIBRARY SYNOPSIS DESCRIPTION RETURN VALUES SEE ALSO STANDARDS HISTORY AUTHORS

Standard C Library (libc, -lc)

#include <time.h>

int
timespec_get(struct timespec *ts, int base);

The timespec_get function sets the interval pointed to by ts to hold the current calendar time based on the specified time base in base.

The base TIME_UTC returns the time since the epoch. This time is expressed in seconds and nanoseconds since midnight (0 hour), January 1, 1970. In FreeBSD , this corresponds to CLOCK_REALTIME.

The base TIME_MONOTONIC returns a monotonically-increasing time since an unspecified point in the past. In FreeBSD , this corresponds to CLOCK_MONOTONIC.

The timespec_get function returns the passed value of base if successful, otherwise 0 on failure.

The timespec_get function with a base of TIME_UTC conforms to ISO/IEC .

This interface first appeared in FreeBSD 12 .

Kamil Rytarowski <Mt kamil@NetBSD.org> Warner Losh <Mt imp@FreeBSD.org>