1 /* ld-emul.h - Linker emulation header file
2 Copyright (C) 1991-2020 Free Software Foundation, Inc.
4 This file is part of the GNU Binutils.
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.
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.
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. */
24 /* Forward declaration for ldemul_add_options() and others. */
27 extern void ldemul_hll
29 extern void ldemul_syslib
31 extern void ldemul_after_parse
33 extern void ldemul_before_parse
35 extern void ldemul_after_open
37 extern void ldemul_after_check_relocs
39 extern void ldemul_before_place_orphans
41 extern void ldemul_after_allocation
43 extern void ldemul_before_allocation
45 extern void ldemul_set_output_arch
47 extern char *ldemul_choose_target
49 extern void ldemul_choose_mode
51 extern void ldemul_list_emulations
53 extern void ldemul_list_emulation_options
55 extern char *ldemul_get_script
57 extern void ldemul_finish
59 extern void ldemul_set_symbols
61 extern void ldemul_create_output_section_statements
63 extern lang_output_section_statement_type
*ldemul_place_orphan
64 (asection
*, const char *, int);
65 extern bfd_boolean ldemul_parse_args
67 extern void ldemul_add_options
68 (int, char **, int, struct option
**, int, struct option
**);
69 extern bfd_boolean ldemul_handle_option
71 extern bfd_boolean ldemul_unrecognized_file
72 (struct lang_input_statement_struct
*);
73 extern bfd_boolean ldemul_recognized_file
74 (struct lang_input_statement_struct
*);
75 extern bfd_boolean ldemul_open_dynamic_archive
76 (const char *, struct search_dirs
*, struct lang_input_statement_struct
*);
77 extern char *ldemul_default_target
79 extern void after_parse_default
81 extern void after_open_default
83 extern void after_check_relocs_default
85 extern void before_place_orphans_default
87 extern void after_allocation_default
89 extern void before_allocation_default
91 extern void finish_default
93 extern void finish_default
95 extern void set_output_arch_default
97 extern void syslib_default
99 extern void hll_default
101 extern int ldemul_find_potential_libraries
102 (char *, struct lang_input_statement_struct
*);
103 extern struct bfd_elf_version_expr
*ldemul_new_vers_pattern
104 (struct bfd_elf_version_expr
*);
105 extern void ldemul_extra_map_file_text
106 (bfd
*, struct bfd_link_info
*, FILE *);
107 /* Return 1 if we are emitting CTF early, and 0 if ldemul_examine_strtab_for_ctf
108 will be called by the target. */
109 extern int ldemul_emit_ctf_early
111 /* Called from per-target code to examine the strtab and symtab. */
112 extern void ldemul_examine_strtab_for_ctf
113 (struct ctf_file
*, struct elf_sym_strtab
*, bfd_size_type
,
114 struct elf_strtab_hash
*);
115 extern bfd_boolean ldemul_print_symbol
116 (struct bfd_link_hash_entry
*hash_entry
, void *ptr
);
118 typedef struct ld_emulation_xfer_struct
{
119 /* Run before parsing the command line and script file.
120 Set the architecture, maybe other things. */
121 void (*before_parse
) (void);
123 /* Handle the SYSLIB (low level library) script command. */
124 void (*syslib
) (char *);
126 /* Handle the HLL (high level library) script command. */
127 void (*hll
) (char *);
129 /* Run after parsing the command line and script file. */
130 void (*after_parse
) (void);
132 /* Run after opening all input files, and loading the symbols. */
133 void (*after_open
) (void);
135 /* Run after checking relocations. */
136 void (*after_check_relocs
) (void);
138 /* Run before placing orphans. */
139 void (*before_place_orphans
) (void);
141 /* Run after allocating output sections. */
142 void (*after_allocation
) (void);
144 /* Set the output architecture and machine if possible. */
145 void (*set_output_arch
) (void);
147 /* Decide which target name to use. */
148 char * (*choose_target
) (int, char**);
150 /* Run before allocating output sections. */
151 void (*before_allocation
) (void);
153 /* Return the appropriate linker script. */
154 char * (*get_script
) (int *isfile
);
156 /* The name of this emulation. */
157 char *emulation_name
;
159 /* The output format. */
162 /* Run after assigning values from the script. */
163 void (*finish
) (void);
165 /* Create any output sections needed by the target. */
166 void (*create_output_section_statements
) (void);
168 /* Try to open a dynamic library. ARCH is an architecture name, and
169 is normally the empty string. ENTRY is the lang_input_statement
170 that should be opened. */
171 bfd_boolean (*open_dynamic_archive
)
172 (const char *arch
, struct search_dirs
*,
173 struct lang_input_statement_struct
*entry
);
175 /* Place an orphan section. Return TRUE if it was placed, FALSE if
176 the default action should be taken. This field may be NULL, in
177 which case the default action will always be taken. */
178 lang_output_section_statement_type
*(*place_orphan
)
179 (asection
*, const char *, int);
181 /* Run after assigning parsing with the args, but before
182 reading the script. Used to initialize symbols used in the script. */
183 void (*set_symbols
) (void);
185 /* Parse args which the base linker doesn't understand.
186 Return TRUE if the arg needs no further processing. */
187 bfd_boolean (*parse_args
) (int, char **);
189 /* Hook to add options to parameters passed by the base linker to
190 getopt_long and getopt_long_only calls. */
192 (int, char **, int, struct option
**, int, struct option
**);
194 /* Companion to the above to handle an option. Returns TRUE if it is
195 one of our options. */
196 bfd_boolean (*handle_option
) (int);
198 /* Run to handle files which are not recognized as object files or
199 archives. Return TRUE if the file was handled. */
200 bfd_boolean (*unrecognized_file
)
201 (struct lang_input_statement_struct
*);
203 /* Run to list the command line options which parse_args handles. */
204 void (* list_options
) (FILE *);
206 /* Run to specially handle files which *are* recognized as object
207 files or archives. Return TRUE if the file was handled. */
208 bfd_boolean (*recognized_file
)
209 (struct lang_input_statement_struct
*);
211 /* Called when looking for libraries in a directory specified
212 via a linker command line option or linker script option.
213 Files that match the pattern "lib*.a" have already been scanned.
214 (For VMS files matching ":lib*.a" have also been scanned). */
215 int (* find_potential_libraries
)
216 (char *, struct lang_input_statement_struct
*);
218 /* Called when adding a new version pattern. PowerPC64-ELF uses
219 this hook to add a pattern matching ".foo" for every "foo". */
220 struct bfd_elf_version_expr
* (*new_vers_pattern
)
221 (struct bfd_elf_version_expr
*);
223 /* Called when printing the map file, in case there are
224 emulation-specific sections for it. */
225 void (*extra_map_file_text
)
226 (bfd
*, struct bfd_link_info
*, FILE *);
228 /* If this returns true, we emit CTF as early as possible: if false, we emit
229 CTF once the strtab and symtab are laid out. */
230 int (*emit_ctf_early
)
233 /* Called to examine the string and symbol table late enough in linking that
234 they are finally laid out. If emit_ctf_early returns true, this is not
235 called and ldemul_maybe_emit_ctf() emits CTF in 'early' mode: otherwise, it
236 waits until 'late'. (Late mode needs explicit support at per-target link
237 time to get called at all). If set, called by ld when the examine_strtab
238 bfd_link_callback is invoked by per-target code. */
239 void (*examine_strtab_for_ctf
) (struct ctf_file
*, struct elf_sym_strtab
*,
240 bfd_size_type
, struct elf_strtab_hash
*);
242 /* Called when printing a symbol to the map file. AIX uses this
243 hook to flag gc'd symbols. */
244 bfd_boolean (*print_symbol
)
245 (struct bfd_link_hash_entry
*hash_entry
, void *ptr
);
247 } ld_emulation_xfer_type
;
250 intel_ic960_ld_mode_enum
,
252 intel_gld960_ld_mode_enum
253 } lang_emulation_mode_enum_type
;
255 extern ld_emulation_xfer_type
*ld_emulations
[];