CLOCK_GETRES

Section: Linux Programmer's Manual (2)
Updated: 2004-03-12
Index Return to Main Contents
 

NAME

clock_getres - Get the resolution of any clock  

SYNOPSIS

long sys_clock_getres (clockid_t which_clock, struct timespec *tp);
 

DESCRIPTION

clock_gettime gets the resolution of any clock specified by the which_clock parameter, and places this information in the struct timespec pointed to by tp. The values that clockid_t currently supports for POSIX.1b timers, as defined in include/linux/time.h, are:

CLOCK_REALTIME
Systemwide realtime clock.
CLOCK_MONOTONIC
Represents monotonic time. Cannot be set.
CLOCK_PROCESS_CPUTIME_ID
High resolution per-process timer.
CLOCK_THREAD_CPUTIME_ID
Thread-specific timer.
CLOCK_REALTIME_HR
High resolution version of CLOCK_REALTIME.
CLOCK_MONOTONIC_HR
High resolution version of CLOCK_MONOTONIC.
 
 

RETURN VALUE

clock_gettime returns 0 on success; otherwise, it returns one of the errors listed in the "Errors" section.  

ERRORS

-EINVAL
An invalid which_clock value was specified.
-EFAULT
An invalid tp value was specified.
 

SEE ALSO

clock_gettext(2), clock_nanosleep(2), clock_settime(2)  

AUTHOR

Niki Rahimi