From: Ian Lance Taylor <ian@airs.com>
Date: Fri, 10 Mar 1995 18:36:43 +0000 (+0000)
Subject: document split-by-reloc and split-by-file
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=ec5865657b3cc4ca8b07392ce5e3f2a0f1bc4bdc;p=binutils-gdb.git

document split-by-reloc and split-by-file
---

diff --git a/ld/ld.1 b/ld/ld.1
index 7e302670677..40fec9f2a01 100644
--- a/ld/ld.1
+++ b/ld/ld.1
@@ -82,6 +82,10 @@ ld \- the GNU linker
 .RB "[\|" \-S "\|]" 
 .RB "[\|" \-s "\|]" 
 .RB "[\|" \-sort\-common "\|]" 
+.RB "[\|" \-split\-by\-reloc\ "\c
+.I count\c
+\&\|]
+.RB "[\|" \-split\-by\-file "\|]" 
 .RB "[\|" "\-T\ "\c
 .I commandfile\c
 \&\|]  
@@ -700,6 +704,28 @@ the two bytes, then all the four bytes, and then everything else.
 This is to prevent gaps between symbols due to
 alignment constraints.  This option disables that sorting.
 
+.TP
+.B \-split\-by\-reloc\ \fIcount
+Trys to creates extra sections in the output file so that no single
+output section in the file contains more than
+.I count
+relocations.
+This is useful when generating huge relocatable for downloading into
+certain real time kernels with the COFF object file format; since COFF
+cannot represent more than 65535 relocations in a single section.
+Note that this will fail to work with object file formats which do not
+support arbitrary sections.  The linker will not split up individual
+input sections for redistribution, so if a single input section
+contains more than
+.I count
+relocations one output section will contain that many relocations.
+
+.TP
+.B \-split\-by\-file
+Similar to
+.B \-split\-by\-reloc
+but creates a new output section for each input file.
+
 .TP
 .BI "\-Tbss " "org"\c
 .TP