1 /* Work with executable files, for GDB, the GNU debugger.
3 Copyright (C) 2003-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/>. */
24 #include "progspace.h"
26 #include "symfile-add-flags.h"
28 struct target_section
;
33 #define exec_bfd current_program_space->ebfd
34 #define exec_bfd_mtime current_program_space->ebfd_mtime
36 /* Builds a section table, given args BFD. */
38 extern target_section_table
build_section_table (struct bfd
*);
40 /* The current inferior is a child vforked and its program space is
41 shared with its parent. This pushes the exec target on the
42 current/child inferior's target stack if there are sections in the
43 program space's section table. */
45 extern void exec_on_vfork ();
47 /* Read from mappable read-only sections of BFD executable files.
48 Return TARGET_XFER_OK, if read is successful. Return
49 TARGET_XFER_EOF if read is done. Return TARGET_XFER_E_IO
52 extern enum target_xfer_status
53 exec_read_partial_read_only (gdb_byte
*readbuf
, ULONGEST offset
,
54 ULONGEST len
, ULONGEST
*xfered_len
);
56 /* Read or write from mappable sections of BFD executable files.
58 Request to transfer up to LEN 8-bit bytes of the target sections
59 defined by SECTIONS and SECTIONS_END. The OFFSET specifies the
62 The MATCH_CB predicate is optional; when provided it will be called
63 for each section under consideration. When MATCH_CB evaluates as
64 true, the section remains under consideration; a false result
65 removes it from consideration for performing the memory transfers
66 noted above. See memory_xfer_partial_1() in target.c for an
69 Return the number of bytes actually transfered, or zero when no
70 data is available for the requested range.
72 This function is intended to be used from target_xfer_partial
73 implementations. See target_read and target_write for more
76 One, and only one, of readbuf or writebuf must be non-NULL. */
78 extern enum target_xfer_status
79 section_table_xfer_memory_partial (gdb_byte
*,
81 ULONGEST
, ULONGEST
, ULONGEST
*,
82 const target_section_table
&,
83 gdb::function_view
<bool
84 (const struct target_section
*)> match_cb
87 /* Read from mappable read-only sections of BFD executable files.
88 Similar to exec_read_partial_read_only, but return
89 TARGET_XFER_UNAVAILABLE if data is unavailable. */
91 extern enum target_xfer_status
92 section_table_read_available_memory (gdb_byte
*readbuf
, ULONGEST offset
,
93 ULONGEST len
, ULONGEST
*xfered_len
);
95 /* Set the loaded address of a section. */
96 extern void exec_set_section_address (const char *, int, CORE_ADDR
);
98 /* Remove all target sections owned by OWNER. */
100 extern void remove_target_sections (void *owner
);
102 /* Add the sections array defined by [SECTIONS..SECTIONS_END[ to the
103 current set of target sections. */
105 extern void add_target_sections (void *owner
,
106 const target_section_table
§ions
);
108 /* Add the sections of OBJFILE to the current set of target sections.
109 * OBJFILE owns the new target sections. */
111 extern void add_target_sections_of_objfile (struct objfile
*objfile
);
113 /* Prints info about all sections defined in the TABLE. ABFD is
114 special cased --- it's filename is omitted; if it is the executable
115 file, its entry point is printed. */
117 extern void print_section_info (target_section_table
*table
,
120 extern void exec_close (void);
122 /* Helper function that attempts to open the symbol file at EXEC_FILE_HOST.
123 If successful, it proceeds to add the symbol file as the main symbol file.
125 ADD_FLAGS is passed on to the function adding the symbol file. */
126 extern void try_open_exec_file (const char *exec_file_host
,
127 struct inferior
*inf
,
128 symfile_add_flags add_flags
);