binutils-gdb/ld
Richard Sandiford 34e77a920a include/elf/
* arm.h (R_ARM_IRELATIVE): New relocation.

bfd/
	* reloc.c (BFD_RELOC_ARM_IRELATIVE): New relocation.
	* bfd-in2.h: Regenerate.
	* elf32-arm.c (elf32_arm_howto_table_2): Rename existing definition
	to elf32_arm_howto_table_3 and replace with a single R_ARM_IRELATIVE
	entry.
	(elf32_arm_howto_from_type): Update accordingly.
	(elf32_arm_reloc_map): Map BFD_RELOC_ARM_IRELATIVE to R_ARM_IRELATIVE.
	(elf32_arm_reloc_name_lookup): Handle elf32_arm_howto_table_3.
	(arm_plt_info): New structure, split out from elf32_arm_link_hash_entry
	with an extra noncall_refcount field.
	(arm_local_iplt_info): New structure.
	(elf_arm_obj_tdata): Add local_iplt.
	(elf32_arm_local_iplt): New accessor macro.
	(elf32_arm_link_hash_entry): Replace plt_thumb_refcount,
	plt_maybe_thumb_refcount and plt_got_offset with an arm_plt_info.
	Change tls_type to a bitfield and add is_iplt.
	(elf32_arm_link_hash_newfunc): Update accordingly.
	(elf32_arm_allocate_local_sym_info): New function.
	(elf32_arm_create_local_iplt): Likewise.
	(elf32_arm_get_plt_info): Likewise.
	(elf32_arm_plt_needs_thumb_stub_p): Likewise.
	(elf32_arm_get_local_dynreloc_list): Likewise.
	(create_ifunc_sections): Likewise.
	(elf32_arm_copy_indirect_symbol): Update after the changes to
	elf32_arm_link_hash_entry.  Assert the is_iplt has not yet been set.
	(arm_type_of_stub): Add an st_type argument.  Use elf32_arm_get_plt_info
	to get PLT information.  Assert that all STT_GNU_IFUNC references
	are turned into PLT references.
	(arm_build_one_stub): Pass the symbol type to
	elf32_arm_final_link_relocate.
	(elf32_arm_size_stubs): Pass the symbol type to arm_type_of_stub.
	(elf32_arm_allocate_irelocs): New function.
	(elf32_arm_add_dynreloc): In static objects, use .rel.iplt for
	all R_ARM_IRELATIVE.
	(elf32_arm_allocate_plt_entry): New function.
	(elf32_arm_populate_plt_entry): Likewise.
	(elf32_arm_final_link_relocate): Add an st_type parameter.
	Set srelgot to null for static objects.  Use separate variables
	to record which st_value and st_type should be used when generating
	a dynamic relocation.  Use elf32_arm_get_plt_info to find the
	symbol's PLT information, setting has_iplt_entry, splt,
	plt_offset and gotplt_offset accordingly.  Check whether
	STT_GNU_IFUNC symbols should resolve to an .iplt entry, and change
	the relocation target accordingly.  Broaden assert to include
	.iplts.  Don't set sreloc for static relocations.  Assert that
	we only generate dynamic R_ARM_RELATIVE relocations for R_ARM_ABS32
	and R_ARM_ABS32_NOI.  Generate R_ARM_IRELATIVE relocations instead
	of R_ARM_RELATIVE relocations if the target is an STT_GNU_IFUNC
	symbol.  Pass the symbol type to arm_type_of_stub.  Conditionally
	resolve GOT references to the .igot.plt entry.
	(elf32_arm_relocate_section): Update the call to
	elf32_arm_final_link_relocate.
	(elf32_arm_gc_sweep_hook): Use elf32_arm_get_plt_info to get PLT
	information.  Treat R_ARM_REL32 and R_ARM_REL32_NOI as call
	relocations in shared libraries and relocatable executables.
	Count non-call PLT references.  Use elf32_arm_get_local_dynreloc_list
	to get the list of dynamic relocations for a local symbol.
	(elf32_arm_check_relocs): Always create ifunc sections.  Set isym
	at the same time as setting h.  Use elf32_arm_allocate_local_sym_info
	to allocate local symbol information.  Treat R_ARM_REL32 and
	R_ARM_REL32_NOI as call relocations in shared libraries and
	relocatable executables.  Record PLT information for local
	STT_GNU_IFUNC functions as well as global functions.   Count
	non-call PLT references.  Use elf32_arm_get_local_dynreloc_list
	to get the list of dynamic relocations for a local symbol.
	(elf32_arm_adjust_dynamic_symbol): Handle STT_GNU_IFUNC symbols.
	Don't remove STT_GNU_IFUNC PLTs unless all references have been
	removed.  Update after the changes to elf32_arm_link_hash_entry.
	(allocate_dynrelocs_for_symbol): Decide whether STT_GNU_IFUNC PLT
	entries should live in .plt or .iplt.  Check whether the .igot.plt
	and .got entries can be combined.  Use elf32_arm_allocate_plt_entry
	to allocate .plt and .(i)got.plt entries.  Detect which .got
	entries will need R_ARM_IRELATIVE relocations and use
	elf32_arm_allocate_irelocs to allocate them.  Likewise other
	non-.got dynamic relocations.
	(elf32_arm_size_dynamic_sections): Allocate .iplt, .igot.plt
	and dynamic relocations for local STT_GNU_IFUNC symbols.
	Check whether the .igot.plt and .got entries can be combined.
	Detect which .got entries will need R_ARM_IRELATIVE relocations
	and use elf32_arm_allocate_irelocs to allocate them.  Use stashed
	section pointers intead of strcmp checks.  Handle iplt and igotplt.
	(elf32_arm_finish_dynamic_symbol): Use elf32_arm_populate_plt_entry
	to fill in .plt, .got.plt and .rel(a).plt entries.  Point
	STT_GNU_IFUNC symbols at an .iplt entry if non-call relocations
	resolve to it.
	(elf32_arm_output_plt_map_1): New function, split out from
	elf32_arm_output_plt_map.  Handle .iplt entries.  Use
	elf32_arm_plt_needs_thumb_stub_p.
	(elf32_arm_output_plt_map): Call it.
	(elf32_arm_output_arch_local_syms): Add mapping symbols for
	local .iplt entries.
	(elf32_arm_swap_symbol_in): Handle Thumb STT_GNU_IFUNC symbols.
	(elf32_arm_swap_symbol_out): Likewise.
	(elf32_arm_add_symbol_hook): New function.
	(elf_backend_add_symbol_hook): Define for all targets.

