Home | History | Annotate | Download | only in ld
      1 /* ld-emul.h - Linker emulation header file
      2    Copyright (C) 1991-2014 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 LDEMUL_H
     22 #define LDEMUL_H
     23 
     24 /* Forward declaration for ldemul_add_options() and others.  */
     25 struct option;
     26 
     27 extern void ldemul_hll
     28   (char *);
     29 extern void ldemul_syslib
     30   (char *);
     31 extern void ldemul_after_parse
     32   (void);
     33 extern void ldemul_before_parse
     34   (void);
     35 extern void ldemul_after_open
     36   (void);
     37 extern void ldemul_after_allocation
     38   (void);
     39 extern void ldemul_before_allocation
     40   (void);
     41 extern void ldemul_set_output_arch
     42   (void);
     43 extern char *ldemul_choose_target
     44   (int, char**);
     45 extern void ldemul_choose_mode
     46   (char *);
     47 extern void ldemul_list_emulations
     48   (FILE *);
     49 extern void ldemul_list_emulation_options
     50   (FILE *);
     51 extern char *ldemul_get_script
     52   (int *isfile);
     53 extern void ldemul_finish
     54   (void);
     55 extern void ldemul_set_symbols
     56   (void);
     57 extern void ldemul_create_output_section_statements
     58   (void);
     59 extern lang_output_section_statement_type *ldemul_place_orphan
     60   (asection *, const char *, int);
     61 extern bfd_boolean ldemul_parse_args
     62   (int, char **);
     63 extern void ldemul_add_options
     64   (int, char **, int, struct option **, int, struct option **);
     65 extern bfd_boolean ldemul_handle_option
     66   (int);
     67 extern bfd_boolean ldemul_unrecognized_file
     68   (struct lang_input_statement_struct *);
     69 extern bfd_boolean ldemul_recognized_file
     70   (struct lang_input_statement_struct *);
     71 extern bfd_boolean ldemul_open_dynamic_archive
     72   (const char *, struct search_dirs *, struct lang_input_statement_struct *);
     73 extern char *ldemul_default_target
     74   (int, char**);
     75 extern void after_parse_default
     76   (void);
     77 extern void after_open_default
     78   (void);
     79 extern void after_allocation_default
     80   (void);
     81 extern void before_allocation_default
     82   (void);
     83 extern void finish_default
     84   (void);
     85 extern void finish_default
     86   (void);
     87 extern void set_output_arch_default
     88   (void);
     89 extern void syslib_default
     90   (char*);
     91 extern void hll_default
     92   (char*);
     93 extern int  ldemul_find_potential_libraries
     94   (char *, struct lang_input_statement_struct *);
     95 extern struct bfd_elf_version_expr *ldemul_new_vers_pattern
     96   (struct bfd_elf_version_expr *);
     97 extern void ldemul_extra_map_file_text
     98   (bfd *, struct bfd_link_info *, FILE *);
     99 
    100 typedef struct ld_emulation_xfer_struct {
    101   /* Run before parsing the command line and script file.
    102      Set the architecture, maybe other things.  */
    103   void   (*before_parse) (void);
    104 
    105   /* Handle the SYSLIB (low level library) script command.  */
    106   void   (*syslib) (char *);
    107 
    108   /* Handle the HLL (high level library) script command.  */
    109   void   (*hll) (char *);
    110 
    111   /* Run after parsing the command line and script file.  */
    112   void   (*after_parse) (void);
    113 
    114   /* Run after opening all input files, and loading the symbols.  */
    115   void   (*after_open) (void);
    116 
    117   /* Run after allocating output sections.  */
    118   void   (*after_allocation)  (void);
    119 
    120   /* Set the output architecture and machine if possible.  */
    121   void   (*set_output_arch) (void);
    122 
    123   /* Decide which target name to use.  */
    124   char * (*choose_target) (int, char**);
    125 
    126   /* Run before allocating output sections.  */
    127   void   (*before_allocation) (void);
    128 
    129   /* Return the appropriate linker script.  */
    130   char * (*get_script) (int *isfile);
    131 
    132   /* The name of this emulation.  */
    133   char *emulation_name;
    134 
    135   /* The output format.  */
    136   char *target_name;
    137 
    138   /* Run after assigning values from the script.  */
    139   void	(*finish) (void);
    140 
    141   /* Create any output sections needed by the target.  */
    142   void	(*create_output_section_statements) (void);
    143 
    144   /* Try to open a dynamic library.  ARCH is an architecture name, and
    145      is normally the empty string.  ENTRY is the lang_input_statement
    146      that should be opened.  */
    147   bfd_boolean (*open_dynamic_archive)
    148     (const char *arch, struct search_dirs *,
    149      struct lang_input_statement_struct *entry);
    150 
    151   /* Place an orphan section.  Return TRUE if it was placed, FALSE if
    152      the default action should be taken.  This field may be NULL, in
    153      which case the default action will always be taken.  */
    154   lang_output_section_statement_type *(*place_orphan)
    155     (asection *, const char *, int);
    156 
    157   /* Run after assigning parsing with the args, but before
    158      reading the script.  Used to initialize symbols used in the script.  */
    159   void	(*set_symbols) (void);
    160 
    161   /* Parse args which the base linker doesn't understand.
    162      Return TRUE if the arg needs no further processing.  */
    163   bfd_boolean (*parse_args) (int, char **);
    164 
    165   /* Hook to add options to parameters passed by the base linker to
    166      getopt_long and getopt_long_only calls.  */
    167   void (*add_options)
    168     (int, char **, int, struct option **, int, struct option **);
    169 
    170   /* Companion to the above to handle an option.  Returns TRUE if it is
    171      one of our options.  */
    172   bfd_boolean (*handle_option) (int);
    173 
    174   /* Run to handle files which are not recognized as object files or
    175      archives.  Return TRUE if the file was handled.  */
    176   bfd_boolean (*unrecognized_file)
    177     (struct lang_input_statement_struct *);
    178 
    179   /* Run to list the command line options which parse_args handles.  */
    180   void (* list_options) (FILE *);
    181 
    182   /* Run to specially handle files which *are* recognized as object
    183      files or archives.  Return TRUE if the file was handled.  */
    184   bfd_boolean (*recognized_file)
    185     (struct lang_input_statement_struct *);
    186 
    187   /* Called when looking for libraries in a directory specified
    188      via a linker command line option or linker script option.
    189      Files that match the pattern "lib*.a" have already been scanned.
    190      (For VMS files matching ":lib*.a" have also been scanned).  */
    191   int (* find_potential_libraries)
    192     (char *, struct lang_input_statement_struct *);
    193 
    194   /* Called when adding a new version pattern.  PowerPC64-ELF uses
    195      this hook to add a pattern matching ".foo" for every "foo".  */
    196   struct bfd_elf_version_expr * (*new_vers_pattern)
    197     (struct bfd_elf_version_expr *);
    198 
    199   /* Called when printing the map file, in case there are
    200      emulation-specific sections for it.  */
    201   void (*extra_map_file_text)
    202     (bfd *, struct bfd_link_info *, FILE *);
    203 
    204 } ld_emulation_xfer_type;
    205 
    206 typedef enum {
    207   intel_ic960_ld_mode_enum,
    208   default_mode_enum,
    209   intel_gld960_ld_mode_enum
    210 } lang_emulation_mode_enum_type;
    211 
    212 extern ld_emulation_xfer_type *ld_emulations[];
    213 
    214 #endif
    215