usr/src/man/man3proc/Psetsysentry.3proc

   1 .\"
   2 .\" This file and its contents are supplied under the terms of the
   3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4 .\" You may only use this file in accordance with the terms of version
   5 .\" 1.0 of the CDDL.
   6 .\"
   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\"
  12 .\" Copyright 2015 Joyent, Inc.
  13 .\"
  14 .Dd May 11, 2016
  15 .Dt PSETSYSENTRY 3PROC
  16 .Os
  17 .Sh NAME
  18 .Nm Psetsysentry ,
  19 .Nm Psetsysexit
  20 .Nd set system call tracing flags
  21 .Sh SYNOPSIS
  22 .Lb libproc
  23 .In libproc.h
  24 .Ft void
  25 .Fo Psetsysentry
  26 .Fa "struct ps_prochandle *P"
  27 .Fa "const sysset_t *set"
  28 .Fc
  29 .Ft void
  30 .Fo Psetsysexit
  31 .Fa "struct ps_prochandle *P"
  32 .Fa "const sysset_t *set"
  33 .Fc
  34 .Sh DESCRIPTION
  35 The
  36 .Fn Psetsysentry
  37 and
  38 .Fn Psetsysexit
  39 set the system call entry and exit tracing flags respectively in the
  40 process handle
  41 .Fa P
  42 to
  43 .Fa set .
  44 The call to
  45 .Fn Psetsysentry
  46 or
  47 .Fn Psetsysexit
  48 replaces the corresponding set of system call tracing flags entirely
  49 with the new set. The system call entry tracing flags cause a thread to
  50 stop on entry to the system call and the exit tracing flags cause a
  51 thread to stop on return from the system call, before control returns
  52 back to the user land process. For more information on the state of the
  53 thread and for information on manipulating the
  54 .Sy sysset_t ,
  55 see
  56 .Xr proc 4 .
  57 .Pp
  58 Note that only active processes may have their system call tracing flags
  59 updated.  Process handles that refer to core files, zombie processes,
  60 and files do not have fault tracing flags and this function is a no-op
  61 on them.
  62 .Sh INTERFACE STABILITY
  63 .Sy Uncommitted
  64 .Sh MT-LEVEL
  65 See
  66 .Sy LOCKING
  67 in
  68 .Xr libproc 3LIB .
  69 .Sh SEE ALSO
  70 .Xr Intro 2 ,
  71 .Xr libproc 3LIB ,
  72 .Xr proc 4