mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2024-12-15 04:31:49 +08:00
9d862524f6
Verify that the ISA mode of branch targets is the same as the referring
relocation, so that an attempt to produce a branch between instructions
encoded in different ISA modes each causes an error rather than silently
producing non-functional code. Make sure that no symbol or addend bits
are silently truncated: terminate with an error if the relocation value
calculated cannot be encoded in the relocatable field of a branch; for
REL targets also applying to any intermediate addend.
Also make jump target's alignment verification consistent with that for
branches.
This change will require an update to some obscure handcoded assembly
sources which make branches to labels placed at data objects, however
for microMIPS code only. These labels will have to be updated with the
`.insn' directive for containing code to assemble and link successfully.
Such code is broken as any such labels have always been required by the
microMIPS architecture specification[1][2] to be annotated this way for
correct interpretation, and with our old code missing `.insn' directives
caused labels to present different semantics depending on whether they
were referred with branch (ISA bit ignored) or other relocations (ISA
bit respected).
Enforcing these checks however will ensure errors in building software,
like mixed regular MIPS and microMIPS code links with branches between,
will be diagnosed at the build time rather than causing odd run-time
errors such as intermittent crashes. It will also let cross-mode BAL
instructions be converted to JALX instructions, with a separate change.
References:
[1] "MIPS Architecture for Programmers, Volume II-B: The microMIPS32
Instruction Set", MIPS Technologies, Inc., Document Number: MD00582,
Revision 5.04, January 15, 2014, Section 7.1 "Assembly-Level
Compatibility", p. 533
[2] "MIPS Architecture for Programmers, Volume II-B: The microMIPS64
Instruction Set", MIPS Technologies, Inc., Document Number: MD00594,
Revision 5.04, January 15, 2014, Section 8.1 "Assembly-Level
Compatibility", p. 623
bfd/
* elfxx-mips.c (b_reloc_p): Add R_MICROMIPS_PC16_S1,
R_MICROMIPS_PC10_S1 and R_MICROMIPS_PC7_S1.
(branch_reloc_p): New function.
(mips_elf_calculate_relocation): Handle ISA mode determination
for relocations against section symbols, against absolute
symbols and absolute relocations. Also set `*cross_mode_jump_p'
for branches.
<R_MIPS16_26, R_MIPS_26, R_MICROMIPS_26_S1>: Suppress alignment
checks for weak undefined symbols. Also check target alignment
within the same ISA mode.
<R_MIPS_PC16, R_MIPS_GNU_REL16_S2>: Handle cross-mode branches
in the alignment check.
<R_MICROMIPS_PC7_S1>: Add an alignment check.
<R_MICROMIPS_PC10_S1>: Likewise.
<R_MICROMIPS_PC16_S1>: Likewise.
(mips_elf_perform_relocation): Report a failure for unsupported
same-mode JALX instructions and cross-mode branches.
(_bfd_mips_elf_relocate_section) <bfd_reloc_outofrange>: Add
error messages for jumps to misaligned addresses.
gas/
* config/tc-mips.c (mips_force_relocation): Also retain branch
relocations against MIPS16 and microMIPS symbols.
(fix_bad_cross_mode_jump_p): New function.
(fix_bad_same_mode_jalx_p): Likewise.
(fix_bad_misaligned_jump_p): Likewise.
(fix_bad_cross_mode_branch_p): Likewise.
(fix_bad_misaligned_branch_p): Likewise.
(fix_validate_branch): Likewise.
(md_apply_fix) <BFD_RELOC_MIPS_JMP, BFD_RELOC_MIPS16_JMP>
<BFD_RELOC_MICROMIPS_JMP>: Separate from BFD_RELOC_MIPS_SHIFT5,
etc. Verify the ISA mode and alignment of the jump target.
<BFD_RELOC_MIPS_21_PCREL_S2>: Replace the inline alignment check
with a call to `fix_validate_branch'.
<BFD_RELOC_MIPS_26_PCREL_S2>: Likewise.
<BFD_RELOC_16_PCREL_S2>: Likewise.
<BFD_RELOC_MICROMIPS_7_PCREL_S1, BFD_RELOC_MICROMIPS_10_PCREL_S1>
<BFD_RELOC_MICROMIPS_16_PCREL_S1>: Retain the original addend.
Verify the ISA mode and alignment of the branch target.
(md_convert_frag): Verify the ISA mode and alignment of resolved
MIPS16 branch targets.
* testsuite/gas/mips/branch-misc-1.s: Annotate non-instruction
branch targets with `.insn'.
* testsuite/gas/mips/branch-misc-5.s: Likewise.
* testsuite/gas/mips/micromips@branch-misc-5-64.d: Update
accordingly.
* testsuite/gas/mips/micromips@branch-misc-5pic-64.d: Likewise.
* testsuite/gas/mips/micromips-branch-relax.s: Annotate
non-instruction branch target with `.insn'.
* testsuite/gas/mips/micromips.s: Replace microMIPS JALX targets
with external symbols.
* testsuite/gas/mips/micromips-insn32.d: Update accordingly.
* testsuite/gas/mips/micromips-noinsn32.d: Likewise.
* testsuite/gas/mips/micromips-trap.d: Likewise.
* testsuite/gas/mips/micromips.d: Likewise.
* testsuite/gas/mips/mips16.s: Annotate non-instruction branch
targets with `.insn'.
* testsuite/gas/mips/mips16.d: Update accordingly.
* testsuite/gas/mips/mips16-64.d: Likewise.
* testsuite/gas/mips/mips16-dwarf2.s: Annotate non-instruction
branch target with `.insn'.
* testsuite/gas/mips/relax-swap3.s: Likewise.
* testsuite/gas/mips/branch-local-2.l: New list test.
* testsuite/gas/mips/branch-local-3.l: New list test.
* testsuite/gas/mips/branch-local-n32-2.l: New list test.
* testsuite/gas/mips/branch-local-n32-3.l: New list test.
* testsuite/gas/mips/branch-local-n64-2.l: New list test.
* testsuite/gas/mips/branch-local-n64-3.l: New list test.
* testsuite/gas/mips/unaligned-jump-1.l: New list test.
* testsuite/gas/mips/unaligned-jump-2.l: New list test.
* testsuite/gas/mips/unaligned-jump-3.d: New test.
* testsuite/gas/mips/unaligned-jump-mips16-1.l: New list test.
* testsuite/gas/mips/unaligned-jump-mips16-2.l: New list test.
* testsuite/gas/mips/unaligned-jump-mips16-3.d: New test.
* testsuite/gas/mips/unaligned-jump-micromips-1.l: New list
test.
* testsuite/gas/mips/unaligned-jump-micromips-2.l: New list
test.
* testsuite/gas/mips/unaligned-jump-micromips-3.d: New test.
* testsuite/gas/mips/unaligned-branch-1.l: New list test.
* testsuite/gas/mips/unaligned-branch-2.l: New list test.
* testsuite/gas/mips/unaligned-branch-3.d: New test.
* testsuite/gas/mips/unaligned-branch-r6-1.l: New list test.
* testsuite/gas/mips/unaligned-branch-r6-2.l: New list test.
* testsuite/gas/mips/unaligned-branch-r6-3.l: New list test.
* testsuite/gas/mips/unaligned-branch-r6-4.l: New list test.
* testsuite/gas/mips/unaligned-branch-r6-5.d: New test.
* testsuite/gas/mips/unaligned-branch-r6-6.d: New test.
* testsuite/gas/mips/unaligned-branch-mips16-1.l: New list test.
* testsuite/gas/mips/unaligned-branch-mips16-2.l: New list test.
* testsuite/gas/mips/unaligned-branch-mips16-3.d: New test.
* testsuite/gas/mips/unaligned-branch-micromips-1.l: New list
test.
* testsuite/gas/mips/unaligned-branch-micromips-2.l: New list
test.
* testsuite/gas/mips/unaligned-branch-micromips-3.d: New test.
* testsuite/gas/mips/branch-local-2.s: New test source.
* testsuite/gas/mips/branch-local-3.s: New test source.
* testsuite/gas/mips/branch-local-n32-2.s: New test source.
* testsuite/gas/mips/branch-local-n32-3.s: New test source.
* testsuite/gas/mips/branch-local-n64-2.s: New test source.
* testsuite/gas/mips/branch-local-n64-3.s: New test source.
* testsuite/gas/mips/unaligned-jump-1.s: New test source.
* testsuite/gas/mips/unaligned-jump-2.s: New test source.
* testsuite/gas/mips/unaligned-jump-mips16-1.s: New test source.
* testsuite/gas/mips/unaligned-jump-mips16-2.s: New test source.
* testsuite/gas/mips/unaligned-jump-micromips-1.s: New test
source.
* testsuite/gas/mips/unaligned-jump-micromips-2.s: New test
source.
* testsuite/gas/mips/unaligned-branch-1.s: New test source.
* testsuite/gas/mips/unaligned-branch-2.s: New test source.
* testsuite/gas/mips/unaligned-branch-r6-1.s: New test source.
* testsuite/gas/mips/unaligned-branch-r6-2.s: New test source.
* testsuite/gas/mips/unaligned-branch-r6-3.s: New test source.
* testsuite/gas/mips/unaligned-branch-r6-4.s: New test source.
* testsuite/gas/mips/unaligned-branch-mips16-1.s: New test
source.
* testsuite/gas/mips/unaligned-branch-mips16-2.s: New test
source.
* testsuite/gas/mips/unaligned-branch-micromips-1.s: New test
source.
* testsuite/gas/mips/unaligned-branch-micromips-2.s: New test
source.
* testsuite/gas/mips/mips.exp: Run the new tests.
ld/
* testsuite/ld-mips-elf/unaligned-jalx-1.d: Update error message
expected.
* testsuite/ld-mips-elf/unaligned-jalx-addend-1.d: Likewise.
* testsuite/ld-mips-elf/unaligned-jalx-addend-mips16-1.d:
Likewise.
* testsuite/ld-mips-elf/unaligned-jalx-addend-micromips-1.d:
Likewise.
* testsuite/ld-mips-elf/unaligned-jalx-mips16-1.d: Likewise.
* testsuite/ld-mips-elf/unaligned-jalx-micromips-1.d: Likewise.
* testsuite/ld-mips-elf/undefweak-overflow.s: Add jumps,
microMIPS BAL and MIPS16 instructions.
* testsuite/ld-mips-elf/undefweak-overflow.d: Update
accordingly.
* testsuite/ld-mips-elf/unaligned-branch-2.d: New test.
* testsuite/ld-mips-elf/unaligned-branch-r6-1.d: New test.
* testsuite/ld-mips-elf/unaligned-branch-r6-2.d: New test.
* testsuite/ld-mips-elf/unaligned-branch-mips16.d: New test.
* testsuite/ld-mips-elf/unaligned-branch-micromips.d: New test.
* testsuite/ld-mips-elf/unaligned-jump-mips16.d: New test.
* testsuite/ld-mips-elf/unaligned-jump-micromips.d: New test.
* testsuite/ld-mips-elf/unaligned-jump.d: New test.
* testsuite/ld-mips-elf/mips-elf.exp: Run the new tests.
|
||
|---|---|---|
| .. | ||
| doc | ||
| hosts | ||
| po | ||
| .gitignore | ||
| acinclude.m4 | ||
| aclocal.m4 | ||
| aix5ppc-core.c | ||
| aix386-core.c | ||
| aout0.c | ||
| aout32.c | ||
| aout64.c | ||
| aout-adobe.c | ||
| aout-arm.c | ||
| aout-cris.c | ||
| aout-ns32k.c | ||
| aout-sparcle.c | ||
| aout-target.h | ||
| aout-tic30.c | ||
| aoutf1.h | ||
| aoutx.h | ||
| arc-got.h | ||
| arc-plt.def | ||
| arc-plt.h | ||
| archive64.c | ||
| archive.c | ||
| archures.c | ||
| armnetbsd.c | ||
| bfd-in2.h | ||
| bfd-in.h | ||
| bfd.c | ||
| bfd.m4 | ||
| bfdio.c | ||
| bfdwin.c | ||
| binary.c | ||
| bout.c | ||
| cache.c | ||
| cf-i386lynx.c | ||
| cf-sparclynx.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-9193 | ||
| ChangeLog-9495 | ||
| ChangeLog-9697 | ||
| ChangeLog-9899 | ||
| cisco-core.c | ||
| coff64-rs6000.c | ||
| coff-alpha.c | ||
| coff-apollo.c | ||
| coff-arm.c | ||
| coff-aux.c | ||
| coff-bfd.c | ||
| coff-bfd.h | ||
| coff-go32.c | ||
| coff-h8300.c | ||
| coff-h8500.c | ||
| coff-i386.c | ||
| coff-i860.c | ||
| coff-i960.c | ||
| coff-ia64.c | ||
| coff-m68k.c | ||
| coff-m88k.c | ||
| coff-mcore.c | ||
| coff-mips.c | ||
| coff-ppc.c | ||
| coff-rs6000.c | ||
| coff-sh.c | ||
| coff-sparc.c | ||
| coff-stgo32.c | ||
| coff-svm68k.c | ||
| coff-tic4x.c | ||
| coff-tic30.c | ||
| coff-tic54x.c | ||
| coff-tic80.c | ||
| coff-u68k.c | ||
| coff-w65.c | ||
| coff-we32k.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-alpha.c | ||
| cpu-arc.c | ||
| cpu-arm.c | ||
| cpu-avr.c | ||
| cpu-bfin.c | ||
| cpu-cr16.c | ||
| cpu-cr16c.c | ||
| cpu-cris.c | ||
| cpu-crx.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-h8500.c | ||
| cpu-hppa.c | ||
| cpu-i370.c | ||
| cpu-i386.c | ||
| cpu-i860.c | ||
| cpu-i960.c | ||
| cpu-ia64-opc.c | ||
| cpu-ia64.c | ||
| cpu-iamcu.c | ||
| cpu-ip2k.c | ||
| cpu-iq2000.c | ||
| cpu-k1om.c | ||
| cpu-l1om.c | ||
| cpu-lm32.c | ||
| cpu-m9s12x.c | ||
| cpu-m9s12xg.c | ||
| cpu-m32c.c | ||
| cpu-m32r.c | ||
| cpu-m68hc11.c | ||
| cpu-m68hc12.c | ||
| cpu-m68k.c | ||
| cpu-m88k.c | ||
| 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-nios2.c | ||
| cpu-ns32k.c | ||
| cpu-or1k.c | ||
| cpu-pdp11.c | ||
| cpu-pj.c | ||
| cpu-plugin.c | ||
| cpu-powerpc.c | ||
| cpu-rl78.c | ||
| cpu-rs6000.c | ||
| cpu-rx.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-tic80.c | ||
| cpu-tilegx.c | ||
| cpu-tilepro.c | ||
| cpu-v850_rh850.c | ||
| cpu-v850.c | ||
| cpu-vax.c | ||
| cpu-visium.c | ||
| cpu-w65.c | ||
| cpu-we32k.c | ||
| cpu-xc16x.c | ||
| cpu-xgate.c | ||
| cpu-xstormy16.c | ||
| cpu-xtensa.c | ||
| cpu-z8k.c | ||
| cpu-z80.c | ||
| demo64.c | ||
| dep-in.sed | ||
| development.sh | ||
| dwarf1.c | ||
| dwarf2.c | ||
| ecoff.c | ||
| ecofflink.c | ||
| ecoffswap.h | ||
| elf32-am33lin.c | ||
| elf32-arc.c | ||
| elf32-arm.c | ||
| elf32-avr.c | ||
| elf32-avr.h | ||
| elf32-bfin.c | ||
| elf32-cr16.c | ||
| elf32-cr16c.c | ||
| elf32-cris.c | ||
| elf32-crx.c | ||
| 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-i370.c | ||
| elf32-i386.c | ||
| elf32-i860.c | ||
| elf32-i960.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-m88k.c | ||
| 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-rl78.c | ||
| elf32-rx.c | ||
| elf32-rx.h | ||
| elf32-s390.c | ||
| elf32-score7.c | ||
| elf32-score.c | ||
| elf32-score.h | ||
| elf32-sh64-com.c | ||
| elf32-sh64.c | ||
| elf32-sh64.h | ||
| elf32-sh-relocs.h | ||
| elf32-sh-symbian.c | ||
| 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-vax.c | ||
| elf32-visium.c | ||
| elf32-xc16x.c | ||
| elf32-xgate.c | ||
| elf32-xgate.h | ||
| elf32-xstormy16.c | ||
| elf32-xtensa.c | ||
| elf32.c | ||
| elf64-alpha.c | ||
| elf64-gen.c | ||
| elf64-hppa.c | ||
| elf64-hppa.h | ||
| elf64-ia64-vms.c | ||
| elf64-mips.c | ||
| elf64-mmix.c | ||
| elf64-ppc.c | ||
| elf64-ppc.h | ||
| elf64-s390.c | ||
| elf64-sh64.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-linux-core.h | ||
| elf-m10200.c | ||
| elf-m10300.c | ||
| elf-nacl.c | ||
| elf-nacl.h | ||
| elf-s390-common.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 | ||
| elfxx-aarch64.c | ||
| elfxx-aarch64.h | ||
| elfxx-ia64.c | ||
| elfxx-ia64.h | ||
| elfxx-mips.c | ||
| elfxx-mips.h | ||
| elfxx-sparc.c | ||
| elfxx-sparc.h | ||
| elfxx-target.h | ||
| elfxx-tilegx.c | ||
| elfxx-tilegx.h | ||
| epoc-pe-arm.c | ||
| epoc-pei-arm.c | ||
| format.c | ||
| freebsd.h | ||
| gen-aout.c | ||
| genlink.h | ||
| go32stub.h | ||
| hash.c | ||
| host-aout.c | ||
| hp300bsd.c | ||
| hp300hpux.c | ||
| hppabsd-core.c | ||
| hpux-core.c | ||
| i386aout.c | ||
| i386bsd.c | ||
| i386dynix.c | ||
| i386freebsd.c | ||
| i386linux.c | ||
| i386lynx.c | ||
| i386mach3.c | ||
| i386msdos.c | ||
| i386netbsd.c | ||
| i386os9k.c | ||
| ieee.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 | ||
| libieee.h | ||
| libnlm.h | ||
| liboasys.h | ||
| libpei.h | ||
| libxcoff.h | ||
| linker.c | ||
| lynx-core.c | ||
| m68k4knetbsd.c | ||
| m68klinux.c | ||
| m68knetbsd.c | ||
| m88kmach3.c | ||
| m88kopenbsd.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 | ||
| mipsbsd.c | ||
| mmo.c | ||
| netbsd-core.c | ||
| netbsd.h | ||
| newsos3.c | ||
| nlm32-alpha.c | ||
| nlm32-i386.c | ||
| nlm32-ppc.c | ||
| nlm32-sparc.c | ||
| nlm32.c | ||
| nlm64.c | ||
| nlm-target.h | ||
| nlm.c | ||
| nlmcode.h | ||
| nlmswap.h | ||
| ns32k.h | ||
| ns32knetbsd.c | ||
| oasys.c | ||
| opncls.c | ||
| osf-core.c | ||
| pc532-mach.c | ||
| pdp11.c | ||
| pe-arm-wince.c | ||
| pe-arm.c | ||
| pe-i386.c | ||
| pe-mcore.c | ||
| pe-mips.c | ||
| pe-ppc.c | ||
| pe-sh.c | ||
| pe-x86_64.c | ||
| pef-traceback.h | ||
| pef.c | ||
| pef.h | ||
| pei-arm-wince.c | ||
| pei-arm.c | ||
| pei-i386.c | ||
| pei-ia64.c | ||
| pei-mcore.c | ||
| pei-mips.c | ||
| pei-ppc.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 | ||
| riscix.c | ||
| rs6000-core.c | ||
| sco5-core.c | ||
| section.c | ||
| simple.c | ||
| som.c | ||
| som.h | ||
| sparclinux.c | ||
| sparclynx.c | ||
| sparcnetbsd.c | ||
| srec.c | ||
| stab-syms.c | ||
| stabs.c | ||
| stamp-h.in | ||
| sunos.c | ||
| syms.c | ||
| sysdep.h | ||
| targets.c | ||
| targmatch.sed | ||
| tekhex.c | ||
| TODO | ||
| trad-core.c | ||
| vax1knetbsd.c | ||
| vaxbsd.c | ||
| vaxnetbsd.c | ||
| verilog.c | ||
| versados.c | ||
| version.h | ||
| version.m4 | ||
| vms-alpha.c | ||
| vms-lib.c | ||
| vms-misc.c | ||
| vms.h | ||
| warning.m4 | ||
| xcofflink.c | ||
| xsym.c | ||
| xsym.h | ||
| 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 with BFD to bug-binutils@gnu.org.
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-2016 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.