aboutsummaryrefslogtreecommitdiff
path: root/ld
diff options
context:
space:
mode:
authorPer Bothner <per@bothner.com>1991-10-15 06:57:32 +0000
committerPer Bothner <per@bothner.com>1991-10-15 06:57:32 +0000
commitc1eeb9af4ab9c19672530881b23575ee63f47f38 (patch)
tree20e975dce7fd6745db8cb31fcc24f9dc401a6fec /ld
parent2109a7b736f5a2075f08c33250023d49ed637a85 (diff)
downloadgdb-c1eeb9af4ab9c19672530881b23575ee63f47f38.zip
gdb-c1eeb9af4ab9c19672530881b23575ee63f47f38.tar.gz
gdb-c1eeb9af4ab9c19672530881b23575ee63f47f38.tar.bz2
Initial revision
Diffstat (limited to 'ld')
-rw-r--r--ld/README51
1 files changed, 51 insertions, 0 deletions
diff --git a/ld/README b/ld/README
new file mode 100644
index 0000000..f6da828
--- /dev/null
+++ b/ld/README
@@ -0,0 +1,51 @@
+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 manual.
+
+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.
+
+Porting to a new target
+=======================
+
+A new target configuration may need a new linker script (.sc file)
+to specify linker actions (such as the layout of the output).
+See if one of the existing ones are suitable.
+Note that the Makefile generates variants of the standard script
+that are used when ld is passed -r -Ur -N or -n options.
+These variant default scripts are generated from the "master"
+script using sed scripts that may not work in all cases.
+Look at the rules and comments in ld/Makefile.in to make sure
+you stay with the rules.
+
+Otherwise, you may need to add a new "emulation" (a sample of a
+recently added target and emulation is for the SOny 68k News
+family - look for files named *news*).
+
+Also see the notes in ../binutils/README.
+
+Reporting bugs etc
+===========================
+See ../binutils/README.