]>
Commit | Line | Data |
---|---|---|
252b5132 | 1 | /* ld.h -- general linker header file |
a2c58332 | 2 | Copyright (C) 1991-2022 Free Software Foundation, Inc. |
252b5132 | 3 | |
f96b4a7b | 4 | This file is part of the GNU Binutils. |
252b5132 | 5 | |
f96b4a7b | 6 | This program is free software; you can redistribute it and/or modify |
252b5132 | 7 | it under the terms of the GNU General Public License as published by |
f96b4a7b NC |
8 | the Free Software Foundation; either version 3 of the License, or |
9 | (at your option) any later version. | |
252b5132 | 10 | |
f96b4a7b | 11 | This program is distributed in the hope that it will be useful, |
252b5132 RH |
12 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
14 | GNU General Public License for more details. | |
15 | ||
16 | You should have received a copy of the GNU General Public License | |
f96b4a7b NC |
17 | along with this program; if not, write to the Free Software |
18 | Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, | |
19 | MA 02110-1301, USA. */ | |
252b5132 RH |
20 | |
21 | #ifndef LD_H | |
22 | #define LD_H | |
23 | ||
a70c2403 NC |
24 | #ifndef SEEK_CUR |
25 | #define SEEK_CUR 1 | |
26 | #endif | |
27 | #ifndef SEEK_END | |
28 | #define SEEK_END 2 | |
29 | #endif | |
30 | ||
c774eab1 AM |
31 | #ifndef ENABLE_NLS |
32 | /* The Solaris version of locale.h always includes libintl.h. If we have | |
33 | been configured with --disable-nls then ENABLE_NLS will not be defined | |
34 | and the dummy definitions of bindtextdomain (et al) below will conflict | |
35 | with the defintions in libintl.h. So we define these values to prevent | |
36 | the bogus inclusion of libintl.h. */ | |
37 | # define _LIBINTL_H | |
38 | # define _LIBGETTEXT_H | |
252b5132 | 39 | #endif |
c774eab1 | 40 | #include <locale.h> |
252b5132 RH |
41 | |
42 | #ifdef ENABLE_NLS | |
43 | # include <libintl.h> | |
44 | # define _(String) gettext (String) | |
45 | # ifdef gettext_noop | |
46 | # define N_(String) gettext_noop (String) | |
47 | # else | |
48 | # define N_(String) (String) | |
49 | # endif | |
50 | #else | |
897083bd AM |
51 | # define gettext(Msgid) (Msgid) |
52 | # define dgettext(Domainname, Msgid) (Msgid) | |
53 | # define dcgettext(Domainname, Msgid, Category) (Msgid) | |
6003e27e AM |
54 | # define ngettext(Msgid1, Msgid2, n) \ |
55 | (n == 1 ? Msgid1 : Msgid2) | |
56 | # define dngettext(Domainname, Msgid1, Msgid2, n) \ | |
57 | (n == 1 ? Msgid1 : Msgid2) | |
58 | # define dcngettext(Domainname, Msgid1, Msgid2, n, Category) \ | |
59 | (n == 1 ? Msgid1 : Msgid2) | |
60 | # define textdomain(Domainname) do {} while (0) | |
61 | # define bindtextdomain(Domainname, Dirname) do {} while (0) | |
252b5132 RH |
62 | # define _(String) (String) |
63 | # define N_(String) (String) | |
64 | #endif | |
65 | ||
66 | /* Look in this environment name for the linker to pretend to be */ | |
67 | #define EMULATION_ENVIRON "LDEMULATION" | |
68 | /* If in there look for the strings: */ | |
69 | ||
70 | /* Look in this variable for a target format */ | |
71 | #define TARGET_ENVIRON "GNUTARGET" | |
72 | ||
73 | /* Input sections which are put in a section of this name are actually | |
74 | discarded. */ | |
75 | #define DISCARD_SECTION_NAME "/DISCARD/" | |
76 | ||
920e4862 NC |
77 | /* A file name list. */ |
78 | typedef struct name_list | |
79 | { | |
89cdebba KH |
80 | const char *name; |
81 | struct name_list *next; | |
82 | } | |
83 | name_list; | |
18625d54 | 84 | |
de7dd2bd | 85 | typedef enum {sort_none, sort_ascending, sort_descending} sort_order; |
4724d37e | 86 | |
bcaa7b3e L |
87 | /* A wildcard specification. */ |
88 | ||
920e4862 NC |
89 | typedef enum |
90 | { | |
02ecc8e9 | 91 | none, by_name, by_alignment, by_name_alignment, by_alignment_name, |
eda680f8 | 92 | by_none, by_init_priority |
bcaa7b3e L |
93 | } sort_type; |
94 | ||
95 | extern sort_type sort_section; | |
252b5132 | 96 | |
920e4862 NC |
97 | struct wildcard_spec |
98 | { | |
252b5132 | 99 | const char *name; |
18625d54 | 100 | struct name_list *exclude_name_list; |
bcaa7b3e | 101 | sort_type sorted; |
ae17ab41 | 102 | struct flag_info *section_flag_list; |
252b5132 RH |
103 | }; |
104 | ||
920e4862 NC |
105 | struct wildcard_list |
106 | { | |
b6bf44ba AM |
107 | struct wildcard_list *next; |
108 | struct wildcard_spec spec; | |
109 | }; | |
110 | ||
252b5132 RH |
111 | #define BYTE_SIZE (1) |
112 | #define SHORT_SIZE (2) | |
113 | #define LONG_SIZE (4) | |
114 | #define QUAD_SIZE (8) | |
115 | ||
1e9cc1c2 NC |
116 | enum endian_enum { ENDIAN_UNSET = 0, ENDIAN_BIG, ENDIAN_LITTLE }; |
117 | ||
920e4862 NC |
118 | typedef struct |
119 | { | |
252b5132 | 120 | /* 1 => assign space to common symbols even if `relocatable_output'. */ |
f38a2680 | 121 | bool force_common_definition; |
4818e05f | 122 | |
b34976b6 | 123 | /* If TRUE, build MIPS embedded PIC relocation tables in the output |
252b5132 | 124 | file. */ |
f38a2680 | 125 | bool embedded_relocs; |
252b5132 | 126 | |
b34976b6 | 127 | /* If TRUE, force generation of a file with a .exe file. */ |
f38a2680 | 128 | bool force_exe_suffix; |
252b5132 | 129 | |
b34976b6 | 130 | /* If TRUE, generate a cross reference report. */ |
f38a2680 | 131 | bool cref; |
252b5132 | 132 | |
b34976b6 | 133 | /* If TRUE (which is the default), warn about mismatched input |
252b5132 | 134 | files. */ |
f38a2680 | 135 | bool warn_mismatch; |
252b5132 | 136 | |
fe7929ce AM |
137 | /* Warn on attempting to open an incompatible library during a library |
138 | search. */ | |
f38a2680 | 139 | bool warn_search_mismatch; |
fe7929ce | 140 | |
02b0b1aa NS |
141 | /* If non-zero check section addresses, once computed, |
142 | for overlaps. Relocatable links only check when this is > 0. */ | |
143 | signed char check_section_addresses; | |
5cc18311 | 144 | |
312b768e NC |
145 | /* If TRUE allow the linking of input files in an unknown architecture |
146 | assuming that the user knows what they are doing. This was the old | |
147 | behaviour of the linker. The new default behaviour is to reject such | |
148 | input files. */ | |
f38a2680 | 149 | bool accept_unknown_input_arch; |
d8cf8b51 | 150 | |
76359541 TP |
151 | /* Name of the import library to generate. */ |
152 | char *out_implib_filename; | |
153 | ||
30824704 | 154 | /* If TRUE we'll just print the default output on stdout. */ |
f38a2680 | 155 | bool print_output_format; |
30824704 | 156 | |
3604cb1f | 157 | /* If set, display the target memory usage (per memory region). */ |
f38a2680 | 158 | bool print_memory_usage; |
3604cb1f | 159 | |
670b1a13 | 160 | /* Should we force section groups to be resolved? Controlled with |
7bdf4127 AB |
161 | --force-group-allocation on the command line or FORCE_GROUP_ALLOCATION |
162 | in the linker script. */ | |
f38a2680 | 163 | bool force_group_allocation; |
7bdf4127 | 164 | |
3b95049e | 165 | /* Big or little endian as set on command line. */ |
1e9cc1c2 | 166 | enum endian_enum endian; |
3b95049e | 167 | |
3b95049e AM |
168 | /* Name of runtime interpreter to invoke. */ |
169 | char *interpreter; | |
170 | ||
370dfff4 | 171 | /* Name to give runtime library from the -soname argument. */ |
3b95049e AM |
172 | char *soname; |
173 | ||
174 | /* Runtime library search path from the -rpath argument. */ | |
175 | char *rpath; | |
176 | ||
177 | /* Link time runtime library search path from the -rpath-link | |
178 | argument. */ | |
179 | char *rpath_link; | |
180 | ||
181 | /* Name of shared object whose symbol table should be filtered with | |
182 | this shared object. From the --filter option. */ | |
183 | char *filter_shlib; | |
184 | ||
185 | /* Name of shared object for whose symbol table this shared object | |
186 | is an auxiliary filter. From the --auxiliary option. */ | |
187 | char **auxiliary_filters; | |
188 | ||
189 | /* A version symbol to be applied to the symbol names found in the | |
190 | .exports sections. */ | |
191 | char *version_exports_section; | |
192 | ||
193 | /* Default linker script. */ | |
194 | char *default_script; | |
252b5132 RH |
195 | } args_type; |
196 | ||
197 | extern args_type command_line; | |
198 | ||
199 | typedef int token_code_type; | |
200 | ||
c005eb9e AB |
201 | /* Different ways we can handle orphan sections. */ |
202 | ||
920e4862 NC |
203 | enum orphan_handling_enum |
204 | { | |
c005eb9e AB |
205 | /* The classic strategy, find a suitable section to place the orphan |
206 | into. */ | |
207 | orphan_handling_place = 0, | |
208 | ||
209 | /* Discard any orphan sections as though they were assign to the section | |
210 | /DISCARD/. */ | |
211 | orphan_handling_discard, | |
212 | ||
213 | /* Find somewhere to place the orphan section, as with | |
214 | ORPHAN_HANDLING_PLACE, but also issue a warning. */ | |
215 | orphan_handling_warn, | |
216 | ||
217 | /* Issue a fatal error if any orphan sections are found. */ | |
218 | orphan_handling_error, | |
219 | }; | |
220 | ||
920e4862 NC |
221 | typedef struct |
222 | { | |
f38a2680 AM |
223 | bool magic_demand_paged; |
224 | bool make_executable; | |
252b5132 | 225 | |
b34976b6 | 226 | /* If TRUE, -shared is supported. */ |
252b5132 RH |
227 | /* ??? A better way to do this is perhaps to define this in the |
228 | ld_emulation_xfer_struct since this is really a target dependent | |
229 | parameter. */ | |
f38a2680 | 230 | bool has_shared; |
252b5132 | 231 | |
b34976b6 | 232 | /* If TRUE, build constructors. */ |
f38a2680 | 233 | bool build_constructors; |
252b5132 | 234 | |
b34976b6 | 235 | /* If TRUE, warn about any constructors. */ |
f38a2680 | 236 | bool warn_constructors; |
252b5132 | 237 | |
b34976b6 | 238 | /* If TRUE, warn about merging common symbols with others. */ |
f38a2680 | 239 | bool warn_common; |
252b5132 | 240 | |
b34976b6 | 241 | /* If TRUE, only warn once about a particular undefined symbol. */ |
f38a2680 | 242 | bool warn_once; |
252b5132 | 243 | |
c005eb9e AB |
244 | /* How should we deal with orphan sections. */ |
245 | enum orphan_handling_enum orphan_handling; | |
3ea60775 | 246 | |
b34976b6 | 247 | /* If TRUE, warn if multiple global-pointers are needed (Alpha |
252b5132 | 248 | only). */ |
f38a2680 | 249 | bool warn_multiple_gp; |
252b5132 | 250 | |
b34976b6 | 251 | /* If TRUE, warn if the starting address of an output section |
252b5132 | 252 | changes due to the alignment of an input section. */ |
f38a2680 | 253 | bool warn_section_align; |
252b5132 | 254 | |
b34976b6 | 255 | /* If TRUE, warning messages are fatal */ |
f38a2680 | 256 | bool fatal_warnings; |
7ce691ae | 257 | |
de7dd2bd | 258 | sort_order sort_common; |
252b5132 | 259 | |
f38a2680 | 260 | bool text_read_only; |
252b5132 | 261 | |
f38a2680 | 262 | bool stats; |
252b5132 | 263 | |
a854a4a7 AM |
264 | /* If set, orphan input sections will be mapped to separate output |
265 | sections. */ | |
f38a2680 | 266 | bool unique_orphan_sections; |
a854a4a7 | 267 | |
3b95049e AM |
268 | /* If set, only search library directories explicitly selected |
269 | on the command line. */ | |
f38a2680 | 270 | bool only_cmd_line_lib_dirs; |
361b220e | 271 | |
01554a74 AM |
272 | /* If set, numbers and absolute symbols are simply treated as |
273 | numbers everywhere. */ | |
f38a2680 | 274 | bool sane_expr; |
01554a74 | 275 | |
4724d37e | 276 | /* If set, code and non-code sections should never be in one segment. */ |
f38a2680 | 277 | bool separate_code; |
4724d37e | 278 | |
c76308d2 RS |
279 | /* The rpath separation character. Usually ':'. */ |
280 | char rpath_separator; | |
281 | ||
3b95049e AM |
282 | char *map_filename; |
283 | FILE *map_file; | |
284 | ||
f37b21b4 RM |
285 | char *dependency_file; |
286 | ||
3b95049e AM |
287 | unsigned int split_by_reloc; |
288 | bfd_size_type split_by_file; | |
289 | ||
2d643429 | 290 | /* The size of the hash table to use. */ |
8ad17b3a | 291 | unsigned long hash_table_size; |
24718e3b | 292 | |
035801ce | 293 | /* If set, print discarded sections in map file output. */ |
f38a2680 | 294 | bool print_map_discarded; |
5dba6f05 NA |
295 | |
296 | /* If set, emit the names and types of statically-linked variables | |
297 | into the CTF. */ | |
f38a2680 | 298 | bool ctf_variables; |
5dba6f05 NA |
299 | |
300 | /* If set, share only duplicated types in CTF, rather than sharing | |
301 | all types that are not in conflict. */ | |
f38a2680 | 302 | bool ctf_share_duplicated; |
252b5132 RH |
303 | } ld_config_type; |
304 | ||
305 | extern ld_config_type config; | |
306 | ||
b9a8de1e | 307 | extern FILE * saved_script_handle; |
f38a2680 | 308 | extern bool force_make_executable; |
252b5132 | 309 | |
1579bae1 AM |
310 | extern int yyparse (void); |
311 | extern void add_cref (const char *, bfd *, asection *, bfd_vma); | |
f38a2680 | 312 | extern bool handle_asneeded_cref (bfd *, enum notice_asneeded_action); |
1579bae1 AM |
313 | extern void output_cref (FILE *); |
314 | extern void check_nocrossrefs (void); | |
315 | extern void ld_abort (const char *, int, const char *) ATTRIBUTE_NORETURN; | |
45455cdd | 316 | |
a1934524 AM |
317 | /* If gcc >= 2.6, we can give a function name, too. */ |
318 | #if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 6) | |
1579bae1 | 319 | #define __PRETTY_FUNCTION__ NULL |
45455cdd ILT |
320 | #endif |
321 | ||
322 | #undef abort | |
323 | #define abort() ld_abort (__FILE__, __LINE__, __PRETTY_FUNCTION__) | |
324 | ||
252b5132 | 325 | #endif |