binutils-gdb/ld
Jakub Jelinek db6751f2e7 * elf-bfd.h (enum elf_reloc_type_class): New.
(struct elf_backend_data): Add elf_backend_reloc_type_class.
	(_bfd_elf_reloc_type_class): New.
	* elfxx-target.h (elf_backend_reloc_type_class): Define.
	(elfNN_bed): Add elf_backend_reloc_type_class.
	* elf.c (_bfd_elf_reloc_type_class): New.
	* elf32-i386.c (elf_i386_check_relocs): Set DF_TEXTREL if the reloc
	is against read-only section.
	(elf_i386_size_dynamic_sections): Use DF_TEXTREL flag instead of
	looking up section names for DT_TEXTREL.
	(elf_i386_reloc_type_class): New.
	(elf_backend_reloc_type_class): Define.
	* elf32-sparc.c (elf32_sparc_check_relocs): Set DF_TEXTREL if the
	reloc is against read-only section.
	(elf32_sparc_size_dynamic_sections): Use DF_TEXTREL flag instead of
	looking up section names for DT_TEXTREL.
	(elf32_sparc_reloc_type_class): New.
	(elf_backend_reloc_type_class): Define.
	* elf64-sparc.c (sparc64_elf_check_relocs): Set DF_TEXTREL if the
	reloc is against read-only section.
	(sparc64_elf_size_dynamic_sections): Use DF_TEXTREL flag instead of
	looking up section names for DT_TEXTREL.
	(sparc64_elf_reloc_type_class): New.
	(elf_backend_reloc_type_class): Define.
	* elfxx-ia64.c (struct elfNN_ia64_link_hash_table): Add reltext field.
	(elfNN_ia64_hash_table_create): Clear ia64_info.
	(get_reloc_section): Set DF_TEXTREL if the reloc is against read-only
	section.
	(elfNN_ia64_size_dynamic_sections): Use ia64_info->reltext flag
	instead of looking up section names for DT_TEXTREL.
	(elfNN_ia64_reloc_type_class): New.
	(elf_backend_reloc_type_class): Define.
	* elflink.h (size_dynamic_sections): Add spare DT_NULL tags.
	(struct elf_link_sort_rela): New.
	(elf_link_sort_cmp1, elf_link_sort_cmp2, elf_link_sort_relocs): New.
	(elf_bfd_final_link): Call elf_link_sort_relocs.
	Convert one spare DT_NULL into DT_RELCOUNT resp. DT_RELACOUNT if
	necessary.

	* bfdlink.h (struct bfd_link_info): Add combreloc and
	spare_dynamic_tags fields.

	* emultempl/elf32.em (place_orphan): Place orphan .rel* sections
	into .rel.dyn resp. .rela.dyn if combreloc.
	(get_script): If .x linker script is equal to .xn, only put it
	once into the binary.
	Add .xc and .xsc scripts.
	(parse_args): Handle -z combreloc and -z nocombreloc.
	* scripttempl/elf.sc (.rela.sbss): Fix a typo.
	For .xc and .xsc scripts put all .rel* or .rela* input sections
	but .rel*.plt and PLT-like sections into .rel.dyn resp. .rela.dyn.
	* genscripts.sh (GENERATE_COMBRELOC_SCRIPT): Set if SCRIPT_NAME
	is elf.
	Strip trailing whitespace from script.
	Generate .xc and .xsc scripts if requested.
	* ldmain.c (main): Initialize link_info.combreloc and
	link_info.spare_dynamic_tags.
	* lexsup.c (OPTION_SPARE_DYNAMIC_TAGS): Define.
	(ld_options): Add --spare-dynamic-tags option.
	(parse_args): Likewise.
	* ld.texinfo: Document -z combreloc and -z nocombreloc.
	* ldint.texinfo: Document .xc and .xsc linker scripts.
	* NEWS: Add notes about -z combreloc and SHF_MERGE.
