binutils-gdb/ld
Bob Wilson 74869ac7a4 bfd/
* elf32-xtensa.c (xtensa_get_property_section_name): Delete.
	(xtensa_get_property_section): New.
	(xtensa_read_table_entries): Use xtensa_get_property_section.
	(relax_property_section, xtensa_get_property_predef_flags): Handle
	group name suffixes in property section names.
	(match_section_group): New.
gas/
	* config/tc-xtensa.c (FINI_LITERAL_SECTION_NAME): Delete.
	(INIT_LITERAL_SECTION_NAME): Delete.
	(lit_state struct): Remove segment names, init_lit_seg, and
	fini_lit_seg.  Add lit_prefix and current_text_seg.
	(init_literal_head_h, init_literal_head): Delete.
	(fini_literal_head_h, fini_literal_head): Delete.
	(xtensa_begin_directive): Move argument parsing to
	xtensa_literal_prefix function.
	(xtensa_end_directive): Deallocate lit_prefix field of lit_state.
	(xtensa_literal_prefix): Parse the directive argument here and
	record it in the lit_prefix field.  Remove code to derive literal
	section names.
	(linkonce_len): New.
	(get_is_linkonce_section): Use linkonce_len.  Check for any
	".gnu.linkonce.*" section, not just text sections.
	(md_begin): Remove initialization of deleted lit_state fields.
	(xtensa_reorder_segments, xtensa_post_relax_hook): Remove references
	to init_literal_head and fini_literal_head.
	(xtensa_move_literals): Likewise.  Skip literals for .init and .fini
	when traversing literal_head list.
	(match_section_group): New.
	(cache_literal_section): Rewrite to determine the literal section
	name on the fly, create the section and return it.
	(xtensa_switch_to_literal_fragment): Adjust for cache_literal_section.
	(xtensa_switch_to_non_abs_literal_fragment): Likewise.
	(xtensa_create_property_segments, xtensa_create_xproperty_segments):
	Use xtensa_get_property_section from bfd.
	(retrieve_xtensa_section): Delete.
	* doc/c-xtensa.texi (Xtensa Options): Fix --text-section-literals
	description to refer to plural literal sections and add xref to
	the Literal Directive section.
	(Literal Directive): Describe new rules for deriving literal section
	names.  Add footnote for special case of .init/.fini with
	--text-section-literals.
	(Literal Prefix Directive): Replace old naming rules with xref to the
	Literal Directive section.
ld/
	* emulparams/elf32xtensa.sh (.xt.prop): Add .xt.prop.*.
	* scripttempl/elfxtensa.sc (.text): Add .literal.*.
2006-08-25 00:08:55 +00:00
..
emulparams bfd/ 2006-08-25 00:08:55 +00:00
emultempl bfd 2006-08-21 08:12:46 +00:00
po * po/zh_TW.po: New Chinese (traditional) translation. 2006-07-10 14:30:41 +00:00
scripttempl bfd/ 2006-08-25 00:08:55 +00:00
testsuite 2006-08-23 H.J. Lu <hongjiu.lu@intel.com> 2006-08-23 14:45:30 +00:00
ChangeLog bfd/ 2006-08-25 00:08:55 +00:00
ChangeLog-0001
ChangeLog-0203
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-9899
MAINTAINERS
Makefile.am bfd 2006-08-21 08:12:46 +00:00
Makefile.in bfd 2006-08-21 08:12:46 +00:00
NEWS * NEWS: Mention LMA default change. 2006-08-22 07:41:05 +00:00
README
TODO
acinclude.m4
aclocal.m4 binutils/ 2006-05-02 14:20:46 +00:00
config.in * config.in: Regenerate. 2006-06-05 12:30:16 +00:00
configure * po/zh_TW.po: New Chinese (traditional) translation. 2006-07-10 14:30:41 +00:00
configure.host 2005-07-19 Paul Brook <paul@codesourcery.com> 2005-07-19 12:43:19 +00:00
configure.in * po/zh_TW.po: New Chinese (traditional) translation. 2006-07-10 14:30:41 +00:00
configure.tgt * configure.tgt: Set targ_emul to arm_wince_pe for ARM Windows CE targets. 2006-08-22 11:50:33 +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 LIBRARY or NAME statement 2006-04-01 04:51:23 +00:00
dep-in.sed ld/ 2005-10-30 17:40:28 +00:00
elf-hints-local.h * emultempl/elf32.em: Add support for elf-hints.h on FreeBSD and Dragonfly targets. 2006-04-11 10:36:26 +00:00
fdl.texi
gen-doc.texi * ld.texinfo: Document PowerPC and PowerPC64 options. 2006-05-05 00:51:37 +00:00
genscripts.sh * Makefile.am (GENSCRIPTS): Pass prefix. 2006-04-05 15:40:40 +00:00
h8-doc.texi
ld.h bfd/ 2006-07-19 01:50:23 +00:00
ld.texinfo * NEWS: Mention LMA default change. 2006-08-22 07:41:05 +00:00
ldcref.c bfd/ 2006-07-19 01:50:23 +00:00
ldctor.c
ldctor.h
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 * ldexp.c (fold_name <LOADADDR>): Return an absolute value 2006-08-23 01:35:31 +00:00
ldexp.h bfd/ 2005-08-05 13:52:13 +00:00
ldfile.c
ldfile.h
ldgram.y * ldlang.h (enum section_type): Delete dsect_section, copy_section, 2006-06-07 04:55:11 +00:00
ldint.texinfo Fix spelling typos 2006-07-24 13:49:50 +00:00
ldlang.c * ldlang.c (lang_size_sections_1, lang_assignment_statement_enum): 2006-08-24 14:59:24 +00:00
ldlang.h ld/ 2006-08-16 08:31:45 +00:00
ldlex.h
ldlex.l bfd/ 2006-05-30 16:45:32 +00:00
ldmain.c * ldmain.c (main): Initialise print_gc_sections field of link_info structure. 2006-08-04 14:53:26 +00:00
ldmain.h
ldmisc.c * ldmisc.c (vfinfo): Revert 2005-10-05 changes. If 2006-03-31 11:23:55 +00:00
ldmisc.h
ldver.c
ldver.h
ldwrite.c * ldlang.h (lang_input_section_type): Remove "ifile" field. 2005-11-17 00:10:05 +00:00
ldwrite.h
lexsup.c * ldmain.c (main): Initialise print_gc_sections field of link_info structure. 2006-08-04 14:53:26 +00:00
mri.c
mri.h
pe-dll.c bfd 2006-08-21 08:12:46 +00:00
pe-dll.h
stamp-h.in
sysdep.h configure clean up patch from Steve Ellcey. 2005-06-09 18:39:34 +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.