2012-02-15 Pedro Alves <palves@redhat.com>
[deliverable/binutils-gdb.git] / ld / ld.h
diff --git a/ld/ld.h b/ld/ld.h
index 3be5b5dc187ff4807f8f6da10ed2ab19ed270aaf..a18b265eb85838ff3e32dfdf46a6b34f0a3df23e 100644 (file)
--- a/ld/ld.h
+++ b/ld/ld.h
-/* ld.h -
+/* ld.h -- general linker header file
+   Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
+   2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
+   Free Software Foundation, Inc.
 
-   Copyright (C) 1991, 1993 Free Software Foundation, Inc.
+   This file is part of the GNU Binutils.
 
-   This file is part of GLD, the Gnu Linker.
-
-   GLD is free software; you can redistribute it and/or modify
+   This program 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 2, or (at your option)
-   any later version.
+   the Free Software Foundation; either version 3 of the License, or
+   (at your option) any later version.
 
-   GLD is distributed in the hope that it will be useful,
+   This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
 
    You should have received a copy of the GNU General Public License
-   along with GLD; see the file COPYING.  If not, write to
-   the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  */
-
-
-#define flag_is_not_at_end(x) ((x) & BSF_NOT_AT_END)
-#define flag_is_ordinary_local(x) (((x) & (BSF_LOCAL))&!((x) & (BSF_DEBUGGING)))
-#define flag_is_debugger(x) ((x) & BSF_DEBUGGING)
-#define flag_is_undefined_or_global(x) ((x) & (BSF_UNDEFINED | BSF_GLOBAL))
-#define flag_is_defined(x) (!((x) & (BSF_UNDEFINED)))
-#define flag_is_global_or_common(x) ((x) & (BSF_GLOBAL | BSF_FORT_COMM))
-#define flag_is_undefined_or_global_or_common(x) ((x) & (BSF_UNDEFINED | BSF_GLOBAL | BSF_FORT_COMM))
-#define flag_is_undefined_or_global_or_common_or_constructor(x) ((x) & (BSF_UNDEFINED | BSF_GLOBAL | BSF_FORT_COMM | BSF_CONSTRUCTOR))
-#define flag_is_constructor(x) ((x) & BSF_CONSTRUCTOR)
-#define flag_is_common(x) ((x) & BSF_FORT_COMM)
-#define flag_is_global(x) ((x) & (BSF_GLOBAL))
-#define flag_is_undefined(x) ((x) & BSF_UNDEFINED)
-#define flag_set(x,y) (x = y)
-#define flag_is_fort_comm(x) ((x) & BSF_FORT_COMM)
-#define flag_is_absolute(x) ((x) & BSF_ABSOLUTE)
-/* Extra information we hold on sections */
-typedef struct  user_section_struct {
-  /* Pointer to the section where this data will go */
-  struct lang_input_statement_struct *file;
-} section_userdata_type;
+   along with this program; if not, write to the Free Software
+   Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
+   MA 02110-1301, USA.  */
+
+#ifndef LD_H
+#define LD_H
+
+#ifdef HAVE_LOCALE_H
+#endif
+#ifndef SEEK_CUR
+#define SEEK_CUR 1
+#endif
+#ifndef SEEK_END
+#define SEEK_END 2
+#endif
+
+#ifdef HAVE_LOCALE_H
+# ifndef ENABLE_NLS
+   /* The Solaris version of locale.h always includes libintl.h.  If we have
+      been configured with --disable-nls then ENABLE_NLS will not be defined
+      and the dummy definitions of bindtextdomain (et al) below will conflict
+      with the defintions in libintl.h.  So we define these values to prevent
+      the bogus inclusion of libintl.h.  */
+#  define _LIBINTL_H
+#  define _LIBGETTEXT_H
+# endif
+# include <locale.h>
+#endif
+
+#ifdef ENABLE_NLS
+# include <libintl.h>
+# define _(String) gettext (String)
+# ifdef gettext_noop
+#  define N_(String) gettext_noop (String)
+# else
+#  define N_(String) (String)
+# endif
+#else
+# define gettext(Msgid) (Msgid)
+# define dgettext(Domainname, Msgid) (Msgid)
+# define dcgettext(Domainname, Msgid, Category) (Msgid)
+# define textdomain(Domainname) while (0) /* nothing */
+# define bindtextdomain(Domainname, Dirname) while (0) /* nothing */
+# define _(String) (String)
+# define N_(String) (String)
+#endif
+
+/* Look in this environment name for the linker to pretend to be */
+#define EMULATION_ENVIRON "LDEMULATION"
+/* If in there look for the strings: */
+
+/* Look in this variable for a target format */
+#define TARGET_ENVIRON "GNUTARGET"
+
+/* Input sections which are put in a section of this name are actually
+   discarded.  */
+#define DISCARD_SECTION_NAME "/DISCARD/"
+
+/* A file name list */
+typedef struct name_list {
+  const char *name;
+  struct name_list *next;
+}
+name_list;
+
+typedef enum {sort_none, sort_ascending, sort_descending} sort_order;
+  
+/* A wildcard specification.  */
 
+typedef enum {
+  none, by_name, by_alignment, by_name_alignment, by_alignment_name,
+  by_init_priority
+} sort_type;
+
+extern sort_type sort_section;
+
+struct wildcard_spec {
+  const char *name;
+  struct name_list *exclude_name_list;
+  sort_type sorted;
+  struct flag_info *section_flag_list;
+};
+
+struct wildcard_list {
+  struct wildcard_list *next;
+  struct wildcard_spec spec;
+};
+
+struct map_symbol_def {
+  struct bfd_link_hash_entry *entry;
+  struct map_symbol_def *next;
+};
+
+/* The initial part of fat_user_section_struct has to be idential with
+   lean_user_section_struct.  */
+typedef struct fat_user_section_struct {
+  /* For input sections, when writing a map file: head / tail of a linked
+     list of hash table entries for symbols defined in this section.  */
+  struct map_symbol_def *map_symbol_def_head;
+  struct map_symbol_def **map_symbol_def_tail;
+  unsigned long map_symbol_def_count;
+} fat_section_userdata_type;
 
 #define get_userdata(x) ((x)->userdata)
-#define as_output_section_statement(x) ((x)->otheruserdata)
 
+#define BYTE_SIZE      (1)
+#define SHORT_SIZE     (2)
+#define LONG_SIZE      (4)
+#define QUAD_SIZE      (8)
 
+enum endian_enum { ENDIAN_UNSET = 0, ENDIAN_BIG, ENDIAN_LITTLE };
 
-/* Which symbols should be stripped (omitted from the output):
-   none, all, or debugger symbols.  */
-typedef  enum { STRIP_NONE, STRIP_ALL, STRIP_DEBUGGER, STRIP_SOME } strip_symbols_type;
+enum symbolic_enum
+  {
+    symbolic_unset = 0,
+    symbolic,
+    symbolic_functions,
+  };
 
+enum dynamic_list_enum
+  {
+    dynamic_list_unset = 0,
+    dynamic_list_data,
+    dynamic_list
+  };
 
