binutils-gdb/bfd
H.J. Lu 0ff2b86e7c Create the second PLT for BND relocations
Intel MPX introduces 4 bound registers, which will be used for parameter
passing in x86-64.  Bound registers are cleared by branch instructions.
Branch instructions with BND prefix will keep bound register contents.
This leads to 2 requirements to 64-bit MPX run-time:

1. Dynamic linker (ld.so) should save and restore bound registers during
symbol lookup.
2. Change the current 16-byte PLT0:

  ff 35 08 00 00 00	pushq  GOT+8(%rip)
  ff 25 00 10 00	jmpq  *GOT+16(%rip)
  0f 1f 40 00		nopl   0x0(%rax)

and 16-byte PLT1:

  ff 25 00 00 00 00    	jmpq   *name@GOTPCREL(%rip)
  68 00 00 00 00       	pushq  $index
  e9 00 00 00 00       	jmpq   PLT0

which clear bound registers, to preserve bound registers.

We use 2 new relocations:

to mark branch instructions with BND prefix.

When linker sees any R_X86_64_PC32_BND or R_X86_64_PLT32_BND relocations,
it switches to a different PLT0:

  ff 35 08 00 00 00	pushq  GOT+8(%rip)
  f2 ff 25 00 10 00	bnd jmpq *GOT+16(%rip)
  0f 1f 00		nopl   (%rax)

to preserve bound registers for symbol lookup and it also creates an
external PLT section, .pl.bnd.  Linker will create a BND PLT1 entry
in .plt:

  68 00 00 00 00       	pushq  $index
  f2 e9 00 00 00 00     bnd jmpq PLT0
  0f 1f 44 00 00        nopl 0(%rax,%rax,1)

and a 8-byte BND PLT entry in .plt.bnd:

  f2 ff 25 00 00 00 00  bnd jmpq *name@GOTPCREL(%rip)
  90			nop

Otherwise, linker will create a legacy PLT1 entry in .plt:

  68 00 00 00 00       	pushq  $index
  e9 00 00 00 00        jmpq PLT0
  66 0f 1f 44 00 00     nopw 0(%rax,%rax,1)

and a 8-byte legacy PLT in .plt.bnd:

  ff 25 00 00 00 00     jmpq  *name@GOTPCREL(%rip)
  66 90                 xchg  %ax,%ax

The initial value of the GOT entry for "name" will be set to the the
"pushq" instruction in the corresponding entry in .plt.  Linker will
resolve reference of symbol "name" to the entry in the second PLT,
.plt.bnd.

Prelink stores the offset of pushq of PLT1 (plt_base + 0x10) in GOT[1]
and GOT[1] is stored in GOT[3].  We can undo prelink in GOT by computing
the corresponding the pushq offset with

GOT[1] + (GOT offset - &GOT[3]) * 2

Since for each entry in .plt except for PLT0 we create a 8-byte entry in
.plt.bnd, there is extra 8-byte per PLT symbol.

We also investigated the 16-byte entry for .plt.bnd.  We compared the
8-byte entry vs the the 16-byte entry for .plt.bnd on Sandy Bridge.
There are no performance differences in SPEC CPU 2000/2006 as well as
micro benchmarks.

Pros:
	No change to undo prelink in dynamic linker.
	Only 8-byte memory overhead for each PLT symbol.
Cons:
	Extra .plt.bnd section is needed.
	Extra 8 byte for legacy branches to PLT.
	GDB is unware of the new layout of .plt and .plt.bnd.

bfd/

	* elf64-x86-64.c (elf_x86_64_bnd_plt0_entry): New.
	(elf_x86_64_legacy_plt_entry): Likewise.
	(elf_x86_64_bnd_plt_entry): Likewise.
	(elf_x86_64_legacy_plt2_entry): Likewise.
	(elf_x86_64_bnd_plt2_entry): Likewise.
	(elf_x86_64_bnd_arch_bed): Likewise.
	(elf_x86_64_link_hash_entry): Add has_bnd_reloc and plt_bnd.
	(elf_x86_64_link_hash_table): Add plt_bnd.
	(elf_x86_64_link_hash_newfunc): Initialize has_bnd_reloc and
	plt_bnd.
	(elf_x86_64_copy_indirect_symbol): Also copy has_bnd_reloc.
	(elf_x86_64_check_relocs): Create the second PLT for Intel MPX
	in 64-bit mode.
	(elf_x86_64_allocate_dynrelocs): Handle the second PLT for IFUNC
	symbols.  Resolve call to the second PLT if it is created.
	(elf_x86_64_size_dynamic_sections): Keep the second PLT section.
	(elf_x86_64_relocate_section): Resolve PLT references to the
	second PLT if it is created.
	(elf_x86_64_finish_dynamic_symbol): Use BND PLT0 and fill the
	second PLT entry for BND relocation.
	(elf_x86_64_finish_dynamic_sections): Use MPX backend data if
	the second PLT is created.
	(elf_x86_64_get_synthetic_symtab): New.
	(bfd_elf64_get_synthetic_symtab): Likewise.  Undefine for NaCl.

