binutils-gdb/ld/ldemul.h

198 lines
6.8 KiB
C
Raw Normal View History

1999-05-03 15:29:11 +08:00
/* ld-emul.h - Linker emulation header file
Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 2000, 2002
Free Software Foundation, Inc.
1999-05-03 15:29:11 +08: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
extern void ldemul_hll
PARAMS ((char *));
extern void ldemul_syslib
PARAMS ((char *));
extern void ldemul_after_parse
PARAMS ((void));
extern void ldemul_before_parse
PARAMS ((void));
extern void ldemul_after_open
PARAMS ((void));
extern void ldemul_after_allocation
PARAMS ((void));
extern void ldemul_before_allocation
PARAMS ((void));
extern void ldemul_set_output_arch
PARAMS ((void));
extern char *ldemul_choose_target
PARAMS ((int, char**));
extern void ldemul_choose_mode
PARAMS ((char *));
extern void ldemul_list_emulations
PARAMS ((FILE *));
extern void ldemul_list_emulation_options
PARAMS ((FILE *));
extern char *ldemul_get_script
PARAMS ((int *isfile));
extern void ldemul_finish
PARAMS ((void));
extern void ldemul_set_symbols
PARAMS ((void));
extern void ldemul_create_output_section_statements
PARAMS ((void));
extern bfd_boolean ldemul_place_orphan
1999-05-03 15:29:11 +08:00
PARAMS ((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 09:32:31 +08:00
extern bfd_boolean ldemul_parse_args
PARAMS ((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 09:32:31 +08:00
extern void ldemul_add_options
PARAMS ((int, char **, int, struct option **, int, struct option **));
extern bfd_boolean ldemul_handle_option
PARAMS ((int));
extern bfd_boolean ldemul_unrecognized_file
1999-05-03 15:29:11 +08:00
PARAMS ((struct lang_input_statement_struct *));
extern bfd_boolean ldemul_recognized_file
1999-05-03 15:29:11 +08:00
PARAMS ((struct lang_input_statement_struct *));
extern bfd_boolean ldemul_open_dynamic_archive
1999-05-03 15:29:11 +08:00
PARAMS ((const char *, struct search_dirs *,
struct lang_input_statement_struct *));
extern char *ldemul_default_target
PARAMS ((int, char**));
extern void after_parse_default
PARAMS ((void));
extern void after_open_default
PARAMS ((void));
extern void after_allocation_default
PARAMS ((void));
extern void before_allocation_default
PARAMS ((void));
extern void set_output_arch_default
PARAMS ((void));
extern void syslib_default
PARAMS ((char*));
extern void hll_default
PARAMS ((char*));
extern int ldemul_find_potential_libraries
PARAMS ((char *, struct lang_input_statement_struct *));
extern struct bfd_elf_version_expr *ldemul_new_vers_pattern
PARAMS ((struct bfd_elf_version_expr *));
1999-05-03 15:29:11 +08:00
typedef struct ld_emulation_xfer_struct {
1999-05-03 15:29:11 +08:00
/* Run before parsing the command line and script file.
Set the architecture, maybe other things. */
void (*before_parse) PARAMS ((void));
/* Handle the SYSLIB (low level library) script command. */
void (*syslib) PARAMS ((char *));
/* Handle the HLL (high level library) script command. */
void (*hll) PARAMS ((char *));
/* Run after parsing the command line and script file. */
void (*after_parse) PARAMS ((void));
/* Run after opening all input files, and loading the symbols. */
void (*after_open) PARAMS ((void));
/* Run after allocating output sections. */
void (*after_allocation) PARAMS ( (void));
/* Set the output architecture and machine if possible. */
void (*set_output_arch) PARAMS ((void));
/* Decide which target name to use. */
char * (*choose_target) PARAMS ((int, char**));
1999-05-03 15:29:11 +08:00
/* Run before allocating output sections. */
void (*before_allocation) PARAMS ((void));
/* Return the appropriate linker script. */
char * (*get_script) PARAMS ((int *isfile));
/* The name of this emulation. */
char *emulation_name;
/* The output format. */
char *target_name;
/* Run after assigning values from the script. */
void (*finish) PARAMS ((void));
/* Create any output sections needed by the target. */
void (*create_output_section_statements) PARAMS ((void));
/* 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)
1999-05-03 15:29:11 +08:00
PARAMS ((const char *arch, struct search_dirs *,
struct lang_input_statement_struct *entry));
/* Place an orphan section. Return TRUE if it was placed, FALSE if
1999-05-03 15:29:11 +08: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)
1999-05-03 15:29:11 +08:00
PARAMS ((struct lang_input_statement_struct *, asection *));
/* Run after assigning parsing with the args, but before
reading the script. Used to initialize symbols used in the script. */
1999-05-03 15:29:11 +08:00
void (*set_symbols) PARAMS ((void));
* 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 09:32:31 +08:00
/* Parse args which the base linker doesn't understand.
Return TRUE if the arg needs no further processing. */
* 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 09:32:31 +08:00
bfd_boolean (*parse_args) PARAMS ((int, char **));
/* Hook to add options to parameters passed by the base linker to
getopt_long and getopt_long_only calls. */
void (*add_options)
PARAMS ((int, char **, int, struct option **, int, struct option **));
/* Companion to the above to handle an option. Returns TRUE if it is
one of our options. */
bfd_boolean (*handle_option) PARAMS ((int));
1999-05-03 15:29:11 +08: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)
1999-05-03 15:29:11 +08:00
PARAMS ((struct lang_input_statement_struct *));
/* Run to list the command line options which parse_args handles. */
void (* list_options) PARAMS ((FILE *));
/* Run to specially handle files which *are* recognized as object
files or archives. Return TRUE if the file was handled. */
bfd_boolean (*recognized_file)
1999-05-03 15:29:11 +08:00
PARAMS ((struct lang_input_statement_struct *));
/* 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)
PARAMS ((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)
PARAMS ((struct bfd_elf_version_expr *));
1999-05-03 15:29:11 +08:00
} ld_emulation_xfer_type;
typedef enum {
1999-05-03 15:29:11 +08:00
intel_ic960_ld_mode_enum,
default_mode_enum,
1999-05-03 15:29:11 +08:00
intel_gld960_ld_mode_enum
} lang_emulation_mode_enum_type;
extern ld_emulation_xfer_type *ld_emulations[];
#endif