]>
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 | |
1f0c4988 | 35 | #define exec_filename current_program_space->pspace_exec_filename |
6c95b8df | 36 | |
2d128614 | 37 | /* Builds a section table, given args BFD. */ |
4646aa9d | 38 | |
2d128614 | 39 | extern target_section_table build_section_table (struct bfd *); |
4646aa9d | 40 | |
5b6d1e4f PA |
41 | /* The current inferior is a child vforked and its program space is |
42 | shared with its parent. This pushes the exec target on the | |
43 | current/child inferior's target stack if there are sections in the | |
44 | program space's section table. */ | |
45 | ||
46 | extern void exec_on_vfork (); | |
47 | ||
1ca49d37 YQ |
48 | /* Read from mappable read-only sections of BFD executable files. |
49 | Return TARGET_XFER_OK, if read is successful. Return | |
50 | TARGET_XFER_EOF if read is done. Return TARGET_XFER_E_IO | |
51 | otherwise. */ | |
52 | ||
53 | extern enum target_xfer_status | |
54 | exec_read_partial_read_only (gdb_byte *readbuf, ULONGEST offset, | |
55 | ULONGEST len, ULONGEST *xfered_len); | |
56 | ||
4b477ade PA |
57 | /* Read or write from mappable sections of BFD executable files. |
58 | ||
59 | Request to transfer up to LEN 8-bit bytes of the target sections | |
348f8c02 PA |
60 | defined by SECTIONS and SECTIONS_END. The OFFSET specifies the |
61 | starting address. | |
e56cb451 KB |
62 | |
63 | The MATCH_CB predicate is optional; when provided it will be called | |
64 | for each section under consideration. When MATCH_CB evaluates as | |
65 | true, the section remains under consideration; a false result | |
66 | removes it from consideration for performing the memory transfers | |
67 | noted above. See memory_xfer_partial_1() in target.c for an | |
68 | example. | |
348f8c02 | 69 | |
4b477ade PA |
70 | Return the number of bytes actually transfered, or zero when no |
71 | data is available for the requested range. | |
348f8c02 PA |
72 | |
73 | This function is intended to be used from target_xfer_partial | |
74 | implementations. See target_read and target_write for more | |
75 | information. | |
76 | ||
77 | One, and only one, of readbuf or writebuf must be non-NULL. */ | |
78 | ||
9b409511 YQ |
79 | extern enum target_xfer_status |
80 | section_table_xfer_memory_partial (gdb_byte *, | |
81 | const gdb_byte *, | |
82 | ULONGEST, ULONGEST, ULONGEST *, | |
bb2a6777 | 83 | const target_section_table &, |
e56cb451 KB |
84 | gdb::function_view<bool |
85 | (const struct target_section *)> match_cb | |
86 | = nullptr); | |
348f8c02 | 87 | |
1ee79381 YQ |
88 | /* Read from mappable read-only sections of BFD executable files. |
89 | Similar to exec_read_partial_read_only, but return | |
bc113b4e | 90 | TARGET_XFER_UNAVAILABLE if data is unavailable. */ |
1ee79381 YQ |
91 | |
92 | extern enum target_xfer_status | |
93 | section_table_read_available_memory (gdb_byte *readbuf, ULONGEST offset, | |
94 | ULONGEST len, ULONGEST *xfered_len); | |
95 | ||
c1bd25fd DJ |
96 | /* Set the loaded address of a section. */ |
97 | extern void exec_set_section_address (const char *, int, CORE_ADDR); | |
98 | ||
046ac79f | 99 | /* Remove all target sections owned by OWNER. */ |
07b82ea5 | 100 | |
046ac79f | 101 | extern void remove_target_sections (void *owner); |
07b82ea5 PA |
102 | |
103 | /* Add the sections array defined by [SECTIONS..SECTIONS_END[ to the | |
104 | current set of target sections. */ | |
105 | ||
046ac79f | 106 | extern void add_target_sections (void *owner, |
bb2a6777 | 107 | const target_section_table §ions); |
07b82ea5 | 108 | |
76ad5e1e NB |
109 | /* Add the sections of OBJFILE to the current set of target sections. |
110 | * OBJFILE owns the new target sections. */ | |
111 | ||
112 | extern void add_target_sections_of_objfile (struct objfile *objfile); | |
113 | ||
07b82ea5 PA |
114 | /* Prints info about all sections defined in the TABLE. ABFD is |
115 | special cased --- it's filename is omitted; if it is the executable | |
116 | file, its entry point is printed. */ | |
117 | ||
d7a78e5c | 118 | extern void print_section_info (target_section_table *table, |
07b82ea5 PA |
119 | bfd *abfd); |
120 | ||
6c95b8df | 121 | extern void exec_close (void); |
07b82ea5 | 122 | |
ecf45d2c SL |
123 | /* Helper function that attempts to open the symbol file at EXEC_FILE_HOST. |
124 | If successful, it proceeds to add the symbol file as the main symbol file. | |
125 | ||
126 | ADD_FLAGS is passed on to the function adding the symbol file. */ | |
127 | extern void try_open_exec_file (const char *exec_file_host, | |
128 | struct inferior *inf, | |
129 | symfile_add_flags add_flags); | |
4646aa9d | 130 | #endif |