This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

clock_getcpuclockid()

Return the clock ID of the CPU-time clock from a specified process

Synopsis:

#include <sys/types.h>
#include <time.h>

extern int clock_getcpuclockid( 
                       pid_t pid,
                       clockid_t* clock_id );

Arguments:

pid: The process ID for the process whose clock ID you want to get.
clock_id: A pointer to a clockid_t object where the function can store the clock ID.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

The clock_getcpuclockid() function 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 is stored in clock_id.

If pid is zero, the clock ID of the CPU-time clock of the process marking the call is returned in clock_id.

A process always has permission to obtain the CPU-time clock ID of another process.

Returns:

Zero for success, or an error value.

Errors:

ESRCH: No process can be found corresponding to the specified pid.

Classification:

POSIX 1003.1 CPT

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes