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

          --- old/usr/src/man/man3proc/Psetbkpt.3proc.man.txt
          +++ new/usr/src/man/man3proc/Psetbkpt.3proc.man.txt
   1    1  PSETBKPT(3PROC)        Process Control Library Functions       PSETBKPT(3PROC)
   2    2  
   3    3  NAME
   4    4       Psetbkpt - set a breakpoint trap in a process
   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       Psetbkpt(struct ps_prochandle *P, uintptr_t address, ulong_t *saved);
  12   14  
  13   15  DESCRIPTION
  14   16       The Psetbkpt() function sets a breakpoint instruction at the address
  15   17       address in the process handle P.  The instruction that used to be set
  16   18       will be set in saved and should be retained.
  17   19  

  18   20       A breakpoint will remain in place until a subsequent call to
  19   21       Pdelbkpt(3PROC).  The value stored in saved should be passed as the third
  20   22       argument to Pdelbkpt(3PROC).
  21   23  
  22   24       When a process executes an instruction that has been replaced with a
  23   25       breakpoint it generates a FLTBPT trap causing the thread to stop.
  24   26  
  25   27       Note, breakpoints may only be set in active processes.  They may not be
  26   28       set in process handles that refer to core files, zombie processes, or
  27   29       files.
  28   30  
  29   31  RETURN VALUES
  30   32       Upon successful completion, the Psetbkpt() function sets the breakpoint
  31   33       and returns 0.  Otherwise, -1 is returned and errno is set to indicate
  32   34       the error.
  33   35  
  34   36  ERRORS
  35   37       For a full list of possible errors see the DIAGNOSTICS section in
  36   38       proc(4).
  37   39  
  38   40       The Psetbkpt() function will fail if:
  39   41  
  40   42       ENOENT             P does not refer to an active process.
  41   43  
  42   44       EBUSY              A breakpoint instruction was already written by
  43   45                          another debugger.
  44   46  
  45   47  INTERFACE STABILITY
  46   48       Uncommitted
  47   49  
  48   50  MT-LEVEL
  49   51       See LOCKING in libproc(3LIB).
  50   52  
  51   53  SEE ALSO
  52   54       libproc(3LIB), Pdelbkpt(3PROC), proc(4)
  53   55  
  54   56  illumos                          May 11, 2016                          illumos

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX