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

          --- old/usr/src/man/man3proc/Plwp_getasrs.3proc.man.txt
          +++ new/usr/src/man/man3proc/Plwp_getasrs.3proc.man.txt
   1    1  PLWP_GETASRS(3PROC)    Process Control Library Functions   PLWP_GETASRS(3PROC)
   2    2  
   3    3  NAME
   4    4       Plwp_getasrs, Plwp_setasrs - get and set SPARCv9 ancillary state
   5    5       registers
   6    6  
   7      -SYNOPSIS
        7 +LIBRARY
   8    8       Process Control Library (libproc, -lproc)
        9 +
       10 +SYNOPSIS
   9   11       #include <libproc.h>
  10   12  
  11   13       int
  12   14       Plwp_getasrs(struct ps_prochandle *P, lwpid_t lwpid, asrset_t asrs);
  13   15  
  14   16       int
  15   17       Plwp_setasrs(struct ps_prochandle *P, lwpid_t lwpid,
  16   18           const asrset_t asrs);
  17   19  
  18   20  DESCRIPTION

  19   21       The Plwp_getasrs() and Plwp_setasrs() functions get and set the ancillary
  20   22       thread-specific register set of the thread lwpid in the process handle P.
  21   23  
  22   24       The ancillary state registers are only present on 64-bit SPARCv9
  23   25       processes.  They contain information that is specific to the platform and
  24   26       are not included in the information obtained through functions such as
  25   27       Plwp_getregs(3PROC), Plwp_getfpregs(3PROC), and Plwp_getxregs(3PROC).
  26   28  
  27   29       The Plwp_getasrs() function reads the ancillary registers into asrs,
  28   30       while the Plwp_setasrs() sets the thread's ancillary registers to the
  29   31       values provided by asrs.
  30   32  
  31   33       Processes should 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 asrset_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_getasrs() and Plwp_setasrs()
  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_getasrs() and Plwp_setasrs() function will fail if:
  49   51  
  50   52       ENODATA            The process handle P does not have any ancillary
  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 or it is not a 64-bit
  58   60                          SPARCv9 process.
  59   61  
  60   62       EINVAL             The process handle P refers to a core file and there
  61   63                          is no thread with id lwpid.
  62   64  
  63   65  ARCHITECTURE
  64   66       The Plwp_getasrs() and Plwp_setasrs() functions are only available on
  65   67       64-bit SPARCv9 platforms.
  66   68  
  67   69  INTERFACE STABILITY
  68   70       Uncommitted
  69   71  
  70   72  MT-LEVEL
  71   73       See LOCKING in libproc(3LIB).
  72   74  
  73   75  SEE ALSO
  74   76       libproc(3LIB), Plwp_getfpregs(3PROC), Plwp_getregs(3PROC),
  75   77       Plwp_setregs(3PROC), Plwp_setregs(3PROC), Pstop(3PROC), proc(4)
  76   78  
  77   79  illumos                          May 11, 2016                          illumos

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX