Commit | Line | Data |
---|---|---|
c906108c | 1 | /* Machine independent variables that describe the core file under GDB. |
00e32a35 | 2 | |
0b302171 JB |
3 | Copyright (C) 1986-1987, 1989-2001, 2004, 2007-2012 Free Software |
4 | Foundation, Inc. | |
c906108c | 5 | |
c5aa993b | 6 | This file is part of GDB. |
c906108c | 7 | |
c5aa993b JM |
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 | |
a9762ec7 | 10 | the Free Software Foundation; either version 3 of the License, or |
c5aa993b | 11 | (at your option) any later version. |
c906108c | 12 | |
c5aa993b JM |
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. | |
c906108c | 17 | |
c5aa993b | 18 | You should have received a copy of the GNU General Public License |
a9762ec7 | 19 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
c906108c SS |
20 | |
21 | /* Interface routines for core, executable, etc. */ | |
22 | ||
23 | #if !defined (GDBCORE_H) | |
24 | #define GDBCORE_H 1 | |
25 | ||
da3331ec | 26 | struct type; |
9eefc95f | 27 | struct regcache; |
da3331ec | 28 | |
c906108c | 29 | #include "bfd.h" |
6c95b8df | 30 | #include "exec.h" |
c906108c 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 | ||
a14ed312 | 36 | extern char *get_exec_file (int err); |
c906108c SS |
37 | |
38 | /* Nonzero if there is a core file. */ | |
39 | ||
a14ed312 | 40 | extern int have_core_file_p (void); |
c906108c | 41 | |
c906108c SS |
42 | /* Report a memory error with error(). */ |
43 | ||
a14ed312 | 44 | extern void memory_error (int status, CORE_ADDR memaddr); |
c906108c SS |
45 | |
46 | /* Like target_read_memory, but report an error if can't read. */ | |
47 | ||
45aa4659 | 48 | extern void read_memory (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len); |
c906108c | 49 | |
4e5d721f DE |
50 | /* Like target_read_stack, but report an error if can't read. */ |
51 | ||
45aa4659 | 52 | extern void read_stack (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len); |
4e5d721f | 53 | |
c906108c SS |
54 | /* Read an integer from debugged memory, given address and number of |
55 | bytes. */ | |
56 | ||
e17a4113 UW |
57 | extern LONGEST read_memory_integer (CORE_ADDR memaddr, |
58 | int len, enum bfd_endian byte_order); | |
59 | extern int safe_read_memory_integer (CORE_ADDR memaddr, int len, | |
3e43a32a MS |
60 | enum bfd_endian byte_order, |
61 | LONGEST *return_value); | |
c906108c SS |
62 | |
63 | /* Read an unsigned integer from debugged memory, given address and | |
64 | number of bytes. */ | |
65 | ||
e17a4113 | 66 | extern ULONGEST read_memory_unsigned_integer (CORE_ADDR memaddr, |
3e43a32a MS |
67 | int len, |
68 | enum bfd_endian byte_order); | |
c906108c | 69 | |
0963b4bd MS |
70 | /* Read a null-terminated string from the debuggee's memory, given |
71 | address, a buffer into which to place the string, and the maximum | |
72 | available space. */ | |
0d540cdf | 73 | |
a14ed312 | 74 | extern void read_memory_string (CORE_ADDR, char *, int); |
c906108c | 75 | |
0d540cdf | 76 | /* Read the pointer of type TYPE at ADDR, and return the address it |
0963b4bd | 77 | represents. */ |
0d540cdf | 78 | |
570b8f7c | 79 | CORE_ADDR read_memory_typed_address (CORE_ADDR addr, struct type *type); |
0d540cdf | 80 | |
c906108c SS |
81 | /* This takes a char *, not void *. This is probably right, because |
82 | passing in an int * or whatever is wrong with respect to | |
83 | byteswapping, alignment, different sizes for host vs. target types, | |
84 | etc. */ | |
85 | ||
45aa4659 JK |
86 | extern void write_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, |
87 | ssize_t len); | |
c906108c | 88 | |
972daa01 YQ |
89 | /* Same as write_memory, but notify 'memory_changed' observers. */ |
90 | ||
91 | extern void write_memory_with_notification (CORE_ADDR memaddr, | |
92 | const bfd_byte *myaddr, | |
93 | ssize_t len); | |
94 | ||
c26e4683 JB |
95 | /* Store VALUE at ADDR in the inferior as a LEN-byte unsigned integer. */ |
96 | extern void write_memory_unsigned_integer (CORE_ADDR addr, int len, | |
e17a4113 UW |
97 | enum bfd_endian byte_order, |
98 | ULONGEST value); | |
c26e4683 JB |
99 | |
100 | /* Store VALUE at ADDR in the inferior as a LEN-byte unsigned integer. */ | |
101 | extern void write_memory_signed_integer (CORE_ADDR addr, int len, | |
e17a4113 | 102 | enum bfd_endian byte_order, |
c26e4683 | 103 | LONGEST value); |
c906108c SS |
104 | \f |
105 | /* Hook for `exec_file_command' command to call. */ | |
106 | ||
9a4105ab | 107 | extern void (*deprecated_exec_file_display_hook) (char *filename); |
c906108c SS |
108 | |
109 | /* Hook for "file_command", which is more useful than above | |
3a9a986f | 110 | (because it is invoked AFTER symbols are read, not before). */ |
c906108c | 111 | |
9a4105ab | 112 | extern void (*deprecated_file_changed_hook) (char *filename); |
c906108c | 113 | |
a14ed312 | 114 | extern void specify_exec_file_hook (void (*hook) (char *filename)); |
c906108c | 115 | |
6c95b8df | 116 | /* Binary File Diddler for the core file. */ |
c906108c SS |
117 | |
118 | extern bfd *core_bfd; | |
c04ea773 | 119 | |
c0edd9ed JK |
120 | extern struct target_ops *core_target; |
121 | ||
c906108c SS |
122 | /* Whether to open exec and core files read-only or read-write. */ |
123 | ||
124 | extern int write_files; | |
125 | ||
a14ed312 | 126 | extern void core_file_command (char *filename, int from_tty); |
c906108c | 127 | |
a14ed312 | 128 | extern void exec_file_attach (char *filename, int from_tty); |
c906108c | 129 | |
1adeb98a | 130 | extern void exec_file_clear (int from_tty); |
c906108c | 131 | |
a14ed312 | 132 | extern void validate_files (void); |
c906108c | 133 | |
c906108c SS |
134 | /* The current default bfd target. */ |
135 | ||
136 | extern char *gnutarget; | |
137 | ||
a14ed312 | 138 | extern void set_gnutarget (char *); |
c906108c SS |
139 | |
140 | /* Structure to keep track of core register reading functions for | |
141 | various core file types. */ | |
142 | ||
c5aa993b JM |
143 | struct core_fns |
144 | { | |
c906108c | 145 | |
2acceee2 JM |
146 | /* BFD flavour that a core file handler is prepared to read. This |
147 | can be used by the handler's core tasting function as a first | |
148 | level filter to reject BFD's that don't have the right | |
0963b4bd | 149 | flavour. */ |
c906108c | 150 | |
c5aa993b | 151 | enum bfd_flavour core_flavour; |
c906108c | 152 | |
2acceee2 JM |
153 | /* Core file handler function to call to recognize corefile |
154 | formats that BFD rejects. Some core file format just don't fit | |
155 | into the BFD model, or may require other resources to identify | |
156 | them, that simply aren't available to BFD (such as symbols from | |
157 | another file). Returns nonzero if the handler recognizes the | |
0963b4bd | 158 | format, zero otherwise. */ |
2acceee2 | 159 | |
507f3c78 | 160 | int (*check_format) (bfd *); |
2acceee2 JM |
161 | |
162 | /* Core file handler function to call to ask if it can handle a | |
163 | given core file format or not. Returns zero if it can't, | |
0963b4bd | 164 | nonzero otherwise. */ |
2acceee2 | 165 | |
507f3c78 | 166 | int (*core_sniffer) (struct core_fns *, bfd *); |
2acceee2 | 167 | |
9eefc95f UW |
168 | /* Extract the register values out of the core file and supply them |
169 | into REGCACHE. | |
c906108c | 170 | |
c5aa993b JM |
171 | CORE_REG_SECT points to the register values themselves, read into |
172 | memory. | |
c906108c | 173 | |
c5aa993b | 174 | CORE_REG_SIZE is the size of that area. |
c906108c | 175 | |
de57eccd JM |
176 | WHICH says which set of registers we are handling: |
177 | 0 --- integer registers | |
178 | 2 --- floating-point registers, on machines where they are | |
179 | discontiguous | |
180 | 3 --- extended floating-point registers, on machines where | |
181 | these are present in yet a third area. (GNU/Linux uses | |
182 | this to get at the SSE registers.) | |
c906108c | 183 | |
c5aa993b JM |
184 | REG_ADDR is the offset from u.u_ar0 to the register values relative to |
185 | core_reg_sect. This is used with old-fashioned core files to locate the | |
186 | registers in a large upage-plus-stack ".reg" section. Original upage | |
0963b4bd | 187 | address X is at location core_reg_sect+x+reg_addr. */ |
c906108c | 188 | |
9eefc95f UW |
189 | void (*core_read_registers) (struct regcache *regcache, |
190 | char *core_reg_sect, | |
507f3c78 KB |
191 | unsigned core_reg_size, |
192 | int which, CORE_ADDR reg_addr); | |
c906108c | 193 | |
00e32a35 AC |
194 | /* Finds the next struct core_fns. They are allocated and |
195 | initialized in whatever module implements the functions pointed | |
196 | to; an initializer calls deprecated_add_core_fns to add them to | |
197 | the global chain. */ | |
c906108c | 198 | |
c5aa993b | 199 | struct core_fns *next; |
c906108c | 200 | |
c5aa993b | 201 | }; |
c906108c | 202 | |
00e32a35 AC |
203 | /* NOTE: cagney/2004-04-05: Replaced by "regset.h" and |
204 | regset_from_core_section(). */ | |
205 | extern void deprecated_add_core_fns (struct core_fns *cf); | |
a14ed312 KB |
206 | extern int default_core_sniffer (struct core_fns *cf, bfd * abfd); |
207 | extern int default_check_format (bfd * abfd); | |
c906108c | 208 | |
07b82ea5 PA |
209 | struct target_section *deprecated_core_resize_section_table (int num_added); |
210 | ||
c5aa993b | 211 | #endif /* !defined (GDBCORE_H) */ |