1 /* Memory breakpoint interfaces for the remote server for GDB.
2 Copyright (C) 2002, 2005, 2007, 2008, 2009, 2010, 2011
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 /* Reinsert all breakpoints of the current process (and change their
82 status to inserted). */
84 void reinsert_all_breakpoints (void);
86 /* Uninsert all breakpoints of the current process (and change their
87 status to uninserted). This still leaves the breakpoints in the
90 void uninsert_all_breakpoints (void);
92 /* See if any breakpoint claims ownership of STOP_PC. Call the handler for
93 the breakpoint, if found. */
95 void check_breakpoints (CORE_ADDR stop_pc);
97 /* See if any breakpoints shadow the target memory area from MEM_ADDR
98 to MEM_ADDR + MEM_LEN. Update the data already read from the target
99 (in BUF) if necessary. */
101 void check_mem_read (CORE_ADDR mem_addr, unsigned char *buf, int mem_len);
103 /* See if any breakpoints shadow the target memory area from MEM_ADDR
104 to MEM_ADDR + MEM_LEN. Update the data to be written to the target
105 (in BUF, a copy of MYADDR on entry) if necessary, as well as the
106 original data for any breakpoints. */
108 void check_mem_write (CORE_ADDR mem_addr,
109 unsigned char *buf, const unsigned char *myaddr, int mem_len);
111 /* Set the byte pattern to insert for memory breakpoints. This function
112 must be called before any breakpoints are set. */
114 void set_breakpoint_data (const unsigned char *bp_data, int bp_len);
116 /* Delete all breakpoints. */
118 void delete_all_breakpoints (void);
120 /* Clear the "inserted" flag in all breakpoints of PROC. */
122 void mark_breakpoints_out (struct process_info *proc);
124 /* Delete all breakpoints, but do not try to un-insert them from the
127 void free_all_breakpoints (struct process_info *proc);
129 /* Check if breakpoints still seem to be inserted in the inferior. */
131 void validate_breakpoints (void);
133 /* Insert a fast tracepoint jump at WHERE, using instruction INSN, of
136 struct fast_tracepoint_jump *set_fast_tracepoint_jump (CORE_ADDR where,
140 /* Delete fast tracepoint jump TODEL from our tables, and uninsert if
143 int delete_fast_tracepoint_jump (struct fast_tracepoint_jump *todel);
145 /* Returns true if there's fast tracepoint jump set at WHERE. */
147 int fast_tracepoint_jump_here (CORE_ADDR);
149 /* Uninsert fast tracepoint jumps at WHERE (and change their status to
150 uninserted). This still leaves the tracepoints in the table. */
152 void uninsert_fast_tracepoint_jumps_at (CORE_ADDR pc);
154 /* Reinsert fast tracepoint jumps at WHERE (and change their status to
157 void reinsert_fast_tracepoint_jumps_at (CORE_ADDR where);
159 #endif /* MEM_BREAK_H */