old-cross-binutils/ld
Richard Sandiford 00a976722a bfd/
* configure.in (bfd_elf32_bigarm_vec): Include elf-vxworks.lo.
	(bfd_elf32_bigarm_symbian_vec): Likewise.
	(bfd_elf32_bigarm_vxworks_vec): Likewise.
	(bfd_elf32_littlearm_vec): Likewise.
	(bfd_elf32_littlearm_symbian_vec): Likewise.
	(bfd_elf32_littlearm_vxworks_vec): Likewise.
	* configure: Regenerate.
	* elf32-arm.c: Include libiberty.h and elf-vxworks.h.
	(RELOC_SECTION, RELOC_SIZE, SWAP_RELOC_IN, SWAP_RELOC_OUT): New macros.
	(elf32_arm_vxworks_bed): Add forward declaration.
	(elf32_arm_howto_table_1): Fix the masks for R_ASM_ABS12.
	(elf32_arm_vxworks_exec_plt0_entry): New table.
	(elf32_arm_vxworks_exec_plt_entry): Likewise.
	(elf32_arm_vxworks_shared_plt_entry): Likewise.
	(elf32_arm_link_hash_table): Add vxworks_p and srelplt2 fields.
	(reloc_section_p): New function.
	(create_got_section): Use RELOC_SECTION.
	(elf32_arm_create_dynamic_sections): Likewise.  Call
	elf_vxworks_create_dynamic_sections for VxWorks targets.
	Choose between the two possible values of plt_header_size
	and plt_entry_size.
	(elf32_arm_link_hash_table_create): Initialize vxworks_p and srelplt2.
	(elf32_arm_abs12_reloc): New function.
	(elf32_arm_final_link_relocate): Call it.  Allow the creation of
	dynamic R_ARM_ABS12 relocs on VxWorks.  Use reloc_section_p,
	RELOC_SIZE, SWAP_RELOC_OUT and RELOC_SECTION.  Initialize the
	r_addend fields of relocs.  On rela targets, skip any code that
	adjusts in-place addends.  When using _bfd_link_final_relocate
	to perform a final relocation, pass rel->r_addend as the addend
	argument.
	(elf32_arm_merge_private_bfd_data): If one of the bfds is a VxWorks
	object, ignore flags that are not standard on VxWorks.
	(elf32_arm_check_relocs): Allow the creation of dynamic R_ARM_ABS12
	relocs on VxWorks.  Use reloc_section_p.
	(elf32_arm_adjust_dynamic_symbol): Use RELOC_SECTION and RELOC_SIZE.
	(allocate_dynrelocs): Use RELOC_SIZE.  Account for the size of
	.rela.plt.unloaded relocs on VxWorks targets.
	(elf32_arm_size_dynamic_sections): Use RELOC_SIZE.  Check for
	.rela.plt.unloaded as well as .rel(a).plt.  Add DT_RELA* tags
	instead of DT_REL* tags on RELA targets.
	(elf32_arm_finish_dynamic_symbol): Use RELOC_SECTION, RELOC_SIZE
	and SWAP_RELOC_OUT.  Initialize r_addend fields.  Handle VxWorks
	PLT entries.  Do not make _GLOBAL_OFFSET_TABLE_ absolute on VxWorks.
	(elf32_arm_finish_dynamic_sections): Use RELOC_SECTION, RELOC_SIZE
	and SWAP_RELOC_OUT.  Initialize r_addend fields.  Handle DT_RELASZ
	like DT_RELSZ.  Handle the VxWorks form of initial PLT entry.
	Correct the .rela.plt.unreloaded symbol indexes.
	(elf32_arm_output_symbol_hook): Call the VxWorks version of this
	hook on VxWorks targets.
	(elf32_arm_vxworks_link_hash_table_create): Set vxworks_p to true.
	Minor formatting tweak.
	(elf32_arm_vxworks_final_write_processing): New function.
	(elf_backend_add_symbol_hook): Override for VxWorks and reset
	for Symbian.
	(elf_backend_final_write_processing): Likewise.
	(elf_backend_emit_relocs): Likewise.
	(elf_backend_want_plt_sym): Likewise.
	(ELF_MAXPAGESIZE): Likewise.
	(elf_backend_may_use_rel_p): Minor formatting tweak.
	(elf_backend_may_use_rela_p): Likewise.
	(elf_backend_default_use_rela_p): Likewise.
	(elf_backend_rela_normal): Likewise.
	* Makefile.in (elf32-arm.lo): Depend on elf-vxworks.h.

