PDELBKPT(3PROC) Process Control Library Functions PDELBKPT(3PROC)

Pdelbkpt —
clear a breakpoint in a process

Process Control Library (libproc, -lproc)

#include <libproc.h>

int
Pdelbkpt(struct ps_prochandle *P, uintptr_t address, ulong_t saved);

The Pdelbkpt() function removes the breakpoint installed at address from process P. Restoring the instruction present in saved.

If the instruction at address is no longer the architecture-specific breakpoint instruction, then saved is not restored, but the function still returns successfully. This behavior is done due to the presence of setting breakpoints in self-modifying code, e.g. procedure linkage tables.

The Pdelbkpt() function only works on running processes, such as those created through Pgrab(3PROC) and Pcreate(3PROC). Attempting to remove a breakpoint from process handles to core files, zombie processes, or ELF objects will fail.

Upon successful completion, the Pdelbkpt() function removes the breakpoint and returns 0. Otherwise, -1 is returned, and errno is set to indicate the error.

For a full list of possible errors see the DIAGNOSTICS section in proc(5).

The Pdelbkpt() function will fail with:

The handle P refers to a grabbed core file, a zombie process, or an ELF object.

Uncommitted

See LOCKING in libproc(3LIB).

libproc(3LIB), Pcreate(3PROC), Pgrab(3PROC), Pgrab_core(3PROC), Pgrab_file(3PROC), Psetbkpt(3PROC), proc(5)
May 11, 2016 OmniOS