opcodes/
	* arm-dis.c (get_sym_code_type): Treat STT_GNU_IFUNCs as code.

gas/
	* config/tc-arm.c (md_pcrel_from_section): Use S_FORCE_RELOC to
	determine whether a relocation is needed.
	(md_apply_fix, arm_apply_sym_value): Likewise.

ld/testsuite/
	* ld-arm/ifunc-1.s, ld-arm/ifunc-1.dd, ld-arm/ifunc-1.gd,
	ld-arm/ifunc-1.rd, ld-arm/ifunc-2.s, ld-arm/ifunc-2.dd,
	ld-arm/ifunc-2.gd, ld-arm/ifunc-2.rd, ld-arm/ifunc-3.s,
	ld-arm/ifunc-3.dd, ld-arm/ifunc-3.gd, ld-arm/ifunc-3.rd,
	ld-arm/ifunc-4.s, ld-arm/ifunc-4.dd, ld-arm/ifunc-4.gd,
	ld-arm/ifunc-4.rd, ld-arm/ifunc-5.s, ld-arm/ifunc-5.dd,
	ld-arm/ifunc-5.gd, ld-arm/ifunc-5.rd, ld-arm/ifunc-6.s,
	ld-arm/ifunc-6.dd, ld-arm/ifunc-6.gd, ld-arm/ifunc-6.rd,
	ld-arm/ifunc-7.s, ld-arm/ifunc-7.dd, ld-arm/ifunc-7.gd,
	ld-arm/ifunc-7.rd, ld-arm/ifunc-8.s, ld-arm/ifunc-8.dd,
	ld-arm/ifunc-8.gd, ld-arm/ifunc-8.rd, ld-arm/ifunc-9.s,
	ld-arm/ifunc-9.dd, ld-arm/ifunc-9.gd, ld-arm/ifunc-9.rd,
	ld-arm/ifunc-10.s, ld-arm/ifunc-10.dd, ld-arm/ifunc-10.gd,
	ld-arm/ifunc-10.rd, ld-arm/ifunc-11.s, ld-arm/ifunc-11.dd,
	ld-arm/ifunc-11.gd, ld-arm/ifunc-11.rd, ld-arm/ifunc-12.s,
	ld-arm/ifunc-12.dd, ld-arm/ifunc-12.gd, ld-arm/ifunc-12.rd,
	ld-arm/ifunc-13.s, ld-arm/ifunc-13.dd, ld-arm/ifunc-13.gd,
	ld-arm/ifunc-13.rd, ld-arm/ifunc-14.s, ld-arm/ifunc-14.dd,
	ld-arm/ifunc-14.gd, ld-arm/ifunc-14.rd, ld-arm/ifunc-15.s,
	ld-arm/ifunc-15.dd, ld-arm/ifunc-15.gd, ld-arm/ifunc-15.rd,
	ld-arm/ifunc-16.s, ld-arm/ifunc-16.dd, ld-arm/ifunc-16.gd,
	ld-arm/ifunc-16.rd, ld-arm/ifunc-dynamic.ld,
	ld-arm/ifunc-static.ld: New tests.
	* ld-arm/farcall-group.d, ld-arm/farcall-group-size2.d,
	ld-arm/farcall-mixed-lib-v4t.d, ld-arm/farcall-mixed-lib.d: Update
	for new stub hashes.
	* ld-arm/arm-elf.exp: Run them.
