Commit | Line | Data |
---|---|---|
89fc3421 CC |
1 | /* plugin-api.h -- External linker plugin API. */ |
2 | ||
3 | /* Copyright 2008 Free Software Foundation, Inc. | |
4 | Written by Cary Coutant <ccoutant@google.com>. | |
5 | ||
6 | This file is part of binutils. | |
7 | ||
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. | |
12 | ||
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. | |
17 | ||
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. */ | |
22 | ||
23 | /* This file defines the interface for writing a linker plugin, which is | |
24 | described at < http://gcc.gnu.org/wiki/whopr/driver >. */ | |
25 | ||
26 | #ifndef PLUGIN_API_H | |
27 | #define PLUGIN_API_H | |
28 | ||
29 | #include <stdint.h> | |
30 | #include <sys/types.h> | |
31 | ||
32 | #ifdef __cplusplus | |
33 | extern "C" | |
34 | { | |
35 | #endif | |
36 | ||
37 | /* Status code returned by most API routines. */ | |
38 | ||
39 | enum ld_plugin_status | |
40 | { | |
41 | LDPS_OK = 0, | |
bbb444b6 | 42 | LDPS_NO_SYMS, /* Attempt to get symbols that haven't been added. */ |
fa7f3e72 | 43 | LDPS_BAD_HANDLE, /* No claimed object associated with given handle. */ |
bbb444b6 | 44 | LDPS_ERR |
89fc3421 CC |
45 | /* Additional Error codes TBD. */ |
46 | }; | |
47 | ||
48 | /* The version of the API specification. */ | |
49 | ||
50 | enum ld_plugin_api_version | |
51 | { | |
bbb444b6 | 52 | LD_PLUGIN_API_VERSION = 1 |
89fc3421 CC |
53 | }; |
54 | ||
55 | /* The type of output file being generated by the linker. */ | |
56 | ||
57 | enum ld_plugin_output_file_type | |
58 | { | |
59 | LDPO_REL, | |
60 | LDPO_EXEC, | |
bbb444b6 | 61 | LDPO_DYN |
89fc3421 CC |
62 | }; |
63 | ||
64 | /* An input file managed by the plugin library. */ | |
65 | ||
66 | struct ld_plugin_input_file | |
67 | { | |
68 | const char *name; | |
69 | int fd; | |
70 | off_t offset; | |
71 | off_t filesize; | |
72 | void *handle; | |
73 | }; | |
74 | ||
75 | /* A symbol belonging to an input file managed by the plugin library. */ | |
76 | ||
77 | struct ld_plugin_symbol | |
78 | { | |
79 | char *name; | |
80 | char *version; | |
81 | int def; | |
82 | int visibility; | |
83 | uint64_t size; | |
84 | char *comdat_key; | |
85 | int resolution; | |
86 | }; | |
87 | ||
88 | /* Whether the symbol is a definition, reference, or common, weak or not. */ | |
89 | ||
90 | enum ld_plugin_symbol_kind | |
91 | { | |
92 | LDPK_DEF, | |
93 | LDPK_WEAKDEF, | |
94 | LDPK_UNDEF, | |
95 | LDPK_WEAKUNDEF, | |
bbb444b6 | 96 | LDPK_COMMON |
89fc3421 CC |
97 | }; |
98 | ||
99 | /* The visibility of the symbol. */ | |
100 | ||
101 | enum ld_plugin_symbol_visibility | |
102 | { | |
103 | LDPV_DEFAULT, | |
104 | LDPV_PROTECTED, | |
105 | LDPV_INTERNAL, | |
bbb444b6 | 106 | LDPV_HIDDEN |
89fc3421 CC |
107 | }; |
108 | ||
109 | /* How a symbol is resolved. */ | |
110 | ||
111 | enum ld_plugin_symbol_resolution | |
112 | { | |
113 | LDPR_UNKNOWN = 0, | |
114 | LDPR_UNDEF, | |
115 | LDPR_PREVAILING_DEF, | |
116 | LDPR_PREVAILING_DEF_IRONLY, | |
117 | LDPR_PREEMPTED_REG, | |
118 | LDPR_PREEMPTED_IR, | |
119 | LDPR_RESOLVED_IR, | |
120 | LDPR_RESOLVED_EXEC, | |
bbb444b6 | 121 | LDPR_RESOLVED_DYN |
89fc3421 CC |
122 | }; |
123 | ||
124 | /* The plugin library's "claim file" handler. */ | |
125 | ||
126 | typedef | |
127 | enum ld_plugin_status | |
128 | (*ld_plugin_claim_file_handler) ( | |
129 | const struct ld_plugin_input_file *file, int *claimed); | |
130 | ||
131 | /* The plugin library's "all symbols read" handler. */ | |
132 | ||
133 | typedef | |
134 | enum ld_plugin_status | |
135 | (*ld_plugin_all_symbols_read_handler) (void); | |
136 | ||
137 | /* The plugin library's cleanup handler. */ | |
138 | ||
139 | typedef | |
140 | enum ld_plugin_status | |
141 | (*ld_plugin_cleanup_handler) (void); | |
142 | ||
143 | /* The linker's interface for registering the "claim file" handler. */ | |
144 | ||
145 | typedef | |
146 | enum ld_plugin_status | |
147 | (*ld_plugin_register_claim_file) (ld_plugin_claim_file_handler handler); | |
148 | ||
149 | /* The linker's interface for registering the "all symbols read" handler. */ | |
150 | ||
151 | typedef | |
152 | enum ld_plugin_status | |
153 | (*ld_plugin_register_all_symbols_read) ( | |
154 | ld_plugin_all_symbols_read_handler handler); | |
155 | ||
156 | /* The linker's interface for registering the cleanup handler. */ | |
157 | ||
158 | typedef | |
159 | enum ld_plugin_status | |
160 | (*ld_plugin_register_cleanup) (ld_plugin_cleanup_handler handler); | |
161 | ||
162 | /* The linker's interface for adding symbols from a claimed input file. */ | |
163 | ||
164 | typedef | |
165 | enum ld_plugin_status | |
166 | (*ld_plugin_add_symbols) (void *handle, int nsyms, | |
167 | const struct ld_plugin_symbol *syms); | |
168 | ||
fa7f3e72 CC |
169 | /* The linker's interface for getting the input file information with |
170 | an open (possibly re-opened) file descriptor. */ | |
171 | ||
172 | typedef | |
173 | enum ld_plugin_status | |
174 | (*ld_plugin_get_input_file) (const void *handle, | |
175 | struct ld_plugin_input_file *file); | |
176 | ||
177 | /* The linker's interface for releasing the input file. */ | |
178 | ||
179 | typedef | |
180 | enum ld_plugin_status | |
181 | (*ld_plugin_release_input_file) (const void *handle); | |
182 | ||
89fc3421 CC |
183 | /* The linker's interface for retrieving symbol resolution information. */ |
184 | ||
185 | typedef | |
186 | enum ld_plugin_status | |
187 | (*ld_plugin_get_symbols) (const void *handle, int nsyms, | |
188 | struct ld_plugin_symbol *syms); | |
189 | ||
190 | /* The linker's interface for adding a compiled input file. */ | |
191 | ||
192 | typedef | |
193 | enum ld_plugin_status | |
194 | (*ld_plugin_add_input_file) (char *pathname); | |
195 | ||
196 | /* The linker's interface for issuing a warning or error message. */ | |
197 | ||
198 | typedef | |
199 | enum ld_plugin_status | |
6c52134c | 200 | (*ld_plugin_message) (int level, const char *format, ...); |
89fc3421 CC |
201 | |
202 | enum ld_plugin_level | |
203 | { | |
204 | LDPL_INFO, | |
205 | LDPL_WARNING, | |
206 | LDPL_ERROR, | |
bbb444b6 | 207 | LDPL_FATAL |
89fc3421 CC |
208 | }; |
209 | ||
210 | /* Values for the tv_tag field of the transfer vector. */ | |
211 | ||
212 | enum ld_plugin_tag | |
213 | { | |
214 | LDPT_NULL = 0, | |
215 | LDPT_API_VERSION, | |
216 | LDPT_GOLD_VERSION, | |
217 | LDPT_LINKER_OUTPUT, | |
218 | LDPT_OPTION, | |
219 | LDPT_REGISTER_CLAIM_FILE_HOOK, | |
220 | LDPT_REGISTER_ALL_SYMBOLS_READ_HOOK, | |
221 | LDPT_REGISTER_CLEANUP_HOOK, | |
222 | LDPT_ADD_SYMBOLS, | |
223 | LDPT_GET_SYMBOLS, | |
224 | LDPT_ADD_INPUT_FILE, | |
fa7f3e72 CC |
225 | LDPT_MESSAGE, |
226 | LDPT_GET_INPUT_FILE, | |
227 | LDPT_RELEASE_INPUT_FILE | |
89fc3421 CC |
228 | }; |
229 | ||
230 | /* The plugin transfer vector. */ | |
231 | ||
232 | struct ld_plugin_tv | |
233 | { | |
234 | enum ld_plugin_tag tv_tag; | |
235 | union | |
236 | { | |
237 | int tv_val; | |
238 | const char *tv_string; | |
239 | ld_plugin_register_claim_file tv_register_claim_file; | |
240 | ld_plugin_register_all_symbols_read tv_register_all_symbols_read; | |
241 | ld_plugin_register_cleanup tv_register_cleanup; | |
242 | ld_plugin_add_symbols tv_add_symbols; | |
243 | ld_plugin_get_symbols tv_get_symbols; | |
244 | ld_plugin_add_input_file tv_add_input_file; | |
245 | ld_plugin_message tv_message; | |
fa7f3e72 CC |
246 | ld_plugin_get_input_file tv_get_input_file; |
247 | ld_plugin_release_input_file tv_release_input_file; | |
89fc3421 CC |
248 | } tv_u; |
249 | }; | |
250 | ||
251 | /* The plugin library's "onload" entry point. */ | |
252 | ||
253 | typedef | |
254 | enum ld_plugin_status | |
255 | (*ld_plugin_onload) (struct ld_plugin_tv *tv); | |
256 | ||
257 | #ifdef __cplusplus | |
a6bfd026 | 258 | } |
89fc3421 CC |
259 | #endif |
260 | ||
261 | #endif /* !defined(PLUGIN_API_H) */ |