Commit | Line | Data |
---|---|---|
c906108c SS |
1 | /* Machine independent variables that describe the core file under GDB. |
2 | Copyright 1986, 1987, 1989, 1990, 1992, 1995 Free Software Foundation, Inc. | |
3 | ||
c5aa993b | 4 | This file is part of GDB. |
c906108c | 5 | |
c5aa993b JM |
6 | This program is free software; you can redistribute it and/or modify |
7 | it under the terms of the GNU General Public License as published by | |
8 | the Free Software Foundation; either version 2 of the License, or | |
9 | (at your option) any later version. | |
c906108c | 10 | |
c5aa993b JM |
11 | This program is distributed in the hope that it will be useful, |
12 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
14 | GNU General Public License for more details. | |
c906108c | 15 | |
c5aa993b JM |
16 | You should have received a copy of the GNU General Public License |
17 | along with this program; if not, write to the Free Software | |
18 | Foundation, Inc., 59 Temple Place - Suite 330, | |
19 | Boston, MA 02111-1307, USA. */ | |
c906108c SS |
20 | |
21 | /* Interface routines for core, executable, etc. */ | |
22 | ||
23 | #if !defined (GDBCORE_H) | |
24 | #define GDBCORE_H 1 | |
25 | ||
26 | #include "bfd.h" | |
27 | ||
28 | /* Return the name of the executable file as a string. | |
29 | ERR nonzero means get error if there is none specified; | |
30 | otherwise return 0 in that case. */ | |
31 | ||
32 | extern char *get_exec_file PARAMS ((int err)); | |
33 | ||
34 | /* Nonzero if there is a core file. */ | |
35 | ||
36 | extern int have_core_file_p PARAMS ((void)); | |
37 | ||
38 | /* Read "memory data" from whatever target or inferior we have. | |
39 | Returns zero if successful, errno value if not. EIO is used for | |
40 | address out of bounds. If breakpoints are inserted, returns shadow | |
41 | contents, not the breakpoints themselves. From breakpoint.c. */ | |
42 | ||
43 | extern int read_memory_nobpt PARAMS ((CORE_ADDR memaddr, char *myaddr, | |
44 | unsigned len)); | |
45 | ||
46 | /* Report a memory error with error(). */ | |
47 | ||
48 | extern void memory_error PARAMS ((int status, CORE_ADDR memaddr)); | |
49 | ||
50 | /* Like target_read_memory, but report an error if can't read. */ | |
51 | ||
52 | extern void read_memory PARAMS ((CORE_ADDR memaddr, char *myaddr, int len)); | |
53 | ||
54 | extern void read_memory_section PARAMS ((CORE_ADDR memaddr, char *myaddr, | |
c5aa993b | 55 | int len, asection * bfd_section)); |
c906108c SS |
56 | |
57 | /* Read an integer from debugged memory, given address and number of | |
58 | bytes. */ | |
59 | ||
60 | extern LONGEST read_memory_integer PARAMS ((CORE_ADDR memaddr, int len)); | |
61 | ||
62 | /* Read an unsigned integer from debugged memory, given address and | |
63 | number of bytes. */ | |
64 | ||
65 | extern ULONGEST read_memory_unsigned_integer PARAMS ((CORE_ADDR memaddr, int len)); | |
66 | ||
67 | /* Read a null-terminated string from the debuggee's memory, given address, | |
c5aa993b | 68 | * a buffer into which to place the string, and the maximum available space */ |
c906108c SS |
69 | extern void read_memory_string PARAMS ((CORE_ADDR, char *, int)); |
70 | ||
71 | /* This takes a char *, not void *. This is probably right, because | |
72 | passing in an int * or whatever is wrong with respect to | |
73 | byteswapping, alignment, different sizes for host vs. target types, | |
74 | etc. */ | |
75 | ||
76 | extern void write_memory PARAMS ((CORE_ADDR memaddr, char *myaddr, int len)); | |
77 | ||
78 | extern void generic_search PARAMS ((int len, char *data, char *mask, | |
79 | CORE_ADDR startaddr, int increment, | |
80 | CORE_ADDR lorange, CORE_ADDR hirange, | |
c5aa993b | 81 | CORE_ADDR * addr_found, char *data_found)); |
c906108c SS |
82 | \f |
83 | /* Hook for `exec_file_command' command to call. */ | |
84 | ||
85 | extern void (*exec_file_display_hook) PARAMS ((char *filename)); | |
86 | ||
87 | /* Hook for "file_command", which is more useful than above | |
88 | (because it is invoked AFTER symbols are read, not before) */ | |
89 | ||
90 | extern void (*file_changed_hook) PARAMS ((char *filename)); | |
91 | ||
92 | extern void specify_exec_file_hook PARAMS ((void (*hook) (char *filename))); | |
93 | ||
94 | /* Binary File Diddlers for the exec and core files */ | |
95 | ||
96 | extern bfd *core_bfd; | |
97 | extern bfd *exec_bfd; | |
98 | ||
99 | /* Whether to open exec and core files read-only or read-write. */ | |
100 | ||
101 | extern int write_files; | |
102 | ||
103 | extern void core_file_command PARAMS ((char *filename, int from_tty)); | |
104 | ||
105 | extern void exec_file_attach PARAMS ((char *filename, int from_tty)); | |
106 | ||
107 | extern void exec_file_command PARAMS ((char *filename, int from_tty)); | |
108 | ||
109 | extern void validate_files PARAMS ((void)); | |
110 | ||
111 | extern CORE_ADDR register_addr PARAMS ((int regno, CORE_ADDR blockend)); | |
112 | ||
113 | extern void registers_fetched PARAMS ((void)); | |
114 | ||
115 | #if !defined (KERNEL_U_ADDR) | |
116 | extern CORE_ADDR kernel_u_addr; | |
117 | #define KERNEL_U_ADDR kernel_u_addr | |
118 | #endif | |
119 | ||
120 | /* The target vector for core files. */ | |
121 | ||
122 | extern struct target_ops core_ops; | |
123 | ||
124 | /* The current default bfd target. */ | |
125 | ||
126 | extern char *gnutarget; | |
127 | ||
128 | extern void set_gnutarget PARAMS ((char *)); | |
129 | ||
130 | /* Structure to keep track of core register reading functions for | |
131 | various core file types. */ | |
132 | ||
c5aa993b JM |
133 | struct core_fns |
134 | { | |
c906108c | 135 | |
2acceee2 JM |
136 | /* BFD flavour that a core file handler is prepared to read. This |
137 | can be used by the handler's core tasting function as a first | |
138 | level filter to reject BFD's that don't have the right | |
139 | flavour. */ | |
c906108c | 140 | |
c5aa993b | 141 | enum bfd_flavour core_flavour; |
c906108c | 142 | |
2acceee2 JM |
143 | /* Core file handler function to call to recognize corefile |
144 | formats that BFD rejects. Some core file format just don't fit | |
145 | into the BFD model, or may require other resources to identify | |
146 | them, that simply aren't available to BFD (such as symbols from | |
147 | another file). Returns nonzero if the handler recognizes the | |
148 | format, zero otherwise. */ | |
149 | ||
150 | int (*check_format) PARAMS ((bfd *)); | |
151 | ||
152 | /* Core file handler function to call to ask if it can handle a | |
153 | given core file format or not. Returns zero if it can't, | |
154 | nonzero otherwise. */ | |
155 | ||
156 | int (*core_sniffer) PARAMS ((struct core_fns *, bfd *)); | |
157 | ||
c5aa993b JM |
158 | /* Extract the register values out of the core file and store them where |
159 | `read_register' will find them. | |
c906108c | 160 | |
c5aa993b JM |
161 | CORE_REG_SECT points to the register values themselves, read into |
162 | memory. | |
c906108c | 163 | |
c5aa993b | 164 | CORE_REG_SIZE is the size of that area. |
c906108c | 165 | |
c5aa993b JM |
166 | WHICH says which set of registers we are handling (0 = int, 2 = float on |
167 | machines where they are discontiguous). | |
c906108c | 168 | |
c5aa993b JM |
169 | REG_ADDR is the offset from u.u_ar0 to the register values relative to |
170 | core_reg_sect. This is used with old-fashioned core files to locate the | |
171 | registers in a large upage-plus-stack ".reg" section. Original upage | |
172 | address X is at location core_reg_sect+x+reg_addr. */ | |
c906108c | 173 | |
c5aa993b JM |
174 | void (*core_read_registers) PARAMS ((char *core_reg_sect, unsigned core_reg_size, |
175 | int which, CORE_ADDR reg_addr)); | |
c906108c | 176 | |
c5aa993b JM |
177 | /* Finds the next struct core_fns. They are allocated and initialized |
178 | in whatever module implements the functions pointed to; an | |
179 | initializer calls add_core_fns to add them to the global chain. */ | |
c906108c | 180 | |
c5aa993b | 181 | struct core_fns *next; |
c906108c | 182 | |
c5aa993b | 183 | }; |
c906108c | 184 | |
c5aa993b | 185 | extern void add_core_fns PARAMS ((struct core_fns * cf)); |
2acceee2 JM |
186 | extern int default_core_sniffer PARAMS ((struct core_fns *cf, bfd *abfd)); |
187 | extern int default_check_format PARAMS ((bfd *abfd)); | |
c906108c | 188 | |
c5aa993b | 189 | #endif /* !defined (GDBCORE_H) */ |