2011-03-14 16:04:16 +00:00
..
emulparams PR ld/12376 2011-02-18 18:20:29 +00:00
emultempl include/elf/ 2011-03-14 15:55:04 +00:00
po * po/da.po: Updated Danish translation. 2011-01-10 13:51:10 +00:00
scripttempl remove accidental SANE_EXPR change 2011-02-10 08:35:26 +00:00
testsuite include/elf/ 2011-03-14 16:04:16 +00:00
.gitignore bfd/binutils/gas/gprof/ld/libiberty/opcodes: add .gitignore 2010-12-09 09:03:18 +00:00
ChangeLog include/elf/ 2011-03-14 15:55:04 +00:00
ChangeLog-0001 Split ChangeLog files. 2004-01-02 11:16:21 +00:00
ChangeLog-0203 Restore 2002 ChangeLog history. 2004-04-16 23:56:29 +00:00
ChangeLog-2004 Fix a typo. 2009-01-13 15:49:13 +00:00
ChangeLog-2005 split changelogs 2006-01-16 23:15:07 +00:00
ChangeLog-2006 Move 2006 ChangeLog entries to ChangeLog-2006. 2007-01-09 14:29:31 +00:00
ChangeLog-2007 Move 2007 ChangeLog entries to ChangeLog-2007. 2008-01-02 21:41:02 +00:00
ChangeLog-2008 2009-01-03 Dave Korn <dave.korn.cygwin@gmail.com> 2009-01-03 17:43:45 +00:00
ChangeLog-2009 Move 2009 binutils ChangeLog to ChangeLog-2009. 2010-01-01 18:06:10 +00:00
ChangeLog-2010 Rotate binutils ChangeLogs. 2011-01-01 16:43:53 +00:00
ChangeLog-9197 * ChangeLog-9197: Fix typos. 2003-10-25 16:26:30 +00:00
ChangeLog-9899
MAINTAINERS
Makefile.am Add AC_PROG_CXX. 2011-01-22 19:25:37 +00:00
Makefile.in Add AC_PROG_CXX. 2011-01-22 19:25:37 +00:00
NEWS Add SORT_BY_INIT_PRIORITY. 2010-12-15 14:56:40 +00:00
README
TODO
aclocal.m4 bfd/ 2010-05-07 12:28:50 +00:00
config.in Add SORT_BY_INIT_PRIORITY. 2010-12-15 14:56:40 +00:00
configure Remove freebsd1 from libtool.m4 macros and config.rpath. 2011-02-13 21:00:14 +00:00
configure.host Adjust URLs. 2010-12-21 11:00:48 +00:00
configure.in Add AC_PROG_CXX. 2011-01-22 19:25:37 +00:00
configure.tgt bfd/ 2010-12-31 11:01:00 +00:00
deffile.h 2009-10-23 Kai Tietz <kai.tietz@onevision.com> 2009-10-23 11:40:17 +00:00
deffilep.y 2010-05-25 Kai Tietz <kai.tietz@onevision.com> 2010-05-25 10:05:16 +00:00
dep-in.sed * dep-in.sed: Don't use \n in replacement part of s command. 2009-06-04 06:57:56 +00:00
elf-hints-local.h 2007-08-10 H.J. Lu <hongjiu.lu@intel.com> 2007-08-10 12:25:30 +00:00
fdl.texi etc/ChangeLog 2010-06-08 10:30:56 +00:00
gen-doc.texi Revert my last change since it has not been approved. 2008-07-12 08:54:13 +00:00
genscrba.sh ld: 2008-01-11 09:11:18 +00:00
genscripts.sh Add SORT_BY_INIT_PRIORITY. 2010-12-15 14:56:40 +00:00
h8-doc.texi
ld.h Update copyright dates. 2011-01-13 13:34:54 +00:00
ld.texinfo Report plugin symbols for --verbose=N. 2011-03-04 23:44:01 +00:00
ldcref.c PR ld/11367 2010-03-10 22:44:01 +00:00
ldctor.c PR ld/12356 2011-01-13 13:06:22 +00:00
ldctor.h update copyright dates 2009-09-02 07:25:43 +00:00
ldemul.c Update copyright dates. 2011-01-13 13:34:54 +00:00
ldemul.h update copyright dates 2009-09-02 07:25:43 +00:00
ldexp.c * ldexp.c (fold_binary): Set result section for arithmetic and 2011-01-21 13:18:19 +00:00
ldexp.h PR ld/12356 2011-01-13 13:29:55 +00:00
ldfile.c 2011-02-28 Kai Tietz <kai.tietz@onevision.com> 2011-02-28 18:34:52 +00:00
ldfile.h update copyright dates 2009-09-02 07:25:43 +00:00
ldgram.y PR ld/12356 2011-01-13 13:29:55 +00:00
ldint.texinfo Add directory section for info document. 2010-10-28 11:40:26 +00:00
ldlang.c [PATCH] Fix issue from GCC PR47527: no ELF flags, EABI attribs, etc. in dummy IR BFD. 2011-03-10 10:26:26 +00:00
ldlang.h [PATCH] Revise linker plugin API to better preserve link order. 2011-03-10 10:25:02 +00:00
ldlex-wrapper.c ld/ 2010-02-10 19:48:16 +00:00
ldlex.h update copyright dates 2009-09-02 07:25:43 +00:00
ldlex.l Update copyright dates. 2011-01-13 13:34:54 +00:00
ldmain.c [PATCH] Revise linker plugin API to better preserve link order. 2011-03-10 10:25:02 +00:00
ldmain.h * lexsup.c: Rename --add-needed to --copy-dt-needed-entries. 2009-11-05 15:35:50 +00:00
ldmisc.c 2011-02-28 Kai Tietz <kai.tietz@onevision.com> 2011-02-28 18:34:52 +00:00
ldmisc.h Applied patch series for LD plugin interface (six parts). 2010-10-14 01:31:33 +00:00
ldver.c Update copyright in comments to 2011. 2011-01-01 21:42:17 +00:00
ldver.h update copyright dates 2009-09-02 07:25:43 +00:00
ldwrite.c * ldwrite.c (build_link_order <lang_data_statement_enum>): Don't 2010-10-21 23:28:06 +00:00
ldwrite.h update copyright dates 2009-09-02 07:25:43 +00:00
lexsup.c Report plugin symbols for --verbose=N. 2011-03-04 23:44:01 +00:00
mri.c PR ld/12356 2011-01-13 13:06:22 +00:00
mri.h update copyright dates 2009-09-02 07:25:43 +00:00
pe-dll.c 2011-02-28 Kai Tietz <kai.tietz@onevision.com> 2011-02-28 18:34:52 +00:00
pe-dll.h 2010-04-05 Kai Tietz <kai.tietz@onevision.com> 2010-04-05 09:04:09 +00:00
pep-dll.c 2010-04-05 Kai Tietz <kai.tietz@onevision.com> 2010-04-05 09:04:09 +00:00
pep-dll.h 2010-04-05 Kai Tietz <kai.tietz@onevision.com> 2010-04-05 09:04:09 +00:00
plugin.c [PATCH] Respect symbol wrappers when computing symbol resolutions. 2011-03-10 10:27:50 +00:00
plugin.h Report plugin symbols for --verbose=N. 2011-03-04 23:44:01 +00:00
stamp-h.in
sysdep.h Provide win32-based dlapi replacements on windows platforms without dlfcn.h. 2010-10-15 16:21:41 +00:00
testplug.c Don't use filename_cmp in plugin test DSO. 2011-03-01 22:55:35 +00:00

README

		README for LD

This is the GNU linker.  It is distributed with other "binary
utilities" which should be in ../binutils.  See ../binutils/README for
more general notes, including where to send bug reports.

There are many features of the linker:

* The linker uses a Binary File Descriptor library (../bfd)
  that it uses to read and write object files.  This helps
  insulate the linker itself from the format of object files.

* The linker supports a number of different object file
  formats.  It can even handle multiple formats at once:
  Read two input formats and write a third.

* The linker can be configured for cross-linking.

* The linker supports a control language.

* There is a user manual (ld.texinfo), as well as the
  beginnings of an internals manual (ldint.texinfo).

Installation
============

See ../binutils/README.

If you want to make a cross-linker, you may want to specify
a different search path of -lfoo libraries than the default.
You can do this by setting the LIB_PATH variable in ./Makefile
or using the --with-lib-path configure switch.

To build just the linker, make the target all-ld from the top level
directory (one directory above this one).

Porting to a new target
=======================

See the ldint.texinfo manual.

Reporting bugs etc
===========================

See ../binutils/README.

Known problems
==============

The Solaris linker normally exports all dynamic symbols from an
executable.  The GNU linker does not do this by default.  This is
because the GNU linker tries to present the same interface for all
similar targets (in this case, all native ELF targets).  This does not
matter for normal programs, but it can make a difference for programs
which try to dlopen an executable, such as PERL or Tcl.  You can make
the GNU linker export all dynamic symbols with the -E or
--export-dynamic command line option.

HP/UX 9.01 has a shell bug that causes the linker scripts to be
generated incorrectly.  The symptom of this appears to be "fatal error
- scanner input buffer overflow" error messages.  There are various
workarounds to this:
  * Build and install bash, and build with "make SHELL=bash".
  * Update to a version of HP/UX with a working shell (e.g., 9.05).
  * Replace "(. ${srcdir}/scripttempl/${SCRIPT_NAME}.sc)" in
    genscripts.sh with "sh ${srcdir}..." (no parens) and make sure the
    emulparams script used exports any shell variables it sets.