]>
Commit | Line | Data |
---|---|---|
252b5132 | 1 | /* ld.h -- general linker header file |
fd67aa11 | 2 | Copyright (C) 1991-2024 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 | { | |
85921e9a NC |
99 | const char * name; |
100 | struct name_list * exclude_name_list; | |
101 | struct flag_info * section_flag_list; | |
102 | size_t namelen; | |
103 | size_t prefixlen; | |
104 | size_t suffixlen; | |
105 | sort_type sorted; | |
106 | bool reversed; | |
252b5132 RH |
107 | }; |
108 | ||
920e4862 NC |
109 | struct wildcard_list |
110 | { | |
b6bf44ba AM |
111 | struct wildcard_list *next; |
112 | struct wildcard_spec spec; | |
113 | }; | |
114 | ||
252b5132 RH |
115 | #define BYTE_SIZE (1) |
116 | #define SHORT_SIZE (2) | |
117 | #define LONG_SIZE (4) | |
118 | #define QUAD_SIZE (8) | |
119 | ||
1e9cc1c2 NC |
120 | enum endian_enum { ENDIAN_UNSET = 0, ENDIAN_BIG, ENDIAN_LITTLE }; |
121 | ||
920e4862 NC |
122 | typedef struct |
123 | { | |
252b5132 | 124 | /* 1 => assign space to common symbols even if `relocatable_output'. */ |
f38a2680 | 125 | bool force_common_definition; |
4818e05f | 126 | |
b34976b6 | 127 | /* If TRUE, build MIPS embedded PIC relocation tables in the output |
252b5132 | 128 | file. */ |
f38a2680 | 129 | bool embedded_relocs; |
252b5132 | 130 | |
b34976b6 | 131 | /* If TRUE, force generation of a file with a .exe file. */ |
f38a2680 | 132 | bool force_exe_suffix; |
252b5132 | 133 | |
b34976b6 | 134 | /* If TRUE, generate a cross reference report. */ |
f38a2680 | 135 | bool cref; |
252b5132 | 136 | |
b34976b6 | 137 | /* If TRUE (which is the default), warn about mismatched input |
252b5132 | 138 | files. */ |
f38a2680 | 139 | bool warn_mismatch; |
252b5132 | 140 | |
fe7929ce AM |
141 | /* Warn on attempting to open an incompatible library during a library |
142 | search. */ | |
f38a2680 | 143 | bool warn_search_mismatch; |
fe7929ce | 144 | |
02b0b1aa NS |
145 | /* If non-zero check section addresses, once computed, |
146 | for overlaps. Relocatable links only check when this is > 0. */ | |
147 | signed char check_section_addresses; | |
5cc18311 | 148 | |
312b768e NC |
149 | /* If TRUE allow the linking of input files in an unknown architecture |
150 | assuming that the user knows what they are doing. This was the old | |
151 | behaviour of the linker. The new default behaviour is to reject such | |
152 | input files. */ | |
f38a2680 | 153 | bool accept_unknown_input_arch; |
d8cf8b51 | 154 | |
76359541 TP |
155 | /* Name of the import library to generate. */ |
156 | char *out_implib_filename; | |
157 | ||
30824704 | 158 | /* If TRUE we'll just print the default output on stdout. */ |
f38a2680 | 159 | bool print_output_format; |
30824704 | 160 | |
3604cb1f | 161 | /* If set, display the target memory usage (per memory region). */ |
f38a2680 | 162 | bool print_memory_usage; |
3604cb1f | 163 | |
670b1a13 | 164 | /* Should we force section groups to be resolved? Controlled with |
7bdf4127 AB |
165 | --force-group-allocation on the command line or FORCE_GROUP_ALLOCATION |
166 | in the linker script. */ | |
f38a2680 | 167 | bool force_group_allocation; |
7bdf4127 | 168 | |
3b95049e | 169 | /* Big or little endian as set on command line. */ |
1e9cc1c2 | 170 | enum endian_enum endian; |
3b95049e | 171 | |
3b95049e AM |
172 | /* Name of runtime interpreter to invoke. */ |
173 | char *interpreter; | |
174 | ||
370dfff4 | 175 | /* Name to give runtime library from the -soname argument. */ |
3b95049e AM |
176 | char *soname; |
177 | ||
178 | /* Runtime library search path from the -rpath argument. */ | |
179 | char *rpath; | |
180 | ||
181 | /* Link time runtime library search path from the -rpath-link | |
182 | argument. */ | |
183 | char *rpath_link; | |
184 | ||
185 | /* Name of shared object whose symbol table should be filtered with | |
186 | this shared object. From the --filter option. */ | |
187 | char *filter_shlib; | |
188 | ||
189 | /* Name of shared object for whose symbol table this shared object | |
190 | is an auxiliary filter. From the --auxiliary option. */ | |
191 | char **auxiliary_filters; | |
192 | ||
193 | /* A version symbol to be applied to the symbol names found in the | |
194 | .exports sections. */ | |
195 | char *version_exports_section; | |
196 | ||
197 | /* Default linker script. */ | |
198 | char *default_script; | |
252b5132 RH |
199 | } args_type; |
200 | ||
201 | extern args_type command_line; | |
202 | ||
203 | typedef int token_code_type; | |
204 | ||
c005eb9e AB |
205 | /* Different ways we can handle orphan sections. */ |
206 | ||
920e4862 NC |
207 | enum orphan_handling_enum |
208 | { | |
c005eb9e AB |
209 | /* The classic strategy, find a suitable section to place the orphan |
210 | into. */ | |
211 | orphan_handling_place = 0, | |
212 | ||
213 | /* Discard any orphan sections as though they were assign to the section | |
214 | /DISCARD/. */ | |
215 | orphan_handling_discard, | |
216 | ||
217 | /* Find somewhere to place the orphan section, as with | |
218 | ORPHAN_HANDLING_PLACE, but also issue a warning. */ | |
219 | orphan_handling_warn, | |
220 | ||
221 | /* Issue a fatal error if any orphan sections are found. */ | |
222 | orphan_handling_error, | |
223 | }; | |
224 | ||
920e4862 NC |
225 | typedef struct |
226 | { | |
f38a2680 AM |
227 | bool magic_demand_paged; |
228 | bool make_executable; | |
252b5132 | 229 | |
b34976b6 | 230 | /* If TRUE, -shared is supported. */ |
252b5132 RH |
231 | /* ??? A better way to do this is perhaps to define this in the |
232 | ld_emulation_xfer_struct since this is really a target dependent | |
233 | parameter. */ | |
f38a2680 | 234 | bool has_shared; |
252b5132 | 235 | |
b34976b6 | 236 | /* If TRUE, build constructors. */ |
f38a2680 | 237 | bool build_constructors; |
252b5132 | 238 | |
b34976b6 | 239 | /* If TRUE, warn about any constructors. */ |
f38a2680 | 240 | bool warn_constructors; |
252b5132 | 241 | |
b34976b6 | 242 | /* If TRUE, warn about merging common symbols with others. */ |
f38a2680 | 243 | bool warn_common; |
252b5132 | 244 | |
b34976b6 | 245 | /* If TRUE, only warn once about a particular undefined symbol. */ |
f38a2680 | 246 | bool warn_once; |
252b5132 | 247 | |
c005eb9e AB |
248 | /* How should we deal with orphan sections. */ |
249 | enum orphan_handling_enum orphan_handling; | |
3ea60775 | 250 | |
b34976b6 | 251 | /* If TRUE, warn if multiple global-pointers are needed (Alpha |
252b5132 | 252 | only). */ |
f38a2680 | 253 | bool warn_multiple_gp; |
252b5132 | 254 | |
b34976b6 | 255 | /* If TRUE, warn if the starting address of an output section |
252b5132 | 256 | changes due to the alignment of an input section. */ |
f38a2680 | 257 | bool warn_section_align; |
252b5132 | 258 | |
4b2e7a57 | 259 | /* If TRUE, warning messages are fatal. */ |
f38a2680 | 260 | bool fatal_warnings; |
7ce691ae | 261 | |
4b2e7a57 NC |
262 | /* If TRUE, warning and error messages are ignored. */ |
263 | bool no_warnings; | |
264 | ||
de7dd2bd | 265 | sort_order sort_common; |
252b5132 | 266 | |
f38a2680 | 267 | bool text_read_only; |
252b5132 | 268 | |
f38a2680 | 269 | bool stats; |
252b5132 | 270 | |
a854a4a7 AM |
271 | /* If set, orphan input sections will be mapped to separate output |
272 | sections. */ | |
f38a2680 | 273 | bool unique_orphan_sections; |
a854a4a7 | 274 | |
3b95049e AM |
275 | /* If set, only search library directories explicitly selected |
276 | on the command line. */ | |
f38a2680 | 277 | bool only_cmd_line_lib_dirs; |
361b220e | 278 | |
01554a74 AM |
279 | /* If set, numbers and absolute symbols are simply treated as |
280 | numbers everywhere. */ | |
f38a2680 | 281 | bool sane_expr; |
01554a74 | 282 | |
4724d37e | 283 | /* If set, code and non-code sections should never be in one segment. */ |
f38a2680 | 284 | bool separate_code; |
4724d37e | 285 | |
96cc7918 KB |
286 | /* If set, generation of ELF section header should be suppressed. */ |
287 | bool no_section_header; | |
288 | ||
c76308d2 RS |
289 | /* The rpath separation character. Usually ':'. */ |
290 | char rpath_separator; | |
291 | ||
3b95049e AM |
292 | char *map_filename; |
293 | FILE *map_file; | |
294 | ||
f37b21b4 RM |
295 | char *dependency_file; |
296 | ||
3b95049e AM |
297 | unsigned int split_by_reloc; |
298 | bfd_size_type split_by_file; | |
299 | ||
2d643429 | 300 | /* The size of the hash table to use. */ |
8ad17b3a | 301 | unsigned long hash_table_size; |
24718e3b | 302 | |
035801ce | 303 | /* If set, print discarded sections in map file output. */ |
f38a2680 | 304 | bool print_map_discarded; |
5dba6f05 | 305 | |
496917ce NC |
306 | /* If set, print local symbols in map file output. */ |
307 | bool print_map_locals; | |
308 | ||
5dba6f05 NA |
309 | /* If set, emit the names and types of statically-linked variables |
310 | into the CTF. */ | |
f38a2680 | 311 | bool ctf_variables; |
5dba6f05 NA |
312 | |
313 | /* If set, share only duplicated types in CTF, rather than sharing | |
314 | all types that are not in conflict. */ | |
f38a2680 | 315 | bool ctf_share_duplicated; |
c3620d6d AM |
316 | |
317 | /* Compress DWARF debug sections. */ | |
318 | enum compressed_debug_section_type compress_debug; | |
252b5132 RH |
319 | } ld_config_type; |
320 | ||
321 | extern ld_config_type config; | |
322 | ||
b9a8de1e | 323 | extern FILE * saved_script_handle; |
f38a2680 | 324 | extern bool force_make_executable; |
252b5132 | 325 | |
1579bae1 AM |
326 | extern int yyparse (void); |
327 | extern void add_cref (const char *, bfd *, asection *, bfd_vma); | |
f38a2680 | 328 | extern bool handle_asneeded_cref (bfd *, enum notice_asneeded_action); |
1579bae1 AM |
329 | extern void output_cref (FILE *); |
330 | extern void check_nocrossrefs (void); | |
331 | extern void ld_abort (const char *, int, const char *) ATTRIBUTE_NORETURN; | |
45455cdd | 332 | |
a1934524 AM |
333 | /* If gcc >= 2.6, we can give a function name, too. */ |
334 | #if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 6) | |
1579bae1 | 335 | #define __PRETTY_FUNCTION__ NULL |
45455cdd ILT |
336 | #endif |
337 | ||
338 | #undef abort | |
339 | #define abort() ld_abort (__FILE__, __LINE__, __PRETTY_FUNCTION__) | |
340 | ||
252b5132 | 341 | #endif |