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

          --- old/usr/src/man/man3proc/Psync.3proc
          +++ new/usr/src/man/man3proc/Psync.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 PSYNC 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Psync ,
  19   19  .Nm Lsync
  20   20  .Nd synchronize cached tracing flags and modifications
  21      -.Sh SYNOPSIS
       21 +.Sh LIBRARY
  22   22  .Lb libproc
       23 +.Sh SYNOPSIS
  23   24  .In libproc.h
  24   25  .Ft void
  25   26  .Fo Psync
  26   27  .Fa "struct ps_prochandle *P"
  27   28  .Fc
  28   29  .Ft void
  29   30  .Fo Lsync
  30   31  .Fa "struct ps_lwphandle *L"
  31   32  .Fc
  32   33  .Sh DESCRIPTION

  33   34  The
  34   35  .Fn Psync
  35   36  function synchronizes modifications to the process handle
  36   37  .Fa P
  37   38  back to the underlying active process.
  38   39  The
  39   40  .Fn Psync
  40   41  function ensures that any outstanding process holds, register
  41   42  modifications, signal injections, and modifications to the various fault
  42   43  and system call tracing flags are taken care of.
  43   44  .Pp
  44   45  Normally this function is not required as other library routines take
  45   46  care of synchronizing this state out to the process when it is required.
  46   47  If the underlying /proc file system routines are used outside of the
  47   48  library, calling this function may be required.
  48   49  .Pp
  49   50  The
  50   51  .Fn Psync
  51   52  function is only meaningful for active processes.
  52   53  It will do nothing on process handles that refer to core files, zombie
  53   54  processes, and ELF objects.
  54   55  .Pp
  55   56  The
  56   57  .Fn Lsync
  57   58  function is equivalent to the
  58   59  .Fn Psync
  59   60  function, except rather than operating on the entire process and its
  60   61  representative thread, it instead operates on the thread handle
  61   62  .Fa L .
  62   63  .Sh INTERFACE STABILITY
  63   64  .Sy Uncommitted
  64   65  .Sh MT-LEVEL
  65   66  See
  66   67  .Sy LOCKING
  67   68  in
  68   69  .Xr libproc 3LIB .
  69   70  .Sh SEE ALSO
  70   71  .Xr libproc 3LIB ,
  71   72  .Xr Pfault 3PROC ,
  72   73  .Xr Pputareg 3PROC ,
  73   74  .Xr Psetfault 3PROC ,
  74   75  .Xr Psetsignal 3PROC ,
  75   76  .Xr Psetsysentry 3PROC ,
  76   77  .Xr Psetsysexit 3PROC ,
  77   78  .Xr Psignal 3PROC ,
  78   79  .Xr Psysentry 3PROC ,
  79   80  .Xr Psysexit 3PROC ,
  80   81  .Xr proc 4

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX