contrib/binutils/ld/ld.h

   1 /* ld.h -- general linker header file
   2    Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000
   3    Free Software Foundation, Inc.
   4
   5    This file is part of GLD, the Gnu Linker.
   6
   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 2, or (at your option)
  10    any later version.
  11
  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.
  16
  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
  20    02111-1307, USA.  */
  21
  22 #ifndef LD_H
  23 #define LD_H
  24
  25 #ifdef HAVE_LOCALE_H
  26 # include <locale.h>
  27 #endif
  28
  29 #ifdef ENABLE_NLS
  30 # include <libintl.h>
  31 # define _(String) gettext (String)
  32 # ifdef gettext_noop
  33 #  define N_(String) gettext_noop (String)
  34 # else
  35 #  define N_(String) (String)
  36 # endif
  37 #else
  38 # define gettext(Msgid) (Msgid)
  39 # define dgettext(Domainname, Msgid) (Msgid)
  40 # define dcgettext(Domainname, Msgid, Category) (Msgid)
  41 # define textdomain(Domainname) while (0) /* nothing */
  42 # define bindtextdomain(Domainname, Dirname) while (0) /* nothing */
  43 # define _(String) (String)
  44 # define N_(String) (String)
  45 #endif
  46
  47 #include "bin-bugs.h"
  48
  49 /* Look in this environment name for the linker to pretend to be */
  50 #define EMULATION_ENVIRON "LDEMULATION"
  51 /* If in there look for the strings: */
  52
  53 /* Look in this variable for a target format */
  54 #define TARGET_ENVIRON "GNUTARGET"
  55
  56 /* Input sections which are put in a section of this name are actually
  57    discarded.  */
  58 #define DISCARD_SECTION_NAME "/DISCARD/"
  59
  60 /* A file name list */
  61 typedef struct name_list {
  62   const char *name;
  63   struct name_list *next;
  64 }
  65 name_list;
  66
  67 /* A wildcard specification.  This is only used in ldgram.y, but it
  68    winds up in ldgram.h, so we need to define it outside.  */
  69
  70 struct wildcard_spec {
  71   const char *name;
  72   struct name_list *exclude_name_list;
  73   boolean sorted;
  74 };
  75
  76 struct wildcard_list {
  77   struct wildcard_list *next;
  78   struct wildcard_spec spec;
  79 };
  80
  81 /* Extra information we hold on sections */
  82 typedef struct user_section_struct {
  83   /* Pointer to the section where this data will go */
  84   struct lang_input_statement_struct *file;
  85 } section_userdata_type;
  86
  87 #define get_userdata(x) ((x)->userdata)
  88
  89 #define BYTE_SIZE       (1)
  90 #define SHORT_SIZE      (2)
  91 #define LONG_SIZE       (4)
  92 #define QUAD_SIZE       (8)
  93
  94 /* ALIGN macro changed to ALIGN_N to avoid      */
  95 /* conflict in /usr/include/machine/machparam.h */
  96 /* WARNING: If THIS is a 64 bit address and BOUNDARY is a 32 bit int,
  97    you must coerce boundary to the same type as THIS.
  98    ??? Is there a portable way to avoid this.  */
  99 #define ALIGN_N(this, boundary) \
 100   ((( (this) + ((boundary) -1)) & (~((boundary)-1))))
 101
 102 typedef struct {
 103   /* 1 => assign space to common symbols even if `relocatable_output'.  */
 104   boolean force_common_definition;
 105
 106   /* 1 => do not assign addresses to common symbols. */
 107   boolean inhibit_common_definition;
 108   boolean relax;
 109
 110   /* Name of runtime interpreter to invoke.  */
 111   char *interpreter;
 112
 113   /* Name to give runtime libary from the -soname argument.  */
 114   char *soname;
 115
 116   /* Runtime library search path from the -rpath argument.  */
 117   char *rpath;
 118
 119   /* Link time runtime library search path from the -rpath-link
 120      argument.  */
 121   char *rpath_link;
 122
 123   /* Big or little endian as set on command line.  */
 124   enum { ENDIAN_UNSET = 0, ENDIAN_BIG, ENDIAN_LITTLE } endian;
 125
 126   /* If true, build MIPS embedded PIC relocation tables in the output
 127      file.  */
 128   boolean embedded_relocs;
 129
 130   /* If true, force generation of a file with a .exe file.  */
 131   boolean force_exe_suffix;
 132
 133   /* If true, generate a cross reference report.  */
 134   boolean cref;
 135
 136   /* If true (which is the default), warn about mismatched input
 137      files.  */
 138   boolean warn_mismatch;
 139
 140   /* Remove unreferenced sections?  */
 141   boolean gc_sections;
 142
 143   /* Name of shared object whose symbol table should be filtered with
 144      this shared object.  From the --filter option.  */
 145   char *filter_shlib;
 146
 147   /* Name of shared object for whose symbol table this shared object
 148      is an auxiliary filter.  From the --auxiliary option.  */
 149   char **auxiliary_filters;
 150
 151   /* A version symbol to be applied to the symbol names found in the
 152      .exports sections.  */
 153   char *version_exports_section;
 154
 155   /* If true (the default) check section addresses, once compute,
 156      fpor overlaps.  */
 157   boolean check_section_addresses;
 158
 159 } args_type;
 160
 161 extern args_type command_line;
 162
 163 typedef int token_code_type;
 164
 165 typedef struct {
 166   bfd_size_type specified_data_size;
 167   boolean magic_demand_paged;
 168   boolean make_executable;
 169
 170   /* If true, doing a dynamic link.  */
 171   boolean dynamic_link;
 172
 173   /* If true, -shared is supported.  */
 174   /* ??? A better way to do this is perhaps to define this in the
 175      ld_emulation_xfer_struct since this is really a target dependent
 176      parameter.  */
 177   boolean has_shared;
 178
 179   /* If true, build constructors.  */
 180   boolean build_constructors;
 181
 182   /* If true, warn about any constructors.  */
 183   boolean warn_constructors;
 184
 185   /* If true, warn about merging common symbols with others.  */
 186   boolean warn_common;
 187
 188   /* If true, only warn once about a particular undefined symbol.  */
 189   boolean warn_once;
 190
 191   /* If true, warn if multiple global-pointers are needed (Alpha
 192      only).  */
 193   boolean warn_multiple_gp;
 194
 195   /* If true, warn if the starting address of an output section
 196      changes due to the alignment of an input section.  */
 197   boolean warn_section_align;
 198
 199   /* If true, warning messages are fatal */
 200   boolean fatal_warnings;
 201
 202   boolean sort_common;
 203
 204   boolean text_read_only;
 205
 206   char *map_filename;
 207   FILE *map_file;
 208
 209   boolean stats;
 210
 211   /* If set, orphan input sections will be mapped to separate output
 212      sections.  */
 213   boolean unique_orphan_sections;
 214
 215   unsigned int split_by_reloc;
 216   bfd_size_type split_by_file;
 217
 218   /* If set, only search library directories explicitly selected
 219      on the command line.  */
 220   boolean only_cmd_line_lib_dirs;
 221 } ld_config_type;
 222
 223 extern ld_config_type config;
 224
 225 typedef enum {
 226   lang_first_phase_enum,
 227   lang_allocating_phase_enum,
 228   lang_final_phase_enum
 229 } lang_phase_type;
 230
 231 extern FILE * saved_script_handle;
 232 extern boolean force_make_executable;
 233
 234 /* Non-zero if we are processing a --defsym from the command line.  */
 235 extern int parsing_defsym;
 236
 237 extern int yyparse PARAMS ((void));
 238
 239 extern void add_cref PARAMS ((const char *, bfd *, asection *, bfd_vma));
 240 extern void output_cref PARAMS ((FILE *));
 241 extern void check_nocrossrefs PARAMS ((void));
 242
 243 extern void ld_abort PARAMS ((const char *, int, const char *))
 244      ATTRIBUTE_NORETURN;
 245
 246 /* If gcc >= 2.6, we can give a function name, too.  */
 247 #if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 6)
 248 #define __PRETTY_FUNCTION__  ((char*) NULL)
 249 #endif
 250
 251 #undef abort
 252 #define abort() ld_abort (__FILE__, __LINE__, __PRETTY_FUNCTION__)
 253
 254 #endif