man pages section 2: System Calls

_lwp_info(2)

Name

_lwp_info– return the time-accounting information of a single LWP

Synopsis

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

int _lwp_info(struct lwpinfo *buffer);

Description

The _lwp_info() function fills the lwpinfo structure pointed to by buffer with time-accounting information pertaining to the calling LWP. This call may be extended in the future to return other information to the lwpinfo structure as needed. The lwpinfo structure in <sys/lwp.h> includes the following members:

timestruc_t   lwp_utime;
timestruc_t   lwp_stime;

The lwp_utime member is the CPU time used while executing instructions in the user space of the calling LWP.

The lwp_stime member is the CPU time used by the system on behalf of the calling LWP.

Return Values

Upon successful completion, _lwp_info() returns 0 and fills in the lwpinfo structure pointed to by buffer.

Errors

If the following condition is detected, _lwp_info() returns the corresponding value:

EFAULT: The buffer argument points to an illegal address.

Additionally, the _lwp_info() function will fail for 32-bit interfaces if:

EOVERFLOW: The size of the tv_sec member of the timestruc_t type pointed to by lwp_utime and lwp_stime is too small to contain the correct number of seconds.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
MT-Level	Async-Signal-Safe