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

          --- old/usr/src/man/man3proc/Preopen.3proc
          +++ new/usr/src/man/man3proc/Preopen.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 PREOPEN 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Preopen
  19   19  .Nd reopen 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 Preopen
  25   26  .Fa "struct ps_prochandle *P"
  26   27  .Fc
  27   28  .Sh DESCRIPTION
  28   29  The
  29   30  .Fn Preopen
  30   31  function is used to regain control of the process represented by the
  31   32  handle

  32   33  .Fa P .
  33   34  A loss of control is indicated by the
  34   35  .Xr Pstatus 3PROC
  35   36  function returning the value
  36   37  .Dv PS_LOST .
  37   38  This may occur when the controlled process performs an
  38   39  .Xr exec 2
  39   40  of a setuid or setgid binary or one where the controlling process cannot
  40   41  read the object file.
  41   42  For more information on this, see the
  42   43  .Sy PROGRAMMING NOTES
  43   44  section of
  44   45  .Xr proc 4 .
  45   46  .Pp
  46   47  If successful, the controlling process will obtain control of the
  47   48  process specified by
  48   49  .Fa P .
  49   50  If it fails, the controlling process should release the handle with
  50   51  .Xr Prelease 3PROC .
  51   52  Note there are occasions where due to permissions it may not be possible
  52   53  to obtain control again.
  53   54  .Sh RETURN VALUES
  54   55  Upon successful completion, the
  55   56  .Fn Preopen
  56   57  function returns
  57   58  .Sy 0.
  58   59  Otherwise,
  59   60  .Sy -1
  60   61  is returned.
  61   62  .Sh INTERFACE STABILITY
  62   63  .Sy Uncommitted
  63   64  .Sh MT-LEVEL
  64   65  See
  65   66  .Sy LOCKING
  66   67  in
  67   68  .Xr libproc 3LIB .
  68   69  .Sh SEE ALSO
  69   70  .Xr exec 2 ,
  70   71  .Xr libproc 3LIB ,
  71   72  .Xr Prelease 3PROC ,
  72   73  .Xr Pstatus 3PROC ,
  73   74  .Xr proc 4

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX