Print this page
8158 Want named threads API
9857 proc manpages should have LIBRARY section
Split |
Close |
Expand all |
Collapse all |
--- old/usr/src/man/man3proc/Pdelbkpt.3proc.man.txt
+++ new/usr/src/man/man3proc/Pdelbkpt.3proc.man.txt
1 1 PDELBKPT(3PROC) Process Control Library Functions PDELBKPT(3PROC)
2 2
3 3 NAME
4 4 Pdelbkpt - clear a breakpoint in a process
5 5
6 -SYNOPSIS
6 +LIBRARY
7 7 Process Control Library (libproc, -lproc)
8 +
9 +SYNOPSIS
8 10 #include <libproc.h>
9 11
10 12 int
11 13 Pdelbkpt(struct ps_prochandle *P, uintptr_t address, ulong_t saved);
12 14
13 15 DESCRIPTION
14 16 The Pdelbkpt() function removes the breakpoint installed at address from
15 17 process P. Restoring the instruction present in saved.
16 18
17 19 If the instruction at address is no longer the architecture-specific
18 20 breakpoint instruction, then saved is not restored, but the function
19 21 still returns successfully. This behavior is done due to the presence of
20 22 setting breakpoints in self-modifying code, e.g. procedure linkage
21 23 tables.
22 24
23 25 The Pdelbkpt() function only works on running processes, such as those
24 26 created through Pgrab(3PROC) and Pcreate(3PROC). Attempting to remove a
25 27 breakpoint from process handles to core files, zombie processes, or ELF
26 28 objects will fail.
27 29
28 30 RETURN VALUES
29 31 Upon successful completion, the Pdelbkpt() function removes the
30 32 breakpoint and returns 0. Otherwise, -1 is returned, and errno is set to
31 33 indicate the error.
32 34
33 35 ERRORS
34 36 For a full list of possible errors see the DIAGNOSTICS section in
35 37 proc(4).
36 38
37 39 The Pdelbkpt() function will fail with:
38 40
39 41 ENOENT The handle P refers to a grabbed core file, a zombie
40 42 process, or an ELF object.
41 43
42 44 INTERFACE STABILITY
43 45 Uncommitted
44 46
45 47 MT-LEVEL
46 48 See LOCKING in libproc(3LIB).
47 49
48 50 SEE ALSO
49 51 libproc(3LIB), Pcreate(3PROC), Pgrab(3PROC), Pgrab_core(3PROC),
50 52 Pgrab_file(3PROC), Psetbkpt(3PROC), proc(4)
51 53
52 54 illumos May 11, 2016 illumos
↓ open down ↓ |
35 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX