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