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

          --- old/usr/src/man/man3proc/Pupdate_syms.3proc
          +++ new/usr/src/man/man3proc/Pupdate_syms.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 PUPDATE_SYMS 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Pupdate_syms
  19   19  .Nd update cached symbol tables
  20      -.Sh SYNOPSIS
       20 +.Sh LIBRARY
  21   21  .Lb libproc
       22 +.Sh SYNOPSIS
  22   23  .In libproc.h
  23   24  .Ft void
  24   25  .Fo Pupdate_syms
  25   26  .Fa "struct ps_prochandle *P"
  26   27  .Fc
  27   28  .Sh DESCRIPTION
  28   29  The
  29   30  .Fn Pupdate_syms
  30   31  function is used to update all of the cached symbol tables in the
  31   32  process handle

  32   33  .Fa P :
  33   34  updating, invalidating, and caching new symbol tables as appropriate for
  34   35  functions such as
  35   36  .Xr Psymbol_iter 3PROC .
  36   37  This is generally called in response to activity by the run-time
  37   38  link-editor.
  38   39  In general, the
  39   40  .Sy libproc
  40   41  library takes care of managing the need to call this function;
  41   42  however, debuggers, introspection tools, and others that are
  42   43  interposing on rtld activity may need to call this function.
  43   44  Note that the
  44   45  .Fn Pupdate_syms
  45   46  function is only meaningful for active processes.
  46   47  It will do nothing on process handles that refer to core files, zombie
  47   48  processes, and ELF objects.
  48   49  .Sh INTERFACE STABILITY
  49   50  .Sy Uncommitted
  50   51  .Sh MT-LEVEL
  51   52  See
  52   53  .Sy LOCKING
  53   54  in
  54   55  .Xr libproc 3LIB .
  55   56  .Sh SEE ALSO
  56   57  .Xr libproc 3LIB ,
  57   58  .Xr Pupdate_maps 3PROC

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX