2 .\" This file and its contents are supplied under the terms of the
3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
4 .\" You may only use this file in accordance with the terms of version
7 .\" A full copy of the text of the CDDL should have accompanied this
8 .\" source. A copy of the CDDL is also available via the Internet at
9 .\" http://www.illumos.org/license/CDDL.
12 .\" Copyright 2015 Joyent, Inc.
19 .Nd clear a breakpoint in a process
26 .Fa "struct ps_prochandle *P"
27 .Fa "uintptr_t address"
33 function removes the breakpoint installed at
37 Restoring the instruction present in
42 is no longer the architecture-specific breakpoint instruction, then
44 is not restored, but the function still returns successfully.
45 This behavior is done due to the presence of setting breakpoints in
46 self-modifying code, e.g. procedure linkage tables.
50 function only works on running processes, such as those created through
54 Attempting to remove a breakpoint from process handles to core files,
55 zombie processes, or ELF objects will fail.
57 Upon successful completion, the
59 function removes the breakpoint and
66 is set to indicate the error.
68 For a full list of possible errors see the
75 function will fail with:
80 refers to a grabbed core file, a zombie process, or an ELF object.
82 .Sh INTERFACE STABILITY
93 .Xr Pgrab_core 3PROC ,
94 .Xr Pgrab_file 3PROC ,