CLOCK_GETCPUCLOCKID2(2)

CLOCK_GETCPUCLOCKID2(2) | System Calls Manual | CLOCK_GETCPUCLOCKID2(2)

# NAME

clock_getcpuclockid2 — retrieve the clock id of a process or LWP

# LIBRARY

Standard C Library (libc, -lc)

# SYNOPSIS

#include <time.h>
int
clock_getcpuclockid2(idtype_t idtype, id_t id, clockid_t *clock_id);
int
clock_getcpuclockid(pid_t pid, clockid_t *clock_id);

# DESCRIPTION

The cpu_getcpuclockid2() function retrieves the clock_id for the specified id and idtype. Supported idtypes are:

`P_PID`
  The specified process id or `0` for the current process.
`P_LWPID`
  The specified LWP id or `0` for the current LWP.

The clock_getcpuclockid() function is equivalent to calling clock_getcpuclockid2() with idtype `P_PID` and id pid.
The clock_gettime(2) function can be used with the returned clock_id to retrieve process and LWP times.

# RETURN VALUES

The clock_getcpuclockid2() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.
If successful, the clock_getcpuclockid() function will return 0. Otherwise an error number will be returned.

# ERRORS

These functions fail if:

[`EFAULT`]
  clock_id points outside the process's allocated address space.

In addition clock_getcpuclockid2() will fail if:

[`EINVAL`]
  An unsupported idtype was supplied.

# SEE ALSO

clock_gettime(2)

# STANDARDS

The clock_getcpuclockid() function conforms to IEEE Std 1003.1-2001 (“POSIX.1”). The clock_getcpuclockid2() is a NetBSD extension.

# HISTORY

The clock_getcpuclockid() and clock_getcpuclockid2() functions appeared in NetBSD 8.

March 5, 2017 | NetBSD 8.3