[deliverable/binutils-gdb.git] / gdb / i386-nat.h

/* Native-dependent code for the i386.

   Low level functions to implement Oeprating System specific
   code to manipulate I386 debug registers.

   Copyright (C) 2009-2013 Free Software Foundation, Inc.

   This file is part of GDB.

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 3 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program.  If not, see <http://www.gnu.org/licenses/>.  */

#ifndef I386_NAT_H
#define I386_NAT_H 1

/* Hardware-assisted breakpoints and watchpoints.  */

/* Add watchpoint methods to the provided target_ops.  
   Targets using i386 family debug registers for watchpoints should call
   this.  */
struct target_ops;
extern void i386_use_watchpoints (struct target_ops *);

/* Support for hardware watchpoints and breakpoints using the i386
   debug registers.

   This provides several functions for inserting and removing
   hardware-assisted breakpoints and watchpoints, testing if one or
   more of the watchpoints triggered and at what address, checking
   whether a given region can be watched, etc.

   In addition, each target should provide several low-level functions
   regrouped into i386_dr_low_type struct below.  These functions
   that will be called to insert watchpoints and hardware breakpoints
   into the inferior, remove them, and check their status.  These
   functions are:

      set_control              -- set the debug control (DR7)
				  register to a given value for all LWPs

      set_addr                 -- put an address into one debug
				  register for all LWPs

      get_addr                 -- return the address in a given debug
				  register of the current LWP

      get_status               -- return the value of the debug
				  status (DR6) register for current LWP

      get_control               -- return the value of the debug
				  control (DR7) register for current LWP

   Additionally, the native file should set the debug_register_length
   field to 4 or 8 depending on the number of bytes used for
   deubg registers.  */

struct i386_dr_low_type
  {
    void (*set_control) (unsigned long);
    void (*set_addr) (int, CORE_ADDR);
    CORE_ADDR (*get_addr) (int);
    unsigned long (*get_status) (void);
    unsigned long (*get_control) (void);
    int debug_register_length;
  };

extern struct i386_dr_low_type i386_dr_low;

/* Debug registers' indices.  */
#define DR_FIRSTADDR 0
#define DR_LASTADDR  3
#define DR_NADDR     4	/* The number of debug address registers.  */
#define DR_STATUS    6	/* Index of debug status register (DR6).  */
#define DR_CONTROL   7	/* Index of debug control register (DR7).  */

/* Global state needed to track h/w watchpoints.  */

struct i386_debug_reg_state
{
  /* Mirror the inferior's DRi registers.  We keep the status and
     control registers separated because they don't hold addresses.
     Note that since we can change these mirrors while threads are
     running, we never trust them to explain a cause of a trap.
     For that, we need to peek directly in the inferior registers.  */
  CORE_ADDR dr_mirror[DR_NADDR];
  unsigned dr_status_mirror, dr_control_mirror;

  /* Reference counts for each debug register.  */
  int dr_ref_count[DR_NADDR];
};

/* Use this function to set i386_dr_low debug_register_length field
   rather than setting it directly to check that the length is only
   set once.  It also enables the 'maint set/show show-debug-regs' 
   command.  */

extern void i386_set_debug_register_length (int len);

/* Use this function to reset the i386-nat.c debug register state.  */

extern void i386_cleanup_dregs (void);

/* Return a pointer to the local mirror of the debug registers of
   process PID.  */

extern struct i386_debug_reg_state *i386_debug_reg_state (pid_t pid);

/* Called whenever GDB is no longer debugging process PID.  It deletes
   data structures that keep track of debug register state.  */

extern void i386_forget_process (pid_t pid);

