]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blobdiff - ld/ldlang.h
* ld.texinfo: Typo fixes. Document SUBALIGN.
[thirdparty/binutils-gdb.git] / ld / ldlang.h
index 58a47f23a5be86dc3a019f7e2945f1085556ca2f..d3e87b128b7372c7563a93e6d3252e1484ecd244 100644 (file)
@@ -1,12 +1,13 @@
 /* ldlang.h - linker command language support
-   Copyright 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000
+   Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
+   2001, 2002, 2003
    Free Software Foundation, Inc.
 
    This file is part of GLD, the Gnu Linker.
 
    GLD is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
-   the Free Software Foundation; either version 1, or (at your option)
+   the Free Software Foundation; either version 2, or (at your option)
    any later version.
 
    GLD is distributed in the hope that it will be useful,
@@ -22,8 +23,7 @@
 #ifndef LDLANG_H
 #define LDLANG_H
 
-typedef enum
-{
+typedef enum {
   lang_input_file_is_l_enum,
   lang_input_file_is_symbols_only_enum,
   lang_input_file_is_marker_enum,
@@ -32,15 +32,17 @@ typedef enum
   lang_input_file_is_file_enum
 } lang_input_file_enum_type;
 
-typedef unsigned int fill_type;
-typedef struct statement_list
-{
+struct _fill_type {
+  size_t size;
+  unsigned char data[1];
+};
+
+typedef struct statement_list {
   union lang_statement_union *head;
   union lang_statement_union **tail;
 } lang_statement_list_type;
 
-typedef struct memory_region_struct
-{
+typedef struct memory_region_struct {
   char *name;
   struct memory_region_struct *next;
   bfd_vma origin;
@@ -49,56 +51,50 @@ typedef struct memory_region_struct
   bfd_size_type old_length;
   flagword flags;
   flagword not_flags;
-  boolean had_full_message;
-} lang_memory_region_type ;
-
-typedef struct lang_statement_header_struct
-{
-  union  lang_statement_union  *next;
-  enum statement_enum
-    {
-      lang_output_section_statement_enum,
-      lang_assignment_statement_enum,
-      lang_input_statement_enum,
-      lang_address_statement_enum,
-      lang_wild_statement_enum,
-      lang_input_section_enum,
-      lang_object_symbols_statement_enum,
-      lang_fill_statement_enum,
-      lang_data_statement_enum,
-      lang_reloc_statement_enum,
-      lang_target_statement_enum,
-      lang_output_statement_enum,
-      lang_padding_statement_enum,
-      lang_group_statement_enum,
-
-      lang_afile_asection_pair_statement_enum,
-      lang_constructors_statement_enum
-    } type;
+  bfd_boolean had_full_message;
+} lang_memory_region_type;
+
+typedef struct lang_statement_header_struct {
+  union lang_statement_union *next;
+  enum statement_enum {
+    lang_output_section_statement_enum,
+    lang_assignment_statement_enum,
+    lang_input_statement_enum,
+    lang_address_statement_enum,
+    lang_wild_statement_enum,
+    lang_input_section_enum,
+    lang_object_symbols_statement_enum,
+    lang_fill_statement_enum,
+    lang_data_statement_enum,
+    lang_reloc_statement_enum,
+    lang_target_statement_enum,
+    lang_output_statement_enum,
+    lang_padding_statement_enum,
+    lang_group_statement_enum,
+
+    lang_afile_asection_pair_statement_enum,
+    lang_constructors_statement_enum
+  } type;
 } lang_statement_header_type;
 
-typedef struct
-{
+typedef struct {
   lang_statement_header_type header;
   union etree_union *exp;
 } lang_assignment_statement_type;
 
-typedef struct lang_target_statement_struct
-{
+typedef struct lang_target_statement_struct {
   lang_statement_header_type header;
   const char *target;
 } lang_target_statement_type;
 
-typedef struct lang_output_statement_struct
-{
+typedef struct lang_output_statement_struct {
   lang_statement_header_type header;
   const char *name;
 } lang_output_statement_type;
 
 /* Section types specified in a linker script.  */
 
