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

          --- old/usr/src/man/man3proc/Psetsysentry.3proc
          +++ new/usr/src/man/man3proc/Psetsysentry.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 PSETSYSENTRY 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Psetsysentry ,
  19   19  .Nm Psetsysexit
  20   20  .Nd set system call tracing flags
  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 Psetsysentry
  26   27  .Fa "struct ps_prochandle *P"
  27   28  .Fa "const sysset_t *set"
  28   29  .Fc
  29   30  .Ft void
  30   31  .Fo Psetsysexit
  31   32  .Fa "struct ps_prochandle *P"
  32   33  .Fa "const sysset_t *set"

  33   34  .Fc
  34   35  .Sh DESCRIPTION
  35   36  The
  36   37  .Fn Psetsysentry
  37   38  and
  38   39  .Fn Psetsysexit
  39   40  set the system call entry and exit tracing flags respectively in the
  40   41  process handle
  41   42  .Fa P
  42   43  to
  43   44  .Fa set .
  44   45  The call to
  45   46  .Fn Psetsysentry
  46   47  or
  47   48  .Fn Psetsysexit
  48   49  replaces the corresponding set of system call tracing flags entirely
  49   50  with the new set.
  50   51  The system call entry tracing flags cause a thread to stop on entry to the
  51   52  system call and the exit tracing flags cause a thread to stop on return from the
  52   53  system call, before control returns back to the user land process.
  53   54  For more information on the state of the thread and for information on
  54   55  manipulating the
  55   56  .Sy sysset_t ,
  56   57  see
  57   58  .Xr proc 4 .
  58   59  .Pp
  59   60  Note that only active processes may have their system call tracing flags
  60   61  updated.
  61   62  Process handles that refer to core files, zombie processes, and files do not
  62   63  have fault tracing flags and this function is a no-op on them.
  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 Intro 2 ,
  72   73  .Xr libproc 3LIB ,
  73   74  .Xr proc 4

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX