daily update
[binutils.git] / ld / ld.h
blob12f3f69db548049119993c62bb89c290452685b8
1 /* ld.h -- general linker header file
2 Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2002
3 Free Software Foundation, Inc.
5 This file is part of GLD, the Gnu Linker.
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.
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.
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. */
22 #ifndef LD_H
23 #define LD_H
25 #ifdef HAVE_LOCALE_H
26 # include <locale.h>
27 #endif
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
47 #include "bin-bugs.h"
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: */
53 /* Look in this variable for a target format */
54 #define TARGET_ENVIRON "GNUTARGET"
56 /* Input sections which are put in a section of this name are actually
57 discarded. */
58 #define DISCARD_SECTION_NAME "/DISCARD/"
60 /* A file name list */
61 typedef struct name_list {
62 const char *name;
63 struct name_list *next;
65 name_list;
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. */
70 struct wildcard_spec {
71 const char *name;
72 struct name_list *exclude_name_list;
73 boolean sorted;
76 struct wildcard_list {
77 struct wildcard_list *next;
78 struct wildcard_spec spec;
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;
87 #define get_userdata(x) ((x)->userdata)
89 #define BYTE_SIZE (1)
90 #define SHORT_SIZE (2)
91 #define LONG_SIZE (4)
92 #define QUAD_SIZE (8)
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))))
102 typedef struct {
103 /* 1 => assign space to common symbols even if `relocatable_output'. */
104 boolean force_common_definition;
106 /* 1 => do not assign addresses to common symbols. */
107 boolean inhibit_common_definition;
108 boolean relax;
110 /* Name of runtime interpreter to invoke. */
111 char *interpreter;
113 /* Name to give runtime libary from the -soname argument. */
114 char *soname;
116 /* Runtime library search path from the -rpath argument. */
117 char *rpath;
119 /* Link time runtime library search path from the -rpath-link
120 argument. */
121 char *rpath_link;
123 /* Big or little endian as set on command line. */
124 enum { ENDIAN_UNSET = 0, ENDIAN_BIG, ENDIAN_LITTLE } endian;
126 /* If true, build MIPS embedded PIC relocation tables in the output
127 file. */
128 boolean embedded_relocs;
130 /* If true, force generation of a file with a .exe file. */
131 boolean force_exe_suffix;
133 /* If true, generate a cross reference report. */
134 boolean cref;
136 /* If true (which is the default), warn about mismatched input
137 files. */
138 boolean warn_mismatch;
140 /* Remove unreferenced sections? */
141 boolean gc_sections;
143 /* Name of shared object whose symbol table should be filtered with
144 this shared object. From the --filter option. */
145 char *filter_shlib;
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;
151 /* A version symbol to be applied to the symbol names found in the
152 .exports sections. */
153 char *version_exports_section;
155 /* If true (the default) check section addresses, once compute,
156 fpor overlaps. */
157 boolean check_section_addresses;
159 } args_type;
161 extern args_type command_line;
163 typedef int token_code_type;
165 typedef struct {
166 bfd_size_type specified_data_size;
167 boolean magic_demand_paged;
168 boolean make_executable;
170 /* If true, doing a dynamic link. */
171 boolean dynamic_link;
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;
179 /* If true, build constructors. */
180 boolean build_constructors;
182 /* If true, warn about any constructors. */
183 boolean warn_constructors;
185 /* If true, warn about merging common symbols with others. */
186 boolean warn_common;
188 /* If true, only warn once about a particular undefined symbol. */
189 boolean warn_once;
191 /* If true, warn if multiple global-pointers are needed (Alpha
192 only). */
193 boolean warn_multiple_gp;
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;
199 /* If true, warning messages are fatal */
200 boolean fatal_warnings;
202 boolean sort_common;
204 boolean text_read_only;
206 char *map_filename;
207 FILE *map_file;
209 boolean stats;
211 /* If set, orphan input sections will be mapped to separate output
212 sections. */
213 boolean unique_orphan_sections;
215 unsigned int split_by_reloc;
216 bfd_size_type split_by_file;
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;
223 extern ld_config_type config;
225 typedef enum {
226 lang_first_phase_enum,
227 lang_allocating_phase_enum,
228 lang_final_phase_enum
229 } lang_phase_type;
231 extern FILE * saved_script_handle;
232 extern boolean force_make_executable;
234 /* Non-zero if we are processing a --defsym from the command line. */
235 extern int parsing_defsym;
237 extern int yyparse PARAMS ((void));
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));
243 extern void ld_abort PARAMS ((const char *, int, const char *))
244 ATTRIBUTE_NORETURN;
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
251 #undef abort
252 #define abort() ld_abort (__FILE__, __LINE__, __PRETTY_FUNCTION__)
254 #endif