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

          --- old/usr/src/man/man3proc/Pctlfd.3proc
          +++ new/usr/src/man/man3proc/Pctlfd.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 PCTFLD 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Pctlfd
  19   19  .Nd obtain the process control file descriptor
  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 Pctlfd
  25   26  .Fa "struct ps_prochandle *P"
  26   27  .Fc
  27   28  .Sh DESCRIPTION
  28   29  The
  29   30  .Fn Pctlfd
  30   31  function returns a file descriptor to the underlying /proc file system
  31   32  .Sy ctl

  32   33  file for the process identified by the handle
  33   34  .Fa P .
  34   35  This may be used for injecting control operations manually;
  35   36  however, many interfaces for using it are provided by
  36   37  .Xr libproc 3LIB
  37   38  itself.
  38   39  .Pp
  39   40  Only live processes have a control file descriptor.
  40   41  Process handles that correspond to files and cores, created through
  41   42  .Xr Pgrab_file 3PROC
  42   43  and
  43   44  .Xr Pgrab_core 3PROC ,
  44   45  do not have a corresponding file descriptor.
  45   46  .Pp
  46   47  The file descriptor is invalidated when the process handle is released
  47   48  through
  48   49  .Xr Prelease 3PROC
  49   50  or if control is lost and the handle is reopened.
  50   51  .Sh RETURN VALUES
  51   52  Upon successful completion, the
  52   53  .Fn Pctlfd
  53   54  function returns a valid file descriptor.
  54   55  Otherwise, if none exists, then
  55   56  .Sy -1
  56   57  is returned.
  57   58  .Sh INTERFACE STABILITY
  58   59  .Sy Uncommitted
  59   60  .Sh MT-LEVEL
  60   61  See
  61   62  .Sy LOCKING
  62   63  in
  63   64  .Xr libproc 3LIB .
  64   65  .Sh SEE ALSO
  65   66  .Xr libproc 3LIB ,
  66   67  .Xr Pcreate 3PROC ,
  67   68  .Xr Pgrab 3PROC ,
  68   69  .Xr Pgrab_core 3PROC ,
  69   70  .Xr Pgrab_file 3PROC ,
  70   71  .Xr Prelease 3PROC ,
  71   72  .Xr Preopen 3PROC ,
  72   73  .Xr proc 4

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX