Add support for DragonFlyBSD target.
[binutils.git] / gold / plugin.cc
blob7e259e0803345875e9a1938e5b31560db876e1b7
1 // plugin.cc -- plugin manager for gold -*- C++ -*-
3 // Copyright 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
4 // Written by Cary Coutant <ccoutant@google.com>.
6 // This file is part of gold.
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 #include "gold.h"
25 #include <cstdio>
26 #include <cstdarg>
27 #include <cstring>
28 #include <string>
29 #include <vector>
31 #ifdef ENABLE_PLUGINS
32 #include <dlfcn.h>
33 #endif
35 #include "parameters.h"
36 #include "errors.h"
37 #include "fileread.h"
38 #include "layout.h"
39 #include "options.h"
40 #include "plugin.h"
41 #include "target.h"
42 #include "readsyms.h"
43 #include "symtab.h"
44 #include "elfcpp.h"
46 namespace gold
49 #ifdef ENABLE_PLUGINS
51 // The linker's exported interfaces.
53 extern "C"
56 static enum ld_plugin_status
57 register_claim_file(ld_plugin_claim_file_handler handler);
59 static enum ld_plugin_status
60 register_all_symbols_read(ld_plugin_all_symbols_read_handler handler);
62 static enum ld_plugin_status
63 register_cleanup(ld_plugin_cleanup_handler handler);
65 static enum ld_plugin_status
66 add_symbols(void *handle, int nsyms, const struct ld_plugin_symbol *syms);
68 static enum ld_plugin_status
69 get_input_file(const void *handle, struct ld_plugin_input_file *file);
71 static enum ld_plugin_status
72 get_view(const void *handle, const void **viewp);
74 static enum ld_plugin_status
75 release_input_file(const void *handle);
77 static enum ld_plugin_status
78 get_symbols(const void *handle, int nsyms, struct ld_plugin_symbol *syms);
80 static enum ld_plugin_status
81 add_input_file(const char *pathname);
83 static enum ld_plugin_status
84 add_input_library(const char *pathname);
86 static enum ld_plugin_status
87 set_extra_library_path(const char *path);
89 static enum ld_plugin_status
90 message(int level, const char *format, ...);
94 #endif // ENABLE_PLUGINS
96 static Pluginobj* make_sized_plugin_object(Input_file* input_file,
97 off_t offset, off_t filesize);
99 // Plugin methods.
101 // Load one plugin library.
103 void
104 Plugin::load()
106 #ifdef ENABLE_PLUGINS
107 // Load the plugin library.
108 // FIXME: Look for the library in standard locations.
109 this->handle_ = dlopen(this->filename_.c_str(), RTLD_NOW);
110 if (this->handle_ == NULL)
112 gold_error(_("%s: could not load plugin library: %s"),
113 this->filename_.c_str(), dlerror());
114 return;
117 // Find the plugin's onload entry point.
118 void* ptr = dlsym(this->handle_, "onload");
119 if (ptr == NULL)
121 gold_error(_("%s: could not find onload entry point"),
122 this->filename_.c_str());
123 return;
125 ld_plugin_onload onload;
126 gold_assert(sizeof(onload) == sizeof(ptr));
127 memcpy(&onload, &ptr, sizeof(ptr));
129 // Get the linker's version number.
130 const char* ver = get_version_string();
131 int major = 0;
132 int minor = 0;
133 sscanf(ver, "%d.%d", &major, &minor);
135 // Allocate and populate a transfer vector.
136 const int tv_fixed_size = 17;
137 int tv_size = this->args_.size() + tv_fixed_size;
138 ld_plugin_tv* tv = new ld_plugin_tv[tv_size];
140 // Put LDPT_MESSAGE at the front of the list so the plugin can use it
141 // while processing subsequent entries.
142 int i = 0;
143 tv[i].tv_tag = LDPT_MESSAGE;
144 tv[i].tv_u.tv_message = message;
146 ++i;
147 tv[i].tv_tag = LDPT_API_VERSION;
148 tv[i].tv_u.tv_val = LD_PLUGIN_API_VERSION;
150 ++i;
151 tv[i].tv_tag = LDPT_GOLD_VERSION;
152 tv[i].tv_u.tv_val = major * 100 + minor;
154 ++i;
155 tv[i].tv_tag = LDPT_LINKER_OUTPUT;
156 if (parameters->options().relocatable())
157 tv[i].tv_u.tv_val = LDPO_REL;
158 else if (parameters->options().shared())
159 tv[i].tv_u.tv_val = LDPO_DYN;
160 else
161 tv[i].tv_u.tv_val = LDPO_EXEC;
163 ++i;
164 tv[i].tv_tag = LDPT_OUTPUT_NAME;
165 tv[i].tv_u.tv_string = parameters->options().output();
167 for (unsigned int j = 0; j < this->args_.size(); ++j)
169 ++i;
170 tv[i].tv_tag = LDPT_OPTION;
171 tv[i].tv_u.tv_string = this->args_[j].c_str();
174 ++i;
175 tv[i].tv_tag = LDPT_REGISTER_CLAIM_FILE_HOOK;
176 tv[i].tv_u.tv_register_claim_file = register_claim_file;
178 ++i;
179 tv[i].tv_tag = LDPT_REGISTER_ALL_SYMBOLS_READ_HOOK;
180 tv[i].tv_u.tv_register_all_symbols_read = register_all_symbols_read;
182 ++i;
183 tv[i].tv_tag = LDPT_REGISTER_CLEANUP_HOOK;
184 tv[i].tv_u.tv_register_cleanup = register_cleanup;
186 ++i;
187 tv[i].tv_tag = LDPT_ADD_SYMBOLS;
188 tv[i].tv_u.tv_add_symbols = add_symbols;
190 ++i;
191 tv[i].tv_tag = LDPT_GET_INPUT_FILE;
192 tv[i].tv_u.tv_get_input_file = get_input_file;
194 ++i;
195 tv[i].tv_tag = LDPT_GET_VIEW;
196 tv[i].tv_u.tv_get_view = get_view;
198 ++i;
199 tv[i].tv_tag = LDPT_RELEASE_INPUT_FILE;
200 tv[i].tv_u.tv_release_input_file = release_input_file;
202 ++i;
203 tv[i].tv_tag = LDPT_GET_SYMBOLS;
204 tv[i].tv_u.tv_get_symbols = get_symbols;
206 ++i;
207 tv[i].tv_tag = LDPT_ADD_INPUT_FILE;
208 tv[i].tv_u.tv_add_input_file = add_input_file;
210 ++i;
211 tv[i].tv_tag = LDPT_ADD_INPUT_LIBRARY;
212 tv[i].tv_u.tv_add_input_library = add_input_library;
214 ++i;
215 tv[i].tv_tag = LDPT_SET_EXTRA_LIBRARY_PATH;
216 tv[i].tv_u.tv_set_extra_library_path = set_extra_library_path;
218 ++i;
219 tv[i].tv_tag = LDPT_NULL;
220 tv[i].tv_u.tv_val = 0;
222 gold_assert(i == tv_size - 1);
224 // Call the onload entry point.
225 (*onload)(tv);
227 delete[] tv;
228 #endif // ENABLE_PLUGINS
231 // Call the plugin claim-file handler.
233 inline bool
234 Plugin::claim_file(struct ld_plugin_input_file* plugin_input_file)
236 int claimed = 0;
238 if (this->claim_file_handler_ != NULL)
240 (*this->claim_file_handler_)(plugin_input_file, &claimed);
241 if (claimed)
242 return true;
244 return false;
247 // Call the all-symbols-read handler.
249 inline void
250 Plugin::all_symbols_read()
252 if (this->all_symbols_read_handler_ != NULL)
253 (*this->all_symbols_read_handler_)();
256 // Call the cleanup handler.
258 inline void
259 Plugin::cleanup()
261 if (this->cleanup_handler_ != NULL && !this->cleanup_done_)
263 // Set this flag before calling to prevent a recursive plunge
264 // in the event that a plugin's cleanup handler issues a
265 // fatal error.
266 this->cleanup_done_ = true;
267 (*this->cleanup_handler_)();
271 // This task is used to rescan archives as needed.
273 class Plugin_rescan : public Task
275 public:
276 Plugin_rescan(Task_token* this_blocker, Task_token* next_blocker)
277 : this_blocker_(this_blocker), next_blocker_(next_blocker)
280 ~Plugin_rescan()
282 delete this->this_blocker_;
285 Task_token*
286 is_runnable()
288 if (this->this_blocker_->is_blocked())
289 return this->this_blocker_;
290 return NULL;
293 void
294 locks(Task_locker* tl)
295 { tl->add(this, this->next_blocker_); }
297 void
298 run(Workqueue*)
299 { parameters->options().plugins()->rescan(this); }
301 std::string
302 get_name() const
303 { return "Plugin_rescan"; }
305 private:
306 Task_token* this_blocker_;
307 Task_token* next_blocker_;
310 // Plugin_manager methods.
312 Plugin_manager::~Plugin_manager()
314 for (Plugin_list::iterator p = this->plugins_.begin();
315 p != this->plugins_.end();
316 ++p)
317 delete *p;
318 this->plugins_.clear();
319 for (Object_list::iterator obj = this->objects_.begin();
320 obj != this->objects_.end();
321 ++obj)
322 delete *obj;
323 this->objects_.clear();
326 // Load all plugin libraries.
328 void
329 Plugin_manager::load_plugins()
331 for (this->current_ = this->plugins_.begin();
332 this->current_ != this->plugins_.end();
333 ++this->current_)
334 (*this->current_)->load();
337 // Call the plugin claim-file handlers in turn to see if any claim the file.
339 Pluginobj*
340 Plugin_manager::claim_file(Input_file* input_file, off_t offset,
341 off_t filesize)
343 if (this->in_replacement_phase_)
344 return NULL;
346 unsigned int handle = this->objects_.size();
347 this->input_file_ = input_file;
348 this->plugin_input_file_.name = input_file->filename().c_str();
349 this->plugin_input_file_.fd = input_file->file().descriptor();
350 this->plugin_input_file_.offset = offset;
351 this->plugin_input_file_.filesize = filesize;
352 this->plugin_input_file_.handle = reinterpret_cast<void*>(handle);
354 for (this->current_ = this->plugins_.begin();
355 this->current_ != this->plugins_.end();
356 ++this->current_)
358 if ((*this->current_)->claim_file(&this->plugin_input_file_))
360 this->any_claimed_ = true;
362 if (this->objects_.size() > handle)
363 return this->objects_[handle];
365 // If the plugin claimed the file but did not call the
366 // add_symbols callback, we need to create the Pluginobj now.
367 Pluginobj* obj = this->make_plugin_object(handle);
368 return obj;
372 return NULL;
375 // Save an archive. This is used so that a plugin can add a file
376 // which refers to a symbol which was not previously referenced. In
377 // that case we want to pretend that the symbol was referenced before,
378 // and pull in the archive object.
380 void
381 Plugin_manager::save_archive(Archive* archive)
383 if (this->in_replacement_phase_ || !this->any_claimed_)
384 delete archive;
385 else
386 this->rescannable_.push_back(Rescannable(archive));
389 // Save an Input_group. This is like save_archive.
391 void
392 Plugin_manager::save_input_group(Input_group* input_group)
394 if (this->in_replacement_phase_ || !this->any_claimed_)
395 delete input_group;
396 else
397 this->rescannable_.push_back(Rescannable(input_group));
400 // Call the all-symbols-read handlers.
402 void
403 Plugin_manager::all_symbols_read(Workqueue* workqueue, Task* task,
404 Input_objects* input_objects,
405 Symbol_table* symtab, Layout* layout,
406 Dirsearch* dirpath, Mapfile* mapfile,
407 Task_token** last_blocker)
409 this->in_replacement_phase_ = true;
410 this->workqueue_ = workqueue;
411 this->task_ = task;
412 this->input_objects_ = input_objects;
413 this->symtab_ = symtab;
414 this->layout_ = layout;
415 this->dirpath_ = dirpath;
416 this->mapfile_ = mapfile;
417 this->this_blocker_ = NULL;
419 for (this->current_ = this->plugins_.begin();
420 this->current_ != this->plugins_.end();
421 ++this->current_)
422 (*this->current_)->all_symbols_read();
424 if (this->any_added_)
426 Task_token* next_blocker = new Task_token(true);
427 next_blocker->add_blocker();
428 workqueue->queue(new Plugin_rescan(this->this_blocker_, next_blocker));
429 this->this_blocker_ = next_blocker;
432 *last_blocker = this->this_blocker_;
435 // This is called when we see a new undefined symbol. If we are in
436 // the replacement phase, this means that we may need to rescan some
437 // archives we have previously seen.
439 void
440 Plugin_manager::new_undefined_symbol(Symbol* sym)
442 if (this->in_replacement_phase_)
443 this->undefined_symbols_.push_back(sym);
446 // Rescan archives as needed. This handles the case where a new
447 // object file added by a plugin has an undefined reference to some
448 // symbol defined in an archive.
450 void
451 Plugin_manager::rescan(Task* task)
453 size_t rescan_pos = 0;
454 size_t rescan_size = this->rescannable_.size();
455 while (!this->undefined_symbols_.empty())
457 if (rescan_pos >= rescan_size)
459 this->undefined_symbols_.clear();
460 return;
463 Undefined_symbol_list undefs;
464 undefs.reserve(this->undefined_symbols_.size());
465 this->undefined_symbols_.swap(undefs);
467 size_t min_rescan_pos = rescan_size;
469 for (Undefined_symbol_list::const_iterator p = undefs.begin();
470 p != undefs.end();
471 ++p)
473 if (!(*p)->is_undefined())
474 continue;
476 this->undefined_symbols_.push_back(*p);
478 // Find the first rescan archive which defines this symbol,
479 // starting at the current rescan position. The rescan position
480 // exists so that given -la -lb -lc we don't look for undefined
481 // symbols in -lb back in -la, but instead get the definition
482 // from -lc. Don't bother to look past the current minimum
483 // rescan position.
484 for (size_t i = rescan_pos; i < min_rescan_pos; ++i)
486 if (this->rescannable_defines(i, *p))
488 min_rescan_pos = i;
489 break;
494 if (min_rescan_pos >= rescan_size)
496 // We didn't find any rescannable archives which define any
497 // undefined symbols.
498 return;
501 const Rescannable& r(this->rescannable_[min_rescan_pos]);
502 if (r.is_archive)
504 Task_lock_obj<Archive> tl(task, r.u.archive);
505 r.u.archive->add_symbols(this->symtab_, this->layout_,
506 this->input_objects_, this->mapfile_);
508 else
510 size_t next_saw_undefined = this->symtab_->saw_undefined();
511 size_t saw_undefined;
514 saw_undefined = next_saw_undefined;
516 for (Input_group::const_iterator p = r.u.input_group->begin();
517 p != r.u.input_group->end();
518 ++p)
520 Task_lock_obj<Archive> tl(task, *p);
522 (*p)->add_symbols(this->symtab_, this->layout_,
523 this->input_objects_, this->mapfile_);
526 next_saw_undefined = this->symtab_->saw_undefined();
528 while (saw_undefined != next_saw_undefined);
531 for (size_t i = rescan_pos; i < min_rescan_pos + 1; ++i)
533 if (this->rescannable_[i].is_archive)
534 delete this->rescannable_[i].u.archive;
535 else
536 delete this->rescannable_[i].u.input_group;
539 rescan_pos = min_rescan_pos + 1;
543 // Return whether the rescannable at index I defines SYM.
545 bool
546 Plugin_manager::rescannable_defines(size_t i, Symbol* sym)
548 const Rescannable& r(this->rescannable_[i]);
549 if (r.is_archive)
550 return r.u.archive->defines_symbol(sym);
551 else
553 for (Input_group::const_iterator p = r.u.input_group->begin();
554 p != r.u.input_group->end();
555 ++p)
557 if ((*p)->defines_symbol(sym))
558 return true;
560 return false;
564 // Layout deferred objects.
566 void
567 Plugin_manager::layout_deferred_objects()
569 Deferred_layout_list::iterator obj;
571 for (obj = this->deferred_layout_objects_.begin();
572 obj != this->deferred_layout_objects_.end();
573 ++obj)
575 // Lock the object so we can read from it. This is only called
576 // single-threaded from queue_middle_tasks, so it is OK to lock.
577 // Unfortunately we have no way to pass in a Task token.
578 const Task* dummy_task = reinterpret_cast<const Task*>(-1);
579 Task_lock_obj<Object> tl(dummy_task, *obj);
580 (*obj)->layout_deferred_sections(this->layout_);
584 // Call the cleanup handlers.
586 void
587 Plugin_manager::cleanup()
589 for (this->current_ = this->plugins_.begin();
590 this->current_ != this->plugins_.end();
591 ++this->current_)
592 (*this->current_)->cleanup();
595 // Make a new Pluginobj object. This is called when the plugin calls
596 // the add_symbols API.
598 Pluginobj*
599 Plugin_manager::make_plugin_object(unsigned int handle)
601 // Make sure we aren't asked to make an object for the same handle twice.
602 if (this->objects_.size() != handle)
603 return NULL;
605 Pluginobj* obj = make_sized_plugin_object(this->input_file_,
606 this->plugin_input_file_.offset,
607 this->plugin_input_file_.filesize);
608 this->objects_.push_back(obj);
609 return obj;
612 // Get the input file information with an open (possibly re-opened)
613 // file descriptor.
615 ld_plugin_status
616 Plugin_manager::get_input_file(unsigned int handle,
617 struct ld_plugin_input_file* file)
619 Pluginobj* obj = this->object(handle);
620 if (obj == NULL)
621 return LDPS_BAD_HANDLE;
623 obj->lock(this->task_);
624 file->name = obj->filename().c_str();
625 file->fd = obj->descriptor();
626 file->offset = obj->offset();
627 file->filesize = obj->filesize();
628 file->handle = reinterpret_cast<void*>(handle);
629 return LDPS_OK;
632 // Release the input file.
634 ld_plugin_status
635 Plugin_manager::release_input_file(unsigned int handle)
637 Pluginobj* obj = this->object(handle);
638 if (obj == NULL)
639 return LDPS_BAD_HANDLE;
641 obj->unlock(this->task_);
642 return LDPS_OK;
645 ld_plugin_status
646 Plugin_manager::get_view(unsigned int handle, const void **viewp)
648 off_t offset;
649 size_t filesize;
650 Input_file *input_file;
651 if (this->objects_.size() == handle)
653 // We are being called from the claim_file hook.
654 const struct ld_plugin_input_file &f = this->plugin_input_file_;
655 offset = f.offset;
656 filesize = f.filesize;
657 input_file = this->input_file_;
659 else
661 // An already claimed file.
662 Pluginobj* obj = this->object(handle);
663 if (obj == NULL)
664 return LDPS_BAD_HANDLE;
665 offset = obj->offset();
666 filesize = obj->filesize();
667 input_file = obj->input_file();
669 *viewp = (void*) input_file->file().get_view(offset, 0, filesize, false,
670 false);
671 return LDPS_OK;
674 // Add a new library path.
676 ld_plugin_status
677 Plugin_manager::set_extra_library_path(const char* path)
679 this->extra_search_path_ = std::string(path);
680 return LDPS_OK;
683 // Add a new input file.
685 ld_plugin_status
686 Plugin_manager::add_input_file(const char* pathname, bool is_lib)
688 Input_file_argument file(pathname,
689 (is_lib
690 ? Input_file_argument::INPUT_FILE_TYPE_LIBRARY
691 : Input_file_argument::INPUT_FILE_TYPE_FILE),
692 (is_lib
693 ? this->extra_search_path_.c_str()
694 : ""),
695 false,
696 this->options_);
697 Input_argument* input_argument = new Input_argument(file);
698 Task_token* next_blocker = new Task_token(true);
699 next_blocker->add_blocker();
700 if (parameters->incremental())
701 gold_error(_("input files added by plug-ins in --incremental mode not "
702 "supported yet"));
703 this->workqueue_->queue_soon(new Read_symbols(this->input_objects_,
704 this->symtab_,
705 this->layout_,
706 this->dirpath_,
708 this->mapfile_,
709 input_argument,
710 NULL,
711 NULL,
712 this->this_blocker_,
713 next_blocker));
714 this->this_blocker_ = next_blocker;
715 this->any_added_ = true;
716 return LDPS_OK;
719 // Class Pluginobj.
721 Pluginobj::Pluginobj(const std::string& name, Input_file* input_file,
722 off_t offset, off_t filesize)
723 : Object(name, input_file, false, offset),
724 nsyms_(0), syms_(NULL), symbols_(), filesize_(filesize), comdat_map_()
728 // Return TRUE if a defined symbol might be reachable from outside the
729 // universe of claimed objects.
731 static inline bool
732 is_visible_from_outside(Symbol* lsym)
734 if (lsym->in_real_elf())
735 return true;
736 if (parameters->options().relocatable())
737 return true;
738 if (parameters->options().is_undefined(lsym->name()))
739 return true;
740 if (parameters->options().export_dynamic() || parameters->options().shared())
741 return lsym->is_externally_visible();
742 return false;
745 // Get symbol resolution info.
747 ld_plugin_status
748 Pluginobj::get_symbol_resolution_info(int nsyms, ld_plugin_symbol* syms) const
750 if (nsyms > this->nsyms_)
751 return LDPS_NO_SYMS;
753 if (static_cast<size_t>(nsyms) > this->symbols_.size())
755 // We never decided to include this object. We mark all symbols as
756 // preempted.
757 gold_assert(this->symbols_.size() == 0);
758 for (int i = 0; i < nsyms; i++)
759 syms[i].resolution = LDPR_PREEMPTED_REG;
760 return LDPS_OK;
763 for (int i = 0; i < nsyms; i++)
765 ld_plugin_symbol* isym = &syms[i];
766 Symbol* lsym = this->symbols_[i];
767 ld_plugin_symbol_resolution res = LDPR_UNKNOWN;
769 if (lsym->is_undefined())
770 // The symbol remains undefined.
771 res = LDPR_UNDEF;
772 else if (isym->def == LDPK_UNDEF
773 || isym->def == LDPK_WEAKUNDEF
774 || isym->def == LDPK_COMMON)
776 // The original symbol was undefined or common.
777 if (lsym->source() != Symbol::FROM_OBJECT)
778 res = LDPR_RESOLVED_EXEC;
779 else if (lsym->object()->pluginobj() == this)
780 res = (is_visible_from_outside(lsym)
781 ? LDPR_PREVAILING_DEF
782 : LDPR_PREVAILING_DEF_IRONLY);
783 else if (lsym->object()->pluginobj() != NULL)
784 res = LDPR_RESOLVED_IR;
785 else if (lsym->object()->is_dynamic())
786 res = LDPR_RESOLVED_DYN;
787 else
788 res = LDPR_RESOLVED_EXEC;
790 else
792 // The original symbol was a definition.
793 if (lsym->source() != Symbol::FROM_OBJECT)
794 res = LDPR_PREEMPTED_REG;
795 else if (lsym->object() == static_cast<const Object*>(this))
796 res = (is_visible_from_outside(lsym)
797 ? LDPR_PREVAILING_DEF
798 : LDPR_PREVAILING_DEF_IRONLY);
799 else
800 res = (lsym->object()->pluginobj() != NULL
801 ? LDPR_PREEMPTED_IR
802 : LDPR_PREEMPTED_REG);
804 isym->resolution = res;
806 return LDPS_OK;
809 // Return TRUE if the comdat group with key COMDAT_KEY from this object
810 // should be kept.
812 bool
813 Pluginobj::include_comdat_group(std::string comdat_key, Layout* layout)
815 std::pair<Comdat_map::iterator, bool> ins =
816 this->comdat_map_.insert(std::make_pair(comdat_key, false));
818 // If this is the first time we've seen this comdat key, ask the
819 // layout object whether it should be included.
820 if (ins.second)
821 ins.first->second = layout->find_or_add_kept_section(comdat_key,
822 NULL, 0, true,
823 true, NULL);
825 return ins.first->second;
828 // Class Sized_pluginobj.
830 template<int size, bool big_endian>
831 Sized_pluginobj<size, big_endian>::Sized_pluginobj(
832 const std::string& name,
833 Input_file* input_file,
834 off_t offset,
835 off_t filesize)
836 : Pluginobj(name, input_file, offset, filesize)
840 // Read the symbols. Not used for plugin objects.
842 template<int size, bool big_endian>
843 void
844 Sized_pluginobj<size, big_endian>::do_read_symbols(Read_symbols_data*)
846 gold_unreachable();
849 // Lay out the input sections. Not used for plugin objects.
851 template<int size, bool big_endian>
852 void
853 Sized_pluginobj<size, big_endian>::do_layout(Symbol_table*, Layout*,
854 Read_symbols_data*)
856 gold_unreachable();
859 // Add the symbols to the symbol table.
861 template<int size, bool big_endian>
862 void
863 Sized_pluginobj<size, big_endian>::do_add_symbols(Symbol_table* symtab,
864 Read_symbols_data*,
865 Layout* layout)
867 const int sym_size = elfcpp::Elf_sizes<size>::sym_size;
868 unsigned char symbuf[sym_size];
869 elfcpp::Sym<size, big_endian> sym(symbuf);
870 elfcpp::Sym_write<size, big_endian> osym(symbuf);
872 typedef typename elfcpp::Elf_types<size>::Elf_WXword Elf_size_type;
874 this->symbols_.resize(this->nsyms_);
876 for (int i = 0; i < this->nsyms_; ++i)
878 const struct ld_plugin_symbol* isym = &this->syms_[i];
879 const char* name = isym->name;
880 const char* ver = isym->version;
881 elfcpp::Elf_Half shndx;
882 elfcpp::STB bind;
883 elfcpp::STV vis;
885 if (name != NULL && name[0] == '\0')
886 name = NULL;
887 if (ver != NULL && ver[0] == '\0')
888 ver = NULL;
890 switch (isym->def)
892 case LDPK_WEAKDEF:
893 case LDPK_WEAKUNDEF:
894 bind = elfcpp::STB_WEAK;
895 break;
896 case LDPK_DEF:
897 case LDPK_UNDEF:
898 case LDPK_COMMON:
899 default:
900 bind = elfcpp::STB_GLOBAL;
901 break;
904 switch (isym->def)
906 case LDPK_DEF:
907 case LDPK_WEAKDEF:
908 shndx = elfcpp::SHN_ABS;
909 break;
910 case LDPK_COMMON:
911 shndx = elfcpp::SHN_COMMON;
912 break;
913 case LDPK_UNDEF:
914 case LDPK_WEAKUNDEF:
915 default:
916 shndx = elfcpp::SHN_UNDEF;
917 break;
920 switch (isym->visibility)
922 case LDPV_PROTECTED:
923 vis = elfcpp::STV_PROTECTED;
924 break;
925 case LDPV_INTERNAL:
926 vis = elfcpp::STV_INTERNAL;
927 break;
928 case LDPV_HIDDEN:
929 vis = elfcpp::STV_HIDDEN;
930 break;
931 case LDPV_DEFAULT:
932 default:
933 vis = elfcpp::STV_DEFAULT;
934 break;
937 if (isym->comdat_key != NULL
938 && isym->comdat_key[0] != '\0'
939 && !this->include_comdat_group(isym->comdat_key, layout))
940 shndx = elfcpp::SHN_UNDEF;
942 osym.put_st_name(0);
943 osym.put_st_value(0);
944 osym.put_st_size(static_cast<Elf_size_type>(isym->size));
945 osym.put_st_info(bind, elfcpp::STT_NOTYPE);
946 osym.put_st_other(vis, 0);
947 osym.put_st_shndx(shndx);
949 this->symbols_[i] =
950 symtab->add_from_pluginobj<size, big_endian>(this, name, ver, &sym);
954 template<int size, bool big_endian>
955 Archive::Should_include
956 Sized_pluginobj<size, big_endian>::do_should_include_member(
957 Symbol_table* symtab,
958 Layout* layout,
959 Read_symbols_data*,
960 std::string* why)
962 char* tmpbuf = NULL;
963 size_t tmpbuflen = 0;
965 for (int i = 0; i < this->nsyms_; ++i)
967 const struct ld_plugin_symbol& sym = this->syms_[i];
968 const char* name = sym.name;
969 Symbol* symbol;
970 Archive::Should_include t = Archive::should_include_member(symtab,
971 layout,
972 name,
973 &symbol, why,
974 &tmpbuf,
975 &tmpbuflen);
976 if (t == Archive::SHOULD_INCLUDE_YES)
978 if (tmpbuf != NULL)
979 free(tmpbuf);
980 return t;
983 if (tmpbuf != NULL)
984 free(tmpbuf);
985 return Archive::SHOULD_INCLUDE_UNKNOWN;
988 // Get the size of a section. Not used for plugin objects.
990 template<int size, bool big_endian>
991 uint64_t
992 Sized_pluginobj<size, big_endian>::do_section_size(unsigned int)
994 gold_unreachable();
995 return 0;
998 // Get the name of a section. Not used for plugin objects.
1000 template<int size, bool big_endian>
1001 std::string
1002 Sized_pluginobj<size, big_endian>::do_section_name(unsigned int)
1004 gold_unreachable();
1005 return std::string();
1008 // Return a view of the contents of a section. Not used for plugin objects.
1010 template<int size, bool big_endian>
1011 Object::Location
1012 Sized_pluginobj<size, big_endian>::do_section_contents(unsigned int)
1014 Location loc(0, 0);
1016 gold_unreachable();
1017 return loc;
1020 // Return section flags. Not used for plugin objects.
1022 template<int size, bool big_endian>
1023 uint64_t
1024 Sized_pluginobj<size, big_endian>::do_section_flags(unsigned int)
1026 gold_unreachable();
1027 return 0;
1030 // Return section entsize. Not used for plugin objects.
1032 template<int size, bool big_endian>
1033 uint64_t
1034 Sized_pluginobj<size, big_endian>::do_section_entsize(unsigned int)
1036 gold_unreachable();
1037 return 0;
1040 // Return section address. Not used for plugin objects.
1042 template<int size, bool big_endian>
1043 uint64_t
1044 Sized_pluginobj<size, big_endian>::do_section_address(unsigned int)
1046 gold_unreachable();
1047 return 0;
1050 // Return section type. Not used for plugin objects.
1052 template<int size, bool big_endian>
1053 unsigned int
1054 Sized_pluginobj<size, big_endian>::do_section_type(unsigned int)
1056 gold_unreachable();
1057 return 0;
1060 // Return the section link field. Not used for plugin objects.
1062 template<int size, bool big_endian>
1063 unsigned int
1064 Sized_pluginobj<size, big_endian>::do_section_link(unsigned int)
1066 gold_unreachable();
1067 return 0;
1070 // Return the section link field. Not used for plugin objects.
1072 template<int size, bool big_endian>
1073 unsigned int
1074 Sized_pluginobj<size, big_endian>::do_section_info(unsigned int)
1076 gold_unreachable();
1077 return 0;
1080 // Return the section alignment. Not used for plugin objects.
1082 template<int size, bool big_endian>
1083 uint64_t
1084 Sized_pluginobj<size, big_endian>::do_section_addralign(unsigned int)
1086 gold_unreachable();
1087 return 0;
1090 // Return the Xindex structure to use. Not used for plugin objects.
1092 template<int size, bool big_endian>
1093 Xindex*
1094 Sized_pluginobj<size, big_endian>::do_initialize_xindex()
1096 gold_unreachable();
1097 return NULL;
1100 // Get symbol counts. Not used for plugin objects.
1102 template<int size, bool big_endian>
1103 void
1104 Sized_pluginobj<size, big_endian>::do_get_global_symbol_counts(const Symbol_table*,
1105 size_t*, size_t*) const
1107 gold_unreachable();
1110 // Get symbols. Not used for plugin objects.
1112 template<int size, bool big_endian>
1113 const Object::Symbols*
1114 Sized_pluginobj<size, big_endian>::do_get_global_symbols() const
1116 gold_unreachable();
1119 // Class Plugin_finish. This task runs after all replacement files have
1120 // been added. For now, it's a placeholder for a possible plugin API
1121 // to allow the plugin to release most of its resources. The cleanup
1122 // handlers must be called later, because they can remove the temporary
1123 // object files that are needed until the end of the link.
1125 class Plugin_finish : public Task
1127 public:
1128 Plugin_finish(Task_token* this_blocker, Task_token* next_blocker)
1129 : this_blocker_(this_blocker), next_blocker_(next_blocker)
1132 ~Plugin_finish()
1134 if (this->this_blocker_ != NULL)
1135 delete this->this_blocker_;
1138 Task_token*
1139 is_runnable()
1141 if (this->this_blocker_ != NULL && this->this_blocker_->is_blocked())
1142 return this->this_blocker_;
1143 return NULL;
1146 void
1147 locks(Task_locker* tl)
1148 { tl->add(this, this->next_blocker_); }
1150 void
1151 run(Workqueue*)
1153 // We could call early cleanup handlers here.
1156 std::string
1157 get_name() const
1158 { return "Plugin_finish"; }
1160 private:
1161 Task_token* this_blocker_;
1162 Task_token* next_blocker_;
1165 // Class Plugin_hook.
1167 Plugin_hook::~Plugin_hook()
1171 // Return whether a Plugin_hook task is runnable.
1173 Task_token*
1174 Plugin_hook::is_runnable()
1176 if (this->this_blocker_ != NULL && this->this_blocker_->is_blocked())
1177 return this->this_blocker_;
1178 return NULL;
1181 // Return a Task_locker for a Plugin_hook task. We don't need any
1182 // locks here.
1184 void
1185 Plugin_hook::locks(Task_locker*)
1189 // Run the "all symbols read" plugin hook.
1191 void
1192 Plugin_hook::run(Workqueue* workqueue)
1194 gold_assert(this->options_.has_plugins());
1195 Symbol* start_sym;
1196 if (parameters->options().entry())
1197 start_sym = this->symtab_->lookup(parameters->options().entry());
1198 else
1199 start_sym = this->symtab_->lookup("_start");
1200 if (start_sym != NULL)
1201 start_sym->set_in_real_elf();
1203 this->options_.plugins()->all_symbols_read(workqueue,
1204 this,
1205 this->input_objects_,
1206 this->symtab_,
1207 this->layout_,
1208 this->dirpath_,
1209 this->mapfile_,
1210 &this->this_blocker_);
1211 workqueue->queue_soon(new Plugin_finish(this->this_blocker_,
1212 this->next_blocker_));
1215 // The C interface routines called by the plugins.
1217 #ifdef ENABLE_PLUGINS
1219 // Register a claim-file handler.
1221 static enum ld_plugin_status
1222 register_claim_file(ld_plugin_claim_file_handler handler)
1224 gold_assert(parameters->options().has_plugins());
1225 parameters->options().plugins()->set_claim_file_handler(handler);
1226 return LDPS_OK;
1229 // Register an all-symbols-read handler.
1231 static enum ld_plugin_status
1232 register_all_symbols_read(ld_plugin_all_symbols_read_handler handler)
1234 gold_assert(parameters->options().has_plugins());
1235 parameters->options().plugins()->set_all_symbols_read_handler(handler);
1236 return LDPS_OK;
1239 // Register a cleanup handler.
1241 static enum ld_plugin_status
1242 register_cleanup(ld_plugin_cleanup_handler handler)
1244 gold_assert(parameters->options().has_plugins());
1245 parameters->options().plugins()->set_cleanup_handler(handler);
1246 return LDPS_OK;
1249 // Add symbols from a plugin-claimed input file.
1251 static enum ld_plugin_status
1252 add_symbols(void* handle, int nsyms, const ld_plugin_symbol* syms)
1254 gold_assert(parameters->options().has_plugins());
1255 Pluginobj* obj = parameters->options().plugins()->make_plugin_object(
1256 static_cast<unsigned int>(reinterpret_cast<intptr_t>(handle)));
1257 if (obj == NULL)
1258 return LDPS_ERR;
1259 obj->store_incoming_symbols(nsyms, syms);
1260 return LDPS_OK;
1263 // Get the input file information with an open (possibly re-opened)
1264 // file descriptor.
1266 static enum ld_plugin_status
1267 get_input_file(const void* handle, struct ld_plugin_input_file* file)
1269 gold_assert(parameters->options().has_plugins());
1270 unsigned int obj_index =
1271 static_cast<unsigned int>(reinterpret_cast<intptr_t>(handle));
1272 return parameters->options().plugins()->get_input_file(obj_index, file);
1275 // Release the input file.
1277 static enum ld_plugin_status
1278 release_input_file(const void* handle)
1280 gold_assert(parameters->options().has_plugins());
1281 unsigned int obj_index =
1282 static_cast<unsigned int>(reinterpret_cast<intptr_t>(handle));
1283 return parameters->options().plugins()->release_input_file(obj_index);
1286 static enum ld_plugin_status
1287 get_view(const void *handle, const void **viewp)
1289 gold_assert(parameters->options().has_plugins());
1290 unsigned int obj_index =
1291 static_cast<unsigned int>(reinterpret_cast<intptr_t>(handle));
1292 return parameters->options().plugins()->get_view(obj_index, viewp);
1295 // Get the symbol resolution info for a plugin-claimed input file.
1297 static enum ld_plugin_status
1298 get_symbols(const void* handle, int nsyms, ld_plugin_symbol* syms)
1300 gold_assert(parameters->options().has_plugins());
1301 Pluginobj* obj = parameters->options().plugins()->object(
1302 static_cast<unsigned int>(reinterpret_cast<intptr_t>(handle)));
1303 if (obj == NULL)
1304 return LDPS_ERR;
1305 return obj->get_symbol_resolution_info(nsyms, syms);
1308 // Add a new (real) input file generated by a plugin.
1310 static enum ld_plugin_status
1311 add_input_file(const char* pathname)
1313 gold_assert(parameters->options().has_plugins());
1314 return parameters->options().plugins()->add_input_file(pathname, false);
1317 // Add a new (real) library required by a plugin.
1319 static enum ld_plugin_status
1320 add_input_library(const char* pathname)
1322 gold_assert(parameters->options().has_plugins());
1323 return parameters->options().plugins()->add_input_file(pathname, true);
1326 // Set the extra library path to be used by libraries added via
1327 // add_input_library
1329 static enum ld_plugin_status
1330 set_extra_library_path(const char* path)
1332 gold_assert(parameters->options().has_plugins());
1333 return parameters->options().plugins()->set_extra_library_path(path);
1336 // Issue a diagnostic message from a plugin.
1338 static enum ld_plugin_status
1339 message(int level, const char* format, ...)
1341 va_list args;
1342 va_start(args, format);
1344 switch (level)
1346 case LDPL_INFO:
1347 parameters->errors()->info(format, args);
1348 break;
1349 case LDPL_WARNING:
1350 parameters->errors()->warning(format, args);
1351 break;
1352 case LDPL_ERROR:
1353 default:
1354 parameters->errors()->error(format, args);
1355 break;
1356 case LDPL_FATAL:
1357 parameters->errors()->fatal(format, args);
1358 break;
1361 va_end(args);
1362 return LDPS_OK;
1365 #endif // ENABLE_PLUGINS
1367 // Allocate a Pluginobj object of the appropriate size and endianness.
1369 static Pluginobj*
1370 make_sized_plugin_object(Input_file* input_file, off_t offset, off_t filesize)
1372 Pluginobj* obj = NULL;
1374 parameters_force_valid_target();
1375 const Target& target(parameters->target());
1377 if (target.get_size() == 32)
1379 if (target.is_big_endian())
1380 #ifdef HAVE_TARGET_32_BIG
1381 obj = new Sized_pluginobj<32, true>(input_file->filename(),
1382 input_file, offset, filesize);
1383 #else
1384 gold_error(_("%s: not configured to support "
1385 "32-bit big-endian object"),
1386 input_file->filename().c_str());
1387 #endif
1388 else
1389 #ifdef HAVE_TARGET_32_LITTLE
1390 obj = new Sized_pluginobj<32, false>(input_file->filename(),
1391 input_file, offset, filesize);
1392 #else
1393 gold_error(_("%s: not configured to support "
1394 "32-bit little-endian object"),
1395 input_file->filename().c_str());
1396 #endif
1398 else if (target.get_size() == 64)
1400 if (target.is_big_endian())
1401 #ifdef HAVE_TARGET_64_BIG
1402 obj = new Sized_pluginobj<64, true>(input_file->filename(),
1403 input_file, offset, filesize);
1404 #else
1405 gold_error(_("%s: not configured to support "
1406 "64-bit big-endian object"),
1407 input_file->filename().c_str());
1408 #endif
1409 else
1410 #ifdef HAVE_TARGET_64_LITTLE
1411 obj = new Sized_pluginobj<64, false>(input_file->filename(),
1412 input_file, offset, filesize);
1413 #else
1414 gold_error(_("%s: not configured to support "
1415 "64-bit little-endian object"),
1416 input_file->filename().c_str());
1417 #endif
1420 gold_assert(obj != NULL);
1421 return obj;
1424 } // End namespace gold.