Commit | Line | Data |
---|---|---|
5796c8dc SS |
1 | /* Machine independent variables that describe the core file under GDB. |
2 | ||
25e4902b | 3 | Copyright (C) 1986-2015 Free Software Foundation, Inc. |
5796c8dc SS |
4 | |
5 | This file is part of GDB. | |
6 | ||
7 | This program is free software; you can redistribute it and/or modify | |
8 | it under the terms of the GNU General Public License as published by | |
9 | the Free Software Foundation; either version 3 of the License, or | |
10 | (at your option) any later version. | |
11 | ||
12 | This program is distributed in the hope that it will be useful, | |
13 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | GNU General Public License for more details. | |
16 | ||
17 | You should have received a copy of the GNU General Public License | |
18 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ | |
19 | ||
20 | /* Interface routines for core, executable, etc. */ | |
21 | ||
22 | #if !defined (GDBCORE_H) | |
23 | #define GDBCORE_H 1 | |
24 | ||
25 | struct type; | |
26 | struct regcache; | |
27 | ||
28 | #include "bfd.h" | |
cf7f2e2d | 29 | #include "exec.h" |
25e4902b | 30 | #include "target.h" |
5796c8dc SS |
31 | |
32 | /* Return the name of the executable file as a string. | |
33 | ERR nonzero means get error if there is none specified; | |
34 | otherwise return 0 in that case. */ | |
35 | ||
36 | extern char *get_exec_file (int err); | |
37 | ||
38 | /* Nonzero if there is a core file. */ | |
39 | ||
40 | extern int have_core_file_p (void); | |
41 | ||
42 | /* Report a memory error with error(). */ | |
43 | ||
25e4902b AHJ |
44 | extern void memory_error (enum target_xfer_status status, CORE_ADDR memaddr); |
45 | ||
46 | /* The string 'memory_error' would use as exception message. Space | |
47 | for the result is malloc'd, caller must free. */ | |
48 | ||
49 | extern char *memory_error_message (enum target_xfer_status err, | |
50 | struct gdbarch *gdbarch, CORE_ADDR memaddr); | |
5796c8dc SS |
51 | |
52 | /* Like target_read_memory, but report an error if can't read. */ | |
53 | ||
ef5ccd6c | 54 | extern void read_memory (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len); |
5796c8dc SS |
55 | |
56 | /* Like target_read_stack, but report an error if can't read. */ | |
57 | ||
ef5ccd6c | 58 | extern void read_stack (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len); |
5796c8dc | 59 | |
25e4902b AHJ |
60 | /* Like target_read_code, but report an error if can't read. */ |
61 | ||
62 | extern void read_code (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len); | |
63 | ||
5796c8dc SS |
64 | /* Read an integer from debugged memory, given address and number of |
65 | bytes. */ | |
66 | ||
67 | extern LONGEST read_memory_integer (CORE_ADDR memaddr, | |
68 | int len, enum bfd_endian byte_order); | |
69 | extern int safe_read_memory_integer (CORE_ADDR memaddr, int len, | |
c50c785c JM |
70 | enum bfd_endian byte_order, |
71 | LONGEST *return_value); | |
5796c8dc SS |
72 | |
73 | /* Read an unsigned integer from debugged memory, given address and | |
74 | number of bytes. */ | |
75 | ||
76 | extern ULONGEST read_memory_unsigned_integer (CORE_ADDR memaddr, | |
c50c785c JM |
77 | int len, |
78 | enum bfd_endian byte_order); | |
5796c8dc | 79 | |
25e4902b AHJ |
80 | /* Read an integer from debugged code memory, given address, |
81 | number of bytes, and byte order for code. */ | |
82 | ||
83 | extern LONGEST read_code_integer (CORE_ADDR memaddr, int len, | |
84 | enum bfd_endian byte_order); | |
85 | ||
86 | /* Read an unsigned integer from debugged code memory, given address, | |
87 | number of bytes, and byte order for code. */ | |
88 | ||
89 | extern ULONGEST read_code_unsigned_integer (CORE_ADDR memaddr, | |
90 | int len, | |
91 | enum bfd_endian byte_order); | |
92 | ||
c50c785c JM |
93 | /* Read a null-terminated string from the debuggee's memory, given |
94 | address, a buffer into which to place the string, and the maximum | |
95 | available space. */ | |
5796c8dc SS |
96 | |
97 | extern void read_memory_string (CORE_ADDR, char *, int); | |
98 | ||
99 | /* Read the pointer of type TYPE at ADDR, and return the address it | |
c50c785c | 100 | represents. */ |
5796c8dc SS |
101 | |
102 | CORE_ADDR read_memory_typed_address (CORE_ADDR addr, struct type *type); | |
103 | ||
25e4902b AHJ |
104 | /* Same as target_write_memory, but report an error if can't |
105 | write. */ | |
5796c8dc | 106 | |
ef5ccd6c JM |
107 | extern void write_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, |
108 | ssize_t len); | |
109 | ||
110 | /* Same as write_memory, but notify 'memory_changed' observers. */ | |
111 | ||
112 | extern void write_memory_with_notification (CORE_ADDR memaddr, | |
113 | const bfd_byte *myaddr, | |
114 | ssize_t len); | |
5796c8dc SS |
115 | |
116 | /* Store VALUE at ADDR in the inferior as a LEN-byte unsigned integer. */ | |
117 | extern void write_memory_unsigned_integer (CORE_ADDR addr, int len, | |
118 | enum bfd_endian byte_order, | |
119 | ULONGEST value); | |
120 | ||
121 | /* Store VALUE at ADDR in the inferior as a LEN-byte unsigned integer. */ | |
122 | extern void write_memory_signed_integer (CORE_ADDR addr, int len, | |
123 | enum bfd_endian byte_order, | |
124 | LONGEST value); | |
125 | \f | |
126 | /* Hook for `exec_file_command' command to call. */ | |
127 | ||
25e4902b | 128 | extern void (*deprecated_exec_file_display_hook) (const char *filename); |
5796c8dc SS |
129 | |
130 | /* Hook for "file_command", which is more useful than above | |
131 | (because it is invoked AFTER symbols are read, not before). */ | |
132 | ||
133 | extern void (*deprecated_file_changed_hook) (char *filename); | |
134 | ||
25e4902b | 135 | extern void specify_exec_file_hook (void (*hook) (const char *filename)); |
5796c8dc | 136 | |
cf7f2e2d | 137 | /* Binary File Diddler for the core file. */ |
5796c8dc SS |
138 | |
139 | extern bfd *core_bfd; | |
5796c8dc | 140 | |
c50c785c JM |
141 | extern struct target_ops *core_target; |
142 | ||
5796c8dc SS |
143 | /* Whether to open exec and core files read-only or read-write. */ |
144 | ||
145 | extern int write_files; | |
146 | ||
147 | extern void core_file_command (char *filename, int from_tty); | |
148 | ||
25e4902b AHJ |
149 | extern void exec_file_attach (const char *filename, int from_tty); |
150 | ||
151 | /* If the filename of the main executable is unknown, attempt to | |
152 | determine it. If a filename is determined, proceed as though | |
153 | it was just specified with the "file" command. Do nothing if | |
154 | the filename of the main executable is already known. */ | |
155 | ||
156 | extern void exec_file_locate_attach (int pid, int from_tty); | |
5796c8dc SS |
157 | |
158 | extern void exec_file_clear (int from_tty); | |
159 | ||
160 | extern void validate_files (void); | |
161 | ||
162 | /* The current default bfd target. */ | |
163 | ||
164 | extern char *gnutarget; | |
165 | ||
166 | extern void set_gnutarget (char *); | |
167 | ||
168 | /* Structure to keep track of core register reading functions for | |
169 | various core file types. */ | |
170 | ||
171 | struct core_fns | |
172 | { | |
173 | ||
174 | /* BFD flavour that a core file handler is prepared to read. This | |
175 | can be used by the handler's core tasting function as a first | |
176 | level filter to reject BFD's that don't have the right | |
c50c785c | 177 | flavour. */ |
5796c8dc SS |
178 | |
179 | enum bfd_flavour core_flavour; | |
180 | ||
181 | /* Core file handler function to call to recognize corefile | |
182 | formats that BFD rejects. Some core file format just don't fit | |
183 | into the BFD model, or may require other resources to identify | |
184 | them, that simply aren't available to BFD (such as symbols from | |
185 | another file). Returns nonzero if the handler recognizes the | |
c50c785c | 186 | format, zero otherwise. */ |
5796c8dc SS |
187 | |
188 | int (*check_format) (bfd *); | |
189 | ||
190 | /* Core file handler function to call to ask if it can handle a | |
191 | given core file format or not. Returns zero if it can't, | |
c50c785c | 192 | nonzero otherwise. */ |
5796c8dc SS |
193 | |
194 | int (*core_sniffer) (struct core_fns *, bfd *); | |
195 | ||
196 | /* Extract the register values out of the core file and supply them | |
197 | into REGCACHE. | |
198 | ||
199 | CORE_REG_SECT points to the register values themselves, read into | |
200 | memory. | |
201 | ||
202 | CORE_REG_SIZE is the size of that area. | |
203 | ||
204 | WHICH says which set of registers we are handling: | |
205 | 0 --- integer registers | |
206 | 2 --- floating-point registers, on machines where they are | |
207 | discontiguous | |
208 | 3 --- extended floating-point registers, on machines where | |
209 | these are present in yet a third area. (GNU/Linux uses | |
210 | this to get at the SSE registers.) | |
211 | ||
212 | REG_ADDR is the offset from u.u_ar0 to the register values relative to | |
213 | core_reg_sect. This is used with old-fashioned core files to locate the | |
214 | registers in a large upage-plus-stack ".reg" section. Original upage | |
c50c785c | 215 | address X is at location core_reg_sect+x+reg_addr. */ |
5796c8dc SS |
216 | |
217 | void (*core_read_registers) (struct regcache *regcache, | |
218 | char *core_reg_sect, | |
219 | unsigned core_reg_size, | |
220 | int which, CORE_ADDR reg_addr); | |
221 | ||
222 | /* Finds the next struct core_fns. They are allocated and | |
223 | initialized in whatever module implements the functions pointed | |
224 | to; an initializer calls deprecated_add_core_fns to add them to | |
225 | the global chain. */ | |
226 | ||
227 | struct core_fns *next; | |
228 | ||
229 | }; | |
230 | ||
231 | /* NOTE: cagney/2004-04-05: Replaced by "regset.h" and | |
232 | regset_from_core_section(). */ | |
233 | extern void deprecated_add_core_fns (struct core_fns *cf); | |
234 | extern int default_core_sniffer (struct core_fns *cf, bfd * abfd); | |
235 | extern int default_check_format (bfd * abfd); | |
236 | ||
5796c8dc | 237 | #endif /* !defined (GDBCORE_H) */ |