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 LIBRARY
  22 .Lb libproc
  23 .Sh SYNOPSIS
  24 .In libproc.h
  25 .Ft void
  26 .Fo Psetsysentry
  27 .Fa "struct ps_prochandle *P"
  28 .Fa "const sysset_t *set"
  29 .Fc
  30 .Ft void
  31 .Fo Psetsysexit
  32 .Fa "struct ps_prochandle *P"
  33 .Fa "const sysset_t *set"
  34 .Fc
  35 .Sh DESCRIPTION
  36 The
  37 .Fn Psetsysentry
  38 and
  39 .Fn Psetsysexit
  40 set the system call entry and exit tracing flags respectively in the
  41 process handle
  42 .Fa P
  43 to
  44 .Fa set .
  45 The call to
  46 .Fn Psetsysentry
  47 or
  48 .Fn Psetsysexit
  49 replaces the corresponding set of system call tracing flags entirely
  50 with the new set.
  51 The system call entry tracing flags cause a thread to stop on entry to the
  52 system call and the exit tracing flags cause a thread to stop on return from the
  53 system call, before control returns back to the user land process.
  54 For more information on the state of the thread and for information on
  55 manipulating the
  56 .Sy sysset_t ,
  57 see
  58 .Xr proc 4 .
  59 .Pp
  60 Note that only active processes may have their system call tracing flags
  61 updated.
  62 Process handles that refer to core files, zombie processes, and files do not
  63 have fault tracing flags and this function is a no-op on them.
  64 .Sh INTERFACE STABILITY
  65 .Sy Uncommitted
  66 .Sh MT-LEVEL
  67 See
  68 .Sy LOCKING
  69 in
  70 .Xr libproc 3LIB .
  71 .Sh SEE ALSO
  72 .Xr Intro 2 ,
  73 .Xr libproc 3LIB ,
  74 .Xr proc 4