1 /* ldlang.h - linker command language support
2 Copyright 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001
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
26 lang_input_file_is_l_enum
,
27 lang_input_file_is_symbols_only_enum
,
28 lang_input_file_is_marker_enum
,
29 lang_input_file_is_fake_enum
,
30 lang_input_file_is_search_file_enum
,
31 lang_input_file_is_file_enum
32 } lang_input_file_enum_type
;
34 typedef unsigned int fill_type
;
36 typedef struct statement_list
{
37 union lang_statement_union
*head
;
38 union lang_statement_union
**tail
;
39 } lang_statement_list_type
;
41 typedef struct memory_region_struct
{
43 struct memory_region_struct
*next
;
47 bfd_size_type old_length
;
50 boolean had_full_message
;
51 } lang_memory_region_type
;
53 typedef struct lang_statement_header_struct
{
54 union lang_statement_union
*next
;
56 lang_output_section_statement_enum
,
57 lang_assignment_statement_enum
,
58 lang_input_statement_enum
,
59 lang_address_statement_enum
,
60 lang_wild_statement_enum
,
61 lang_input_section_enum
,
62 lang_object_symbols_statement_enum
,
63 lang_fill_statement_enum
,
64 lang_data_statement_enum
,
65 lang_reloc_statement_enum
,
66 lang_target_statement_enum
,
67 lang_output_statement_enum
,
68 lang_padding_statement_enum
,
69 lang_group_statement_enum
,
71 lang_afile_asection_pair_statement_enum
,
72 lang_constructors_statement_enum
74 } lang_statement_header_type
;
77 lang_statement_header_type header
;
78 union etree_union
*exp
;
79 } lang_assignment_statement_type
;
81 typedef struct lang_target_statement_struct
{
82 lang_statement_header_type header
;
84 } lang_target_statement_type
;
86 typedef struct lang_output_statement_struct
{
87 lang_statement_header_type header
;
89 } lang_output_statement_type
;
91 /* Section types specified in a linker script. */
102 /* This structure holds a list of program headers describing segments
103 in which this section should be placed. */
105 struct lang_output_section_phdr_list
{
106 struct lang_output_section_phdr_list
*next
;
111 typedef struct lang_output_section_statement_struct
{
112 lang_statement_header_type header
;
113 union etree_union
*addr_tree
;
114 lang_statement_list_type children
;
116 union lang_statement_union
*next
;
121 asection
*bfd_section
;
122 flagword flags
; /* Or together of all input sections */
123 enum section_type sectype
;
124 struct memory_region_struct
*region
;
125 struct memory_region_struct
*lma_region
;
129 int subsection_alignment
; /* alignment of components */
130 int section_alignment
; /* alignment of start of section */
132 union etree_union
*load_base
;
134 struct lang_output_section_phdr_list
*phdrs
;
135 } lang_output_section_statement_type
;
138 lang_statement_header_type header
;
139 } lang_common_statement_type
;
142 lang_statement_header_type header
;
143 } lang_object_symbols_statement_type
;
146 lang_statement_header_type header
;
149 asection
*output_section
;
150 } lang_fill_statement_type
;
153 lang_statement_header_type header
;
155 union etree_union
*exp
;
157 asection
*output_section
;
159 } lang_data_statement_type
;
161 /* Generate a reloc in the output file. */
164 lang_statement_header_type header
;
166 /* Reloc to generate. */
167 bfd_reloc_code_real_type reloc
;
169 /* Reloc howto structure. */
170 reloc_howto_type
*howto
;
172 /* Section to generate reloc against. Exactly one of section and
173 name must be NULL. */
176 /* Name of symbol to generate reloc against. Exactly one of section
177 and name must be NULL. */
180 /* Expression for addend. */
181 union etree_union
*addend_exp
;
183 /* Resolved addend. */
184 bfd_vma addend_value
;
186 /* Output section where reloc should be performed. */
187 asection
*output_section
;
189 /* VMA within output section. */
191 } lang_reloc_statement_type
;
193 typedef struct lang_input_statement_struct
{
194 lang_statement_header_type header
;
195 /* Name of this file. */
196 const char *filename
;
197 /* Name to use for the symbol giving address of text start */
198 /* Usually the same as filename, but for a file spec'd with -l
199 this is the -l switch itself rather than the filename. */
200 const char *local_sym_name
;
205 file_ptr passive_position
;
207 /* Symbol table of the file. */
209 unsigned int symbol_count
;
211 /* Point to the next file - whatever it is, wanders up and down
214 union lang_statement_union
*next
;
215 /* Point to the next file, but skips archive contents */
216 union lang_statement_union
*next_real_file
;
220 /* 1 means search a set of directories for this file. */
221 boolean search_dirs_flag
;
223 /* 1 means this is base file of incremental load.
224 Do not load this file's text or data.
225 Also default text_start to after this file's bss. */
227 boolean just_syms_flag
;
229 /* Whether to search for this entry as a dynamic archive. */
232 /* Whether to include the entire contents of an archive. */
233 boolean whole_archive
;
238 unsigned int globals_in_this_file
;
242 } lang_input_statement_type
;
245 lang_statement_header_type header
;
247 lang_input_statement_type
*ifile
;
249 } lang_input_section_type
;
252 lang_statement_header_type header
;
254 union lang_statement_union
*file
;
255 } lang_afile_asection_pair_statement_type
;
257 typedef struct lang_wild_statement_struct
{
258 lang_statement_header_type header
;
259 const char *section_name
;
260 boolean sections_sorted
;
261 const char *filename
;
262 boolean filenames_sorted
;
263 boolean keep_sections
;
264 struct name_list
*exclude_filename_list
;
265 lang_statement_list_type children
;
266 } lang_wild_statement_type
;
268 typedef struct lang_address_statement_struct
{
269 lang_statement_header_type header
;
270 const char *section_name
;
271 union etree_union
*address
;
272 } lang_address_statement_type
;
275 lang_statement_header_type header
;
276 bfd_vma output_offset
;
278 asection
*output_section
;
280 } lang_padding_statement_type
;
282 /* A group statement collects a set of libraries together. The
283 libraries are searched multiple times, until no new undefined
284 symbols are found. The effect is to search a group of libraries as
285 though they were a single library. */
288 lang_statement_header_type header
;
289 lang_statement_list_type children
;
290 } lang_group_statement_type
;
292 typedef union lang_statement_union
{
293 lang_statement_header_type header
;
294 union lang_statement_union
*next
;
295 lang_wild_statement_type wild_statement
;
296 lang_data_statement_type data_statement
;
297 lang_reloc_statement_type reloc_statement
;
298 lang_address_statement_type address_statement
;
299 lang_output_section_statement_type output_section_statement
;
300 lang_afile_asection_pair_statement_type afile_asection_pair_statement
;
301 lang_assignment_statement_type assignment_statement
;
302 lang_input_statement_type input_statement
;
303 lang_target_statement_type target_statement
;
304 lang_output_statement_type output_statement
;
305 lang_input_section_type input_section
;
306 lang_common_statement_type common_statement
;
307 lang_object_symbols_statement_type object_symbols_statement
;
308 lang_fill_statement_type fill_statement
;
309 lang_padding_statement_type padding_statement
;
310 lang_group_statement_type group_statement
;
311 } lang_statement_union_type
;
313 /* This structure holds information about a program header, from the
314 PHDRS command in the linker script. */
317 struct lang_phdr
*next
;
326 /* This structure is used to hold a list of sections which may not
327 cross reference each other. */
329 struct lang_nocrossref
{
330 struct lang_nocrossref
*next
;
334 /* The list of nocrossref lists. */
336 struct lang_nocrossrefs
{
337 struct lang_nocrossrefs
*next
;
338 struct lang_nocrossref
*list
;
341 extern struct lang_nocrossrefs
*nocrossref_list
;
343 /* This structure is used to hold a list of input section names which
344 will not match an output section in the linker script. */
346 struct unique_sections
{
347 struct unique_sections
*next
;
351 extern struct unique_sections
*unique_section_list
;
353 extern lang_output_section_statement_type
*abs_output_section
;
354 extern lang_statement_list_type lang_output_section_statement
;
355 extern boolean lang_has_input_file
;
356 extern etree_type
*base
;
357 extern lang_statement_list_type
*stat_ptr
;
358 extern boolean delete_output_file_on_failure
;
360 extern const char *entry_symbol
;
361 extern boolean entry_from_cmdline
;
362 extern lang_statement_list_type file_chain
;
364 extern void lang_init
PARAMS ((void));
365 extern struct memory_region_struct
*lang_memory_region_lookup
366 PARAMS ((const char *const));
367 extern struct memory_region_struct
*lang_memory_region_default
368 PARAMS ((asection
*));
369 extern void lang_map
PARAMS ((void));
370 extern void lang_set_flags
PARAMS ((lang_memory_region_type
*, const char *,
372 extern void lang_add_output
PARAMS ((const char *, int from_script
));
373 extern lang_output_section_statement_type
*lang_enter_output_section_statement
374 PARAMS ((const char *output_section_statement_name
,
375 etree_type
* address_exp
,
376 enum section_type sectype
,
379 etree_type
*subalign
,
381 extern void lang_final
PARAMS ((void));
382 extern void lang_process
PARAMS ((void));
383 extern void lang_section_start
PARAMS ((const char *, union etree_union
*));
384 extern void lang_add_entry
PARAMS ((const char *, boolean
));
385 extern void lang_add_target
PARAMS ((const char *));
386 extern void lang_add_wild
387 PARAMS ((const char *, boolean
, const char *, boolean
, boolean
, name_list
*));
388 extern void lang_add_map
PARAMS ((const char *));
389 extern void lang_add_fill
PARAMS ((int));
390 extern lang_assignment_statement_type
* lang_add_assignment
PARAMS ((union etree_union
*));
391 extern void lang_add_attribute
PARAMS ((enum statement_enum
));
392 extern void lang_startup
PARAMS ((const char *));
393 extern void lang_float
PARAMS ((enum bfd_boolean
));
394 extern void lang_leave_output_section_statement
395 PARAMS ((bfd_vma
, const char *, struct lang_output_section_phdr_list
*,
397 extern void lang_abs_symbol_at_end_of
PARAMS ((const char *, const char *));
398 extern void lang_abs_symbol_at_beginning_of
PARAMS ((const char *,
400 extern void lang_statement_append
PARAMS ((struct statement_list
*,
401 union lang_statement_union
*,
402 union lang_statement_union
**));
403 extern void lang_for_each_input_file
404 PARAMS ((void (*dothis
) (lang_input_statement_type
*)));
405 extern void lang_for_each_file
406 PARAMS ((void (*dothis
) (lang_input_statement_type
*)));
407 extern bfd_vma lang_do_assignments
408 PARAMS ((lang_statement_union_type
* s
,
409 lang_output_section_statement_type
*output_section_statement
,
413 #define LANG_FOR_EACH_INPUT_STATEMENT(statement) \
414 lang_input_statement_type *statement; \
415 for (statement = (lang_input_statement_type *)file_chain.head;\
416 statement != (lang_input_statement_type *)NULL; \
417 statement = (lang_input_statement_type *)statement->next)\
419 extern void lang_process PARAMS ((void));
420 extern void ldlang_add_file
PARAMS ((lang_input_statement_type
*));
421 extern lang_output_section_statement_type
*lang_output_section_find
422 PARAMS ((const char * const));
423 extern lang_input_statement_type
*lang_add_input_file
424 PARAMS ((const char *name
, lang_input_file_enum_type file_type
,
425 const char *target
));
426 extern void lang_add_keepsyms_file
PARAMS ((const char *filename
));
427 extern lang_output_section_statement_type
*
428 lang_output_section_statement_lookup
PARAMS ((const char * const name
));
429 extern void ldlang_add_undef
PARAMS ((const char *const name
));
430 extern void lang_add_output_format
PARAMS ((const char *, const char *,
431 const char *, int from_script
));
432 extern void lang_list_init
PARAMS ((lang_statement_list_type
*));
433 extern void lang_add_data
PARAMS ((int type
, union etree_union
*));
434 extern void lang_add_reloc
435 PARAMS ((bfd_reloc_code_real_type reloc
, reloc_howto_type
*howto
,
436 asection
*section
, const char *name
, union etree_union
*addend
));
437 extern void lang_for_each_statement
438 PARAMS ((void (*func
) (lang_statement_union_type
*)));
439 extern PTR stat_alloc
PARAMS ((size_t size
));
440 extern void dprint_statement
PARAMS ((lang_statement_union_type
*, int));
441 extern bfd_vma lang_size_sections
442 PARAMS ((lang_statement_union_type
*s
,
443 lang_output_section_statement_type
*output_section_statement
,
444 lang_statement_union_type
**prev
, fill_type fill
,
445 bfd_vma dot
, boolean relax
));
446 extern void lang_enter_group
PARAMS ((void));
447 extern void lang_leave_group
PARAMS ((void));
448 extern void wild_doit
449 PARAMS ((lang_statement_list_type
*ptr
, asection
*section
,
450 lang_output_section_statement_type
*output
,
451 lang_input_statement_type
*file
));
452 extern void lang_new_phdr
453 PARAMS ((const char *, etree_type
*, boolean
, boolean
, etree_type
*,
455 extern void lang_add_nocrossref
PARAMS ((struct lang_nocrossref
*));
456 extern void lang_enter_overlay
PARAMS ((etree_type
*, etree_type
*, int));
457 extern void lang_enter_overlay_section
PARAMS ((const char *));
458 extern void lang_leave_overlay_section
459 PARAMS ((bfd_vma
, struct lang_output_section_phdr_list
*));
460 extern void lang_leave_overlay
461 PARAMS ((bfd_vma
, const char *, struct lang_output_section_phdr_list
*,
464 extern struct bfd_elf_version_tree
*lang_elf_version_info
;
466 extern struct bfd_elf_version_expr
*lang_new_vers_regex
467 PARAMS ((struct bfd_elf_version_expr
*, const char *, const char *));
468 extern struct bfd_elf_version_tree
*lang_new_vers_node
469 PARAMS ((struct bfd_elf_version_expr
*, struct bfd_elf_version_expr
*));
470 extern struct bfd_elf_version_deps
*lang_add_vers_depend
471 PARAMS ((struct bfd_elf_version_deps
*, const char *));
472 extern void lang_register_vers_node
473 PARAMS ((const char *, struct bfd_elf_version_tree
*,
474 struct bfd_elf_version_deps
*));
475 boolean unique_section_p
PARAMS ((const char *));
476 extern void lang_add_unique
PARAMS ((const char *));