]>
Commit | Line | Data |
---|---|---|
bd5635a1 | 1 | /* Work with executable files, for GDB. |
be772100 | 2 | Copyright 1988, 1989, 1991, 1992 Free Software Foundation, Inc. |
bd5635a1 RP |
3 | |
4 | This file is part of GDB. | |
5 | ||
bdbd5f50 | 6 | This program is free software; you can redistribute it and/or modify |
bd5635a1 | 7 | it under the terms of the GNU General Public License as published by |
bdbd5f50 JG |
8 | the Free Software Foundation; either version 2 of the License, or |
9 | (at your option) any later version. | |
bd5635a1 | 10 | |
bdbd5f50 | 11 | This program is distributed in the hope that it will be useful, |
bd5635a1 RP |
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. | |
15 | ||
16 | You should have received a copy of the GNU General Public License | |
bdbd5f50 JG |
17 | along with this program; if not, write to the Free Software |
18 | Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ | |
bd5635a1 | 19 | |
bd5635a1 | 20 | #include "defs.h" |
bd5635a1 RP |
21 | #include "frame.h" |
22 | #include "inferior.h" | |
23 | #include "target.h" | |
bdbd5f50 | 24 | #include "gdbcmd.h" |
b02fd8ca | 25 | #include "language.h" |
bd5635a1 RP |
26 | |
27 | #ifdef USG | |
28 | #include <sys/types.h> | |
29 | #endif | |
30 | ||
31 | #include <sys/param.h> | |
32 | #include <fcntl.h> | |
bdbd5f50 | 33 | #include <string.h> |
bd5635a1 RP |
34 | |
35 | #include "gdbcore.h" | |
36 | ||
f2ebc25f | 37 | #include <ctype.h> |
bd5635a1 | 38 | #include <sys/stat.h> |
a8e033f2 SG |
39 | #ifndef O_BINARY |
40 | #define O_BINARY 0 | |
41 | #endif | |
bd5635a1 | 42 | |
be772100 JG |
43 | /* Prototypes for local functions */ |
44 | ||
45 | static void | |
46 | add_to_section_table PARAMS ((bfd *, sec_ptr, PTR)); | |
47 | ||
48 | static void | |
49 | exec_close PARAMS ((int)); | |
50 | ||
51 | static void | |
52 | file_command PARAMS ((char *, int)); | |
53 | ||
54 | static void | |
55 | set_section_command PARAMS ((char *, int)); | |
56 | ||
57 | static void | |
58 | exec_files_info PARAMS ((struct target_ops *)); | |
59 | ||
60 | extern int info_verbose; | |
bd5635a1 RP |
61 | |
62 | /* The Binary File Descriptor handle for the executable file. */ | |
63 | ||
64 | bfd *exec_bfd = NULL; | |
65 | ||
bdbd5f50 | 66 | /* Whether to open exec and core files read-only or read-write. */ |
bd5635a1 | 67 | |
bdbd5f50 | 68 | int write_files = 0; |
bd5635a1 | 69 | |
7730bd5a JG |
70 | /* Text start and end addresses (KLUDGE) if needed */ |
71 | ||
dad0e12d | 72 | #ifdef NEED_TEXT_START_END |
7730bd5a JG |
73 | CORE_ADDR text_start = 0; |
74 | CORE_ADDR text_end = 0; | |
75 | #endif | |
76 | ||
bd5635a1 RP |
77 | /* Forward decl */ |
78 | ||
79 | extern struct target_ops exec_ops; | |
80 | ||
bdbd5f50 | 81 | /* ARGSUSED */ |
be772100 | 82 | static void |
bd5635a1 RP |
83 | exec_close (quitting) |
84 | int quitting; | |
85 | { | |
86 | if (exec_bfd) { | |
b1eaba9a | 87 | char *name = bfd_get_filename (exec_bfd); |
bd5635a1 | 88 | bfd_close (exec_bfd); |
b1eaba9a | 89 | free (name); |
bd5635a1 RP |
90 | exec_bfd = NULL; |
91 | } | |
be772100 JG |
92 | if (exec_ops.to_sections) { |
93 | free ((PTR)exec_ops.to_sections); | |
94 | exec_ops.to_sections = NULL; | |
95 | exec_ops.to_sections_end = NULL; | |
bdbd5f50 | 96 | } |
bd5635a1 RP |
97 | } |
98 | ||
be772100 JG |
99 | /* Process the first arg in ARGS as the new exec file. |
100 | ||
101 | Note that we have to explicitly ignore additional args, since we can | |
102 | be called from file_command(), which also calls symbol_file_command() | |
103 | which can take multiple args. */ | |
104 | ||
bd5635a1 | 105 | void |
be772100 JG |
106 | exec_file_command (args, from_tty) |
107 | char *args; | |
bd5635a1 RP |
108 | int from_tty; |
109 | { | |
be772100 JG |
110 | char **argv; |
111 | char *filename; | |
112 | ||
f2fc6e7a | 113 | target_preopen (from_tty); |
bd5635a1 RP |
114 | |
115 | /* Remove any previous exec file. */ | |
116 | unpush_target (&exec_ops); | |
117 | ||
118 | /* Now open and digest the file the user requested, if any. */ | |
119 | ||
be772100 | 120 | if (args) |
bd5635a1 RP |
121 | { |
122 | char *scratch_pathname; | |
123 | int scratch_chan; | |
124 | ||
be772100 JG |
125 | /* Scan through the args and pick up the first non option arg |
126 | as the filename. */ | |
127 | ||
128 | if ((argv = buildargv (args)) == NULL) | |
129 | { | |
130 | nomem (0); | |
131 | } | |
132 | make_cleanup (freeargv, (char *) argv); | |
133 | ||
134 | for (; (*argv != NULL) && (**argv == '-'); argv++) {;} | |
135 | if (*argv == NULL) | |
136 | { | |
137 | error ("no exec file name was specified"); | |
138 | } | |
139 | ||
140 | filename = tilde_expand (*argv); | |
bd5635a1 RP |
141 | make_cleanup (free, filename); |
142 | ||
bdbd5f50 | 143 | scratch_chan = openp (getenv ("PATH"), 1, filename, |
a8e033f2 | 144 | write_files? O_RDWR|O_BINARY: O_RDONLY|O_BINARY, 0, |
bd5635a1 RP |
145 | &scratch_pathname); |
146 | if (scratch_chan < 0) | |
147 | perror_with_name (filename); | |
148 | ||
b1eaba9a | 149 | exec_bfd = bfd_fdopenr (scratch_pathname, gnutarget, scratch_chan); |
bd5635a1 RP |
150 | if (!exec_bfd) |
151 | error ("Could not open `%s' as an executable file: %s", | |
c4a081e1 | 152 | scratch_pathname, bfd_errmsg (bfd_get_error ())); |
bd5635a1 | 153 | if (!bfd_check_format (exec_bfd, bfd_object)) |
b02fd8ca JK |
154 | { |
155 | /* Make sure to close exec_bfd, or else "run" might try to use | |
156 | it. */ | |
157 | exec_close (0); | |
158 | error ("\"%s\": not in executable format: %s.", | |
c4a081e1 | 159 | scratch_pathname, bfd_errmsg (bfd_get_error ())); |
b02fd8ca | 160 | } |
bd5635a1 | 161 | |
be772100 JG |
162 | if (build_section_table (exec_bfd, &exec_ops.to_sections, |
163 | &exec_ops.to_sections_end)) | |
b02fd8ca JK |
164 | { |
165 | /* Make sure to close exec_bfd, or else "run" might try to use | |
166 | it. */ | |
167 | exec_close (0); | |
168 | error ("Can't find the file sections in `%s': %s", | |
c4a081e1 | 169 | exec_bfd->filename, bfd_errmsg (bfd_get_error ())); |
b02fd8ca | 170 | } |
bd5635a1 | 171 | |
dad0e12d | 172 | #ifdef NEED_TEXT_START_END |
b02fd8ca JK |
173 | |
174 | /* text_end is sometimes used for where to put call dummies. A | |
175 | few ports use these for other purposes too. */ | |
176 | ||
7730bd5a JG |
177 | { |
178 | struct section_table *p; | |
b02fd8ca JK |
179 | |
180 | /* Set text_start to the lowest address of the start of any | |
181 | readonly code section and set text_end to the highest | |
182 | address of the end of any readonly code section. */ | |
183 | ||
184 | text_start = ~(CORE_ADDR)0; | |
185 | text_end = (CORE_ADDR)0; | |
be772100 | 186 | for (p = exec_ops.to_sections; p < exec_ops.to_sections_end; p++) |
b02fd8ca JK |
187 | if (bfd_get_section_flags (p->bfd, p->sec_ptr) |
188 | & (SEC_CODE | SEC_READONLY)) | |
dad0e12d | 189 | { |
b02fd8ca JK |
190 | if (text_start > p->addr) |
191 | text_start = p->addr; | |
192 | if (text_end < p->endaddr) | |
193 | text_end = p->endaddr; | |
dad0e12d | 194 | } |
7730bd5a JG |
195 | } |
196 | #endif | |
197 | ||
bd5635a1 RP |
198 | validate_files (); |
199 | ||
200 | push_target (&exec_ops); | |
201 | ||
202 | /* Tell display code (if any) about the changed file name. */ | |
203 | if (exec_file_display_hook) | |
204 | (*exec_file_display_hook) (filename); | |
205 | } | |
206 | else if (from_tty) | |
b02fd8ca | 207 | printf_unfiltered ("No exec file now.\n"); |
bd5635a1 RP |
208 | } |
209 | ||
210 | /* Set both the exec file and the symbol file, in one command. | |
211 | What a novelty. Why did GDB go through four major releases before this | |
212 | command was added? */ | |
213 | ||
be772100 | 214 | static void |
bd5635a1 RP |
215 | file_command (arg, from_tty) |
216 | char *arg; | |
217 | int from_tty; | |
218 | { | |
219 | /* FIXME, if we lose on reading the symbol file, we should revert | |
220 | the exec file, but that's rough. */ | |
221 | exec_file_command (arg, from_tty); | |
222 | symbol_file_command (arg, from_tty); | |
223 | } | |
224 | ||
225 | \f | |
bdbd5f50 JG |
226 | /* Locate all mappable sections of a BFD file. |
227 | table_pp_char is a char * to get it through bfd_map_over_sections; | |
228 | we cast it back to its proper type. */ | |
bd5635a1 | 229 | |
be772100 | 230 | static void |
bdbd5f50 | 231 | add_to_section_table (abfd, asect, table_pp_char) |
bd5635a1 RP |
232 | bfd *abfd; |
233 | sec_ptr asect; | |
be772100 | 234 | PTR table_pp_char; |
bd5635a1 | 235 | { |
bdbd5f50 | 236 | struct section_table **table_pp = (struct section_table **)table_pp_char; |
bd5635a1 RP |
237 | flagword aflag; |
238 | ||
239 | aflag = bfd_get_section_flags (abfd, asect); | |
c4a081e1 | 240 | if (!(aflag & SEC_ALLOC)) |
bd5635a1 | 241 | return; |
dad0e12d JG |
242 | if (0 == bfd_section_size (abfd, asect)) |
243 | return; | |
bdbd5f50 | 244 | (*table_pp)->bfd = abfd; |
bd5635a1 RP |
245 | (*table_pp)->sec_ptr = asect; |
246 | (*table_pp)->addr = bfd_section_vma (abfd, asect); | |
247 | (*table_pp)->endaddr = (*table_pp)->addr + bfd_section_size (abfd, asect); | |
248 | (*table_pp)++; | |
249 | } | |
250 | ||
be772100 JG |
251 | /* Builds a section table, given args BFD, SECTABLE_PTR, SECEND_PTR. |
252 | Returns 0 if OK, 1 on error. */ | |
253 | ||
bd5635a1 RP |
254 | int |
255 | build_section_table (some_bfd, start, end) | |
256 | bfd *some_bfd; | |
257 | struct section_table **start, **end; | |
258 | { | |
259 | unsigned count; | |
260 | ||
261 | count = bfd_count_sections (some_bfd); | |
777bef06 | 262 | if (*start) |
be772100 | 263 | free ((PTR)*start); |
bd5635a1 RP |
264 | *start = (struct section_table *) xmalloc (count * sizeof (**start)); |
265 | *end = *start; | |
bdbd5f50 | 266 | bfd_map_over_sections (some_bfd, add_to_section_table, (char *)end); |
bd5635a1 RP |
267 | if (*end > *start + count) |
268 | abort(); | |
269 | /* We could realloc the table, but it probably loses for most files. */ | |
270 | return 0; | |
271 | } | |
272 | \f | |
273 | /* Read or write the exec file. | |
274 | ||
bdbd5f50 | 275 | Args are address within a BFD file, address within gdb address-space, |
bd5635a1 RP |
276 | length, and a flag indicating whether to read or write. |
277 | ||
278 | Result is a length: | |
279 | ||
280 | 0: We cannot handle this address and length. | |
281 | > 0: We have handled N bytes starting at this address. | |
282 | (If N == length, we did it all.) We might be able | |
283 | to handle more bytes beyond this length, but no | |
284 | promises. | |
285 | < 0: We cannot handle this address, but if somebody | |
286 | else handles (-N) bytes, we can start from there. | |
287 | ||
288 | The same routine is used to handle both core and exec files; | |
289 | we just tail-call it with more arguments to select between them. */ | |
290 | ||
291 | int | |
bdbd5f50 | 292 | xfer_memory (memaddr, myaddr, len, write, target) |
bd5635a1 RP |
293 | CORE_ADDR memaddr; |
294 | char *myaddr; | |
295 | int len; | |
296 | int write; | |
bdbd5f50 | 297 | struct target_ops *target; |
bd5635a1 RP |
298 | { |
299 | boolean res; | |
300 | struct section_table *p; | |
301 | CORE_ADDR nextsectaddr, memend; | |
be772100 | 302 | boolean (*xfer_fn) PARAMS ((bfd *, sec_ptr, PTR, file_ptr, bfd_size_type)); |
bd5635a1 RP |
303 | |
304 | if (len <= 0) | |
305 | abort(); | |
306 | ||
307 | memend = memaddr + len; | |
308 | xfer_fn = write? bfd_set_section_contents: bfd_get_section_contents; | |
309 | nextsectaddr = memend; | |
310 | ||
be772100 | 311 | for (p = target->to_sections; p < target->to_sections_end; p++) |
bd5635a1 RP |
312 | { |
313 | if (p->addr <= memaddr) | |
314 | if (p->endaddr >= memend) | |
315 | { | |
316 | /* Entire transfer is within this section. */ | |
bdbd5f50 | 317 | res = xfer_fn (p->bfd, p->sec_ptr, myaddr, memaddr - p->addr, len); |
bd5635a1 RP |
318 | return (res != false)? len: 0; |
319 | } | |
320 | else if (p->endaddr <= memaddr) | |
321 | { | |
322 | /* This section ends before the transfer starts. */ | |
323 | continue; | |
324 | } | |
325 | else | |
326 | { | |
327 | /* This section overlaps the transfer. Just do half. */ | |
328 | len = p->endaddr - memaddr; | |
bdbd5f50 | 329 | res = xfer_fn (p->bfd, p->sec_ptr, myaddr, memaddr - p->addr, len); |
bd5635a1 RP |
330 | return (res != false)? len: 0; |
331 | } | |
332 | else if (p->addr < nextsectaddr) | |
333 | nextsectaddr = p->addr; | |
334 | } | |
335 | ||
336 | if (nextsectaddr >= memend) | |
337 | return 0; /* We can't help */ | |
338 | else | |
339 | return - (nextsectaddr - memaddr); /* Next boundary where we can help */ | |
340 | } | |
341 | ||
bd5635a1 RP |
342 | #ifdef FIXME |
343 | #ifdef REG_STACK_SEGMENT | |
344 | /* MOVE TO BFD... */ | |
345 | /* Pyramids and AM29000s have an extra segment in the virtual address space | |
346 | for the (control) stack of register-window frames. The AM29000 folk | |
347 | call it the "register stack" rather than the "memory stack". */ | |
348 | else if (memaddr >= reg_stack_start && memaddr < reg_stack_end) | |
349 | { | |
350 | i = min (len, reg_stack_end - memaddr); | |
351 | fileptr = memaddr - reg_stack_start + reg_stack_offset; | |
352 | wanna_xfer = coredata; | |
353 | } | |
354 | #endif /* REG_STACK_SEGMENT */ | |
117f631e | 355 | #endif /* FIXME */ |
bd5635a1 | 356 | \f |
be772100 JG |
357 | void |
358 | print_section_info (t, abfd) | |
359 | struct target_ops *t; | |
360 | bfd *abfd; | |
bd5635a1 RP |
361 | { |
362 | struct section_table *p; | |
363 | ||
be772100 | 364 | printf_filtered ("\t`%s', ", bfd_get_filename(abfd)); |
7d9884b9 | 365 | wrap_here (" "); |
be772100 | 366 | printf_filtered ("file type %s.\n", bfd_get_target(abfd)); |
c4a081e1 DM |
367 | printf_filtered ("\tEntry point: "); |
368 | print_address_numeric (bfd_get_start_address (exec_bfd), gdb_stdout); | |
369 | printf_filtered ("\n"); | |
370 | for (p = t->to_sections; p < t->to_sections_end; p++) | |
371 | { | |
372 | /* FIXME-32x64 need a print_address_numeric with field width */ | |
373 | printf_filtered ("\t%s", local_hex_string_custom ((unsigned long) p->addr, "08l")); | |
374 | printf_filtered (" - %s", local_hex_string_custom ((unsigned long) p->endaddr, "08l")); | |
375 | if (info_verbose) | |
376 | printf_filtered (" @ %s", | |
377 | local_hex_string_custom ((unsigned long) p->sec_ptr->filepos, "08l")); | |
378 | printf_filtered (" is %s", bfd_section_name (p->bfd, p->sec_ptr)); | |
379 | if (p->bfd != abfd) | |
380 | { | |
381 | printf_filtered (" in %s", bfd_get_filename (p->bfd)); | |
382 | } | |
383 | printf_filtered ("\n"); | |
be772100 | 384 | } |
bd5635a1 RP |
385 | } |
386 | ||
be772100 JG |
387 | static void |
388 | exec_files_info (t) | |
389 | struct target_ops *t; | |
390 | { | |
391 | print_section_info (t, exec_bfd); | |
392 | } | |
393 | ||
f2fc6e7a JK |
394 | static void |
395 | set_section_command (args, from_tty) | |
396 | char *args; | |
397 | int from_tty; | |
398 | { | |
399 | struct section_table *p; | |
400 | char *secname; | |
401 | unsigned seclen; | |
402 | unsigned long secaddr; | |
403 | char secprint[100]; | |
404 | long offset; | |
405 | ||
406 | if (args == 0) | |
407 | error ("Must specify section name and its virtual address"); | |
408 | ||
409 | /* Parse out section name */ | |
410 | for (secname = args; !isspace(*args); args++) ; | |
411 | seclen = args - secname; | |
412 | ||
413 | /* Parse out new virtual address */ | |
414 | secaddr = parse_and_eval_address (args); | |
415 | ||
be772100 | 416 | for (p = exec_ops.to_sections; p < exec_ops.to_sections_end; p++) { |
f2fc6e7a JK |
417 | if (!strncmp (secname, bfd_section_name (exec_bfd, p->sec_ptr), seclen) |
418 | && bfd_section_name (exec_bfd, p->sec_ptr)[seclen] == '\0') { | |
419 | offset = secaddr - p->addr; | |
420 | p->addr += offset; | |
421 | p->endaddr += offset; | |
be772100 JG |
422 | if (from_tty) |
423 | exec_files_info(&exec_ops); | |
f2fc6e7a JK |
424 | return; |
425 | } | |
426 | } | |
427 | if (seclen >= sizeof (secprint)) | |
428 | seclen = sizeof (secprint) - 1; | |
429 | strncpy (secprint, secname, seclen); | |
430 | secprint[seclen] = '\0'; | |
431 | error ("Section %s not found", secprint); | |
432 | } | |
433 | ||
b1eaba9a | 434 | /* If mourn is being called in all the right places, this could be say |
b02fd8ca | 435 | `gdb internal error' (since generic_mourn calls breakpoint_init_inferior). */ |
b1eaba9a SG |
436 | |
437 | static int | |
438 | ignore (addr, contents) | |
439 | CORE_ADDR addr; | |
440 | char *contents; | |
441 | { | |
442 | return 0; | |
443 | } | |
444 | ||
bd5635a1 RP |
445 | struct target_ops exec_ops = { |
446 | "exec", "Local exec file", | |
f2fc6e7a JK |
447 | "Use an executable file as a target.\n\ |
448 | Specify the filename of the executable file.", | |
bd5635a1 | 449 | exec_file_command, exec_close, /* open, close */ |
117f631e | 450 | find_default_attach, 0, 0, 0, /* attach, detach, resume, wait, */ |
bd5635a1 | 451 | 0, 0, /* fetch_registers, store_registers, */ |
a03d4f8e | 452 | 0, /* prepare_to_store, */ |
bdbd5f50 | 453 | xfer_memory, exec_files_info, |
b1eaba9a | 454 | ignore, ignore, /* insert_breakpoint, remove_breakpoint, */ |
bd5635a1 | 455 | 0, 0, 0, 0, 0, /* terminal stuff */ |
64e52224 | 456 | 0, 0, /* kill, load */ |
be772100 | 457 | 0, /* lookup sym */ |
117f631e | 458 | find_default_create_inferior, |
bd5635a1 | 459 | 0, /* mourn_inferior */ |
117f631e ILT |
460 | 0, /* can_run */ |
461 | 0, /* notice_signals */ | |
bd5635a1 RP |
462 | file_stratum, 0, /* next */ |
463 | 0, 1, 0, 0, 0, /* all mem, mem, stack, regs, exec */ | |
bdbd5f50 | 464 | 0, 0, /* section pointers */ |
bd5635a1 RP |
465 | OPS_MAGIC, /* Always the last thing */ |
466 | }; | |
467 | ||
468 | void | |
469 | _initialize_exec() | |
470 | { | |
b1eaba9a | 471 | struct cmd_list_element *c; |
bd5635a1 | 472 | |
b1eaba9a SG |
473 | c = add_cmd ("file", class_files, file_command, |
474 | "Use FILE as program to be debugged.\n\ | |
bd5635a1 RP |
475 | It is read for its symbols, for getting the contents of pure memory,\n\ |
476 | and it is the program executed when you use the `run' command.\n\ | |
477 | If FILE cannot be found as specified, your execution directory path\n\ | |
478 | ($PATH) is searched for a command of that name.\n\ | |
b1eaba9a SG |
479 | No arg means to have no executable file and no symbols.", &cmdlist); |
480 | c->completer = filename_completer; | |
bd5635a1 | 481 | |
b1eaba9a | 482 | c = add_cmd ("exec-file", class_files, exec_file_command, |
bd5635a1 RP |
483 | "Use FILE as program for getting contents of pure memory.\n\ |
484 | If FILE cannot be found as specified, your execution directory path\n\ | |
485 | is searched for a command of that name.\n\ | |
b1eaba9a SG |
486 | No arg means have no executable file.", &cmdlist); |
487 | c->completer = filename_completer; | |
bd5635a1 | 488 | |
f2fc6e7a JK |
489 | add_com ("section", class_files, set_section_command, |
490 | "Change the base address of section SECTION of the exec file to ADDR.\n\ | |
491 | This can be used if the exec file does not contain section addresses,\n\ | |
492 | (such as in the a.out format), or when the addresses specified in the\n\ | |
493 | file itself are wrong. Each section must be changed separately. The\n\ | |
494 | ``info files'' command lists all the sections and their addresses."); | |
495 | ||
bdbd5f50 JG |
496 | add_show_from_set |
497 | (add_set_cmd ("write", class_support, var_boolean, (char *)&write_files, | |
498 | "Set writing into executable and core files.", | |
499 | &setlist), | |
500 | &showlist); | |
501 | ||
bd5635a1 RP |
502 | add_target (&exec_ops); |
503 | } |