clock_getcpuclockid3
Access a process cpu-time clock
Usage
#include <time.h>
int
clock_getcpuclockid(pid_t pid, clockid_t *clock_id);
Library
Standard C Library (libc, -lc)
Overview
The clock_getcpuclockid() returns the clock ID of the CPU-time clock of the process specified by pid. If the process described by pid exists and the calling process has permission, the clock ID of this clock will be returned in clock_id.
If pid is zero, the clock_getcpuclockid() function returns the clock ID of the CPU-time clock of the process making the call, in clock_id.
Return values
Upon successful completion, clock_getcpuclockid() returns zero; otherwise, an error number is returned to indicate the error.
Errors
The clock_getcpuclockid() function will fail if:
- [EPERM]
-
The requesting process does not have permission to access the CPU-time clock for the process.
- [ESRCH]
-
No process can be found corresponding to the process specified by pid.
Releases
30 releases since FreeBSD 10.0-RELEASE; the text changed 16 times.