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;
43 typedef struct memory_region_struct
46 struct memory_region_struct *next;
50 bfd_size_type old_length;
53 boolean had_full_message;
54 } lang_memory_region_type ;
56 typedef struct lang_statement_header_struct
58 union lang_statement_union *next;
61 lang_output_section_statement_enum,
62 lang_assignment_statement_enum,
63 lang_input_statement_enum,
64 lang_address_statement_enum,
65 lang_wild_statement_enum,
66 lang_input_section_enum,
67 lang_object_symbols_statement_enum,
68 lang_fill_statement_enum,
69 lang_data_statement_enum,
70 lang_reloc_statement_enum,
71 lang_target_statement_enum,
72 lang_output_statement_enum,
73 lang_padding_statement_enum,
74 lang_group_statement_enum,
76 lang_afile_asection_pair_statement_enum,
77 lang_constructors_statement_enum
79 } lang_statement_header_type;
84 lang_statement_header_type header;
85 union etree_union *exp;
86 } lang_assignment_statement_type;
89 typedef struct lang_target_statement_struct
91 lang_statement_header_type header;
93 } lang_target_statement_type;
96 typedef struct lang_output_statement_struct
98 lang_statement_header_type header;
100 } lang_output_statement_type;
102 /* Section types specified in a linker script. */
114 /* This structure holds a list of program headers describing segments
115 in which this section should be placed. */
117 struct lang_output_section_phdr_list
119 struct lang_output_section_phdr_list *next;
124 typedef struct lang_output_section_statement_struct
126 lang_statement_header_type header;
127 union etree_union *addr_tree;
128 lang_statement_list_type children;
130 union lang_statement_union *next;
135 asection *bfd_section;
136 flagword flags; /* Or together of all input sections */
137 enum section_type sectype;
138 struct memory_region_struct *region;
139 struct memory_region_struct *lma_region;
143 int subsection_alignment; /* alignment of components */
144 int section_alignment; /* alignment of start of section */
146 union etree_union *load_base;
148 struct lang_output_section_phdr_list *phdrs;
149 } lang_output_section_statement_type;
154 lang_statement_header_type header;
155 } lang_common_statement_type;
159 lang_statement_header_type header;
160 } lang_object_symbols_statement_type;
164 lang_statement_header_type header;
167 asection *output_section;
168 } lang_fill_statement_type;
172 lang_statement_header_type header;
174 union etree_union *exp;
176 asection *output_section;
178 } lang_data_statement_type;
180 /* Generate a reloc in the output file. */
184 lang_statement_header_type header;
186 /* Reloc to generate. */
187 bfd_reloc_code_real_type reloc;
189 /* Reloc howto structure. */
190 reloc_howto_type *howto;
192 /* Section to generate reloc against. Exactly one of section and
193 name must be NULL. */
196 /* Name of symbol to generate reloc against. Exactly one of section
197 and name must be NULL. */
200 /* Expression for addend. */
201 union etree_union *addend_exp;
203 /* Resolved addend. */
204 bfd_vma addend_value;
206 /* Output section where reloc should be performed. */
207 asection *output_section;
209 /* VMA within output section. */
211 } lang_reloc_statement_type;
213 typedef struct lang_input_statement_struct
215 lang_statement_header_type header;
216 /* Name of this file. */
217 const char *filename;
218 /* Name to use for the symbol giving address of text start */
219 /* Usually the same as filename, but for a file spec'd with -l
220 this is the -l switch itself rather than the filename. */
221 const char *local_sym_name;
226 file_ptr passive_position;
228 /* Symbol table of the file. */
230 unsigned int symbol_count;
232 /* Point to the next file - whatever it is, wanders up and down
235 union lang_statement_union *next;
236 /* Point to the next file, but skips archive contents */
237 union lang_statement_union *next_real_file;
241 /* 1 means search a set of directories for this file. */
242 boolean search_dirs_flag;
244 /* 1 means this is base file of incremental load.
245 Do not load this file's text or data.
246 Also default text_start to after this file's bss. */
248 boolean just_syms_flag;
250 /* Whether to search for this entry as a dynamic archive. */
253 /* Whether to include the entire contents of an archive. */
254 boolean whole_archive;
258 /* unsigned int globals_in_this_file;*/
261 } lang_input_statement_type;
265 lang_statement_header_type header;
267 lang_input_statement_type *ifile;
269 } lang_input_section_type;
274 lang_statement_header_type header;
276 union lang_statement_union *file;
277 } lang_afile_asection_pair_statement_type;
279 typedef struct lang_wild_statement_struct
281 lang_statement_header_type header;
282 const char *section_name;
283 boolean sections_sorted;
284 const char *filename;
285 boolean filenames_sorted;
286 boolean keep_sections;
287 struct name_list *exclude_filename_list;
288 lang_statement_list_type children;
289 } lang_wild_statement_type;
291 typedef struct lang_address_statement_struct
293 lang_statement_header_type header;
294 const char *section_name;
295 union etree_union *address;
296 } lang_address_statement_type;
300 lang_statement_header_type header;
301 bfd_vma output_offset;
303 asection *output_section;
305 } lang_padding_statement_type;
307 /* A group statement collects a set of libraries together. The
308 libraries are searched multiple times, until no new undefined
309 symbols are found. The effect is to search a group of libraries as
310 though they were a single library. */
314 lang_statement_header_type header;
315 lang_statement_list_type children;
316 } lang_group_statement_type;
318 typedef union lang_statement_union
320 lang_statement_header_type header;
321 union lang_statement_union *next;
322 lang_wild_statement_type wild_statement;
323 lang_data_statement_type data_statement;
324 lang_reloc_statement_type reloc_statement;
325 lang_address_statement_type address_statement;
326 lang_output_section_statement_type output_section_statement;
327 lang_afile_asection_pair_statement_type afile_asection_pair_statement;
328 lang_assignment_statement_type assignment_statement;
329 lang_input_statement_type input_statement;
330 lang_target_statement_type target_statement;
331 lang_output_statement_type output_statement;
332 lang_input_section_type input_section;
333 lang_common_statement_type common_statement;
334 lang_object_symbols_statement_type object_symbols_statement;
335 lang_fill_statement_type fill_statement;
336 lang_padding_statement_type padding_statement;
337 lang_group_statement_type group_statement;
338 } lang_statement_union_type;
340 /* This structure holds information about a program header, from the
341 PHDRS command in the linker script. */
345 struct lang_phdr *next;
354 /* This structure is used to hold a list of sections which may not
355 cross reference each other. */
357 struct lang_nocrossref
359 struct lang_nocrossref *next;
363 /* The list of nocrossref lists. */
365 struct lang_nocrossrefs
367 struct lang_nocrossrefs *next;
368 struct lang_nocrossref *list;
371 extern struct lang_nocrossrefs *nocrossref_list;
373 extern lang_output_section_statement_type *abs_output_section;
374 extern lang_statement_list_type lang_output_section_statement;
375 extern boolean lang_has_input_file;
376 extern etree_type *base;
377 extern lang_statement_list_type *stat_ptr;
378 extern boolean delete_output_file_on_failure;
380 extern const char *entry_symbol;
381 extern boolean entry_from_cmdline;
382 extern lang_statement_list_type file_chain;
384 extern void lang_init PARAMS ((void));
385 extern struct memory_region_struct *lang_memory_region_lookup
386 PARAMS ((const char *const));
387 extern struct memory_region_struct *lang_memory_region_default
388 PARAMS ((asection *));
389 extern void lang_map PARAMS ((void));
390 extern void lang_set_flags PARAMS ((lang_memory_region_type *, const char *,
392 extern void lang_add_output PARAMS ((const char *, int from_script));
393 extern lang_output_section_statement_type *lang_enter_output_section_statement
394 PARAMS ((const char *output_section_statement_name,
395 etree_type * address_exp,
396 enum section_type sectype,
399 etree_type *subalign,
401 extern void lang_final PARAMS ((void));
402 extern void lang_process PARAMS ((void));
403 extern void lang_section_start PARAMS ((const char *, union etree_union *));
404 extern void lang_add_entry PARAMS ((const char *, boolean));
405 extern void lang_add_target PARAMS ((const char *));
406 extern void lang_add_wild
407 PARAMS ((const char *, boolean, const char *, boolean, boolean, name_list *));
408 extern void lang_add_map PARAMS ((const char *));
409 extern void lang_add_fill PARAMS ((int));
410 extern lang_assignment_statement_type * lang_add_assignment PARAMS ((union etree_union *));
411 extern void lang_add_attribute PARAMS ((enum statement_enum));
412 extern void lang_startup PARAMS ((const char *));
413 extern void lang_float PARAMS ((enum bfd_boolean));
414 extern void lang_leave_output_section_statement
415 PARAMS ((bfd_vma, const char *, struct lang_output_section_phdr_list *,
417 extern void lang_abs_symbol_at_end_of PARAMS ((const char *, const char *));
418 extern void lang_abs_symbol_at_beginning_of PARAMS ((const char *,
420 extern void lang_statement_append PARAMS ((struct statement_list *,
421 union lang_statement_union *,
422 union lang_statement_union **));
423 extern void lang_for_each_input_file
424 PARAMS ((void (*dothis) (lang_input_statement_type *)));
425 extern void lang_for_each_file
426 PARAMS ((void (*dothis) (lang_input_statement_type *)));
427 extern bfd_vma lang_do_assignments
428 PARAMS ((lang_statement_union_type * s,
429 lang_output_section_statement_type *output_section_statement,
433 #define LANG_FOR_EACH_INPUT_STATEMENT(statement) \
434 lang_input_statement_type *statement; \
435 for (statement = (lang_input_statement_type *)file_chain.head;\
436 statement != (lang_input_statement_type *)NULL; \
437 statement = (lang_input_statement_type *)statement->next)\
439 extern void lang_process PARAMS ((void));
440 extern void ldlang_add_file PARAMS ((lang_input_statement_type *));
441 extern lang_output_section_statement_type *lang_output_section_find
442 PARAMS ((const char * const));
443 extern lang_input_statement_type *lang_add_input_file
444 PARAMS ((const char *name, lang_input_file_enum_type file_type,
445 const char *target));
446 extern void lang_add_keepsyms_file PARAMS ((const char *filename));
447 extern lang_output_section_statement_type *
448 lang_output_section_statement_lookup PARAMS ((const char * const name));
449 extern void ldlang_add_undef PARAMS ((const char *const name));
450 extern void lang_add_output_format PARAMS ((const char *, const char *,
451 const char *, int from_script));
452 extern void lang_list_init PARAMS ((lang_statement_list_type*));
453 extern void lang_add_data PARAMS ((int type, union etree_union *));
454 extern void lang_add_reloc
455 PARAMS ((bfd_reloc_code_real_type reloc, reloc_howto_type *howto,
456 asection *section, const char *name, union etree_union *addend));
457 extern void lang_for_each_statement
458 PARAMS ((void (*func) (lang_statement_union_type *)));
459 extern PTR stat_alloc PARAMS ((size_t size));
460 extern void dprint_statement PARAMS ((lang_statement_union_type *, int));
461 extern bfd_vma lang_size_sections
462 PARAMS ((lang_statement_union_type *s,
463 lang_output_section_statement_type *output_section_statement,
464 lang_statement_union_type **prev, fill_type fill,
465 bfd_vma dot, boolean relax));
466 extern void lang_enter_group PARAMS ((void));
467 extern void lang_leave_group PARAMS ((void));
468 extern void wild_doit
469 PARAMS ((lang_statement_list_type *ptr, asection *section,
470 lang_output_section_statement_type *output,
471 lang_input_statement_type *file));
472 extern void lang_new_phdr
473 PARAMS ((const char *, etree_type *, boolean, boolean, etree_type *,
475 extern void lang_add_nocrossref PARAMS ((struct lang_nocrossref *));
476 extern void lang_enter_overlay PARAMS ((etree_type *, etree_type *, int));
477 extern void lang_enter_overlay_section PARAMS ((const char *));
478 extern void lang_leave_overlay_section
479 PARAMS ((bfd_vma, struct lang_output_section_phdr_list *));
480 extern void lang_leave_overlay
481 PARAMS ((bfd_vma, const char *, struct lang_output_section_phdr_list *,
484 extern struct bfd_elf_version_tree *lang_elf_version_info;
486 extern struct bfd_elf_version_expr *lang_new_vers_regex
487 PARAMS ((struct bfd_elf_version_expr *, const char *, const char *));
488 extern struct bfd_elf_version_tree *lang_new_vers_node
489 PARAMS ((struct bfd_elf_version_expr *, struct bfd_elf_version_expr *));
490 extern struct bfd_elf_version_deps *lang_add_vers_depend
491 PARAMS ((struct bfd_elf_version_deps *, const char *));
492 extern void lang_register_vers_node
493 PARAMS ((const char *, struct bfd_elf_version_tree *,
494 struct bfd_elf_version_deps *));