1.\"
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
5.\" 1.0 of the CDDL.
6.\"
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.
10.\"
11.\"
12.\" Copyright 2015 Joyent, Inc.
13.\"
14.Dd May 11, 2016
15.Dt PDELWAPT 3PROC
16.Os
17.Sh NAME
18.Nm Pdelwapt
19.Nd remove a watchpoint in a process
20.Sh LIBRARY
21.Lb libproc
22.Sh SYNOPSIS
23.In libproc.h
24.Ft int
25.Fo Pdelwapt
26.Fa "struct ps_prochandle *P"
27.Fa "const prwatch_t *wp"
28.Fc
29.Sh DESCRIPTION
30The
31.Fn Pdelwapt
32function removes the watchpoint specified by
33.Fa wp
34from the process represented by the handle
35.Fa P .
36The watchpoint should have been installed with either
37.Xr Psetwapt 3PROC
38or the underlying /proc file system
39.Sy PCWATCH
40operation.
41.Pp
42The
43.Fn Pdelwapt
44function only works on running processes, such as those created through
45.Xr Pgrab 3PROC
46and
47.Xr Pcreate 3PROC .
48Attempting to remove a watchpoint from process handles to core files,
49zombie processes, or ELF objects will fail.
50.Sh RETURN VALUES
51Upon successful completion, the
52.Fn Pdelwapt
53function removes the watchpoint and returns
54.Sy 0 .
55Otherwise,
56.Sy -1
57is returned,
58.Sy errno
59is set to indicate the error.
60.Sh ERRORS
61For a full list of possible errors see the
62.Sy DIAGNOSTICS
63section in
64.Xr proc 5 .
65.Pp
66The
67.Fn Pdelwapt
68function will fail with:
69.Bl -tag -width Er
70.It Er ENOENT
71The handle
72.Fa P
73refers to a grabbed core file, a zombie process, or an ELF object.
74.El
75.Sh INTERFACE STABILITY
76.Sy Uncommitted
77.Sh MT-LEVEL
78See
79.Sy LOCKING
80in
81.Xr libproc 3LIB .
82.Sh SEE ALSO
83.Xr libproc 3LIB ,
84.Xr Pcreate 3PROC ,
85.Xr Pgrab 3PROC ,
86.Xr Pgrab_core 3PROC ,
87.Xr Pgrab_file 3PROC ,
88.Xr Psetwapt 3PROC ,
89.Xr proc 5
90