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

          --- old/usr/src/man/man3proc/Pclearfault.3proc
          +++ new/usr/src/man/man3proc/Pclearfault.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 PCLEARFAULT 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Pclearfault ,
  19   19  .Nm Lclearfault
  20   20  .Nd clear process and thread faults
  21      -.Sh SYNOPSIS
       21 +.Sh LIBRARY
  22   22  .Lb libproc
       23 +.Sh SYNOPSIS
  23   24  .In libproc.h
  24   25  .Ft int
  25   26  .Fo Pclearfault
  26   27  .Fa "struct ps_prochandle *P"
  27   28  .Fc
  28   29  .Ft int
  29   30  .Fo Lclearfault
  30   31  .Fa "struct ps_lwphandle *L"
  31   32  .Fc
  32   33  .Sh DESCRIPTION

  33   34  During normal operation a process may encounter a
  34   35  .Sy fault ,
  35   36  due to a hardware exception, identifying a problem with the running process.
  36   37  Hardware faults include things like executing illegal instructions, encountering
  37   38  a breakpoint, and arithmetic exceptions.
  38   39  Faults are discussed further in
  39   40  .Xr proc 4 .
  40   41  .Pp
  41   42  The
  42   43  .Fn Pclearfault
  43   44  function instructs the system to clear any fault pending delivery to a
  44   45  thread in the process represented by the process handle
  45   46  .Fa P .
  46   47  The pending fault will never be delivered to process represented by
  47   48  .Fa P .
  48   49  .Pp
  49   50  The
  50   51  .Fn Lclearfault
  51   52  function is identical to the
  52   53  .Fn Pclearfault
  53   54  function, except rather than operating on the representative thread of
  54   55  the process it operates on the thread handle
  55   56  .Fa L .
  56   57  .Pp
  57   58  The
  58   59  .Fn Pclearfault
  59   60  and
  60   61  .Fn Lclearfault
  61   62  functions only have meaning for active processes.
  62   63  They will fail on process handles corresponding to zombie processes, ELF
  63   64  objects, and cores.
  64   65  .Sh RETURN VALUES
  65   66  Upon successful completion, the
  66   67  .Fn Pclearfault
  67   68  and
  68   69  .Fn Lclearfault
  69   70  functions clear pending faults and return
  70   71  .Sy 0 .
  71   72  Otherwise,
  72   73  .Sy -1
  73   74  is returned,
  74   75  .Sy errno
  75   76  is set to indicate the error,
  76   77  and no faults are cleared.
  77   78  .Sh ERRORS
  78   79  For a full list of possible errors see the
  79   80  .Sy DIAGNOSTICS
  80   81  section in
  81   82  .Xr proc 4 .
  82   83  .Sh INTERFACE STABILITY
  83   84  .Sy Uncommitted
  84   85  .Sh MT-LEVEL
  85   86  See
  86   87  .Sy LOCKING
  87   88  in
  88   89  .Xr libproc 3LIB .
  89   90  .Sh SEE ALSO
  90   91  .Xr libproc 3LIB ,
  91   92  .Xr proc 4

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX