1 // target-reloc.h -- target specific relocation support -*- C++ -*-
3 // Copyright (C) 2006-2017 Free Software Foundation, Inc.
4 // Written by Ian Lance Taylor <iant@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 #ifndef GOLD_TARGET_RELOC_H
24 #define GOLD_TARGET_RELOC_H
30 #include "reloc-types.h"
35 // This function implements the generic part of reloc scanning. The
36 // template parameter Scan must be a class type which provides two
37 // functions: local() and global(). Those functions implement the
38 // machine specific part of scanning. We do it this way to
39 // avoid making a function call for each relocation, and to avoid
40 // repeating the generic code for each target.
42 template<int size
, bool big_endian
, typename Target_type
,
43 typename Scan
, typename Classify_reloc
>
49 Sized_relobj_file
<size
, big_endian
>* object
,
50 unsigned int data_shndx
,
51 const unsigned char* prelocs
,
53 Output_section
* output_section
,
54 bool needs_special_offset_handling
,
56 const unsigned char* plocal_syms
)
58 typedef typename
Classify_reloc::Reltype Reltype
;
59 const int reloc_size
= Classify_reloc::reloc_size
;
60 const int sym_size
= elfcpp::Elf_sizes
<size
>::sym_size
;
63 for (size_t i
= 0; i
< reloc_count
; ++i
, prelocs
+= reloc_size
)
65 Reltype
reloc(prelocs
);
67 if (needs_special_offset_handling
68 && !output_section
->is_input_address_mapped(object
, data_shndx
,
69 reloc
.get_r_offset()))
72 unsigned int r_sym
= Classify_reloc::get_r_sym(&reloc
);
73 unsigned int r_type
= Classify_reloc::get_r_type(&reloc
);
75 if (r_sym
< local_count
)
77 gold_assert(plocal_syms
!= NULL
);
78 typename
elfcpp::Sym
<size
, big_endian
> lsym(plocal_syms
80 unsigned int shndx
= lsym
.get_st_shndx();
82 shndx
= object
->adjust_sym_shndx(r_sym
, shndx
, &is_ordinary
);
83 // If RELOC is a relocation against a local symbol in a
84 // section we are discarding then we can ignore it. It will
85 // eventually become a reloc against the value zero.
87 // FIXME: We should issue a warning if this is an
88 // allocated section; is this the best place to do it?
90 // FIXME: The old GNU linker would in some cases look
91 // for the linkonce section which caused this section to
92 // be discarded, and, if the other section was the same
93 // size, change the reloc to refer to the other section.
94 // That seems risky and weird to me, and I don't know of
95 // any case where it is actually required.
96 bool is_discarded
= (is_ordinary
97 && shndx
!= elfcpp::SHN_UNDEF
98 && !object
->is_section_included(shndx
)
99 && !symtab
->is_section_folded(object
, shndx
));
100 scan
.local(symtab
, layout
, target
, object
, data_shndx
,
101 output_section
, reloc
, r_type
, lsym
, is_discarded
);
105 Symbol
* gsym
= object
->global_symbol(r_sym
);
106 gold_assert(gsym
!= NULL
);
107 if (gsym
->is_forwarder())
108 gsym
= symtab
->resolve_forwards(gsym
);
110 scan
.global(symtab
, layout
, target
, object
, data_shndx
,
111 output_section
, reloc
, r_type
, gsym
);
116 // Behavior for relocations to discarded comdat sections.
120 CB_UNDETERMINED
, // Not yet determined -- need to look at section name.
121 CB_PRETEND
, // Attempt to map to the corresponding kept section.
122 CB_IGNORE
, // Ignore the relocation.
123 CB_WARNING
// Print a warning.
126 class Default_comdat_behavior
129 // Decide what the linker should do for relocations that refer to
130 // discarded comdat sections. This decision is based on the name of
131 // the section being relocated.
133 inline Comdat_behavior
134 get(const char* name
)
136 if (Layout::is_debug_info_section(name
))
138 if (strcmp(name
, ".eh_frame") == 0
139 || strcmp(name
, ".gcc_except_table") == 0)
145 // Give an error for a symbol with non-default visibility which is not
149 visibility_error(const Symbol
* sym
)
152 switch (sym
->visibility())
154 case elfcpp::STV_INTERNAL
:
157 case elfcpp::STV_HIDDEN
:
160 case elfcpp::STV_PROTECTED
:
166 gold_error(_("%s symbol '%s' is not defined locally"),
170 // Return true if we are should issue an error saying that SYM is an
171 // undefined symbol. This is called if there is a relocation against
175 issue_undefined_symbol_error(const Symbol
* sym
)
177 // We only report global symbols.
181 // We only report undefined symbols.
182 if (!sym
->is_undefined() && !sym
->is_placeholder())
185 // We don't report weak symbols.
186 if (sym
->is_weak_undefined())
189 // We don't report symbols defined in discarded sections,
190 // unless they're placeholder symbols that should have been
191 // provided by a plugin.
192 if (sym
->is_defined_in_discarded_section() && !sym
->is_placeholder())
195 // If the target defines this symbol, don't report it here.
196 if (parameters
->target().is_defined_by_abi(sym
))
199 // See if we've been told to ignore whether this symbol is
201 const char* const u
= parameters
->options().unresolved_symbols();
204 if (strcmp(u
, "ignore-all") == 0)
206 if (strcmp(u
, "report-all") == 0)
208 if (strcmp(u
, "ignore-in-object-files") == 0 && !sym
->in_dyn())
210 if (strcmp(u
, "ignore-in-shared-libs") == 0 && !sym
->in_reg())
214 // If the symbol is hidden, report it.
215 if (sym
->visibility() == elfcpp::STV_HIDDEN
)
218 // When creating a shared library, only report unresolved symbols if
220 if (parameters
->options().shared() && !parameters
->options().defs())
223 // Otherwise issue a warning.
227 // This function implements the generic part of relocation processing.
228 // The template parameter Relocate must be a class type which provides
229 // a single function, relocate(), which implements the machine
230 // specific part of a relocation.
232 // The template parameter Relocate_comdat_behavior is a class type
233 // which provides a single function, get(), which determines what the
234 // linker should do for relocations that refer to discarded comdat
237 // SIZE is the ELF size: 32 or 64. BIG_ENDIAN is the endianness of
238 // the data. SH_TYPE is the section type: SHT_REL or SHT_RELA.
239 // RELOCATE implements operator() to do a relocation.
241 // PRELOCS points to the relocation data. RELOC_COUNT is the number
242 // of relocs. OUTPUT_SECTION is the output section.
243 // NEEDS_SPECIAL_OFFSET_HANDLING is true if input offsets need to be
244 // mapped to output offsets.
246 // VIEW is the section data, VIEW_ADDRESS is its memory address, and
247 // VIEW_SIZE is the size. These refer to the input section, unless
248 // NEEDS_SPECIAL_OFFSET_HANDLING is true, in which case they refer to
249 // the output section.
251 // RELOC_SYMBOL_CHANGES is used for -fsplit-stack support. If it is
252 // not NULL, it is a vector indexed by relocation index. If that
253 // entry is not NULL, it points to a global symbol which used as the
254 // symbol for the relocation, ignoring the symbol index in the
257 template<int size
, bool big_endian
, typename Target_type
,
259 typename Relocate_comdat_behavior
,
260 typename Classify_reloc
>
263 const Relocate_info
<size
, big_endian
>* relinfo
,
265 const unsigned char* prelocs
,
267 Output_section
* output_section
,
268 bool needs_special_offset_handling
,
270 typename
elfcpp::Elf_types
<size
>::Elf_Addr view_address
,
271 section_size_type view_size
,
272 const Reloc_symbol_changes
* reloc_symbol_changes
)
274 typedef typename
Classify_reloc::Reltype Reltype
;
275 const int reloc_size
= Classify_reloc::reloc_size
;
277 Relocate_comdat_behavior relocate_comdat_behavior
;
279 Sized_relobj_file
<size
, big_endian
>* object
= relinfo
->object
;
280 unsigned int local_count
= object
->local_symbol_count();
282 Comdat_behavior comdat_behavior
= CB_UNDETERMINED
;
284 for (size_t i
= 0; i
< reloc_count
; ++i
, prelocs
+= reloc_size
)
286 Reltype
reloc(prelocs
);
288 section_offset_type offset
=
289 convert_to_section_size_type(reloc
.get_r_offset());
291 if (needs_special_offset_handling
)
293 offset
= output_section
->output_offset(relinfo
->object
,
300 unsigned int r_sym
= Classify_reloc::get_r_sym(&reloc
);
302 const Sized_symbol
<size
>* sym
;
304 Symbol_value
<size
> symval
;
305 const Symbol_value
<size
> *psymval
;
306 bool is_defined_in_discarded_section
;
308 if (r_sym
< local_count
309 && (reloc_symbol_changes
== NULL
310 || (*reloc_symbol_changes
)[i
] == NULL
))
313 psymval
= object
->local_symbol(r_sym
);
315 // If the local symbol belongs to a section we are discarding,
316 // and that section is a debug section, try to find the
317 // corresponding kept section and map this symbol to its
318 // counterpart in the kept section. The symbol must not
319 // correspond to a section we are folding.
321 shndx
= psymval
->input_shndx(&is_ordinary
);
322 is_defined_in_discarded_section
=
324 && shndx
!= elfcpp::SHN_UNDEF
325 && !object
->is_section_included(shndx
)
326 && !relinfo
->symtab
->is_section_folded(object
, shndx
));
331 if (reloc_symbol_changes
!= NULL
332 && (*reloc_symbol_changes
)[i
] != NULL
)
333 gsym
= (*reloc_symbol_changes
)[i
];
336 gsym
= object
->global_symbol(r_sym
);
337 gold_assert(gsym
!= NULL
);
338 if (gsym
->is_forwarder())
339 gsym
= relinfo
->symtab
->resolve_forwards(gsym
);
342 sym
= static_cast<const Sized_symbol
<size
>*>(gsym
);
343 if (sym
->has_symtab_index() && sym
->symtab_index() != -1U)
344 symval
.set_output_symtab_index(sym
->symtab_index());
346 symval
.set_no_output_symtab_entry();
347 symval
.set_output_value(sym
->value());
348 if (gsym
->type() == elfcpp::STT_TLS
)
349 symval
.set_is_tls_symbol();
350 else if (gsym
->type() == elfcpp::STT_GNU_IFUNC
)
351 symval
.set_is_ifunc_symbol();
354 is_defined_in_discarded_section
=
355 (gsym
->is_defined_in_discarded_section()
356 && gsym
->is_undefined());
360 Symbol_value
<size
> symval2
;
361 if (is_defined_in_discarded_section
)
363 if (comdat_behavior
== CB_UNDETERMINED
)
365 std::string name
= object
->section_name(relinfo
->data_shndx
);
366 comdat_behavior
= relocate_comdat_behavior
.get(name
.c_str());
368 if (comdat_behavior
== CB_PRETEND
)
370 // FIXME: This case does not work for global symbols.
371 // We have no place to store the original section index.
372 // Fortunately this does not matter for comdat sections,
373 // only for sections explicitly discarded by a linker
376 typename
elfcpp::Elf_types
<size
>::Elf_Addr value
=
377 object
->map_to_kept_section(shndx
, &found
);
379 symval2
.set_output_value(value
+ psymval
->input_value());
381 symval2
.set_output_value(0);
385 if (comdat_behavior
== CB_WARNING
)
386 gold_warning_at_location(relinfo
, i
, offset
,
387 _("relocation refers to discarded "
389 symval2
.set_output_value(0);
391 symval2
.set_no_output_symtab_entry();
395 // If OFFSET is out of range, still let the target decide to
396 // ignore the relocation. Pass in NULL as the VIEW argument so
397 // that it can return quickly without trashing an invalid memory
399 unsigned char *v
= view
+ offset
;
400 if (offset
< 0 || static_cast<section_size_type
>(offset
) >= view_size
)
403 if (!relocate
.relocate(relinfo
, Classify_reloc::sh_type
, target
,
404 output_section
, i
, prelocs
, sym
, psymval
,
405 v
, view_address
+ offset
, view_size
))
410 gold_error_at_location(relinfo
, i
, offset
,
411 _("reloc has bad offset %zu"),
412 static_cast<size_t>(offset
));
416 if (issue_undefined_symbol_error(sym
))
417 gold_undefined_symbol_at_location(sym
, relinfo
, i
, offset
);
419 && sym
->visibility() != elfcpp::STV_DEFAULT
420 && (sym
->is_strong_undefined() || sym
->is_from_dynobj()))
421 visibility_error(sym
);
423 if (sym
!= NULL
&& sym
->has_warning())
424 relinfo
->symtab
->issue_warning(sym
, relinfo
, i
, offset
);
428 // Apply an incremental relocation.
430 template<int size
, bool big_endian
, typename Target_type
,
433 apply_relocation(const Relocate_info
<size
, big_endian
>* relinfo
,
435 typename
elfcpp::Elf_types
<size
>::Elf_Addr r_offset
,
437 typename
elfcpp::Elf_types
<size
>::Elf_Swxword r_addend
,
440 typename
elfcpp::Elf_types
<size
>::Elf_Addr address
,
441 section_size_type view_size
)
443 // Construct the ELF relocation in a temporary buffer.
444 const int reloc_size
= elfcpp::Elf_sizes
<size
>::rela_size
;
445 unsigned char relbuf
[reloc_size
];
446 elfcpp::Rela_write
<size
, big_endian
> orel(relbuf
);
447 orel
.put_r_offset(r_offset
);
448 orel
.put_r_info(elfcpp::elf_r_info
<size
>(0, r_type
));
449 orel
.put_r_addend(r_addend
);
451 // Setup a Symbol_value for the global symbol.
452 const Sized_symbol
<size
>* sym
= static_cast<const Sized_symbol
<size
>*>(gsym
);
453 Symbol_value
<size
> symval
;
454 gold_assert(sym
->has_symtab_index() && sym
->symtab_index() != -1U);
455 symval
.set_output_symtab_index(sym
->symtab_index());
456 symval
.set_output_value(sym
->value());
457 if (gsym
->type() == elfcpp::STT_TLS
)
458 symval
.set_is_tls_symbol();
459 else if (gsym
->type() == elfcpp::STT_GNU_IFUNC
)
460 symval
.set_is_ifunc_symbol();
463 relocate
.relocate(relinfo
, elfcpp::SHT_RELA
, target
, NULL
,
464 -1U, relbuf
, sym
, &symval
,
465 view
+ r_offset
, address
+ r_offset
, view_size
);
468 // A class for inquiring about properties of a relocation,
469 // used while scanning relocs during a relocatable link and
470 // garbage collection. This class may be used as the default
471 // for SHT_RELA targets, but SHT_REL targets must implement
472 // a derived class that overrides get_size_for_reloc.
473 // The MIPS-64 target also needs to override the methods
474 // for accessing the r_sym and r_type fields of a relocation,
475 // due to its non-standard use of the r_info field.
477 template<int sh_type_
, int size
, bool big_endian
>
478 class Default_classify_reloc
481 typedef typename Reloc_types
<sh_type_
, size
, big_endian
>::Reloc
483 typedef typename Reloc_types
<sh_type_
, size
, big_endian
>::Reloc_write
485 static const int reloc_size
=
486 Reloc_types
<sh_type_
, size
, big_endian
>::reloc_size
;
487 static const int sh_type
= sh_type_
;
489 // Return the symbol referred to by the relocation.
490 static inline unsigned int
491 get_r_sym(const Reltype
* reloc
)
492 { return elfcpp::elf_r_sym
<size
>(reloc
->get_r_info()); }
494 // Return the type of the relocation.
495 static inline unsigned int
496 get_r_type(const Reltype
* reloc
)
497 { return elfcpp::elf_r_type
<size
>(reloc
->get_r_info()); }
499 // Return the explicit addend of the relocation (return 0 for SHT_REL).
500 static inline typename
elfcpp::Elf_types
<size
>::Elf_Swxword
501 get_r_addend(const Reltype
* reloc
)
502 { return Reloc_types
<sh_type_
, size
, big_endian
>::get_reloc_addend(reloc
); }
504 // Write the r_info field to a new reloc, using the r_info field from
505 // the original reloc, replacing the r_sym field with R_SYM.
507 put_r_info(Reltype_write
* new_reloc
, Reltype
* reloc
, unsigned int r_sym
)
509 unsigned int r_type
= elfcpp::elf_r_type
<size
>(reloc
->get_r_info());
510 new_reloc
->put_r_info(elfcpp::elf_r_info
<size
>(r_sym
, r_type
));
513 // Write the r_addend field to a new reloc.
515 put_r_addend(Reltype_write
* to
,
516 typename
elfcpp::Elf_types
<size
>::Elf_Swxword addend
)
517 { Reloc_types
<sh_type_
, size
, big_endian
>::set_reloc_addend(to
, addend
); }
519 // Return the size of the addend of the relocation (only used for SHT_REL).
521 get_size_for_reloc(unsigned int, Relobj
*)
528 // This class may be used as a typical class for the
529 // Scan_relocatable_reloc parameter to scan_relocatable_relocs.
530 // This class is intended to capture the most typical target behaviour,
531 // while still permitting targets to define their own independent class
532 // for Scan_relocatable_reloc.
534 template<typename Classify_reloc
>
535 class Default_scan_relocatable_relocs
538 typedef typename
Classify_reloc::Reltype Reltype
;
539 static const int reloc_size
= Classify_reloc::reloc_size
;
540 static const int sh_type
= Classify_reloc::sh_type
;
542 // Return the symbol referred to by the relocation.
543 static inline unsigned int
544 get_r_sym(const Reltype
* reloc
)
545 { return Classify_reloc::get_r_sym(reloc
); }
547 // Return the type of the relocation.
548 static inline unsigned int
549 get_r_type(const Reltype
* reloc
)
550 { return Classify_reloc::get_r_type(reloc
); }
552 // Return the strategy to use for a local symbol which is not a
553 // section symbol, given the relocation type.
554 inline Relocatable_relocs::Reloc_strategy
555 local_non_section_strategy(unsigned int r_type
, Relobj
*, unsigned int r_sym
)
557 // We assume that relocation type 0 is NONE. Targets which are
558 // different must override.
559 if (r_type
== 0 && r_sym
== 0)
560 return Relocatable_relocs::RELOC_DISCARD
;
561 return Relocatable_relocs::RELOC_COPY
;
564 // Return the strategy to use for a local symbol which is a section
565 // symbol, given the relocation type.
566 inline Relocatable_relocs::Reloc_strategy
567 local_section_strategy(unsigned int r_type
, Relobj
* object
)
569 if (sh_type
== elfcpp::SHT_RELA
)
570 return Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_RELA
;
573 switch (Classify_reloc::get_size_for_reloc(r_type
, object
))
576 return Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_0
;
578 return Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_1
;
580 return Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_2
;
582 return Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_4
;
584 return Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_8
;
591 // Return the strategy to use for a global symbol, given the
592 // relocation type, the object, and the symbol index.
593 inline Relocatable_relocs::Reloc_strategy
594 global_strategy(unsigned int, Relobj
*, unsigned int)
595 { return Relocatable_relocs::RELOC_COPY
; }
598 // This is a strategy class used with scan_relocatable_relocs
599 // and --emit-relocs.
601 template<typename Classify_reloc
>
602 class Default_emit_relocs_strategy
605 typedef typename
Classify_reloc::Reltype Reltype
;
606 static const int reloc_size
= Classify_reloc::reloc_size
;
607 static const int sh_type
= Classify_reloc::sh_type
;
609 // Return the symbol referred to by the relocation.
610 static inline unsigned int
611 get_r_sym(const Reltype
* reloc
)
612 { return Classify_reloc::get_r_sym(reloc
); }
614 // Return the type of the relocation.
615 static inline unsigned int
616 get_r_type(const Reltype
* reloc
)
617 { return Classify_reloc::get_r_type(reloc
); }
619 // A local non-section symbol.
620 inline Relocatable_relocs::Reloc_strategy
621 local_non_section_strategy(unsigned int, Relobj
*, unsigned int)
622 { return Relocatable_relocs::RELOC_COPY
; }
624 // A local section symbol.
625 inline Relocatable_relocs::Reloc_strategy
626 local_section_strategy(unsigned int, Relobj
*)
628 if (sh_type
== elfcpp::SHT_RELA
)
629 return Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_RELA
;
632 // The addend is stored in the section contents. Since this
633 // is not a relocatable link, we are going to apply the
634 // relocation contents to the section as usual. This means
635 // that we have no way to record the original addend. If the
636 // original addend is not zero, there is basically no way for
637 // the user to handle this correctly. Caveat emptor.
638 return Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_0
;
643 inline Relocatable_relocs::Reloc_strategy
644 global_strategy(unsigned int, Relobj
*, unsigned int)
645 { return Relocatable_relocs::RELOC_COPY
; }
648 // Scan relocs during a relocatable link. This is a default
649 // definition which should work for most targets.
650 // Scan_relocatable_reloc must name a class type which provides three
651 // functions which return a Relocatable_relocs::Reloc_strategy code:
652 // global_strategy, local_non_section_strategy, and
653 // local_section_strategy. Most targets should be able to use
654 // Default_scan_relocatable_relocs as this class.
656 template<int size
, bool big_endian
, typename Scan_relocatable_reloc
>
658 scan_relocatable_relocs(
661 Sized_relobj_file
<size
, big_endian
>* object
,
662 unsigned int data_shndx
,
663 const unsigned char* prelocs
,
665 Output_section
* output_section
,
666 bool needs_special_offset_handling
,
667 size_t local_symbol_count
,
668 const unsigned char* plocal_syms
,
669 Relocatable_relocs
* rr
)
671 typedef typename
Scan_relocatable_reloc::Reltype Reltype
;
672 const int reloc_size
= Scan_relocatable_reloc::reloc_size
;
673 const int sym_size
= elfcpp::Elf_sizes
<size
>::sym_size
;
674 Scan_relocatable_reloc scan
;
676 for (size_t i
= 0; i
< reloc_count
; ++i
, prelocs
+= reloc_size
)
678 Reltype
reloc(prelocs
);
680 Relocatable_relocs::Reloc_strategy strategy
;
682 if (needs_special_offset_handling
683 && !output_section
->is_input_address_mapped(object
, data_shndx
,
684 reloc
.get_r_offset()))
685 strategy
= Relocatable_relocs::RELOC_DISCARD
;
688 const unsigned int r_sym
= Scan_relocatable_reloc::get_r_sym(&reloc
);
689 const unsigned int r_type
=
690 Scan_relocatable_reloc::get_r_type(&reloc
);
692 if (r_sym
>= local_symbol_count
)
693 strategy
= scan
.global_strategy(r_type
, object
, r_sym
);
696 gold_assert(plocal_syms
!= NULL
);
697 typename
elfcpp::Sym
<size
, big_endian
> lsym(plocal_syms
699 unsigned int shndx
= lsym
.get_st_shndx();
701 shndx
= object
->adjust_sym_shndx(r_sym
, shndx
, &is_ordinary
);
703 && shndx
!= elfcpp::SHN_UNDEF
704 && !object
->is_section_included(shndx
))
706 // RELOC is a relocation against a local symbol
707 // defined in a section we are discarding. Discard
708 // the reloc. FIXME: Should we issue a warning?
709 strategy
= Relocatable_relocs::RELOC_DISCARD
;
711 else if (lsym
.get_st_type() != elfcpp::STT_SECTION
)
712 strategy
= scan
.local_non_section_strategy(r_type
, object
,
716 strategy
= scan
.local_section_strategy(r_type
, object
);
717 if (strategy
!= Relocatable_relocs::RELOC_DISCARD
)
718 object
->output_section(shndx
)->set_needs_symtab_index();
721 if (strategy
== Relocatable_relocs::RELOC_COPY
)
722 object
->set_must_have_output_symtab_entry(r_sym
);
726 rr
->set_next_reloc_strategy(strategy
);
730 // Relocate relocs. Called for a relocatable link, and for --emit-relocs.
731 // This is a default definition which should work for most targets.
733 template<int size
, bool big_endian
, typename Classify_reloc
>
736 const Relocate_info
<size
, big_endian
>* relinfo
,
737 const unsigned char* prelocs
,
739 Output_section
* output_section
,
740 typename
elfcpp::Elf_types
<size
>::Elf_Off offset_in_output_section
,
742 typename
elfcpp::Elf_types
<size
>::Elf_Addr view_address
,
743 section_size_type view_size
,
744 unsigned char* reloc_view
,
745 section_size_type reloc_view_size
)
747 typedef typename
elfcpp::Elf_types
<size
>::Elf_Addr Address
;
748 typedef typename
Classify_reloc::Reltype Reltype
;
749 typedef typename
Classify_reloc::Reltype_write Reltype_write
;
750 const int reloc_size
= Classify_reloc::reloc_size
;
751 const Address invalid_address
= static_cast<Address
>(0) - 1;
753 Sized_relobj_file
<size
, big_endian
>* const object
= relinfo
->object
;
754 const unsigned int local_count
= object
->local_symbol_count();
756 unsigned char* pwrite
= reloc_view
;
758 for (size_t i
= 0; i
< reloc_count
; ++i
, prelocs
+= reloc_size
)
760 Relocatable_relocs::Reloc_strategy strategy
= relinfo
->rr
->strategy(i
);
761 if (strategy
== Relocatable_relocs::RELOC_DISCARD
)
764 if (strategy
== Relocatable_relocs::RELOC_SPECIAL
)
766 // Target wants to handle this relocation.
767 Sized_target
<size
, big_endian
>* target
=
768 parameters
->sized_target
<size
, big_endian
>();
769 target
->relocate_special_relocatable(relinfo
, Classify_reloc::sh_type
,
770 prelocs
, i
, output_section
,
771 offset_in_output_section
,
774 pwrite
+= reloc_size
;
777 Reltype
reloc(prelocs
);
778 Reltype_write
reloc_write(pwrite
);
780 const unsigned int r_sym
= Classify_reloc::get_r_sym(&reloc
);
782 // Get the new symbol index.
784 Output_section
* os
= NULL
;
785 unsigned int new_symndx
;
786 if (r_sym
< local_count
)
790 case Relocatable_relocs::RELOC_COPY
:
795 new_symndx
= object
->symtab_index(r_sym
);
796 gold_assert(new_symndx
!= -1U);
800 case Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_RELA
:
801 case Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_0
:
802 case Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_1
:
803 case Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_2
:
804 case Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_4
:
805 case Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_8
:
806 case Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_4_UNALIGNED
:
808 // We are adjusting a section symbol. We need to find
809 // the symbol table index of the section symbol for
810 // the output section corresponding to input section
811 // in which this symbol is defined.
812 gold_assert(r_sym
< local_count
);
815 object
->local_symbol_input_shndx(r_sym
, &is_ordinary
);
816 gold_assert(is_ordinary
);
817 os
= object
->output_section(shndx
);
818 gold_assert(os
!= NULL
);
819 gold_assert(os
->needs_symtab_index());
820 new_symndx
= os
->symtab_index();
830 const Symbol
* gsym
= object
->global_symbol(r_sym
);
831 gold_assert(gsym
!= NULL
);
832 if (gsym
->is_forwarder())
833 gsym
= relinfo
->symtab
->resolve_forwards(gsym
);
835 gold_assert(gsym
->has_symtab_index());
836 new_symndx
= gsym
->symtab_index();
839 // Get the new offset--the location in the output section where
840 // this relocation should be applied.
842 Address offset
= reloc
.get_r_offset();
844 if (offset_in_output_section
!= invalid_address
)
845 new_offset
= offset
+ offset_in_output_section
;
848 section_offset_type sot_offset
=
849 convert_types
<section_offset_type
, Address
>(offset
);
850 section_offset_type new_sot_offset
=
851 output_section
->output_offset(object
, relinfo
->data_shndx
,
853 gold_assert(new_sot_offset
!= -1);
854 new_offset
= new_sot_offset
;
857 // In an object file, r_offset is an offset within the section.
858 // In an executable or dynamic object, generated by
859 // --emit-relocs, r_offset is an absolute address.
860 if (!parameters
->options().relocatable())
862 new_offset
+= view_address
;
863 if (offset_in_output_section
!= invalid_address
)
864 new_offset
-= offset_in_output_section
;
867 reloc_write
.put_r_offset(new_offset
);
868 Classify_reloc::put_r_info(&reloc_write
, &reloc
, new_symndx
);
870 // Handle the reloc addend based on the strategy.
872 if (strategy
== Relocatable_relocs::RELOC_COPY
)
874 if (Classify_reloc::sh_type
== elfcpp::SHT_RELA
)
875 Classify_reloc::put_r_addend(&reloc_write
,
876 Classify_reloc::get_r_addend(&reloc
));
880 // The relocation uses a section symbol in the input file.
881 // We are adjusting it to use a section symbol in the output
882 // file. The input section symbol refers to some address in
883 // the input section. We need the relocation in the output
884 // file to refer to that same address. This adjustment to
885 // the addend is the same calculation we use for a simple
886 // absolute relocation for the input section symbol.
888 const Symbol_value
<size
>* psymval
= object
->local_symbol(r_sym
);
890 unsigned char* padd
= view
+ offset
;
893 case Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_RELA
:
895 typename
elfcpp::Elf_types
<size
>::Elf_Swxword addend
;
896 addend
= Classify_reloc::get_r_addend(&reloc
);
897 gold_assert(os
!= NULL
);
898 addend
= psymval
->value(object
, addend
) - os
->address();
899 Classify_reloc::put_r_addend(&reloc_write
, addend
);
903 case Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_0
:
906 case Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_1
:
907 Relocate_functions
<size
, big_endian
>::rel8(padd
, object
,
911 case Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_2
:
912 Relocate_functions
<size
, big_endian
>::rel16(padd
, object
,
916 case Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_4
:
917 Relocate_functions
<size
, big_endian
>::rel32(padd
, object
,
921 case Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_8
:
922 Relocate_functions
<size
, big_endian
>::rel64(padd
, object
,
926 case Relocatable_relocs::RELOC_ADJUST_FOR_SECTION_4_UNALIGNED
:
927 Relocate_functions
<size
, big_endian
>::rel32_unaligned(padd
,
937 pwrite
+= reloc_size
;
940 gold_assert(static_cast<section_size_type
>(pwrite
- reloc_view
)
944 } // End namespace gold.
946 #endif // !defined(GOLD_TARGET_RELOC_H)