1 /* Work with executable files, for GDB.
2 Copyright 1988, 1989, 1991, 1992, 1993, 1994 Free Software Foundation, Inc.
4 This file is part of GDB.
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.
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.
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, Boston, MA 02111-1307, USA. */
30 #include <sys/types.h>
33 #include <sys/param.h>
35 #include "gdb_string.h"
45 #include "xcoffsolib.h"
47 struct vmap *map_vmap PARAMS ((bfd *, bfd *));
49 /* Prototypes for local functions */
51 static void add_to_section_table PARAMS ((bfd *, sec_ptr, PTR));
53 static void exec_close PARAMS ((int));
55 static void file_command PARAMS ((char *, int));
57 static void set_section_command PARAMS ((char *, int));
59 static void exec_files_info PARAMS ((struct target_ops *));
61 static void bfdsec_to_vmap PARAMS ((bfd *, sec_ptr, PTR));
63 static int ignore PARAMS ((CORE_ADDR, char *));
65 extern int info_verbose;
67 /* The Binary File Descriptor handle for the executable file. */
71 /* Whether to open exec and core files read-only or read-write. */
75 /* Text start and end addresses (KLUDGE) if needed */
77 #ifdef NEED_TEXT_START_END
78 CORE_ADDR text_start = 0;
79 CORE_ADDR text_end = 0;
86 extern struct target_ops exec_ops;
93 int need_symtab_cleanup = 0;
94 struct vmap *vp, *nxt;
96 for (nxt = vmap; nxt != NULL; )
101 /* if there is an objfile associated with this bfd,
102 free_objfile() will do proper cleanup of objfile *and* bfd. */
106 free_objfile (vp->objfile);
107 need_symtab_cleanup = 1;
109 else if (vp->bfd != exec_bfd)
110 /* FIXME-leak: We should be freeing vp->name too, I think. */
111 if (!bfd_close (vp->bfd))
112 warning ("cannot close \"%s\": %s",
113 vp->name, bfd_errmsg (bfd_get_error ()));
115 /* FIXME: This routine is #if 0'd in symfile.c. What should we
116 be doing here? Should we just free everything in
117 vp->objfile->symtabs? Should free_objfile do that?
118 FIXME-as-well: free_objfile already free'd vp->name, so it isn't
120 free_named_symtabs (vp->name);
128 char *name = bfd_get_filename (exec_bfd);
130 if (!bfd_close (exec_bfd))
131 warning ("cannot close \"%s\": %s",
132 name, bfd_errmsg (bfd_get_error ()));
137 if (exec_ops.to_sections)
139 free ((PTR)exec_ops.to_sections);
140 exec_ops.to_sections = NULL;
141 exec_ops.to_sections_end = NULL;
145 /* Process the first arg in ARGS as the new exec file.
147 Note that we have to explicitly ignore additional args, since we can
148 be called from file_command(), which also calls symbol_file_command()
149 which can take multiple args. */
152 exec_file_command (args, from_tty)
159 target_preopen (from_tty);
161 /* Remove any previous exec file. */
162 unpush_target (&exec_ops);
164 /* Now open and digest the file the user requested, if any. */
168 char *scratch_pathname;
171 /* Scan through the args and pick up the first non option arg
174 argv = buildargv (args);
178 make_cleanup (freeargv, (char *) argv);
180 for (; (*argv != NULL) && (**argv == '-'); argv++) {;}
182 error ("no exec file name was specified");
184 filename = tilde_expand (*argv);
185 make_cleanup (free, filename);
187 scratch_chan = openp (getenv ("PATH"), 1, filename,
188 write_files? O_RDWR|O_BINARY: O_RDONLY|O_BINARY, 0,
190 #if defined(__GO32__) || defined(__WIN32__)
191 if (scratch_chan < 0)
193 char *exename = alloca (strlen (filename) + 5);
194 strcat (strcpy (exename, filename), ".exe");
195 scratch_chan = openp (getenv ("PATH"), 1, exename, write_files ?
196 O_RDWR|O_BINARY : O_RDONLY|O_BINARY, 0, &scratch_pathname);
199 if (scratch_chan < 0)
200 perror_with_name (filename);
201 exec_bfd = bfd_fdopenr (scratch_pathname, gnutarget, scratch_chan);
204 error ("\"%s\": could not open as an executable file: %s",
205 scratch_pathname, bfd_errmsg (bfd_get_error ()));
207 /* At this point, scratch_pathname and exec_bfd->name both point to the
208 same malloc'd string. However exec_close() will attempt to free it
209 via the exec_bfd->name pointer, so we need to make another copy and
210 leave exec_bfd as the new owner of the original copy. */
211 scratch_pathname = strdup (scratch_pathname);
212 make_cleanup (free, scratch_pathname);
214 if (!bfd_check_format (exec_bfd, bfd_object))
216 /* Make sure to close exec_bfd, or else "run" might try to use
219 error ("\"%s\": not in executable format: %s",
220 scratch_pathname, bfd_errmsg (bfd_get_error ()));
223 /* FIXME - This should only be run for RS6000, but the ifdef is a poor
224 way to accomplish. */
225 #ifdef IBM6000_TARGET
226 /* Setup initial vmap. */
228 map_vmap (exec_bfd, 0);
231 /* Make sure to close exec_bfd, or else "run" might try to use
234 error ("\"%s\": can't find the file sections: %s",
235 scratch_pathname, bfd_errmsg (bfd_get_error ()));
237 #endif /* IBM6000_TARGET */
239 if (build_section_table (exec_bfd, &exec_ops.to_sections,
240 &exec_ops.to_sections_end))
242 /* Make sure to close exec_bfd, or else "run" might try to use
245 error ("\"%s\": can't find the file sections: %s",
246 scratch_pathname, bfd_errmsg (bfd_get_error ()));
249 #ifdef NEED_TEXT_START_END
251 /* text_end is sometimes used for where to put call dummies. A
252 few ports use these for other purposes too. */
255 struct section_table *p;
257 /* Set text_start to the lowest address of the start of any
258 readonly code section and set text_end to the highest
259 address of the end of any readonly code section. */
260 /* FIXME: The comment above does not match the code. The code
261 checks for sections with are either code *or* readonly. */
263 text_start = ~(CORE_ADDR)0;
264 text_end = (CORE_ADDR)0;
265 for (p = exec_ops.to_sections; p < exec_ops.to_sections_end; p++)
266 if (bfd_get_section_flags (p->bfd, p->the_bfd_section)
267 & (SEC_CODE | SEC_READONLY))
269 if (text_start > p->addr)
270 text_start = p->addr;
271 if (text_end < p->endaddr)
272 text_end = p->endaddr;
279 set_endian_from_file (exec_bfd);
281 push_target (&exec_ops);
283 /* Tell display code (if any) about the changed file name. */
284 if (exec_file_display_hook)
285 (*exec_file_display_hook) (filename);
288 printf_unfiltered ("No exec file now.\n");
291 /* Set both the exec file and the symbol file, in one command.
292 What a novelty. Why did GDB go through four major releases before this
293 command was added? */
296 file_command (arg, from_tty)
300 /* FIXME, if we lose on reading the symbol file, we should revert
301 the exec file, but that's rough. */
302 exec_file_command (arg, from_tty);
303 symbol_file_command (arg, from_tty);
307 /* Locate all mappable sections of a BFD file.
308 table_pp_char is a char * to get it through bfd_map_over_sections;
309 we cast it back to its proper type. */
312 add_to_section_table (abfd, asect, table_pp_char)
317 struct section_table **table_pp = (struct section_table **)table_pp_char;
320 aflag = bfd_get_section_flags (abfd, asect);
321 if (!(aflag & SEC_ALLOC))
323 if (0 == bfd_section_size (abfd, asect))
325 (*table_pp)->bfd = abfd;
326 (*table_pp)->the_bfd_section = asect;
327 (*table_pp)->addr = bfd_section_vma (abfd, asect);
328 (*table_pp)->endaddr = (*table_pp)->addr + bfd_section_size (abfd, asect);
332 /* Builds a section table, given args BFD, SECTABLE_PTR, SECEND_PTR.
333 Returns 0 if OK, 1 on error. */
336 build_section_table (some_bfd, start, end)
338 struct section_table **start, **end;
342 count = bfd_count_sections (some_bfd);
345 *start = (struct section_table *) xmalloc (count * sizeof (**start));
347 bfd_map_over_sections (some_bfd, add_to_section_table, (char *)end);
348 if (*end > *start + count)
350 /* We could realloc the table, but it probably loses for most files. */
355 bfdsec_to_vmap(abfd, sect, arg3)
360 struct vmap_and_bfd *vmap_bfd = (struct vmap_and_bfd *) arg3;
363 vp = vmap_bfd->pvmap;
365 if ((bfd_get_section_flags (abfd, sect) & SEC_LOAD) == 0)
368 if (STREQ (bfd_section_name (abfd, sect), ".text"))
371 vp->tend = vp->tstart + bfd_section_size (abfd, sect);
373 /* When it comes to this adjustment value, in contrast to our previous
374 belief shared objects should behave the same as the main load segment.
375 This is the offset from the beginning of text section to the first
378 vp->tadj = sect->filepos - bfd_section_vma (abfd, sect);
380 else if (STREQ (bfd_section_name (abfd, sect), ".data"))
383 vp->dend = vp->dstart + bfd_section_size (abfd, sect);
385 /* Silently ignore other types of sections. (FIXME?) */
388 /* Make a vmap for ABFD which might be a member of the archive ARCH.
389 Return the new vmap. */
392 map_vmap (abfd, arch)
396 struct vmap_and_bfd vmap_bfd;
397 struct vmap *vp, **vpp;
399 vp = (struct vmap *) xmalloc (sizeof (*vp));
400 memset ((char *) vp, '\0', sizeof (*vp));
403 vp->name = bfd_get_filename (arch ? arch : abfd);
404 vp->member = arch ? bfd_get_filename (abfd) : "";
406 vmap_bfd.pbfd = arch;
408 bfd_map_over_sections (abfd, bfdsec_to_vmap, &vmap_bfd);
410 /* Find the end of the list and append. */
411 for (vpp = &vmap; *vpp; vpp = &(*vpp)->nxt)
418 /* Read or write the exec file.
420 Args are address within a BFD file, address within gdb address-space,
421 length, and a flag indicating whether to read or write.
425 0: We cannot handle this address and length.
426 > 0: We have handled N bytes starting at this address.
427 (If N == length, we did it all.) We might be able
428 to handle more bytes beyond this length, but no
430 < 0: We cannot handle this address, but if somebody
431 else handles (-N) bytes, we can start from there.
433 The same routine is used to handle both core and exec files;
434 we just tail-call it with more arguments to select between them. */
437 xfer_memory (memaddr, myaddr, len, write, target)
442 struct target_ops *target;
445 struct section_table *p;
446 CORE_ADDR nextsectaddr, memend;
447 boolean (*xfer_fn) PARAMS ((bfd *, sec_ptr, PTR, file_ptr, bfd_size_type));
452 memend = memaddr + len;
453 xfer_fn = write ? bfd_set_section_contents : bfd_get_section_contents;
454 nextsectaddr = memend;
456 for (p = target->to_sections; p < target->to_sections_end; p++)
458 if (p->addr <= memaddr)
459 if (p->endaddr >= memend)
461 /* Entire transfer is within this section. */
462 res = xfer_fn (p->bfd, p->the_bfd_section, myaddr,
463 memaddr - p->addr, len);
464 return (res != 0) ? len : 0;
466 else if (p->endaddr <= memaddr)
468 /* This section ends before the transfer starts. */
473 /* This section overlaps the transfer. Just do half. */
474 len = p->endaddr - memaddr;
475 res = xfer_fn (p->bfd, p->the_bfd_section, myaddr,
476 memaddr - p->addr, len);
477 return (res != 0) ? len : 0;
479 else if (p->addr < nextsectaddr)
480 nextsectaddr = p->addr;
483 if (nextsectaddr >= memend)
484 return 0; /* We can't help */
486 return - (nextsectaddr - memaddr); /* Next boundary where we can help */
490 #ifdef REG_STACK_SEGMENT
492 /* Pyramids and AM29000s have an extra segment in the virtual address space
493 for the (control) stack of register-window frames. The AM29000 folk
494 call it the "register stack" rather than the "memory stack". */
495 else if (memaddr >= reg_stack_start && memaddr < reg_stack_end)
497 i = min (len, reg_stack_end - memaddr);
498 fileptr = memaddr - reg_stack_start + reg_stack_offset;
499 wanna_xfer = coredata;
501 #endif /* REG_STACK_SEGMENT */
505 print_section_info (t, abfd)
506 struct target_ops *t;
509 struct section_table *p;
511 printf_filtered ("\t`%s', ", bfd_get_filename(abfd));
513 printf_filtered ("file type %s.\n", bfd_get_target(abfd));
514 if (abfd == exec_bfd)
516 printf_filtered ("\tEntry point: ");
517 print_address_numeric (bfd_get_start_address (abfd), 1, gdb_stdout);
518 printf_filtered ("\n");
520 for (p = t->to_sections; p < t->to_sections_end; p++)
522 /* FIXME-32x64 need a print_address_numeric with field width */
523 printf_filtered ("\t%s", local_hex_string_custom ((unsigned long) p->addr, "08l"));
524 printf_filtered (" - %s", local_hex_string_custom ((unsigned long) p->endaddr, "08l"));
526 printf_filtered (" @ %s",
527 local_hex_string_custom ((unsigned long) p->the_bfd_section->filepos, "08l"));
528 printf_filtered (" is %s", bfd_section_name (p->bfd, p->the_bfd_section));
531 printf_filtered (" in %s", bfd_get_filename (p->bfd));
533 printf_filtered ("\n");
539 struct target_ops *t;
541 print_section_info (t, exec_bfd);
547 printf_unfiltered ("\tMapping info for file `%s'.\n", vmap->name);
548 printf_unfiltered ("\t %8.8s %8.8s %8.8s %8.8s %8.8s %s\n",
549 "tstart", "tend", "dstart", "dend", "section",
552 for (vp = vmap; vp; vp = vp->nxt)
553 printf_unfiltered ("\t0x%8.8x 0x%8.8x 0x%8.8x 0x%8.8x %s%s%s%s\n",
554 vp->tstart, vp->tend, vp->dstart, vp->dend, vp->name,
555 *vp->member ? "(" : "", vp->member,
556 *vp->member ? ")" : "");
561 set_section_command (args, from_tty)
565 struct section_table *p;
568 unsigned long secaddr;
573 error ("Must specify section name and its virtual address");
575 /* Parse out section name */
576 for (secname = args; !isspace(*args); args++) ;
577 seclen = args - secname;
579 /* Parse out new virtual address */
580 secaddr = parse_and_eval_address (args);
582 for (p = exec_ops.to_sections; p < exec_ops.to_sections_end; p++) {
583 if (!strncmp (secname, bfd_section_name (exec_bfd, p->the_bfd_section), seclen)
584 && bfd_section_name (exec_bfd, p->the_bfd_section)[seclen] == '\0') {
585 offset = secaddr - p->addr;
587 p->endaddr += offset;
589 exec_files_info(&exec_ops);
593 if (seclen >= sizeof (secprint))
594 seclen = sizeof (secprint) - 1;
595 strncpy (secprint, secname, seclen);
596 secprint[seclen] = '\0';
597 error ("Section %s not found", secprint);
600 /* If mourn is being called in all the right places, this could be say
601 `gdb internal error' (since generic_mourn calls breakpoint_init_inferior). */
604 ignore (addr, contents)
611 struct target_ops exec_ops = {
612 "exec", /* to_shortname */
613 "Local exec file", /* to_longname */
614 "Use an executable file as a target.\n\
615 Specify the filename of the executable file.", /* to_doc */
616 exec_file_command, /* to_open */
617 exec_close, /* to_close */
618 find_default_attach, /* to_attach */
622 0, /* to_fetch_registers */
623 0, /* to_store_registers */
624 0, /* to_prepare_to_store */
625 xfer_memory, /* to_xfer_memory */
626 exec_files_info, /* to_files_info */
627 ignore, /* to_insert_breakpoint */
628 ignore, /* to_remove_breakpoint */
629 0, /* to_terminal_init */
630 0, /* to_terminal_inferior */
631 0, /* to_terminal_ours_for_output */
632 0, /* to_terminal_ours */
633 0, /* to_terminal_info */
636 0, /* to_lookup_symbol */
637 find_default_create_inferior, /* to_create_inferior */
638 0, /* to_mourn_inferior */
640 0, /* to_notice_signals */
641 0, /* to_thread_alive */
643 file_stratum, /* to_stratum */
645 0, /* to_has_all_memory */
646 1, /* to_has_memory */
647 0, /* to_has_stack */
648 0, /* to_has_registers */
649 0, /* to_has_execution */
651 0, /* to_sections_end */
652 OPS_MAGIC, /* to_magic */
658 struct cmd_list_element *c;
660 c = add_cmd ("file", class_files, file_command,
661 "Use FILE as program to be debugged.\n\
662 It is read for its symbols, for getting the contents of pure memory,\n\
663 and it is the program executed when you use the `run' command.\n\
664 If FILE cannot be found as specified, your execution directory path\n\
665 ($PATH) is searched for a command of that name.\n\
666 No arg means to have no executable file and no symbols.", &cmdlist);
667 c->completer = filename_completer;
669 c = add_cmd ("exec-file", class_files, exec_file_command,
670 "Use FILE as program for getting contents of pure memory.\n\
671 If FILE cannot be found as specified, your execution directory path\n\
672 is searched for a command of that name.\n\
673 No arg means have no executable file.", &cmdlist);
674 c->completer = filename_completer;
676 add_com ("section", class_files, set_section_command,
677 "Change the base address of section SECTION of the exec file to ADDR.\n\
678 This can be used if the exec file does not contain section addresses,\n\
679 (such as in the a.out format), or when the addresses specified in the\n\
680 file itself are wrong. Each section must be changed separately. The\n\
681 ``info files'' command lists all the sections and their addresses.");
684 (add_set_cmd ("write", class_support, var_boolean, (char *)&write_files,
685 "Set writing into executable and core files.",
689 add_target (&exec_ops);