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
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.
12 .\" Copyright 2015 Joyent, Inc.
20 .Nd set system call entry and exit actions
27 .Fa "struct ps_prochandle *P"
33 .Fa "struct ps_prochandle *P"
42 functions controls what actions the process handle
44 should take upon executing a system call.
46 The system allows a process to be stopped on both entry and exit of a
48 For information on the state of the process when it is stopped due to system
58 parameter controls whether or not the system call listed in
60 causes the process to stop.
61 A value of non-zero indicates the process should stop;
62 a value of 0 indicates it should not.
66 indicates which system call the change applies to.
67 A value of 0 applies to all system calls.
68 Note, the system does not supply a stable mapping from system call names to
71 These functions only apply to actively running processes.
72 They do not function on handles that refer to core files, zombie processes,
75 Upon successful completion, the
79 functions return the previous disposition of the system call --
81 if it was not set to stop and
84 and the system call state is updated.
89 is updated with the error that occurred, and the system call state is
96 functions will fail if:
101 is invalid, e.g. it is less than zero or greater than the largest defined
106 refers to a process that is a zombie, a core file, or an ELF object.
108 .Sh INTERFACE STABILITY
115 functions are uncommitted, the mapping of system calls to system call
118 and may change at any time.