PXECBKPT(3PROC) Process Control Library Functions PXECBKPT(3PROC)
NAME
Pxecbkpt,
Pxecwapt,
Lxecbkpt,
Lxecwapt - step over a breakpoint or
watchpoint
LIBRARY
Process Control Library (libproc, -lproc)
SYNOPSIS
#include <libproc.h> int Pxecbkpt(
struct ps_prochandle *P,
ulong_t saved);
int Pxecwapt(
struct ps_prochandle *P,
ulong_t saved);
int Lxecbkpt(
struct ps_lwphandle *L,
ulong_t saved);
int Lxecwapt(
struct ps_lwphandle *L,
ulong_t saved);
DESCRIPTION
The
Pxecbkpt() and
Pxecwapt() functions step over a breakpoint or
watchpoint respectively in the corresponding process handle
P. The
functions execute the original instruction that was at the current program
counter, provided by
saved, and then leave the process stopped at the next
instruction.
The process must be stopped at the time that the
Pxecbkpt() or
Pxecwapt()
functions are called.
The
Lxecbkpt() and
Lxecwapt() functions are identical to
Pxecbkpt() and
Pxecwapt(), respectively; except rather than operating on the process as a
whole, they operate on the thread handle
L. These functions only require
that the thread represented by
L be stopped and not the entire process.
RETURN VALUES
Upon successful completion, the
Pxecbkpt(),
Pxecwapt(),
Lxecbkpt(), and
Lxecwapt() functions return
0 having executed the original instruction at
saved. Otherwise,
-1 is returned and
errno is set to indicate the error.
ERRORS
For a full list of errors see the
DIAGNOSTICS section in
proc(5). The
Pxecbkpt(),
Pxecwapt(),
Lxecbkpt(), and
Lxecwapt() functions will fail if:
EBUSY Either
P or
L is not stopped.
INTERFACE STABILITY
UncommittedMT-LEVEL See
LOCKING in
libproc(3LIB).
SEE ALSO
libproc(3LIB),
Pdelbkpt(3PROC),
Pdelwapt(3PROC),
Psetbkpt(3PROC),
Psetwapt(3PROC),
proc(5)illumos November 27, 2023 illumos