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