daily update
[binutils.git] / ld / plugin.h
blobfc5f37f2dabd355f0c867bc58ba35015992042f3
1 /* Plugin control for the GNU linker.
2 Copyright 2010 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. */
21 #ifndef GLD_PLUGIN_H
22 #define GLD_PLUGIN_H
25 /* This is the only forward declaration we need to avoid having
26 to include the plugin-api.h header in order to use this file. */
27 struct ld_plugin_input_file;
29 /* Handle -plugin arg: find and load plugin, or return error. */
30 extern int plugin_opt_plugin (const char *plugin);
32 /* Accumulate option arguments for last-loaded plugin, or return
33 error if none. */
34 extern int plugin_opt_plugin_arg (const char *arg);
36 /* Return true if any plugins are active this run. Only valid
37 after options have been processed. */
38 extern bfd_boolean plugin_active_plugins_p (void);
40 /* Load up and initialise all plugins after argument parsing. */
41 extern int plugin_load_plugins (void);
43 /* Return name of plugin which caused an error in any of the above. */
44 extern const char *plugin_error_plugin (void);
46 /* Call 'claim file' hook for all plugins. */
47 extern int plugin_call_claim_file (const struct ld_plugin_input_file *file,
48 int *claimed);
50 /* Call 'all symbols read' hook for all plugins. */
51 extern int plugin_call_all_symbols_read (void);
53 /* Generate a dummy BFD to represent an IR file, for any callers of
54 plugin_call_claim_file to use as the handle in the ld_plugin_input_file
55 struct that they build to pass in. The BFD is initially writable, so
56 that symbols can be added to it; it must be made readable after the
57 add_symbols hook has been called so that it can be read when linking. */
58 extern bfd *plugin_get_ir_dummy_bfd (const char *name, bfd *template);
60 /* Notice-symbol bfd linker callback hook. */
61 extern bfd_boolean plugin_notice (struct bfd_link_info *info,
62 const char *name, bfd *abfd,
63 asection *section, bfd_vma value);
65 /* Multiple-definition bfd linker callback hook. */
66 extern bfd_boolean plugin_multiple_definition (struct bfd_link_info *info,
67 const char *name,
68 bfd *obfd, asection *osec,
69 bfd_vma oval, bfd *nbfd,
70 asection *nsec,
71 bfd_vma nval);
73 #endif /* !def GLD_PLUGIN_H */