1 .\" Copyright (c) 2000 Brian S. Dean
2 .\" All rights reserved.
4 .\" This man-page is based on a similar man-page by Jonathan Lemon
5 .\" which is copyrighted under the following conditions:
7 .\" Redistribution and use in source and binary forms, with or without
8 .\" modification, are permitted provided that the following conditions
10 .\" 1. Redistributions of source code must retain the above copyright
11 .\" notice, this list of conditions and the following disclaimer.
12 .\" 2. Redistributions in binary form must reproduce the above copyright
13 .\" notice, this list of conditions and the following disclaimer in the
14 .\" documentation and/or other materials provided with the distribution.
16 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36 .Nd manage i386 debug register values
43 .Fn i386_clr_watch "int watchnum" "struct dbreg *d"
45 .Fn i386_set_watch "int watchnum" "unsigned int watchaddr" "int size" "int access" "struct dbreg *d"
50 will disable the indicated watch point within the specified debug
56 will set up the specified debug registers as indicated by the
60 argument specifies which watch register is used, 0, 1, 2, 3, or \-1.
63 is \-1, a free watch register is found and used.
65 watch registers, an error code of \-1 is returned.
69 specifies the watch address,
71 specifies the size in bytes of the area to be watched (1, 2, or 4 bytes),
74 specifies the type of watch point:
76 .Bd -literal -offset indent -compact
77 DBREG_DR7_EXEC An execution breakpoint.
78 DBREG_DR7_WRONLY Break only when the watch area is written to.
79 DBREG_DR7_RDWR Break when the watch area is read from or written
83 Note that these functions do not actually set or clear breakpoints;
84 they manipulate the indicated debug register set.
87 to retrieve and install the debug register values for a process.
92 On error, \-1 returned which indicates that
94 is invalid (not in the range of 0-3).
95 If the specified watchnum was already disabled, no error is returned.
101 argument, or the watchnum actually used in the case where the specified
106 function returns \-1 indicating that the watchpoint could not established
107 because either no more watchpoints are available, or
117 This man page was written by