1 /* Work with executable files, for GDB.
3 Copyright (C) 1988-2017 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
26 #include "filenames.h"
29 #include "completer.h"
33 #include "arch-utils.h"
34 #include "gdbthread.h"
35 #include "progspace.h"
40 #include "readline/readline.h"
48 void (*deprecated_file_changed_hook) (const char *);
50 /* Prototypes for local functions */
52 static void set_section_command (char *, int);
54 static void exec_files_info (struct target_ops *);
56 static void init_exec_ops (void);
58 /* The target vector for executable files. */
60 static struct target_ops exec_ops;
62 /* Whether to open exec and core files read-only or read-write. */
66 show_write_files (struct ui_file *file, int from_tty,
67 struct cmd_list_element *c, const char *value)
69 fprintf_filtered (file, _("Writing into executable and core files is %s.\n"),
75 exec_open (const char *args, int from_tty)
77 target_preopen (from_tty);
78 exec_file_attach (args, from_tty);
81 /* Close and clear exec_bfd. If we end up with no target sections to
82 read memory from, this unpushes the exec_ops target. */
93 /* Removing target sections may close the exec_ops target.
94 Clear exec_bfd before doing so to prevent recursion. */
98 remove_target_sections (&exec_bfd);
100 xfree (exec_filename);
101 exec_filename = NULL;
105 /* This is the target_close implementation. Clears all target
106 sections and closes all executable bfds from all program spaces. */
109 exec_close_1 (struct target_ops *self)
111 struct program_space *ss;
112 scoped_restore_current_program_space restore_pspace;
116 set_current_program_space (ss);
117 clear_section_table (current_target_sections);
123 exec_file_clear (int from_tty)
125 /* Remove exec file. */
129 printf_unfiltered (_("No executable file now.\n"));
135 try_open_exec_file (const char *exec_file_host, struct inferior *inf,
136 symfile_add_flags add_flags)
138 struct cleanup *old_chain;
139 struct gdb_exception prev_err = exception_none;
141 old_chain = make_cleanup (free_current_contents, &prev_err.message);
143 /* exec_file_attach and symbol_file_add_main may throw an error if the file
144 cannot be opened either locally or remotely.
146 This happens for example, when the file is first found in the local
147 sysroot (above), and then disappears (a TOCTOU race), or when it doesn't
148 exist in the target filesystem, or when the file does exist, but
151 Even without a symbol file, the remote-based debugging session should
152 continue normally instead of ending abruptly. Hence we catch thrown
153 errors/exceptions in the following code. */
156 /* We must do this step even if exec_file_host is NULL, so that
157 exec_file_attach will clear state. */
158 exec_file_attach (exec_file_host, add_flags & SYMFILE_VERBOSE);
160 CATCH (err, RETURN_MASK_ERROR)
162 if (err.message != NULL)
163 warning ("%s", err.message);
167 /* Save message so it doesn't get trashed by the catch below. */
168 if (err.message != NULL)
169 prev_err.message = xstrdup (err.message);
173 if (exec_file_host != NULL)
177 symbol_file_add_main (exec_file_host, add_flags);
179 CATCH (err, RETURN_MASK_ERROR)
181 if (!exception_print_same (prev_err, err))
182 warning ("%s", err.message);
187 do_cleanups (old_chain);
193 exec_file_locate_attach (int pid, int defer_bp_reset, int from_tty)
195 char *exec_file_target, *exec_file_host;
196 struct cleanup *old_chain;
197 symfile_add_flags add_flags = 0;
199 /* Do nothing if we already have an executable filename. */
200 if (get_exec_file (0) != NULL)
203 /* Try to determine a filename from the process itself. */
204 exec_file_target = target_pid_to_exec_file (pid);
205 if (exec_file_target == NULL)
207 warning (_("No executable has been specified and target does not "
209 "determining executable automatically. "
210 "Try using the \"file\" command."));
214 exec_file_host = exec_file_find (exec_file_target, NULL);
215 old_chain = make_cleanup (xfree, exec_file_host);
218 add_flags |= SYMFILE_DEFER_BP_RESET;
221 add_flags |= SYMFILE_VERBOSE;
223 /* Attempt to open the exec file. */
224 try_open_exec_file (exec_file_host, current_inferior (), add_flags);
225 do_cleanups (old_chain);
228 /* Set FILENAME as the new exec file.
230 This function is intended to be behave essentially the same
231 as exec_file_command, except that the latter will detect when
232 a target is being debugged, and will ask the user whether it
233 should be shut down first. (If the answer is "no", then the
234 new file is ignored.)
236 This file is used by exec_file_command, to do the work of opening
237 and processing the exec file after any prompting has happened.
239 And, it is used by child_attach, when the attach command was
240 given a pid but not a exec pathname, and the attach command could
241 figure out the pathname from the pid. (In this case, we shouldn't
242 ask the user whether the current target should be shut down --
243 we're supplying the exec pathname late for good reason.) */
246 exec_file_attach (const char *filename, int from_tty)
248 /* First, acquire a reference to the current exec_bfd. We release
249 this at the end of the function; but acquiring it now lets the
250 BFD cache return it if this call refers to the same file. */
251 gdb_bfd_ref_ptr exec_bfd_holder = new_bfd_ref (exec_bfd);
253 /* Remove any previous exec file. */
256 /* Now open and digest the file the user requested, if any. */
261 printf_unfiltered (_("No executable file now.\n"));
263 set_gdbarch_from_file (NULL);
267 int load_via_target = 0;
268 const char *scratch_pathname, *canonical_pathname;
270 struct target_section *sections = NULL, *sections_end = NULL;
273 if (is_target_filename (filename))
275 if (target_filesystem_is_local ())
276 filename += strlen (TARGET_SYSROOT_PREFIX);
281 gdb::unique_xmalloc_ptr<char> canonical_storage, scratch_storage;
284 /* gdb_bfd_fopen does not support "target:" filenames. */
286 warning (_("writing into executable files is "
287 "not supported for %s sysroots"),
288 TARGET_SYSROOT_PREFIX);
290 scratch_pathname = filename;
292 canonical_pathname = scratch_pathname;
298 scratch_chan = openp (getenv ("PATH"), OPF_TRY_CWD_FIRST,
299 filename, write_files ?
300 O_RDWR | O_BINARY : O_RDONLY | O_BINARY,
302 #if defined(__GO32__) || defined(_WIN32) || defined(__CYGWIN__)
303 if (scratch_chan < 0)
305 char *exename = (char *) alloca (strlen (filename) + 5);
307 strcat (strcpy (exename, filename), ".exe");
308 scratch_chan = openp (getenv ("PATH"), OPF_TRY_CWD_FIRST,
309 exename, write_files ?
311 : O_RDONLY | O_BINARY,
315 if (scratch_chan < 0)
316 perror_with_name (filename);
318 scratch_storage.reset (temp_pathname);
319 scratch_pathname = temp_pathname;
321 /* gdb_bfd_open (and its variants) prefers canonicalized
322 pathname for better BFD caching. */
323 canonical_storage = gdb_realpath (scratch_pathname);
324 canonical_pathname = canonical_storage.get ();
327 gdb_bfd_ref_ptr temp;
328 if (write_files && !load_via_target)
329 temp = gdb_bfd_fopen (canonical_pathname, gnutarget,
330 FOPEN_RUB, scratch_chan);
332 temp = gdb_bfd_open (canonical_pathname, gnutarget, scratch_chan);
333 exec_bfd = temp.release ();
337 error (_("\"%s\": could not open as an executable file: %s."),
338 scratch_pathname, bfd_errmsg (bfd_get_error ()));
341 /* gdb_realpath_keepfile resolves symlinks on the local
342 filesystem and so cannot be used for "target:" files. */
343 gdb_assert (exec_filename == NULL);
345 exec_filename = xstrdup (bfd_get_filename (exec_bfd));
347 exec_filename = gdb_realpath_keepfile (scratch_pathname).release ();
349 if (!bfd_check_format_matches (exec_bfd, bfd_object, &matching))
351 /* Make sure to close exec_bfd, or else "run" might try to use
354 error (_("\"%s\": not in executable format: %s"),
356 gdb_bfd_errmsg (bfd_get_error (), matching));
359 if (build_section_table (exec_bfd, §ions, §ions_end))
361 /* Make sure to close exec_bfd, or else "run" might try to use
364 error (_("\"%s\": can't find the file sections: %s"),
365 scratch_pathname, bfd_errmsg (bfd_get_error ()));
368 exec_bfd_mtime = bfd_get_mtime (exec_bfd);
372 set_gdbarch_from_file (exec_bfd);
374 /* Add the executable's sections to the current address spaces'
375 list of sections. This possibly pushes the exec_ops
377 add_target_sections (&exec_bfd, sections, sections_end);
380 /* Tell display code (if any) about the changed file name. */
381 if (deprecated_exec_file_display_hook)
382 (*deprecated_exec_file_display_hook) (filename);
385 bfd_cache_close_all ();
386 observer_notify_executable_changed ();
389 /* Process the first arg in ARGS as the new exec file.
391 Note that we have to explicitly ignore additional args, since we can
392 be called from file_command(), which also calls symbol_file_command()
393 which can take multiple args.
395 If ARGS is NULL, we just want to close the exec file. */
398 exec_file_command (const char *args, int from_tty)
402 if (from_tty && target_has_execution
403 && !query (_("A program is being debugged already.\n"
404 "Are you sure you want to change the file? ")))
405 error (_("File not changed."));
409 /* Scan through the args and pick up the first non option arg
412 gdb_argv built_argv (args);
413 char **argv = built_argv.get ();
415 for (; (*argv != NULL) && (**argv == '-'); argv++)
419 error (_("No executable file name was specified"));
421 gdb::unique_xmalloc_ptr<char> filename (tilde_expand (*argv));
422 exec_file_attach (filename.get (), from_tty);
425 exec_file_attach (NULL, from_tty);
428 /* Set both the exec file and the symbol file, in one command.
429 What a novelty. Why did GDB go through four major releases before this
430 command was added? */
433 file_command (const char *arg, int from_tty)
435 /* FIXME, if we lose on reading the symbol file, we should revert
436 the exec file, but that's rough. */
437 exec_file_command (arg, from_tty);
438 symbol_file_command (arg, from_tty);
439 if (deprecated_file_changed_hook)
440 deprecated_file_changed_hook (arg);
444 /* Locate all mappable sections of a BFD file.
445 table_pp_char is a char * to get it through bfd_map_over_sections;
446 we cast it back to its proper type. */
449 add_to_section_table (bfd *abfd, struct bfd_section *asect,
452 struct target_section **table_pp = (struct target_section **) table_pp_char;
455 gdb_assert (abfd == asect->owner);
457 /* Check the section flags, but do not discard zero-length sections, since
458 some symbols may still be attached to this section. For instance, we
459 encountered on sparc-solaris 2.10 a shared library with an empty .bss
460 section to which a symbol named "_end" was attached. The address
461 of this symbol still needs to be relocated. */
462 aflag = bfd_get_section_flags (abfd, asect);
463 if (!(aflag & SEC_ALLOC))
466 (*table_pp)->owner = NULL;
467 (*table_pp)->the_bfd_section = asect;
468 (*table_pp)->addr = bfd_section_vma (abfd, asect);
469 (*table_pp)->endaddr = (*table_pp)->addr + bfd_section_size (abfd, asect);
476 clear_section_table (struct target_section_table *table)
478 xfree (table->sections);
479 table->sections = table->sections_end = NULL;
482 /* Resize section table TABLE by ADJUSTMENT.
483 ADJUSTMENT may be negative, in which case the caller must have already
484 removed the sections being deleted.
485 Returns the old size. */
488 resize_section_table (struct target_section_table *table, int adjustment)
493 old_count = table->sections_end - table->sections;
495 new_count = adjustment + old_count;
499 table->sections = XRESIZEVEC (struct target_section, table->sections,
501 table->sections_end = table->sections + new_count;
504 clear_section_table (table);
509 /* Builds a section table, given args BFD, SECTABLE_PTR, SECEND_PTR.
510 Returns 0 if OK, 1 on error. */
513 build_section_table (struct bfd *some_bfd, struct target_section **start,
514 struct target_section **end)
518 count = bfd_count_sections (some_bfd);
521 *start = XNEWVEC (struct target_section, count);
523 bfd_map_over_sections (some_bfd, add_to_section_table, (char *) end);
524 if (*end > *start + count)
525 internal_error (__FILE__, __LINE__,
526 _("failed internal consistency check"));
527 /* We could realloc the table, but it probably loses for most files. */
531 /* Add the sections array defined by [SECTIONS..SECTIONS_END[ to the
532 current set of target sections. */
535 add_target_sections (void *owner,
536 struct target_section *sections,
537 struct target_section *sections_end)
540 struct target_section_table *table = current_target_sections;
542 count = sections_end - sections;
546 int space = resize_section_table (table, count);
549 for (i = 0; i < count; ++i)
551 table->sections[space + i] = sections[i];
552 table->sections[space + i].owner = owner;
555 /* If these are the first file sections we can provide memory
556 from, push the file_stratum target. */
557 if (!target_is_pushed (&exec_ops))
558 push_target (&exec_ops);
562 /* Add the sections of OBJFILE to the current set of target sections. */
565 add_target_sections_of_objfile (struct objfile *objfile)
567 struct target_section_table *table = current_target_sections;
568 struct obj_section *osect;
571 struct target_section *ts;
576 /* Compute the number of sections to add. */
577 ALL_OBJFILE_OSECTIONS (objfile, osect)
579 if (bfd_get_section_size (osect->the_bfd_section) == 0)
587 space = resize_section_table (table, count);
589 ts = table->sections + space;
591 ALL_OBJFILE_OSECTIONS (objfile, osect)
593 if (bfd_get_section_size (osect->the_bfd_section) == 0)
596 gdb_assert (ts < table->sections + space + count);
598 ts->addr = obj_section_addr (osect);
599 ts->endaddr = obj_section_endaddr (osect);
600 ts->the_bfd_section = osect->the_bfd_section;
601 ts->owner = (void *) objfile;
607 /* Remove all target sections owned by OWNER.
608 OWNER must be the same value passed to add_target_sections. */
611 remove_target_sections (void *owner)
613 struct target_section *src, *dest;
614 struct target_section_table *table = current_target_sections;
616 gdb_assert (owner != NULL);
618 dest = table->sections;
619 for (src = table->sections; src < table->sections_end; src++)
620 if (src->owner != owner)
622 /* Keep this section. */
628 /* If we've dropped any sections, resize the section table. */
633 old_count = resize_section_table (table, dest - src);
635 /* If we don't have any more sections to read memory from,
636 remove the file_stratum target from the stack. */
637 if (old_count + (dest - src) == 0)
639 struct program_space *pspace;
642 if (pspace->target_sections.sections
643 != pspace->target_sections.sections_end)
646 unpush_target (&exec_ops);
653 enum target_xfer_status
654 exec_read_partial_read_only (gdb_byte *readbuf, ULONGEST offset,
655 ULONGEST len, ULONGEST *xfered_len)
657 /* It's unduly pedantic to refuse to look at the executable for
658 read-only pieces; so do the equivalent of readonly regions aka
660 if (exec_bfd != NULL)
666 for (s = exec_bfd->sections; s; s = s->next)
668 if ((s->flags & SEC_LOAD) == 0
669 || (s->flags & SEC_READONLY) == 0)
673 size = bfd_get_section_size (s);
674 if (vma <= offset && offset < (vma + size))
678 amt = (vma + size) - offset;
682 amt = bfd_get_section_contents (exec_bfd, s,
683 readbuf, offset - vma, amt);
686 return TARGET_XFER_EOF;
690 return TARGET_XFER_OK;
696 /* Indicate failure to find the requested memory block. */
697 return TARGET_XFER_E_IO;
700 /* Return all read-only memory ranges found in the target section
701 table defined by SECTIONS and SECTIONS_END, starting at (and
702 intersected with) MEMADDR for LEN bytes. */
704 static std::vector<mem_range>
705 section_table_available_memory (CORE_ADDR memaddr, ULONGEST len,
706 struct target_section *sections,
707 struct target_section *sections_end)
709 std::vector<mem_range> memory;
711 for (target_section *p = sections; p < sections_end; p++)
713 if ((bfd_get_section_flags (p->the_bfd_section->owner,
715 & SEC_READONLY) == 0)
718 /* Copy the meta-data, adjusted. */
719 if (mem_ranges_overlap (p->addr, p->endaddr - p->addr, memaddr, len))
721 ULONGEST lo1, hi1, lo2, hi2;
729 CORE_ADDR start = std::max (lo1, lo2);
730 int length = std::min (hi1, hi2) - start;
732 memory.emplace_back (start, length);
739 enum target_xfer_status
740 section_table_read_available_memory (gdb_byte *readbuf, ULONGEST offset,
741 ULONGEST len, ULONGEST *xfered_len)
743 target_section_table *table = target_get_section_table (&exec_ops);
744 std::vector<mem_range> available_memory
745 = section_table_available_memory (offset, len,
746 table->sections, table->sections_end);
748 normalize_mem_ranges (&available_memory);
750 for (const mem_range &r : available_memory)
752 if (mem_ranges_overlap (r.start, r.length, offset, len))
755 enum target_xfer_status status;
757 /* Get the intersection window. */
758 end = std::min<CORE_ADDR> (offset + len, r.start + r.length);
760 gdb_assert (end - offset <= len);
762 if (offset >= r.start)
763 status = exec_read_partial_read_only (readbuf, offset,
768 *xfered_len = r.start - offset;
769 status = TARGET_XFER_UNAVAILABLE;
776 return TARGET_XFER_UNAVAILABLE;
779 enum target_xfer_status
780 section_table_xfer_memory_partial (gdb_byte *readbuf, const gdb_byte *writebuf,
781 ULONGEST offset, ULONGEST len,
782 ULONGEST *xfered_len,
783 struct target_section *sections,
784 struct target_section *sections_end,
785 const char *section_name)
788 struct target_section *p;
789 ULONGEST memaddr = offset;
790 ULONGEST memend = memaddr + len;
793 internal_error (__FILE__, __LINE__,
794 _("failed internal consistency check"));
796 for (p = sections; p < sections_end; p++)
798 struct bfd_section *asect = p->the_bfd_section;
799 bfd *abfd = asect->owner;
801 if (section_name && strcmp (section_name, asect->name) != 0)
802 continue; /* not the section we need. */
803 if (memaddr >= p->addr)
805 if (memend <= p->endaddr)
807 /* Entire transfer is within this section. */
809 res = bfd_set_section_contents (abfd, asect,
810 writebuf, memaddr - p->addr,
813 res = bfd_get_section_contents (abfd, asect,
814 readbuf, memaddr - p->addr,
820 return TARGET_XFER_OK;
823 return TARGET_XFER_EOF;
825 else if (memaddr >= p->endaddr)
827 /* This section ends before the transfer starts. */
832 /* This section overlaps the transfer. Just do half. */
833 len = p->endaddr - memaddr;
835 res = bfd_set_section_contents (abfd, asect,
836 writebuf, memaddr - p->addr,
839 res = bfd_get_section_contents (abfd, asect,
840 readbuf, memaddr - p->addr,
845 return TARGET_XFER_OK;
848 return TARGET_XFER_EOF;
853 return TARGET_XFER_EOF; /* We can't help. */
856 static struct target_section_table *
857 exec_get_section_table (struct target_ops *ops)
859 return current_target_sections;
862 static enum target_xfer_status
863 exec_xfer_partial (struct target_ops *ops, enum target_object object,
864 const char *annex, gdb_byte *readbuf,
865 const gdb_byte *writebuf,
866 ULONGEST offset, ULONGEST len, ULONGEST *xfered_len)
868 struct target_section_table *table = target_get_section_table (ops);
870 if (object == TARGET_OBJECT_MEMORY)
871 return section_table_xfer_memory_partial (readbuf, writebuf,
872 offset, len, xfered_len,
877 return TARGET_XFER_E_IO;
882 print_section_info (struct target_section_table *t, bfd *abfd)
884 struct gdbarch *gdbarch = gdbarch_from_bfd (abfd);
885 struct target_section *p;
886 /* FIXME: 16 is not wide enough when gdbarch_addr_bit > 64. */
887 int wid = gdbarch_addr_bit (gdbarch) <= 32 ? 8 : 16;
889 printf_filtered ("\t`%s', ", bfd_get_filename (abfd));
891 printf_filtered (_("file type %s.\n"), bfd_get_target (abfd));
892 if (abfd == exec_bfd)
894 /* gcc-3.4 does not like the initialization in
895 <p == t->sections_end>. */
896 bfd_vma displacement = 0;
899 for (p = t->sections; p < t->sections_end; p++)
901 struct bfd_section *psect = p->the_bfd_section;
902 bfd *pbfd = psect->owner;
904 if ((bfd_get_section_flags (pbfd, psect) & (SEC_ALLOC | SEC_LOAD))
905 != (SEC_ALLOC | SEC_LOAD))
908 if (bfd_get_section_vma (pbfd, psect) <= abfd->start_address
909 && abfd->start_address < (bfd_get_section_vma (pbfd, psect)
910 + bfd_get_section_size (psect)))
912 displacement = p->addr - bfd_get_section_vma (pbfd, psect);
916 if (p == t->sections_end)
917 warning (_("Cannot find section for the entry point of %s."),
918 bfd_get_filename (abfd));
920 entry_point = gdbarch_addr_bits_remove (gdbarch,
921 bfd_get_start_address (abfd)
923 printf_filtered (_("\tEntry point: %s\n"),
924 paddress (gdbarch, entry_point));
926 for (p = t->sections; p < t->sections_end; p++)
928 struct bfd_section *psect = p->the_bfd_section;
929 bfd *pbfd = psect->owner;
931 printf_filtered ("\t%s", hex_string_custom (p->addr, wid));
932 printf_filtered (" - %s", hex_string_custom (p->endaddr, wid));
934 /* FIXME: A format of "08l" is not wide enough for file offsets
935 larger than 4GB. OTOH, making it "016l" isn't desirable either
936 since most output will then be much wider than necessary. It
937 may make sense to test the size of the file and choose the
938 format string accordingly. */
939 /* FIXME: i18n: Need to rewrite this sentence. */
941 printf_filtered (" @ %s",
942 hex_string_custom (psect->filepos, 8));
943 printf_filtered (" is %s", bfd_section_name (pbfd, psect));
945 printf_filtered (" in %s", bfd_get_filename (pbfd));
946 printf_filtered ("\n");
951 exec_files_info (struct target_ops *t)
954 print_section_info (current_target_sections, exec_bfd);
956 puts_filtered (_("\t<no file loaded>\n"));
960 set_section_command (char *args, int from_tty)
962 struct target_section *p;
965 unsigned long secaddr;
968 struct target_section_table *table;
971 error (_("Must specify section name and its virtual address"));
973 /* Parse out section name. */
974 for (secname = args; !isspace (*args); args++);
975 seclen = args - secname;
977 /* Parse out new virtual address. */
978 secaddr = parse_and_eval_address (args);
980 table = current_target_sections;
981 for (p = table->sections; p < table->sections_end; p++)
983 if (!strncmp (secname, bfd_section_name (p->bfd,
984 p->the_bfd_section), seclen)
985 && bfd_section_name (p->bfd, p->the_bfd_section)[seclen] == '\0')
987 offset = secaddr - p->addr;
989 p->endaddr += offset;
991 exec_files_info (&exec_ops);
995 if (seclen >= sizeof (secprint))
996 seclen = sizeof (secprint) - 1;
997 strncpy (secprint, secname, seclen);
998 secprint[seclen] = '\0';
999 error (_("Section %s not found"), secprint);
1002 /* If we can find a section in FILENAME with BFD index INDEX, adjust
1006 exec_set_section_address (const char *filename, int index, CORE_ADDR address)
1008 struct target_section *p;
1009 struct target_section_table *table;
1011 table = current_target_sections;
1012 for (p = table->sections; p < table->sections_end; p++)
1014 if (filename_cmp (filename, p->the_bfd_section->owner->filename) == 0
1015 && index == p->the_bfd_section->index)
1017 p->endaddr += address - p->addr;
1023 /* If mourn is being called in all the right places, this could be say
1024 `gdb internal error' (since generic_mourn calls
1025 breakpoint_init_inferior). */
1028 ignore (struct target_ops *ops, struct gdbarch *gdbarch,
1029 struct bp_target_info *bp_tgt)
1034 /* Implement the to_remove_breakpoint method. */
1037 exec_remove_breakpoint (struct target_ops *ops, struct gdbarch *gdbarch,
1038 struct bp_target_info *bp_tgt,
1039 enum remove_bp_reason reason)
1045 exec_has_memory (struct target_ops *ops)
1047 /* We can provide memory if we have any file/target sections to read
1049 return (current_target_sections->sections
1050 != current_target_sections->sections_end);
1054 exec_make_note_section (struct target_ops *self, bfd *obfd, int *note_size)
1056 error (_("Can't create a corefile"));
1059 /* Fill in the exec file target vector. Very few entries need to be
1063 init_exec_ops (void)
1065 exec_ops.to_shortname = "exec";
1066 exec_ops.to_longname = "Local exec file";
1067 exec_ops.to_doc = "Use an executable file as a target.\n\
1068 Specify the filename of the executable file.";
1069 exec_ops.to_open = exec_open;
1070 exec_ops.to_close = exec_close_1;
1071 exec_ops.to_xfer_partial = exec_xfer_partial;
1072 exec_ops.to_get_section_table = exec_get_section_table;
1073 exec_ops.to_files_info = exec_files_info;
1074 exec_ops.to_insert_breakpoint = ignore;
1075 exec_ops.to_remove_breakpoint = exec_remove_breakpoint;
1076 exec_ops.to_stratum = file_stratum;
1077 exec_ops.to_has_memory = exec_has_memory;
1078 exec_ops.to_make_corefile_notes = exec_make_note_section;
1079 exec_ops.to_find_memory_regions = objfile_find_memory_regions;
1080 exec_ops.to_magic = OPS_MAGIC;
1084 _initialize_exec (void)
1086 struct cmd_list_element *c;
1092 c = add_cmd ("file", class_files, file_command, _("\
1093 Use FILE as program to be debugged.\n\
1094 It is read for its symbols, for getting the contents of pure memory,\n\
1095 and it is the program executed when you use the `run' command.\n\
1096 If FILE cannot be found as specified, your execution directory path\n\
1097 ($PATH) is searched for a command of that name.\n\
1098 No arg means to have no executable file and no symbols."), &cmdlist);
1099 set_cmd_completer (c, filename_completer);
1102 c = add_cmd ("exec-file", class_files, exec_file_command, _("\
1103 Use FILE as program for getting contents of pure memory.\n\
1104 If FILE cannot be found as specified, your execution directory path\n\
1105 is searched for a command of that name.\n\
1106 No arg means have no executable file."), &cmdlist);
1107 set_cmd_completer (c, filename_completer);
1109 add_com ("section", class_files, set_section_command, _("\
1110 Change the base address of section SECTION of the exec file to ADDR.\n\
1111 This can be used if the exec file does not contain section addresses,\n\
1112 (such as in the a.out format), or when the addresses specified in the\n\
1113 file itself are wrong. Each section must be changed separately. The\n\
1114 ``info files'' command lists all the sections and their addresses."));
1116 add_setshow_boolean_cmd ("write", class_support, &write_files, _("\
1117 Set writing into executable and core files."), _("\
1118 Show writing into executable and core files."), NULL,
1121 &setlist, &showlist);
1123 add_target_with_completer (&exec_ops, filename_completer);