1 /* Memory breakpoint interfaces for the remote server for GDB.
2 Copyright (C) 2002, 2005, 2007, 2008, 2009, 2010
3 Free Software Foundation, Inc.
5 Contributed by MontaVista Software.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
25 /* Breakpoints are opaque. */
27 struct fast_tracepoint_jump;
29 /* Create a new GDB breakpoint at WHERE. Returns -1 if breakpoints
30 are not supported on this target, 0 otherwise. */
32 int set_gdb_breakpoint_at (CORE_ADDR where);
34 /* Returns TRUE if there's any breakpoint at ADDR in our tables,
37 int breakpoint_here (CORE_ADDR addr);
39 /* Returns TRUE if there's any inserted breakpoint set at ADDR. */
41 int breakpoint_inserted_here (CORE_ADDR addr);
43 /* Returns TRUE if there's a GDB breakpoint set at ADDR. */
45 int gdb_breakpoint_here (CORE_ADDR where);
47 /* Create a new breakpoint at WHERE, and call HANDLER when
48 it is hit. HANDLER should return 1 if the breakpoint
49 should be deleted, 0 otherwise. */
51 struct breakpoint *set_breakpoint_at (CORE_ADDR where,
52 int (*handler) (CORE_ADDR));
54 /* Delete a GDB breakpoint previously inserted at ADDR with
55 set_gdb_breakpoint_at. */
57 int delete_gdb_breakpoint_at (CORE_ADDR addr);
59 /* Delete a breakpoint. */
61 int delete_breakpoint (struct breakpoint *bkpt);
63 /* Set a reinsert breakpoint at STOP_AT. */
65 void set_reinsert_breakpoint (CORE_ADDR stop_at);
67 /* Delete all reinsert breakpoints. */
69 void delete_reinsert_breakpoints (void);
71 /* Reinsert breakpoints at WHERE (and change their status to
74 void reinsert_breakpoints_at (CORE_ADDR where);
76 /* Uninsert breakpoints at WHERE (and change their status to
77 uninserted). This still leaves the breakpoints in the table. */
79 void uninsert_breakpoints_at (CORE_ADDR where);
81 /* See if any breakpoint claims ownership of STOP_PC. Call the handler for
82 the breakpoint, if found. */
84 void check_breakpoints (CORE_ADDR stop_pc);
86 /* See if any breakpoints shadow the target memory area from MEM_ADDR
87 to MEM_ADDR + MEM_LEN. Update the data already read from the target
88 (in BUF) if necessary. */
90 void check_mem_read (CORE_ADDR mem_addr, unsigned char *buf, int mem_len);
92 /* See if any breakpoints shadow the target memory area from MEM_ADDR
93 to MEM_ADDR + MEM_LEN. Update the data to be written to the target
94 (in BUF) if necessary, as well as the original data for any breakpoints. */
96 void check_mem_write (CORE_ADDR mem_addr, unsigned char *buf, int mem_len);
98 /* Set the byte pattern to insert for memory breakpoints. This function
99 must be called before any breakpoints are set. */
101 void set_breakpoint_data (const unsigned char *bp_data, int bp_len);
103 /* Delete all breakpoints. */
105 void delete_all_breakpoints (void);
107 /* Clear the "inserted" flag in all breakpoints of PROC. */
109 void mark_breakpoints_out (struct process_info *proc);
111 /* Delete all breakpoints, but do not try to un-insert them from the
114 void free_all_breakpoints (struct process_info *proc);
116 /* Check if breakpoints still seem to be inserted in the inferior. */
118 void validate_breakpoints (void);
120 /* Insert a fast tracepoint jump at WHERE, using instruction INSN, of
123 struct fast_tracepoint_jump *set_fast_tracepoint_jump (CORE_ADDR where,
127 /* Delete fast tracepoint jump TODEL from our tables, and uninsert if
130 int delete_fast_tracepoint_jump (struct fast_tracepoint_jump *todel);
132 /* Returns true if there's fast tracepoint jump set at WHERE. */
134 int fast_tracepoint_jump_here (CORE_ADDR);
136 /* Uninsert fast tracepoint jumps at WHERE (and change their status to
137 uninserted). This still leaves the tracepoints in the table. */
139 void uninsert_fast_tracepoint_jumps_at (CORE_ADDR pc);
141 /* Reinsert fast tracepoint jumps at WHERE (and change their status to
144 void reinsert_fast_tracepoint_jumps_at (CORE_ADDR where);
146 #endif /* MEM_BREAK_H */