diff options
Diffstat (limited to 'ld')
-rw-r--r-- | ld/README | 51 |
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. |