1 /* Work with executable files, for GDB.
3 Copyright (C) 1988-2020 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"
32 #include "observable.h"
33 #include "arch-utils.h"
34 #include "gdbthread.h"
35 #include "progspace.h"
36 #include "progspace-and-thread.h"
43 #include "readline/tilde.h"
50 #include "gdbsupport/pathstuff.h"
51 #include "cli/cli-style.h"
53 void (*deprecated_file_changed_hook
) (const char *);
55 static const target_info exec_target_info
= {
57 N_("Local exec file"),
58 N_("Use an executable file as a target.\n\
59 Specify the filename of the executable file.")
62 /* The target vector for executable files. */
64 struct exec_target final
: public target_ops
66 const target_info
&info () const override
67 { return exec_target_info
; }
69 strata
stratum () const override
{ return file_stratum
; }
71 void close () override
;
72 enum target_xfer_status
xfer_partial (enum target_object object
,
75 const gdb_byte
*writebuf
,
76 ULONGEST offset
, ULONGEST len
,
77 ULONGEST
*xfered_len
) override
;
78 struct target_section_table
*get_section_table () override
;
79 void files_info () override
;
81 bool has_memory () override
;
82 char *make_corefile_notes (bfd
*, int *) override
;
83 int find_memory_regions (find_memory_region_ftype func
, void *data
) override
;
86 static exec_target exec_ops
;
88 /* How to handle a mismatch between the current exec file and the exec
89 file determined from target. */
91 static const char *const exec_file_mismatch_names
[]
92 = {"ask", "warn", "off", NULL
};
93 enum exec_file_mismatch_mode
95 exec_file_mismatch_ask
, exec_file_mismatch_warn
, exec_file_mismatch_off
97 static const char *exec_file_mismatch
= exec_file_mismatch_names
[0];
98 static enum exec_file_mismatch_mode exec_file_mismatch_mode
99 = exec_file_mismatch_ask
;
103 show_exec_file_mismatch_command (struct ui_file
*file
, int from_tty
,
104 struct cmd_list_element
*c
, const char *value
)
106 fprintf_filtered (gdb_stdout
,
107 _("exec-file-mismatch handling is currently \"%s\".\n"),
108 exec_file_mismatch_names
[exec_file_mismatch_mode
]);
111 /* Set command. Change the setting for range checking. */
113 set_exec_file_mismatch_command (const char *ignore
,
114 int from_tty
, struct cmd_list_element
*c
)
116 for (enum exec_file_mismatch_mode mode
= exec_file_mismatch_ask
;
118 mode
= static_cast<enum exec_file_mismatch_mode
>(1 + (int) mode
))
120 if (strcmp (exec_file_mismatch
, exec_file_mismatch_names
[mode
]) == 0)
122 exec_file_mismatch_mode
= mode
;
125 if (mode
== exec_file_mismatch_off
)
126 internal_error (__FILE__
, __LINE__
,
127 _("Unrecognized exec-file-mismatch setting: \"%s\""),
132 /* Whether to open exec and core files read-only or read-write. */
134 bool write_files
= false;
136 show_write_files (struct ui_file
*file
, int from_tty
,
137 struct cmd_list_element
*c
, const char *value
)
139 fprintf_filtered (file
, _("Writing into executable and core files is %s.\n"),
145 exec_target_open (const char *args
, int from_tty
)
147 target_preopen (from_tty
);
148 exec_file_attach (args
, from_tty
);
151 /* Close and clear exec_bfd. If we end up with no target sections to
152 read memory from, this unpushes the exec_ops target. */
159 bfd
*abfd
= exec_bfd
;
161 gdb_bfd_unref (abfd
);
163 /* Removing target sections may close the exec_ops target.
164 Clear exec_bfd before doing so to prevent recursion. */
168 remove_target_sections (&exec_bfd
);
170 xfree (exec_filename
);
171 exec_filename
= NULL
;
175 /* This is the target_close implementation. Clears all target
176 sections and closes all executable bfds from all program spaces. */
179 exec_target::close ()
181 scoped_restore_current_program_space restore_pspace
;
183 for (struct program_space
*ss
: program_spaces
)
185 set_current_program_space (ss
);
186 clear_section_table (current_target_sections
);
194 try_open_exec_file (const char *exec_file_host
, struct inferior
*inf
,
195 symfile_add_flags add_flags
)
197 struct gdb_exception prev_err
;
199 /* exec_file_attach and symbol_file_add_main may throw an error if the file
200 cannot be opened either locally or remotely.
202 This happens for example, when the file is first found in the local
203 sysroot (above), and then disappears (a TOCTOU race), or when it doesn't
204 exist in the target filesystem, or when the file does exist, but
207 Even without a symbol file, the remote-based debugging session should
208 continue normally instead of ending abruptly. Hence we catch thrown
209 errors/exceptions in the following code. */
212 /* We must do this step even if exec_file_host is NULL, so that
213 exec_file_attach will clear state. */
214 exec_file_attach (exec_file_host
, add_flags
& SYMFILE_VERBOSE
);
216 catch (gdb_exception_error
&err
)
218 if (err
.message
!= NULL
)
219 warning ("%s", err
.what ());
221 prev_err
= std::move (err
);
224 if (exec_file_host
!= NULL
)
228 symbol_file_add_main (exec_file_host
, add_flags
);
230 catch (const gdb_exception_error
&err
)
232 if (!exception_print_same (prev_err
, err
))
233 warning ("%s", err
.what ());
241 validate_exec_file (int from_tty
)
243 /* If user asked to ignore the mismatch, do nothing. */
244 if (exec_file_mismatch_mode
== exec_file_mismatch_off
)
247 const char *current_exec_file
= get_exec_file (0);
248 struct inferior
*inf
= current_inferior ();
249 /* Try to determine a filename from the process itself. */
250 const char *pid_exec_file
= target_pid_to_exec_file (inf
->pid
);
251 bool build_id_mismatch
= false;
253 /* If we cannot validate the exec file, return. */
254 if (current_exec_file
== NULL
|| pid_exec_file
== NULL
)
257 /* Try validating via build-id, if available. This is the most
260 /* In case current_exec_file was changed, reopen_exec_file ensures
261 an up to date build_id (will do nothing if the file timestamp
262 did not change). If exec file changed, reopen_exec_file has
263 allocated another file name, so get_exec_file again. */
265 current_exec_file
= get_exec_file (0);
267 const bfd_build_id
*exec_file_build_id
= build_id_bfd_get (exec_bfd
);
268 if (exec_file_build_id
!= nullptr)
270 /* Prepend the target prefix, to force gdb_bfd_open to open the
271 file on the remote file system (if indeed remote). */
272 std::string target_pid_exec_file
273 = std::string (TARGET_SYSROOT_PREFIX
) + pid_exec_file
;
275 gdb_bfd_ref_ptr
abfd (gdb_bfd_open (target_pid_exec_file
.c_str (),
276 gnutarget
, -1, false));
279 const bfd_build_id
*target_exec_file_build_id
280 = build_id_bfd_get (abfd
.get ());
282 if (target_exec_file_build_id
!= nullptr)
284 if (exec_file_build_id
->size
== target_exec_file_build_id
->size
285 && memcmp (exec_file_build_id
->data
,
286 target_exec_file_build_id
->data
,
287 exec_file_build_id
->size
) == 0)
293 build_id_mismatch
= true;
298 if (build_id_mismatch
)
300 std::string
exec_file_target (pid_exec_file
);
302 /* In case the exec file is not local, exec_file_target has to point at
303 the target file system. */
304 if (is_target_filename (current_exec_file
) && !target_filesystem_is_local ())
305 exec_file_target
= TARGET_SYSROOT_PREFIX
+ exec_file_target
;
308 (_("Build ID mismatch between current exec-file %ps\n"
309 "and automatically determined exec-file %ps\n"
310 "exec-file-mismatch handling is currently \"%s\""),
311 styled_string (file_name_style
.style (), current_exec_file
),
312 styled_string (file_name_style
.style (), exec_file_target
.c_str ()),
313 exec_file_mismatch_names
[exec_file_mismatch_mode
]);
314 if (exec_file_mismatch_mode
== exec_file_mismatch_ask
)
316 symfile_add_flags add_flags
= SYMFILE_MAINLINE
;
319 add_flags
|= SYMFILE_VERBOSE
;
320 add_flags
|= SYMFILE_ALWAYS_CONFIRM
;
324 symbol_file_add_main (exec_file_target
.c_str (), add_flags
);
325 exec_file_attach (exec_file_target
.c_str (), from_tty
);
327 catch (gdb_exception_error
&err
)
329 warning (_("loading %ps %s"),
330 styled_string (file_name_style
.style (),
331 exec_file_target
.c_str ()),
332 err
.message
!= NULL
? err
.what () : "error");
341 exec_file_locate_attach (int pid
, int defer_bp_reset
, int from_tty
)
343 char *exec_file_target
;
344 symfile_add_flags add_flags
= 0;
346 /* Do nothing if we already have an executable filename. */
347 if (get_exec_file (0) != NULL
)
350 /* Try to determine a filename from the process itself. */
351 exec_file_target
= target_pid_to_exec_file (pid
);
352 if (exec_file_target
== NULL
)
354 warning (_("No executable has been specified and target does not "
356 "determining executable automatically. "
357 "Try using the \"file\" command."));
361 gdb::unique_xmalloc_ptr
<char> exec_file_host
362 = exec_file_find (exec_file_target
, NULL
);
365 add_flags
|= SYMFILE_DEFER_BP_RESET
;
368 add_flags
|= SYMFILE_VERBOSE
;
370 /* Attempt to open the exec file. */
371 try_open_exec_file (exec_file_host
.get (), current_inferior (), add_flags
);
374 /* Set FILENAME as the new exec file.
376 This function is intended to be behave essentially the same
377 as exec_file_command, except that the latter will detect when
378 a target is being debugged, and will ask the user whether it
379 should be shut down first. (If the answer is "no", then the
380 new file is ignored.)
382 This file is used by exec_file_command, to do the work of opening
383 and processing the exec file after any prompting has happened.
385 And, it is used by child_attach, when the attach command was
386 given a pid but not a exec pathname, and the attach command could
387 figure out the pathname from the pid. (In this case, we shouldn't
388 ask the user whether the current target should be shut down --
389 we're supplying the exec pathname late for good reason.) */
392 exec_file_attach (const char *filename
, int from_tty
)
394 /* First, acquire a reference to the current exec_bfd. We release
395 this at the end of the function; but acquiring it now lets the
396 BFD cache return it if this call refers to the same file. */
397 gdb_bfd_ref_ptr exec_bfd_holder
= gdb_bfd_ref_ptr::new_reference (exec_bfd
);
399 /* Remove any previous exec file. */
402 /* Now open and digest the file the user requested, if any. */
407 printf_unfiltered (_("No executable file now.\n"));
409 set_gdbarch_from_file (NULL
);
413 int load_via_target
= 0;
414 const char *scratch_pathname
, *canonical_pathname
;
416 struct target_section
*sections
= NULL
, *sections_end
= NULL
;
419 if (is_target_filename (filename
))
421 if (target_filesystem_is_local ())
422 filename
+= strlen (TARGET_SYSROOT_PREFIX
);
427 gdb::unique_xmalloc_ptr
<char> canonical_storage
, scratch_storage
;
430 /* gdb_bfd_fopen does not support "target:" filenames. */
432 warning (_("writing into executable files is "
433 "not supported for %s sysroots"),
434 TARGET_SYSROOT_PREFIX
);
436 scratch_pathname
= filename
;
438 canonical_pathname
= scratch_pathname
;
442 scratch_chan
= openp (getenv ("PATH"), OPF_TRY_CWD_FIRST
,
443 filename
, write_files
?
444 O_RDWR
| O_BINARY
: O_RDONLY
| O_BINARY
,
446 #if defined(__GO32__) || defined(_WIN32) || defined(__CYGWIN__)
447 if (scratch_chan
< 0)
449 int first_errno
= errno
;
450 char *exename
= (char *) alloca (strlen (filename
) + 5);
452 strcat (strcpy (exename
, filename
), ".exe");
453 scratch_chan
= openp (getenv ("PATH"), OPF_TRY_CWD_FIRST
,
454 exename
, write_files
?
456 : O_RDONLY
| O_BINARY
,
458 if (scratch_chan
< 0)
462 if (scratch_chan
< 0)
463 perror_with_name (filename
);
465 scratch_pathname
= scratch_storage
.get ();
467 /* gdb_bfd_open (and its variants) prefers canonicalized
468 pathname for better BFD caching. */
469 canonical_storage
= gdb_realpath (scratch_pathname
);
470 canonical_pathname
= canonical_storage
.get ();
473 gdb_bfd_ref_ptr temp
;
474 if (write_files
&& !load_via_target
)
475 temp
= gdb_bfd_fopen (canonical_pathname
, gnutarget
,
476 FOPEN_RUB
, scratch_chan
);
478 temp
= gdb_bfd_open (canonical_pathname
, gnutarget
, scratch_chan
);
479 exec_bfd
= temp
.release ();
483 error (_("\"%ps\": could not open as an executable file: %s."),
484 styled_string (file_name_style
.style (), scratch_pathname
),
485 bfd_errmsg (bfd_get_error ()));
488 /* gdb_realpath_keepfile resolves symlinks on the local
489 filesystem and so cannot be used for "target:" files. */
490 gdb_assert (exec_filename
== NULL
);
492 exec_filename
= xstrdup (bfd_get_filename (exec_bfd
));
494 exec_filename
= gdb_realpath_keepfile (scratch_pathname
).release ();
496 if (!bfd_check_format_matches (exec_bfd
, bfd_object
, &matching
))
498 /* Make sure to close exec_bfd, or else "run" might try to use
501 error (_("\"%ps\": not in executable format: %s"),
502 styled_string (file_name_style
.style (), scratch_pathname
),
503 gdb_bfd_errmsg (bfd_get_error (), matching
).c_str ());
506 if (build_section_table (exec_bfd
, §ions
, §ions_end
))
508 /* Make sure to close exec_bfd, or else "run" might try to use
511 error (_("\"%ps\": can't find the file sections: %s"),
512 styled_string (file_name_style
.style (), scratch_pathname
),
513 bfd_errmsg (bfd_get_error ()));
516 exec_bfd_mtime
= bfd_get_mtime (exec_bfd
);
520 set_gdbarch_from_file (exec_bfd
);
522 /* Add the executable's sections to the current address spaces'
523 list of sections. This possibly pushes the exec_ops
525 add_target_sections (&exec_bfd
, sections
, sections_end
);
528 /* Tell display code (if any) about the changed file name. */
529 if (deprecated_exec_file_display_hook
)
530 (*deprecated_exec_file_display_hook
) (filename
);
533 bfd_cache_close_all ();
534 gdb::observers::executable_changed
.notify ();
537 /* Process the first arg in ARGS as the new exec file.
539 Note that we have to explicitly ignore additional args, since we can
540 be called from file_command(), which also calls symbol_file_command()
541 which can take multiple args.
543 If ARGS is NULL, we just want to close the exec file. */
546 exec_file_command (const char *args
, int from_tty
)
548 if (from_tty
&& target_has_execution ()
549 && !query (_("A program is being debugged already.\n"
550 "Are you sure you want to change the file? ")))
551 error (_("File not changed."));
555 /* Scan through the args and pick up the first non option arg
558 gdb_argv
built_argv (args
);
559 char **argv
= built_argv
.get ();
561 for (; (*argv
!= NULL
) && (**argv
== '-'); argv
++)
565 error (_("No executable file name was specified"));
567 gdb::unique_xmalloc_ptr
<char> filename (tilde_expand (*argv
));
568 exec_file_attach (filename
.get (), from_tty
);
571 exec_file_attach (NULL
, from_tty
);
574 /* Set both the exec file and the symbol file, in one command.
575 What a novelty. Why did GDB go through four major releases before this
576 command was added? */
579 file_command (const char *arg
, int from_tty
)
581 /* FIXME, if we lose on reading the symbol file, we should revert
582 the exec file, but that's rough. */
583 exec_file_command (arg
, from_tty
);
584 symbol_file_command (arg
, from_tty
);
585 if (deprecated_file_changed_hook
)
586 deprecated_file_changed_hook (arg
);
593 clear_section_table (struct target_section_table
*table
)
595 xfree (table
->sections
);
596 table
->sections
= table
->sections_end
= NULL
;
599 /* Resize section table TABLE by ADJUSTMENT.
600 ADJUSTMENT may be negative, in which case the caller must have already
601 removed the sections being deleted.
602 Returns the old size. */
605 resize_section_table (struct target_section_table
*table
, int adjustment
)
610 old_count
= table
->sections_end
- table
->sections
;
612 new_count
= adjustment
+ old_count
;
616 table
->sections
= XRESIZEVEC (struct target_section
, table
->sections
,
618 table
->sections_end
= table
->sections
+ new_count
;
621 clear_section_table (table
);
626 /* Builds a section table, given args BFD, SECTABLE_PTR, SECEND_PTR.
627 Returns 0 if OK, 1 on error. */
630 build_section_table (struct bfd
*some_bfd
, struct target_section
**start
,
631 struct target_section
**end
)
635 count
= bfd_count_sections (some_bfd
);
637 *start
= XNEWVEC (struct target_section
, count
);
639 for (asection
*asect
: gdb_bfd_sections (some_bfd
))
643 /* Check the section flags, but do not discard zero-length
644 sections, since some symbols may still be attached to this
645 section. For instance, we encountered on sparc-solaris 2.10
646 a shared library with an empty .bss section to which a symbol
647 named "_end" was attached. The address of this symbol still
648 needs to be relocated. */
649 aflag
= bfd_section_flags (asect
);
650 if (!(aflag
& SEC_ALLOC
))
653 (*end
)->owner
= NULL
;
654 (*end
)->the_bfd_section
= asect
;
655 (*end
)->addr
= bfd_section_vma (asect
);
656 (*end
)->endaddr
= (*end
)->addr
+ bfd_section_size (asect
);
660 gdb_assert (*end
<= *start
+ count
);
662 /* We could realloc the table, but it probably loses for most files. */
666 /* Add the sections array defined by [SECTIONS..SECTIONS_END[ to the
667 current set of target sections. */
670 add_target_sections (void *owner
,
671 struct target_section
*sections
,
672 struct target_section
*sections_end
)
675 struct target_section_table
*table
= current_target_sections
;
677 count
= sections_end
- sections
;
681 int space
= resize_section_table (table
, count
);
684 for (i
= 0; i
< count
; ++i
)
686 table
->sections
[space
+ i
] = sections
[i
];
687 table
->sections
[space
+ i
].owner
= owner
;
690 scoped_restore_current_pspace_and_thread restore_pspace_thread
;
691 program_space
*curr_pspace
= current_program_space
;
693 /* If these are the first file sections we can provide memory
694 from, push the file_stratum target. Must do this in all
695 inferiors sharing the program space. */
696 for (inferior
*inf
: all_inferiors ())
698 if (inf
->pspace
!= curr_pspace
)
701 if (inf
->target_is_pushed (&exec_ops
))
704 switch_to_inferior_no_thread (inf
);
705 push_target (&exec_ops
);
710 /* Add the sections of OBJFILE to the current set of target sections. */
713 add_target_sections_of_objfile (struct objfile
*objfile
)
715 struct target_section_table
*table
= current_target_sections
;
716 struct obj_section
*osect
;
719 struct target_section
*ts
;
724 /* Compute the number of sections to add. */
725 ALL_OBJFILE_OSECTIONS (objfile
, osect
)
727 if (bfd_section_size (osect
->the_bfd_section
) == 0)
735 space
= resize_section_table (table
, count
);
737 ts
= table
->sections
+ space
;
739 ALL_OBJFILE_OSECTIONS (objfile
, osect
)
741 if (bfd_section_size (osect
->the_bfd_section
) == 0)
744 gdb_assert (ts
< table
->sections
+ space
+ count
);
746 ts
->addr
= obj_section_addr (osect
);
747 ts
->endaddr
= obj_section_endaddr (osect
);
748 ts
->the_bfd_section
= osect
->the_bfd_section
;
749 ts
->owner
= (void *) objfile
;
755 /* Remove all target sections owned by OWNER.
756 OWNER must be the same value passed to add_target_sections. */
759 remove_target_sections (void *owner
)
761 struct target_section
*src
, *dest
;
762 struct target_section_table
*table
= current_target_sections
;
764 gdb_assert (owner
!= NULL
);
766 dest
= table
->sections
;
767 for (src
= table
->sections
; src
< table
->sections_end
; src
++)
768 if (src
->owner
!= owner
)
770 /* Keep this section. */
776 /* If we've dropped any sections, resize the section table. */
781 old_count
= resize_section_table (table
, dest
- src
);
783 /* If we don't have any more sections to read memory from,
784 remove the file_stratum target from the stack of each
785 inferior sharing the program space. */
786 if (old_count
+ (dest
- src
) == 0)
788 scoped_restore_current_pspace_and_thread restore_pspace_thread
;
789 program_space
*curr_pspace
= current_program_space
;
791 for (inferior
*inf
: all_inferiors ())
793 if (inf
->pspace
!= curr_pspace
)
796 if (inf
->pspace
->target_sections
.sections
797 != inf
->pspace
->target_sections
.sections_end
)
800 switch_to_inferior_no_thread (inf
);
801 unpush_target (&exec_ops
);
812 if (current_program_space
->target_sections
.sections
813 != current_program_space
->target_sections
.sections_end
)
814 push_target (&exec_ops
);
819 enum target_xfer_status
820 exec_read_partial_read_only (gdb_byte
*readbuf
, ULONGEST offset
,
821 ULONGEST len
, ULONGEST
*xfered_len
)
823 /* It's unduly pedantic to refuse to look at the executable for
824 read-only pieces; so do the equivalent of readonly regions aka
826 if (exec_bfd
!= NULL
)
832 for (s
= exec_bfd
->sections
; s
; s
= s
->next
)
834 if ((s
->flags
& SEC_LOAD
) == 0
835 || (s
->flags
& SEC_READONLY
) == 0)
839 size
= bfd_section_size (s
);
840 if (vma
<= offset
&& offset
< (vma
+ size
))
844 amt
= (vma
+ size
) - offset
;
848 amt
= bfd_get_section_contents (exec_bfd
, s
,
849 readbuf
, offset
- vma
, amt
);
852 return TARGET_XFER_EOF
;
856 return TARGET_XFER_OK
;
862 /* Indicate failure to find the requested memory block. */
863 return TARGET_XFER_E_IO
;
866 /* Return all read-only memory ranges found in the target section
867 table defined by SECTIONS and SECTIONS_END, starting at (and
868 intersected with) MEMADDR for LEN bytes. */
870 static std::vector
<mem_range
>
871 section_table_available_memory (CORE_ADDR memaddr
, ULONGEST len
,
872 struct target_section
*sections
,
873 struct target_section
*sections_end
)
875 std::vector
<mem_range
> memory
;
877 for (target_section
*p
= sections
; p
< sections_end
; p
++)
879 if ((bfd_section_flags (p
->the_bfd_section
) & SEC_READONLY
) == 0)
882 /* Copy the meta-data, adjusted. */
883 if (mem_ranges_overlap (p
->addr
, p
->endaddr
- p
->addr
, memaddr
, len
))
885 ULONGEST lo1
, hi1
, lo2
, hi2
;
893 CORE_ADDR start
= std::max (lo1
, lo2
);
894 int length
= std::min (hi1
, hi2
) - start
;
896 memory
.emplace_back (start
, length
);
903 enum target_xfer_status
904 section_table_read_available_memory (gdb_byte
*readbuf
, ULONGEST offset
,
905 ULONGEST len
, ULONGEST
*xfered_len
)
907 target_section_table
*table
= target_get_section_table (&exec_ops
);
908 std::vector
<mem_range
> available_memory
909 = section_table_available_memory (offset
, len
,
910 table
->sections
, table
->sections_end
);
912 normalize_mem_ranges (&available_memory
);
914 for (const mem_range
&r
: available_memory
)
916 if (mem_ranges_overlap (r
.start
, r
.length
, offset
, len
))
919 enum target_xfer_status status
;
921 /* Get the intersection window. */
922 end
= std::min
<CORE_ADDR
> (offset
+ len
, r
.start
+ r
.length
);
924 gdb_assert (end
- offset
<= len
);
926 if (offset
>= r
.start
)
927 status
= exec_read_partial_read_only (readbuf
, offset
,
932 *xfered_len
= r
.start
- offset
;
933 status
= TARGET_XFER_UNAVAILABLE
;
940 return TARGET_XFER_UNAVAILABLE
;
943 enum target_xfer_status
944 section_table_xfer_memory_partial (gdb_byte
*readbuf
, const gdb_byte
*writebuf
,
945 ULONGEST offset
, ULONGEST len
,
946 ULONGEST
*xfered_len
,
947 struct target_section
*sections
,
948 struct target_section
*sections_end
,
949 gdb::function_view
<bool
950 (const struct target_section
*)> match_cb
)
953 struct target_section
*p
;
954 ULONGEST memaddr
= offset
;
955 ULONGEST memend
= memaddr
+ len
;
957 gdb_assert (len
!= 0);
959 for (p
= sections
; p
< sections_end
; p
++)
961 struct bfd_section
*asect
= p
->the_bfd_section
;
962 bfd
*abfd
= asect
->owner
;
964 if (match_cb
!= nullptr && !match_cb (p
))
965 continue; /* not the section we need. */
966 if (memaddr
>= p
->addr
)
968 if (memend
<= p
->endaddr
)
970 /* Entire transfer is within this section. */
972 res
= bfd_set_section_contents (abfd
, asect
,
973 writebuf
, memaddr
- p
->addr
,
976 res
= bfd_get_section_contents (abfd
, asect
,
977 readbuf
, memaddr
- p
->addr
,
983 return TARGET_XFER_OK
;
986 return TARGET_XFER_EOF
;
988 else if (memaddr
>= p
->endaddr
)
990 /* This section ends before the transfer starts. */
995 /* This section overlaps the transfer. Just do half. */
996 len
= p
->endaddr
- memaddr
;
998 res
= bfd_set_section_contents (abfd
, asect
,
999 writebuf
, memaddr
- p
->addr
,
1002 res
= bfd_get_section_contents (abfd
, asect
,
1003 readbuf
, memaddr
- p
->addr
,
1008 return TARGET_XFER_OK
;
1011 return TARGET_XFER_EOF
;
1016 return TARGET_XFER_EOF
; /* We can't help. */
1019 struct target_section_table
*
1020 exec_target::get_section_table ()
1022 return current_target_sections
;
1025 enum target_xfer_status
1026 exec_target::xfer_partial (enum target_object object
,
1027 const char *annex
, gdb_byte
*readbuf
,
1028 const gdb_byte
*writebuf
,
1029 ULONGEST offset
, ULONGEST len
, ULONGEST
*xfered_len
)
1031 struct target_section_table
*table
= get_section_table ();
1033 if (object
== TARGET_OBJECT_MEMORY
)
1034 return section_table_xfer_memory_partial (readbuf
, writebuf
,
1035 offset
, len
, xfered_len
,
1037 table
->sections_end
);
1039 return TARGET_XFER_E_IO
;
1044 print_section_info (struct target_section_table
*t
, bfd
*abfd
)
1046 struct gdbarch
*gdbarch
= gdbarch_from_bfd (abfd
);
1047 struct target_section
*p
;
1048 /* FIXME: 16 is not wide enough when gdbarch_addr_bit > 64. */
1049 int wid
= gdbarch_addr_bit (gdbarch
) <= 32 ? 8 : 16;
1051 printf_filtered ("\t`%ps', ",
1052 styled_string (file_name_style
.style (),
1053 bfd_get_filename (abfd
)));
1055 printf_filtered (_("file type %s.\n"), bfd_get_target (abfd
));
1056 if (abfd
== exec_bfd
)
1058 /* gcc-3.4 does not like the initialization in
1059 <p == t->sections_end>. */
1060 bfd_vma displacement
= 0;
1061 bfd_vma entry_point
;
1063 for (p
= t
->sections
; p
< t
->sections_end
; p
++)
1065 struct bfd_section
*psect
= p
->the_bfd_section
;
1067 if ((bfd_section_flags (psect
) & (SEC_ALLOC
| SEC_LOAD
))
1068 != (SEC_ALLOC
| SEC_LOAD
))
1071 if (bfd_section_vma (psect
) <= abfd
->start_address
1072 && abfd
->start_address
< (bfd_section_vma (psect
)
1073 + bfd_section_size (psect
)))
1075 displacement
= p
->addr
- bfd_section_vma (psect
);
1079 if (p
== t
->sections_end
)
1080 warning (_("Cannot find section for the entry point of %ps."),
1081 styled_string (file_name_style
.style (),
1082 bfd_get_filename (abfd
)));
1084 entry_point
= gdbarch_addr_bits_remove (gdbarch
,
1085 bfd_get_start_address (abfd
)
1087 printf_filtered (_("\tEntry point: %s\n"),
1088 paddress (gdbarch
, entry_point
));
1090 for (p
= t
->sections
; p
< t
->sections_end
; p
++)
1092 struct bfd_section
*psect
= p
->the_bfd_section
;
1093 bfd
*pbfd
= psect
->owner
;
1095 printf_filtered ("\t%s", hex_string_custom (p
->addr
, wid
));
1096 printf_filtered (" - %s", hex_string_custom (p
->endaddr
, wid
));
1098 /* FIXME: A format of "08l" is not wide enough for file offsets
1099 larger than 4GB. OTOH, making it "016l" isn't desirable either
1100 since most output will then be much wider than necessary. It
1101 may make sense to test the size of the file and choose the
1102 format string accordingly. */
1103 /* FIXME: i18n: Need to rewrite this sentence. */
1105 printf_filtered (" @ %s",
1106 hex_string_custom (psect
->filepos
, 8));
1107 printf_filtered (" is %s", bfd_section_name (psect
));
1109 printf_filtered (" in %ps",
1110 styled_string (file_name_style
.style (),
1111 bfd_get_filename (pbfd
)));
1112 printf_filtered ("\n");
1117 exec_target::files_info ()
1120 print_section_info (current_target_sections
, exec_bfd
);
1122 puts_filtered (_("\t<no file loaded>\n"));
1126 set_section_command (const char *args
, int from_tty
)
1128 struct target_section
*p
;
1129 const char *secname
;
1131 unsigned long secaddr
;
1134 struct target_section_table
*table
;
1137 error (_("Must specify section name and its virtual address"));
1139 /* Parse out section name. */
1140 for (secname
= args
; !isspace (*args
); args
++);
1141 seclen
= args
- secname
;
1143 /* Parse out new virtual address. */
1144 secaddr
= parse_and_eval_address (args
);
1146 table
= current_target_sections
;
1147 for (p
= table
->sections
; p
< table
->sections_end
; p
++)
1149 if (!strncmp (secname
, bfd_section_name (p
->the_bfd_section
), seclen
)
1150 && bfd_section_name (p
->the_bfd_section
)[seclen
] == '\0')
1152 offset
= secaddr
- p
->addr
;
1154 p
->endaddr
+= offset
;
1156 exec_ops
.files_info ();
1160 if (seclen
>= sizeof (secprint
))
1161 seclen
= sizeof (secprint
) - 1;
1162 strncpy (secprint
, secname
, seclen
);
1163 secprint
[seclen
] = '\0';
1164 error (_("Section %s not found"), secprint
);
1167 /* If we can find a section in FILENAME with BFD index INDEX, adjust
1171 exec_set_section_address (const char *filename
, int index
, CORE_ADDR address
)
1173 struct target_section
*p
;
1174 struct target_section_table
*table
;
1176 table
= current_target_sections
;
1177 for (p
= table
->sections
; p
< table
->sections_end
; p
++)
1179 if (filename_cmp (filename
,
1180 bfd_get_filename (p
->the_bfd_section
->owner
)) == 0
1181 && index
== p
->the_bfd_section
->index
)
1183 p
->endaddr
+= address
- p
->addr
;
1190 exec_target::has_memory ()
1192 /* We can provide memory if we have any file/target sections to read
1194 return (current_target_sections
->sections
1195 != current_target_sections
->sections_end
);
1199 exec_target::make_corefile_notes (bfd
*obfd
, int *note_size
)
1201 error (_("Can't create a corefile"));
1205 exec_target::find_memory_regions (find_memory_region_ftype func
, void *data
)
1207 return objfile_find_memory_regions (this, func
, data
);
1210 void _initialize_exec ();
1214 struct cmd_list_element
*c
;
1218 c
= add_cmd ("file", class_files
, file_command
, _("\
1219 Use FILE as program to be debugged.\n\
1220 It is read for its symbols, for getting the contents of pure memory,\n\
1221 and it is the program executed when you use the `run' command.\n\
1222 If FILE cannot be found as specified, your execution directory path\n\
1223 ($PATH) is searched for a command of that name.\n\
1224 No arg means to have no executable file and no symbols."), &cmdlist
);
1225 set_cmd_completer (c
, filename_completer
);
1228 c
= add_cmd ("exec-file", class_files
, exec_file_command
, _("\
1229 Use FILE as program for getting contents of pure memory.\n\
1230 If FILE cannot be found as specified, your execution directory path\n\
1231 is searched for a command of that name.\n\
1232 No arg means have no executable file."), &cmdlist
);
1233 set_cmd_completer (c
, filename_completer
);
1235 add_com ("section", class_files
, set_section_command
, _("\
1236 Change the base address of section SECTION of the exec file to ADDR.\n\
1237 This can be used if the exec file does not contain section addresses,\n\
1238 (such as in the a.out format), or when the addresses specified in the\n\
1239 file itself are wrong. Each section must be changed separately. The\n\
1240 ``info files'' command lists all the sections and their addresses."));
1242 add_setshow_boolean_cmd ("write", class_support
, &write_files
, _("\
1243 Set writing into executable and core files."), _("\
1244 Show writing into executable and core files."), NULL
,
1247 &setlist
, &showlist
);
1249 add_setshow_enum_cmd ("exec-file-mismatch", class_support
,
1250 exec_file_mismatch_names
,
1251 &exec_file_mismatch
,
1253 Set exec-file-mismatch handling (ask|warn|off)."),
1255 Show exec-file-mismatch handling (ask|warn|off)."),
1257 Specifies how to handle a mismatch between the current exec-file\n\
1258 loaded by GDB and the exec-file automatically determined when attaching\n\
1260 ask - warn the user and ask whether to load the determined exec-file.\n\
1261 warn - warn the user, but do not change the exec-file.\n\
1262 off - do not check for mismatch.\n\
1264 GDB detects a mismatch by comparing the build IDs of the files.\n\
1265 If the user confirms loading the determined exec-file, then its symbols\n\
1266 will be loaded as well."),
1267 set_exec_file_mismatch_command
,
1268 show_exec_file_mismatch_command
,
1269 &setlist
, &showlist
);
1271 add_target (exec_target_info
, exec_target_open
, filename_completer
);