Go to main content

man pages section 3: Basic Library Functions

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

clock_getcpuclockid(3C)

Name

clock_getcpuclockid - access a process CPU-time clock

Synopsis

#include <time.h>

int clock_getcpuclockid(pid_t  pid, clockid_t *clock_id);

Description

The clock_getcpuclockid() function shall return 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 shall be returned in clock_id. If pid is zero, the clock_getcpuclockid() function shall return the clock ID of the CPU-time clock of the process making the call in clock_id. The conditions under which one process has permission to obtain the CPU-time clock ID of other processes are implementation-defined.

Return Values

On successful completion, clock_getcpuclockid() shall return 0; otherwise an error shall be 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.

The clock_getcpuclockid() function may fail if:

ESRCH

No process can be found corresponding to the process specified by pid.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
MT-Safe
Standard

See Also

clock_getres(3C), timer_create(3C), attributes(7), standards(7)