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

          --- old/usr/src/man/man3proc/Pdelwapt.3proc
          +++ new/usr/src/man/man3proc/Pdelwapt.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 PDELWAPT 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Pdelwapt
  19   19  .Nd remove 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 Pdelwapt
  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 Pdelwapt
  31   32  function removes the watchpoint specified by

  32   33  .Fa wp
  33   34  from the process represented by the handle
  34   35  .Fa P .
  35   36  The watchpoint should have been installed with either
  36   37  .Xr Psetwapt 3PROC
  37   38  or the underlying /proc file system
  38   39  .Sy PCWATCH
  39   40  operation.
  40   41  .Pp
  41   42  The
  42   43  .Fn Pdelwapt
  43   44  function only works on running processes, such as those created through
  44   45  .Xr Pgrab 3PROC
  45   46  and
  46   47  .Xr Pcreate 3PROC .
  47   48  Attempting to remove a watchpoint from process handles to core files,
  48   49  zombie processes, or ELF objects will fail.
  49   50  .Sh RETURN VALUES
  50   51  Upon successful completion, the
  51   52  .Fn Pdelwapt
  52   53  function removes the watchpoint and returns
  53   54  .Sy 0 .
  54   55  Otherwise,
  55   56  .Sy -1
  56   57  is returned,
  57   58  .Sy errno
  58   59  is set to indicate the error.
  59   60  .Sh ERRORS
  60   61  For a full list of possible errors see the
  61   62  .Sy DIAGNOSTICS
  62   63  section in
  63   64  .Xr proc 4 .
  64   65  .Pp
  65   66  The
  66   67  .Fn Pdelwapt
  67   68  function will fail with:
  68   69  .Bl -tag -width Er
  69   70  .It Er ENOENT
  70   71  The handle
  71   72  .Fa P
  72   73  refers to a grabbed core file, a zombie process, or an ELF object.
  73   74  .El
  74   75  .Sh INTERFACE STABILITY
  75   76  .Sy Uncommitted
  76   77  .Sh MT-LEVEL
  77   78  See
  78   79  .Sy LOCKING
  79   80  in
  80   81  .Xr libproc 3LIB .
  81   82  .Sh SEE ALSO
  82   83  .Xr libproc 3LIB ,
  83   84  .Xr Pcreate 3PROC ,
  84   85  .Xr Pgrab 3PROC ,
  85   86  .Xr Pgrab_core 3PROC ,
  86   87  .Xr Pgrab_file 3PROC ,
  87   88  .Xr Psetwapt 3PROC ,
  88   89  .Xr proc 4

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX