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

          --- old/usr/src/man/man3proc/Pexecname.3proc
          +++ new/usr/src/man/man3proc/Pexecname.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 PEXECNAME 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Pexecname
  19   19  .Nd obtain full path to process executable
  20      -.Sh SYNOPSIS
       20 +.Sh LIBRARY
  21   21  .Lb libproc
       22 +.Sh SYNOPSIS
  22   23  .In libproc.h
  23   24  .Ft "char *"
  24   25  .Fo Pexecname
  25   26  .Fa "struct ps_prochandle *P"
  26   27  .Fa "char *buf"
  27   28  .Fa "size_t buflen"
  28   29  .Fc
  29   30  .Sh DESCRIPTION
  30   31  The
  31   32  .Fn Pexecname

  32   33  function attempts to determine the full path to the process executable
  33   34  referred to by the handle
  34   35  .Fa P .
  35   36  .Pp
  36   37  If found,
  37   38  .Fa buf
  38   39  will be filled in with the full path for up to
  39   40  .Fa buflen
  40   41  bytes, including the null terminator.
  41   42  .Pp
  42   43  For a handle grabbed with
  43   44  .Xr Pgrab_file 3PROC ,
  44   45  the executable refers to the path of the file itself.
  45   46  For a core file, the system attempts to determine the original path of the
  46   47  executable and return that.
  47   48  .Sh RETURN VALUES
  48   49  Upon successful completion, the
  49   50  .Fn Pexecname
  50   51  function returns the value of
  51   52  .Fa buf ,
  52   53  and up to
  53   54  .Fa buflen
  54   55  bytes of
  55   56  .Fa buf
  56   57  are filled in with a null-terminated path.
  57   58  Otherwise,
  58   59  .Dv NULL
  59   60  is returned.
  60   61  .Sh INTERFACE STABILITY
  61   62  .Sy Uncommitted
  62   63  .Sh MT-LEVEL
  63   64  See
  64   65  .Sy LOCKING
  65   66  in
  66   67  .Xr libproc 3LIB .
  67   68  .Sh SEE ALSO
  68   69  .Xr libproc 3LIB

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX