Commit | Line | Data |
---|---|---|
4646aa9d AC |
1 | /* Work with executable files, for GDB, the GNU debugger. |
2 | ||
ecd75fc8 | 3 | Copyright (C) 2003-2014 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 | ||
23 | #include "target.h" | |
6c95b8df | 24 | #include "progspace.h" |
e6ca34fc | 25 | #include "memrange.h" |
4646aa9d | 26 | |
0542c86d | 27 | struct target_section; |
4646aa9d AC |
28 | struct target_ops; |
29 | struct bfd; | |
76ad5e1e | 30 | struct objfile; |
4646aa9d | 31 | |
954a7fba | 32 | extern struct target_ops exec_ops; |
4646aa9d | 33 | |
6c95b8df PA |
34 | #define exec_bfd current_program_space->ebfd |
35 | #define exec_bfd_mtime current_program_space->ebfd_mtime | |
1f0c4988 | 36 | #define exec_filename current_program_space->pspace_exec_filename |
6c95b8df | 37 | |
4646aa9d AC |
38 | /* Builds a section table, given args BFD, SECTABLE_PTR, SECEND_PTR. |
39 | Returns 0 if OK, 1 on error. */ | |
40 | ||
0542c86d PA |
41 | extern int build_section_table (struct bfd *, struct target_section **, |
42 | struct target_section **); | |
4646aa9d | 43 | |
a5b1fd27 | 44 | /* Remove all entries from TABLE. */ |
07b82ea5 | 45 | |
a5b1fd27 | 46 | extern void clear_section_table (struct target_section_table *table); |
07b82ea5 | 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. | |
4b477ade PA |
62 | If SECTION_NAME is not NULL, only access sections with that same |
63 | name. | |
348f8c02 | 64 | |
4b477ade PA |
65 | Return the number of bytes actually transfered, or zero when no |
66 | data is available for the requested range. | |
348f8c02 PA |
67 | |
68 | This function is intended to be used from target_xfer_partial | |
69 | implementations. See target_read and target_write for more | |
70 | information. | |
71 | ||
72 | One, and only one, of readbuf or writebuf must be non-NULL. */ | |
73 | ||
9b409511 YQ |
74 | extern enum target_xfer_status |
75 | section_table_xfer_memory_partial (gdb_byte *, | |
76 | const gdb_byte *, | |
77 | ULONGEST, ULONGEST, ULONGEST *, | |
78 | struct target_section *, | |
79 | struct target_section *, | |
80 | const char *); | |
348f8c02 | 81 | |
1ee79381 YQ |
82 | /* Read from mappable read-only sections of BFD executable files. |
83 | Similar to exec_read_partial_read_only, but return | |
bc113b4e | 84 | TARGET_XFER_UNAVAILABLE if data is unavailable. */ |
1ee79381 YQ |
85 | |
86 | extern enum target_xfer_status | |
87 | section_table_read_available_memory (gdb_byte *readbuf, ULONGEST offset, | |
88 | ULONGEST len, ULONGEST *xfered_len); | |
89 | ||
c1bd25fd DJ |
90 | /* Set the loaded address of a section. */ |
91 | extern void exec_set_section_address (const char *, int, CORE_ADDR); | |
92 | ||
046ac79f | 93 | /* Remove all target sections owned by OWNER. */ |
07b82ea5 | 94 | |
046ac79f | 95 | extern void remove_target_sections (void *owner); |
07b82ea5 PA |
96 | |
97 | /* Add the sections array defined by [SECTIONS..SECTIONS_END[ to the | |
98 | current set of target sections. */ | |
99 | ||
046ac79f | 100 | extern void add_target_sections (void *owner, |
ed9eebaf | 101 | struct target_section *sections, |
07b82ea5 PA |
102 | struct target_section *sections_end); |
103 | ||
76ad5e1e NB |
104 | /* Add the sections of OBJFILE to the current set of target sections. |
105 | * OBJFILE owns the new target sections. */ | |
106 | ||
107 | extern void add_target_sections_of_objfile (struct objfile *objfile); | |
108 | ||
07b82ea5 PA |
109 | /* Prints info about all sections defined in the TABLE. ABFD is |
110 | special cased --- it's filename is omitted; if it is the executable | |
111 | file, its entry point is printed. */ | |
112 | ||
113 | extern void print_section_info (struct target_section_table *table, | |
114 | bfd *abfd); | |
115 | ||
6c95b8df | 116 | extern void exec_close (void); |
07b82ea5 | 117 | |
4646aa9d | 118 | #endif |