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 run a stopped process or thread
27 .Fa "struct ps_prochandle *P"
33 .Fa "struct ps_lwphandle *L"
40 function resumes the stopped process handle
42 and transitions the process to running.
47 function causes the signal to be delivered.
50 for a list of valid signal identifiers.
54 member modifies the behavior of the resumed handle.
55 The following values may be combined by a bitwise-inclusive-OR:
56 .Bl -tag -width Dv -offset indent
58 Clears the current signal, if any.
60 Clears the current fault, if any.
62 Indicates that the thread should single-step over the next machine
63 instruction and upon completion, inject a trap.
64 For the specific mechanics of single-stepping and what traps or signals will be
70 Indicates that the thread should abort the system call that it is
72 This is only valid if the thread is stopped because it is asleep or right before
74 This will cause the system call to return
85 request takes priority, and it will be treated as though
87 was passed the argument
90 When the process is resumed all extent tracing flags and register
91 changes will be synchronized with the process.
92 For more information on resuming a thread see the
99 function is only valid for active processes.
100 It will fail on process handles that refer to core files, zombie processes, and
105 function is equivalent to the
107 function, except rather than operating on a process it operates on a
110 causes the specified thread,
115 causes all threads in the process to resume.
117 Upon successful completion, the
127 is set to indicate the error.
129 For a full list of possible errors see the
138 functions will fail if:
143 is not currently stopped or it is not stopped due to an event of
144 interest, a directed stop, or it is asleep in a system call.
146 .Sh INTERFACE STABILITY