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.
  50 The system call entry tracing flags cause a thread to stop on entry to the
  51 system call and the exit tracing flags cause a thread to stop on return from the
  52 system call, before control returns back to the user land process.
  53 For more information on the state of the thread and for information on
  54 manipulating the
  55 .Sy sysset_t ,
  56 see
  57 .Xr proc 4 .
  58 .Pp
  59 Note that only active processes may have their system call tracing flags
  60 updated.
  61 Process handles that refer to core files, zombie processes, and files do not
  62 have fault tracing flags and this function is a no-op on them.
  63 .Sh INTERFACE STABILITY
  64 .Sy Uncommitted
  65 .Sh MT-LEVEL
  66 See
  67 .Sy LOCKING
  68 in
  69 .Xr libproc 3LIB .
  70 .Sh SEE ALSO
  71 .Xr Intro 2 ,
  72 .Xr libproc 3LIB ,
  73 .Xr proc 4