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

NAME

Pdelwapt - remove a watchpoint in a process

LIBRARY

Process Control Library (libproc, -lproc)

SYNOPSIS

#include <libproc.h>

int
Pdelwapt(struct ps_prochandle *P, const prwatch_t *wp);

DESCRIPTION

The Pdelwapt() function removes the watchpoint specified by wp from the
process represented by the handle P. The watchpoint should have been
installed with either Psetwapt(3PROC) or the underlying /proc file
system PCWATCH operation.

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

RETURN VALUES

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

ERRORS

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

The Pdelwapt() function will fail with:

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

INTERFACE STABILITY

Uncommitted

MT-LEVEL
See LOCKING in libproc(3LIB).

SEE ALSO

libproc(3LIB), Pcreate(3PROC), Pgrab(3PROC), Pgrab_core(3PROC),
Pgrab_file(3PROC), Psetwapt(3PROC), proc(5)

illumos May 11, 2016 illumos