1 /* ldlang.h - linker command language support
2 Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
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 1, 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, 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
;
37 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
{
44 struct memory_region_struct
*next
;
48 bfd_size_type old_length
;
51 boolean had_full_message
;
52 } lang_memory_region_type
;
54 typedef struct lang_statement_header_struct
{
55 union lang_statement_union
*next
;
57 lang_output_section_statement_enum
,
58 lang_assignment_statement_enum
,
59 lang_input_statement_enum
,
60 lang_address_statement_enum
,
61 lang_wild_statement_enum
,
62 lang_input_section_enum
,
63 lang_object_symbols_statement_enum
,
64 lang_fill_statement_enum
,
65 lang_data_statement_enum
,
66 lang_reloc_statement_enum
,
67 lang_target_statement_enum
,
68 lang_output_statement_enum
,
69 lang_padding_statement_enum
,
70 lang_group_statement_enum
,
72 lang_afile_asection_pair_statement_enum
,
73 lang_constructors_statement_enum
75 } lang_statement_header_type
;
78 lang_statement_header_type header
;
79 union etree_union
*exp
;
80 } lang_assignment_statement_type
;
82 typedef struct lang_target_statement_struct
{
83 lang_statement_header_type header
;
85 } lang_target_statement_type
;
87 typedef struct lang_output_statement_struct
{
88 lang_statement_header_type header
;
90 } lang_output_statement_type
;
92 /* Section types specified in a linker script. */
103 /* This structure holds a list of program headers describing segments
104 in which this section should be placed. */
106 struct lang_output_section_phdr_list
{
107 struct lang_output_section_phdr_list
*next
;
112 typedef struct lang_output_section_statement_struct
{
113 lang_statement_header_type header
;
114 union etree_union
*addr_tree
;
115 lang_statement_list_type children
;
117 union lang_statement_union
*next
;
122 asection
*bfd_section
;
123 flagword flags
; /* Or together of all input sections */
124 enum section_type sectype
;
125 struct memory_region_struct
*region
;
126 struct memory_region_struct
*lma_region
;
130 int subsection_alignment
; /* alignment of components */
131 int section_alignment
; /* alignment of start of section */
133 union etree_union
*load_base
;
135 struct lang_output_section_phdr_list
*phdrs
;
136 } lang_output_section_statement_type
;
139 lang_statement_header_type header
;
140 } lang_common_statement_type
;
143 lang_statement_header_type header
;
144 } lang_object_symbols_statement_type
;
147 lang_statement_header_type header
;
150 asection
*output_section
;
151 } lang_fill_statement_type
;
154 lang_statement_header_type header
;
156 union etree_union
*exp
;
158 asection
*output_section
;
160 } lang_data_statement_type
;
162 /* Generate a reloc in the output file. */
165 lang_statement_header_type header
;
167 /* Reloc to generate. */
168 bfd_reloc_code_real_type reloc
;
170 /* Reloc howto structure. */
171 reloc_howto_type
*howto
;
173 /* Section to generate reloc against. Exactly one of section and
174 name must be NULL. */
177 /* Name of symbol to generate reloc against. Exactly one of section
178 and name must be NULL. */
181 /* Expression for addend. */
182 union etree_union
*addend_exp
;
184 /* Resolved addend. */
185 bfd_vma addend_value
;
187 /* Output section where reloc should be performed. */
188 asection
*output_section
;
190 /* VMA within output section. */
192 } lang_reloc_statement_type
;
194 typedef struct lang_input_statement_struct
{
195 lang_statement_header_type header
;
196 /* Name of this file. */
197 const char *filename
;
198 /* Name to use for the symbol giving address of text start */
199 /* Usually the same as filename, but for a file spec'd with -l
200 this is the -l switch itself rather than the filename. */
201 const char *local_sym_name
;
206 file_ptr passive_position
;
208 /* Symbol table of the file. */
210 unsigned int symbol_count
;
212 /* Point to the next file - whatever it is, wanders up and down
215 union lang_statement_union
*next
;
216 /* Point to the next file, but skips archive contents */
217 union lang_statement_union
*next_real_file
;
221 /* 1 means search a set of directories for this file. */
222 boolean search_dirs_flag
;
224 /* 1 means this is base file of incremental load.
225 Do not load this file's text or data.
226 Also default text_start to after this file's bss. */
228 boolean just_syms_flag
;
230 /* Whether to search for this entry as a dynamic archive. */
233 /* Whether to include the entire contents of an archive. */
234 boolean whole_archive
;
239 unsigned int globals_in_this_file
;
243 } lang_input_statement_type
;
246 lang_statement_header_type header
;
248 lang_input_statement_type
*ifile
;
250 } lang_input_section_type
;
253 lang_statement_header_type header
;
255 union lang_statement_union
*file
;
256 } lang_afile_asection_pair_statement_type
;
258 typedef struct lang_wild_statement_struct
{
259 lang_statement_header_type header
;
260 const char *filename
;
261 boolean filenames_sorted
;
262 struct wildcard_list
*section_list
;
263 boolean keep_sections
;
264 lang_statement_list_type children
;
265 } lang_wild_statement_type
;
267 typedef struct lang_address_statement_struct
{
268 lang_statement_header_type header
;
269 const char *section_name
;
270 union etree_union
*address
;
271 } lang_address_statement_type
;
274 lang_statement_header_type header
;
275 bfd_vma output_offset
;
277 asection
*output_section
;
279 } lang_padding_statement_type
;
281 /* A group statement collects a set of libraries together. The
282 libraries are searched multiple times, until no new undefined
283 symbols are found. The effect is to search a group of libraries as
284 though they were a single library. */
287 lang_statement_header_type header
;
288 lang_statement_list_type children
;
289 } lang_group_statement_type
;
291 typedef union lang_statement_union
{
292 lang_statement_header_type header
;
293 union lang_statement_union
*next
;
294 lang_wild_statement_type wild_statement
;
295 lang_data_statement_type data_statement
;
296 lang_reloc_statement_type reloc_statement
;
297 lang_address_statement_type address_statement
;
298 lang_output_section_statement_type output_section_statement
;
299 lang_afile_asection_pair_statement_type afile_asection_pair_statement
;
300 lang_assignment_statement_type assignment_statement
;
301 lang_input_statement_type input_statement
;
302 lang_target_statement_type target_statement
;
303 lang_output_statement_type output_statement
;
304 lang_input_section_type input_section
;
305 lang_common_statement_type common_statement
;
306 lang_object_symbols_statement_type object_symbols_statement
;
307 lang_fill_statement_type fill_statement
;
308 lang_padding_statement_type padding_statement
;
309 lang_group_statement_type group_statement
;
310 } lang_statement_union_type
;
312 /* This structure holds information about a program header, from the
313 PHDRS command in the linker script. */
316 struct lang_phdr
*next
;
325 /* This structure is used to hold a list of sections which may not
326 cross reference each other. */
328 struct lang_nocrossref
{
329 struct lang_nocrossref
*next
;
333 /* The list of nocrossref lists. */
335 struct lang_nocrossrefs
{
336 struct lang_nocrossrefs
*next
;
337 struct lang_nocrossref
*list
;
340 extern struct lang_nocrossrefs
*nocrossref_list
;
342 /* This structure is used to hold a list of input section names which
343 will not match an output section in the linker script. */
345 struct unique_sections
{
346 struct unique_sections
*next
;
350 extern struct unique_sections
*unique_section_list
;
352 extern lang_output_section_statement_type
*abs_output_section
;
353 extern lang_statement_list_type lang_output_section_statement
;
354 extern boolean lang_has_input_file
;
355 extern etree_type
*base
;
356 extern lang_statement_list_type
*stat_ptr
;
357 extern boolean delete_output_file_on_failure
;
359 extern const char *entry_symbol
;
360 extern boolean entry_from_cmdline
;
361 extern lang_statement_list_type file_chain
;
363 extern void lang_init
PARAMS ((void));
364 extern struct memory_region_struct
*lang_memory_region_lookup
365 PARAMS ((const char *const));
366 extern struct memory_region_struct
*lang_memory_region_default
367 PARAMS ((asection
*));
368 extern void lang_map
PARAMS ((void));
369 extern void lang_set_flags
PARAMS ((lang_memory_region_type
*, const char *,
371 extern void lang_add_output
PARAMS ((const char *, int from_script
));
372 extern lang_output_section_statement_type
*lang_enter_output_section_statement
373 PARAMS ((const char *output_section_statement_name
,
374 etree_type
* address_exp
,
375 enum section_type sectype
,
378 etree_type
*subalign
,
380 extern void lang_final
PARAMS ((void));
381 extern void lang_process
PARAMS ((void));
382 extern void lang_section_start
PARAMS ((const char *, union etree_union
*));
383 extern void lang_add_entry
PARAMS ((const char *, boolean
));
384 extern void lang_add_target
PARAMS ((const char *));
385 extern void lang_add_wild
386 PARAMS ((struct wildcard_spec
*, struct wildcard_list
*, boolean
));
387 extern void lang_add_map
PARAMS ((const char *));
388 extern void lang_add_fill
PARAMS ((int));
389 extern lang_assignment_statement_type
* lang_add_assignment
PARAMS ((union etree_union
*));
390 extern void lang_add_attribute
PARAMS ((enum statement_enum
));
391 extern void lang_startup
PARAMS ((const char *));
392 extern void lang_float
PARAMS ((enum bfd_boolean
));
393 extern void lang_leave_output_section_statement
394 PARAMS ((bfd_vma
, const char *, struct lang_output_section_phdr_list
*,
396 extern void lang_abs_symbol_at_end_of
PARAMS ((const char *, const char *));
397 extern void lang_abs_symbol_at_beginning_of
PARAMS ((const char *,
399 extern void lang_statement_append
PARAMS ((struct statement_list
*,
400 union lang_statement_union
*,
401 union lang_statement_union
**));
402 extern void lang_for_each_input_file
403 PARAMS ((void (*dothis
) (lang_input_statement_type
*)));
404 extern void lang_for_each_file
405 PARAMS ((void (*dothis
) (lang_input_statement_type
*)));
406 extern bfd_vma lang_do_assignments
407 PARAMS ((lang_statement_union_type
* s
,
408 lang_output_section_statement_type
*output_section_statement
,
412 #define LANG_FOR_EACH_INPUT_STATEMENT(statement) \
413 lang_input_statement_type *statement; \
414 for (statement = (lang_input_statement_type *)file_chain.head;\
415 statement != (lang_input_statement_type *)NULL; \
416 statement = (lang_input_statement_type *)statement->next)\
418 extern void lang_process PARAMS ((void));
419 extern void ldlang_add_file
PARAMS ((lang_input_statement_type
*));
420 extern lang_output_section_statement_type
*lang_output_section_find
421 PARAMS ((const char * const));
422 extern lang_input_statement_type
*lang_add_input_file
423 PARAMS ((const char *name
, lang_input_file_enum_type file_type
,
424 const char *target
));
425 extern void lang_add_keepsyms_file
PARAMS ((const char *filename
));
426 extern lang_output_section_statement_type
*
427 lang_output_section_statement_lookup
PARAMS ((const char * const name
));
428 extern void ldlang_add_undef
PARAMS ((const char *const name
));
429 extern void lang_add_output_format
PARAMS ((const char *, const char *,
430 const char *, int from_script
));
431 extern void lang_list_init
PARAMS ((lang_statement_list_type
*));
432 extern void lang_add_data
PARAMS ((int type
, union etree_union
*));
433 extern void lang_add_reloc
434 PARAMS ((bfd_reloc_code_real_type reloc
, reloc_howto_type
*howto
,
435 asection
*section
, const char *name
, union etree_union
*addend
));
436 extern void lang_for_each_statement
437 PARAMS ((void (*func
) (lang_statement_union_type
*)));
438 extern PTR stat_alloc
PARAMS ((size_t size
));
439 extern void dprint_statement
PARAMS ((lang_statement_union_type
*, int));
440 extern bfd_vma lang_size_sections
441 PARAMS ((lang_statement_union_type
*s
,
442 lang_output_section_statement_type
*output_section_statement
,
443 lang_statement_union_type
**prev
, fill_type fill
,
444 bfd_vma dot
, boolean relax
));
445 extern void lang_enter_group
PARAMS ((void));
446 extern void lang_leave_group
PARAMS ((void));
447 extern void wild_doit
448 PARAMS ((lang_statement_list_type
*ptr
, asection
*section
,
449 lang_output_section_statement_type
*output
,
450 lang_input_statement_type
*file
));
451 extern void lang_new_phdr
452 PARAMS ((const char *, etree_type
*, boolean
, boolean
, etree_type
*,
454 extern void lang_add_nocrossref
PARAMS ((struct lang_nocrossref
*));
455 extern void lang_enter_overlay
PARAMS ((etree_type
*, etree_type
*, int));
456 extern void lang_enter_overlay_section
PARAMS ((const char *));
457 extern void lang_leave_overlay_section
458 PARAMS ((bfd_vma
, struct lang_output_section_phdr_list
*));
459 extern void lang_leave_overlay
460 PARAMS ((bfd_vma
, const char *, struct lang_output_section_phdr_list
*,
463 extern struct bfd_elf_version_tree
*lang_elf_version_info
;
465 extern struct bfd_elf_version_expr
*lang_new_vers_regex
466 PARAMS ((struct bfd_elf_version_expr
*, const char *, const char *));
467 extern struct bfd_elf_version_tree
*lang_new_vers_node
468 PARAMS ((struct bfd_elf_version_expr
*, struct bfd_elf_version_expr
*));
469 extern struct bfd_elf_version_deps
*lang_add_vers_depend
470 PARAMS ((struct bfd_elf_version_deps
*, const char *));
471 extern void lang_register_vers_node
472 PARAMS ((const char *, struct bfd_elf_version_tree
*,
473 struct bfd_elf_version_deps
*));
474 boolean unique_section_p
PARAMS ((const char *));
475 extern void lang_add_unique
PARAMS ((const char *));