gas/
	* config/tc-arm.c (md_apply_fix): Install a value of zero into a
	BFD_RELOC_ARM_OFFSET_IMM field if we're going to generate a RELA
	R_ARM_ABS12 reloc.
	(tc_gen_reloc): Keep the original fx_offset for RELA pc-relative
	relocs, but adjust by md_pcrel_from_section.  Create R_ARM_ABS12
	relocations for BFD_RELOC_ARM_OFFSET_IMM on RELA targets.

gas/testsuite/
	* gas/arm/abs12.s, gas/arm/abs12.d: New test.
	* gas/arm/pic.d: Skip for *-*-vxworks*...
	* gas/arm/pic_vxworks.d: ...use this version instead.
	* gas/arm/unwind_vxworks.d: Fix expected output.

ld/
	* emulparams/armelf_vxworks.sh: Include vxworks.sh.
	(MAXPAGESIZE): Define.
	* emulparams/vxworks.sh: Undefine.
	* Makefile.am (earmelf_vxworks.c): Depend on vxworks.sh and vxworks.em.
	* Makefile.in: Regenerate.

ld/testsuite/
	* ld-arm/vxworks1.dd, ld-arm/vxworks1.ld, ld-arm/vxworks1-lib.dd,
	* ld-arm/vxworks1-lib.nd, ld-arm/vxworks1-lib.rd,
	* ld-arm/vxworks1-lib.s, ld-arm/vxworks1.rd, ld-arm/vxworks1.s,
	* ld-arm/vxworks1-static.d, ld-arm/vxworks2.s, ld-arm/vxworks2.sd,
	* ld-arm/vxworks2-static.sd: New tests.
	* ld-arm/arm-elf.exp: Run them.
