1 /* ldlang.h - linker command language support
2 Copyright 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000
3 Free Software Foundation, Inc.
5 This file is part of GLD, the Gnu Linker.
7 GLD is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 1, or (at your option)
12 GLD 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.
17 You should have received a copy of the GNU General Public License
18 along with GLD; see the file COPYING. If not, write to the Free
19 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
27 lang_input_file_is_l_enum,
28 lang_input_file_is_symbols_only_enum,
29 lang_input_file_is_marker_enum,
30 lang_input_file_is_fake_enum,
31 lang_input_file_is_search_file_enum,
32 lang_input_file_is_file_enum
33 } lang_input_file_enum_type;
35 typedef unsigned int fill_type;
36 typedef struct statement_list
38 union lang_statement_union *head;
39 union lang_statement_union **tail;
40 } lang_statement_list_type;
42 typedef struct memory_region_struct
45 struct memory_region_struct *next;
49 bfd_size_type old_length;
52 boolean had_full_message;
53 } lang_memory_region_type ;
55 typedef struct lang_statement_header_struct
57 union lang_statement_union *next;
60 lang_output_section_statement_enum,
61 lang_assignment_statement_enum,
62 lang_input_statement_enum,
63 lang_address_statement_enum,
64 lang_wild_statement_enum,
65 lang_input_section_enum,
66 lang_object_symbols_statement_enum,
67 lang_fill_statement_enum,
68 lang_data_statement_enum,
69 lang_reloc_statement_enum,
70 lang_target_statement_enum,
71 lang_output_statement_enum,
72 lang_padding_statement_enum,
73 lang_group_statement_enum,
75 lang_afile_asection_pair_statement_enum,
76 lang_constructors_statement_enum
78 } lang_statement_header_type;
82 lang_statement_header_type header;
83 union etree_union *exp;
84 } lang_assignment_statement_type;
86 typedef struct lang_target_statement_struct
88 lang_statement_header_type header;
90 } lang_target_statement_type;
92 typedef struct lang_output_statement_struct
94 lang_statement_header_type header;
96 } lang_output_statement_type;
98 /* Section types specified in a linker script. */
110 /* This structure holds a list of program headers describing segments
111 in which this section should be placed. */
113 struct lang_output_section_phdr_list
115 struct lang_output_section_phdr_list *next;
120 typedef struct lang_output_section_statement_struct
122 lang_statement_header_type header;
123 union etree_union *addr_tree;
124 lang_statement_list_type children;
126 union lang_statement_union *next;
131 asection *bfd_section;
132 flagword flags; /* Or together of all input sections */
133 enum section_type sectype;
134 struct memory_region_struct *region;
135 struct memory_region_struct *lma_region;
139 int subsection_alignment; /* alignment of components */
140 int section_alignment; /* alignment of start of section */
142 union etree_union *load_base;
144 struct lang_output_section_phdr_list *phdrs;
145 } lang_output_section_statement_type;
149 lang_statement_header_type header;
150 } lang_common_statement_type;
154 lang_statement_header_type header;
155 } lang_object_symbols_statement_type;
159 lang_statement_header_type header;
162 asection *output_section;
163 } lang_fill_statement_type;
167 lang_statement_header_type header;
169 union etree_union *exp;
171 asection *output_section;
173 } lang_data_statement_type;
175 /* Generate a reloc in the output file. */
179 lang_statement_header_type header;
181 /* Reloc to generate. */
182 bfd_reloc_code_real_type reloc;
184 /* Reloc howto structure. */
185 reloc_howto_type *howto;
187 /* Section to generate reloc against. Exactly one of section and
188 name must be NULL. */
191 /* Name of symbol to generate reloc against. Exactly one of section
192 and name must be NULL. */
195 /* Expression for addend. */
196 union etree_union *addend_exp;
198 /* Resolved addend. */
199 bfd_vma addend_value;
201 /* Output section where reloc should be performed. */
202 asection *output_section;
204 /* VMA within output section. */
206 } lang_reloc_statement_type;
208 typedef struct lang_input_statement_struct
210 lang_statement_header_type header;
211 /* Name of this file. */
212 const char *filename;
213 /* Name to use for the symbol giving address of text start */
214 /* Usually the same as filename, but for a file spec'd with -l
215 this is the -l switch itself rather than the filename. */
216 const char *local_sym_name;
221 file_ptr passive_position;
223 /* Symbol table of the file. */
225 unsigned int symbol_count;
227 /* Point to the next file - whatever it is, wanders up and down
230 union lang_statement_union *next;
231 /* Point to the next file, but skips archive contents */
232 union lang_statement_union *next_real_file;
236 /* 1 means search a set of directories for this file. */
237 boolean search_dirs_flag;
239 /* 1 means this is base file of incremental load.
240 Do not load this file's text or data.
241 Also default text_start to after this file's bss. */
243 boolean just_syms_flag;
245 /* Whether to search for this entry as a dynamic archive. */
248 /* Whether to include the entire contents of an archive. */
249 boolean whole_archive;
253 /* unsigned int globals_in_this_file;*/
256 } lang_input_statement_type;
260 lang_statement_header_type header;
262 lang_input_statement_type *ifile;
264 } lang_input_section_type;
268 lang_statement_header_type header;
270 union lang_statement_union *file;
271 } lang_afile_asection_pair_statement_type;
273 typedef struct lang_wild_statement_struct
275 lang_statement_header_type header;
276 const char *section_name;
277 boolean sections_sorted;
278 const char *filename;
279 boolean filenames_sorted;
280 boolean keep_sections;
281 struct name_list *exclude_filename_list;
282 lang_statement_list_type children;
283 } lang_wild_statement_type;
285 typedef struct lang_address_statement_struct
287 lang_statement_header_type header;
288 const char *section_name;
289 union etree_union *address;
290 } lang_address_statement_type;
294 lang_statement_header_type header;
295 bfd_vma output_offset;
297 asection *output_section;
299 } lang_padding_statement_type;
301 /* A group statement collects a set of libraries together. The
302 libraries are searched multiple times, until no new undefined
303 symbols are found. The effect is to search a group of libraries as
304 though they were a single library. */
308 lang_statement_header_type header;
309 lang_statement_list_type children;
310 } lang_group_statement_type;
312 typedef union lang_statement_union
314 lang_statement_header_type header;
315 union lang_statement_union *next;
316 lang_wild_statement_type wild_statement;
317 lang_data_statement_type data_statement;
318 lang_reloc_statement_type reloc_statement;
319 lang_address_statement_type address_statement;
320 lang_output_section_statement_type output_section_statement;
321 lang_afile_asection_pair_statement_type afile_asection_pair_statement;
322 lang_assignment_statement_type assignment_statement;
323 lang_input_statement_type input_statement;
324 lang_target_statement_type target_statement;
325 lang_output_statement_type output_statement;
326 lang_input_section_type input_section;
327 lang_common_statement_type common_statement;
328 lang_object_symbols_statement_type object_symbols_statement;
329 lang_fill_statement_type fill_statement;
330 lang_padding_statement_type padding_statement;
331 lang_group_statement_type group_statement;
332 } lang_statement_union_type;
334 /* This structure holds information about a program header, from the
335 PHDRS command in the linker script. */
339 struct lang_phdr *next;
348 /* This structure is used to hold a list of sections which may not
349 cross reference each other. */
351 struct lang_nocrossref
353 struct lang_nocrossref *next;
357 /* The list of nocrossref lists. */
359 struct lang_nocrossrefs
361 struct lang_nocrossrefs *next;
362 struct lang_nocrossref *list;
365 extern struct lang_nocrossrefs *nocrossref_list;
367 extern lang_output_section_statement_type *abs_output_section;
368 extern lang_statement_list_type lang_output_section_statement;
369 extern boolean lang_has_input_file;
370 extern etree_type *base;
371 extern lang_statement_list_type *stat_ptr;
372 extern boolean delete_output_file_on_failure;
374 extern const char *entry_symbol;
375 extern boolean entry_from_cmdline;
376 extern lang_statement_list_type file_chain;
378 extern void lang_init PARAMS ((void));
379 extern struct memory_region_struct *lang_memory_region_lookup
380 PARAMS ((const char *const));
381 extern struct memory_region_struct *lang_memory_region_default
382 PARAMS ((asection *));
383 extern void lang_map PARAMS ((void));
384 extern void lang_set_flags PARAMS ((lang_memory_region_type *, const char *,
386 extern void lang_add_output PARAMS ((const char *, int from_script));
387 extern lang_output_section_statement_type *lang_enter_output_section_statement
388 PARAMS ((const char *output_section_statement_name,
389 etree_type * address_exp,
390 enum section_type sectype,
393 etree_type *subalign,
395 extern void lang_final PARAMS ((void));
396 extern void lang_process PARAMS ((void));
397 extern void lang_section_start PARAMS ((const char *, union etree_union *));
398 extern void lang_add_entry PARAMS ((const char *, boolean));
399 extern void lang_add_target PARAMS ((const char *));
400 extern void lang_add_wild
401 PARAMS ((const char *, boolean, const char *, boolean, boolean, name_list *));
402 extern void lang_add_map PARAMS ((const char *));
403 extern void lang_add_fill PARAMS ((int));
404 extern lang_assignment_statement_type * lang_add_assignment PARAMS ((union etree_union *));
405 extern void lang_add_attribute PARAMS ((enum statement_enum));
406 extern void lang_startup PARAMS ((const char *));
407 extern void lang_float PARAMS ((enum bfd_boolean));
408 extern void lang_leave_output_section_statement
409 PARAMS ((bfd_vma, const char *, struct lang_output_section_phdr_list *,
411 extern void lang_abs_symbol_at_end_of PARAMS ((const char *, const char *));
412 extern void lang_abs_symbol_at_beginning_of PARAMS ((const char *,
414 extern void lang_statement_append PARAMS ((struct statement_list *,
415 union lang_statement_union *,
416 union lang_statement_union **));
417 extern void lang_for_each_input_file
418 PARAMS ((void (*dothis) (lang_input_statement_type *)));
419 extern void lang_for_each_file
420 PARAMS ((void (*dothis) (lang_input_statement_type *)));
421 extern bfd_vma lang_do_assignments
422 PARAMS ((lang_statement_union_type * s,
423 lang_output_section_statement_type *output_section_statement,
427 #define LANG_FOR_EACH_INPUT_STATEMENT(statement) \
428 lang_input_statement_type *statement; \
429 for (statement = (lang_input_statement_type *)file_chain.head;\
430 statement != (lang_input_statement_type *)NULL; \
431 statement = (lang_input_statement_type *)statement->next)\
433 extern void lang_process PARAMS ((void));
434 extern void ldlang_add_file PARAMS ((lang_input_statement_type *));
435 extern lang_output_section_statement_type *lang_output_section_find
436 PARAMS ((const char * const));
437 extern lang_input_statement_type *lang_add_input_file
438 PARAMS ((const char *name, lang_input_file_enum_type file_type,
439 const char *target));
440 extern void lang_add_keepsyms_file PARAMS ((const char *filename));
441 extern lang_output_section_statement_type *
442 lang_output_section_statement_lookup PARAMS ((const char * const name));
443 extern void ldlang_add_undef PARAMS ((const char *const name));
444 extern void lang_add_output_format PARAMS ((const char *, const char *,
445 const char *, int from_script));
446 extern void lang_list_init PARAMS ((lang_statement_list_type*));
447 extern void lang_add_data PARAMS ((int type, union etree_union *));
448 extern void lang_add_reloc
449 PARAMS ((bfd_reloc_code_real_type reloc, reloc_howto_type *howto,
450 asection *section, const char *name, union etree_union *addend));
451 extern void lang_for_each_statement
452 PARAMS ((void (*func) (lang_statement_union_type *)));
453 extern PTR stat_alloc PARAMS ((size_t size));
454 extern void dprint_statement PARAMS ((lang_statement_union_type *, int));
455 extern bfd_vma lang_size_sections
456 PARAMS ((lang_statement_union_type *s,
457 lang_output_section_statement_type *output_section_statement,
458 lang_statement_union_type **prev, fill_type fill,
459 bfd_vma dot, boolean relax));
460 extern void lang_enter_group PARAMS ((void));
461 extern void lang_leave_group PARAMS ((void));
462 extern void wild_doit
463 PARAMS ((lang_statement_list_type *ptr, asection *section,
464 lang_output_section_statement_type *output,
465 lang_input_statement_type *file));
466 extern void lang_new_phdr
467 PARAMS ((const char *, etree_type *, boolean, boolean, etree_type *,
469 extern void lang_add_nocrossref PARAMS ((struct lang_nocrossref *));
470 extern void lang_enter_overlay PARAMS ((etree_type *, etree_type *, int));
471 extern void lang_enter_overlay_section PARAMS ((const char *));
472 extern void lang_leave_overlay_section
473 PARAMS ((bfd_vma, struct lang_output_section_phdr_list *));
474 extern void lang_leave_overlay
475 PARAMS ((bfd_vma, const char *, struct lang_output_section_phdr_list *,
478 extern struct bfd_elf_version_tree *lang_elf_version_info;
480 extern struct bfd_elf_version_expr *lang_new_vers_regex
481 PARAMS ((struct bfd_elf_version_expr *, const char *, const char *));
482 extern struct bfd_elf_version_tree *lang_new_vers_node
483 PARAMS ((struct bfd_elf_version_expr *, struct bfd_elf_version_expr *));
484 extern struct bfd_elf_version_deps *lang_add_vers_depend
485 PARAMS ((struct bfd_elf_version_deps *, const char *));
486 extern void lang_register_vers_node
487 PARAMS ((const char *, struct bfd_elf_version_tree *,
488 struct bfd_elf_version_deps *));