xref: /illumos-gate/usr/src/man/man3proc/Pdelwapt.3proc (revision 43051d2742bbe5911de73322064cb573b6aff975)
1*43051d27SRobert Mustacchi.\"
2*43051d27SRobert Mustacchi.\" This file and its contents are supplied under the terms of the
3*43051d27SRobert Mustacchi.\" Common Development and Distribution License ("CDDL"), version 1.0.
4*43051d27SRobert Mustacchi.\" You may only use this file in accordance with the terms of version
5*43051d27SRobert Mustacchi.\" 1.0 of the CDDL.
6*43051d27SRobert Mustacchi.\"
7*43051d27SRobert Mustacchi.\" A full copy of the text of the CDDL should have accompanied this
8*43051d27SRobert Mustacchi.\" source.  A copy of the CDDL is also available via the Internet at
9*43051d27SRobert Mustacchi.\" http://www.illumos.org/license/CDDL.
10*43051d27SRobert Mustacchi.\"
11*43051d27SRobert Mustacchi.\"
12*43051d27SRobert Mustacchi.\" Copyright 2015 Joyent, Inc.
13*43051d27SRobert Mustacchi.\"
14*43051d27SRobert Mustacchi.Dd May 11, 2016
15*43051d27SRobert Mustacchi.Dt PDELWAPT 3PROC
16*43051d27SRobert Mustacchi.Os
17*43051d27SRobert Mustacchi.Sh NAME
18*43051d27SRobert Mustacchi.Nm Pdelwapt
19*43051d27SRobert Mustacchi.Nd remove a watchpoint in a process
20*43051d27SRobert Mustacchi.Sh SYNOPSIS
21*43051d27SRobert Mustacchi.Lb libproc
22*43051d27SRobert Mustacchi.In libproc.h
23*43051d27SRobert Mustacchi.Ft int
24*43051d27SRobert Mustacchi.Fo Pdelwapt
25*43051d27SRobert Mustacchi.Fa "struct ps_prochandle *P"
26*43051d27SRobert Mustacchi.Fa "const prwatch_t *wp"
27*43051d27SRobert Mustacchi.Fc
28*43051d27SRobert Mustacchi.Sh DESCRIPTION
29*43051d27SRobert MustacchiThe
30*43051d27SRobert Mustacchi.Fn Pdelwapt
31*43051d27SRobert Mustacchifunction removes the watchpoint specified by
32*43051d27SRobert Mustacchi.Fa wp
33*43051d27SRobert Mustacchifrom the process represented by the handle
34*43051d27SRobert Mustacchi.Fa P .
35*43051d27SRobert MustacchiThe watchpoint should have been installed with either
36*43051d27SRobert Mustacchi.Xr Psetwapt 3PROC
37*43051d27SRobert Mustacchior the underlying /proc file system
38*43051d27SRobert Mustacchi.Sy PCWATCH
39*43051d27SRobert Mustacchioperation.
40*43051d27SRobert Mustacchi.Pp
41*43051d27SRobert MustacchiThe
42*43051d27SRobert Mustacchi.Fn Pdelwapt
43*43051d27SRobert Mustacchifunction only works on running processes, such as those created through
44*43051d27SRobert Mustacchi.Xr Pgrab 3PROC
45*43051d27SRobert Mustacchiand
46*43051d27SRobert Mustacchi.Xr Pcreate 3PROC .
47*43051d27SRobert MustacchiAttempting to remove a watchpoint from process handles to core files,
48*43051d27SRobert Mustacchizombie processes, or ELF objects will fail.
49*43051d27SRobert Mustacchi.Sh RETURN VALUES
50*43051d27SRobert MustacchiUpon successful completion, the
51*43051d27SRobert Mustacchi.Fn Pdelwapt
52*43051d27SRobert Mustacchifunction removes the watchpoint and returns
53*43051d27SRobert Mustacchi.Sy 0 .
54*43051d27SRobert MustacchiOtherwise,
55*43051d27SRobert Mustacchi.Sy -1
56*43051d27SRobert Mustacchiis returned,
57*43051d27SRobert Mustacchi.Sy errno
58*43051d27SRobert Mustacchiis set to indicate the error.
59*43051d27SRobert Mustacchi.Sh ERRORS
60*43051d27SRobert MustacchiFor a full list of possible errors see the
61*43051d27SRobert Mustacchi.Sy DIAGNOSTICS
62*43051d27SRobert Mustacchisection in
63*43051d27SRobert Mustacchi.Xr proc 4 .
64*43051d27SRobert Mustacchi.Pp
65*43051d27SRobert MustacchiThe
66*43051d27SRobert Mustacchi.Fn Pdelwapt
67*43051d27SRobert Mustacchifunction will fail with:
68*43051d27SRobert Mustacchi.Bl -tag -width Er
69*43051d27SRobert Mustacchi.It Er ENOENT
70*43051d27SRobert MustacchiThe handle
71*43051d27SRobert Mustacchi.Fa P
72*43051d27SRobert Mustacchirefers to a grabbed core file, a zombie process, or an ELF object.
73*43051d27SRobert Mustacchi.El
74*43051d27SRobert Mustacchi.Sh INTERFACE STABILITY
75*43051d27SRobert Mustacchi.Sy Uncommitted
76*43051d27SRobert Mustacchi.Sh MT-LEVEL
77*43051d27SRobert MustacchiSee
78*43051d27SRobert Mustacchi.Sy LOCKING
79*43051d27SRobert Mustacchiin
80*43051d27SRobert Mustacchi.Xr libproc 3LIB .
81*43051d27SRobert Mustacchi.Sh SEE ALSO
82*43051d27SRobert Mustacchi.Xr libproc 3LIB ,
83*43051d27SRobert Mustacchi.Xr Pcreate 3PROC ,
84*43051d27SRobert Mustacchi.Xr Pgrab 3PROC ,
85*43051d27SRobert Mustacchi.Xr Pgrab_core 3PROC ,
86*43051d27SRobert Mustacchi.Xr Pgrab_file 3PROC ,
87*43051d27SRobert Mustacchi.Xr Psetwapt 3PROC ,
88*43051d27SRobert Mustacchi.Xr proc 4
89