2006-03-07 08:39:21 +00:00
..
emulparams bfd/ 2006-03-07 08:39:21 +00:00
emultempl ld/ 2006-03-03 09:32:01 +00:00
po bfd/doc/ 2006-02-27 16:26:26 +00:00
scripttempl Add linker relaxation support for the AVR 2006-03-03 15:25:31 +00:00
testsuite bfd/ 2006-03-07 08:39:21 +00:00
acinclude.m4 ./ 2005-05-15 18:19:45 +00:00
aclocal.m4 2005-09-30 H.J. Lu <hongjiu.lu@intel.com> 2005-09-30 18:59:46 +00:00
ChangeLog bfd/ 2006-03-07 08:39:21 +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 split changelogs 2006-01-16 23:15:07 +00:00
ChangeLog-2005 split changelogs 2006-01-16 23:15:07 +00:00
ChangeLog-9197 * ChangeLog-9197: Fix typos. 2003-10-25 16:26:30 +00:00
ChangeLog-9899 Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
config.in configure clean up patch from Steve Ellcey. 2005-06-09 18:39:34 +00:00
configure Add new Chinese (simplified) translation 2006-01-16 16:15:17 +00:00
configure.host 2005-07-19 Paul Brook <paul@codesourcery.com> 2005-07-19 12:43:19 +00:00
configure.in Add new Chinese (simplified) translation 2006-01-16 16:15:17 +00:00
configure.tgt Add support for the Infineon XC16X. 2006-02-17 14:36:28 +00:00
deffile.h 2006-01-31 Filip Navara <navaraf@reactos.com> 2006-01-31 22:08:14 +00:00
deffilep.y * deffilep.y (def_image_name): If the image name does not have 2006-02-01 21:28:29 +00:00
dep-in.sed ld/ 2005-10-30 17:40:28 +00:00
fdl.texi Update FSF addresses 2005-05-12 07:32:09 +00:00
gen-doc.texi Add Xtensa port 2003-04-01 15:50:31 +00:00
genscripts.sh 2004-10-21 H.J. Lu <hongjiu.lu@intel.com> 2004-10-21 15:20:35 +00:00
h8-doc.texi Replace occurrances of 'Hitachi' with 'Renesas'. 2003-04-15 08:51:55 +00:00
ld.h asintl.h/bucomm.h/ld.h: Prevent the inclusion of <libintl.h> from the Solaris 2005-09-30 11:42:05 +00:00
ld.texinfo ld/ 2006-03-03 09:32:01 +00:00
ldcref.c 2005-10-05 H.J. Lu <hongjiu.lu@intel.com> 2005-10-05 16:12:17 +00:00
ldctor.c Update FSF addresses 2005-05-12 07:32:09 +00:00
ldctor.h Update FSF addresses 2005-05-12 07:32:09 +00:00
ldemul.c * ldlang.h (lang_input_section_type): Remove "ifile" field. 2005-11-17 00:10:05 +00:00
ldemul.h * ldlang.h (lang_input_section_type): Remove "ifile" field. 2005-11-17 00:10:05 +00:00
ldexp.c bfd/ 2005-12-07 14:43:54 +00:00
ldexp.h bfd/ 2005-08-05 13:52:13 +00:00
ldfile.c Update FSF addresses 2005-05-12 07:32:09 +00:00
ldfile.h Update FSF addresses 2005-05-12 07:32:09 +00:00
ldgram.y * ld.texino: Describe double-quoted string syntax for version 2005-10-13 17:29:57 +00:00
ldint.texinfo Update FSF addresses 2005-05-12 07:32:09 +00:00
ldlang.c * ldlang.h (lang_output_section_statement_type): Add prev. 2005-12-24 07:48:30 +00:00
ldlang.h * ldlang.h (lang_output_section_statement_type): Add prev. 2005-12-24 07:48:30 +00:00
ldlex.h Update FSF addresses 2005-05-12 07:32:09 +00:00
ldlex.l bfd/ 2005-08-05 13:52:13 +00:00
ldmain.c * ldmain.c (main): Add \n to error message. 2005-11-06 23:12:36 +00:00
ldmain.h Update FSF addresses 2005-05-12 07:32:09 +00:00
ldmisc.c * ldlang.c (lang_size_sections_1): Revert 2005-11-16 functional 2005-11-18 04:12:27 +00:00
ldmisc.h Update FSF addresses 2005-05-12 07:32:09 +00:00
ldver.c Update FSF addresses 2005-05-12 07:32:09 +00:00
ldver.h Update FSF addresses 2005-05-12 07:32:09 +00:00
ldwrite.c * ldlang.h (lang_input_section_type): Remove "ifile" field. 2005-11-17 00:10:05 +00:00
ldwrite.h Update FSF addresses 2005-05-12 07:32:09 +00:00
lexsup.c * as.c (show_usage): Document "@FILE". 2005-10-30 18:08:52 +00:00
MAINTAINERS add MAINTAINERS files 2000-07-05 19:28:06 +00:00
Makefile.am bfd/ 2006-03-07 08:39:21 +00:00
Makefile.in bfd/ 2006-03-07 08:39:21 +00:00
mri.c Update FSF addresses 2005-05-12 07:32:09 +00:00
mri.h Update FSF addresses 2005-05-12 07:32:09 +00:00
NEWS Add support for the Infineon XC16X. 2006-02-17 14:36:28 +00:00
pe-dll.c 2006-01-31 Filip Navara <navaraf@reactos.com> 2006-01-31 22:08:14 +00:00
pe-dll.h Update FSF addresses 2005-05-12 07:32:09 +00:00
README Add --with-lib-patch configure switch. 2002-08-23 08:03:32 +00:00
stamp-h.in 19990502 sourceware import 1999-05-03 07:29:11 +00:00
sysdep.h configure clean up patch from Steve Ellcey. 2005-06-09 18:39:34 +00:00
TODO 19990502 sourceware import 1999-05-03 07:29:11 +00:00

		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.