mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2025-02-23 13:21:43 +08:00
a71d876801
The logic to decide if an input relocation for a symbol becomes a particular kind of output relocation is one of the hard to maintain parts of the bfd ld backend, since it is partially repeated across elfNN_aarch64_check_relocs (where dynamic relocations are counted per symbol and input section), elfNN_aarch64_late_size_sections (where relocation sections are sized and GOT offsets assigned), elfNN_aarch64_relocate_section (where most relocations are applied and output to a relocation section), elfNN_aarch64_finish_dynamic_symbol (where some of the GOT relocations are applied and output). The DT_RELR support adds another layer to this complexity: after the output relocation sections are sized, so all dynamic relocations are accounted (in elfNN_aarch64_late_size_sections), we scan the symbols and input relocations again to decide which ones become relative relocations that can be packed. The sizes of the relocation sections are updated accordingly. This logic must be consistent with the code that applies the relocs later so each relative relocation is emitted exactly once: either in .rela.* or packed in .relr.dyn. Sizing of .relr.dyn is done via elfNN_aarch64_size_relative_relocs that may be called repeatedly whenever the layout changes since an address change can affect the size of the packed format. Then the final content is emitted in elfNN_aarch64_finish_relative_relocs, that is called after the layout is final and before relocations are applied and emitted. These hooks are only called if DT_RELR is enabled. We only pack relative relocs that are known to be aligned in the output during .relr.dyn sizing, the potentially unaligned relative relocs are emitted normally (in .rela.*, not packed), because the format requires aligned addresses. |
||
|---|---|---|
| .. | ||
| doc | ||
| hosts | ||
| po | ||
| .gitignore | ||
| acinclude.m4 | ||
| aclocal.m4 | ||
| aix5ppc-core.c | ||
| aout32.c | ||
| aout64.c | ||
| aout-cris.c | ||
| aout-ns32k.c | ||
| aout-target.h | ||
| aoutx.h | ||
| arc-got.h | ||
| arc-plt.def | ||
| arc-plt.h | ||
| archive64.c | ||
| archive.c | ||
| archures.c | ||
| ax_tls.m4 | ||
| bfd-in2.h | ||
| bfd-in.h | ||
| bfd.c | ||
| bfd.m4 | ||
| bfdio.c | ||
| binary.c | ||
| bpf-reloc.def | ||
| cache.c | ||
| cf-i386lynx.c | ||
| ChangeLog | ||
| ChangeLog-0001 | ||
| ChangeLog-0203 | ||
| ChangeLog-2004 | ||
| ChangeLog-2005 | ||
| ChangeLog-2006 | ||
| ChangeLog-2007 | ||
| ChangeLog-2008 | ||
| ChangeLog-2009 | ||
| ChangeLog-2010 | ||
| ChangeLog-2011 | ||
| ChangeLog-2012 | ||
| ChangeLog-2013 | ||
| ChangeLog-2014 | ||
| ChangeLog-2015 | ||
| ChangeLog-2016 | ||
| ChangeLog-2017 | ||
| ChangeLog-2018 | ||
| ChangeLog-2019 | ||
| ChangeLog-2020 | ||
| ChangeLog-9193 | ||
| ChangeLog-9495 | ||
| ChangeLog-9697 | ||
| ChangeLog-9899 | ||
| cisco-core.c | ||
| coff64-rs6000.c | ||
| coff-aarch64.c | ||
| coff-alpha.c | ||
| coff-arm.c | ||
| coff-arm.h | ||
| coff-bfd.c | ||
| coff-bfd.h | ||
| coff-go32.c | ||
| coff-i386.c | ||
| coff-ia64.c | ||
| coff-loongarch64.c | ||
| coff-mcore.c | ||
| coff-mips.c | ||
| coff-riscv64.c | ||
| coff-rs6000.c | ||
| coff-sh.c | ||
| coff-stgo32.c | ||
| coff-tic4x.c | ||
| coff-tic30.c | ||
| coff-tic54x.c | ||
| coff-x86_64.c | ||
| coff-z8k.c | ||
| coff-z80.c | ||
| coffcode.h | ||
| coffgen.c | ||
| cofflink.c | ||
| coffswap.h | ||
| compress.c | ||
| config.bfd | ||
| config.in | ||
| configure | ||
| configure.ac | ||
| configure.com | ||
| configure.host | ||
| COPYING | ||
| corefile.c | ||
| cpu-aarch64.c | ||
| cpu-aarch64.h | ||
| cpu-alpha.c | ||
| cpu-amdgcn.c | ||
| cpu-arc.c | ||
| cpu-arm.c | ||
| cpu-arm.h | ||
| cpu-avr.c | ||
| cpu-bfin.c | ||
| cpu-bpf.c | ||
| cpu-cr16.c | ||
| cpu-cris.c | ||
| cpu-crx.c | ||
| cpu-csky.c | ||
| cpu-d10v.c | ||
| cpu-d30v.c | ||
| cpu-dlx.c | ||
| cpu-epiphany.c | ||
| cpu-fr30.c | ||
| cpu-frv.c | ||
| cpu-ft32.c | ||
| cpu-h8300.c | ||
| cpu-h8300.h | ||
| cpu-hppa.c | ||
| cpu-i386.c | ||
| cpu-ia64-opc.c | ||
| cpu-ia64.c | ||
| cpu-iamcu.c | ||
| cpu-ip2k.c | ||
| cpu-iq2000.c | ||
| cpu-kvx.c | ||
| cpu-lm32.c | ||
| cpu-loongarch.c | ||
| cpu-m9s12x.c | ||
| cpu-m9s12xg.c | ||
| cpu-m32c.c | ||
| cpu-m32r.c | ||
| cpu-m68hc11.c | ||
| cpu-m68hc12.c | ||
| cpu-m68k.c | ||
| cpu-m68k.h | ||
| cpu-m10200.c | ||
| cpu-m10300.c | ||
| cpu-mcore.c | ||
| cpu-mep.c | ||
| cpu-metag.c | ||
| cpu-microblaze.c | ||
| cpu-mips.c | ||
| cpu-mmix.c | ||
| cpu-moxie.c | ||
| cpu-msp430.c | ||
| cpu-mt.c | ||
| cpu-nds32.c | ||
| cpu-nfp.c | ||
| cpu-nios2.c | ||
| cpu-ns32k.c | ||
| cpu-or1k.c | ||
| cpu-pdp11.c | ||
| cpu-pj.c | ||
| cpu-powerpc.c | ||
| cpu-pru.c | ||
| cpu-riscv.c | ||
| cpu-riscv.h | ||
| cpu-rl78.c | ||
| cpu-rs6000.c | ||
| cpu-rx.c | ||
| cpu-s12z.c | ||
| cpu-s390.c | ||
| cpu-score.c | ||
| cpu-sh.c | ||
| cpu-sparc.c | ||
| cpu-spu.c | ||
| cpu-tic4x.c | ||
| cpu-tic6x.c | ||
| cpu-tic30.c | ||
| cpu-tic54x.c | ||
| cpu-tilegx.c | ||
| cpu-tilepro.c | ||
| cpu-v850_rh850.c | ||
| cpu-v850.c | ||
| cpu-vax.c | ||
| cpu-visium.c | ||
| cpu-wasm32.c | ||
| cpu-xgate.c | ||
| cpu-xstormy16.c | ||
| cpu-xtensa.c | ||
| cpu-z8k.c | ||
| cpu-z80.c | ||
| dep-in.sed | ||
| development.sh | ||
| dwarf1.c | ||
| dwarf2.c | ||
| ecoff-bfd.h | ||
| ecoff.c | ||
| ecofflink.c | ||
| ecoffswap.h | ||
| elf32-am33lin.c | ||
| elf32-arc.c | ||
| elf32-arm.c | ||
| elf32-arm.h | ||
| elf32-avr.c | ||
| elf32-avr.h | ||
| elf32-bfin.c | ||
| elf32-bfin.h | ||
| elf32-cr16.c | ||
| elf32-cr16.h | ||
| elf32-cris.c | ||
| elf32-crx.c | ||
| elf32-csky.c | ||
| elf32-csky.h | ||
| elf32-d10v.c | ||
| elf32-d30v.c | ||
| elf32-dlx.c | ||
| elf32-dlx.h | ||
| elf32-epiphany.c | ||
| elf32-fr30.c | ||
| elf32-frv.c | ||
| elf32-ft32.c | ||
| elf32-gen.c | ||
| elf32-h8300.c | ||
| elf32-hppa.c | ||
| elf32-hppa.h | ||
| elf32-i386.c | ||
| elf32-ip2k.c | ||
| elf32-iq2000.c | ||
| elf32-lm32.c | ||
| elf32-m32c.c | ||
| elf32-m32r.c | ||
| elf32-m68hc1x.c | ||
| elf32-m68hc1x.h | ||
| elf32-m68hc11.c | ||
| elf32-m68hc12.c | ||
| elf32-m68k.c | ||
| elf32-m68k.h | ||
| elf32-mcore.c | ||
| elf32-mep.c | ||
| elf32-metag.c | ||
| elf32-metag.h | ||
| elf32-microblaze.c | ||
| elf32-mips.c | ||
| elf32-moxie.c | ||
| elf32-msp430.c | ||
| elf32-mt.c | ||
| elf32-nds32.c | ||
| elf32-nds32.h | ||
| elf32-nios2.c | ||
| elf32-nios2.h | ||
| elf32-or1k.c | ||
| elf32-pj.c | ||
| elf32-ppc.c | ||
| elf32-ppc.h | ||
| elf32-pru.c | ||
| elf32-rl78.c | ||
| elf32-rx.c | ||
| elf32-rx.h | ||
| elf32-s12z.c | ||
| elf32-s390.c | ||
| elf32-score7.c | ||
| elf32-score.c | ||
| elf32-score.h | ||
| elf32-sh-relocs.h | ||
| elf32-sh.c | ||
| elf32-sparc.c | ||
| elf32-spu.c | ||
| elf32-spu.h | ||
| elf32-tic6x.c | ||
| elf32-tic6x.h | ||
| elf32-tilegx.c | ||
| elf32-tilegx.h | ||
| elf32-tilepro.c | ||
| elf32-tilepro.h | ||
| elf32-v850.c | ||
| elf32-v850.h | ||
| elf32-vax.c | ||
| elf32-visium.c | ||
| elf32-wasm32.c | ||
| elf32-xgate.c | ||
| elf32-xstormy16.c | ||
| elf32-xtensa.c | ||
| elf32-z80.c | ||
| elf32.c | ||
| elf64-alpha.c | ||
| elf64-amdgcn.c | ||
| elf64-bpf.c | ||
| elf64-gen.c | ||
| elf64-hppa.c | ||
| elf64-hppa.h | ||
| elf64-ia64-vms.c | ||
| elf64-mips.c | ||
| elf64-mmix.c | ||
| elf64-nfp.c | ||
| elf64-ppc.c | ||
| elf64-ppc.h | ||
| elf64-s390.c | ||
| elf64-sparc.c | ||
| elf64-tilegx.c | ||
| elf64-tilegx.h | ||
| elf64-x86-64.c | ||
| elf64.c | ||
| elf-attrs.c | ||
| elf-bfd.h | ||
| elf-eh-frame.c | ||
| elf-hppa.h | ||
| elf-ifunc.c | ||
| elf-linker-x86.h | ||
| elf-linux-core.h | ||
| elf-m10200.c | ||
| elf-m10300.c | ||
| elf-nacl.c | ||
| elf-nacl.h | ||
| elf-properties.c | ||
| elf-s390-common.c | ||
| elf-s390.h | ||
| elf-sframe.c | ||
| elf-strtab.c | ||
| elf-vxworks.c | ||
| elf-vxworks.h | ||
| elf.c | ||
| elfcode.h | ||
| elfcore.h | ||
| elflink.c | ||
| elfn32-mips.c | ||
| elfnn-aarch64.c | ||
| elfnn-ia64.c | ||
| elfnn-kvx.c | ||
| elfnn-loongarch.c | ||
| elfnn-riscv.c | ||
| elfxx-aarch64.c | ||
| elfxx-aarch64.h | ||
| elfxx-ia64.c | ||
| elfxx-ia64.h | ||
| elfxx-kvx-relocs.h | ||
| elfxx-kvx.c | ||
| elfxx-kvx.h | ||
| elfxx-loongarch.c | ||
| elfxx-loongarch.h | ||
| elfxx-mips.c | ||
| elfxx-mips.h | ||
| elfxx-riscv.c | ||
| elfxx-riscv.h | ||
| elfxx-sparc.c | ||
| elfxx-sparc.h | ||
| elfxx-target.h | ||
| elfxx-tilegx.c | ||
| elfxx-tilegx.h | ||
| elfxx-x86.c | ||
| elfxx-x86.h | ||
| format.c | ||
| gen-aout.c | ||
| genlink.h | ||
| go32stub.h | ||
| hash.c | ||
| host-aout.c | ||
| hppabsd-core.c | ||
| hpux-core.c | ||
| i386aout.c | ||
| i386bsd.c | ||
| i386lynx.c | ||
| i386msdos.c | ||
| ihex.c | ||
| init.c | ||
| irix-core.c | ||
| libaout.h | ||
| libbfd-in.h | ||
| libbfd.c | ||
| libbfd.h | ||
| libcoff-in.h | ||
| libcoff.h | ||
| libecoff.h | ||
| libhppa.h | ||
| libpei.h | ||
| libxcoff.h | ||
| linker.c | ||
| lynx-core.c | ||
| mach-o-aarch64.c | ||
| mach-o-arm.c | ||
| mach-o-i386.c | ||
| mach-o-target.c | ||
| mach-o-x86-64.c | ||
| mach-o.c | ||
| mach-o.h | ||
| MAINTAINERS | ||
| Makefile.am | ||
| Makefile.in | ||
| makefile.vms | ||
| mep-relocs.pl | ||
| merge.c | ||
| mmo.c | ||
| netbsd-core.c | ||
| netbsd.h | ||
| ns32k.h | ||
| ns32knetbsd.c | ||
| opncls.c | ||
| osf-core.c | ||
| pc532-mach.c | ||
| pdb.c | ||
| pdp11.c | ||
| pe-aarch64.c | ||
| pe-arm-wince.c | ||
| pe-arm.c | ||
| pe-i386.c | ||
| pe-mcore.c | ||
| pe-sh.c | ||
| pe-x86_64.c | ||
| pef-traceback.h | ||
| pef.c | ||
| pef.h | ||
| pei-aarch64.c | ||
| pei-arm-wince.c | ||
| pei-arm.c | ||
| pei-i386.c | ||
| pei-ia64.c | ||
| pei-loongarch64.c | ||
| pei-mcore.c | ||
| pei-riscv64.c | ||
| pei-sh.c | ||
| pei-x86_64.c | ||
| peicode.h | ||
| peXXigen.c | ||
| plugin.c | ||
| plugin.h | ||
| PORTING | ||
| ppcboot.c | ||
| ptrace-core.c | ||
| README | ||
| reloc16.c | ||
| reloc.c | ||
| rs6000-core.c | ||
| section.c | ||
| simple.c | ||
| som.c | ||
| som.h | ||
| srec.c | ||
| stab-syms.c | ||
| stabs.c | ||
| syms.c | ||
| sysdep.h | ||
| targets.c | ||
| targmatch.sed | ||
| tekhex.c | ||
| TODO | ||
| trad-core.c | ||
| vax1knetbsd.c | ||
| vaxnetbsd.c | ||
| verilog.c | ||
| version.h | ||
| version.m4 | ||
| vms-alpha.c | ||
| vms-lib.c | ||
| vms-misc.c | ||
| vms.h | ||
| warning.m4 | ||
| wasm-module.c | ||
| wasm-module.h | ||
| xcofflink.c | ||
| xcofflink.h | ||
| xsym.c | ||
| xsym.h | ||
| xtensa-dynconfig.c | ||
| xtensa-isa.c | ||
| xtensa-modules.c | ||
BFD is an object file library. It permits applications to use the
same routines to process object files regardless of their format.
BFD is used by the GNU debugger, assembler, linker, and the binary
utilities.
The documentation on using BFD is scanty and may be occasionally
incorrect. Pointers to documentation problems, or an entirely
rewritten manual, would be appreciated.
There is some BFD internals documentation in doc/bfdint.texi which may
help programmers who want to modify BFD.
BFD is normally built as part of another package. See the build
instructions for that package, probably in a README file in the
appropriate directory.
BFD supports the following configure options:
--target=TARGET
The default target for which to build the library. TARGET is
a configuration target triplet, such as sparc-sun-solaris.
--enable-targets=TARGET,TARGET,TARGET...
Additional targets the library should support. To include
support for all known targets, use --enable-targets=all.
--enable-64-bit-bfd
Include support for 64 bit targets. This is automatically
turned on if you explicitly request a 64 bit target, but not
for --enable-targets=all. This requires a compiler with a 64
bit integer type, such as gcc.
--enable-shared
Build BFD as a shared library.
--with-mmap
Use mmap when accessing files. This is faster on some hosts,
but slower on others. It may not work on all hosts.
Report bugs in BFD to https://sourceware.org/bugzilla/
Patches are encouraged. When sending patches, always send the output
of diff -u or diff -c from the original file to the new file. Do not
send default diff output. Do not make the diff from the new file to
the original file. Remember that any patch must not break other
systems. Remember that BFD must support cross compilation from any
host to any target, so patches which use ``#ifdef HOST'' are not
acceptable. Please also read the ``Reporting Bugs'' section of the
gcc manual.
Bug reports without patches will be remembered, but they may never get
fixed until somebody volunteers to fix them.
Copyright (C) 2012-2024 Free Software Foundation, Inc.
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.