binutils-gdb/ld
Alan Modra e9ee469ad1 * ld.h (lang_phase_type): Move to..
* ldexp.h: ..here.  Add lang_mark_phase_enum.
	(node_type): Remove etree_undef and etree_unspec.
	(exp_data_seg): Delete.
	(struct ldexp_control, expld): New.
	(invalid, exp_mark_used_section): Delete.
	(exp_fold_tree, exp_get_vma, exp_get_value_int, exp_get_fill,
	exp_get_abs_int): Update prototypes.
	* ldexp.c (assigning_to_dot): Delete.
	(expld): Define.
	(make_abs): Operate directly on expld.result.  Update all callers.
	(new_abs): Likewise.  Return void.
	(new_rel_from_abs): Rename from new_rel_from_section.
	(new_rel, new_rel_from_abs): Operate on expld.result and return void.
	Update all callers.
	(fold_unary): Operate on expld.result and return void.  Remove
	"current_section", "allocation_done", "dot", "dotp" and "mark_used"
	params.  Update all callers.
	(fold_binary, fold_trinary, fold_name, exp_fold_tree_1): Likewise.
	(fold_unary <ALIGN_K>): Ensure alignment is absolute.
	(fold_unary <ABSOLUTE>): Use make_abs.
	(fold_unary <DATA_SEGMENT_END>): Evaluate mark_phase as for
	allocating_phase.
	(fold_binary <DATA_SEGMENT_ALIGN, DATA_SEGMENT_RELRO_END, >): Ditto.
	(fold_binary <'%','/'>): Don't error if marking.
	(fold_name <SIZEOF_HEADERS>): Don't call bfd_sizeof_headers when
	marking.
	(fold_name <NAME>): Remove FIXME; -R is handled correctly.  Don't
	error when marking.
	(fold_name <ADDR, LOADADDR, SIZEOF>): Don't set SEC_KEEP.
	(exp_fold_tree_1): Don't error when marking.
	(exp_fold_tree_1 <etree_rel>): Evaluate in all phases except first.
	(exp_fold_tree_1 <etree_assign to dot>): Don't check for NULL
	current section, instead check for NULL dotp.
	(exp_fold_tree_1 <etree_provide>): Don't evaluate the assignment
	source unless the symbol is referenced and undefined.
	(exp_fold_tree): Remove "allocation_done" and "dot" params.  Save
	params to expld.
	(exp_fold_tree_no_dot): Remove "current_section", "allocation_done
	and "mark_used" params.  Save params to expld.  Update all callers.
	(exp_assop): Do without temp var.
	(exp_print_tree <etree_undef>): Delete code.
	(exp_get_vma): Remove "allocation_done" param.  Correct error return.
	(exp_get_fill, exp_get_abs_int): Likewise.
	(exp_get_value_int): Remove "allocation_done" param.
	(exp_mark_used_section): Delete.
	* ldgram.y (fill_exp): Update exp_get_fill call.
	(origin_spec, length_spec): Update exp_get_vma call.
	* ldlang.c (lang_init): Don't bother clearing lang_statement_iteration.
	(lang_mark_used_section_1, lang_mark_used_section): Delete.
	(strip_excluded_output_sections): Call one_lang_size_sections_pass in
	marking mode.  Merge old lang_mark_used_section code.  Correct handling
	of output sections with excluded input sections and data statements.
	Don't drop non-zero sized sections.  Don't zap os->bfd_section.
	Do set SEC_EXCLUDE when appropriate.
	(print_output_section_statement): Update for changed ldexp.c
	interface.
	(print_assignment, lang_size_sections_1): Likewise.
	(lang_do_assignments_1, lang_enter_output_section_statement): Likewise.
	(lang_new_phdr, lang_record_phdrs): Likewise.
	(lang_size_sections): Likewise.
	(insert_pad): Use following statement if it is a pad, rather than
	creating a new one.
	(lang_size_sections_1 <lang_output_section_statement_enum>): Do
	process ignored output section to set vma and lma, but don't
	update dot for these sections.  Don't error if marking.
	(lang_size_sections_1 <lang_assignment_statement_enum>): Don't
	update dot for ignored sections.
	(lang_size_sections_1 <lang_data_statement_enum>): Don't mark absolute
	section with SEC_ALLOC.
	(one_lang_size_sections_pass): New function.
	(lang_size_sections): Remove first five params.  Set expld.phase on
	entry and exit.   Use one_lang_size_sections_pass.
	(lang_do_assignments): Remove all params.  Update all callers.
	(lang_reset_memory_regions): Clear os->processed for all output
	section statements.
	* ldlang.h (lang_do_assignments): Update prototype.
	(lang_size_sections): Likewise.
	(one_lang_size_sections_pass): Declare.
	* pe-dll.c (pe_dll_fill_sections, pe_exe_fill_sections): Update
	lang_size_sections and lang_do_assignments calls.
	* emultempl/elf32.em (layout_sections_again): Likewise.
	* emultempl/ppc64elf.em (ppc_before_allocation): Use
	one_lang_size_sections_pass.
