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

          --- old/usr/src/man/man3proc/Pasfd.3proc
          +++ new/usr/src/man/man3proc/Pasfd.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 PASFD 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Pasfd
  19   19  .Nd obtain the process address space 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 Pasfd
  25   26  .Fa "struct ps_prochandle *P"
  26   27  .Fc
  27   28  .Sh DESCRIPTION
  28   29  The
  29   30  .Fn Pasfd
  30   31  funtion returns a file descriptor that allows direct access to the
  31   32  address space of the process handle

  32   33  .Fa P .
  33   34  A defined file descriptor is provided when using the
  34   35  .Xr Pcreate 3PROC ,
  35   36  .Xr Pgrab 3PROC ,
  36   37  .Xr Pgrab_file 3PROC ,
  37   38  and
  38   39  .Xr Pgrab_core 3PROC
  39   40  functions.
  40   41  Note that the address space may be different in each of these cases and doesn't
  41   42  necessarily correspond to the /proc
  42   43  .Sy as
  43   44  file, except for live processes.
  44   45  Other means of obtaining a
  45   46  .Sy libproc
  46   47  process handle may not define a file descriptor that contains the
  47   48  address space.
  48   49  .Pp
  49   50  The returned file descriptor must not be closed and is only valid for
  50   51  as long as the corresponding process handle
  51   52  .Fa P
  52   53  is valid.
  53   54  After a call to
  54   55  .Xr Prelease 3PROC
  55   56  the file descriptor is invalidated.
  56   57  .Sh RETURN VALUES
  57   58  Upon successful completion, the
  58   59  .Fn Pasfd
  59   60  function returns a valid file descriptor.
  60   61  Otherwise, if none exists, then
  61   62  .Sy -1
  62   63  is returned.
  63   64  .Sh INTERFACE STABILITY
  64   65  .Sy Uncommitted
  65   66  .Sh MT-LEVEL
  66   67  See
  67   68  .Sy LOCKING
  68   69  in
  69   70  .Xr libproc 3LIB .
  70   71  .Sh SEE ALSO
  71   72  .Xr libproc 3LIB ,
  72   73  .Xr Pcreate 3PROC ,
  73   74  .Xr Pgrab 3PROC ,
  74   75  .Xr Pgrab_core 3PROC ,
  75   76  .Xr Pgrab_file 3PROC ,
  76   77  .Xr Prelease 3PROC ,
  77   78  .Xr proc 4

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX