1 /* Memory breakpoint interfaces for the remote server for GDB.
2 Copyright (C) 2002, 2005, 2007-2012 Free Software Foundation, Inc.
4 Contributed by MontaVista Software.
6 This file is part of GDB.
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 3 of the License, or
11 (at your option) any later version.
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.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>. */
24 /* Breakpoints are opaque. */
26 struct fast_tracepoint_jump
;
28 /* Create a new GDB breakpoint at WHERE. Returns -1 if breakpoints
29 are not supported on this target, 0 otherwise. */
31 int set_gdb_breakpoint_at (CORE_ADDR where
);
33 /* Returns TRUE if there's any breakpoint at ADDR in our tables,
36 int breakpoint_here (CORE_ADDR addr
);
38 /* Returns TRUE if there's any inserted breakpoint set at ADDR. */
40 int breakpoint_inserted_here (CORE_ADDR addr
);
42 /* Returns TRUE if there's a GDB breakpoint set at ADDR. */
44 int gdb_breakpoint_here (CORE_ADDR where
);
46 /* Create a new breakpoint at WHERE, and call HANDLER when
47 it is hit. HANDLER should return 1 if the breakpoint
48 should be deleted, 0 otherwise. */
50 struct breakpoint
*set_breakpoint_at (CORE_ADDR where
,
51 int (*handler
) (CORE_ADDR
));
53 /* Delete a GDB breakpoint previously inserted at ADDR with
54 set_gdb_breakpoint_at. */
56 int delete_gdb_breakpoint_at (CORE_ADDR addr
);
58 /* Delete a breakpoint. */
60 int delete_breakpoint (struct breakpoint
*bkpt
);
62 /* Set a reinsert breakpoint at STOP_AT. */
64 void set_reinsert_breakpoint (CORE_ADDR stop_at
);
66 /* Delete all reinsert breakpoints. */
68 void delete_reinsert_breakpoints (void);
70 /* Reinsert breakpoints at WHERE (and change their status to
73 void reinsert_breakpoints_at (CORE_ADDR where
);
75 /* Uninsert breakpoints at WHERE (and change their status to
76 uninserted). This still leaves the breakpoints in the table. */
78 void uninsert_breakpoints_at (CORE_ADDR where
);
80 /* Reinsert all breakpoints of the current process (and change their
81 status to inserted). */
83 void reinsert_all_breakpoints (void);
85 /* Uninsert all breakpoints of the current process (and change their
86 status to uninserted). This still leaves the breakpoints in the
89 void uninsert_all_breakpoints (void);
91 /* See if any breakpoint claims ownership of STOP_PC. Call the handler for
92 the breakpoint, if found. */
94 void check_breakpoints (CORE_ADDR stop_pc
);
96 /* See if any breakpoints shadow the target memory area from MEM_ADDR
97 to MEM_ADDR + MEM_LEN. Update the data already read from the target
98 (in BUF) if necessary. */
100 void check_mem_read (CORE_ADDR mem_addr
, unsigned char *buf
, int mem_len
);
102 /* See if any breakpoints shadow the target memory area from MEM_ADDR
103 to MEM_ADDR + MEM_LEN. Update the data to be written to the target
104 (in BUF, a copy of MYADDR on entry) if necessary, as well as the
105 original data for any breakpoints. */
107 void check_mem_write (CORE_ADDR mem_addr
,
108 unsigned char *buf
, const unsigned char *myaddr
, int mem_len
);
110 /* Set the byte pattern to insert for memory breakpoints. This function
111 must be called before any breakpoints are set. */
113 void set_breakpoint_data (const unsigned char *bp_data
, int bp_len
);
115 /* Delete all breakpoints. */
117 void delete_all_breakpoints (void);
119 /* Clear the "inserted" flag in all breakpoints of PROC. */
121 void mark_breakpoints_out (struct process_info
*proc
);
123 /* Delete all breakpoints, but do not try to un-insert them from the
126 void free_all_breakpoints (struct process_info
*proc
);
128 /* Check if breakpoints still seem to be inserted in the inferior. */
130 void validate_breakpoints (void);
132 /* Insert a fast tracepoint jump at WHERE, using instruction INSN, of
135 struct fast_tracepoint_jump
*set_fast_tracepoint_jump (CORE_ADDR where
,
139 /* Increment reference counter of JP. */
140 void inc_ref_fast_tracepoint_jump (struct fast_tracepoint_jump
*jp
);
142 /* Delete fast tracepoint jump TODEL from our tables, and uninsert if
145 int delete_fast_tracepoint_jump (struct fast_tracepoint_jump
*todel
);
147 /* Returns true if there's fast tracepoint jump set at WHERE. */
149 int fast_tracepoint_jump_here (CORE_ADDR
);
151 /* Uninsert fast tracepoint jumps at WHERE (and change their status to
152 uninserted). This still leaves the tracepoints in the table. */
154 void uninsert_fast_tracepoint_jumps_at (CORE_ADDR pc
);
156 /* Reinsert fast tracepoint jumps at WHERE (and change their status to
159 void reinsert_fast_tracepoint_jumps_at (CORE_ADDR where
);
161 #endif /* MEM_BREAK_H */