Commit | Line | Data |
---|---|---|
9bb9e8ad PM |
1 | /* Native-dependent code for the i386. |
2 | ||
3 | Low level functions to implement Oeprating System specific | |
4 | code to manipulate I386 debug registers. | |
5 | ||
7b6bb8da | 6 | Copyright (C) 2009, 2010, 2011 Free Software Foundation, Inc. |
9bb9e8ad PM |
7 | |
8 | This file is part of GDB. | |
9 | ||
10 | This program is free software; you can redistribute it and/or modify | |
11 | it under the terms of the GNU General Public License as published by | |
12 | the Free Software Foundation; either version 3 of the License, or | |
13 | (at your option) any later version. | |
14 | ||
15 | This program is distributed in the hope that it will be useful, | |
16 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
17 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
18 | GNU General Public License for more details. | |
19 | ||
20 | You should have received a copy of the GNU General Public License | |
21 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ | |
22 | ||
23 | #include "defs.h" | |
24 | ||
25 | #ifndef I386_NAT_H | |
26 | #define I386_NAT_H 1 | |
27 | ||
28 | /* Hardware-assisted breakpoints and watchpoints. */ | |
29 | ||
30 | /* Add watchpoint methods to the provided target_ops. | |
31 | Targets using i386 family debug registers for watchpoints should call | |
32 | this. */ | |
33 | struct target_ops; | |
34 | extern void i386_use_watchpoints (struct target_ops *); | |
35 | ||
36 | /* Support for hardware watchpoints and breakpoints using the i386 | |
37 | debug registers. | |
38 | ||
39 | This provides several functions for inserting and removing | |
40 | hardware-assisted breakpoints and watchpoints, testing if one or | |
41 | more of the watchpoints triggered and at what address, checking | |
42 | whether a given region can be watched, etc. | |
43 | ||
44 | In addition, each target should provide several low-level functions | |
1777feb0 | 45 | regrouped into i386_dr_low_type struct below. These functions |
9bb9e8ad PM |
46 | that will be called to insert watchpoints and hardware breakpoints |
47 | into the inferior, remove them, and check their status. These | |
48 | functions are: | |
49 | ||
50 | set_control -- set the debug control (DR7) | |
a79d3c27 | 51 | register to a given value for all LWPs |
9bb9e8ad PM |
52 | |
53 | set_addr -- put an address into one debug | |
a79d3c27 | 54 | register for all LWPs |
9bb9e8ad PM |
55 | |
56 | reset_addr -- reset the address stored in | |
a79d3c27 | 57 | one debug register for all LWPs |
9bb9e8ad PM |
58 | |
59 | get_status -- return the value of the debug | |
a79d3c27 JK |
60 | status (DR6) register for current LWP |
61 | ||
62 | unset_status -- unset the specified bits of the debug | |
63 | status (DR6) register for all LWPs | |
9bb9e8ad PM |
64 | |
65 | Additionally, the native file should set the debug_register_length | |
66 | field to 4 or 8 depending on the number of bytes used for | |
67 | deubg registers. */ | |
68 | ||
69 | struct i386_dr_low_type | |
70 | { | |
71 | void (*set_control) (unsigned long); | |
72 | void (*set_addr) (int, CORE_ADDR); | |
73 | void (*reset_addr) (int); | |
74 | unsigned long (*get_status) (void); | |
a79d3c27 | 75 | void (*unset_status) (unsigned long); |
9bb9e8ad PM |
76 | int debug_register_length; |
77 | }; | |
78 | ||
79 | extern struct i386_dr_low_type i386_dr_low; | |
80 | ||
81 | /* Use this function to set i386_dr_low debug_register_length field | |
82 | rather than setting it directly to check that the length is only | |
83 | set once. It also enables the 'maint set/show show-debug-regs' | |
84 | command. */ | |
85 | ||
86 | extern void i386_set_debug_register_length (int len); | |
87 | ||
88 | /* Use this function to reset the i386-nat.c debug register state. */ | |
89 | ||
90 | extern void i386_cleanup_dregs (void); | |
91 | ||
92 | #endif /* I386_NAT_H */ |