8158 Want named threads API
9857 proc manpages should have LIBRARY section

          --- old/usr/src/man/man3proc/Plwp_getxregs.3proc.man.txt
          +++ new/usr/src/man/man3proc/Plwp_getxregs.3proc.man.txt
   1    1  PLWP_GETXREGS(3PROC)   Process Control Library Functions  PLWP_GETXREGS(3PROC)
   2    2  
   3    3  NAME
   4    4       Plwp_getxregs, Plwp_setxregs - get and set extended register state
   5    5  
   6      -SYNOPSIS
        6 +LIBRARY
   7    7       Process Control Library (libproc, -lproc)
        8 +
        9 +SYNOPSIS
   8   10       #include <libproc.h>
   9   11  
  10   12       int
  11   13       Plwp_getxregs(struct ps_prochandle *P, lwpid_t lwpid,
  12   14           prxregset_t *xregs);
  13   15  
  14   16       int
  15   17       Plwp_setxregs(struct ps_prochandle *P, lwpid_t lwpid,
  16   18           const prxregset_t *xregs);
  17   19  

  18   20  DESCRIPTION
  19   21       The Plwp_getxregs() and Plwp_setxregs() functions get and set the
  20   22       extended register state of the thread lwpid in the process handle P.
  21   23  
  22   24       The extended register state is defined by the architecture.  These
  23   25       registers may refer to optional registers that have become common on the
  24   26       platform, but are not part of the standard ABI and thus not covered by
  25   27       functions such as Plwp_getregs(3PROC) and Plwp_getfpregs(3PROC).
  26   28  
  27   29       The Plwp_getxregs() function gets the extended register state information
  28   30       and places it into xregs.  Where as the Plwp_setxregs() function sets the
  29   31       extended register state information in xregs for the process handle P.
  30   32  
  31   33       Processes must be stopped prior to obtaining the register state of
  32   34       individual threads.  Processes may be stopped with Pstop(3PROC).
  33   35  
  34   36       The prxregset_t structure is described in proc(4).
  35   37  
  36   38       One may not set the register values of a process that is not an active
  37   39       process, e.g. a process handle that refers to a file or a core file.
  38   40  
  39   41  RETURN VALUES
  40   42       Upon successful completion, the Plwp_getxregs() and Plwp_setxregs()
  41   43       functions return 0 and get or set the register state.  Otherwise, -1 is
  42   44       returned and errno is set to indicate the error.
  43   45  
  44   46  ERRORS
  45   47       For a full list of possible errors see the DIAGNOSTICS section in
  46   48       proc(4).
  47   49  
  48   50       The Plwp_getxregs() and Plwp_setxregs() function will fail if:
  49   51  
  50   52       ENODATA            The process handle P does not have any extended
  51   53                          register state information.
  52   54  
  53   55       EBUSY              The process handle P refers to a live process and it
  54   56                          is not stopped.
  55   57  
  56   58       ENOENT             The process handle P refers to a live process and
  57   59                          there is no thread with id lwpid.
  58   60  
  59   61       EINVAL             The process handle P refers to a core file and there
  60   62                          is no thread with id lwpid.
  61   63  
  62   64  ARCHITECTURE
  63   65       The Plwp_getxregs() and Plwp_setxregs() functions are only available on
  64   66       SPARC platforms.
  65   67  
  66   68  INTERFACE STABILITY
  67   69       Uncommitted
  68   70  
  69   71  MT-LEVEL
  70   72       See LOCKING in libproc(3LIB).
  71   73  
  72   74  SEE ALSO
  73   75       libproc(3LIB), Plwp_getfpregs(3PROC), Plwp_getregs(3PROC),
  74   76       Plwp_setfpregs(3PROC), Plwp_setregs(3PROC), Pstop(3PROC), proc(4)
  75   77  
  76   78  illumos                          May 11, 2016                          illumos

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX