[deliverable/binutils-gdb.git] / gdb / gdbserver / mem-break.h

/* Memory breakpoint interfaces for the remote server for GDB.
   Copyright (C) 2002, 2005, 2007 Free Software Foundation, Inc.

   Contributed by MontaVista Software.

   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 2 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, write to the Free Software
   Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301, USA.  */

#ifndef MEM_BREAK_H
#define MEM_BREAK_H

/* Breakpoints are opaque.  */

/* Create a new breakpoint at WHERE, and call HANDLER when
   it is hit.  */

void set_breakpoint_at (CORE_ADDR where,
			void (*handler) (CORE_ADDR));

/* Delete a breakpoint previously inserted at ADDR with
   set_breakpoint_at.  */

void delete_breakpoint_at (CORE_ADDR addr);

/* Create a reinsertion breakpoint at STOP_AT for the breakpoint
   currently at STOP_PC (and temporarily remove the breakpoint at
   STOP_PC).  */

void reinsert_breakpoint_by_bp (CORE_ADDR stop_pc, CORE_ADDR stop_at);

/* Change the status of the breakpoint at WHERE to inserted.  */

void reinsert_breakpoint (CORE_ADDR where);

/* Change the status of the breakpoint at WHERE to uninserted.  */

void uninsert_breakpoint (CORE_ADDR where);

/* See if any breakpoint claims ownership of STOP_PC.  Call the handler for
   the breakpoint, if found.  */

int check_breakpoints (CORE_ADDR stop_pc);

/* See if any breakpoints shadow the target memory area from MEM_ADDR
   to MEM_ADDR + MEM_LEN.  Update the data already read from the target
   (in BUF) if necessary.  */

void check_mem_read (CORE_ADDR mem_addr, unsigned char *buf, int mem_len);

/* See if any breakpoints shadow the target memory area from MEM_ADDR
   to MEM_ADDR + MEM_LEN.  Update the data to be written to the target
   (in BUF) if necessary, as well as the original data for any breakpoints.  */

void check_mem_write (CORE_ADDR mem_addr, unsigned char *buf, int mem_len);

/* Set the byte pattern to insert for memory breakpoints.  This function
   must be called before any breakpoints are set.  */

void set_breakpoint_data (const unsigned char *bp_data, int bp_len);

/* Delete all breakpoints.  */

void delete_all_breakpoints (void);

#endif /* MEM_BREAK_H */
Commit	Line	Data
611cb4a5	1	/* Memory breakpoint interfaces for the remote server for GDB.
6aba47ca	2	Copyright (C) 2002, 2005, 2007 Free Software Foundation, Inc.
611cb4a5 DJ	3
	4	Contributed by MontaVista Software.
	5
	6	This file is part of GDB.
	7
	8	This program is free software; you can redistribute it and/or modify
	9	it under the terms of the GNU General Public License as published by
	10	the Free Software Foundation; either version 2 of the License, or
	11	(at your option) any later version.
	12
	13	This program is distributed in the hope that it will be useful,
	14	but WITHOUT ANY WARRANTY; without even the implied warranty of
	15	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	16	GNU General Public License for more details.
	17
	18	You should have received a copy of the GNU General Public License
	19	along with this program; if not, write to the Free Software
6f0f660e EZ	20	Foundation, Inc., 51 Franklin Street, Fifth Floor,
6f0f660e EZ	21	Boston, MA 02110-1301, USA. */
611cb4a5 DJ	22
	23	#ifndef MEM_BREAK_H
	24	#define MEM_BREAK_H
	25
	26	/* Breakpoints are opaque. */
	27
	28	/* Create a new breakpoint at WHERE, and call HANDLER when
	29	it is hit. */
	30
	31	void set_breakpoint_at (CORE_ADDR where,
	32	void (*handler) (CORE_ADDR));
	33
68070c10 PA	34	/* Delete a breakpoint previously inserted at ADDR with
	35	set_breakpoint_at. */
	36
	37	void delete_breakpoint_at (CORE_ADDR addr);
	38
611cb4a5 DJ	39	/* Create a reinsertion breakpoint at STOP_AT for the breakpoint
	40	currently at STOP_PC (and temporarily remove the breakpoint at
	41	STOP_PC). */
	42
	43	void reinsert_breakpoint_by_bp (CORE_ADDR stop_pc, CORE_ADDR stop_at);
	44
	45	/* Change the status of the breakpoint at WHERE to inserted. */
	46
	47	void reinsert_breakpoint (CORE_ADDR where);
	48
	49	/* Change the status of the breakpoint at WHERE to uninserted. */
	50
	51	void uninsert_breakpoint (CORE_ADDR where);
	52
	53	/* See if any breakpoint claims ownership of STOP_PC. Call the handler for
	54	the breakpoint, if found. */
	55
	56	int check_breakpoints (CORE_ADDR stop_pc);
	57
	58	/* See if any breakpoints shadow the target memory area from MEM_ADDR
	59	to MEM_ADDR + MEM_LEN. Update the data already read from the target
	60	(in BUF) if necessary. */
	61
f450004a	62	void check_mem_read (CORE_ADDR mem_addr, unsigned char *buf, int mem_len);
611cb4a5 DJ	63
	64	/* See if any breakpoints shadow the target memory area from MEM_ADDR
	65	to MEM_ADDR + MEM_LEN. Update the data to be written to the target
	66	(in BUF) if necessary, as well as the original data for any breakpoints. */
	67
f450004a	68	void check_mem_write (CORE_ADDR mem_addr, unsigned char *buf, int mem_len);
611cb4a5 DJ	69
	70	/* Set the byte pattern to insert for memory breakpoints. This function
	71	must be called before any breakpoints are set. */
	72
f450004a	73	void set_breakpoint_data (const unsigned char *bp_data, int bp_len);
611cb4a5	74
ae13219e DJ	75	/* Delete all breakpoints. */
	76
	77	void delete_all_breakpoints (void);
	78
611cb4a5	79	#endif /* MEM_BREAK_H */