binutils-gdb/ld/ldemul.h

201 lines
6.4 KiB
C
Raw Normal View History

1999-05-03 09:29:11 +02:00
/* ld-emul.h - Linker emulation header file
2005-03-03 12:52:12 +01:00
Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 2000, 2001,
2002, 2003, 2004
Free Software Foundation, Inc.
1999-05-03 09:29:11 +02:00
This file is part of GLD, the Gnu Linker.
GLD 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 1, or (at your option)
any later version.
GLD 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. */
#ifndef LDEMUL_H
#define LDEMUL_H
/* Forward declaration for ldemul_add_options() and others. */
struct option;
extern void ldemul_hll
2003-06-28 07:28:54 +02:00
(char *);
extern void ldemul_syslib
2003-06-28 07:28:54 +02:00
(char *);
extern void ldemul_after_parse
2003-06-28 07:28:54 +02:00
(void);
extern void ldemul_before_parse
2003-06-28 07:28:54 +02:00
(void);
extern void ldemul_after_open
2003-06-28 07:28:54 +02:00
(void);
extern void ldemul_after_allocation
2003-06-28 07:28:54 +02:00
(void);
extern void ldemul_before_allocation
2003-06-28 07:28:54 +02:00
(void);
extern void ldemul_set_output_arch
2003-06-28 07:28:54 +02:00
(void);
extern char *ldemul_choose_target
2003-06-28 07:28:54 +02:00
(int, char**);
extern void ldemul_choose_mode
2003-06-28 07:28:54 +02:00
(char *);
extern void ldemul_list_emulations
2003-06-28 07:28:54 +02:00
(FILE *);
extern void ldemul_list_emulation_options
2003-06-28 07:28:54 +02:00
(FILE *);
extern char *ldemul_get_script
2003-06-28 07:28:54 +02:00
(int *isfile);
extern void ldemul_finish
2003-06-28 07:28:54 +02:00
(void);
extern void ldemul_set_symbols
2003-06-28 07:28:54 +02:00
(void);
extern void ldemul_create_output_section_statements
2003-06-28 07:28:54 +02:00
(void);
extern bfd_boolean ldemul_place_orphan
2003-06-28 07:28:54 +02:00
(struct lang_input_statement_struct *, asection *);
* ldemul.c (ldemul_add_options, ldemul_handle_option): New functions. (ldemul_parse_args): Return bfd_boolean. Formatting. * ldemul.h (ldemul_add_options, ldemul_handle_option): Declare. (ldemul_parse_args): Adjust. (struct ld_emulation_xfer_struct): Add add_options and handle_option. Return bfd_boolean from parse_args. * lexsup.c (parse_args): Malloc shortopts, longopts and really_longopts. Call ldemul_add_options and ldemul_handle_option. * emultempl/aix.em (gld${EMULATION_NAME}_add_options): Split out from gld${EMULATION_NAME}_parse_args. (gld${EMULATION_NAME}_handle_option): Likewise. (ld_${EMULATION_NAME}_emulation): Adjust initializer. * emultempl/armcoff.em: As for aix.em, but remove parse_args. * emultempl/beos.em: Likewise. * emultempl/pe.em: Likewise. * emultempl/ticoff.em: Likewise. * emultempl/elf32.em: Likewise. Don't duplicate long options either. (gld${EMULATION_NAME}_add_sysroot): Prototype. * emultempl/armelf.em (PARSE_AND_LIST_LONGOPTS): Don't duplicate options. * emultempl/hppaelf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/ppc32elf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/ppc64elf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/armelf_oabi.em (ld_${EMULATION_NAME}_emulation): Adjust initializer. * emultempl/generic.em: Likewise. * emultempl/gld960.em: Likewise. * emultempl/gld960c.em: Likewise. * emultempl/linux.em: Likewise. * emultempl/lnk960.em: Likewise. * emultempl/m68kcoff.em: Likewise. * emultempl/mipsecoff.em: Likewise. * emultempl/sunos.em: Likewise. * emultempl/vanilla.em: Likewise. * emultempl/netbsd.em (gldnetbsd_before_parse): Prototype.
2003-02-28 02:32:31 +01:00
extern bfd_boolean ldemul_parse_args
2003-06-28 07:28:54 +02:00
(int, char **);
* ldemul.c (ldemul_add_options, ldemul_handle_option): New functions. (ldemul_parse_args): Return bfd_boolean. Formatting. * ldemul.h (ldemul_add_options, ldemul_handle_option): Declare. (ldemul_parse_args): Adjust. (struct ld_emulation_xfer_struct): Add add_options and handle_option. Return bfd_boolean from parse_args. * lexsup.c (parse_args): Malloc shortopts, longopts and really_longopts. Call ldemul_add_options and ldemul_handle_option. * emultempl/aix.em (gld${EMULATION_NAME}_add_options): Split out from gld${EMULATION_NAME}_parse_args. (gld${EMULATION_NAME}_handle_option): Likewise. (ld_${EMULATION_NAME}_emulation): Adjust initializer. * emultempl/armcoff.em: As for aix.em, but remove parse_args. * emultempl/beos.em: Likewise. * emultempl/pe.em: Likewise. * emultempl/ticoff.em: Likewise. * emultempl/elf32.em: Likewise. Don't duplicate long options either. (gld${EMULATION_NAME}_add_sysroot): Prototype. * emultempl/armelf.em (PARSE_AND_LIST_LONGOPTS): Don't duplicate options. * emultempl/hppaelf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/ppc32elf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/ppc64elf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/armelf_oabi.em (ld_${EMULATION_NAME}_emulation): Adjust initializer. * emultempl/generic.em: Likewise. * emultempl/gld960.em: Likewise. * emultempl/gld960c.em: Likewise. * emultempl/linux.em: Likewise. * emultempl/lnk960.em: Likewise. * emultempl/m68kcoff.em: Likewise. * emultempl/mipsecoff.em: Likewise. * emultempl/sunos.em: Likewise. * emultempl/vanilla.em: Likewise. * emultempl/netbsd.em (gldnetbsd_before_parse): Prototype.
2003-02-28 02:32:31 +01:00
extern void ldemul_add_options
2003-06-28 07:28:54 +02:00
(int, char **, int, struct option **, int, struct option **);
* ldemul.c (ldemul_add_options, ldemul_handle_option): New functions. (ldemul_parse_args): Return bfd_boolean. Formatting. * ldemul.h (ldemul_add_options, ldemul_handle_option): Declare. (ldemul_parse_args): Adjust. (struct ld_emulation_xfer_struct): Add add_options and handle_option. Return bfd_boolean from parse_args. * lexsup.c (parse_args): Malloc shortopts, longopts and really_longopts. Call ldemul_add_options and ldemul_handle_option. * emultempl/aix.em (gld${EMULATION_NAME}_add_options): Split out from gld${EMULATION_NAME}_parse_args. (gld${EMULATION_NAME}_handle_option): Likewise. (ld_${EMULATION_NAME}_emulation): Adjust initializer. * emultempl/armcoff.em: As for aix.em, but remove parse_args. * emultempl/beos.em: Likewise. * emultempl/pe.em: Likewise. * emultempl/ticoff.em: Likewise. * emultempl/elf32.em: Likewise. Don't duplicate long options either. (gld${EMULATION_NAME}_add_sysroot): Prototype. * emultempl/armelf.em (PARSE_AND_LIST_LONGOPTS): Don't duplicate options. * emultempl/hppaelf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/ppc32elf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/ppc64elf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/armelf_oabi.em (ld_${EMULATION_NAME}_emulation): Adjust initializer. * emultempl/generic.em: Likewise. * emultempl/gld960.em: Likewise. * emultempl/gld960c.em: Likewise. * emultempl/linux.em: Likewise. * emultempl/lnk960.em: Likewise. * emultempl/m68kcoff.em: Likewise. * emultempl/mipsecoff.em: Likewise. * emultempl/sunos.em: Likewise. * emultempl/vanilla.em: Likewise. * emultempl/netbsd.em (gldnetbsd_before_parse): Prototype.
2003-02-28 02:32:31 +01:00
extern bfd_boolean ldemul_handle_option
2003-06-28 07:28:54 +02:00
(int);
extern bfd_boolean ldemul_unrecognized_file
2003-06-28 07:28:54 +02:00
(struct lang_input_statement_struct *);
extern bfd_boolean ldemul_recognized_file
2003-06-28 07:28:54 +02:00
(struct lang_input_statement_struct *);
extern bfd_boolean ldemul_open_dynamic_archive
2003-06-28 07:28:54 +02:00
(const char *, struct search_dirs *, struct lang_input_statement_struct *);
extern char *ldemul_default_target
2003-06-28 07:28:54 +02:00
(int, char**);
extern void after_parse_default
2003-06-28 07:28:54 +02:00
(void);
extern void after_open_default
2003-06-28 07:28:54 +02:00
(void);
extern void after_allocation_default
2003-06-28 07:28:54 +02:00
(void);
extern void before_allocation_default
2003-06-28 07:28:54 +02:00
(void);
extern void set_output_arch_default
2003-06-28 07:28:54 +02:00
(void);
extern void syslib_default
2003-06-28 07:28:54 +02:00
(char*);
extern void hll_default
2003-06-28 07:28:54 +02:00
(char*);
extern int ldemul_find_potential_libraries
2003-06-28 07:28:54 +02:00
(char *, struct lang_input_statement_struct *);
extern struct bfd_elf_version_expr *ldemul_new_vers_pattern
2003-06-28 07:28:54 +02:00
(struct bfd_elf_version_expr *);
1999-05-03 09:29:11 +02:00
typedef struct ld_emulation_xfer_struct {
1999-05-03 09:29:11 +02:00
/* Run before parsing the command line and script file.
Set the architecture, maybe other things. */
2003-06-28 07:28:54 +02:00
void (*before_parse) (void);
1999-05-03 09:29:11 +02:00
/* Handle the SYSLIB (low level library) script command. */
2003-06-28 07:28:54 +02:00
void (*syslib) (char *);
1999-05-03 09:29:11 +02:00
/* Handle the HLL (high level library) script command. */
2003-06-28 07:28:54 +02:00
void (*hll) (char *);
1999-05-03 09:29:11 +02:00
/* Run after parsing the command line and script file. */
2003-06-28 07:28:54 +02:00
void (*after_parse) (void);
1999-05-03 09:29:11 +02:00
/* Run after opening all input files, and loading the symbols. */
2003-06-28 07:28:54 +02:00
void (*after_open) (void);
1999-05-03 09:29:11 +02:00
/* Run after allocating output sections. */
2003-06-28 07:28:54 +02:00
void (*after_allocation) (void);
1999-05-03 09:29:11 +02:00
/* Set the output architecture and machine if possible. */
2003-06-28 07:28:54 +02:00
void (*set_output_arch) (void);
1999-05-03 09:29:11 +02:00
/* Decide which target name to use. */
2003-06-28 07:28:54 +02:00
char * (*choose_target) (int, char**);
1999-05-03 09:29:11 +02:00
/* Run before allocating output sections. */
2003-06-28 07:28:54 +02:00
void (*before_allocation) (void);
1999-05-03 09:29:11 +02:00
/* Return the appropriate linker script. */
2003-06-28 07:28:54 +02:00
char * (*get_script) (int *isfile);
1999-05-03 09:29:11 +02:00
/* The name of this emulation. */
char *emulation_name;
/* The output format. */
char *target_name;
/* Run after assigning values from the script. */
2003-06-28 07:28:54 +02:00
void (*finish) (void);
1999-05-03 09:29:11 +02:00
/* Create any output sections needed by the target. */
2003-06-28 07:28:54 +02:00
void (*create_output_section_statements) (void);
1999-05-03 09:29:11 +02:00
/* Try to open a dynamic library. ARCH is an architecture name, and
is normally the empty string. ENTRY is the lang_input_statement
that should be opened. */
bfd_boolean (*open_dynamic_archive)
2003-06-28 07:28:54 +02:00
(const char *arch, struct search_dirs *,
struct lang_input_statement_struct *entry);
1999-05-03 09:29:11 +02:00
/* Place an orphan section. Return TRUE if it was placed, FALSE if
1999-05-03 09:29:11 +02:00
the default action should be taken. This field may be NULL, in
which case the default action will always be taken. */
bfd_boolean (*place_orphan)
2003-06-28 07:28:54 +02:00
(struct lang_input_statement_struct *, asection *);
1999-05-03 09:29:11 +02:00
/* Run after assigning parsing with the args, but before
reading the script. Used to initialize symbols used in the script. */
2003-06-28 07:28:54 +02:00
void (*set_symbols) (void);
1999-05-03 09:29:11 +02:00
* ldemul.c (ldemul_add_options, ldemul_handle_option): New functions. (ldemul_parse_args): Return bfd_boolean. Formatting. * ldemul.h (ldemul_add_options, ldemul_handle_option): Declare. (ldemul_parse_args): Adjust. (struct ld_emulation_xfer_struct): Add add_options and handle_option. Return bfd_boolean from parse_args. * lexsup.c (parse_args): Malloc shortopts, longopts and really_longopts. Call ldemul_add_options and ldemul_handle_option. * emultempl/aix.em (gld${EMULATION_NAME}_add_options): Split out from gld${EMULATION_NAME}_parse_args. (gld${EMULATION_NAME}_handle_option): Likewise. (ld_${EMULATION_NAME}_emulation): Adjust initializer. * emultempl/armcoff.em: As for aix.em, but remove parse_args. * emultempl/beos.em: Likewise. * emultempl/pe.em: Likewise. * emultempl/ticoff.em: Likewise. * emultempl/elf32.em: Likewise. Don't duplicate long options either. (gld${EMULATION_NAME}_add_sysroot): Prototype. * emultempl/armelf.em (PARSE_AND_LIST_LONGOPTS): Don't duplicate options. * emultempl/hppaelf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/ppc32elf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/ppc64elf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/armelf_oabi.em (ld_${EMULATION_NAME}_emulation): Adjust initializer. * emultempl/generic.em: Likewise. * emultempl/gld960.em: Likewise. * emultempl/gld960c.em: Likewise. * emultempl/linux.em: Likewise. * emultempl/lnk960.em: Likewise. * emultempl/m68kcoff.em: Likewise. * emultempl/mipsecoff.em: Likewise. * emultempl/sunos.em: Likewise. * emultempl/vanilla.em: Likewise. * emultempl/netbsd.em (gldnetbsd_before_parse): Prototype.
2003-02-28 02:32:31 +01:00
/* Parse args which the base linker doesn't understand.
Return TRUE if the arg needs no further processing. */
2003-06-28 07:28:54 +02:00
bfd_boolean (*parse_args) (int, char **);
* ldemul.c (ldemul_add_options, ldemul_handle_option): New functions. (ldemul_parse_args): Return bfd_boolean. Formatting. * ldemul.h (ldemul_add_options, ldemul_handle_option): Declare. (ldemul_parse_args): Adjust. (struct ld_emulation_xfer_struct): Add add_options and handle_option. Return bfd_boolean from parse_args. * lexsup.c (parse_args): Malloc shortopts, longopts and really_longopts. Call ldemul_add_options and ldemul_handle_option. * emultempl/aix.em (gld${EMULATION_NAME}_add_options): Split out from gld${EMULATION_NAME}_parse_args. (gld${EMULATION_NAME}_handle_option): Likewise. (ld_${EMULATION_NAME}_emulation): Adjust initializer. * emultempl/armcoff.em: As for aix.em, but remove parse_args. * emultempl/beos.em: Likewise. * emultempl/pe.em: Likewise. * emultempl/ticoff.em: Likewise. * emultempl/elf32.em: Likewise. Don't duplicate long options either. (gld${EMULATION_NAME}_add_sysroot): Prototype. * emultempl/armelf.em (PARSE_AND_LIST_LONGOPTS): Don't duplicate options. * emultempl/hppaelf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/ppc32elf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/ppc64elf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/armelf_oabi.em (ld_${EMULATION_NAME}_emulation): Adjust initializer. * emultempl/generic.em: Likewise. * emultempl/gld960.em: Likewise. * emultempl/gld960c.em: Likewise. * emultempl/linux.em: Likewise. * emultempl/lnk960.em: Likewise. * emultempl/m68kcoff.em: Likewise. * emultempl/mipsecoff.em: Likewise. * emultempl/sunos.em: Likewise. * emultempl/vanilla.em: Likewise. * emultempl/netbsd.em (gldnetbsd_before_parse): Prototype.
2003-02-28 02:32:31 +01:00
/* Hook to add options to parameters passed by the base linker to
getopt_long and getopt_long_only calls. */
void (*add_options)
2003-06-28 07:28:54 +02:00
(int, char **, int, struct option **, int, struct option **);
* ldemul.c (ldemul_add_options, ldemul_handle_option): New functions. (ldemul_parse_args): Return bfd_boolean. Formatting. * ldemul.h (ldemul_add_options, ldemul_handle_option): Declare. (ldemul_parse_args): Adjust. (struct ld_emulation_xfer_struct): Add add_options and handle_option. Return bfd_boolean from parse_args. * lexsup.c (parse_args): Malloc shortopts, longopts and really_longopts. Call ldemul_add_options and ldemul_handle_option. * emultempl/aix.em (gld${EMULATION_NAME}_add_options): Split out from gld${EMULATION_NAME}_parse_args. (gld${EMULATION_NAME}_handle_option): Likewise. (ld_${EMULATION_NAME}_emulation): Adjust initializer. * emultempl/armcoff.em: As for aix.em, but remove parse_args. * emultempl/beos.em: Likewise. * emultempl/pe.em: Likewise. * emultempl/ticoff.em: Likewise. * emultempl/elf32.em: Likewise. Don't duplicate long options either. (gld${EMULATION_NAME}_add_sysroot): Prototype. * emultempl/armelf.em (PARSE_AND_LIST_LONGOPTS): Don't duplicate options. * emultempl/hppaelf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/ppc32elf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/ppc64elf.em (PARSE_AND_LIST_LONGOPTS): Likewise. * emultempl/armelf_oabi.em (ld_${EMULATION_NAME}_emulation): Adjust initializer. * emultempl/generic.em: Likewise. * emultempl/gld960.em: Likewise. * emultempl/gld960c.em: Likewise. * emultempl/linux.em: Likewise. * emultempl/lnk960.em: Likewise. * emultempl/m68kcoff.em: Likewise. * emultempl/mipsecoff.em: Likewise. * emultempl/sunos.em: Likewise. * emultempl/vanilla.em: Likewise. * emultempl/netbsd.em (gldnetbsd_before_parse): Prototype.
2003-02-28 02:32:31 +01:00
/* Companion to the above to handle an option. Returns TRUE if it is
one of our options. */
2003-06-28 07:28:54 +02:00
bfd_boolean (*handle_option) (int);
1999-05-03 09:29:11 +02:00
/* Run to handle files which are not recognized as object files or
archives. Return TRUE if the file was handled. */
bfd_boolean (*unrecognized_file)
2003-06-28 07:28:54 +02:00
(struct lang_input_statement_struct *);
1999-05-03 09:29:11 +02:00
/* Run to list the command line options which parse_args handles. */
2003-06-28 07:28:54 +02:00
void (* list_options) (FILE *);
1999-05-03 09:29:11 +02:00
/* Run to specially handle files which *are* recognized as object
files or archives. Return TRUE if the file was handled. */
bfd_boolean (*recognized_file)
2003-06-28 07:28:54 +02:00
(struct lang_input_statement_struct *);
1999-05-03 09:29:11 +02:00
/* Called when looking for libraries in a directory specified
via a linker command line option or linker script option.
Files that match the pattern "lib*.a" have already been scanned.
(For VMS files matching ":lib*.a" have also been scanned). */
int (* find_potential_libraries)
2003-06-28 07:28:54 +02:00
(char *, struct lang_input_statement_struct *);
/* Called when adding a new version pattern. PowerPC64-ELF uses
this hook to add a pattern matching ".foo" for every "foo". */
struct bfd_elf_version_expr * (*new_vers_pattern)
2003-06-28 07:28:54 +02:00
(struct bfd_elf_version_expr *);
1999-05-03 09:29:11 +02:00
} ld_emulation_xfer_type;
typedef enum {
1999-05-03 09:29:11 +02:00
intel_ic960_ld_mode_enum,
default_mode_enum,
1999-05-03 09:29:11 +02:00
intel_gld960_ld_mode_enum
} lang_emulation_mode_enum_type;
extern ld_emulation_xfer_type *ld_emulations[];
#endif