-enum section_type
-{
+enum section_type {
   normal_section,
   dsect_section,
   copy_section,
@@ -110,15 +106,13 @@ enum section_type
 /* This structure holds a list of program headers describing segments
    in which this section should be placed.  */
 
-struct lang_output_section_phdr_list
-{
+struct lang_output_section_phdr_list {
   struct lang_output_section_phdr_list *next;
   const char *name;
-  boolean used;
+  bfd_boolean used;
 };
 
-typedef struct lang_output_section_statement_struct
-{
+typedef struct lang_output_section_statement_struct {
   lang_statement_header_type header;
   union etree_union *addr_tree;
   lang_statement_list_type children;
@@ -126,7 +120,7 @@ typedef struct lang_output_section_statement_struct
   union lang_statement_union *next;
   const char *name;
 
-  boolean processed;
+  bfd_boolean processed;
 
   asection *bfd_section;
   flagword flags;              /* Or together of all input sections */
@@ -134,39 +128,41 @@ typedef struct lang_output_section_statement_struct
   struct memory_region_struct *region;
   struct memory_region_struct *lma_region;
   size_t block_value;
-  fill_type fill;
+  fill_type *fill;
 
-  int subsection_alignment;  /* alignment of components */
-  int section_alignment;  /* alignment of start of section */
+  int subsection_alignment;    /* alignment of components */
+  int section_alignment;       /* alignment of start of section */
 
   union etree_union *load_base;
 
+  /* If non-null, an expression to evaluate after setting the section's
+     size.  The expression is evaluated inside REGION (above) with '.'
+     set to the end of the section.  Used in the last overlay section
+     to move '.' past all the overlaid sections.  */
+  union etree_union *update_dot_tree;
+
   struct lang_output_section_phdr_list *phdrs;
 } lang_output_section_statement_type;
 
-typedef struct
-{
+typedef struct {
   lang_statement_header_type header;
 } lang_common_statement_type;
 
-typedef struct
-{
+typedef struct {
   lang_statement_header_type header;
 } lang_object_symbols_statement_type;
 
-typedef struct
-{
+typedef struct {
   lang_statement_header_type header;
-  fill_type fill;
+  fill_type *fill;
   int size;
   asection *output_section;
 } lang_fill_statement_type;
 
-typedef struct
-{
+typedef struct {
   lang_statement_header_type header;
   unsigned int type;
-  union  etree_union *exp;
+  union etree_union *exp;
   bfd_vma value;
   asection *output_section;
   bfd_vma output_vma;
@@ -174,8 +170,7 @@ typedef struct
 
 /* Generate a reloc in the output file.  */
 
-typedef struct
-{
+typedef struct {
   lang_statement_header_type header;
 
   /* Reloc to generate.  */
@@ -205,8 +200,7 @@ typedef struct
   bfd_vma output_vma;
 } lang_reloc_statement_type;
 
-typedef struct lang_input_statement_struct
-{
+typedef struct lang_input_statement_struct {
   lang_statement_header_type header;
   /* Name of this file.  */
   const char *filename;
@@ -217,7 +211,7 @@ typedef struct lang_input_statement_struct
 
   bfd *the_bfd;
 
-  boolean closed;
+  bfd_boolean closed;
   file_ptr passive_position;
 
   /* Symbol table of the file.  */
@@ -227,75 +221,76 @@ typedef struct lang_input_statement_struct
   /* Point to the next file - whatever it is, wanders up and down
      archives */
 
-  union lang_statement_union  *next;
+  union lang_statement_union *next;
   /* Point to the next file, but skips archive contents */
-  union  lang_statement_union  *next_real_file;
+  union lang_statement_union *next_real_file;
 
-  boolean is_archive;
+  bfd_boolean is_archive;
 
   /* 1 means search a set of directories for this file.  */
-  boolean search_dirs_flag;
+  bfd_boolean search_dirs_flag;
+
+  /* 1 means this was found in a search directory marked as sysrooted,
+     if search_dirs_flag is false, otherwise, that it should be
+     searched in ld_sysroot before any other location, as long as it
+     starts with a slash.  */
+  bfd_boolean sysrooted;
 
   /* 1 means this is base file of incremental load.
      Do not load this file's text or data.
      Also default text_start to after this file's bss.  */
 
-  boolean just_syms_flag;
+  bfd_boolean just_syms_flag;
 
   /* Whether to search for this entry as a dynamic archive.  */
-  boolean dynamic;
+  bfd_boolean dynamic;
 
   /* Whether to include the entire contents of an archive.  */
-  boolean whole_archive;
+  bfd_boolean whole_archive;
 
-  boolean loaded;
+  bfd_boolean loaded;
 
-  /*    unsigned int globals_in_this_file;*/
+#if 0
+  unsigned int globals_in_this_file;
+#endif
   const char *target;
-  boolean real;
+  bfd_boolean real;
 } lang_input_statement_type;
 
-typedef struct
-{
+typedef struct {
   lang_statement_header_type header;
   asection *section;
   lang_input_statement_type *ifile;
 
 } lang_input_section_type;
 
-typedef struct
-{
+typedef struct {
   lang_statement_header_type header;
   asection *section;
   union lang_statement_union *file;
 } lang_afile_asection_pair_statement_type;
 
-typedef struct lang_wild_statement_struct
-{
+typedef struct lang_wild_statement_struct {
   lang_statement_header_type header;
-  const char *section_name;
-  boolean sections_sorted;
   const char *filename;
-  boolean filenames_sorted;
-  boolean keep_sections;
-  struct name_list *exclude_filename_list;
+  bfd_boolean filenames_sorted;
+  struct wildcard_list *section_list;
+  bfd_boolean keep_sections;
   lang_statement_list_type children;
 } lang_wild_statement_type;
 
-typedef struct lang_address_statement_struct
-{
+typedef struct lang_address_statement_struct {
   lang_statement_header_type header;
-  const  char *section_name;
-  union  etree_union *address;
+  const char *section_name;
+  union etree_union *address;
 } lang_address_statement_type;
 
-typedef struct
-{
+typedef struct {
   lang_statement_header_type header;
   bfd_vma output_offset;
   size_t size;
   asection *output_section;
-  fill_type fill;
+  fill_type *fill;
 } lang_padding_statement_type;
 
 /* A group statement collects a set of libraries together.  The
@@ -303,16 +298,13 @@ typedef struct
    symbols are found.  The effect is to search a group of libraries as
    though they were a single library.  */
 
-typedef struct
-{
+typedef struct {
   lang_statement_header_type header;
   lang_statement_list_type children;
 } lang_group_statement_type;
 
-typedef union lang_statement_union
-{
+typedef union lang_statement_union {
   lang_statement_header_type header;
-  union lang_statement_union *next;
   lang_wild_statement_type wild_statement;
   lang_data_statement_type data_statement;
   lang_reloc_statement_type reloc_statement;
@@ -334,13 +326,12 @@ typedef union lang_statement_union
 /* This structure holds information about a program header, from the
    PHDRS command in the linker script.  */
 
-struct lang_phdr
-{
+struct lang_phdr {
   struct lang_phdr *next;
   const char *name;
   unsigned long type;
-  boolean filehdr;
-  boolean phdrs;
+  bfd_boolean filehdr;
+  bfd_boolean phdrs;
   etree_type *at;
   etree_type *flags;
 };
@@ -348,143 +339,183 @@ struct lang_phdr
 /* This structure is used to hold a list of sections which may not
    cross reference each other.  */
 
-struct lang_nocrossref
-{
+struct lang_nocrossref {
   struct lang_nocrossref *next;
   const char *name;
 };
 
 /* The list of nocrossref lists.  */
 
-struct lang_nocrossrefs
-{
+struct lang_nocrossrefs {
   struct lang_nocrossrefs *next;
   struct lang_nocrossref *list;
 };
 
 extern struct lang_nocrossrefs *nocrossref_list;
 
+/* This structure is used to hold a list of input section names which
+   will not match an output section in the linker script.  */
+
+struct unique_sections {
+  struct unique_sections *next;
+  const char *name;
+};
+
+extern struct unique_sections *unique_section_list;
+
 extern lang_output_section_statement_type *abs_output_section;
 extern lang_statement_list_type lang_output_section_statement;
-extern boolean lang_has_input_file;
+extern bfd_boolean lang_has_input_file;
 extern etree_type *base;
 extern lang_statement_list_type *stat_ptr;
-extern boolean delete_output_file_on_failure;
+extern bfd_boolean delete_output_file_on_failure;
 
-extern const char *entry_symbol;
-extern boolean entry_from_cmdline;
+extern struct bfd_sym_chain entry_symbol;
+extern const char *entry_section;
+extern bfd_boolean entry_from_cmdline;
 extern lang_statement_list_type file_chain;
 
-extern void lang_init PARAMS ((void));
+extern void lang_init
+  (void);
 extern struct memory_region_struct *lang_memory_region_lookup
-  PARAMS ((const char *const));
+  (const char *const);
 extern struct memory_region_struct *lang_memory_region_default
-  PARAMS ((asection *));
-extern void lang_map PARAMS ((void));
-extern void lang_set_flags PARAMS ((lang_memory_region_type *, const char *,
-                                   int));
-extern void lang_add_output PARAMS ((const char *, int from_script));
+  (asection *);
+extern void lang_map
+  (void);
+extern void lang_set_flags
+  (lang_memory_region_type *, const char *, int);
+extern void lang_add_output
+  (const char *, int from_script);
 extern lang_output_section_statement_type *lang_enter_output_section_statement
-  PARAMS ((const char *output_section_statement_name,
-          etree_type * address_exp,
-          enum section_type sectype,
-          bfd_vma block_value,
-          etree_type *align,
-          etree_type *subalign,
-          etree_type *));
-extern void lang_final PARAMS ((void));
-extern void lang_process PARAMS ((void));
-extern void lang_section_start PARAMS ((const char *, union etree_union *));
-extern void lang_add_entry PARAMS ((const char *, boolean));
-extern void lang_add_target PARAMS ((const char *));
+  (const char *output_section_statement_name,
+   etree_type *address_exp,
+   enum section_type sectype,
+   bfd_vma block_value,
+   etree_type *align,
+   etree_type *subalign,
+   etree_type *);
+extern void lang_final
+  (void);
+extern void lang_process
+  (void);
+extern void lang_section_start
+  (const char *, union etree_union *);
+extern void lang_add_entry
+  (const char *, bfd_boolean);
+extern void lang_add_target
+  (const char *);
 extern void lang_add_wild
-  PARAMS ((const char *, boolean, const char *, boolean, boolean, name_list *));
-extern void lang_add_map PARAMS ((const char *));
-extern void lang_add_fill PARAMS ((int));
-extern lang_assignment_statement_type * lang_add_assignment PARAMS ((union etree_union *));
-extern void lang_add_attribute PARAMS ((enum statement_enum));
-extern void lang_startup PARAMS ((const char *));
-extern void lang_float PARAMS ((enum bfd_boolean));
+  (struct wildcard_spec *, struct wildcard_list *, bfd_boolean);
+extern void lang_add_map
+  (const char *);
+extern void lang_add_fill
+  (fill_type *);
+extern lang_assignment_statement_type *lang_add_assignment
+  (union etree_union *);
+extern void lang_add_attribute
+  (enum statement_enum);
+extern void lang_startup
+  (const char *);
+extern void lang_float
+  (bfd_boolean);
 extern void lang_leave_output_section_statement
-  PARAMS ((bfd_vma, const char *, struct lang_output_section_phdr_list *,
-           const char *));
-extern void lang_abs_symbol_at_end_of PARAMS ((const char *, const char *));
-extern void lang_abs_symbol_at_beginning_of PARAMS ((const char *,
-                                                    const char *));
-extern void lang_statement_append PARAMS ((struct statement_list *,
-                                          union lang_statement_union *,
-                                          union lang_statement_union **));
+  (fill_type *, const char *, struct lang_output_section_phdr_list *,
+   const char *);
+extern void lang_abs_symbol_at_end_of
+  (const char *, const char *);
+extern void lang_abs_symbol_at_beginning_of
+  (const char *, const char *);
+extern void lang_statement_append
+  (struct statement_list *, union lang_statement_union *,
+   union lang_statement_union **);
 extern void lang_for_each_input_file
-  PARAMS ((void (*dothis) (lang_input_statement_type *)));
+  (void (*dothis) (lang_input_statement_type *));
 extern void lang_for_each_file
-  PARAMS ((void (*dothis) (lang_input_statement_type *)));
+  (void (*dothis) (lang_input_statement_type *));
+extern void lang_reset_memory_regions
+  (void);
 extern bfd_vma lang_do_assignments
-  PARAMS ((lang_statement_union_type * s,
-          lang_output_section_statement_type *output_section_statement,
-          fill_type fill,
-          bfd_vma dot));
-
-#define LANG_FOR_EACH_INPUT_STATEMENT(statement)               \
-  lang_input_statement_type *statement;                                \
-  for (statement = (lang_input_statement_type *)file_chain.head;\
-       statement != (lang_input_statement_type *)NULL;         \
-       statement = (lang_input_statement_type *)statement->next)\
-
-extern void lang_process PARAMS ((void));
-extern void ldlang_add_file PARAMS ((lang_input_statement_type *));
+  (lang_statement_union_type *, lang_output_section_statement_type *,
+   fill_type *, bfd_vma);
+
+#define LANG_FOR_EACH_INPUT_STATEMENT(statement)                       \
+  lang_input_statement_type *statement;                                        \
+  for (statement = (lang_input_statement_type *) file_chain.head;      \
+       statement != (lang_input_statement_type *) NULL;                        \
+       statement = (lang_input_statement_type *) statement->next)      \
+
+extern void lang_process
+  (void);
+extern void ldlang_add_file
+  (lang_input_statement_type *);
 extern lang_output_section_statement_type *lang_output_section_find
-  PARAMS ((const char * const));
+  (const char * const);
 extern lang_input_statement_type *lang_add_input_file
-  PARAMS ((const char *name, lang_input_file_enum_type file_type,
-          const char *target));
-extern void lang_add_keepsyms_file PARAMS ((const char *filename));
+  (const char *, lang_input_file_enum_type, const char *);
+extern void lang_add_keepsyms_file
+  (const char *);
 extern lang_output_section_statement_type *
-  lang_output_section_statement_lookup PARAMS ((const char * const name));
-extern void ldlang_add_undef PARAMS ((const char *const name));
-extern void lang_add_output_format PARAMS ((const char *, const char *,
-                                           const char *, int from_script));
-extern void lang_list_init PARAMS ((lang_statement_list_type*));
-extern void lang_add_data PARAMS ((int type, union etree_union *));
+  lang_output_section_statement_lookup
+  (const char *const);
+extern void ldlang_add_undef
+  (const char *const);
+extern void lang_add_output_format
+  (const char *, const char *, const char *, int);
+extern void lang_list_init
+  (lang_statement_list_type *);
+extern void lang_add_data
+  (int type, union etree_union *);
 extern void lang_add_reloc
-  PARAMS ((bfd_reloc_code_real_type reloc, reloc_howto_type *howto,
-          asection *section, const char *name, union etree_union *addend));
+  (bfd_reloc_code_real_type, reloc_howto_type *, asection *, const char *,
+   union etree_union *);
 extern void lang_for_each_statement
-  PARAMS ((void (*func) (lang_statement_union_type *)));
-extern PTR stat_alloc PARAMS ((size_t size));
-extern void dprint_statement PARAMS ((lang_statement_union_type *, int));
+  (void (*) (lang_statement_union_type *));
+extern void *stat_alloc
+  (size_t);
+extern void dprint_statement
+  (lang_statement_union_type *, int);
 extern bfd_vma lang_size_sections
-  PARAMS ((lang_statement_union_type *s,
-          lang_output_section_statement_type *output_section_statement,
-          lang_statement_union_type **prev, fill_type fill,
-          bfd_vma dot, boolean relax));
-extern void lang_enter_group PARAMS ((void));
-extern void lang_leave_group PARAMS ((void));
-extern void wild_doit
-  PARAMS ((lang_statement_list_type *ptr, asection *section,
-          lang_output_section_statement_type *output,
-          lang_input_statement_type *file));
+  (lang_statement_union_type *, lang_output_section_statement_type *,
+   lang_statement_union_type **, fill_type *, bfd_vma, bfd_boolean *,
+   bfd_boolean);
+extern void lang_enter_group
+  (void);
+extern void lang_leave_group
+  (void);
+extern void lang_add_section
+  (lang_statement_list_type *, asection *,
+   lang_output_section_statement_type *, lang_input_statement_type *);
 extern void lang_new_phdr
-  PARAMS ((const char *, etree_type *, boolean, boolean, etree_type *,
-          etree_type *));
-extern void lang_add_nocrossref PARAMS ((struct lang_nocrossref *));
-extern void lang_enter_overlay PARAMS ((etree_type *, etree_type *, int));
-extern void lang_enter_overlay_section PARAMS ((const char *));
+  (const char *, etree_type *, bfd_boolean, bfd_boolean, etree_type *,
+   etree_type *);
+extern void lang_add_nocrossref
+  (struct lang_nocrossref *);
+extern void lang_enter_overlay
+  (etree_type *, etree_type *);
+extern void lang_enter_overlay_section
+  (const char *);
 extern void lang_leave_overlay_section
-  PARAMS ((bfd_vma, struct lang_output_section_phdr_list *));
+  (fill_type *, struct lang_output_section_phdr_list *);
 extern void lang_leave_overlay
-  PARAMS ((bfd_vma, const char *, struct lang_output_section_phdr_list *,
-           const char *));
+  (etree_type *, int, fill_type *, const char *,
+   struct lang_output_section_phdr_list *, const char *);
 
 extern struct bfd_elf_version_tree *lang_elf_version_info;
 
-extern struct bfd_elf_version_expr *lang_new_vers_regex
-  PARAMS ((struct bfd_elf_version_expr *, const char *, const char *));
+extern struct bfd_elf_version_expr *lang_new_vers_pattern
+  (struct bfd_elf_version_expr *, const char *, const char *);
 extern struct bfd_elf_version_tree *lang_new_vers_node
-  PARAMS ((struct bfd_elf_version_expr *, struct bfd_elf_version_expr *));
+  (struct bfd_elf_version_expr *, struct bfd_elf_version_expr *);
 extern struct bfd_elf_version_deps *lang_add_vers_depend
-  PARAMS ((struct bfd_elf_version_deps *, const char *));
+  (struct bfd_elf_version_deps *, const char *);
 extern void lang_register_vers_node
-  PARAMS ((const char *, struct bfd_elf_version_tree *,
-          struct bfd_elf_version_deps *));
+  (const char *, struct bfd_elf_version_tree *, struct bfd_elf_version_deps *);
+bfd_boolean unique_section_p
+  (const char *);
+extern void lang_add_unique
+  (const char *);
+extern const char *lang_get_output_target
+  (void);
 
 #endif