1 /* ldlang.h - linker command language support
2 Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
3 2001, 2002, 2003, 2004, 2005
4 Free Software Foundation, Inc.
6 This file is part of GLD, the Gnu Linker.
8 GLD is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2, or (at your option)
13 GLD is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GLD; see the file COPYING. If not, write to the Free
20 Software Foundation, 51 Franklin Street - Fifth Floor, Boston, MA
26 #define DEFAULT_MEMORY_REGION "*default*"
30 lang_input_file_is_l_enum,
31 lang_input_file_is_symbols_only_enum,
32 lang_input_file_is_marker_enum,
33 lang_input_file_is_fake_enum,
34 lang_input_file_is_search_file_enum,
35 lang_input_file_is_file_enum
36 } lang_input_file_enum_type;
41 unsigned char data[1];
44 typedef struct statement_list
46 union lang_statement_union *head;
47 union lang_statement_union **tail;
48 } lang_statement_list_type;
50 typedef struct memory_region_struct
53 struct memory_region_struct *next;
57 bfd_size_type old_length;
60 bfd_boolean had_full_message;
61 } lang_memory_region_type;
63 typedef struct lang_statement_header_struct
65 union lang_statement_union *next;
68 lang_output_section_statement_enum,
69 lang_assignment_statement_enum,
70 lang_input_statement_enum,
71 lang_address_statement_enum,
72 lang_wild_statement_enum,
73 lang_input_section_enum,
74 lang_object_symbols_statement_enum,
75 lang_fill_statement_enum,
76 lang_data_statement_enum,
77 lang_reloc_statement_enum,
78 lang_target_statement_enum,
79 lang_output_statement_enum,
80 lang_padding_statement_enum,
81 lang_group_statement_enum,
83 lang_afile_asection_pair_statement_enum,
84 lang_constructors_statement_enum
86 } lang_statement_header_type;
90 lang_statement_header_type header;
91 union etree_union *exp;
92 } lang_assignment_statement_type;
94 typedef struct lang_target_statement_struct
96 lang_statement_header_type header;
98 } lang_target_statement_type;
100 typedef struct lang_output_statement_struct
102 lang_statement_header_type header;
104 } lang_output_statement_type;
106 /* Section types specified in a linker script. */
118 /* This structure holds a list of program headers describing
119 segments in which this section should be placed. */
121 typedef struct lang_output_section_phdr_list
123 struct lang_output_section_phdr_list *next;
126 } lang_output_section_phdr_list;
128 typedef struct lang_output_section_statement_struct
130 lang_statement_header_type header;
131 union etree_union *addr_tree;
132 lang_statement_list_type children;
134 struct lang_output_section_statement_struct *next;
137 bfd_boolean processed;
139 asection *bfd_section;
140 flagword flags; /* Or together of all input sections. */
141 enum section_type sectype;
142 lang_memory_region_type *region;
143 lang_memory_region_type *lma_region;
147 int subsection_alignment; /* Alignment of components. */
148 int section_alignment; /* Alignment of start of section. */
150 unsigned int all_input_readonly : 1;
151 unsigned int ignored : 1;
153 union etree_union *load_base;
155 /* If non-null, an expression to evaluate after setting the section's
156 size. The expression is evaluated inside REGION (above) with '.'
157 set to the end of the section. Used in the last overlay section
158 to move '.' past all the overlaid sections. */
159 union etree_union *update_dot_tree;
161 lang_output_section_phdr_list *phdrs;
162 } lang_output_section_statement_type;
166 lang_statement_header_type header;
167 } lang_common_statement_type;
171 lang_statement_header_type header;
172 } lang_object_symbols_statement_type;
176 lang_statement_header_type header;
179 asection *output_section;
180 } lang_fill_statement_type;
184 lang_statement_header_type header;
186 union etree_union *exp;
188 asection *output_section;
190 } lang_data_statement_type;
192 /* Generate a reloc in the output file. */
196 lang_statement_header_type header;
198 /* Reloc to generate. */
199 bfd_reloc_code_real_type reloc;
201 /* Reloc howto structure. */
202 reloc_howto_type *howto;
204 /* Section to generate reloc against.
205 Exactly one of section and name must be NULL. */
208 /* Name of symbol to generate reloc against.
209 Exactly one of section and name must be NULL. */
212 /* Expression for addend. */
213 union etree_union *addend_exp;
215 /* Resolved addend. */
216 bfd_vma addend_value;
218 /* Output section where reloc should be performed. */
219 asection *output_section;
221 /* VMA within output section. */
223 } lang_reloc_statement_type;
225 typedef struct lang_input_statement_struct
227 lang_statement_header_type header;
228 /* Name of this file. */
229 const char *filename;
230 /* Name to use for the symbol giving address of text start.
231 Usually the same as filename, but for a file spec'd with
232 -l this is the -l switch itself rather than the filename. */
233 const char *local_sym_name;
238 file_ptr passive_position;
240 /* Symbol table of the file. */
242 unsigned int symbol_count;
244 /* Point to the next file - whatever it is, wanders up and down
246 union lang_statement_union *next;
248 /* Point to the next file, but skips archive contents. */
249 union lang_statement_union *next_real_file;
251 bfd_boolean is_archive;
253 /* 1 means search a set of directories for this file. */
254 bfd_boolean search_dirs_flag;
256 /* 1 means this was found in a search directory marked as sysrooted,
257 if search_dirs_flag is false, otherwise, that it should be
258 searched in ld_sysroot before any other location, as long as it
259 starts with a slash. */
260 bfd_boolean sysrooted;
262 /* 1 means this is base file of incremental load.
263 Do not load this file's text or data.
264 Also default text_start to after this file's bss. */
265 bfd_boolean just_syms_flag;
267 /* Whether to search for this entry as a dynamic archive. */
270 /* Whether DT_NEEDED tags should be added for dynamic libraries in
271 DT_NEEDED tags from this entry. */
272 bfd_boolean add_needed;
274 /* Whether this entry should cause a DT_NEEDED tag only when
275 satisfying references from regular files, or always. */
276 bfd_boolean as_needed;
278 /* Whether to include the entire contents of an archive. */
279 bfd_boolean whole_archive;
285 } lang_input_statement_type;
289 lang_statement_header_type header;
291 lang_input_statement_type *ifile;
293 } lang_input_section_type;
297 lang_statement_header_type header;
299 union lang_statement_union *file;
300 } lang_afile_asection_pair_statement_type;
302 typedef struct lang_wild_statement_struct lang_wild_statement_type;
304 typedef void (*callback_t) (lang_wild_statement_type *, struct wildcard_list *,
305 asection *, lang_input_statement_type *, void *);
307 typedef void (*walk_wild_section_handler_t) (lang_wild_statement_type *,
308 lang_input_statement_type *,
312 struct lang_wild_statement_struct
314 lang_statement_header_type header;
315 const char *filename;
316 bfd_boolean filenames_sorted;
317 struct wildcard_list *section_list;
318 bfd_boolean keep_sections;
319 lang_statement_list_type children;
321 walk_wild_section_handler_t walk_wild_section_handler;
322 struct wildcard_list *handler_data[4];
325 typedef struct lang_address_statement_struct
327 lang_statement_header_type header;
328 const char *section_name;
329 union etree_union *address;
330 const segment_type *segment;
331 } lang_address_statement_type;
335 lang_statement_header_type header;
336 bfd_vma output_offset;
338 asection *output_section;
340 } lang_padding_statement_type;
342 /* A group statement collects a set of libraries together. The
343 libraries are searched multiple times, until no new undefined
344 symbols are found. The effect is to search a group of libraries as
345 though they were a single library. */
349 lang_statement_header_type header;
350 lang_statement_list_type children;
351 } lang_group_statement_type;
353 typedef union lang_statement_union
355 lang_statement_header_type header;
356 lang_wild_statement_type wild_statement;
357 lang_data_statement_type data_statement;
358 lang_reloc_statement_type reloc_statement;
359 lang_address_statement_type address_statement;
360 lang_output_section_statement_type output_section_statement;
361 lang_afile_asection_pair_statement_type afile_asection_pair_statement;
362 lang_assignment_statement_type assignment_statement;
363 lang_input_statement_type input_statement;
364 lang_target_statement_type target_statement;
365 lang_output_statement_type output_statement;
366 lang_input_section_type input_section;
367 lang_common_statement_type common_statement;
368 lang_object_symbols_statement_type object_symbols_statement;
369 lang_fill_statement_type fill_statement;
370 lang_padding_statement_type padding_statement;
371 lang_group_statement_type group_statement;
372 } lang_statement_union_type;
374 /* This structure holds information about a program header, from the
375 PHDRS command in the linker script. */
379 struct lang_phdr *next;
388 /* This structure is used to hold a list of sections which may not
389 cross reference each other. */
391 typedef struct lang_nocrossref
393 struct lang_nocrossref *next;
395 } lang_nocrossref_type;
397 /* The list of nocrossref lists. */
399 struct lang_nocrossrefs
401 struct lang_nocrossrefs *next;
402 lang_nocrossref_type *list;
405 extern struct lang_nocrossrefs *nocrossref_list;
407 /* This structure is used to hold a list of input section names which
408 will not match an output section in the linker script. */
410 struct unique_sections
412 struct unique_sections *next;
416 /* This structure records symbols for which we need to keep track of
417 definedness for use in the DEFINED () test. */
419 struct lang_definedness_hash_entry
421 struct bfd_hash_entry root;
425 /* Used by place_orphan to keep track of orphan sections and statements. */
430 lang_output_section_statement_type *os;
432 lang_statement_union_type **stmt;
433 lang_output_section_statement_type **os_tail;
436 extern lang_output_section_statement_type *abs_output_section;
437 extern lang_statement_list_type lang_output_section_statement;
438 extern bfd_boolean lang_has_input_file;
439 extern etree_type *base;
440 extern lang_statement_list_type *stat_ptr;
441 extern bfd_boolean delete_output_file_on_failure;
443 extern struct bfd_sym_chain entry_symbol;
444 extern const char *entry_section;
445 extern bfd_boolean entry_from_cmdline;
446 extern lang_statement_list_type file_chain;
448 extern int lang_statement_iteration;
450 extern void lang_init
452 extern void lang_finish
454 extern lang_memory_region_type *lang_memory_region_lookup
455 (const char *const, bfd_boolean);
456 extern lang_memory_region_type *lang_memory_region_default
460 extern void lang_set_flags
461 (lang_memory_region_type *, const char *, int);
462 extern void lang_add_output
463 (const char *, int from_script);
464 extern lang_output_section_statement_type *lang_enter_output_section_statement
465 (const char *output_section_statement_name,
466 etree_type *address_exp,
467 enum section_type sectype,
469 etree_type *subalign,
471 extern void lang_final
473 extern void lang_process
475 extern void lang_section_start
476 (const char *, union etree_union *, const segment_type *);
477 extern void lang_add_entry
478 (const char *, bfd_boolean);
479 extern void lang_default_entry
481 extern void lang_add_target
483 extern void lang_add_wild
484 (struct wildcard_spec *, struct wildcard_list *, bfd_boolean);
485 extern void lang_add_map
487 extern void lang_add_fill
489 extern lang_assignment_statement_type *lang_add_assignment
490 (union etree_union *);
491 extern void lang_add_attribute
492 (enum statement_enum);
493 extern void lang_startup
495 extern void lang_float
497 extern void lang_leave_output_section_statement
498 (fill_type *, const char *, lang_output_section_phdr_list *,
500 extern void lang_abs_symbol_at_end_of
501 (const char *, const char *);
502 extern void lang_abs_symbol_at_beginning_of
503 (const char *, const char *);
504 extern void lang_statement_append
505 (lang_statement_list_type *, lang_statement_union_type *,
506 lang_statement_union_type **);
507 extern void lang_for_each_input_file
508 (void (*dothis) (lang_input_statement_type *));
509 extern void lang_for_each_file
510 (void (*dothis) (lang_input_statement_type *));
511 extern void lang_reset_memory_regions
513 extern void lang_do_assignments
516 #define LANG_FOR_EACH_INPUT_STATEMENT(statement) \
517 lang_input_statement_type *statement; \
518 for (statement = (lang_input_statement_type *) file_chain.head; \
519 statement != (lang_input_statement_type *) NULL; \
520 statement = (lang_input_statement_type *) statement->next) \
522 extern void lang_process
524 extern void ldlang_add_file
525 (lang_input_statement_type *);
526 extern lang_output_section_statement_type *lang_output_section_find
527 (const char * const);
528 extern lang_output_section_statement_type *lang_output_section_find_by_flags
529 (const asection *, lang_output_section_statement_type **exact);
530 extern lang_output_section_statement_type *lang_insert_orphan
531 (lang_input_statement_type *, asection *, const char *,
532 lang_output_section_statement_type *, struct orphan_save *,
533 etree_type *, lang_statement_list_type *);
534 extern lang_input_statement_type *lang_add_input_file
535 (const char *, lang_input_file_enum_type, const char *);
536 extern void lang_add_keepsyms_file
538 extern lang_output_section_statement_type *
539 lang_output_section_statement_lookup
541 extern void ldlang_add_undef
543 extern void lang_add_output_format
544 (const char *, const char *, const char *, int);
545 extern void lang_list_init
546 (lang_statement_list_type *);
547 extern void lang_add_data
548 (int type, union etree_union *);
549 extern void lang_add_reloc
550 (bfd_reloc_code_real_type, reloc_howto_type *, asection *, const char *,
551 union etree_union *);
552 extern void lang_for_each_statement
553 (void (*) (lang_statement_union_type *));
554 extern void *stat_alloc
556 extern void strip_excluded_output_sections
558 extern void dprint_statement
559 (lang_statement_union_type *, int);
560 extern void lang_size_sections
561 (bfd_boolean *, bfd_boolean);
562 extern void one_lang_size_sections_pass
563 (bfd_boolean *, bfd_boolean);
564 extern void lang_enter_group
566 extern void lang_leave_group
568 extern void lang_add_section
569 (lang_statement_list_type *, asection *,
570 lang_output_section_statement_type *, lang_input_statement_type *);
571 extern void lang_new_phdr
572 (const char *, etree_type *, bfd_boolean, bfd_boolean, etree_type *,
574 extern void lang_add_nocrossref
575 (lang_nocrossref_type *);
576 extern void lang_enter_overlay
577 (etree_type *, etree_type *);
578 extern void lang_enter_overlay_section
580 extern void lang_leave_overlay_section
581 (fill_type *, lang_output_section_phdr_list *);
582 extern void lang_leave_overlay
583 (etree_type *, int, fill_type *, const char *,
584 lang_output_section_phdr_list *, const char *);
586 extern struct bfd_elf_version_tree *lang_elf_version_info;
588 extern struct bfd_elf_version_expr *lang_new_vers_pattern
589 (struct bfd_elf_version_expr *, const char *, const char *);
590 extern struct bfd_elf_version_tree *lang_new_vers_node
591 (struct bfd_elf_version_expr *, struct bfd_elf_version_expr *);
592 extern struct bfd_elf_version_deps *lang_add_vers_depend
593 (struct bfd_elf_version_deps *, const char *);
594 extern void lang_register_vers_node
595 (const char *, struct bfd_elf_version_tree *, struct bfd_elf_version_deps *);
596 bfd_boolean unique_section_p
598 extern void lang_add_unique
600 extern const char *lang_get_output_target
602 extern void lang_track_definedness (const char *);
603 extern int lang_symbol_definition_iteration (const char *);
604 extern void lang_update_definedness
605 (const char *, struct bfd_link_hash_entry *);
607 extern void add_excluded_libs (const char *);