2001-08-23 15:14:18 +00:00
..
emulparams 2001-08-22 H.J. Lu <hjl@gnu.org> 2001-08-22 16:00:25 +00:00
emultempl * elf-bfd.h (enum elf_reloc_type_class): New. 2001-08-23 15:14:18 +00:00
po Add support for arm-vxworks target 2001-04-27 17:12:18 +00:00
scripttempl * elf-bfd.h (enum elf_reloc_type_class): New. 2001-08-23 15:14:18 +00:00
testsuite Return if target is `vax-*-ultrix*'. 2001-08-21 16:04:37 +00:00
ChangeLog * elf-bfd.h (enum elf_reloc_type_class): New. 2001-08-23 15:14:18 +00:00
ChangeLog-9197 Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +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 * emultempl/needrelax.em: New file. 2001-08-13 20:40:31 +00:00
Makefile.in * emultempl/needrelax.em: New file. 2001-08-13 20:40:31 +00:00
NEWS * elf-bfd.h (enum elf_reloc_type_class): New. 2001-08-23 15:14:18 +00:00
README Change bug reporting email address. 2001-07-19 10:43:13 +00:00
TODO 19990502 sourceware import 1999-05-03 07:29:11 +00:00
acinclude.m4 * acinclude.m4: Include libtool and gettext macros from the 2000-08-31 09:46:11 +00:00
aclocal.m4 Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
config.in Add support for arm-vxworks target 2001-04-27 17:12:18 +00:00
configure * configure.in: Add -Wstrict-prototypes and -Wmissing-prototypes 2001-08-10 10:56:47 +00:00
configure.host * configure.host: Set HOSTING_CRT0/HOSTING_LIBS correctly for s/390. 2001-06-06 12:11:23 +00:00
configure.in * configure.in: Add -Wstrict-prototypes and -Wmissing-prototypes 2001-08-10 10:56:47 +00:00
configure.tgt * configure.tgt (i386-*-netbsdelf*): New target. 2001-07-14 14:45:42 +00:00
deffile.h Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
deffilep.y * deffilep.y: Add missing prototypes. 2001-08-21 11:42:57 +00:00
dep-in.sed Match space at start of file name, not end. 2000-04-20 02:13:01 +00:00
gen-doc.texi tic54x/ibmc54xdsp target for ld. 2000-06-20 13:29:07 +00:00
genscripts.sh * elf-bfd.h (enum elf_reloc_type_class): New. 2001-08-23 15:14:18 +00:00
h8-doc.texi 19990502 sourceware import 1999-05-03 07:29:11 +00:00
ld.h Make --verbose always display linker script 2001-08-12 07:59:28 +00:00
ld.texinfo * elf-bfd.h (enum elf_reloc_type_class): New. 2001-08-23 15:14:18 +00:00
ldcref.c * ldcref.c (check_section_sym_xref): New function. 2001-07-23 07:54:04 +00:00
ldctor.c Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
ldctor.h Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
ldemul.c Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
ldemul.h Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
ldexp.c Use stderr if config.map_file is not available. Do not print NULL trees. 2001-07-19 16:41:00 +00:00
ldexp.h Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
ldfile.c Make --verbose always display linker script 2001-08-12 07:59:28 +00:00
ldfile.h Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
ldgram.y Fix for ld 2001-08-15 17:10:18 +00:00
ldint.texinfo * elf-bfd.h (enum elf_reloc_type_class): New. 2001-08-23 15:14:18 +00:00
ldlang.c * ldlang.c (insert_pad): Fix typos in last patch. 2001-08-20 03:09:07 +00:00
ldlang.h * ldlang.c: When traversing lang_statement_union_type lists, 2001-08-20 02:14:50 +00:00
ldlex.h Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
ldlex.l 2001-05-02 H.J. Lu <hjl@gnu.org> 2001-05-02 16:42:55 +00:00
ldmain.c * elf-bfd.h (enum elf_reloc_type_class): New. 2001-08-23 15:14:18 +00:00
ldmain.h Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
ldmisc.c 2001-05-02 H.J. Lu <hjl@gnu.org> 2001-05-02 16:42:55 +00:00
ldmisc.h 2001-05-02 H.J. Lu <hjl@gnu.org> 2001-05-02 16:42:55 +00:00
ldver.c Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
ldver.h Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
ldwrite.c Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
ldwrite.h 19990502 sourceware import 1999-05-03 07:29:11 +00:00
lexsup.c * elf-bfd.h (enum elf_reloc_type_class): New. 2001-08-23 15:14:18 +00:00
mac-ld.r 19990502 sourceware import 1999-05-03 07:29:11 +00:00
mpw-config.in 19990502 sourceware import 1999-05-03 07:29:11 +00:00
mpw-elfmips.c (wild_doit): Rename to lang_add_section. 2001-08-14 02:01:31 +00:00
mpw-eppcmac.c * ldlang.c: When traversing lang_statement_union_type lists, 2001-08-20 02:14:50 +00:00
mpw-esh.c Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
mpw-idtmips.c Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
mpw-make.sed 19990502 sourceware import 1999-05-03 07:29:11 +00:00
mri.c * ld.texinfo (Input Section Basics): Clarify ordering of output 2001-08-03 01:11:21 +00:00
mri.h Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +00:00
pe-dll.c * deffilep.y: Add missing prototypes. 2001-08-21 11:42:57 +00:00
pe-dll.h 2001-08-02 Charles Wilson <cwilson@ece.gatech.edu> 2001-08-02 23:12:02 +00:00
stamp-h.in 19990502 sourceware import 1999-05-03 07:29:11 +00:00
sysdep.h Fixtypos in ChangeLogs, fix copyright dates in files 2001-03-13 06:14:29 +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.

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.