daily update
[binutils.git] / ld / ldemul.h
blobcc81728609423f8e8958789177e1b8b757fbbdf1
1 /* ld-emul.h - Linker emulation header file
2 Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 2000, 2001,
3 2002, 2003, 2004, 2005, 2007
4 Free Software Foundation, Inc.
6 This file is part of the GNU Binutils.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
21 MA 02110-1301, USA. */
23 #ifndef LDEMUL_H
24 #define LDEMUL_H
26 /* Forward declaration for ldemul_add_options() and others. */
27 struct option;
29 extern void ldemul_hll
30 (char *);
31 extern void ldemul_syslib
32 (char *);
33 extern void ldemul_after_parse
34 (void);
35 extern void ldemul_before_parse
36 (void);
37 extern void ldemul_after_open
38 (void);
39 extern void ldemul_after_allocation
40 (void);
41 extern void ldemul_before_allocation
42 (void);
43 extern void ldemul_set_output_arch
44 (void);
45 extern char *ldemul_choose_target
46 (int, char**);
47 extern void ldemul_choose_mode
48 (char *);
49 extern void ldemul_list_emulations
50 (FILE *);
51 extern void ldemul_list_emulation_options
52 (FILE *);
53 extern char *ldemul_get_script
54 (int *isfile);
55 extern void ldemul_finish
56 (void);
57 extern void ldemul_set_symbols
58 (void);
59 extern void ldemul_create_output_section_statements
60 (void);
61 extern bfd_boolean ldemul_place_orphan
62 (asection *);
63 extern bfd_boolean ldemul_parse_args
64 (int, char **);
65 extern void ldemul_add_options
66 (int, char **, int, struct option **, int, struct option **);
67 extern bfd_boolean ldemul_handle_option
68 (int);
69 extern bfd_boolean ldemul_unrecognized_file
70 (struct lang_input_statement_struct *);
71 extern bfd_boolean ldemul_recognized_file
72 (struct lang_input_statement_struct *);
73 extern bfd_boolean ldemul_open_dynamic_archive
74 (const char *, struct search_dirs *, struct lang_input_statement_struct *);
75 extern char *ldemul_default_target
76 (int, char**);
77 extern void after_parse_default
78 (void);
79 extern void after_open_default
80 (void);
81 extern void after_allocation_default
82 (void);
83 extern void before_allocation_default
84 (void);
85 extern void finish_default
86 (void);
87 extern void finish_default
88 (void);
89 extern void set_output_arch_default
90 (void);
91 extern void syslib_default
92 (char*);
93 extern void hll_default
94 (char*);
95 extern int ldemul_find_potential_libraries
96 (char *, struct lang_input_statement_struct *);
97 extern struct bfd_elf_version_expr *ldemul_new_vers_pattern
98 (struct bfd_elf_version_expr *);
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);
105 /* Handle the SYSLIB (low level library) script command. */
106 void (*syslib) (char *);
108 /* Handle the HLL (high level library) script command. */
109 void (*hll) (char *);
111 /* Run after parsing the command line and script file. */
112 void (*after_parse) (void);
114 /* Run after opening all input files, and loading the symbols. */
115 void (*after_open) (void);
117 /* Run after allocating output sections. */
118 void (*after_allocation) (void);
120 /* Set the output architecture and machine if possible. */
121 void (*set_output_arch) (void);
123 /* Decide which target name to use. */
124 char * (*choose_target) (int, char**);
126 /* Run before allocating output sections. */
127 void (*before_allocation) (void);
129 /* Return the appropriate linker script. */
130 char * (*get_script) (int *isfile);
132 /* The name of this emulation. */
133 char *emulation_name;
135 /* The output format. */
136 char *target_name;
138 /* Run after assigning values from the script. */
139 void (*finish) (void);
141 /* Create any output sections needed by the target. */
142 void (*create_output_section_statements) (void);
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);
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 bfd_boolean (*place_orphan)
155 (asection *);
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);
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 **);
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 **);
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);
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 *);
179 /* Run to list the command line options which parse_args handles. */
180 void (* list_options) (FILE *);
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 *);
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 *);
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 *);
199 } ld_emulation_xfer_type;
201 typedef enum {
202 intel_ic960_ld_mode_enum,
203 default_mode_enum,
204 intel_gld960_ld_mode_enum
205 } lang_emulation_mode_enum_type;
207 extern ld_emulation_xfer_type *ld_emulations[];
209 #endif