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

          --- old/usr/src/man/man3proc/Puname.3proc
          +++ new/usr/src/man/man3proc/Puname.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 PUNAME 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Puname
  19   19  .Nd get uname information from 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 Puname
  25   26  .Fa "struct ps_prochandle *P"
  26   27  .Fa "struct utsname *u"
  27   28  .Fc
  28   29  .Sh DESCRIPTION
  29   30  The
  30   31  .Fn Puname
  31   32  function copies the operating system information from the process

  32   33  handle
  33   34  .Fa P
  34   35  into
  35   36  .Fa u .
  36   37  .Pp
  37   38  For an active process or zombie process, this is the same information
  38   39  obtained from
  39   40  .Xr uname 2 .
  40   41  For core files, if available, it is the system information at the time
  41   42  the core was dumped.
  42   43  .Pp
  43   44  Handles that correspond to ELF objects do not contain uname
  44   45  information.
  45   46  .Sh RETURN VALUES
  46   47  Upon successful completion, the
  47   48  .Fn Puname
  48   49  function returns
  49   50  .Sy 0
  50   51  and updates the information at
  51   52  .Fa u .
  52   53  Otherwise,
  53   54  .Sy -1
  54   55  is returned and
  55   56  .Sy errno
  56   57  is set to indicate the error.
  57   58  .Sh ERRORS
  58   59  The
  59   60  .Fn Puname
  60   61  function will fail if:
  61   62  .Bl -tag -width Er
  62   63  .It Er ENODATA
  63   64  .Fa P
  64   65  is a handle that corresponds to an ELF object or
  65   66  .Fa P
  66   67  is a handle that corresponds to a core file and that information is not
  67   68  available in the core file.
  68   69  .It Er EFAULT
  69   70  .Fa P
  70   71  is a handle that corresponds to an active process and
  71   72  .Fa u
  72   73  is a bad address.
  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 uname 1 ,
  83   84  .Xr uname 2 ,
  84   85  .Xr libproc 3LIB

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX