/* ld.h -- general linker header file
|
/* ld.h -- general linker header file
|
Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
|
Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
|
2001, 2002, 2003, 2004, 2005, 2006, 2007
|
2001, 2002, 2003, 2004, 2005, 2006, 2007
|
Free Software Foundation, Inc.
|
Free Software Foundation, Inc.
|
|
|
This file is part of the GNU Binutils.
|
This file is part of the GNU Binutils.
|
|
|
This program 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
|
it under the terms of the GNU General Public License as published by
|
the Free Software Foundation; either version 3 of the License, or
|
the Free Software Foundation; either version 3 of the License, or
|
(at your option) any later version.
|
(at your option) any later version.
|
|
|
This program 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
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
GNU General Public License for more details.
|
GNU General Public License for more details.
|
|
|
You should have received a copy of the GNU General Public License
|
You should have received a copy of the GNU General Public License
|
along with this program; if not, write to the Free Software
|
along with this program; if not, write to the Free Software
|
Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
|
Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
|
MA 02110-1301, USA. */
|
MA 02110-1301, USA. */
|
|
|
#ifndef LD_H
|
#ifndef LD_H
|
#define LD_H
|
#define LD_H
|
|
|
#ifdef HAVE_LOCALE_H
|
#ifdef HAVE_LOCALE_H
|
#endif
|
#endif
|
#ifndef SEEK_CUR
|
#ifndef SEEK_CUR
|
#define SEEK_CUR 1
|
#define SEEK_CUR 1
|
#endif
|
#endif
|
#ifndef SEEK_END
|
#ifndef SEEK_END
|
#define SEEK_END 2
|
#define SEEK_END 2
|
#endif
|
#endif
|
|
|
#if defined(__GNUC__) && !defined(C_ALLOCA)
|
#if defined(__GNUC__) && !defined(C_ALLOCA)
|
# undef alloca
|
# undef alloca
|
# define alloca __builtin_alloca
|
# define alloca __builtin_alloca
|
#else
|
#else
|
# if defined(HAVE_ALLOCA_H) && !defined(C_ALLOCA)
|
# if defined(HAVE_ALLOCA_H) && !defined(C_ALLOCA)
|
# include <alloca.h>
|
# include <alloca.h>
|
# else
|
# else
|
# ifndef alloca /* predefined by HP cc +Olibcalls */
|
# ifndef alloca /* predefined by HP cc +Olibcalls */
|
# if !defined (__STDC__) && !defined (__hpux)
|
# if !defined (__STDC__) && !defined (__hpux)
|
char *alloca ();
|
char *alloca ();
|
# else
|
# else
|
void *alloca ();
|
void *alloca ();
|
# endif /* __STDC__, __hpux */
|
# endif /* __STDC__, __hpux */
|
# endif /* alloca */
|
# endif /* alloca */
|
# endif /* HAVE_ALLOCA_H */
|
# endif /* HAVE_ALLOCA_H */
|
#endif
|
#endif
|
|
|
|
|
#ifdef HAVE_LOCALE_H
|
#ifdef HAVE_LOCALE_H
|
# ifndef ENABLE_NLS
|
# ifndef ENABLE_NLS
|
/* The Solaris version of locale.h always includes libintl.h. If we have
|
/* 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
|
been configured with --disable-nls then ENABLE_NLS will not be defined
|
and the dummy definitions of bindtextdomain (et al) below will conflict
|
and the dummy definitions of bindtextdomain (et al) below will conflict
|
with the defintions in libintl.h. So we define these values to prevent
|
with the defintions in libintl.h. So we define these values to prevent
|
the bogus inclusion of libintl.h. */
|
the bogus inclusion of libintl.h. */
|
# define _LIBINTL_H
|
# define _LIBINTL_H
|
# define _LIBGETTEXT_H
|
# define _LIBGETTEXT_H
|
# endif
|
# endif
|
# include <locale.h>
|
# include <locale.h>
|
#endif
|
#endif
|
|
|
#ifdef ENABLE_NLS
|
#ifdef ENABLE_NLS
|
# include <libintl.h>
|
# include <libintl.h>
|
# define _(String) gettext (String)
|
# define _(String) gettext (String)
|
# ifdef gettext_noop
|
# ifdef gettext_noop
|
# define N_(String) gettext_noop (String)
|
# define N_(String) gettext_noop (String)
|
# else
|
# else
|
# define N_(String) (String)
|
# define N_(String) (String)
|
# endif
|
# endif
|
#else
|
#else
|
# define gettext(Msgid) (Msgid)
|
# define gettext(Msgid) (Msgid)
|
# define dgettext(Domainname, Msgid) (Msgid)
|
# define dgettext(Domainname, Msgid) (Msgid)
|
# define dcgettext(Domainname, Msgid, Category) (Msgid)
|
# define dcgettext(Domainname, Msgid, Category) (Msgid)
|
# define textdomain(Domainname) while (0) /* nothing */
|
# define textdomain(Domainname) while (0) /* nothing */
|
# define bindtextdomain(Domainname, Dirname) while (0) /* nothing */
|
# define bindtextdomain(Domainname, Dirname) while (0) /* nothing */
|
# define _(String) (String)
|
# define _(String) (String)
|
# define N_(String) (String)
|
# define N_(String) (String)
|
#endif
|
#endif
|
|
|
/* Look in this environment name for the linker to pretend to be */
|
/* Look in this environment name for the linker to pretend to be */
|
#define EMULATION_ENVIRON "LDEMULATION"
|
#define EMULATION_ENVIRON "LDEMULATION"
|
/* If in there look for the strings: */
|
/* If in there look for the strings: */
|
|
|
/* Look in this variable for a target format */
|
/* Look in this variable for a target format */
|
#define TARGET_ENVIRON "GNUTARGET"
|
#define TARGET_ENVIRON "GNUTARGET"
|
|
|
/* Input sections which are put in a section of this name are actually
|
/* Input sections which are put in a section of this name are actually
|
discarded. */
|
discarded. */
|
#define DISCARD_SECTION_NAME "/DISCARD/"
|
#define DISCARD_SECTION_NAME "/DISCARD/"
|
|
|
/* A file name list */
|
/* A file name list */
|
typedef struct name_list {
|
typedef struct name_list {
|
const char *name;
|
const char *name;
|
struct name_list *next;
|
struct name_list *next;
|
}
|
}
|
name_list;
|
name_list;
|
|
|
/* A wildcard specification. */
|
/* A wildcard specification. */
|
|
|
typedef enum {
|
typedef enum {
|
none, by_name, by_alignment, by_name_alignment, by_alignment_name
|
none, by_name, by_alignment, by_name_alignment, by_alignment_name
|
} sort_type;
|
} sort_type;
|
|
|
extern sort_type sort_section;
|
extern sort_type sort_section;
|
|
|
struct wildcard_spec {
|
struct wildcard_spec {
|
const char *name;
|
const char *name;
|
struct name_list *exclude_name_list;
|
struct name_list *exclude_name_list;
|
sort_type sorted;
|
sort_type sorted;
|
};
|
};
|
|
|
struct wildcard_list {
|
struct wildcard_list {
|
struct wildcard_list *next;
|
struct wildcard_list *next;
|
struct wildcard_spec spec;
|
struct wildcard_spec spec;
|
};
|
};
|
|
|
struct map_symbol_def {
|
struct map_symbol_def {
|
struct bfd_link_hash_entry *entry;
|
struct bfd_link_hash_entry *entry;
|
struct map_symbol_def *next;
|
struct map_symbol_def *next;
|
};
|
};
|
|
|
/* The initial part of fat_user_section_struct has to be idential with
|
/* The initial part of fat_user_section_struct has to be idential with
|
lean_user_section_struct. */
|
lean_user_section_struct. */
|
typedef struct fat_user_section_struct {
|
typedef struct fat_user_section_struct {
|
/* For input sections, when writing a map file: head / tail of a linked
|
/* For input sections, when writing a map file: head / tail of a linked
|
list of hash table entries for symbols defined in this section. */
|
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_head;
|
struct map_symbol_def **map_symbol_def_tail;
|
struct map_symbol_def **map_symbol_def_tail;
|
} fat_section_userdata_type;
|
} fat_section_userdata_type;
|
|
|
#define get_userdata(x) ((x)->userdata)
|
#define get_userdata(x) ((x)->userdata)
|
|
|
#define BYTE_SIZE (1)
|
#define BYTE_SIZE (1)
|
#define SHORT_SIZE (2)
|
#define SHORT_SIZE (2)
|
#define LONG_SIZE (4)
|
#define LONG_SIZE (4)
|
#define QUAD_SIZE (8)
|
#define QUAD_SIZE (8)
|
|
|
typedef struct {
|
typedef struct {
|
/* 1 => assign space to common symbols even if `relocatable_output'. */
|
/* 1 => assign space to common symbols even if `relocatable_output'. */
|
bfd_boolean force_common_definition;
|
bfd_boolean force_common_definition;
|
|
|
/* 1 => do not assign addresses to common symbols. */
|
/* 1 => do not assign addresses to common symbols. */
|
bfd_boolean inhibit_common_definition;
|
bfd_boolean inhibit_common_definition;
|
bfd_boolean relax;
|
bfd_boolean relax;
|
|
|
/* If TRUE, build MIPS embedded PIC relocation tables in the output
|
/* If TRUE, build MIPS embedded PIC relocation tables in the output
|
file. */
|
file. */
|
bfd_boolean embedded_relocs;
|
bfd_boolean embedded_relocs;
|
|
|
/* If TRUE, force generation of a file with a .exe file. */
|
/* If TRUE, force generation of a file with a .exe file. */
|
bfd_boolean force_exe_suffix;
|
bfd_boolean force_exe_suffix;
|
|
|
/* If TRUE, generate a cross reference report. */
|
/* If TRUE, generate a cross reference report. */
|
bfd_boolean cref;
|
bfd_boolean cref;
|
|
|
/* If TRUE (which is the default), warn about mismatched input
|
/* If TRUE (which is the default), warn about mismatched input
|
files. */
|
files. */
|
bfd_boolean warn_mismatch;
|
bfd_boolean warn_mismatch;
|
|
|
/* Warn on attempting to open an incompatible library during a library
|
/* Warn on attempting to open an incompatible library during a library
|
search. */
|
search. */
|
bfd_boolean warn_search_mismatch;
|
bfd_boolean warn_search_mismatch;
|
|
|
|
|
/* If TRUE (the default) check section addresses, once compute,
|
/* If TRUE (the default) check section addresses, once compute,
|
fpor overlaps. */
|
fpor overlaps. */
|
bfd_boolean check_section_addresses;
|
bfd_boolean check_section_addresses;
|
|
|
/* If TRUE allow the linking of input files in an unknown architecture
|
/* 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
|
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
|
behaviour of the linker. The new default behaviour is to reject such
|
input files. */
|
input files. */
|
bfd_boolean accept_unknown_input_arch;
|
bfd_boolean accept_unknown_input_arch;
|
|
|
/* Big or little endian as set on command line. */
|
/* Big or little endian as set on command line. */
|
enum { ENDIAN_UNSET = 0, ENDIAN_BIG, ENDIAN_LITTLE } endian;
|
enum { ENDIAN_UNSET = 0, ENDIAN_BIG, ENDIAN_LITTLE } endian;
|
|
|
/* -Bsymbolic and -Bsymbolic-functions, as set on command line. */
|
/* -Bsymbolic and -Bsymbolic-functions, as set on command line. */
|
enum
|
enum
|
{
|
{
|
symbolic_unset = 0,
|
symbolic_unset = 0,
|
symbolic,
|
symbolic,
|
symbolic_functions,
|
symbolic_functions,
|
} symbolic;
|
} symbolic;
|
|
|
/* --dynamic-list, --dynamic-list-cpp-new, --dynamic-list-cpp-typeinfo
|
/* --dynamic-list, --dynamic-list-cpp-new, --dynamic-list-cpp-typeinfo
|
and --dynamic-list FILE, as set on command line. */
|
and --dynamic-list FILE, as set on command line. */
|
enum
|
enum
|
{
|
{
|
dynamic_list_unset = 0,
|
dynamic_list_unset = 0,
|
dynamic_list_data,
|
dynamic_list_data,
|
dynamic_list
|
dynamic_list
|
} dynamic_list;
|
} dynamic_list;
|
|
|
/* Name of runtime interpreter to invoke. */
|
/* Name of runtime interpreter to invoke. */
|
char *interpreter;
|
char *interpreter;
|
|
|
/* Name to give runtime libary from the -soname argument. */
|
/* Name to give runtime libary from the -soname argument. */
|
char *soname;
|
char *soname;
|
|
|
/* Runtime library search path from the -rpath argument. */
|
/* Runtime library search path from the -rpath argument. */
|
char *rpath;
|
char *rpath;
|
|
|
/* Link time runtime library search path from the -rpath-link
|
/* Link time runtime library search path from the -rpath-link
|
argument. */
|
argument. */
|
char *rpath_link;
|
char *rpath_link;
|
|
|
/* Name of shared object whose symbol table should be filtered with
|
/* Name of shared object whose symbol table should be filtered with
|
this shared object. From the --filter option. */
|
this shared object. From the --filter option. */
|
char *filter_shlib;
|
char *filter_shlib;
|
|
|
/* Name of shared object for whose symbol table this shared object
|
/* Name of shared object for whose symbol table this shared object
|
is an auxiliary filter. From the --auxiliary option. */
|
is an auxiliary filter. From the --auxiliary option. */
|
char **auxiliary_filters;
|
char **auxiliary_filters;
|
|
|
/* A version symbol to be applied to the symbol names found in the
|
/* A version symbol to be applied to the symbol names found in the
|
.exports sections. */
|
.exports sections. */
|
char *version_exports_section;
|
char *version_exports_section;
|
|
|
/* Default linker script. */
|
/* Default linker script. */
|
char *default_script;
|
char *default_script;
|
} args_type;
|
} args_type;
|
|
|
extern args_type command_line;
|
extern args_type command_line;
|
|
|
typedef int token_code_type;
|
typedef int token_code_type;
|
|
|
typedef struct {
|
typedef struct {
|
bfd_boolean magic_demand_paged;
|
bfd_boolean magic_demand_paged;
|
bfd_boolean make_executable;
|
bfd_boolean make_executable;
|
|
|
/* If TRUE, doing a dynamic link. */
|
/* If TRUE, doing a dynamic link. */
|
bfd_boolean dynamic_link;
|
bfd_boolean dynamic_link;
|
|
|
/* If TRUE, -shared is supported. */
|
/* If TRUE, -shared is supported. */
|
/* ??? A better way to do this is perhaps to define this in the
|
/* ??? A better way to do this is perhaps to define this in the
|
ld_emulation_xfer_struct since this is really a target dependent
|
ld_emulation_xfer_struct since this is really a target dependent
|
parameter. */
|
parameter. */
|
bfd_boolean has_shared;
|
bfd_boolean has_shared;
|
|
|
/* If TRUE, build constructors. */
|
/* If TRUE, build constructors. */
|
bfd_boolean build_constructors;
|
bfd_boolean build_constructors;
|
|
|
/* If TRUE, warn about any constructors. */
|
/* If TRUE, warn about any constructors. */
|
bfd_boolean warn_constructors;
|
bfd_boolean warn_constructors;
|
|
|
/* If TRUE, warn about merging common symbols with others. */
|
/* If TRUE, warn about merging common symbols with others. */
|
bfd_boolean warn_common;
|
bfd_boolean warn_common;
|
|
|
/* If TRUE, only warn once about a particular undefined symbol. */
|
/* If TRUE, only warn once about a particular undefined symbol. */
|
bfd_boolean warn_once;
|
bfd_boolean warn_once;
|
|
|
/* If TRUE, warn if multiple global-pointers are needed (Alpha
|
/* If TRUE, warn if multiple global-pointers are needed (Alpha
|
only). */
|
only). */
|
bfd_boolean warn_multiple_gp;
|
bfd_boolean warn_multiple_gp;
|
|
|
/* If TRUE, warn if the starting address of an output section
|
/* If TRUE, warn if the starting address of an output section
|
changes due to the alignment of an input section. */
|
changes due to the alignment of an input section. */
|
bfd_boolean warn_section_align;
|
bfd_boolean warn_section_align;
|
|
|
/* If TRUE, warning messages are fatal */
|
/* If TRUE, warning messages are fatal */
|
bfd_boolean fatal_warnings;
|
bfd_boolean fatal_warnings;
|
|
|
bfd_boolean sort_common;
|
bfd_boolean sort_common;
|
|
|
bfd_boolean text_read_only;
|
bfd_boolean text_read_only;
|
|
|
bfd_boolean stats;
|
bfd_boolean stats;
|
|
|
/* If set, orphan input sections will be mapped to separate output
|
/* If set, orphan input sections will be mapped to separate output
|
sections. */
|
sections. */
|
bfd_boolean unique_orphan_sections;
|
bfd_boolean unique_orphan_sections;
|
|
|
/* If set, only search library directories explicitly selected
|
/* If set, only search library directories explicitly selected
|
on the command line. */
|
on the command line. */
|
bfd_boolean only_cmd_line_lib_dirs;
|
bfd_boolean only_cmd_line_lib_dirs;
|
|
|
/* The rpath separation character. Usually ':'. */
|
/* The rpath separation character. Usually ':'. */
|
char rpath_separator;
|
char rpath_separator;
|
|
|
char *map_filename;
|
char *map_filename;
|
FILE *map_file;
|
FILE *map_file;
|
|
|
unsigned int split_by_reloc;
|
unsigned int split_by_reloc;
|
bfd_size_type split_by_file;
|
bfd_size_type split_by_file;
|
|
|
bfd_size_type specified_data_size;
|
bfd_size_type specified_data_size;
|
|
|
/* The size of the hash table to use. */
|
/* The size of the hash table to use. */
|
bfd_size_type hash_table_size;
|
bfd_size_type hash_table_size;
|
|
|
/* The maximum page size for ELF. */
|
/* The maximum page size for ELF. */
|
bfd_vma maxpagesize;
|
bfd_vma maxpagesize;
|
|
|
/* The common page size for ELF. */
|
/* The common page size for ELF. */
|
bfd_vma commonpagesize;
|
bfd_vma commonpagesize;
|
} ld_config_type;
|
} ld_config_type;
|
|
|
extern ld_config_type config;
|
extern ld_config_type config;
|
|
|
extern FILE * saved_script_handle;
|
extern FILE * saved_script_handle;
|
extern bfd_boolean force_make_executable;
|
extern bfd_boolean force_make_executable;
|
|
|
/* Non-zero if we are processing a --defsym from the command line. */
|
/* Non-zero if we are processing a --defsym from the command line. */
|
extern int parsing_defsym;
|
extern int parsing_defsym;
|
|
|
extern int yyparse (void);
|
extern int yyparse (void);
|
extern void add_cref (const char *, bfd *, asection *, bfd_vma);
|
extern void add_cref (const char *, bfd *, asection *, bfd_vma);
|
extern bfd_boolean handle_asneeded_cref (bfd *, enum notice_asneeded_action);
|
extern bfd_boolean handle_asneeded_cref (bfd *, enum notice_asneeded_action);
|
extern void output_cref (FILE *);
|
extern void output_cref (FILE *);
|
extern void check_nocrossrefs (void);
|
extern void check_nocrossrefs (void);
|
extern void ld_abort (const char *, int, const char *) ATTRIBUTE_NORETURN;
|
extern void ld_abort (const char *, int, const char *) ATTRIBUTE_NORETURN;
|
|
|
/* If gcc >= 2.6, we can give a function name, too. */
|
/* If gcc >= 2.6, we can give a function name, too. */
|
#if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 6)
|
#if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 6)
|
#define __PRETTY_FUNCTION__ NULL
|
#define __PRETTY_FUNCTION__ NULL
|
#endif
|
#endif
|
|
|
#undef abort
|
#undef abort
|
#define abort() ld_abort (__FILE__, __LINE__, __PRETTY_FUNCTION__)
|
#define abort() ld_abort (__FILE__, __LINE__, __PRETTY_FUNCTION__)
|
|
|
#endif
|
#endif
|
|
|
