NetBSD/gnu/dist/ld
thorpej d32edd2b13 Make the powerpc-*-netbsd* target use the elf32ppc linker emulation. 1998-01-30 22:08:47 +00:00
..
emulparams stock binutils-2.8 1997-09-24 15:39:15 +00:00
emultempl stock binutils-2.8.1 1997-09-24 18:54:18 +00:00
scripttempl Make sure _end is aligned to 4 or 8 bytes (depending on elf32 or elf64). 1997-12-17 03:10:24 +00:00
testsuite stock binutils-2.8.1 1997-09-24 18:54:18 +00:00
ChangeLog stock binutils-2.8.1 1997-09-24 18:54:18 +00:00
Makefile.in stock binutils-2.8 1997-09-24 15:39:15 +00:00
NEWS stock binutils-2.8 1997-09-24 15:39:15 +00:00
README stock binutils-2.8 1997-09-24 15:39:15 +00:00
TODO stock binutils-2.8 1997-09-24 15:39:15 +00:00
acconfig.h stock binutils-2.8 1997-09-24 15:39:15 +00:00
aclocal.m4 stock binutils-2.8 1997-09-24 15:39:15 +00:00
config.in stock binutils-2.8 1997-09-24 15:39:15 +00:00
configdoc.texi stock binutils-2.8 1997-09-24 15:39:15 +00:00
configure stock binutils-2.8 1997-09-24 15:39:15 +00:00
configure.bat stock binutils-2.8 1997-09-24 15:39:15 +00:00
configure.host Add configuration information for NetBSD/alpha. 1997-12-17 03:06:45 +00:00
configure.in stock binutils-2.8 1997-09-24 15:39:15 +00:00
configure.tgt Make the powerpc-*-netbsd* target use the elf32ppc linker emulation. 1998-01-30 22:08:47 +00:00
dep-in.sed stock binutils-2.8 1997-09-24 15:39:15 +00:00
gen-doc.texi stock binutils-2.8 1997-09-24 15:39:15 +00:00
genscripts.sh stock binutils-2.8 1997-09-24 15:39:15 +00:00
h8-doc.texi stock binutils-2.8 1997-09-24 15:39:15 +00:00
ld.1 stock binutils-2.8 1997-09-24 15:39:15 +00:00
ld.h stock binutils-2.8 1997-09-24 15:39:15 +00:00
ld.info stock binutils-2.8 1997-09-24 15:39:15 +00:00
ld.info-1 stock binutils-2.8 1997-09-24 15:39:15 +00:00
ld.info-2 stock binutils-2.8 1997-09-24 15:39:15 +00:00
ld.info-3 stock binutils-2.8 1997-09-24 15:39:15 +00:00
ld.info-4 stock binutils-2.8 1997-09-24 15:39:15 +00:00
ld.texinfo stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldcref.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldctor.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldctor.h stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldemul.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldemul.h stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldexp.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldexp.h stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldfile.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldfile.h stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldgram.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldgram.h stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldgram.y stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldint.texinfo stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldlang.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldlang.h stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldlex.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldlex.h stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldlex.l stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldmain.c stock binutils-2.8.1 1997-09-24 18:54:18 +00:00
ldmain.h stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldmisc.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldmisc.h stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldver.c stock binutils-2.8.1 1997-09-24 18:54:18 +00:00
ldver.h stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldwrite.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
ldwrite.h stock binutils-2.8 1997-09-24 15:39:15 +00:00
lexsup.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
mac-ld.r stock binutils-2.8 1997-09-24 15:39:15 +00:00
mpw-config.in stock binutils-2.8 1997-09-24 15:39:15 +00:00
mpw-elfmips.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
mpw-eppcmac.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
mpw-esh.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
mpw-idtmips.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
mpw-make.sed stock binutils-2.8 1997-09-24 15:39:15 +00:00
mri.c stock binutils-2.8 1997-09-24 15:39:15 +00:00
mri.h stock binutils-2.8 1997-09-24 15:39:15 +00:00
sysdep.h stock binutils-2.8 1997-09-24 15:39:15 +00:00

README

This is a BETA release of a completely rewritten 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 new 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 support 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 contains 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.

Porting to a new target
=======================

See the ldint.texinfo manual.

Reporting bugs etc
===========================
See ../binutils/README.

Known problems
==============

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.