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

          --- old/usr/src/man/man3proc/Psetwapt.3proc
          +++ new/usr/src/man/man3proc/Psetwapt.3proc

   1    1  .\"
   2    2  .\" This file and its contents are supplied under the terms of the
   3    3  .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4    4  .\" You may only use this file in accordance with the terms of version
   5    5  .\" 1.0 of the CDDL.
   6    6  .\"
   7    7  .\" A full copy of the text of the CDDL should have accompanied this
   8    8  .\" source.  A copy of the CDDL is also available via the Internet at
   9    9  .\" http://www.illumos.org/license/CDDL.

  10   10  .\"
  11   11  .\"
  12   12  .\" Copyright 2015 Joyent, Inc.
  13   13  .\"
  14   14  .Dd May 11, 2016
  15   15  .Dt PSETWAPT 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Psetwapt
  19   19  .Nd set a watchpoint in a process
  20      -.Sh SYNOPSIS
       20 +.Sh LIBRARY
  21   21  .Lb libproc
       22 +.Sh SYNOPSIS
  22   23  .In libproc.h
  23   24  .Ft int
  24   25  .Fo Psetwapt
  25   26  .Fa "struct ps_prochandle *P"
  26   27  .Fa "const prwatch_t *wp"
  27   28  .Fc
  28   29  .Sh DESCRIPTION
  29   30  The
  30   31  .Fn Psetwapt
  31   32  function adds a watchpoint to the process handle

  32   33  .Fa P .
  33   34  Allowing the hardware to generate a trap when the specified area is
  34   35  accessed.
  35   36  The watchpoint's parameters are described in
  36   37  .Fa wp .
  37   38  For more information on watchpoints and the
  38   39  .Sy prwatch_t
  39   40  structure, see the
  40   41  .Sy PCWATCH
  41   42  section in
  42   43  .Xr proc 4 .
  43   44  The watched area will persist until a subsequent call to
  44   45  .Xr Pdelwapt 3PROC .
  45   46  .Pp
  46   47  Note, only active processes support watchpoints.
  47   48  It is an error to call this function on process handles that correspond to core
  48   49  files, zombie processes, or files.
  49   50  .Sh RETURN VALUES
  50   51  Upon successful completion, the
  51   52  .Fn Psetwapt
  52   53  function returns
  53   54  .Sy 0
  54   55  and installs the watchpoint in
  55   56  .Fa P .
  56   57  Otherwise,
  57   58  .Sy -1
  58   59  is returned and
  59   60  .Sy errno
  60   61  is set.
  61   62  .Sh ERRORS
  62   63  For a full list of possible errors see the
  63   64  .Sy DIAGNOSTICS
  64   65  section in
  65   66  .Xr proc 4 .
  66   67  .Pp
  67   68  The
  68   69  .Fn Psetwapt
  69   70  function will fail if:
  70   71  .Bl -tag -width Er
  71   72  .It Er ENOENT
  72   73  .Fa P
  73   74  does not refer to an active process.
  74   75  .El
  75   76  .Sh INTERFACE STABILITY
  76   77  .Sy Uncommitted
  77   78  .Sh MT-LEVEL
  78   79  See
  79   80  .Sy LOCKING
  80   81  in
  81   82  .Xr libproc 3LIB .
  82   83  .Sh SEE ALSO
  83   84  .Xr libproc 3LIB ,
  84   85  .Xr Pdelwapt 3PROC ,
  85   86  .Xr proc 4

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX