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 */