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

          --- old/usr/src/man/man3proc/Psysentry.3proc.man.txt
          +++ new/usr/src/man/man3proc/Psysentry.3proc.man.txt
   1    1  PSYSENTRY(3PROC)       Process Control Library Functions      PSYSENTRY(3PROC)
   2    2  
   3    3  NAME
   4    4       Psysentry, Psysexit - set system call entry and exit actions
   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       Psysentry(struct ps_prochandle *P, int which, int stop);
  12   14  
  13   15       int
  14   16       Psysexit(struct ps_prochandle *P, int which, int stop);
  15   17  
  16   18  DESCRIPTION
  17   19       The Psysentry() and Psysexit() functions controls what actions the

  18   20       process handle P should take upon executing a system call.
  19   21  
  20   22       The system allows a process to be stopped on both entry and exit of a
  21   23       system call.  For information on the state of the process when it is
  22   24       stopped due to system call tracing, see the PCSENTRY and PCSEXIT sections
  23   25       of proc(4).
  24   26  
  25   27       The value of the stop parameter controls whether or not the system call
  26   28       listed in which causes the process to stop.  A value of non-zero
  27   29       indicates the process should stop; a value of 0 indicates it should not.
  28   30  
  29   31       The value of which indicates which system call the change applies to.  A
  30   32       value of 0 applies to all system calls.  Note, the system does not supply
  31   33       a stable mapping from system call names to identifiers.
  32   34  
  33   35       These functions only apply to actively running processes.  They do not
  34   36       function on handles that refer to core files, zombie processes, or ELF
  35   37       objects.
  36   38  
  37   39  RETURN VALUES
  38   40       Upon successful completion, the Psysentry() and Psysexit() functions
  39   41       return the previous disposition of the system call -- 0 if it was not set
  40   42       to stop and 1 if it was -- and the system call state is updated.
  41   43       Otherwise, -1 is returned, errno is updated with the error that occurred,
  42   44       and the system call state is not updated.
  43   45  
  44   46  ERRORS
  45   47       The Psysentry() and Psysexit() functions will fail if:
  46   48  
  47   49       EINVAL             The value of which is invalid, e.g. it is less than
  48   50                          zero or greater than the largest defined system call.
  49   51  
  50   52       ENOENT             The handle P refers to a process that is a zombie, a
  51   53                          core file, or an ELF object.
  52   54  
  53   55  INTERFACE STABILITY
  54   56       Uncommitted
  55   57  
  56   58       Note, while the Psysentry() and Psysexit() functions are uncommitted, the
  57   59       mapping of system calls to system call numbers is Not-an-Interface and
  58   60       may change at any time.
  59   61  
  60   62  MT-LEVEL
  61   63       See LOCKING in libproc(3LIB).
  62   64  
  63   65  SEE ALSO
  64   66       libproc(3LIB), proc(4), attributes(5)
  65   67  
  66   68  illumos                          May 11, 2016                          illumos

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX