binutils-gdb/ld
Nick Clifton 906e58cab5 bfd/
* elf32-arm.c (THM2_MAX_FWD_BRANCH_OFFSET): Define.
        (THM2_MAX_BWD_BRANCH_OFFSET): Define.
        (ARM_MAX_FWD_BRANCH_OFFSET): Define.
        (ARM_MAX_BWD_BRANCH_OFFSET): Define.
        (THM_MAX_FWD_BRANCH_OFFSET): Define.
        (THM_MAX_BWD_BRANCH_OFFSET): Define.
        (arm_long_branch_stub): Define.
        (arm_pic_long_branch_stub): Define.
        (arm_thumb_v4t_long_branch_stub): Define.
        (arm_thumb_thumb_long_branch_stub): Define.
        (arm_thumb_arm_v4t_long_branch_stub): Define.
        (STUB_SUFFIX): Define.
        (elf32_arm_stub_type): Define.
        (elf32_arm_stub_hash_entry): Define.
        (elf32_arm_link_hash_entry): Add stub_cache field.
        (arm_stub_hash_lookup): Define.
        (elf32_arm_link_hash_table): Add stub_hash_table, stub_bfd,
        add_stub_section, layout_sections_again, stub_group, bfd_count,
        top_index, input_list fields.
        (elf32_arm_link_hash_newfunc): Init new field.
        (stub_hash_newfunc): New function.
        (elf32_arm_link_hash_table_create): Init stub_hash_table.
        (elf32_arm_hash_table_free): New function.
        (arm_type_of_stub): New function.
        (elf32_arm_stub_name): New function.
        (elf32_arm_get_stub_entry): New function.
        (elf32_arm_stub_add_mapping_symbol): New function.
        (elf32_arm_add_stub): New function.
        (arm_build_one_stub): New function.
        (arm_size_one_stub): New function.
        (elf32_arm_setup_section_lists): New function.
        (elf32_arm_next_input_section): New function.
        (group_sections): New function.
        (elf32_arm_size_stubs): New function.
        (elf32_arm_build_stubs): New function.
        (bfd_elf32_arm_add_glue_sections_to_bfd): Skip stub sections.
        (bfd_elf32_arm_process_before_allocation): No longer handle
        R_ARM_CALL and R_ARM_THM_CALL.
        (using_thumb_only): New function.
        (elf32_arm_final_link_relocate): Redirect calls to stub if range
        exceeds encoding capabilities.
        (bfd_elf32_bfd_link_hash_table_free): Define.
        * bfd-in.h (R_ARM_max): Fix value to 130.
        (elf32_arm_setup_section_lists): Protype.
        (elf32_arm_next_input_section): Protype.
        (elf32_arm_size_stubs): Protype.
        (elf32_arm_build_stubs): Protype.

        ld/
        * emultempl/armelf.em (build_section_lists): New function.
        (stub_file): Define.
        (need_laying_out): Define.
        (group_size): Define.
        (hook_stub_info): Define.
        (hook_in_stub): New function.
        (elf32_arm_add_stub_section): New function.
        (gldarm_layout_sections_again): New function.
        (gld${EMULATION_NAME}_finish): Replace arm_elf_finish(). Generate
        stubs for long calls if needed.
        (arm_elf_create_output_section_statements): create stub_file bfd.
        (arm_for_each_input_file_wrapper): New function.
        (arm_lang_for_each_input_file): New function.
        (lang_for_each_input_file): Define.
        (PARSE_AND_LIST_PROLOGUE): Add option token OPTION_STUBGROUP_SIZE.
        (PARSE_AND_LIST_LONGOPTS): Add option stub-group-size.
        (PARSE_AND_LIST_OPTIONS): Add option stub-group-size.
        (PARSE_AND_LIST_ARGS_CASES): Add OPTION_STUBGROUP_SIZE case.
        (LDEMUL_FINISH): Update to gld${EMULATION_NAME}_finish.
        * ld/lang.c (print_input_statement): Skip if bfd has
        BFD_LINKER_CREATED.

        ld/testsuite
        * ld-arm/arm-elf.exp (armelftests): Add farcall-arm-arm,
        farcall-arm-arm-pic-veneer, farcall-arm-arm-be8 farcall-arm-thumb,
        farcall-arm-thumb-blx, farcall-arm-thumb-pic-veneer,
        farcall-arm-thumb-blx-pic-veneer, farcall-thumb-thumb,
        farcall-thumb-thumb-pic-veneer, farcall-thumb-thumb-blx,
        farcall-thumb-thumb-m, farcall-thumb-thumb-m-pic-veneer,
        farcall-thumb-thumb-blx-pic-veneer, farcall-thumb-arm,
        farcall-thumb-arm-pic-veneer, farcall-thumb-arm-blx,
        farcall-thumb-arm-blx-pic-veneer.
        Change thumb2-bl-as-thumb1-bad, thumb2-bl-bad.
        * ld-arm/thumb2-bl-as-thumb1-bad.d: Reflects farcall stub
        generation.
        * ld-arm/thumb2-bl-bad.d: Likewise.
        * ld-arm/thumb2-bl-as-thumb1-bad.s: Update comments.
        * ld-arm/thumb2-bl-bad.s: Likewise.
2008-05-15 17:00:15 +00:00
..
emulparams bfd/ 2008-05-07 14:46:44 +00:00
emultempl bfd/ 2008-05-15 17:00:15 +00:00
po * po/POTFILES.in: Regenerate. 2008-04-08 06:12:32 +00:00
scripttempl [patch]: ctor/dtor section must start at alignment of 8 for x86_64-pc-mingw32. 2008-04-18 09:06:22 +00:00
testsuite bfd/ 2008-05-15 17:00:15 +00:00
ChangeLog bfd/ 2008-05-15 17:00:15 +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-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-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
MAINTAINERS add MAINTAINERS files 2000-07-05 19:28:06 +00:00
Makefile.am The sha1 code is now in libiberty. 2008-03-25 04:54:03 +00:00
Makefile.in update dependencies 2008-05-14 06:45:42 +00:00
NEWS Add a marker for the 2.18 features. 2007-08-10 13:21:40 +00:00
README Add --with-lib-patch configure switch. 2002-08-23 08:03:32 +00:00
TODO 19990502 sourceware import 1999-05-03 07:29:11 +00:00
aclocal.m4 bfd/ 2008-04-23 16:11:47 +00:00
config.in * Makefile.am (INCLUDES): Remove -D_GNU_SOURCE. 2007-10-24 04:56:48 +00:00
configure bfd/ 2008-04-23 16:11:47 +00:00
configure.host Add support for i386-dragonfly target. 2007-08-28 11:02:55 +00:00
configure.in gas/ 2007-10-24 16:45:53 +00:00
configure.tgt 2008-04-25 Michael Frysinger <vapier@gentoo.org> 2008-04-26 01:10:55 +00:00
deffile.h Update sources to GPLv3 2007-07-06 14:09:45 +00:00
deffilep.y Update sources to GPLv3 2007-07-06 14:09:45 +00:00
dep-in.sed ld/ 2005-10-30 17:40:28 +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 Update FSF addresses 2005-05-12 07:32:09 +00:00
gen-doc.texi bfd/ 2007-04-30 14:06:40 +00:00
genscrba.sh ld: 2008-01-11 09:11:18 +00:00
genscripts.sh PR ld/5652 2008-01-28 11:07:44 +00:00
h8-doc.texi Replace occurrances of 'Hitachi' with 'Renesas'. 2003-04-15 08:51:55 +00:00
ld.h Update sources to GPLv3 2007-07-06 14:09:45 +00:00
ld.texinfo * ld.texinfo (PowerPC64 ELF64): Fix typo. 2008-05-08 17:34:36 +00:00
ldcref.c include/ 2008-02-15 03:35:53 +00:00
ldctor.c include/ 2008-02-15 03:35:53 +00:00
ldctor.h Update sources to GPLv3 2007-07-06 14:09:45 +00:00
ldemul.c include/ 2008-02-15 03:35:53 +00:00
ldemul.h Update sources to GPLv3 2007-07-06 14:09:45 +00:00
ldexp.c * ldexp.c (exp_print_token): Add ABSOLUTE, MIN_K, ASSERT_K. Correct 2008-05-07 14:30:41 +00:00
ldexp.h bfd/ 2007-09-18 00:25:07 +00:00
ldfile.c include/ 2008-02-15 03:35:53 +00:00
ldfile.h Update sources to GPLv3 2007-07-06 14:09:45 +00:00
ldgram.y ld/ 2008-01-25 12:03:37 +00:00
ldint.texinfo PR linker/4844 2007-10-01 09:54:58 +00:00
ldlang.c bfd/ 2008-05-15 17:00:15 +00:00
ldlang.h ld/ 2008-01-25 12:03:37 +00:00
ldlex.h Update sources to GPLv3 2007-07-06 14:09:45 +00:00
ldlex.l ld/ 2008-01-25 12:03:37 +00:00
ldmain.c include/ 2008-02-15 03:35:53 +00:00
ldmain.h include/ 2008-02-15 03:35:53 +00:00
ldmisc.c include/ 2008-02-15 03:35:53 +00:00
ldmisc.h Update sources to GPLv3 2007-07-06 14:09:45 +00:00
ldver.c Update sources to GPLv3 2007-07-06 14:09:45 +00:00
ldver.h Update sources to GPLv3 2007-07-06 14:09:45 +00:00
ldwrite.c include/ 2008-02-15 03:35:53 +00:00
ldwrite.h Update sources to GPLv3 2007-07-06 14:09:45 +00:00
lexsup.c ld/ 2008-01-25 12:03:37 +00:00
mri.c Update sources to GPLv3 2007-07-06 14:09:45 +00:00
mri.h Update sources to GPLv3 2007-07-06 14:09:45 +00:00
pe-dll.c 2008-05-09 Kai Tietz <kai.tietz@onevision.com> 2008-05-09 11:56:31 +00:00
pe-dll.h Update sources to GPLv3 2007-07-06 14:09:45 +00:00
pep-dll.c Update sources to GPLv3 2007-07-06 14:09:45 +00:00
pep-dll.h Update sources to GPLv3 2007-07-06 14:09:45 +00:00
stamp-h.in 19990502 sourceware import 1999-05-03 07:29:11 +00:00
sysdep.h Update sources to GPLv3 2007-07-06 14:09:45 +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.