PSETRUN(3PROC) Process Control Library Functions PSETRUN(3PROC)
NAME
Psetrun,
Lsetrun - run a stopped process or thread
LIBRARY
Process Control Library (libproc, -lproc)
SYNOPSIS
#include <libproc.h> int Psetrun(
struct ps_prochandle *P,
int sig,
int flags);
int Lsetrun(
struct ps_lwphandle *L,
int sig,
int flags);
DESCRIPTION
The
Psetrun() function resumes the stopped process handle
P and
transitions the process to running. If
sig is non-zero, then the
Psetrun() function causes the signal to be delivered. See
signal.h(3HEAD) for a list of valid signal identifiers.
The
flags member modifies the behavior of the resumed handle. The
following values may be combined by a bitwise-inclusive-OR:
PRCSIG Clears the current signal, if any.
PRCFAULT Clears the current fault, if any.
PRSTEP Indicates that the thread should single-step over
the next machine instruction and upon completion,
inject a trap. For the specific mechanics of
single-stepping and what traps or signals will be
injected, see the
PRSTEP section of
proc(5).
PRSABORT Indicates that the thread should abort the system
call that it is currently executing. This is only
valid if the thread is stopped because it is asleep
or right before a system call. This will cause the
system call to return EINTR.
If both PRCSIG is specified and
sig is non-zero, then the PRCSIG
request takes priority, and it will be treated as though
sig was passed
the argument
0.
When the process is resumed all extent tracing flags and register
changes will be synchronized with the process. For more information on
resuming a thread see the
PCRUN section in
proc(5).
Note, the
Psetrun() function is only valid for active processes. It
will fail on process handles that refer to core files, zombie
processes, and ELF objects.
The
Lsetrun() function is equivalent to the
Psetrun() function, except
rather than operating on a process it operates on a thread.
Lsetrun()
causes the specified thread,
L, to resume execution. Whereas
Psetrun()
causes all threads in the process to resume.
RETURN VALUES
Upon successful completion, the
Psetrun() and
Lsetrun() functions
return
0. Otherwise,
-1 is returned and
errno is set to indicate the
error.
ERRORS
For a full list of possible errors see the
DIAGNOSTICS section in
proc(5).
The
Psetrun() and
Lsetrun() functions will fail if:
EBUSY The process handle
P is not currently stopped or it
is not stopped due to an event of interest, a
directed stop, or it is asleep in a system call.
INTERFACE STABILITY
UncommittedMT-LEVEL See
LOCKING in
libproc(3LIB).
SEE ALSO
signal.h(3HEAD),
libproc(3LIB),
Pstatus(3PROC),
proc(5)illumos May 11, 2016 illumos
