1 /* Work with executable files, for GDB.
3 Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997,
4 1998, 1999, 2000, 2001, 2002, 2003, 2007, 2008, 2009, 2010, 2011
5 Free Software Foundation, Inc.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
28 #include "filenames.h"
31 #include "completer.h"
35 #include "arch-utils.h"
36 #include "gdbthread.h"
37 #include "progspace.h"
40 #include "readline/readline.h"
41 #include "gdb_string.h"
48 #include "xcoffsolib.h"
50 struct vmap *map_vmap (bfd *, bfd *);
52 void (*deprecated_file_changed_hook) (char *);
54 /* Prototypes for local functions */
56 static void file_command (char *, int);
58 static void set_section_command (char *, int);
60 static void exec_files_info (struct target_ops *);
62 static void init_exec_ops (void);
64 void _initialize_exec (void);
66 /* The target vector for executable files. */
68 struct target_ops exec_ops;
70 /* True if the exec target is pushed on the stack. */
71 static int using_exec_ops;
73 /* Whether to open exec and core files read-only or read-write. */
77 show_write_files (struct ui_file *file, int from_tty,
78 struct cmd_list_element *c, const char *value)
80 fprintf_filtered (file, _("Writing into executable and core files is %s.\n"),
88 exec_open (char *args, int from_tty)
90 target_preopen (from_tty);
91 exec_file_attach (args, from_tty);
94 /* Close and clear exec_bfd. If we end up with no target sections to
95 read memory from, this unpushes the exec_ops target. */
102 bfd *abfd = exec_bfd;
103 char *name = bfd_get_filename (abfd);
105 gdb_bfd_close_or_warn (abfd);
108 /* Removing target sections may close the exec_ops target.
109 Clear exec_bfd before doing so to prevent recursion. */
113 remove_target_sections (abfd);
117 /* This is the target_close implementation. Clears all target
118 sections and closes all executable bfds from all program spaces. */
121 exec_close_1 (int quitting)
123 int need_symtab_cleanup = 0;
124 struct vmap *vp, *nxt;
128 for (nxt = vmap; nxt != NULL;)
133 /* if there is an objfile associated with this bfd,
134 free_objfile() will do proper cleanup of objfile *and* bfd. */
138 free_objfile (vp->objfile);
139 need_symtab_cleanup = 1;
141 else if (vp->bfd != exec_bfd)
142 /* FIXME-leak: We should be freeing vp->name too, I think. */
143 gdb_bfd_close_or_warn (vp->bfd);
151 struct program_space *ss;
152 struct cleanup *old_chain;
154 old_chain = save_current_program_space ();
157 set_current_program_space (ss);
159 /* Delete all target sections. */
161 (current_target_sections,
162 -resize_section_table (current_target_sections, 0));
167 do_cleanups (old_chain);
172 exec_file_clear (int from_tty)
174 /* Remove exec file. */
178 printf_unfiltered (_("No executable file now.\n"));
181 /* Set FILENAME as the new exec file.
183 This function is intended to be behave essentially the same
184 as exec_file_command, except that the latter will detect when
185 a target is being debugged, and will ask the user whether it
186 should be shut down first. (If the answer is "no", then the
187 new file is ignored.)
189 This file is used by exec_file_command, to do the work of opening
190 and processing the exec file after any prompting has happened.
192 And, it is used by child_attach, when the attach command was
193 given a pid but not a exec pathname, and the attach command could
194 figure out the pathname from the pid. (In this case, we shouldn't
195 ask the user whether the current target should be shut down --
196 we're supplying the exec pathname late for good reason.) */
199 exec_file_attach (char *filename, int from_tty)
201 /* Remove any previous exec file. */
204 /* Now open and digest the file the user requested, if any. */
209 printf_unfiltered (_("No executable file now.\n"));
211 set_gdbarch_from_file (NULL);
215 struct cleanup *cleanups;
216 char *scratch_pathname;
218 struct target_section *sections = NULL, *sections_end = NULL;
221 scratch_chan = openp (getenv ("PATH"), OPF_TRY_CWD_FIRST, filename,
222 write_files ? O_RDWR | O_BINARY : O_RDONLY | O_BINARY,
224 #if defined(__GO32__) || defined(_WIN32) || defined(__CYGWIN__)
225 if (scratch_chan < 0)
227 char *exename = alloca (strlen (filename) + 5);
229 strcat (strcpy (exename, filename), ".exe");
230 scratch_chan = openp (getenv ("PATH"), OPF_TRY_CWD_FIRST, exename,
231 write_files ? O_RDWR | O_BINARY : O_RDONLY | O_BINARY,
235 if (scratch_chan < 0)
236 perror_with_name (filename);
237 exec_bfd = bfd_fopen (scratch_pathname, gnutarget,
238 write_files ? FOPEN_RUB : FOPEN_RB,
243 close (scratch_chan);
244 error (_("\"%s\": could not open as an executable file: %s"),
245 scratch_pathname, bfd_errmsg (bfd_get_error ()));
248 /* At this point, scratch_pathname and exec_bfd->name both point to the
249 same malloc'd string. However exec_close() will attempt to free it
250 via the exec_bfd->name pointer, so we need to make another copy and
251 leave exec_bfd as the new owner of the original copy. */
252 scratch_pathname = xstrdup (scratch_pathname);
253 cleanups = make_cleanup (xfree, scratch_pathname);
255 if (!bfd_check_format_matches (exec_bfd, bfd_object, &matching))
257 /* Make sure to close exec_bfd, or else "run" might try to use
260 error (_("\"%s\": not in executable format: %s"),
262 gdb_bfd_errmsg (bfd_get_error (), matching));
265 /* FIXME - This should only be run for RS6000, but the ifdef is a poor
266 way to accomplish. */
267 #ifdef DEPRECATED_IBM6000_TARGET
268 /* Setup initial vmap. */
270 map_vmap (exec_bfd, 0);
273 /* Make sure to close exec_bfd, or else "run" might try to use
276 error (_("\"%s\": can't find the file sections: %s"),
277 scratch_pathname, bfd_errmsg (bfd_get_error ()));
279 #endif /* DEPRECATED_IBM6000_TARGET */
281 if (build_section_table (exec_bfd, §ions, §ions_end))
283 /* Make sure to close exec_bfd, or else "run" might try to use
286 error (_("\"%s\": can't find the file sections: %s"),
287 scratch_pathname, bfd_errmsg (bfd_get_error ()));
290 exec_bfd_mtime = bfd_get_mtime (exec_bfd);
294 set_gdbarch_from_file (exec_bfd);
296 /* Add the executable's sections to the current address spaces'
297 list of sections. This possibly pushes the exec_ops
299 add_target_sections (sections, sections_end);
302 /* Tell display code (if any) about the changed file name. */
303 if (deprecated_exec_file_display_hook)
304 (*deprecated_exec_file_display_hook) (filename);
306 do_cleanups (cleanups);
308 bfd_cache_close_all ();
309 observer_notify_executable_changed ();
312 /* Process the first arg in ARGS as the new exec file.
314 Note that we have to explicitly ignore additional args, since we can
315 be called from file_command(), which also calls symbol_file_command()
316 which can take multiple args.
318 If ARGS is NULL, we just want to close the exec file. */
321 exec_file_command (char *args, int from_tty)
326 if (from_tty && target_has_execution
327 && !query (_("A program is being debugged already.\n"
328 "Are you sure you want to change the file? ")))
329 error (_("File not changed."));
333 struct cleanup *cleanups;
335 /* Scan through the args and pick up the first non option arg
338 argv = gdb_buildargv (args);
339 cleanups = make_cleanup_freeargv (argv);
341 for (; (*argv != NULL) && (**argv == '-'); argv++)
345 error (_("No executable file name was specified"));
347 filename = tilde_expand (*argv);
348 make_cleanup (xfree, filename);
349 exec_file_attach (filename, from_tty);
351 do_cleanups (cleanups);
354 exec_file_attach (NULL, from_tty);
357 /* Set both the exec file and the symbol file, in one command.
358 What a novelty. Why did GDB go through four major releases before this
359 command was added? */
362 file_command (char *arg, int from_tty)
364 /* FIXME, if we lose on reading the symbol file, we should revert
365 the exec file, but that's rough. */
366 exec_file_command (arg, from_tty);
367 symbol_file_command (arg, from_tty);
368 if (deprecated_file_changed_hook)
369 deprecated_file_changed_hook (arg);
373 /* Locate all mappable sections of a BFD file.
374 table_pp_char is a char * to get it through bfd_map_over_sections;
375 we cast it back to its proper type. */
378 add_to_section_table (bfd *abfd, struct bfd_section *asect,
381 struct target_section **table_pp = (struct target_section **) table_pp_char;
384 /* Check the section flags, but do not discard zero-length sections, since
385 some symbols may still be attached to this section. For instance, we
386 encountered on sparc-solaris 2.10 a shared library with an empty .bss
387 section to which a symbol named "_end" was attached. The address
388 of this symbol still needs to be relocated. */
389 aflag = bfd_get_section_flags (abfd, asect);
390 if (!(aflag & SEC_ALLOC))
393 (*table_pp)->bfd = abfd;
394 (*table_pp)->the_bfd_section = asect;
395 (*table_pp)->addr = bfd_section_vma (abfd, asect);
396 (*table_pp)->endaddr = (*table_pp)->addr + bfd_section_size (abfd, asect);
401 resize_section_table (struct target_section_table *table, int num_added)
403 struct target_section *old_value;
407 old_value = table->sections;
408 old_count = table->sections_end - table->sections;
410 new_count = num_added + old_count;
414 table->sections = xrealloc (table->sections,
415 sizeof (struct target_section) * new_count);
416 table->sections_end = table->sections + new_count;
420 xfree (table->sections);
421 table->sections = table->sections_end = NULL;
427 /* Builds a section table, given args BFD, SECTABLE_PTR, SECEND_PTR.
428 Returns 0 if OK, 1 on error. */
431 build_section_table (struct bfd *some_bfd, struct target_section **start,
432 struct target_section **end)
436 count = bfd_count_sections (some_bfd);
439 *start = (struct target_section *) xmalloc (count * sizeof (**start));
441 bfd_map_over_sections (some_bfd, add_to_section_table, (char *) end);
442 if (*end > *start + count)
443 internal_error (__FILE__, __LINE__,
444 _("failed internal consistency check"));
445 /* We could realloc the table, but it probably loses for most files. */
449 /* Add the sections array defined by [SECTIONS..SECTIONS_END[ to the
450 current set of target sections. */
453 add_target_sections (struct target_section *sections,
454 struct target_section *sections_end)
457 struct target_section_table *table = current_target_sections;
459 count = sections_end - sections;
463 int space = resize_section_table (table, count);
465 memcpy (table->sections + space,
466 sections, count * sizeof (sections[0]));
468 /* If these are the first file sections we can provide memory
469 from, push the file_stratum target. */
473 push_target (&exec_ops);
478 /* Remove all target sections taken from ABFD. */
481 remove_target_sections (bfd *abfd)
483 struct target_section *src, *dest;
484 struct target_section_table *table = current_target_sections;
486 dest = table->sections;
487 for (src = table->sections; src < table->sections_end; src++)
488 if (src->bfd != abfd)
490 /* Keep this section. */
496 /* If we've dropped any sections, resize the section table. */
501 old_count = resize_section_table (table, dest - src);
503 /* If we don't have any more sections to read memory from,
504 remove the file_stratum target from the stack. */
505 if (old_count + (dest - src) == 0)
507 struct program_space *pspace;
510 if (pspace->target_sections.sections
511 != pspace->target_sections.sections_end)
514 unpush_target (&exec_ops);
521 bfdsec_to_vmap (struct bfd *abfd, struct bfd_section *sect, void *arg3)
523 struct vmap_and_bfd *vmap_bfd = (struct vmap_and_bfd *) arg3;
526 vp = vmap_bfd->pvmap;
528 if ((bfd_get_section_flags (abfd, sect) & SEC_LOAD) == 0)
531 if (strcmp (bfd_section_name (abfd, sect), ".text") == 0)
533 vp->tstart = bfd_section_vma (abfd, sect);
534 vp->tend = vp->tstart + bfd_section_size (abfd, sect);
535 vp->tvma = bfd_section_vma (abfd, sect);
536 vp->toffs = sect->filepos;
538 else if (strcmp (bfd_section_name (abfd, sect), ".data") == 0)
540 vp->dstart = bfd_section_vma (abfd, sect);
541 vp->dend = vp->dstart + bfd_section_size (abfd, sect);
542 vp->dvma = bfd_section_vma (abfd, sect);
544 /* Silently ignore other types of sections. (FIXME?) */
547 /* Make a vmap for ABFD which might be a member of the archive ARCH.
548 Return the new vmap. */
551 map_vmap (bfd *abfd, bfd *arch)
553 struct vmap_and_bfd vmap_bfd;
554 struct vmap *vp, **vpp;
556 vp = (struct vmap *) xmalloc (sizeof (*vp));
557 memset ((char *) vp, '\0', sizeof (*vp));
560 vp->name = bfd_get_filename (arch ? arch : abfd);
561 vp->member = arch ? bfd_get_filename (abfd) : "";
563 vmap_bfd.pbfd = arch;
565 bfd_map_over_sections (abfd, bfdsec_to_vmap, &vmap_bfd);
567 /* Find the end of the list and append. */
568 for (vpp = &vmap; *vpp; vpp = &(*vpp)->nxt)
577 section_table_available_memory (VEC(mem_range_s) *memory,
578 CORE_ADDR memaddr, ULONGEST len,
579 struct target_section *sections,
580 struct target_section *sections_end)
582 struct target_section *p;
584 for (p = sections; p < sections_end; p++)
586 if ((bfd_get_section_flags (p->bfd, p->the_bfd_section)
587 & SEC_READONLY) == 0)
590 /* Copy the meta-data, adjusted. */
591 if (mem_ranges_overlap (p->addr, p->endaddr - p->addr, memaddr, len))
593 ULONGEST lo1, hi1, lo2, hi2;
602 r = VEC_safe_push (mem_range_s, memory, NULL);
604 r->start = max (lo1, lo2);
605 r->length = min (hi1, hi2) - r->start;
613 section_table_xfer_memory_partial (gdb_byte *readbuf, const gdb_byte *writebuf,
614 ULONGEST offset, LONGEST len,
615 struct target_section *sections,
616 struct target_section *sections_end,
617 const char *section_name)
620 struct target_section *p;
621 ULONGEST memaddr = offset;
622 ULONGEST memend = memaddr + len;
625 internal_error (__FILE__, __LINE__,
626 _("failed internal consistency check"));
628 for (p = sections; p < sections_end; p++)
630 if (section_name && strcmp (section_name, p->the_bfd_section->name) != 0)
631 continue; /* not the section we need. */
632 if (memaddr >= p->addr)
634 if (memend <= p->endaddr)
636 /* Entire transfer is within this section. */
638 res = bfd_set_section_contents (p->bfd, p->the_bfd_section,
639 writebuf, memaddr - p->addr,
642 res = bfd_get_section_contents (p->bfd, p->the_bfd_section,
643 readbuf, memaddr - p->addr,
645 return (res != 0) ? len : 0;
647 else if (memaddr >= p->endaddr)
649 /* This section ends before the transfer starts. */
654 /* This section overlaps the transfer. Just do half. */
655 len = p->endaddr - memaddr;
657 res = bfd_set_section_contents (p->bfd, p->the_bfd_section,
658 writebuf, memaddr - p->addr,
661 res = bfd_get_section_contents (p->bfd, p->the_bfd_section,
662 readbuf, memaddr - p->addr,
664 return (res != 0) ? len : 0;
669 return 0; /* We can't help. */
672 struct target_section_table *
673 exec_get_section_table (struct target_ops *ops)
675 return current_target_sections;
679 exec_xfer_partial (struct target_ops *ops, enum target_object object,
680 const char *annex, gdb_byte *readbuf,
681 const gdb_byte *writebuf,
682 ULONGEST offset, LONGEST len)
684 struct target_section_table *table = target_get_section_table (ops);
686 if (object == TARGET_OBJECT_MEMORY)
687 return section_table_xfer_memory_partial (readbuf, writebuf,
698 print_section_info (struct target_section_table *t, bfd *abfd)
700 struct gdbarch *gdbarch = gdbarch_from_bfd (abfd);
701 struct target_section *p;
702 /* FIXME: 16 is not wide enough when gdbarch_addr_bit > 64. */
703 int wid = gdbarch_addr_bit (gdbarch) <= 32 ? 8 : 16;
705 printf_filtered ("\t`%s', ", bfd_get_filename (abfd));
707 printf_filtered (_("file type %s.\n"), bfd_get_target (abfd));
708 if (abfd == exec_bfd)
710 /* gcc-3.4 does not like the initialization in
711 <p == t->sections_end>. */
712 bfd_vma displacement = 0;
715 for (p = t->sections; p < t->sections_end; p++)
717 asection *asect = p->the_bfd_section;
719 if ((bfd_get_section_flags (abfd, asect) & (SEC_ALLOC | SEC_LOAD))
720 != (SEC_ALLOC | SEC_LOAD))
723 if (bfd_get_section_vma (abfd, asect) <= abfd->start_address
724 && abfd->start_address < (bfd_get_section_vma (abfd, asect)
725 + bfd_get_section_size (asect)))
727 displacement = p->addr - bfd_get_section_vma (abfd, asect);
731 if (p == t->sections_end)
732 warning (_("Cannot find section for the entry point of %s."),
733 bfd_get_filename (abfd));
735 entry_point = gdbarch_addr_bits_remove (gdbarch,
736 bfd_get_start_address (abfd)
738 printf_filtered (_("\tEntry point: %s\n"),
739 paddress (gdbarch, entry_point));
741 for (p = t->sections; p < t->sections_end; p++)
743 printf_filtered ("\t%s", hex_string_custom (p->addr, wid));
744 printf_filtered (" - %s", hex_string_custom (p->endaddr, wid));
746 /* FIXME: A format of "08l" is not wide enough for file offsets
747 larger than 4GB. OTOH, making it "016l" isn't desirable either
748 since most output will then be much wider than necessary. It
749 may make sense to test the size of the file and choose the
750 format string accordingly. */
751 /* FIXME: i18n: Need to rewrite this sentence. */
753 printf_filtered (" @ %s",
754 hex_string_custom (p->the_bfd_section->filepos, 8));
755 printf_filtered (" is %s", bfd_section_name (p->bfd,
756 p->the_bfd_section));
758 printf_filtered (" in %s", bfd_get_filename (p->bfd));
759 printf_filtered ("\n");
764 exec_files_info (struct target_ops *t)
766 print_section_info (current_target_sections, exec_bfd);
770 int addr_size = gdbarch_addr_bit (target_gdbarch) / 8;
773 printf_unfiltered (_("\tMapping info for file `%s'.\n"), vmap->name);
774 printf_unfiltered ("\t %*s %*s %*s %*s %8.8s %s\n",
775 addr_size * 2, "tstart",
776 addr_size * 2, "tend",
777 addr_size * 2, "dstart",
778 addr_size * 2, "dend",
782 for (vp = vmap; vp; vp = vp->nxt)
783 printf_unfiltered ("\t0x%s 0x%s 0x%s 0x%s %s%s%s%s\n",
784 phex (vp->tstart, addr_size),
785 phex (vp->tend, addr_size),
786 phex (vp->dstart, addr_size),
787 phex (vp->dend, addr_size),
789 *vp->member ? "(" : "", vp->member,
790 *vp->member ? ")" : "");
795 set_section_command (char *args, int from_tty)
797 struct target_section *p;
800 unsigned long secaddr;
803 struct target_section_table *table;
806 error (_("Must specify section name and its virtual address"));
808 /* Parse out section name. */
809 for (secname = args; !isspace (*args); args++);
810 seclen = args - secname;
812 /* Parse out new virtual address. */
813 secaddr = parse_and_eval_address (args);
815 table = current_target_sections;
816 for (p = table->sections; p < table->sections_end; p++)
818 if (!strncmp (secname, bfd_section_name (exec_bfd,
819 p->the_bfd_section), seclen)
820 && bfd_section_name (exec_bfd, p->the_bfd_section)[seclen] == '\0')
822 offset = secaddr - p->addr;
824 p->endaddr += offset;
826 exec_files_info (&exec_ops);
830 if (seclen >= sizeof (secprint))
831 seclen = sizeof (secprint) - 1;
832 strncpy (secprint, secname, seclen);
833 secprint[seclen] = '\0';
834 error (_("Section %s not found"), secprint);
837 /* If we can find a section in FILENAME with BFD index INDEX, adjust
841 exec_set_section_address (const char *filename, int index, CORE_ADDR address)
843 struct target_section *p;
844 struct target_section_table *table;
846 table = current_target_sections;
847 for (p = table->sections; p < table->sections_end; p++)
849 if (filename_cmp (filename, p->bfd->filename) == 0
850 && index == p->the_bfd_section->index)
852 p->endaddr += address - p->addr;
858 /* If mourn is being called in all the right places, this could be say
859 `gdb internal error' (since generic_mourn calls
860 breakpoint_init_inferior). */
863 ignore (struct gdbarch *gdbarch, struct bp_target_info *bp_tgt)
869 exec_has_memory (struct target_ops *ops)
871 /* We can provide memory if we have any file/target sections to read
873 return (current_target_sections->sections
874 != current_target_sections->sections_end);
877 /* Find mapped memory. */
880 exec_set_find_memory_regions (int (*func) (find_memory_region_ftype, void *))
882 exec_ops.to_find_memory_regions = func;
885 static char *exec_make_note_section (bfd *, int *);
887 /* Fill in the exec file target vector. Very few entries need to be
893 exec_ops.to_shortname = "exec";
894 exec_ops.to_longname = "Local exec file";
895 exec_ops.to_doc = "Use an executable file as a target.\n\
896 Specify the filename of the executable file.";
897 exec_ops.to_open = exec_open;
898 exec_ops.to_close = exec_close_1;
899 exec_ops.to_attach = find_default_attach;
900 exec_ops.to_xfer_partial = exec_xfer_partial;
901 exec_ops.to_get_section_table = exec_get_section_table;
902 exec_ops.to_files_info = exec_files_info;
903 exec_ops.to_insert_breakpoint = ignore;
904 exec_ops.to_remove_breakpoint = ignore;
905 exec_ops.to_create_inferior = find_default_create_inferior;
906 exec_ops.to_stratum = file_stratum;
907 exec_ops.to_has_memory = exec_has_memory;
908 exec_ops.to_make_corefile_notes = exec_make_note_section;
909 exec_ops.to_magic = OPS_MAGIC;
913 _initialize_exec (void)
915 struct cmd_list_element *c;
921 c = add_cmd ("file", class_files, file_command, _("\
922 Use FILE as program to be debugged.\n\
923 It is read for its symbols, for getting the contents of pure memory,\n\
924 and it is the program executed when you use the `run' command.\n\
925 If FILE cannot be found as specified, your execution directory path\n\
926 ($PATH) is searched for a command of that name.\n\
927 No arg means to have no executable file and no symbols."), &cmdlist);
928 set_cmd_completer (c, filename_completer);
931 c = add_cmd ("exec-file", class_files, exec_file_command, _("\
932 Use FILE as program for getting contents of pure memory.\n\
933 If FILE cannot be found as specified, your execution directory path\n\
934 is searched for a command of that name.\n\
935 No arg means have no executable file."), &cmdlist);
936 set_cmd_completer (c, filename_completer);
938 add_com ("section", class_files, set_section_command, _("\
939 Change the base address of section SECTION of the exec file to ADDR.\n\
940 This can be used if the exec file does not contain section addresses,\n\
941 (such as in the a.out format), or when the addresses specified in the\n\
942 file itself are wrong. Each section must be changed separately. The\n\
943 ``info files'' command lists all the sections and their addresses."));
945 add_setshow_boolean_cmd ("write", class_support, &write_files, _("\
946 Set writing into executable and core files."), _("\
947 Show writing into executable and core files."), NULL,
950 &setlist, &showlist);
952 add_target (&exec_ops);
956 exec_make_note_section (bfd *obfd, int *note_size)
958 error (_("Can't create a corefile"));