_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
		       correct 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.10							    8 Aug 2001							      _lwp_info(2)