Commit | Line | Data |
---|---|---|
4646aa9d AC |
1 | /* Work with executable files, for GDB, the GNU debugger. |
2 | ||
b811d2c2 | 3 | Copyright (C) 2003-2020 Free Software Foundation, Inc. |
4646aa9d AC |
4 | |
5 | This file is part of GDB. | |
6 | ||
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 | |
a9762ec7 | 9 | the Free Software Foundation; either version 3 of the License, or |
4646aa9d AC |
10 | (at your option) any later version. |
11 | ||
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. | |
16 | ||
17 | You should have received a copy of the GNU General Public License | |
a9762ec7 | 18 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
4646aa9d AC |
19 | |
20 | #ifndef EXEC_H | |
21 | #define EXEC_H | |
22 | ||
4de283e4 | 23 | #include "target.h" |
d55e5aa6 | 24 | #include "progspace.h" |
4de283e4 | 25 | #include "memrange.h" |
ecf45d2c | 26 | #include "symfile-add-flags.h" |
4646aa9d | 27 | |
0542c86d | 28 | struct target_section; |
4646aa9d AC |
29 | struct target_ops; |
30 | struct bfd; | |
76ad5e1e | 31 | struct objfile; |
4646aa9d | 32 | |
6c95b8df PA |
33 | #define exec_bfd current_program_space->ebfd |
34 | #define exec_bfd_mtime current_program_space->ebfd_mtime | |
35 | ||
2d128614 | 36 | /* Builds a section table, given args BFD. */ |
4646aa9d | 37 | |
2d128614 | 38 | extern target_section_table build_section_table (struct bfd *); |
4646aa9d | 39 | |
5b6d1e4f PA |
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. */ | |
44 | ||
45 | extern void exec_on_vfork (); | |
46 | ||
1ca49d37 YQ |
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 | |
50 | otherwise. */ | |
51 | ||
52 | extern enum target_xfer_status | |
53 | exec_read_partial_read_only (gdb_byte *readbuf, ULONGEST offset, | |
54 | ULONGEST len, ULONGEST *xfered_len); | |
55 | ||
4b477ade PA |
56 | /* Read or write from mappable sections of BFD executable files. |
57 | ||
58 | Request to transfer up to LEN 8-bit bytes of the target sections | |
348f8c02 PA |
59 | defined by SECTIONS and SECTIONS_END. The OFFSET specifies the |
60 | starting address. | |
e56cb451 KB |
61 | |
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 | |
67 | example. | |
348f8c02 | 68 | |
4b477ade PA |
69 | Return the number of bytes actually transfered, or zero when no |
70 | data is available for the requested range. | |
348f8c02 PA |
71 | |
72 | This function is intended to be used from target_xfer_partial | |
73 | implementations. See target_read and target_write for more | |
74 | information. | |
75 | ||
76 | One, and only one, of readbuf or writebuf must be non-NULL. */ | |
77 | ||
9b409511 YQ |
78 | extern enum target_xfer_status |
79 | section_table_xfer_memory_partial (gdb_byte *, | |
80 | const gdb_byte *, | |
81 | ULONGEST, ULONGEST, ULONGEST *, | |
bb2a6777 | 82 | const target_section_table &, |
e56cb451 KB |
83 | gdb::function_view<bool |
84 | (const struct target_section *)> match_cb | |
85 | = nullptr); | |
348f8c02 | 86 | |
1ee79381 YQ |
87 | /* Read from mappable read-only sections of BFD executable files. |
88 | Similar to exec_read_partial_read_only, but return | |
bc113b4e | 89 | TARGET_XFER_UNAVAILABLE if data is unavailable. */ |
1ee79381 YQ |
90 | |
91 | extern enum target_xfer_status | |
92 | section_table_read_available_memory (gdb_byte *readbuf, ULONGEST offset, | |
93 | ULONGEST len, ULONGEST *xfered_len); | |
94 | ||
c1bd25fd DJ |
95 | /* Set the loaded address of a section. */ |
96 | extern void exec_set_section_address (const char *, int, CORE_ADDR); | |
97 | ||
046ac79f | 98 | /* Remove all target sections owned by OWNER. */ |
07b82ea5 | 99 | |
046ac79f | 100 | extern void remove_target_sections (void *owner); |
07b82ea5 PA |
101 | |
102 | /* Add the sections array defined by [SECTIONS..SECTIONS_END[ to the | |
103 | current set of target sections. */ | |
104 | ||
046ac79f | 105 | extern void add_target_sections (void *owner, |
bb2a6777 | 106 | const target_section_table §ions); |
07b82ea5 | 107 | |
76ad5e1e NB |
108 | /* Add the sections of OBJFILE to the current set of target sections. |
109 | * OBJFILE owns the new target sections. */ | |
110 | ||
111 | extern void add_target_sections_of_objfile (struct objfile *objfile); | |
112 | ||
07b82ea5 PA |
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. */ | |
116 | ||
d7a78e5c | 117 | extern void print_section_info (target_section_table *table, |
07b82ea5 PA |
118 | bfd *abfd); |
119 | ||
6c95b8df | 120 | extern void exec_close (void); |
07b82ea5 | 121 | |
ecf45d2c SL |
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. | |
124 | ||
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); | |
4646aa9d | 129 | #endif |