[PATCH 28/57][Arm][GAS] Add support for MVE instructions: vqdmlah, vqrdmlah, vqdmlash...
[binutils-gdb.git] / ld / plugin.c
blobe3ca32406930ce52a59556b4a350a08fc8c1acf6
1 /* Plugin control for the GNU linker.
2 Copyright (C) 2010-2019 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 #include "sysdep.h"
22 #include "libiberty.h"
23 #include "bfd.h"
24 #include "bfdlink.h"
25 #include "bfdver.h"
26 #include "ld.h"
27 #include "ldmain.h"
28 #include "ldmisc.h"
29 #include "ldexp.h"
30 #include "ldlang.h"
31 #include "ldfile.h"
32 #include "plugin-api.h"
33 #include "../bfd/plugin.h"
34 #include "plugin.h"
35 #include "elf-bfd.h"
36 #if HAVE_MMAP
37 # include <sys/mman.h>
38 # ifndef MAP_FAILED
39 # define MAP_FAILED ((void *) -1)
40 # endif
41 # ifndef PROT_READ
42 # define PROT_READ 0
43 # endif
44 # ifndef MAP_PRIVATE
45 # define MAP_PRIVATE 0
46 # endif
47 #endif
48 #include <errno.h>
49 #if !(defined(errno) || defined(_MSC_VER) && defined(_INC_ERRNO))
50 extern int errno;
51 #endif
52 #if !defined (HAVE_DLFCN_H) && defined (HAVE_WINDOWS_H)
53 #include <windows.h>
54 #endif
56 /* Report plugin symbols. */
57 bfd_boolean report_plugin_symbols;
59 /* The suffix to append to the name of the real (claimed) object file
60 when generating a dummy BFD to hold the IR symbols sent from the
61 plugin. For cosmetic use only; appears in maps, crefs etc. */
62 #define IRONLY_SUFFIX " (symbol from plugin)"
64 /* Stores a single argument passed to a plugin. */
65 typedef struct plugin_arg
67 struct plugin_arg *next;
68 const char *arg;
69 } plugin_arg_t;
71 /* Holds all details of a single plugin. */
72 typedef struct plugin
74 /* Next on the list of plugins, or NULL at end of chain. */
75 struct plugin *next;
76 /* The argument string given to --plugin. */
77 const char *name;
78 /* The shared library handle returned by dlopen. */
79 void *dlhandle;
80 /* The list of argument string given to --plugin-opt. */
81 plugin_arg_t *args;
82 /* Number of args in the list, for convenience. */
83 size_t n_args;
84 /* The plugin's event handlers. */
85 ld_plugin_claim_file_handler claim_file_handler;
86 ld_plugin_all_symbols_read_handler all_symbols_read_handler;
87 ld_plugin_cleanup_handler cleanup_handler;
88 /* TRUE if the cleanup handlers have been called. */
89 bfd_boolean cleanup_done;
90 } plugin_t;
92 typedef struct view_buffer
94 char *addr;
95 size_t filesize;
96 off_t offset;
97 } view_buffer_t;
99 /* The internal version of struct ld_plugin_input_file with a BFD
100 pointer. */
101 typedef struct plugin_input_file
103 bfd *abfd;
104 view_buffer_t view_buffer;
105 char *name;
106 int fd;
107 bfd_boolean use_mmap;
108 off_t offset;
109 off_t filesize;
110 } plugin_input_file_t;
112 /* The master list of all plugins. */
113 static plugin_t *plugins_list = NULL;
115 /* We keep a tail pointer for easy linking on the end. */
116 static plugin_t **plugins_tail_chain_ptr = &plugins_list;
118 /* The last plugin added to the list, for receiving args. */
119 static plugin_t *last_plugin = NULL;
121 /* The tail of the arg chain of the last plugin added to the list. */
122 static plugin_arg_t **last_plugin_args_tail_chain_ptr = NULL;
124 /* The plugin which is currently having a callback executed. */
125 static plugin_t *called_plugin = NULL;
127 /* Last plugin to cause an error, if any. */
128 static const char *error_plugin = NULL;
130 /* State of linker "notice" interface before we poked at it. */
131 static bfd_boolean orig_notice_all;
133 /* Original linker callbacks, and the plugin version. */
134 static const struct bfd_link_callbacks *orig_callbacks;
135 static struct bfd_link_callbacks plugin_callbacks;
137 /* Set at all symbols read time, to avoid recursively offering the plugin
138 its own newly-added input files and libs to claim. */
139 bfd_boolean no_more_claiming = FALSE;
141 #if HAVE_MMAP && HAVE_GETPAGESIZE
142 /* Page size used by mmap. */
143 static off_t plugin_pagesize;
144 #endif
146 /* List of tags to set in the constant leading part of the tv array. */
147 static const enum ld_plugin_tag tv_header_tags[] =
149 LDPT_MESSAGE,
150 LDPT_API_VERSION,
151 LDPT_GNU_LD_VERSION,
152 LDPT_LINKER_OUTPUT,
153 LDPT_OUTPUT_NAME,
154 LDPT_REGISTER_CLAIM_FILE_HOOK,
155 LDPT_REGISTER_ALL_SYMBOLS_READ_HOOK,
156 LDPT_REGISTER_CLEANUP_HOOK,
157 LDPT_ADD_SYMBOLS,
158 LDPT_GET_INPUT_FILE,
159 LDPT_GET_VIEW,
160 LDPT_RELEASE_INPUT_FILE,
161 LDPT_GET_SYMBOLS,
162 LDPT_GET_SYMBOLS_V2,
163 LDPT_ADD_INPUT_FILE,
164 LDPT_ADD_INPUT_LIBRARY,
165 LDPT_SET_EXTRA_LIBRARY_PATH
168 /* How many entries in the constant leading part of the tv array. */
169 static const size_t tv_header_size = ARRAY_SIZE (tv_header_tags);
171 /* Forward references. */
172 static bfd_boolean plugin_notice (struct bfd_link_info *,
173 struct bfd_link_hash_entry *,
174 struct bfd_link_hash_entry *,
175 bfd *, asection *, bfd_vma, flagword);
177 static const bfd_target * plugin_object_p (bfd *);
179 #if !defined (HAVE_DLFCN_H) && defined (HAVE_WINDOWS_H)
181 #define RTLD_NOW 0 /* Dummy value. */
183 static void *
184 dlopen (const char *file, int mode ATTRIBUTE_UNUSED)
186 return LoadLibrary (file);
189 static void *
190 dlsym (void *handle, const char *name)
192 return GetProcAddress (handle, name);
195 static int
196 dlclose (void *handle)
198 FreeLibrary (handle);
199 return 0;
202 #endif /* !defined (HAVE_DLFCN_H) && defined (HAVE_WINDOWS_H) */
204 #ifndef HAVE_DLFCN_H
205 static const char *
206 dlerror (void)
208 return "";
210 #endif
212 /* Helper function for exiting with error status. */
213 static int
214 set_plugin_error (const char *plugin)
216 error_plugin = plugin;
217 return -1;
220 /* Test if an error occurred. */
221 static bfd_boolean
222 plugin_error_p (void)
224 return error_plugin != NULL;
227 /* Return name of plugin which caused an error if any. */
228 const char *
229 plugin_error_plugin (void)
231 return error_plugin ? error_plugin : _("<no plugin>");
234 /* Handle -plugin arg: find and load plugin, or return error. */
235 void
236 plugin_opt_plugin (const char *plugin)
238 plugin_t *newplug;
239 plugin_t *curplug = plugins_list;
241 newplug = xmalloc (sizeof *newplug);
242 memset (newplug, 0, sizeof *newplug);
243 newplug->name = plugin;
244 newplug->dlhandle = dlopen (plugin, RTLD_NOW);
245 if (!newplug->dlhandle)
246 einfo (_("%F%P: %s: error loading plugin: %s\n"), plugin, dlerror ());
248 /* Check if plugin has been loaded already. */
249 while (curplug)
251 if (newplug->dlhandle == curplug->dlhandle)
253 einfo (_("%P: %s: duplicated plugin\n"), plugin);
254 free (newplug);
255 return;
257 curplug = curplug->next;
260 /* Chain on end, so when we run list it is in command-line order. */
261 *plugins_tail_chain_ptr = newplug;
262 plugins_tail_chain_ptr = &newplug->next;
264 /* Record it as current plugin for receiving args. */
265 last_plugin = newplug;
266 last_plugin_args_tail_chain_ptr = &newplug->args;
269 /* Accumulate option arguments for last-loaded plugin, or return
270 error if none. */
272 plugin_opt_plugin_arg (const char *arg)
274 plugin_arg_t *newarg;
276 if (!last_plugin)
277 return set_plugin_error (_("<no plugin>"));
279 /* Ignore -pass-through= from GCC driver. */
280 if (*arg == '-')
282 const char *p = arg + 1;
284 if (*p == '-')
285 ++p;
286 if (strncmp (p, "pass-through=", 13) == 0)
287 return 0;
290 newarg = xmalloc (sizeof *newarg);
291 newarg->arg = arg;
292 newarg->next = NULL;
294 /* Chain on end to preserve command-line order. */
295 *last_plugin_args_tail_chain_ptr = newarg;
296 last_plugin_args_tail_chain_ptr = &newarg->next;
297 last_plugin->n_args++;
298 return 0;
301 /* Generate a dummy BFD to represent an IR file, for any callers of
302 plugin_call_claim_file to use as the handle in the ld_plugin_input_file
303 struct that they build to pass in. The BFD is initially writable, so
304 that symbols can be added to it; it must be made readable after the
305 add_symbols hook has been called so that it can be read when linking. */
306 static bfd *
307 plugin_get_ir_dummy_bfd (const char *name, bfd *srctemplate)
309 bfd *abfd;
310 bfd_boolean bfd_plugin_target;
312 bfd_use_reserved_id = 1;
313 bfd_plugin_target = bfd_plugin_target_p (srctemplate->xvec);
314 abfd = bfd_create (concat (name, IRONLY_SUFFIX, (const char *) NULL),
315 bfd_plugin_target ? link_info.output_bfd : srctemplate);
316 if (abfd != NULL)
318 abfd->flags |= BFD_LINKER_CREATED | BFD_PLUGIN;
319 if (!bfd_make_writable (abfd))
320 goto report_error;
321 if (!bfd_plugin_target)
323 bfd_set_arch_info (abfd, bfd_get_arch_info (srctemplate));
324 bfd_set_gp_size (abfd, bfd_get_gp_size (srctemplate));
325 if (!bfd_copy_private_bfd_data (srctemplate, abfd))
326 goto report_error;
329 flagword flags;
331 /* Create section to own the symbols. */
332 flags = (SEC_CODE | SEC_HAS_CONTENTS | SEC_READONLY
333 | SEC_ALLOC | SEC_LOAD | SEC_KEEP | SEC_EXCLUDE);
334 if (bfd_make_section_anyway_with_flags (abfd, ".text", flags))
335 return abfd;
338 report_error:
339 einfo (_("%F%P: could not create dummy IR bfd: %E\n"));
340 return NULL;
343 /* Check if the BFD passed in is an IR dummy object file. */
344 static inline bfd_boolean
345 is_ir_dummy_bfd (const bfd *abfd)
347 /* ABFD can sometimes legitimately be NULL, e.g. when called from one
348 of the linker callbacks for a symbol in the *ABS* or *UND* sections. */
349 return abfd != NULL && (abfd->flags & BFD_PLUGIN) != 0;
352 /* Helpers to convert between BFD and GOLD symbol formats. */
353 static enum ld_plugin_status
354 asymbol_from_plugin_symbol (bfd *abfd, asymbol *asym,
355 const struct ld_plugin_symbol *ldsym)
357 flagword flags = BSF_NO_FLAGS;
358 struct bfd_section *section;
360 asym->the_bfd = abfd;
361 asym->name = (ldsym->version
362 ? concat (ldsym->name, "@", ldsym->version, (const char *) NULL)
363 : ldsym->name);
364 asym->value = 0;
365 switch (ldsym->def)
367 case LDPK_WEAKDEF:
368 flags = BSF_WEAK;
369 /* FALLTHRU */
370 case LDPK_DEF:
371 flags |= BSF_GLOBAL;
372 if (ldsym->comdat_key)
374 char *name = concat (".gnu.linkonce.t.", ldsym->comdat_key,
375 (const char *) NULL);
376 section = bfd_get_section_by_name (abfd, name);
377 if (section != NULL)
378 free (name);
379 else
381 flagword sflags;
383 sflags = (SEC_CODE | SEC_HAS_CONTENTS | SEC_READONLY
384 | SEC_ALLOC | SEC_LOAD | SEC_KEEP | SEC_EXCLUDE
385 | SEC_LINK_ONCE | SEC_LINK_DUPLICATES_DISCARD);
386 section = bfd_make_section_anyway_with_flags (abfd, name, sflags);
387 if (section == NULL)
388 return LDPS_ERR;
391 else
392 section = bfd_get_section_by_name (abfd, ".text");
393 break;
395 case LDPK_WEAKUNDEF:
396 flags = BSF_WEAK;
397 /* FALLTHRU */
398 case LDPK_UNDEF:
399 section = bfd_und_section_ptr;
400 break;
402 case LDPK_COMMON:
403 flags = BSF_GLOBAL;
404 section = bfd_com_section_ptr;
405 asym->value = ldsym->size;
406 /* For ELF targets, set alignment of common symbol to 1. */
407 if (bfd_get_flavour (abfd) == bfd_target_elf_flavour)
409 ((elf_symbol_type *) asym)->internal_elf_sym.st_shndx = SHN_COMMON;
410 ((elf_symbol_type *) asym)->internal_elf_sym.st_value = 1;
412 break;
414 default:
415 return LDPS_ERR;
417 asym->flags = flags;
418 asym->section = section;
420 /* Visibility only applies on ELF targets. */
421 if (bfd_get_flavour (abfd) == bfd_target_elf_flavour)
423 elf_symbol_type *elfsym = elf_symbol_from (abfd, asym);
424 unsigned char visibility;
426 if (!elfsym)
427 einfo (_("%F%P: %s: non-ELF symbol in ELF BFD!\n"), asym->name);
428 switch (ldsym->visibility)
430 default:
431 einfo (_("%F%P: unknown ELF symbol visibility: %d!\n"),
432 ldsym->visibility);
433 return LDPS_ERR;
435 case LDPV_DEFAULT:
436 visibility = STV_DEFAULT;
437 break;
438 case LDPV_PROTECTED:
439 visibility = STV_PROTECTED;
440 break;
441 case LDPV_INTERNAL:
442 visibility = STV_INTERNAL;
443 break;
444 case LDPV_HIDDEN:
445 visibility = STV_HIDDEN;
446 break;
448 elfsym->internal_elf_sym.st_other
449 = (visibility | (elfsym->internal_elf_sym.st_other
450 & ~ELF_ST_VISIBILITY (-1)));
453 return LDPS_OK;
456 /* Register a claim-file handler. */
457 static enum ld_plugin_status
458 register_claim_file (ld_plugin_claim_file_handler handler)
460 ASSERT (called_plugin);
461 called_plugin->claim_file_handler = handler;
462 return LDPS_OK;
465 /* Register an all-symbols-read handler. */
466 static enum ld_plugin_status
467 register_all_symbols_read (ld_plugin_all_symbols_read_handler handler)
469 ASSERT (called_plugin);
470 called_plugin->all_symbols_read_handler = handler;
471 return LDPS_OK;
474 /* Register a cleanup handler. */
475 static enum ld_plugin_status
476 register_cleanup (ld_plugin_cleanup_handler handler)
478 ASSERT (called_plugin);
479 called_plugin->cleanup_handler = handler;
480 return LDPS_OK;
483 /* Add symbols from a plugin-claimed input file. */
484 static enum ld_plugin_status
485 add_symbols (void *handle, int nsyms, const struct ld_plugin_symbol *syms)
487 asymbol **symptrs;
488 plugin_input_file_t *input = handle;
489 bfd *abfd = input->abfd;
490 int n;
492 ASSERT (called_plugin);
493 symptrs = xmalloc (nsyms * sizeof *symptrs);
494 for (n = 0; n < nsyms; n++)
496 enum ld_plugin_status rv;
497 asymbol *bfdsym;
499 bfdsym = bfd_make_empty_symbol (abfd);
500 symptrs[n] = bfdsym;
501 rv = asymbol_from_plugin_symbol (abfd, bfdsym, syms + n);
502 if (rv != LDPS_OK)
503 return rv;
505 bfd_set_symtab (abfd, symptrs, nsyms);
506 return LDPS_OK;
509 /* Get the input file information with an open (possibly re-opened)
510 file descriptor. */
511 static enum ld_plugin_status
512 get_input_file (const void *handle, struct ld_plugin_input_file *file)
514 const plugin_input_file_t *input = handle;
516 ASSERT (called_plugin);
518 file->name = input->name;
519 file->offset = input->offset;
520 file->filesize = input->filesize;
521 file->handle = (void *) handle;
523 return LDPS_OK;
526 /* Get view of the input file. */
527 static enum ld_plugin_status
528 get_view (const void *handle, const void **viewp)
530 plugin_input_file_t *input = (plugin_input_file_t *) handle;
531 char *buffer;
532 size_t size = input->filesize;
533 off_t offset = input->offset;
534 #if HAVE_MMAP && HAVE_GETPAGESIZE
535 off_t bias;
536 #endif
538 ASSERT (called_plugin);
540 /* FIXME: einfo should support %lld. */
541 if ((off_t) size != input->filesize)
542 einfo (_("%F%P: unsupported input file size: %s (%ld bytes)\n"),
543 input->name, (long) input->filesize);
545 /* Check the cached view buffer. */
546 if (input->view_buffer.addr != NULL
547 && input->view_buffer.filesize == size
548 && input->view_buffer.offset == offset)
550 *viewp = input->view_buffer.addr;
551 return LDPS_OK;
554 input->view_buffer.filesize = size;
555 input->view_buffer.offset = offset;
557 #if HAVE_MMAP
558 # if HAVE_GETPAGESIZE
559 bias = offset % plugin_pagesize;
560 offset -= bias;
561 size += bias;
562 # endif
563 buffer = mmap (NULL, size, PROT_READ, MAP_PRIVATE, input->fd, offset);
564 if (buffer != MAP_FAILED)
566 input->use_mmap = TRUE;
567 # if HAVE_GETPAGESIZE
568 buffer += bias;
569 # endif
571 else
572 #endif
574 char *p;
576 input->use_mmap = FALSE;
578 if (lseek (input->fd, offset, SEEK_SET) < 0)
579 return LDPS_ERR;
581 buffer = bfd_alloc (input->abfd, size);
582 if (buffer == NULL)
583 return LDPS_ERR;
585 p = buffer;
588 ssize_t got = read (input->fd, p, size);
589 if (got == 0)
590 break;
591 else if (got > 0)
593 p += got;
594 size -= got;
596 else if (errno != EINTR)
597 return LDPS_ERR;
599 while (size > 0);
602 input->view_buffer.addr = buffer;
603 *viewp = buffer;
605 return LDPS_OK;
608 /* Release the input file. */
609 static enum ld_plugin_status
610 release_input_file (const void *handle)
612 plugin_input_file_t *input = (plugin_input_file_t *) handle;
613 ASSERT (called_plugin);
614 if (input->fd != -1)
616 close (input->fd);
617 input->fd = -1;
619 return LDPS_OK;
622 /* Return TRUE if a defined symbol might be reachable from outside the
623 universe of claimed objects. */
624 static inline bfd_boolean
625 is_visible_from_outside (struct ld_plugin_symbol *lsym,
626 struct bfd_link_hash_entry *blhe)
628 if (bfd_link_relocatable (&link_info))
629 return TRUE;
630 if (blhe->non_ir_ref_dynamic
631 || link_info.export_dynamic
632 || bfd_link_dll (&link_info))
634 /* Check if symbol is hidden by version script. */
635 if (bfd_hide_sym_by_version (link_info.version_info,
636 blhe->root.string))
637 return FALSE;
638 /* Only ELF symbols really have visibility. */
639 if (bfd_get_flavour (link_info.output_bfd) == bfd_target_elf_flavour)
641 struct elf_link_hash_entry *el = (struct elf_link_hash_entry *)blhe;
642 int vis = ELF_ST_VISIBILITY (el->other);
643 return vis == STV_DEFAULT || vis == STV_PROTECTED;
645 /* On non-ELF targets, we can safely make inferences by considering
646 what visibility the plugin would have liked to apply when it first
647 sent us the symbol. During ELF symbol processing, visibility only
648 ever becomes more restrictive, not less, when symbols are merged,
649 so this is a conservative estimate; it may give false positives,
650 declaring something visible from outside when it in fact would
651 not have been, but this will only lead to missed optimisation
652 opportunities during LTRANS at worst; it will not give false
653 negatives, which can lead to the disastrous conclusion that the
654 related symbol is IRONLY. (See GCC PR46319 for an example.) */
655 return (lsym->visibility == LDPV_DEFAULT
656 || lsym->visibility == LDPV_PROTECTED);
659 return FALSE;
662 /* Return LTO kind string name that corresponds to INDEX enum value. */
663 static const char *
664 get_lto_kind (unsigned int index)
666 static char buffer[64];
667 const char *lto_kind_str[5] =
669 "DEF",
670 "WEAKDEF",
671 "UNDEF",
672 "WEAKUNDEF",
673 "COMMON"
676 if (index < ARRAY_SIZE (lto_kind_str))
677 return lto_kind_str [index];
679 sprintf (buffer, _("unknown LTO kind value %x"), index);
680 return buffer;
683 /* Return LTO resolution string name that corresponds to INDEX enum value. */
684 static const char *
685 get_lto_resolution (unsigned int index)
687 static char buffer[64];
688 static const char *lto_resolution_str[10] =
690 "UNKNOWN",
691 "UNDEF",
692 "PREVAILING_DEF",
693 "PREVAILING_DEF_IRONLY",
694 "PREEMPTED_REG",
695 "PREEMPTED_IR",
696 "RESOLVED_IR",
697 "RESOLVED_EXEC",
698 "RESOLVED_DYN",
699 "PREVAILING_DEF_IRONLY_EXP",
702 if (index < ARRAY_SIZE (lto_resolution_str))
703 return lto_resolution_str [index];
705 sprintf (buffer, _("unknown LTO resolution value %x"), index);
706 return buffer;
709 /* Return LTO visibility string name that corresponds to INDEX enum value. */
710 static const char *
711 get_lto_visibility (unsigned int index)
713 static char buffer[64];
714 const char *lto_visibility_str[4] =
716 "DEFAULT",
717 "PROTECTED",
718 "INTERNAL",
719 "HIDDEN"
722 if (index < ARRAY_SIZE (lto_visibility_str))
723 return lto_visibility_str [index];
725 sprintf (buffer, _("unknown LTO visibility value %x"), index);
726 return buffer;
729 /* Get the symbol resolution info for a plugin-claimed input file. */
730 static enum ld_plugin_status
731 get_symbols (const void *handle, int nsyms, struct ld_plugin_symbol *syms,
732 int def_ironly_exp)
734 const plugin_input_file_t *input = handle;
735 const bfd *abfd = (const bfd *) input->abfd;
736 int n;
738 ASSERT (called_plugin);
739 for (n = 0; n < nsyms; n++)
741 struct bfd_link_hash_entry *blhe;
742 asection *owner_sec;
743 int res;
744 struct bfd_link_hash_entry *h
745 = bfd_link_hash_lookup (link_info.hash, syms[n].name,
746 FALSE, FALSE, TRUE);
747 enum { wrap_none, wrapper, wrapped } wrap_status = wrap_none;
749 if (syms[n].def != LDPK_UNDEF && syms[n].def != LDPK_WEAKUNDEF)
751 blhe = h;
752 if (blhe)
754 /* Check if a symbol is a wrapper symbol. */
755 struct bfd_link_hash_entry *unwrap
756 = unwrap_hash_lookup (&link_info, (bfd *) abfd, blhe);
757 if (unwrap && unwrap != h)
758 wrap_status = wrapper;
761 else
763 blhe = bfd_wrapped_link_hash_lookup (link_info.output_bfd,
764 &link_info, syms[n].name,
765 FALSE, FALSE, TRUE);
766 /* Check if a symbol is a wrapped symbol. */
767 if (blhe && blhe != h)
768 wrap_status = wrapped;
770 if (!blhe)
772 /* The plugin is called to claim symbols in an archive element
773 from plugin_object_p. But those symbols aren't needed to
774 create output. They are defined and referenced only within
775 IR. */
776 switch (syms[n].def)
778 default:
779 abort ();
780 case LDPK_UNDEF:
781 case LDPK_WEAKUNDEF:
782 res = LDPR_UNDEF;
783 break;
784 case LDPK_DEF:
785 case LDPK_WEAKDEF:
786 case LDPK_COMMON:
787 res = LDPR_PREVAILING_DEF_IRONLY;
788 break;
790 goto report_symbol;
793 /* Determine resolution from blhe type and symbol's original type. */
794 if (blhe->type == bfd_link_hash_undefined
795 || blhe->type == bfd_link_hash_undefweak)
797 res = LDPR_UNDEF;
798 goto report_symbol;
800 if (blhe->type != bfd_link_hash_defined
801 && blhe->type != bfd_link_hash_defweak
802 && blhe->type != bfd_link_hash_common)
804 /* We should not have a new, indirect or warning symbol here. */
805 einfo (_("%F%P: %s: plugin symbol table corrupt (sym type %d)\n"),
806 called_plugin->name, blhe->type);
809 /* Find out which section owns the symbol. Since it's not undef,
810 it must have an owner; if it's not a common symbol, both defs
811 and weakdefs keep it in the same place. */
812 owner_sec = (blhe->type == bfd_link_hash_common
813 ? blhe->u.c.p->section
814 : blhe->u.def.section);
817 /* If it was originally undefined or common, then it has been
818 resolved; determine how. */
819 if (syms[n].def == LDPK_UNDEF
820 || syms[n].def == LDPK_WEAKUNDEF
821 || syms[n].def == LDPK_COMMON)
823 if (owner_sec->owner == link_info.output_bfd)
824 res = LDPR_RESOLVED_EXEC;
825 else if (owner_sec->owner == abfd)
826 res = LDPR_PREVAILING_DEF_IRONLY;
827 else if (is_ir_dummy_bfd (owner_sec->owner))
828 res = LDPR_RESOLVED_IR;
829 else if (owner_sec->owner != NULL
830 && (owner_sec->owner->flags & DYNAMIC) != 0)
831 res = LDPR_RESOLVED_DYN;
832 else
833 res = LDPR_RESOLVED_EXEC;
836 /* Was originally def, or weakdef. Does it prevail? If the
837 owner is the original dummy bfd that supplied it, then this
838 is the definition that has prevailed. */
839 else if (owner_sec->owner == link_info.output_bfd)
840 res = LDPR_PREEMPTED_REG;
841 else if (owner_sec->owner == abfd)
842 res = LDPR_PREVAILING_DEF_IRONLY;
844 /* Was originally def, weakdef, or common, but has been pre-empted. */
845 else if (is_ir_dummy_bfd (owner_sec->owner))
846 res = LDPR_PREEMPTED_IR;
847 else
848 res = LDPR_PREEMPTED_REG;
850 if (res == LDPR_PREVAILING_DEF_IRONLY)
852 /* We need to know if the sym is referenced from non-IR files. Or
853 even potentially-referenced, perhaps in a future final link if
854 this is a partial one, perhaps dynamically at load-time if the
855 symbol is externally visible. Also check for wrapper symbol. */
856 if (blhe->non_ir_ref_regular || wrap_status == wrapper)
857 res = LDPR_PREVAILING_DEF;
858 else if (wrap_status == wrapped)
859 res = LDPR_RESOLVED_IR;
860 else if (is_visible_from_outside (&syms[n], blhe))
861 res = def_ironly_exp;
864 report_symbol:
865 syms[n].resolution = res;
866 if (report_plugin_symbols)
867 einfo (_("%P: %pB: symbol `%s' "
868 "definition: %s, visibility: %s, resolution: %s\n"),
869 abfd, syms[n].name,
870 get_lto_kind (syms[n].def),
871 get_lto_visibility (syms[n].visibility),
872 get_lto_resolution (res));
874 return LDPS_OK;
877 static enum ld_plugin_status
878 get_symbols_v1 (const void *handle, int nsyms, struct ld_plugin_symbol *syms)
880 return get_symbols (handle, nsyms, syms, LDPR_PREVAILING_DEF);
883 static enum ld_plugin_status
884 get_symbols_v2 (const void *handle, int nsyms, struct ld_plugin_symbol *syms)
886 return get_symbols (handle, nsyms, syms, LDPR_PREVAILING_DEF_IRONLY_EXP);
889 /* Add a new (real) input file generated by a plugin. */
890 static enum ld_plugin_status
891 add_input_file (const char *pathname)
893 lang_input_statement_type *is;
895 ASSERT (called_plugin);
896 is = lang_add_input_file (xstrdup (pathname), lang_input_file_is_file_enum,
897 NULL);
898 if (!is)
899 return LDPS_ERR;
900 is->flags.lto_output = 1;
901 return LDPS_OK;
904 /* Add a new (real) library required by a plugin. */
905 static enum ld_plugin_status
906 add_input_library (const char *pathname)
908 lang_input_statement_type *is;
910 ASSERT (called_plugin);
911 is = lang_add_input_file (xstrdup (pathname), lang_input_file_is_l_enum,
912 NULL);
913 if (!is)
914 return LDPS_ERR;
915 is->flags.lto_output = 1;
916 return LDPS_OK;
919 /* Set the extra library path to be used by libraries added via
920 add_input_library. */
921 static enum ld_plugin_status
922 set_extra_library_path (const char *path)
924 ASSERT (called_plugin);
925 ldfile_add_library_path (xstrdup (path), FALSE);
926 return LDPS_OK;
929 /* Issue a diagnostic message from a plugin. */
930 static enum ld_plugin_status
931 message (int level, const char *format, ...)
933 va_list args;
934 va_start (args, format);
936 switch (level)
938 case LDPL_INFO:
939 vfinfo (stdout, format, args, FALSE);
940 putchar ('\n');
941 break;
942 case LDPL_WARNING:
944 char *newfmt = concat (_("%P: warning: "), format, "\n",
945 (const char *) NULL);
946 vfinfo (stdout, newfmt, args, TRUE);
947 free (newfmt);
949 break;
950 case LDPL_FATAL:
951 case LDPL_ERROR:
952 default:
954 char *newfmt = concat (level == LDPL_FATAL ? "%F" : "%X",
955 _("%P: error: "), format, "\n",
956 (const char *) NULL);
957 fflush (stdout);
958 vfinfo (stderr, newfmt, args, TRUE);
959 fflush (stderr);
960 free (newfmt);
962 break;
965 va_end (args);
966 return LDPS_OK;
969 /* Helper to size leading part of tv array and set it up. */
970 static void
971 set_tv_header (struct ld_plugin_tv *tv)
973 size_t i;
975 /* Version info. */
976 static const unsigned int major = (unsigned)(BFD_VERSION / 100000000UL);
977 static const unsigned int minor = (unsigned)(BFD_VERSION / 1000000UL) % 100;
979 for (i = 0; i < tv_header_size; i++)
981 tv[i].tv_tag = tv_header_tags[i];
982 #define TVU(x) tv[i].tv_u.tv_ ## x
983 switch (tv[i].tv_tag)
985 case LDPT_MESSAGE:
986 TVU(message) = message;
987 break;
988 case LDPT_API_VERSION:
989 TVU(val) = LD_PLUGIN_API_VERSION;
990 break;
991 case LDPT_GNU_LD_VERSION:
992 TVU(val) = major * 100 + minor;
993 break;
994 case LDPT_LINKER_OUTPUT:
995 TVU(val) = (bfd_link_relocatable (&link_info) ? LDPO_REL
996 : bfd_link_pde (&link_info) ? LDPO_EXEC
997 : bfd_link_pie (&link_info) ? LDPO_PIE
998 : LDPO_DYN);
999 break;
1000 case LDPT_OUTPUT_NAME:
1001 TVU(string) = output_filename;
1002 break;
1003 case LDPT_REGISTER_CLAIM_FILE_HOOK:
1004 TVU(register_claim_file) = register_claim_file;
1005 break;
1006 case LDPT_REGISTER_ALL_SYMBOLS_READ_HOOK:
1007 TVU(register_all_symbols_read) = register_all_symbols_read;
1008 break;
1009 case LDPT_REGISTER_CLEANUP_HOOK:
1010 TVU(register_cleanup) = register_cleanup;
1011 break;
1012 case LDPT_ADD_SYMBOLS:
1013 TVU(add_symbols) = add_symbols;
1014 break;
1015 case LDPT_GET_INPUT_FILE:
1016 TVU(get_input_file) = get_input_file;
1017 break;
1018 case LDPT_GET_VIEW:
1019 TVU(get_view) = get_view;
1020 break;
1021 case LDPT_RELEASE_INPUT_FILE:
1022 TVU(release_input_file) = release_input_file;
1023 break;
1024 case LDPT_GET_SYMBOLS:
1025 TVU(get_symbols) = get_symbols_v1;
1026 break;
1027 case LDPT_GET_SYMBOLS_V2:
1028 TVU(get_symbols) = get_symbols_v2;
1029 break;
1030 case LDPT_ADD_INPUT_FILE:
1031 TVU(add_input_file) = add_input_file;
1032 break;
1033 case LDPT_ADD_INPUT_LIBRARY:
1034 TVU(add_input_library) = add_input_library;
1035 break;
1036 case LDPT_SET_EXTRA_LIBRARY_PATH:
1037 TVU(set_extra_library_path) = set_extra_library_path;
1038 break;
1039 default:
1040 /* Added a new entry to the array without adding
1041 a new case to set up its value is a bug. */
1042 FAIL ();
1044 #undef TVU
1048 /* Append the per-plugin args list and trailing LDPT_NULL to tv. */
1049 static void
1050 set_tv_plugin_args (plugin_t *plugin, struct ld_plugin_tv *tv)
1052 plugin_arg_t *arg = plugin->args;
1053 while (arg)
1055 tv->tv_tag = LDPT_OPTION;
1056 tv->tv_u.tv_string = arg->arg;
1057 arg = arg->next;
1058 tv++;
1060 tv->tv_tag = LDPT_NULL;
1061 tv->tv_u.tv_val = 0;
1064 /* Load up and initialise all plugins after argument parsing. */
1065 void
1066 plugin_load_plugins (void)
1068 struct ld_plugin_tv *my_tv;
1069 unsigned int max_args = 0;
1070 plugin_t *curplug = plugins_list;
1072 /* If there are no plugins, we need do nothing this run. */
1073 if (!curplug)
1074 return;
1076 /* First pass over plugins to find max # args needed so that we
1077 can size and allocate the tv array. */
1078 while (curplug)
1080 if (curplug->n_args > max_args)
1081 max_args = curplug->n_args;
1082 curplug = curplug->next;
1085 /* Allocate tv array and initialise constant part. */
1086 my_tv = xmalloc ((max_args + 1 + tv_header_size) * sizeof *my_tv);
1087 set_tv_header (my_tv);
1089 /* Pass over plugins again, activating them. */
1090 curplug = plugins_list;
1091 while (curplug)
1093 enum ld_plugin_status rv;
1094 ld_plugin_onload onloadfn;
1096 onloadfn = (ld_plugin_onload) dlsym (curplug->dlhandle, "onload");
1097 if (!onloadfn)
1098 onloadfn = (ld_plugin_onload) dlsym (curplug->dlhandle, "_onload");
1099 if (!onloadfn)
1100 einfo (_("%F%P: %s: error loading plugin: %s\n"),
1101 curplug->name, dlerror ());
1102 set_tv_plugin_args (curplug, &my_tv[tv_header_size]);
1103 called_plugin = curplug;
1104 rv = (*onloadfn) (my_tv);
1105 called_plugin = NULL;
1106 if (rv != LDPS_OK)
1107 einfo (_("%F%P: %s: plugin error: %d\n"), curplug->name, rv);
1108 curplug = curplug->next;
1111 /* Since plugin(s) inited ok, assume they're going to want symbol
1112 resolutions, which needs us to track which symbols are referenced
1113 by non-IR files using the linker's notice callback. */
1114 orig_notice_all = link_info.notice_all;
1115 orig_callbacks = link_info.callbacks;
1116 plugin_callbacks = *orig_callbacks;
1117 plugin_callbacks.notice = &plugin_notice;
1118 link_info.notice_all = TRUE;
1119 link_info.lto_plugin_active = TRUE;
1120 link_info.callbacks = &plugin_callbacks;
1122 register_ld_plugin_object_p (plugin_object_p);
1124 #if HAVE_MMAP && HAVE_GETPAGESIZE
1125 plugin_pagesize = getpagesize ();
1126 #endif
1129 /* Call 'claim file' hook for all plugins. */
1130 static int
1131 plugin_call_claim_file (const struct ld_plugin_input_file *file, int *claimed)
1133 plugin_t *curplug = plugins_list;
1134 *claimed = FALSE;
1135 while (curplug && !*claimed)
1137 if (curplug->claim_file_handler)
1139 enum ld_plugin_status rv;
1141 called_plugin = curplug;
1142 rv = (*curplug->claim_file_handler) (file, claimed);
1143 called_plugin = NULL;
1144 if (rv != LDPS_OK)
1145 set_plugin_error (curplug->name);
1147 curplug = curplug->next;
1149 return plugin_error_p () ? -1 : 0;
1152 /* Duplicates a character string with memory attached to ABFD. */
1154 static char *
1155 plugin_strdup (bfd *abfd, const char *str)
1157 size_t strlength;
1158 char *copy;
1159 strlength = strlen (str) + 1;
1160 copy = bfd_alloc (abfd, strlength);
1161 if (copy == NULL)
1162 einfo (_("%F%P: plugin_strdup failed to allocate memory: %s\n"),
1163 bfd_get_error ());
1164 memcpy (copy, str, strlength);
1165 return copy;
1168 static const bfd_target *
1169 plugin_object_p (bfd *ibfd)
1171 int claimed;
1172 plugin_input_file_t *input;
1173 struct ld_plugin_input_file file;
1174 bfd *abfd;
1176 /* Don't try the dummy object file. */
1177 if ((ibfd->flags & BFD_PLUGIN) != 0)
1178 return NULL;
1180 if (ibfd->plugin_format != bfd_plugin_unknown)
1182 if (ibfd->plugin_format == bfd_plugin_yes)
1183 return ibfd->plugin_dummy_bfd->xvec;
1184 else
1185 return NULL;
1188 /* We create a dummy BFD, initially empty, to house whatever symbols
1189 the plugin may want to add. */
1190 abfd = plugin_get_ir_dummy_bfd (ibfd->filename, ibfd);
1192 input = bfd_alloc (abfd, sizeof (*input));
1193 if (input == NULL)
1194 einfo (_("%F%P: plugin failed to allocate memory for input: %s\n"),
1195 bfd_get_error ());
1197 if (!bfd_plugin_open_input (ibfd, &file))
1198 return NULL;
1200 if (file.name == ibfd->filename)
1202 /* We must copy filename attached to ibfd if it is not an archive
1203 member since it may be freed by bfd_close below. */
1204 file.name = plugin_strdup (abfd, file.name);
1207 file.handle = input;
1208 input->abfd = abfd;
1209 input->view_buffer.addr = NULL;
1210 input->view_buffer.filesize = 0;
1211 input->view_buffer.offset = 0;
1212 input->fd = file.fd;
1213 input->use_mmap = FALSE;
1214 input->offset = file.offset;
1215 input->filesize = file.filesize;
1216 input->name = plugin_strdup (abfd, ibfd->filename);
1218 claimed = 0;
1220 if (plugin_call_claim_file (&file, &claimed))
1221 einfo (_("%F%P: %s: plugin reported error claiming file\n"),
1222 plugin_error_plugin ());
1224 if (input->fd != -1 && !bfd_plugin_target_p (ibfd->xvec))
1226 /* FIXME: fd belongs to us, not the plugin. GCC plugin, which
1227 doesn't need fd after plugin_call_claim_file, doesn't use
1228 BFD plugin target vector. Since GCC plugin doesn't call
1229 release_input_file, we close it here. LLVM plugin, which
1230 needs fd after plugin_call_claim_file and calls
1231 release_input_file after it is done, uses BFD plugin target
1232 vector. This scheme doesn't work when a plugin needs fd and
1233 doesn't use BFD plugin target vector neither. */
1234 close (input->fd);
1235 input->fd = -1;
1238 if (claimed)
1240 ibfd->plugin_format = bfd_plugin_yes;
1241 ibfd->plugin_dummy_bfd = abfd;
1242 bfd_make_readable (abfd);
1243 return abfd->xvec;
1245 else
1247 #if HAVE_MMAP
1248 if (input->use_mmap)
1250 /* If plugin didn't claim the file, unmap the buffer. */
1251 char *addr = input->view_buffer.addr;
1252 off_t size = input->view_buffer.filesize;
1253 # if HAVE_GETPAGESIZE
1254 off_t bias = input->view_buffer.offset % plugin_pagesize;
1255 size += bias;
1256 addr -= bias;
1257 # endif
1258 munmap (addr, size);
1260 #endif
1262 /* If plugin didn't claim the file, we don't need the dummy bfd.
1263 Can't avoid speculatively creating it, alas. */
1264 ibfd->plugin_format = bfd_plugin_no;
1265 bfd_close_all_done (abfd);
1266 return NULL;
1270 void
1271 plugin_maybe_claim (lang_input_statement_type *entry)
1273 ASSERT (entry->header.type == lang_input_statement_enum);
1274 if (plugin_object_p (entry->the_bfd))
1276 bfd *abfd = entry->the_bfd->plugin_dummy_bfd;
1278 /* Discard the real file's BFD and substitute the dummy one. */
1280 /* We can't call bfd_close on archives. BFD archive handling
1281 caches elements, and add_archive_element keeps pointers to
1282 the_bfd and the_bfd->filename in a lang_input_statement_type
1283 linker script statement. */
1284 if (entry->the_bfd->my_archive == NULL)
1285 bfd_close (entry->the_bfd);
1286 entry->the_bfd = abfd;
1287 entry->flags.claimed = 1;
1291 /* Call 'all symbols read' hook for all plugins. */
1293 plugin_call_all_symbols_read (void)
1295 plugin_t *curplug = plugins_list;
1297 /* Disable any further file-claiming. */
1298 no_more_claiming = TRUE;
1300 while (curplug)
1302 if (curplug->all_symbols_read_handler)
1304 enum ld_plugin_status rv;
1305 called_plugin = curplug;
1306 rv = (*curplug->all_symbols_read_handler) ();
1307 called_plugin = NULL;
1308 if (rv != LDPS_OK)
1309 set_plugin_error (curplug->name);
1311 curplug = curplug->next;
1313 return plugin_error_p () ? -1 : 0;
1316 /* Call 'cleanup' hook for all plugins at exit. */
1317 void
1318 plugin_call_cleanup (void)
1320 plugin_t *curplug = plugins_list;
1321 while (curplug)
1323 if (curplug->cleanup_handler && !curplug->cleanup_done)
1325 enum ld_plugin_status rv;
1326 curplug->cleanup_done = TRUE;
1327 called_plugin = curplug;
1328 rv = (*curplug->cleanup_handler) ();
1329 called_plugin = NULL;
1330 if (rv != LDPS_OK)
1331 info_msg (_("%P: %s: error in plugin cleanup: %d (ignored)\n"),
1332 curplug->name, rv);
1333 dlclose (curplug->dlhandle);
1335 curplug = curplug->next;
1339 /* To determine which symbols should be resolved LDPR_PREVAILING_DEF
1340 and which LDPR_PREVAILING_DEF_IRONLY, we notice all the symbols as
1341 the linker adds them to the linker hash table. Mark those
1342 referenced from a non-IR file with non_ir_ref_regular or
1343 non_ir_ref_dynamic as appropriate. We have to notice_all symbols,
1344 because we won't necessarily know until later which ones will be
1345 contributed by IR files. */
1346 static bfd_boolean
1347 plugin_notice (struct bfd_link_info *info,
1348 struct bfd_link_hash_entry *h,
1349 struct bfd_link_hash_entry *inh,
1350 bfd *abfd,
1351 asection *section,
1352 bfd_vma value,
1353 flagword flags)
1355 struct bfd_link_hash_entry *orig_h = h;
1357 if (h != NULL)
1359 bfd *sym_bfd;
1360 bfd_boolean ref = FALSE;
1362 if (h->type == bfd_link_hash_warning)
1363 h = h->u.i.link;
1365 /* Nothing to do here if this def/ref is from an IR dummy BFD. */
1366 if (is_ir_dummy_bfd (abfd))
1369 /* Making an indirect symbol counts as a reference unless this
1370 is a brand new symbol. */
1371 else if (bfd_is_ind_section (section)
1372 || (flags & BSF_INDIRECT) != 0)
1374 /* ??? Some of this is questionable. See comments in
1375 _bfd_generic_link_add_one_symbol for case IND. */
1376 if (h->type != bfd_link_hash_new
1377 || inh->type == bfd_link_hash_new)
1379 if ((abfd->flags & DYNAMIC) == 0)
1380 inh->non_ir_ref_regular = TRUE;
1381 else
1382 inh->non_ir_ref_dynamic = TRUE;
1385 if (h->type != bfd_link_hash_new)
1386 ref = TRUE;
1389 /* Nothing to do here for warning symbols. */
1390 else if ((flags & BSF_WARNING) != 0)
1393 /* Nothing to do here for constructor symbols. */
1394 else if ((flags & BSF_CONSTRUCTOR) != 0)
1397 /* If this is a ref, set non_ir_ref. */
1398 else if (bfd_is_und_section (section))
1400 /* Replace the undefined dummy bfd with the real one. */
1401 if ((h->type == bfd_link_hash_undefined
1402 || h->type == bfd_link_hash_undefweak)
1403 && (h->u.undef.abfd == NULL
1404 || (h->u.undef.abfd->flags & BFD_PLUGIN) != 0))
1405 h->u.undef.abfd = abfd;
1406 ref = TRUE;
1409 /* Otherwise, it must be a new def. */
1410 else
1412 /* Ensure any symbol defined in an IR dummy BFD takes on a
1413 new value from a real BFD. Weak symbols are not normally
1414 overridden by a new weak definition, and strong symbols
1415 will normally cause multiple definition errors. Avoid
1416 this by making the symbol appear to be undefined. */
1417 if (((h->type == bfd_link_hash_defweak
1418 || h->type == bfd_link_hash_defined)
1419 && is_ir_dummy_bfd (sym_bfd = h->u.def.section->owner))
1420 || (h->type == bfd_link_hash_common
1421 && is_ir_dummy_bfd (sym_bfd = h->u.c.p->section->owner)))
1423 h->type = bfd_link_hash_undefweak;
1424 h->u.undef.abfd = sym_bfd;
1427 /* A common symbol should be merged with other commons or
1428 defs with the same name. In particular, a common ought
1429 to be overridden by a def in a -flto object. In that
1430 sense a common is also a ref. */
1431 if (bfd_is_com_section (section))
1432 ref = TRUE;
1435 if (ref)
1437 if ((abfd->flags & DYNAMIC) == 0)
1438 h->non_ir_ref_regular = TRUE;
1439 else
1440 h->non_ir_ref_dynamic = TRUE;
1444 /* Continue with cref/nocrossref/trace-sym processing. */
1445 if (orig_h == NULL
1446 || orig_notice_all
1447 || (info->notice_hash != NULL
1448 && bfd_hash_lookup (info->notice_hash, orig_h->root.string,
1449 FALSE, FALSE) != NULL))
1450 return (*orig_callbacks->notice) (info, orig_h, inh,
1451 abfd, section, value, flags);
1452 return TRUE;