dg_lwp_info(2)                    SDK R4.11                   dg_lwp_info(2)


NAME
       dglwpinfo - get information about currently active light-weight
       processes

SYNOPSIS
       #include <sys/dglwp.h>

       int    dglwpinfo (version,
              pid,
              selector,
              selectorvalue,
              keyptr,
              bufferptr)
       long   version;
       pidt  pid;
       long   selector;
       long   selectorvalue;
       long   * keyptr;
       struct dglwpinfo * bufferptr;

   where:
       version             To use the most recent version, version should be
                           set to DG_LWP_INFO_CURRENT_VERSION.

       pid                 The pid of the process whose light-weight
                           processes (LWPs) are to be examined.

       selector            A value to indicate how LWPs of the process are
                           to be selected.

       selectorvalue      A value for the select condition above.

       keyptr             On the first call, a pointer to a variable
                           containing the value DG_LWP_INFO_INITIAL_KEY; on
                           return, a handle that should be used on
                           subsequent calls to this system call.

       bufferptr          A pointer to a dglwpinfo structure where the
                           LWP information will be returned.

DESCRIPTION
       The dglwpinfo system call searches the specified process for valid
       LWPs and based on the selector determines whether or not to return
       information about that LWP.  Searching continues until an LWP is
       found (return value (1)), or until the process is completely searched
       (return value (0)).  Only one search through the process is made.

ACCESS CONTROL
       There are no checks for access control.  All users can access this
       system call.

RETURN VALUE
       1      Successful search, but not done.  The buffer was filled with
              information about an LWP.  keyptr is given a handle which
              subsequent calls to this routine will use to continue the
              search through the process.

       0      Successful completion, that is, no more LWPs.  The contents of
              buffer are undefined.

       -1     An error occurred.  errno is set to indicate the error.

DIAGNOSTICS
       Errno may be set to one of the following error codes:

       EINTR     An interrupt occurred during the system call

       EINVAL    A bad argument was passed in.

       EFAULT    The keyptr argument specifies a bad address

       EFAULT    The bufferptr argument specifies a bad address

SEE ALSO
       nps(1), dgprocessinfo(2), pthreadcreate(3T).


Licensed material--property of copyright holder(s)