+typedef struct {
+  /* 1 => assign space to common symbols even if `relocatable_output'.  */
+  bfd_boolean force_common_definition;
 
+  /* 1 => do not assign addresses to common symbols.  */
+  bfd_boolean inhibit_common_definition;
 
-/* Which local symbols should be omitted:
-   none, all, or those starting with L.
-   This is irrelevant if STRIP_NONE.  */
-typedef  enum { DISCARD_NONE, DISCARD_ALL, DISCARD_L } discard_locals_type;
+  /* Enable or disable target specific optimizations.
 
+     Not all targets have optimizations to enable.
 
-#define BYTE_SIZE      (1)
-#define SHORT_SIZE     (2)
-#define LONG_SIZE      (4)
+     Normally these optimizations are disabled by default but some targets
+     prefer to enable them by default.  So this field is a tri-state variable.
+     The values are:
+     
+     zero: Enable the optimizations (either from --relax being specified on
+       the command line or the backend's before_allocation emulation function.
+       
+     positive: The user has requested that these optimizations be disabled.
+       (Via the --no-relax command line option).
 
-/* ALIGN macro changed to ALIGN_N to avoid     */
-/* conflict in /usr/include/machine/machparam.h */
-#define ALIGN_N(this, boundary)  ((( (this) + ((boundary) -1)) & (~((boundary)-1))))
+     negative: The optimizations are disabled.  (Set when initializing the
+       args_type structure in ldmain.c:main.  */
+  signed int disable_target_specific_optimizations;
+#define RELAXATION_DISABLED_BY_DEFAULT (command_line.disable_target_specific_optimizations < 0)
+#define RELAXATION_DISABLED_BY_USER    (command_line.disable_target_specific_optimizations > 0)
+#define RELAXATION_ENABLED (command_line.disable_target_specific_optimizations == 0)
+#define DISABLE_RELAXATION do { command_line.disable_target_specific_optimizations = 1; } while (0)
+#define ENABLE_RELAXATION  do { command_line.disable_target_specific_optimizations = 0; } while (0)
 
-typedef struct {
-  /* 1 => assign space to common symbols even if `relocatable_output'.  */
-  boolean force_common_definition;
-  boolean relax;
-  
+  /* If TRUE, build MIPS embedded PIC relocation tables in the output
+     file.  */
+  bfd_boolean embedded_relocs;
+
+  /* If TRUE, force generation of a file with a .exe file.  */
+  bfd_boolean force_exe_suffix;
+
+  /* If TRUE, generate a cross reference report.  */
+  bfd_boolean cref;
+
+  /* If TRUE (which is the default), warn about mismatched input
+     files.  */
+  bfd_boolean warn_mismatch;
+
+  /* Warn on attempting to open an incompatible library during a library
+     search.  */
+  bfd_boolean warn_search_mismatch;
+
+  /* If non-zero check section addresses, once computed,
+     for overlaps.  Relocatable links only check when this is > 0.  */
+  signed char check_section_addresses;
+
+  /* If TRUE allow the linking of input files in an unknown architecture
+     assuming that the user knows what they are doing.  This was the old
+     behaviour of the linker.  The new default behaviour is to reject such
+     input files.  */
+  bfd_boolean accept_unknown_input_arch;
+
+  /* If TRUE we'll just print the default output on stdout.  */
+  bfd_boolean print_output_format;
+
+  /* Big or little endian as set on command line.  */
+  enum endian_enum endian;
+
+  /* -Bsymbolic and -Bsymbolic-functions, as set on command line.  */
+  enum symbolic_enum symbolic;
+
+  /* --dynamic-list, --dynamic-list-cpp-new, --dynamic-list-cpp-typeinfo
+     and --dynamic-list FILE, as set on command line.  */
+  enum dynamic_list_enum dynamic_list;
+
+  /* Name of runtime interpreter to invoke.  */
+  char *interpreter;
+
+  /* Name to give runtime libary from the -soname argument.  */
+  char *soname;
+
+  /* Runtime library search path from the -rpath argument.  */
+  char *rpath;
+
+  /* Link time runtime library search path from the -rpath-link
+     argument.  */
+  char *rpath_link;
+
+  /* Name of shared object whose symbol table should be filtered with
+     this shared object.  From the --filter option.  */
+  char *filter_shlib;
+
+  /* Name of shared object for whose symbol table this shared object
+     is an auxiliary filter.  From the --auxiliary option.  */
+  char **auxiliary_filters;
+
+  /* A version symbol to be applied to the symbol names found in the
+     .exports sections.  */
+  char *version_exports_section;
+
+  /* Default linker script.  */
+  char *default_script;
 } args_type;
 
+extern args_type command_line;
+
 typedef int token_code_type;
 
-typedef struct 
-{
-  bfd_size_type specified_data_size;
-  boolean magic_demand_paged;
-  boolean make_executable;
-  /* 1 => write relocation into output file so can re-input it later.  */
-  boolean relocateable_output;
+typedef struct {
+  bfd_boolean magic_demand_paged;
+  bfd_boolean make_executable;
 
-  /* Will we build contstructors, or leave alone ? */
-  boolean build_constructors;
+  /* If TRUE, doing a dynamic link.  */
+  bfd_boolean dynamic_link;
 
-  /* If true, warn about merging common symbols with others.  */
-  boolean warn_common;
+  /* If TRUE, -shared is supported.  */
+  /* ??? A better way to do this is perhaps to define this in the
+     ld_emulation_xfer_struct since this is really a target dependent
+     parameter.  */
+  bfd_boolean has_shared;
 
-  boolean sort_common;
-/* these flags may seem mutually exclusive, but not setting them
-   allows the back end to decide what would be the best thing to do */
-  boolean text_read_only;
+  /* If TRUE, build constructors.  */
+  bfd_boolean build_constructors;
 
-   char *map_filename;
-   FILE *map_file;
+  /* If TRUE, warn about any constructors.  */
+  bfd_boolean warn_constructors;
 
-} ld_config_type;
-#define set_asymbol_chain(x,y) ((x)->udata = (PTR)y)
-#define get_asymbol_chain(x) ((asymbol **)((x)->udata))
-#define get_loader_symbol(x) ((loader_global_asymbol *)((x)->udata))
-#define set_loader_symbol(x,y) ((x)->udata = (PTR)y)
+  /* If TRUE, warn about merging common symbols with others.  */
+  bfd_boolean warn_common;
 
+  /* If TRUE, only warn once about a particular undefined symbol.  */
+  bfd_boolean warn_once;
 
+  /* If TRUE, warn if multiple global-pointers are needed (Alpha
+     only).  */
+  bfd_boolean warn_multiple_gp;
 
+  /* If TRUE, warn if the starting address of an output section
+     changes due to the alignment of an input section.  */
+  bfd_boolean warn_section_align;
 
+  /* If TRUE, warning messages are fatal */
+  bfd_boolean fatal_warnings;
 
+  sort_order sort_common;
 
-typedef enum {
-  lang_first_phase_enum,
-  lang_allocating_phase_enum,
-  lang_final_phase_enum } lang_phase_type;
+  bfd_boolean text_read_only;
+
+  bfd_boolean stats;
+
+  /* If set, orphan input sections will be mapped to separate output
+     sections.  */
+  bfd_boolean unique_orphan_sections;
+
+  /* If set, only search library directories explicitly selected
+     on the command line.  */
+  bfd_boolean only_cmd_line_lib_dirs;
+
+  /* If set, numbers and absolute symbols are simply treated as
+     numbers everywhere.  */
+  bfd_boolean sane_expr;
+
+  /* The rpath separation character.  Usually ':'.  */
+  char rpath_separator;
+
+  char *map_filename;
+  FILE *map_file;
+
+  unsigned int split_by_reloc;
+  bfd_size_type split_by_file;
+
+  bfd_size_type specified_data_size;
+
+  /* The size of the hash table to use.  */
+  unsigned long hash_table_size;
+
+  /* The maximum page size for ELF.  */
+  bfd_vma maxpagesize;
+
+  /* The common page size for ELF.  */
+  bfd_vma commonpagesize;
+} ld_config_type;
+
+extern ld_config_type config;
+
+extern FILE * saved_script_handle;
+extern bfd_boolean force_make_executable;
 
+/* Non-zero if we are processing a --defsym from the command line.  */
+extern int parsing_defsym;
 
+extern int yyparse (void);
+extern void add_cref (const char *, bfd *, asection *, bfd_vma);
+extern bfd_boolean handle_asneeded_cref (bfd *, enum notice_asneeded_action);
+extern void output_cref (FILE *);
+extern void check_nocrossrefs (void);
+extern void ld_abort (const char *, int, const char *) ATTRIBUTE_NORETURN;
 
+/* If gcc >= 2.6, we can give a function name, too.  */
+#if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 6)
+#define __PRETTY_FUNCTION__  NULL
+#endif
 
+#undef abort
+#define abort() ld_abort (__FILE__, __LINE__, __PRETTY_FUNCTION__)
 
-int yyparse();
-#define BYTE_SIZE 1
-#define SHORT_SIZE 2
-#define LONG_SIZE 4
+#endif
This page took 0.027662 seconds and 4 git commands to generate.