opensolaris man page for _lwp_info

_lwp_info(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 cor-
		    rect number of seconds.

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

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

SEE ALSO
       times(2), attributes(5)

SunOS 5.11							    8 Aug 2001							      _lwp_info(2)