source: trunk/binutils/ld/ldlang.h@ 3388

Last change on this file since 3388 was 610, checked in by bird, 22 years ago

This commit was generated by cvs2svn to compensate for changes in r609,
which included commits to RCS files with non-trunk default branches.
  • Property cvs2svn:cvs-rev set to 1.1.1.2
  • Property svn:eol-style set to native
  • Property svn:executable set to *
File size: 16.0 KB
Line 
1/* ldlang.h - linker command language support
2 Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
3 2001, 2002, 2003
4 Free Software Foundation, Inc.
5
6 This file is part of GLD, the Gnu Linker.
7
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)
11 any later version.
12
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.
17
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
21 02111-1307, USA. */
22
23#ifndef LDLANG_H
24#define LDLANG_H
25
26typedef enum {
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;
34
35struct _fill_type {
36 size_t size;
37 unsigned char data[1];
38};
39
40typedef struct statement_list {
41 union lang_statement_union *head;
42 union lang_statement_union **tail;
43} lang_statement_list_type;
44
45typedef struct memory_region_struct {
46 char *name;
47 struct memory_region_struct *next;
48 bfd_vma origin;
49 bfd_size_type length;
50 bfd_vma current;
51 bfd_size_type old_length;
52 flagword flags;
53 flagword not_flags;
54 bfd_boolean had_full_message;
55} lang_memory_region_type;
56
57typedef struct lang_statement_header_struct {
58 union lang_statement_union *next;
59 enum statement_enum {
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,
74
75 lang_afile_asection_pair_statement_enum,
76 lang_constructors_statement_enum
77 } type;
78} lang_statement_header_type;
79
80typedef struct {
81 lang_statement_header_type header;
82 union etree_union *exp;
83} lang_assignment_statement_type;
84
85typedef struct lang_target_statement_struct {
86 lang_statement_header_type header;
87 const char *target;
88} lang_target_statement_type;
89
90typedef struct lang_output_statement_struct {
91 lang_statement_header_type header;
92 const char *name;
93} lang_output_statement_type;
94
95/* Section types specified in a linker script. */
96
97enum section_type {
98 normal_section,
99 dsect_section,
100 copy_section,
101 noload_section,
102 info_section,
103 overlay_section
104};
105
106/* This structure holds a list of program headers describing segments
107 in which this section should be placed. */
108
109struct lang_output_section_phdr_list {
110 struct lang_output_section_phdr_list *next;
111 const char *name;
112 bfd_boolean used;
113};
114
115typedef struct lang_output_section_statement_struct {
116 lang_statement_header_type header;
117 union etree_union *addr_tree;
118 lang_statement_list_type children;
119 const char *memspec;
120 union lang_statement_union *next;
121 const char *name;
122
123 bfd_boolean processed;
124
125 asection *bfd_section;
126 flagword flags; /* Or together of all input sections */
127 enum section_type sectype;
128 struct memory_region_struct *region;
129 struct memory_region_struct *lma_region;
130 size_t block_value;
131 fill_type *fill;
132
133 int subsection_alignment; /* alignment of components */
134 int section_alignment; /* alignment of start of section */
135
136 union etree_union *load_base;
137
138 /* If non-null, an expression to evaluate after setting the section's
139 size. The expression is evaluated inside REGION (above) with '.'
140 set to the end of the section. Used in the last overlay section
141 to move '.' past all the overlaid sections. */
142 union etree_union *update_dot_tree;
143
144 struct lang_output_section_phdr_list *phdrs;
145} lang_output_section_statement_type;
146
147typedef struct {
148 lang_statement_header_type header;
149} lang_common_statement_type;
150
151typedef struct {
152 lang_statement_header_type header;
153} lang_object_symbols_statement_type;
154
155typedef struct {
156 lang_statement_header_type header;
157 fill_type *fill;
158 int size;
159 asection *output_section;
160} lang_fill_statement_type;
161
162typedef struct {
163 lang_statement_header_type header;
164 unsigned int type;
165 union etree_union *exp;
166 bfd_vma value;
167 asection *output_section;
168 bfd_vma output_vma;
169} lang_data_statement_type;
170
171/* Generate a reloc in the output file. */
172
173typedef struct {
174 lang_statement_header_type header;
175
176 /* Reloc to generate. */
177 bfd_reloc_code_real_type reloc;
178
179 /* Reloc howto structure. */
180 reloc_howto_type *howto;
181
182 /* Section to generate reloc against. Exactly one of section and
183 name must be NULL. */
184 asection *section;
185
186 /* Name of symbol to generate reloc against. Exactly one of section
187 and name must be NULL. */
188 const char *name;
189
190 /* Expression for addend. */
191 union etree_union *addend_exp;
192
193 /* Resolved addend. */
194 bfd_vma addend_value;
195
196 /* Output section where reloc should be performed. */
197 asection *output_section;
198
199 /* VMA within output section. */
200 bfd_vma output_vma;
201} lang_reloc_statement_type;
202
203typedef struct lang_input_statement_struct {
204 lang_statement_header_type header;
205 /* Name of this file. */
206 const char *filename;
207 /* Name to use for the symbol giving address of text start */
208 /* Usually the same as filename, but for a file spec'd with -l
209 this is the -l switch itself rather than the filename. */
210 const char *local_sym_name;
211
212 bfd *the_bfd;
213
214 bfd_boolean closed;
215 file_ptr passive_position;
216
217 /* Symbol table of the file. */
218 asymbol **asymbols;
219 unsigned int symbol_count;
220
221 /* Point to the next file - whatever it is, wanders up and down
222 archives */
223
224 union lang_statement_union *next;
225 /* Point to the next file, but skips archive contents */
226 union lang_statement_union *next_real_file;
227
228 bfd_boolean is_archive;
229
230 /* 1 means search a set of directories for this file. */
231 bfd_boolean search_dirs_flag;
232
233 /* 1 means this was found in a search directory marked as sysrooted,
234 if search_dirs_flag is false, otherwise, that it should be
235 searched in ld_sysroot before any other location, as long as it
236 starts with a slash. */
237 bfd_boolean sysrooted;
238
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. */
242
243 bfd_boolean just_syms_flag;
244
245 /* Whether to search for this entry as a dynamic archive. */
246 bfd_boolean dynamic;
247
248 /* Whether to include the entire contents of an archive. */
249 bfd_boolean whole_archive;
250
251 bfd_boolean loaded;
252
253#if 0
254 unsigned int globals_in_this_file;
255#endif
256 const char *target;
257 bfd_boolean real;
258} lang_input_statement_type;
259
260typedef struct {
261 lang_statement_header_type header;
262 asection *section;
263 lang_input_statement_type *ifile;
264
265} lang_input_section_type;
266
267typedef struct {
268 lang_statement_header_type header;
269 asection *section;
270 union lang_statement_union *file;
271} lang_afile_asection_pair_statement_type;
272
273typedef struct lang_wild_statement_struct {
274 lang_statement_header_type header;
275 const char *filename;
276 bfd_boolean filenames_sorted;
277 struct wildcard_list *section_list;
278 bfd_boolean keep_sections;
279 lang_statement_list_type children;
280} lang_wild_statement_type;
281
282typedef struct lang_address_statement_struct {
283 lang_statement_header_type header;
284 const char *section_name;
285 union etree_union *address;
286} lang_address_statement_type;
287
288typedef struct {
289 lang_statement_header_type header;
290 bfd_vma output_offset;
291 size_t size;
292 asection *output_section;
293 fill_type *fill;
294} lang_padding_statement_type;
295
296/* A group statement collects a set of libraries together. The
297 libraries are searched multiple times, until no new undefined
298 symbols are found. The effect is to search a group of libraries as
299 though they were a single library. */
300
301typedef struct {
302 lang_statement_header_type header;
303 lang_statement_list_type children;
304} lang_group_statement_type;
305
306typedef union lang_statement_union {
307 lang_statement_header_type header;
308 lang_wild_statement_type wild_statement;
309 lang_data_statement_type data_statement;
310 lang_reloc_statement_type reloc_statement;
311 lang_address_statement_type address_statement;
312 lang_output_section_statement_type output_section_statement;
313 lang_afile_asection_pair_statement_type afile_asection_pair_statement;
314 lang_assignment_statement_type assignment_statement;
315 lang_input_statement_type input_statement;
316 lang_target_statement_type target_statement;
317 lang_output_statement_type output_statement;
318 lang_input_section_type input_section;
319 lang_common_statement_type common_statement;
320 lang_object_symbols_statement_type object_symbols_statement;
321 lang_fill_statement_type fill_statement;
322 lang_padding_statement_type padding_statement;
323 lang_group_statement_type group_statement;
324} lang_statement_union_type;
325
326/* This structure holds information about a program header, from the
327 PHDRS command in the linker script. */
328
329struct lang_phdr {
330 struct lang_phdr *next;
331 const char *name;
332 unsigned long type;
333 bfd_boolean filehdr;
334 bfd_boolean phdrs;
335 etree_type *at;
336 etree_type *flags;
337};
338
339/* This structure is used to hold a list of sections which may not
340 cross reference each other. */
341
342struct lang_nocrossref {
343 struct lang_nocrossref *next;
344 const char *name;
345};
346
347/* The list of nocrossref lists. */
348
349struct lang_nocrossrefs {
350 struct lang_nocrossrefs *next;
351 struct lang_nocrossref *list;
352};
353
354extern struct lang_nocrossrefs *nocrossref_list;
355
356/* This structure is used to hold a list of input section names which
357 will not match an output section in the linker script. */
358
359struct unique_sections {
360 struct unique_sections *next;
361 const char *name;
362};
363
364extern struct unique_sections *unique_section_list;
365
366extern lang_output_section_statement_type *abs_output_section;
367extern lang_statement_list_type lang_output_section_statement;
368extern bfd_boolean lang_has_input_file;
369extern etree_type *base;
370extern lang_statement_list_type *stat_ptr;
371extern bfd_boolean delete_output_file_on_failure;
372
373extern struct bfd_sym_chain entry_symbol;
374extern const char *entry_section;
375extern bfd_boolean entry_from_cmdline;
376extern lang_statement_list_type file_chain;
377
378extern void lang_init
379 PARAMS ((void));
380extern struct memory_region_struct *lang_memory_region_lookup
381 PARAMS ((const char *const));
382extern struct memory_region_struct *lang_memory_region_default
383 PARAMS ((asection *));
384extern void lang_map
385 PARAMS ((void));
386extern void lang_set_flags
387 PARAMS ((lang_memory_region_type *, const char *, int));
388extern void lang_add_output
389 PARAMS ((const char *, int from_script));
390extern lang_output_section_statement_type *lang_enter_output_section_statement
391 PARAMS ((const char *output_section_statement_name,
392 etree_type *address_exp,
393 enum section_type sectype,
394 bfd_vma block_value,
395 etree_type *align,
396 etree_type *subalign,
397 etree_type *));
398extern void lang_final
399 PARAMS ((void));
400extern void lang_process
401 PARAMS ((void));
402extern void lang_section_start
403 PARAMS ((const char *, union etree_union *));
404extern void lang_add_entry
405 PARAMS ((const char *, bfd_boolean));
406extern void lang_add_target
407 PARAMS ((const char *));
408extern void lang_add_wild
409 PARAMS ((struct wildcard_spec *, struct wildcard_list *, bfd_boolean));
410extern void lang_add_map
411 PARAMS ((const char *));
412extern void lang_add_fill
413 PARAMS ((fill_type *));
414extern lang_assignment_statement_type * lang_add_assignment
415 PARAMS ((union etree_union *));
416extern void lang_add_attribute
417 PARAMS ((enum statement_enum));
418extern void lang_startup
419 PARAMS ((const char *));
420extern void lang_float
421 PARAMS ((bfd_boolean));
422extern void lang_leave_output_section_statement
423 PARAMS ((fill_type *, const char *, struct lang_output_section_phdr_list *,
424 const char *));
425extern void lang_abs_symbol_at_end_of
426 PARAMS ((const char *, const char *));
427extern void lang_abs_symbol_at_beginning_of
428 PARAMS ((const char *, const char *));
429extern void lang_statement_append
430 PARAMS ((struct statement_list *, union lang_statement_union *,
431 union lang_statement_union **));
432extern void lang_for_each_input_file
433 PARAMS ((void (*dothis) (lang_input_statement_type *)));
434extern void lang_for_each_file
435 PARAMS ((void (*dothis) (lang_input_statement_type *)));
436extern void lang_reset_memory_regions
437 PARAMS ((void));
438extern bfd_vma lang_do_assignments
439 PARAMS ((lang_statement_union_type * s,
440 lang_output_section_statement_type *output_section_statement,
441 fill_type *fill,
442 bfd_vma dot));
443
444#define LANG_FOR_EACH_INPUT_STATEMENT(statement) \
445 lang_input_statement_type *statement; \
446 for (statement = (lang_input_statement_type *) file_chain.head; \
447 statement != (lang_input_statement_type *) NULL; \
448 statement = (lang_input_statement_type *) statement->next) \
449
450extern void lang_process
451 PARAMS ((void));
452extern void ldlang_add_file
453 PARAMS ((lang_input_statement_type *));
454extern lang_output_section_statement_type *lang_output_section_find
455 PARAMS ((const char * const));
456extern lang_input_statement_type *lang_add_input_file
457 PARAMS ((const char *name, lang_input_file_enum_type file_type,
458 const char *target));
459extern void lang_add_keepsyms_file
460 PARAMS ((const char *filename));
461extern lang_output_section_statement_type *
462 lang_output_section_statement_lookup
463 PARAMS ((const char * const name));
464extern void ldlang_add_undef
465 PARAMS ((const char *const name));
466extern void lang_add_output_format
467 PARAMS ((const char *, const char *, const char *, int from_script));
468extern void lang_list_init
469 PARAMS ((lang_statement_list_type*));
470extern void lang_add_data
471 PARAMS ((int type, union etree_union *));
472extern void lang_add_reloc
473 PARAMS ((bfd_reloc_code_real_type reloc, reloc_howto_type *howto,
474 asection *section, const char *name, union etree_union *addend));
475extern void lang_for_each_statement
476 PARAMS ((void (*func) (lang_statement_union_type *)));
477extern PTR stat_alloc
478 PARAMS ((size_t size));
479extern void dprint_statement
480 PARAMS ((lang_statement_union_type *, int));
481extern bfd_vma lang_size_sections
482 PARAMS ((lang_statement_union_type *s,
483 lang_output_section_statement_type *output_section_statement,
484 lang_statement_union_type **prev, fill_type *fill,
485 bfd_vma dot, bfd_boolean *relax, bfd_boolean check_regions));
486extern void lang_enter_group
487 PARAMS ((void));
488extern void lang_leave_group
489 PARAMS ((void));
490extern void lang_add_section
491 PARAMS ((lang_statement_list_type *ptr, asection *section,
492 lang_output_section_statement_type *output,
493 lang_input_statement_type *file));
494extern void lang_new_phdr
495 PARAMS ((const char *, etree_type *, bfd_boolean, bfd_boolean, etree_type *,
496 etree_type *));
497extern void lang_add_nocrossref
498 PARAMS ((struct lang_nocrossref *));
499extern void lang_enter_overlay
500 PARAMS ((etree_type *));
501extern void lang_enter_overlay_section
502 PARAMS ((const char *));
503extern void lang_leave_overlay_section
504 PARAMS ((fill_type *, struct lang_output_section_phdr_list *));
505extern void lang_leave_overlay
506 PARAMS ((etree_type *, int, fill_type *, const char *,
507 struct lang_output_section_phdr_list *, const char *));
508
509extern struct bfd_elf_version_tree *lang_elf_version_info;
510
511extern struct bfd_elf_version_expr *lang_new_vers_pattern
512 PARAMS ((struct bfd_elf_version_expr *, const char *, const char *));
513extern struct bfd_elf_version_tree *lang_new_vers_node
514 PARAMS ((struct bfd_elf_version_expr *, struct bfd_elf_version_expr *));
515extern struct bfd_elf_version_deps *lang_add_vers_depend
516 PARAMS ((struct bfd_elf_version_deps *, const char *));
517extern void lang_register_vers_node
518 PARAMS ((const char *, struct bfd_elf_version_tree *,
519 struct bfd_elf_version_deps *));
520bfd_boolean unique_section_p
521 PARAMS ((const char *));
522extern void lang_add_unique
523 PARAMS ((const char *));
524extern const char *lang_get_output_target
525 PARAMS ((void));
526
527#endif
Note: See TracBrowser for help on using the repository browser.