2005-06-09 02:05:47 +00:00
..
emulparams * emulparams/elf32ms1.sh: New. 2005-06-08 13:03:24 +00:00
emultempl * ld.h (lang_phase_type): Move to.. 2005-06-09 02:05:47 +00:00
po Updated French translation 2005-03-24 21:13:03 +00:00
scripttempl * emulparams/elf64alpha.sh (PLT): New. 2005-05-29 23:16:09 +00:00
testsuite ld/ 2005-06-05 15:28:36 +00:00
acinclude.m4 ./ 2005-05-15 18:19:45 +00:00
aclocal.m4 ./ 2005-05-15 18:19:45 +00:00
ChangeLog * ld.h (lang_phase_type): Move to.. 2005-06-09 02:05:47 +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-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 ./ 2005-05-15 18:19:45 +00:00
configure ./ 2005-05-15 18:19:45 +00:00
configure.host * configure.host (HOSTING_LIBS): Add libunwind.a if it exists. 2005-05-26 22:23:15 +00:00
configure.in ./ 2005-05-15 18:19:45 +00:00
configure.tgt * configure.tgt: Same. 2005-06-07 21:12:16 +00:00
deffile.h Update FSF addresses 2005-05-12 07:32:09 +00:00
deffilep.y Update FSF addresses 2005-05-12 07:32:09 +00:00
dep-in.sed * dep-in.sed: Remove libintl.h. 2003-08-14 07:04:57 +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 * ld.h (lang_phase_type): Move to.. 2005-06-09 02:05:47 +00:00
ld.texinfo * ldlang.c (Scan_for_self_assignment): Check an assignment tree to 2005-05-17 14:35:21 +00:00
ldcref.c Update FSF addresses 2005-05-12 07:32:09 +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 Update FSF addresses 2005-05-12 07:32:09 +00:00
ldemul.h update copyright dates 2005-03-03 11:52:12 +00:00
ldexp.c * ld.h (lang_phase_type): Move to.. 2005-06-09 02:05:47 +00:00
ldexp.h * ld.h (lang_phase_type): Move to.. 2005-06-09 02:05:47 +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.h (lang_phase_type): Move to.. 2005-06-09 02:05:47 +00:00
ldint.texinfo Update FSF addresses 2005-05-12 07:32:09 +00:00
ldlang.c * ld.h (lang_phase_type): Move to.. 2005-06-09 02:05:47 +00:00
ldlang.h * ld.h (lang_phase_type): Move to.. 2005-06-09 02:05:47 +00:00
ldlex.h Update FSF addresses 2005-05-12 07:32:09 +00:00
ldlex.l Update FSF addresses 2005-05-12 07:32:09 +00:00
ldmain.c include/ 2005-06-03 09:52:50 +00:00
ldmain.h Update FSF addresses 2005-05-12 07:32:09 +00:00
ldmisc.c include/ 2005-06-03 09:52:50 +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 Update FSF addresses 2005-05-12 07:32:09 +00:00
ldwrite.h Update FSF addresses 2005-05-12 07:32:09 +00:00
lexsup.c Update FSF addresses 2005-05-12 07:32:09 +00:00
MAINTAINERS add MAINTAINERS files 2000-07-05 19:28:06 +00:00
Makefile.am 2005-06-07 Eric Christopher <echristo@redhat.com> 2005-06-07 23:56:50 +00:00
Makefile.in 2005-06-07 Eric Christopher <echristo@redhat.com> 2005-06-07 23:56:50 +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 cutoff for changes in 2.16 release 2005-03-15 17:49:15 +00:00
pe-dll.c * ld.h (lang_phase_type): Move to.. 2005-06-09 02:05:47 +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 Update FSF addresses 2005-05-12 07:32:09 +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.