binutils-gdb/ld
Alan Modra 5a8edf8ece Test that gcc -B picks up new ld
gcc configured using --with-ld always uses that particular version of
ld if it exists.  This patch adds a check that the ld version reported
directly from ld-new matches that reported via gcc.  I chose to
compare the ld --version output rather than a more strict test (for
example by gcc --print-prog-name=ld), because the version test allows
a user to run the ld testsuite after installing a new ld (in the place
expected by gcc).

Sample output:

Running target unix
Using /usr/share/dejagnu/baseboards/unix.exp as board description file for target.
Using /usr/share/dejagnu/config/unix.exp as generic interface file for target.
Using /home/alan/src/binutils-gdb/ld/testsuite/config/default.exp as tool-and-target-specific interface file.
ERROR: ************************************************************************
ERROR: Your compiler driver ignores -B when choosing ld.
ERROR: You will not be testing the new ld in many of the following tests.
ERROR: It seems you will be testing /usr/bin/x86_64-w64-mingw32-ld instead.
ERROR: ************************************************************************
WARNING: Assuming target board is the local machine (which is probably wrong).
You may need to set your DEJAGNU environment variable.
Running /home/alan/src/binutils-gdb/ld/testsuite/ld-aarch64/aarch64-elf.exp ...

	* testsuite/lib/ld-lib.exp (run_host_cmd): Check that gcc -B
	works.
2018-04-21 18:48:40 +09:30
..
emulparams various i386-aout and i386-coff target removal 2018-04-18 09:34:19 +09:30
emultempl Remove sunos.em 2018-04-16 23:23:11 +09:30
po various i386-aout and i386-coff target removal 2018-04-18 09:34:19 +09:30
scripttempl various i386-aout and i386-coff target removal 2018-04-18 09:34:19 +09:30
testsuite Test that gcc -B picks up new ld 2018-04-21 18:48:40 +09:30
.gitignore
ChangeLog Test that gcc -B picks up new ld 2018-04-21 18:48:40 +09:30
ChangeLog-0001
ChangeLog-0203
ChangeLog-2004
ChangeLog-2005
ChangeLog-2006
ChangeLog-2007
ChangeLog-2008
ChangeLog-2009
ChangeLog-2010
ChangeLog-2011
ChangeLog-2012
ChangeLog-2013
ChangeLog-2014
ChangeLog-2015
ChangeLog-2016
ChangeLog-2017
ChangeLog-9197
ChangeLog-9899
MAINTAINERS
Makefile.am various i386-aout and i386-coff target removal 2018-04-18 09:34:19 +09:30
Makefile.in various i386-aout and i386-coff target removal 2018-04-18 09:34:19 +09:30
NEWS Add blurb about linker changes for Cygwin and Mingw targets. 2018-04-04 12:18:09 +02:00
README
TODO
aclocal.m4
config.in ld: Add --enable-separate-code 2018-02-27 11:34:29 -08:00
configure Use dlsym to check if libdl is needed for plugin 2018-04-05 15:31:53 -07:00
configure.ac Add missing translations to ALL_LINGUAS 2018-03-01 09:17:02 +10:30
configure.host Remove m88k support 2018-04-16 15:23:38 +09:30
configure.tgt various i386-aout and i386-coff target removal 2018-04-18 09:34:19 +09:30
deffile.h Speed up direct linking with DLLs on Windows (2/2). 2018-04-04 12:13:05 +02:00
deffilep.y Speed up direct linking with DLLs on Windows (2/2). 2018-04-04 12:13:05 +02:00
dep-in.sed
elf-hints-local.h
fdl.texi
gen-doc.texi
genscrba.sh
genscripts.sh
h8-doc.texi
ld.h
ld.texinfo [MicroBlaze] PIC data text relative 2018-04-17 14:47:13 -07:00
ldbuildid.c
ldbuildid.h
ldcref.c ld error/warning messages 2018-02-26 10:51:12 +10:30
ldctor.c ld error/warning messages 2018-02-26 10:51:12 +10:30
ldctor.h
ldemul.c powerpc common-page-size 2018-04-14 17:56:40 +09:30
ldemul.h
ldexp.c ld error/warning messages 2018-02-26 10:51:12 +10:30
ldexp.h
ldfile.c ld error/warning messages 2018-02-26 10:51:12 +10:30
ldfile.h
ldgram.y ld error/warning messages 2018-02-26 10:51:12 +10:30
ldint.texinfo
ldlang.c Remove sh5 and sh64 support 2018-04-16 15:29:39 +09:30
ldlang.h
ldlex-wrapper.c
ldlex.h [MicroBlaze] PIC data text relative 2018-04-17 14:47:13 -07:00
ldlex.l
ldmain.c [MicroBlaze] PIC data text relative 2018-04-17 14:47:13 -07:00
ldmain.h
ldmisc.c ld error/warning messages 2018-02-26 10:51:12 +10:30
ldmisc.h
ldver.c
ldver.h
ldwrite.c ld error/warning messages 2018-02-26 10:51:12 +10:30
ldwrite.h
lexsup.c [MicroBlaze] PIC data text relative 2018-04-17 14:47:13 -07:00
mri.c Remove m68k-aout and m68k-coff support 2018-04-16 15:31:36 +09:30
mri.h
pe-dll.c Remove arm-epoc-pe support 2018-04-16 20:29:05 +09:30
pe-dll.h Speed up direct linking with DLLs on Windows (1/2). 2018-04-04 12:07:50 +02:00
pep-dll.c Speed up direct linking with DLLs on Windows (1/2). 2018-04-04 12:07:50 +02:00
pep-dll.h Speed up direct linking with DLLs on Windows (1/2). 2018-04-04 12:07:50 +02:00
plugin.c ld error/warning messages 2018-02-26 10:51:12 +10:30
plugin.h
stamp-h.in
sysdep.h
testplug.c
testplug2.c
testplug3.c
testplug4.c

README

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

		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.

Copyright (C) 2012-2018 Free Software Foundation, Inc.

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.