1 /* ld.h -- general linker header file 2 Copyright (C) 1991-2016 Free Software Foundation, Inc. 3 4 This file is part of the GNU Binutils. 5 6 This program is free software; you can redistribute it and/or modify 7 it under the terms of the GNU General Public License as published by 8 the Free Software Foundation; either version 3 of the License, or 9 (at your option) any later version. 10 11 This program is distributed in the hope that it will be useful, 12 but WITHOUT ANY WARRANTY; without even the implied warranty of 13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 GNU General Public License for more details. 15 16 You should have received a copy of the GNU General Public License 17 along with this program; if not, write to the Free Software 18 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, 19 MA 02110-1301, USA. */ 20 21 #ifndef LD_H 22 #define LD_H 23 24 #ifdef HAVE_LOCALE_H 25 #endif 26 #ifndef SEEK_CUR 27 #define SEEK_CUR 1 28 #endif 29 #ifndef SEEK_END 30 #define SEEK_END 2 31 #endif 32 33 #ifdef HAVE_LOCALE_H 34 # ifndef ENABLE_NLS 35 /* The Solaris version of locale.h always includes libintl.h. If we have 36 been configured with --disable-nls then ENABLE_NLS will not be defined 37 and the dummy definitions of bindtextdomain (et al) below will conflict 38 with the defintions in libintl.h. So we define these values to prevent 39 the bogus inclusion of libintl.h. */ 40 # define _LIBINTL_H 41 # define _LIBGETTEXT_H 42 # endif 43 # include <locale.h> 44 #endif 45 46 #ifdef ENABLE_NLS 47 # include <libintl.h> 48 # define _(String) gettext (String) 49 # ifdef gettext_noop 50 # define N_(String) gettext_noop (String) 51 # else 52 # define N_(String) (String) 53 # endif 54 #else 55 # define gettext(Msgid) (Msgid) 56 # define dgettext(Domainname, Msgid) (Msgid) 57 # define dcgettext(Domainname, Msgid, Category) (Msgid) 58 # define textdomain(Domainname) while (0) /* nothing */ 59 # define bindtextdomain(Domainname, Dirname) while (0) /* nothing */ 60 # define _(String) (String) 61 # define N_(String) (String) 62 #endif 63 64 /* Look in this environment name for the linker to pretend to be */ 65 #define EMULATION_ENVIRON "LDEMULATION" 66 /* If in there look for the strings: */ 67 68 /* Look in this variable for a target format */ 69 #define TARGET_ENVIRON "GNUTARGET" 70 71 /* Input sections which are put in a section of this name are actually 72 discarded. */ 73 #define DISCARD_SECTION_NAME "/DISCARD/" 74 75 /* A file name list. */ 76 typedef struct name_list 77 { 78 const char *name; 79 struct name_list *next; 80 } 81 name_list; 82 83 typedef enum {sort_none, sort_ascending, sort_descending} sort_order; 84 85 /* A wildcard specification. */ 86 87 typedef enum 88 { 89 none, by_name, by_alignment, by_name_alignment, by_alignment_name, 90 by_none, by_init_priority 91 } sort_type; 92 93 extern sort_type sort_section; 94 95 struct wildcard_spec 96 { 97 const char *name; 98 struct name_list *exclude_name_list; 99 sort_type sorted; 100 struct flag_info *section_flag_list; 101 }; 102 103 struct wildcard_list 104 { 105 struct wildcard_list *next; 106 struct wildcard_spec spec; 107 }; 108 109 #define BYTE_SIZE (1) 110 #define SHORT_SIZE (2) 111 #define LONG_SIZE (4) 112 #define QUAD_SIZE (8) 113 114 enum endian_enum { ENDIAN_UNSET = 0, ENDIAN_BIG, ENDIAN_LITTLE }; 115 116 enum symbolic_enum 117 { 118 symbolic_unset = 0, 119 symbolic, 120 symbolic_functions, 121 }; 122 123 enum dynamic_list_enum 124 { 125 dynamic_list_unset = 0, 126 dynamic_list_data, 127 dynamic_list 128 }; 129 130 typedef struct 131 { 132 /* 1 => assign space to common symbols even if `relocatable_output'. */ 133 bfd_boolean force_common_definition; 134 135 /* 1 => do not assign addresses to common symbols. */ 136 bfd_boolean inhibit_common_definition; 137 138 /* If TRUE, build MIPS embedded PIC relocation tables in the output 139 file. */ 140 bfd_boolean embedded_relocs; 141 142 /* If TRUE, force generation of a file with a .exe file. */ 143 bfd_boolean force_exe_suffix; 144 145 /* If TRUE, generate a cross reference report. */ 146 bfd_boolean cref; 147 148 /* If TRUE (which is the default), warn about mismatched input 149 files. */ 150 bfd_boolean warn_mismatch; 151 152 /* Warn on attempting to open an incompatible library during a library 153 search. */ 154 bfd_boolean warn_search_mismatch; 155 156 /* If non-zero check section addresses, once computed, 157 for overlaps. Relocatable links only check when this is > 0. */ 158 signed char check_section_addresses; 159 160 /* If TRUE allow the linking of input files in an unknown architecture 161 assuming that the user knows what they are doing. This was the old 162 behaviour of the linker. The new default behaviour is to reject such 163 input files. */ 164 bfd_boolean accept_unknown_input_arch; 165 166 /* If TRUE we'll just print the default output on stdout. */ 167 bfd_boolean print_output_format; 168 169 /* If set, display the target memory usage (per memory region). */ 170 bfd_boolean print_memory_usage; 171 172 /* If TRUE warn for uses of system directories when cross linking. */ 173 bfd_boolean warn_poison_system_directories; 174 175 /* If TRUE (default FALSE) give an error for uses of system 176 directories when cross linking instead of a warning. */ 177 bfd_boolean error_poison_system_directories; 178 179 /* Big or little endian as set on command line. */ 180 enum endian_enum endian; 181 182 /* -Bsymbolic and -Bsymbolic-functions, as set on command line. */ 183 enum symbolic_enum symbolic; 184 185 /* --dynamic-list, --dynamic-list-cpp-new, --dynamic-list-cpp-typeinfo 186 and --dynamic-list FILE, as set on command line. */ 187 enum dynamic_list_enum dynamic_list; 188 189 /* Name of runtime interpreter to invoke. */ 190 char *interpreter; 191 192 /* Name to give runtime libary from the -soname argument. */ 193 char *soname; 194 195 /* Runtime library search path from the -rpath argument. */ 196 char *rpath; 197 198 /* Link time runtime library search path from the -rpath-link 199 argument. */ 200 char *rpath_link; 201 202 /* Name of shared object whose symbol table should be filtered with 203 this shared object. From the --filter option. */ 204 char *filter_shlib; 205 206 /* Name of shared object for whose symbol table this shared object 207 is an auxiliary filter. From the --auxiliary option. */ 208 char **auxiliary_filters; 209 210 /* A version symbol to be applied to the symbol names found in the 211 .exports sections. */ 212 char *version_exports_section; 213 214 /* Default linker script. */ 215 char *default_script; 216 } args_type; 217 218 extern args_type command_line; 219 220 typedef int token_code_type; 221 222 /* Different ways we can handle orphan sections. */ 223 224 enum orphan_handling_enum 225 { 226 /* The classic strategy, find a suitable section to place the orphan 227 into. */ 228 orphan_handling_place = 0, 229 230 /* Discard any orphan sections as though they were assign to the section 231 /DISCARD/. */ 232 orphan_handling_discard, 233 234 /* Find somewhere to place the orphan section, as with 235 ORPHAN_HANDLING_PLACE, but also issue a warning. */ 236 orphan_handling_warn, 237 238 /* Issue a fatal error if any orphan sections are found. */ 239 orphan_handling_error, 240 }; 241 242 typedef struct 243 { 244 bfd_boolean magic_demand_paged; 245 bfd_boolean make_executable; 246 247 /* If TRUE, -shared is supported. */ 248 /* ??? A better way to do this is perhaps to define this in the 249 ld_emulation_xfer_struct since this is really a target dependent 250 parameter. */ 251 bfd_boolean has_shared; 252 253 /* If TRUE, build constructors. */ 254 bfd_boolean build_constructors; 255 256 /* If TRUE, warn about any constructors. */ 257 bfd_boolean warn_constructors; 258 259 /* If TRUE, warn about merging common symbols with others. */ 260 bfd_boolean warn_common; 261 262 /* If TRUE, only warn once about a particular undefined symbol. */ 263 bfd_boolean warn_once; 264 265 /* How should we deal with orphan sections. */ 266 enum orphan_handling_enum orphan_handling; 267 268 /* If TRUE, warn if multiple global-pointers are needed (Alpha 269 only). */ 270 bfd_boolean warn_multiple_gp; 271 272 /* If TRUE, warn if the starting address of an output section 273 changes due to the alignment of an input section. */ 274 bfd_boolean warn_section_align; 275 276 /* If TRUE, warning messages are fatal */ 277 bfd_boolean fatal_warnings; 278 279 sort_order sort_common; 280 281 bfd_boolean text_read_only; 282 283 bfd_boolean stats; 284 285 /* If set, orphan input sections will be mapped to separate output 286 sections. */ 287 bfd_boolean unique_orphan_sections; 288 289 /* If set, only search library directories explicitly selected 290 on the command line. */ 291 bfd_boolean only_cmd_line_lib_dirs; 292 293 /* If set, numbers and absolute symbols are simply treated as 294 numbers everywhere. */ 295 bfd_boolean sane_expr; 296 297 /* If set, code and non-code sections should never be in one segment. */ 298 bfd_boolean separate_code; 299 300 /* The rpath separation character. Usually ':'. */ 301 char rpath_separator; 302 303 char *map_filename; 304 FILE *map_file; 305 306 unsigned int split_by_reloc; 307 bfd_size_type split_by_file; 308 309 /* The size of the hash table to use. */ 310 unsigned long hash_table_size; 311 312 /* The maximum page size for ELF. */ 313 bfd_vma maxpagesize; 314 315 /* The common page size for ELF. */ 316 bfd_vma commonpagesize; 317 } ld_config_type; 318 319 extern ld_config_type config; 320 321 extern FILE * saved_script_handle; 322 extern bfd_boolean force_make_executable; 323 324 extern int yyparse (void); 325 extern void add_cref (const char *, bfd *, asection *, bfd_vma); 326 extern bfd_boolean handle_asneeded_cref (bfd *, enum notice_asneeded_action); 327 extern void output_cref (FILE *); 328 extern void check_nocrossrefs (void); 329 extern void ld_abort (const char *, int, const char *) ATTRIBUTE_NORETURN; 330 331 /* If gcc >= 2.6, we can give a function name, too. */ 332 #if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 6) 333 #define __PRETTY_FUNCTION__ NULL 334 #endif 335 336 #undef abort 337 #define abort() ld_abort (__FILE__, __LINE__, __PRETTY_FUNCTION__) 338 339 #endif 340