#endif /* I386_NAT_H */
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
28e7fd62	6	Copyright (C) 2009-2013 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
9bb9e8ad PM	23	#ifndef I386_NAT_H
	24	#define I386_NAT_H 1
	25
	26	/* Hardware-assisted breakpoints and watchpoints. */
	27
	28	/* Add watchpoint methods to the provided target_ops.
	29	Targets using i386 family debug registers for watchpoints should call
	30	this. */
	31	struct target_ops;
	32	extern void i386_use_watchpoints (struct target_ops *);
	33
	34	/* Support for hardware watchpoints and breakpoints using the i386
	35	debug registers.
	36
	37	This provides several functions for inserting and removing
	38	hardware-assisted breakpoints and watchpoints, testing if one or
	39	more of the watchpoints triggered and at what address, checking
	40	whether a given region can be watched, etc.
	41
	42	In addition, each target should provide several low-level functions
1777feb0	43	regrouped into i386_dr_low_type struct below. These functions
9bb9e8ad PM	44	that will be called to insert watchpoints and hardware breakpoints
	45	into the inferior, remove them, and check their status. These
	46	functions are:
	47
	48	set_control -- set the debug control (DR7)
a79d3c27	49	register to a given value for all LWPs
9bb9e8ad PM	50
9bb9e8ad PM	51	set_addr -- put an address into one debug
a79d3c27	52	register for all LWPs
9bb9e8ad	53
7b50312a PA	54	get_addr -- return the address in a given debug
7b50312a PA	55	register of the current LWP
9bb9e8ad PM	56
9bb9e8ad PM	57	get_status -- return the value of the debug
a79d3c27 JK	58	status (DR6) register for current LWP
a79d3c27 JK	59
7b50312a PA	60	get_control -- return the value of the debug
7b50312a PA	61	control (DR7) register for current LWP
9bb9e8ad PM	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
7b50312a	67	struct i386_dr_low_type
9bb9e8ad PM	68	{
	69	void (*set_control) (unsigned long);
	70	void (*set_addr) (int, CORE_ADDR);
7b50312a	71	CORE_ADDR (*get_addr) (int);
9bb9e8ad	72	unsigned long (*get_status) (void);
7b50312a	73	unsigned long (*get_control) (void);
9bb9e8ad PM	74	int debug_register_length;
	75	};
	76
	77	extern struct i386_dr_low_type i386_dr_low;
	78
7b50312a PA	79	/* Debug registers' indices. */
	80	#define DR_FIRSTADDR 0
	81	#define DR_LASTADDR 3
	82	#define DR_NADDR 4 /* The number of debug address registers. */
	83	#define DR_STATUS 6 /* Index of debug status register (DR6). */
	84	#define DR_CONTROL 7 /* Index of debug control register (DR7). */
	85
	86	/* Global state needed to track h/w watchpoints. */
	87
	88	struct i386_debug_reg_state
	89	{
	90	/* Mirror the inferior's DRi registers. We keep the status and
	91	control registers separated because they don't hold addresses.
	92	Note that since we can change these mirrors while threads are
	93	running, we never trust them to explain a cause of a trap.
	94	For that, we need to peek directly in the inferior registers. */
	95	CORE_ADDR dr_mirror[DR_NADDR];
	96	unsigned dr_status_mirror, dr_control_mirror;
	97
	98	/* Reference counts for each debug register. */
	99	int dr_ref_count[DR_NADDR];
	100	};
	101
9bb9e8ad PM	102	/* Use this function to set i386_dr_low debug_register_length field
	103	rather than setting it directly to check that the length is only
	104	set once. It also enables the 'maint set/show show-debug-regs'
	105	command. */
	106
	107	extern void i386_set_debug_register_length (int len);
	108
	109	/* Use this function to reset the i386-nat.c debug register state. */
	110
	111	extern void i386_cleanup_dregs (void);
	112
26cb8b7c PA	113	/* Return a pointer to the local mirror of the debug registers of
26cb8b7c PA	114	process PID. */
7b50312a	115
26cb8b7c PA	116	extern struct i386_debug_reg_state *i386_debug_reg_state (pid_t pid);
	117
	118	/* Called whenever GDB is no longer debugging process PID. It deletes
	119	data structures that keep track of debug register state. */
	120
	121	extern void i386_forget_process (pid_t pid);
7b50312a	122
9bb9e8ad	123	#endif /* I386_NAT_H */