Update my e-mail address.
[binutils-gdb.git] / bfd / plugin.c
blobaf50be12b89cb6a4b0ee1726d1dddd56e7574d67
1 /* Plugin support for BFD.
2 Copyright (C) 2009-2017 Free Software Foundation, Inc.
4 This file is part of BFD, the Binary File Descriptor library.
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 #include "sysdep.h"
22 #include "bfd.h"
24 #if BFD_SUPPORTS_PLUGINS
26 #include <assert.h>
27 #ifdef HAVE_DLFCN_H
28 #include <dlfcn.h>
29 #elif defined (HAVE_WINDOWS_H)
30 #include <windows.h>
31 #else
32 #error Unknown how to handle dynamic-load-libraries.
33 #endif
34 #include <stdarg.h>
35 #include "plugin-api.h"
36 #include "plugin.h"
37 #include "libbfd.h"
38 #include "libiberty.h"
39 #include <dirent.h>
41 #if !defined (HAVE_DLFCN_H) && defined (HAVE_WINDOWS_H)
43 #define RTLD_NOW 0 /* Dummy value. */
45 static void *
46 dlopen (const char *file, int mode ATTRIBUTE_UNUSED)
48 return LoadLibrary (file);
51 static void *
52 dlsym (void *handle, const char *name)
54 return GetProcAddress (handle, name);
57 static int ATTRIBUTE_UNUSED
58 dlclose (void *handle)
60 FreeLibrary (handle);
61 return 0;
64 static const char *
65 dlerror (void)
67 return "Unable to load DLL.";
70 #endif /* !defined (HAVE_DLFCN_H) && defined (HAVE_WINDOWS_H) */
72 #define bfd_plugin_close_and_cleanup _bfd_generic_close_and_cleanup
73 #define bfd_plugin_bfd_free_cached_info _bfd_generic_bfd_free_cached_info
74 #define bfd_plugin_new_section_hook _bfd_generic_new_section_hook
75 #define bfd_plugin_get_section_contents _bfd_generic_get_section_contents
76 #define bfd_plugin_get_section_contents_in_window _bfd_generic_get_section_contents_in_window
77 #define bfd_plugin_bfd_copy_private_header_data _bfd_generic_bfd_copy_private_header_data
78 #define bfd_plugin_bfd_merge_private_bfd_data _bfd_generic_bfd_merge_private_bfd_data
79 #define bfd_plugin_bfd_copy_private_header_data _bfd_generic_bfd_copy_private_header_data
80 #define bfd_plugin_bfd_set_private_flags _bfd_generic_bfd_set_private_flags
81 #define bfd_plugin_core_file_matches_executable_p generic_core_file_matches_executable_p
82 #define bfd_plugin_bfd_is_local_label_name _bfd_nosymbols_bfd_is_local_label_name
83 #define bfd_plugin_bfd_is_target_special_symbol ((bfd_boolean (*) (bfd *, asymbol *)) bfd_false)
84 #define bfd_plugin_get_lineno _bfd_nosymbols_get_lineno
85 #define bfd_plugin_find_nearest_line _bfd_nosymbols_find_nearest_line
86 #define bfd_plugin_find_line _bfd_nosymbols_find_line
87 #define bfd_plugin_find_inliner_info _bfd_nosymbols_find_inliner_info
88 #define bfd_plugin_get_symbol_version_string _bfd_nosymbols_get_symbol_version_string
89 #define bfd_plugin_bfd_make_debug_symbol _bfd_nosymbols_bfd_make_debug_symbol
90 #define bfd_plugin_read_minisymbols _bfd_generic_read_minisymbols
91 #define bfd_plugin_minisymbol_to_symbol _bfd_generic_minisymbol_to_symbol
92 #define bfd_plugin_set_arch_mach bfd_default_set_arch_mach
93 #define bfd_plugin_set_section_contents _bfd_generic_set_section_contents
94 #define bfd_plugin_bfd_get_relocated_section_contents bfd_generic_get_relocated_section_contents
95 #define bfd_plugin_bfd_relax_section bfd_generic_relax_section
96 #define bfd_plugin_bfd_link_hash_table_create _bfd_generic_link_hash_table_create
97 #define bfd_plugin_bfd_link_add_symbols _bfd_generic_link_add_symbols
98 #define bfd_plugin_bfd_link_just_syms _bfd_generic_link_just_syms
99 #define bfd_plugin_bfd_final_link _bfd_generic_final_link
100 #define bfd_plugin_bfd_link_split_section _bfd_generic_link_split_section
101 #define bfd_plugin_bfd_gc_sections bfd_generic_gc_sections
102 #define bfd_plugin_bfd_lookup_section_flags bfd_generic_lookup_section_flags
103 #define bfd_plugin_bfd_merge_sections bfd_generic_merge_sections
104 #define bfd_plugin_bfd_is_group_section bfd_generic_is_group_section
105 #define bfd_plugin_bfd_discard_group bfd_generic_discard_group
106 #define bfd_plugin_section_already_linked _bfd_generic_section_already_linked
107 #define bfd_plugin_bfd_define_common_symbol bfd_generic_define_common_symbol
108 #define bfd_plugin_bfd_define_start_stop bfd_generic_define_start_stop
109 #define bfd_plugin_bfd_copy_link_hash_symbol_type _bfd_generic_copy_link_hash_symbol_type
110 #define bfd_plugin_bfd_link_check_relocs _bfd_generic_link_check_relocs
112 static enum ld_plugin_status
113 message (int level ATTRIBUTE_UNUSED,
114 const char * format, ...)
116 va_list args;
117 va_start (args, format);
118 printf ("bfd plugin: ");
119 vprintf (format, args);
120 putchar ('\n');
121 va_end (args);
122 return LDPS_OK;
125 /* Register a claim-file handler. */
126 static ld_plugin_claim_file_handler claim_file;
128 static enum ld_plugin_status
129 register_claim_file (ld_plugin_claim_file_handler handler)
131 claim_file = handler;
132 return LDPS_OK;
135 static enum ld_plugin_status
136 add_symbols (void * handle,
137 int nsyms,
138 const struct ld_plugin_symbol * syms)
140 bfd *abfd = handle;
141 struct plugin_data_struct *plugin_data =
142 bfd_alloc (abfd, sizeof (plugin_data_struct));
144 plugin_data->nsyms = nsyms;
145 plugin_data->syms = syms;
147 if (nsyms != 0)
148 abfd->flags |= HAS_SYMS;
150 abfd->tdata.plugin_data = plugin_data;
151 return LDPS_OK;
154 static const char *plugin_program_name;
156 void
157 bfd_plugin_set_program_name (const char *program_name)
159 plugin_program_name = program_name;
163 bfd_plugin_open_input (bfd *ibfd, struct ld_plugin_input_file *file)
165 bfd *iobfd;
167 iobfd = ibfd;
168 if (ibfd->my_archive && !bfd_is_thin_archive (ibfd->my_archive))
169 iobfd = ibfd->my_archive;
170 file->name = iobfd->filename;
172 if (!iobfd->iostream && !bfd_open_file (iobfd))
173 return 0;
175 file->fd = fileno ((FILE *) iobfd->iostream);
177 if (iobfd == ibfd)
179 struct stat stat_buf;
180 if (fstat (file->fd, &stat_buf))
181 return 0;
182 file->offset = 0;
183 file->filesize = stat_buf.st_size;
185 else
187 file->offset = ibfd->origin;
188 file->filesize = arelt_size (ibfd);
190 return 1;
193 static int
194 try_claim (bfd *abfd)
196 int claimed = 0;
197 struct ld_plugin_input_file file;
199 if (!bfd_plugin_open_input (abfd, &file))
200 return 0;
201 file.handle = abfd;
202 off_t cur_offset = lseek (file.fd, 0, SEEK_CUR);
203 claim_file (&file, &claimed);
204 lseek (file.fd, cur_offset, SEEK_SET);
205 return claimed;
208 static int
209 try_load_plugin (const char *pname, bfd *abfd, int *has_plugin_p)
211 void *plugin_handle;
212 struct ld_plugin_tv tv[4];
213 int i;
214 ld_plugin_onload onload;
215 enum ld_plugin_status status;
217 *has_plugin_p = 0;
219 plugin_handle = dlopen (pname, RTLD_NOW);
220 if (!plugin_handle)
222 _bfd_error_handler ("%s\n", dlerror ());
223 return 0;
226 onload = dlsym (plugin_handle, "onload");
227 if (!onload)
228 goto err;
230 i = 0;
231 tv[i].tv_tag = LDPT_MESSAGE;
232 tv[i].tv_u.tv_message = message;
234 ++i;
235 tv[i].tv_tag = LDPT_REGISTER_CLAIM_FILE_HOOK;
236 tv[i].tv_u.tv_register_claim_file = register_claim_file;
238 ++i;
239 tv[i].tv_tag = LDPT_ADD_SYMBOLS;
240 tv[i].tv_u.tv_add_symbols = add_symbols;
242 ++i;
243 tv[i].tv_tag = LDPT_NULL;
244 tv[i].tv_u.tv_val = 0;
246 status = (*onload)(tv);
248 if (status != LDPS_OK)
249 goto err;
251 *has_plugin_p = 1;
253 abfd->plugin_format = bfd_plugin_no;
255 if (!claim_file)
256 goto err;
258 if (!try_claim (abfd))
259 goto err;
261 abfd->plugin_format = bfd_plugin_yes;
263 return 1;
265 err:
266 return 0;
269 /* There may be plugin libraries in lib/bfd-plugins. */
271 static int has_plugin = -1;
273 static const bfd_target *(*ld_plugin_object_p) (bfd *);
275 static const char *plugin_name;
277 void
278 bfd_plugin_set_plugin (const char *p)
280 plugin_name = p;
281 has_plugin = p != NULL;
284 /* Return TRUE if a plugin library is used. */
286 bfd_boolean
287 bfd_plugin_specified_p (void)
289 return has_plugin > 0;
292 /* Return TRUE if ABFD can be claimed by linker LTO plugin. */
294 bfd_boolean
295 bfd_link_plugin_object_p (bfd *abfd)
297 if (ld_plugin_object_p)
298 return ld_plugin_object_p (abfd) != NULL;
299 return FALSE;
302 extern const bfd_target plugin_vec;
304 /* Return TRUE if TARGET is a pointer to plugin_vec. */
306 bfd_boolean
307 bfd_plugin_target_p (const bfd_target *target)
309 return target == &plugin_vec;
312 /* Register OBJECT_P to be used by bfd_plugin_object_p. */
314 void
315 register_ld_plugin_object_p (const bfd_target *(*object_p) (bfd *))
317 ld_plugin_object_p = object_p;
320 static int
321 load_plugin (bfd *abfd)
323 char *plugin_dir;
324 char *p;
325 DIR *d;
326 struct dirent *ent;
327 int found = 0;
329 if (!has_plugin)
330 return found;
332 if (plugin_name)
333 return try_load_plugin (plugin_name, abfd, &has_plugin);
335 if (plugin_program_name == NULL)
336 return found;
338 plugin_dir = concat (BINDIR, "/../lib/bfd-plugins", NULL);
339 p = make_relative_prefix (plugin_program_name,
340 BINDIR,
341 plugin_dir);
342 free (plugin_dir);
343 plugin_dir = NULL;
345 d = opendir (p);
346 if (!d)
347 goto out;
349 while ((ent = readdir (d)))
351 char *full_name;
352 struct stat s;
353 int valid_plugin;
355 full_name = concat (p, "/", ent->d_name, NULL);
356 if (stat(full_name, &s) == 0 && S_ISREG (s.st_mode))
357 found = try_load_plugin (full_name, abfd, &valid_plugin);
358 if (has_plugin <= 0)
359 has_plugin = valid_plugin;
360 free (full_name);
361 if (found)
362 break;
365 out:
366 free (p);
367 if (d)
368 closedir (d);
370 return found;
374 static const bfd_target *
375 bfd_plugin_object_p (bfd *abfd)
377 if (ld_plugin_object_p)
378 return ld_plugin_object_p (abfd);
380 if (abfd->plugin_format == bfd_plugin_unknown && !load_plugin (abfd))
381 return NULL;
383 return abfd->plugin_format == bfd_plugin_yes ? abfd->xvec : NULL;
386 /* Copy any private info we understand from the input bfd
387 to the output bfd. */
389 static bfd_boolean
390 bfd_plugin_bfd_copy_private_bfd_data (bfd *ibfd ATTRIBUTE_UNUSED,
391 bfd *obfd ATTRIBUTE_UNUSED)
393 BFD_ASSERT (0);
394 return TRUE;
397 /* Copy any private info we understand from the input section
398 to the output section. */
400 static bfd_boolean
401 bfd_plugin_bfd_copy_private_section_data (bfd *ibfd ATTRIBUTE_UNUSED,
402 asection *isection ATTRIBUTE_UNUSED,
403 bfd *obfd ATTRIBUTE_UNUSED,
404 asection *osection ATTRIBUTE_UNUSED)
406 BFD_ASSERT (0);
407 return TRUE;
410 /* Copy any private info we understand from the input symbol
411 to the output symbol. */
413 static bfd_boolean
414 bfd_plugin_bfd_copy_private_symbol_data (bfd *ibfd ATTRIBUTE_UNUSED,
415 asymbol *isymbol ATTRIBUTE_UNUSED,
416 bfd *obfd ATTRIBUTE_UNUSED,
417 asymbol *osymbol ATTRIBUTE_UNUSED)
419 BFD_ASSERT (0);
420 return TRUE;
423 static bfd_boolean
424 bfd_plugin_bfd_print_private_bfd_data (bfd *abfd ATTRIBUTE_UNUSED, PTR ptr ATTRIBUTE_UNUSED)
426 BFD_ASSERT (0);
427 return TRUE;
430 static char *
431 bfd_plugin_core_file_failing_command (bfd *abfd ATTRIBUTE_UNUSED)
433 BFD_ASSERT (0);
434 return NULL;
437 static int
438 bfd_plugin_core_file_failing_signal (bfd *abfd ATTRIBUTE_UNUSED)
440 BFD_ASSERT (0);
441 return 0;
444 static int
445 bfd_plugin_core_file_pid (bfd *abfd ATTRIBUTE_UNUSED)
447 BFD_ASSERT (0);
448 return 0;
451 static long
452 bfd_plugin_get_symtab_upper_bound (bfd *abfd)
454 struct plugin_data_struct *plugin_data = abfd->tdata.plugin_data;
455 long nsyms = plugin_data->nsyms;
457 BFD_ASSERT (nsyms >= 0);
459 return ((nsyms + 1) * sizeof (asymbol *));
462 static flagword
463 convert_flags (const struct ld_plugin_symbol *sym)
465 switch (sym->def)
467 case LDPK_DEF:
468 case LDPK_COMMON:
469 case LDPK_UNDEF:
470 return BSF_GLOBAL;
472 case LDPK_WEAKUNDEF:
473 case LDPK_WEAKDEF:
474 return BSF_GLOBAL | BSF_WEAK;
476 default:
477 BFD_ASSERT (0);
478 return 0;
482 static long
483 bfd_plugin_canonicalize_symtab (bfd *abfd,
484 asymbol **alocation)
486 struct plugin_data_struct *plugin_data = abfd->tdata.plugin_data;
487 long nsyms = plugin_data->nsyms;
488 const struct ld_plugin_symbol *syms = plugin_data->syms;
489 static asection fake_section;
490 static asection fake_common_section;
491 int i;
493 fake_section.name = ".text";
494 fake_common_section.flags = SEC_IS_COMMON;
496 for (i = 0; i < nsyms; i++)
498 asymbol *s = bfd_alloc (abfd, sizeof (asymbol));
500 BFD_ASSERT (s);
501 alocation[i] = s;
503 s->the_bfd = abfd;
504 s->name = syms[i].name;
505 s->value = 0;
506 s->flags = convert_flags (&syms[i]);
507 switch (syms[i].def)
509 case LDPK_COMMON:
510 s->section = &fake_common_section;
511 break;
512 case LDPK_UNDEF:
513 case LDPK_WEAKUNDEF:
514 s->section = bfd_und_section_ptr;
515 break;
516 case LDPK_DEF:
517 case LDPK_WEAKDEF:
518 s->section = &fake_section;
519 break;
520 default:
521 BFD_ASSERT (0);
524 s->udata.p = (void *) &syms[i];
527 return nsyms;
530 static void
531 bfd_plugin_print_symbol (bfd *abfd ATTRIBUTE_UNUSED,
532 PTR afile ATTRIBUTE_UNUSED,
533 asymbol *symbol ATTRIBUTE_UNUSED,
534 bfd_print_symbol_type how ATTRIBUTE_UNUSED)
536 BFD_ASSERT (0);
539 static void
540 bfd_plugin_get_symbol_info (bfd *abfd ATTRIBUTE_UNUSED,
541 asymbol *symbol,
542 symbol_info *ret)
544 bfd_symbol_info (symbol, ret);
547 /* Make an empty symbol. */
549 static asymbol *
550 bfd_plugin_make_empty_symbol (bfd *abfd)
552 asymbol *new_symbol = bfd_zalloc (abfd, sizeof (asymbol));
553 if (new_symbol == NULL)
554 return new_symbol;
555 new_symbol->the_bfd = abfd;
556 return new_symbol;
559 static int
560 bfd_plugin_sizeof_headers (bfd *a ATTRIBUTE_UNUSED,
561 struct bfd_link_info *info ATTRIBUTE_UNUSED)
563 BFD_ASSERT (0);
564 return 0;
567 const bfd_target plugin_vec =
569 "plugin", /* Name. */
570 bfd_target_unknown_flavour,
571 BFD_ENDIAN_LITTLE, /* Target byte order. */
572 BFD_ENDIAN_LITTLE, /* Target headers byte order. */
573 (HAS_RELOC | EXEC_P | /* Object flags. */
574 HAS_LINENO | HAS_DEBUG |
575 HAS_SYMS | HAS_LOCALS | DYNAMIC | WP_TEXT | D_PAGED),
576 (SEC_CODE | SEC_DATA | SEC_ROM | SEC_HAS_CONTENTS
577 | SEC_ALLOC | SEC_LOAD | SEC_RELOC), /* Section flags. */
578 0, /* symbol_leading_char. */
579 '/', /* ar_pad_char. */
580 15, /* ar_max_namelen. */
581 255, /* match priority. */
583 bfd_getl64, bfd_getl_signed_64, bfd_putl64,
584 bfd_getl32, bfd_getl_signed_32, bfd_putl32,
585 bfd_getl16, bfd_getl_signed_16, bfd_putl16, /* data */
586 bfd_getl64, bfd_getl_signed_64, bfd_putl64,
587 bfd_getl32, bfd_getl_signed_32, bfd_putl32,
588 bfd_getl16, bfd_getl_signed_16, bfd_putl16, /* hdrs */
590 { /* bfd_check_format. */
591 _bfd_dummy_target,
592 bfd_plugin_object_p,
593 bfd_generic_archive_p,
594 _bfd_dummy_target
596 { /* bfd_set_format. */
597 bfd_false,
598 bfd_false,
599 _bfd_generic_mkarchive,
600 bfd_false,
602 { /* bfd_write_contents. */
603 bfd_false,
604 bfd_false,
605 _bfd_write_archive_contents,
606 bfd_false,
609 BFD_JUMP_TABLE_GENERIC (bfd_plugin),
610 BFD_JUMP_TABLE_COPY (bfd_plugin),
611 BFD_JUMP_TABLE_CORE (bfd_plugin),
612 #ifdef USE_64_BIT_ARCHIVE
613 BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_64_bit),
614 #else
615 BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_coff),
616 #endif
617 BFD_JUMP_TABLE_SYMBOLS (bfd_plugin),
618 BFD_JUMP_TABLE_RELOCS (_bfd_norelocs),
619 BFD_JUMP_TABLE_WRITE (bfd_plugin),
620 BFD_JUMP_TABLE_LINK (bfd_plugin),
621 BFD_JUMP_TABLE_DYNAMIC (_bfd_nodynamic),
623 NULL,
625 NULL /* backend_data. */
627 #endif /* BFD_SUPPORTS_PLUGIN */