ld/

	* emulparams/elf_x86_64.sh (TINY_READONLY_SECTION): New.

ld/testsuite/

	* ld-x86-64/mpx.exp: Run bnd-ifunc-1 and bnd-plt-1.
	* ld-x86-64/bnd-ifunc-1.d: New file.
	* ld-x86-64/bnd-ifunc-1.s: Likewise.
	* ld-x86-64/bnd-plt-1.d: Likewise.
2014-02-19 11:48:23 -08:00
..
doc binutils doc update 2013-10-25 14:02:58 +00:00
hosts
po binutils potfiles regen 2014-02-10 09:59:35 +10:30
.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
archive64.c
archive.c PR binutils/11983 2014-01-02 12:14:37 +00:00
archures.c Add support for Andes NDS32: 2013-12-13 11:52:32 +00:00
armnetbsd.c
bfd-in2.h Nios II large-GOT relocations 2014-02-03 08:42:42 -08:00
bfd-in.h Following up on Tom's suggestion I am checking in a patch to replace the various 2014-01-29 13:46:39 +00:00
bfd.c Following up on Tom's suggestion I am checking in a patch to replace the various 2014-01-29 13:46:39 +00:00
bfd.m4
bfdio.c PR binutils/15834 2013-08-23 07:54:19 +00:00
bfdwin.c
binary.c
bout.c
cache.c * cache.c (bfd_cache_max_open): Cast RLIM_INFINITY to rlim_t. 2014-02-07 15:44:58 +01:00
cf-i386lynx.c
cf-sparclynx.c
ChangeLog Create the second PLT for BND relocations 2014-02-19 11:48:23 -08:00
ChangeLog-0001
ChangeLog-0203
ChangeLog-2004
ChangeLog-2005
ChangeLog-2006
ChangeLog-2007
ChangeLog-2008
ChangeLog-2009
ChangeLog-2010
ChangeLog-2011
ChangeLog-2012
ChangeLog-2013 New Year - binutils ChangeLog rotation 2014-01-08 05:32:12 -08:00
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-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-or32.c
coff-ppc.c
coff-rs6000.c Fix PowerPC targets minor memory leaks found by Coverity 2014-02-04 20:17:16 +01:00
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 2013-08-21 Tristan Gingold <gingold@adacore.com> 2013-08-21 08:15:23 +00:00
coffgen.c
cofflink.c
coffswap.h
compress.c
config.bfd Add support for Andes NDS32: 2013-12-13 11:52:32 +00:00
config.in * peXXigen.c: Include wchar.h if available. 2013-12-17 15:39:13 +00:00
configure * peXXigen.c: Include wchar.h if available. 2013-12-17 15:39:13 +00:00
configure.com
configure.host
configure.in * peXXigen.c: Include wchar.h if available. 2013-12-17 15:39:13 +00:00
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-h8300.c
cpu-h8500.c
cpu-hppa.c
cpu-i370.c
cpu-i386.c bfd/ 2013-08-26 22:18:07 +00:00
cpu-i860.c
cpu-i960.c
cpu-ia64-opc.c
cpu-ia64.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 * emulparams/msp430all.sh: Update ARCH names. 2013-09-30 09:03:59 +00:00
cpu-mt.c
cpu-nds32.c Add support for Andes NDS32: 2013-12-13 11:52:32 +00:00
cpu-nios2.c
cpu-ns32k.c
cpu-openrisc.c
cpu-or32.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-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
dwarf1.c
dwarf2.c When parsing a DW_FORM_ref_addr attribute the CU containing the 2014-01-28 13:43:35 +00:00
ecoff.c
ecofflink.c
ecoffswap.h
elf32-am33lin.c
elf32-arc.c
elf32-arm.c 2014-01-13 Ma Jiang <ma.jiang@zte.com.cn> 2014-01-13 16:06:28 +00:00
elf32-avr.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-avr.h
elf32-bfin.c Use _bfd_elf_copy_private_bfd_data 2013-12-17 11:48:18 -08:00
elf32-cr16.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-cr16c.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-cris.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-crx.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-d10v.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-d30v.c
elf32-dlx.c
elf32-epiphany.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-fr30.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-frv.c Use _bfd_elf_copy_private_bfd_data 2013-12-17 11:48:18 -08:00
elf32-gen.c
elf32-h8300.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-hppa.c Default elf_backend_post_process_headers to set OSABI 2013-12-17 13:41:17 -08:00
elf32-hppa.h
elf32-i370.c Default elf_backend_post_process_headers to set OSABI 2013-12-17 13:41:17 -08:00
elf32-i386.c Revert the last change 2014-01-15 03:59:42 -08:00
elf32-i860.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-i960.c
elf32-ip2k.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-iq2000.c Use _bfd_elf_copy_private_bfd_data 2013-12-17 11:48:18 -08:00
elf32-lm32.c Use _bfd_elf_copy_private_bfd_data 2013-12-17 11:48:18 -08:00
elf32-m32c.c bfd/ChangeLog 2013-10-09 05:23:23 +00:00
elf32-m32r.c
elf32-m68hc1x.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-m68hc1x.h
elf32-m68hc11.c
elf32-m68hc12.c
elf32-m68k.c Set proper OS ABI magic for ELF/m68k 2013-12-19 12:27:19 +01:00
elf32-m88k.c
elf32-mcore.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-mep.c Use _bfd_elf_copy_private_bfd_data 2013-12-17 11:48:18 -08:00
elf32-metag.c My patch to the binutils strip-10.d test was wrong. The osabi field should always be set to 2014-01-29 14:01:54 +00:00
elf32-metag.h
elf32-microblaze.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-mips.c Default elf_backend_post_process_headers to set OSABI 2013-12-17 13:41:17 -08:00
elf32-moxie.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-msp430.c Default elf_backend_post_process_headers to set OSABI 2013-12-17 13:41:17 -08:00
elf32-mt.c Use _bfd_elf_copy_private_bfd_data 2013-12-17 11:48:18 -08:00
elf32-nds32.c Add support for Andes NDS32: 2013-12-13 11:52:32 +00:00
elf32-nds32.h Add support for Andes NDS32: 2013-12-13 11:52:32 +00:00
elf32-nios2.c Nios II large-GOT relocations 2014-02-03 08:42:42 -08:00
elf32-nios2.h Nios II CALL26 linker relaxation 2014-01-30 17:47:07 -08:00
elf32-openrisc.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-or32.c
elf32-pj.c
elf32-ppc.c ppc476 workaround for ld -r fixes 2014-02-17 17:00:19 +10:30
elf32-ppc.h Enable ppc476 workaround for ld -r. 2014-02-12 22:10:09 +10:30
elf32-rl78.c * elf32-rl78.c (elf32_rl78_relax_delete_bytes): Make sure relocs 2013-11-05 22:13:04 -05:00
elf32-rx.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-s390.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-score7.c
elf32-score.c
elf32-score.h
elf32-sh64-com.c
elf32-sh64.c My patch to the binutils strip-10.d test was wrong. The osabi field should always be set to 2014-01-29 14:01:54 +00:00
elf32-sh64.h
elf32-sh-relocs.h
elf32-sh-symbian.c
elf32-sh.c Use _bfd_elf_copy_private_bfd_data 2013-12-17 11:48:18 -08:00
elf32-sparc.c Default elf_backend_post_process_headers to set OSABI 2013-12-17 13:41:17 -08:00
elf32-spu.c Call _bfd_elf_post_process_headers 2013-12-17 14:10:03 -08:00
elf32-spu.h
elf32-tic6x.c Default elf_backend_post_process_headers to set OSABI 2013-12-17 13:41:17 -08:00
elf32-tic6x.h
elf32-tilegx.c
elf32-tilegx.h
elf32-tilepro.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-tilepro.h
elf32-v850.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-vax.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-xc16x.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-xgate.c
elf32-xgate.h
elf32-xstormy16.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf32-xtensa.c remove VA_* from binutils 2014-01-07 09:17:05 -07:00
elf32.c
elf64-alpha.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf64-gen.c
elf64-hppa.c Default elf_backend_post_process_headers to set OSABI 2013-12-17 13:41:17 -08:00
elf64-hppa.h
elf64-ia64-vms.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf64-mips.c Default elf_backend_post_process_headers to set OSABI 2013-12-17 13:41:17 -08:00
elf64-mmix.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf64-ppc.c Control powerpc64-ld provision of register save/restore 2014-02-19 14:53:50 +10:30
elf64-ppc.h Control powerpc64-ld provision of register save/restore 2014-02-19 14:53:50 +10:30
elf64-s390.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf64-sh64.c My patch to the binutils strip-10.d test was wrong. The osabi field should always be set to 2014-01-29 14:01:54 +00:00
elf64-sparc.c Default elf_backend_post_process_headers to set OSABI 2013-12-17 13:41:17 -08:00
elf64-tilegx.c
elf64-tilegx.h
elf64-x86-64.c Create the second PLT for BND relocations 2014-02-19 11:48:23 -08:00
elf64.c
elf-attrs.c
elf-bfd.h powerpc relax_section and section contents cache 2014-02-09 23:25:14 +10:30
elf-eh-frame.c Don't segv on cie.initial_instructions[] overflow. 2013-12-21 00:08:34 +10:30
elf-hppa.h
elf-ifunc.c
elf-linux-psinfo.h
elf-m10200.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf-m10300.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elf-nacl.c Fix *-nacl* target objcopy/strip of binary made with custom linker script 2013-11-19 15:05:15 -08:00
elf-nacl.h bfd/ 2013-08-26 19:27:25 +00:00
elf-s390-common.c
elf-strtab.c
elf-vxworks.c
elf-vxworks.h
elf.c Issue a linker error if TLS sections are not adjacent 2014-01-23 08:15:17 -08:00
elfcode.h PR binutils/11983 2014-01-02 12:14:37 +00:00
elfcore.h
elflink.c PR15530, mark symbol in executables if it matches dynamic_list 2014-02-12 22:10:09 +10:30
elfn32-mips.c Default elf_backend_post_process_headers to set OSABI 2013-12-17 13:41:17 -08:00
elfnn-aarch64.c 2014-01-14 Michael Hudson-Doyle <michael.hudson@linaro.org> 2014-01-14 15:53:50 +01:00
elfnn-ia64.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elfxx-aarch64.c * elfxx-aarch64.c (_bfd_aarch64_elf_grok_prstatus): Fix hard-coded 2013-11-11 10:26:41 +00:00
elfxx-aarch64.h
elfxx-ia64.c
elfxx-ia64.h
elfxx-mips.c The PT_DYNAMIC segment was being hard coded to have read, write, and 2014-02-18 16:23:48 -08:00
elfxx-mips.h
elfxx-sparc.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elfxx-sparc.h
elfxx-target.h powerpc relax_section and section contents cache 2014-02-09 23:25:14 +10:30
elfxx-tilegx.c Pass ignored unresolved relocations to ld backend 2013-11-05 10:29:44 -08:00
elfxx-tilegx.h
epoc-pe-arm.c
epoc-pei-arm.c
format.c
freebsd.h
gen-aout.c * gen-aout.c (main): Fix formatting. Close file. 2013-10-14 09:15:09 +00:00
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 PR binutils/11983 2014-01-02 12:14:37 +00:00
ihex.c
init.c
irix-core.c
libaout.h
libbfd-in.h
libbfd.c
libbfd.h Nios II large-GOT relocations 2014-02-03 08:42:42 -08:00
libcoff-in.h * windres.c (define_resource): Use zero for timestamp, making 2013-11-22 14:55:56 +00:00
libcoff.h * windres.c (define_resource): Use zero for timestamp, making 2013-11-22 14:55:56 +00:00
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-i386.c
mach-o-target.c
mach-o-x86-64.c
mach-o.c PR binutils/11983 2014-01-02 12:14:37 +00:00
mach-o.h
MAINTAINERS
Makefile.am Add support for Andes NDS32: 2013-12-13 11:52:32 +00:00
Makefile.in Add support for Andes NDS32: 2013-12-13 11:52:32 +00:00
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 PR binutils/11983 2014-01-02 12:14:37 +00:00
opncls.c PR binutils/11983 2014-01-02 12:14:37 +00:00
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 PR binutils/14289 2014-01-02 14:30:18 +00:00
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 Add epilog unwind for x86_64 pe/coff 2013-12-06 11:54:31 +01:00
peicode.h
peXXigen.c * peXXigen.c (rsrc_process_section): Use ptrdiff_t as the type for 2013-12-30 15:28:41 +00:00
plugin.c
plugin.h
PORTING
ppcboot.c
ptrace-core.c
README
reloc16.c
reloc.c Nios II large-GOT relocations 2014-02-03 08:42:42 -08:00
riscix.c
rs6000-core.c
sco5-core.c
section.c ppc476 icache bug workaround 2014-02-03 20:24:20 +10:30
simple.c PR binutils/16595 2014-02-17 08:32:22 +01:00
som.c
som.h
sparclinux.c
sparclynx.c
sparcnetbsd.c
srec.c
stab-syms.c
stabs.c
stamp-h.in
sunos.c
syms.c * syms.c (_bfd_stab_section_find_nearest_line): Ignore partial 2013-09-24 06:57:36 +00:00
sysdep.h
targets.c Add support for Andes NDS32: 2013-12-13 11:52:32 +00:00
targmatch.sed
tekhex.c
ticoff.h
TODO
trad-core.c
vax1knetbsd.c
vaxbsd.c
vaxnetbsd.c
verilog.c
versados.c
version.h daily update 2014-02-19 09:30:43 +10:30
vms-alpha.c
vms-lib.c PR binutils/11983 2014-01-02 12:14:37 +00:00
vms-misc.c
vms.h
warning.m4
xcofflink.c bfd/ 2013-10-09 18:02:48 +00:00
xsym.c
xsym.h
xtensa-isa.c
xtensa-modules.c

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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 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.