BSD 3 development

[unix-history] / usr / man / man1 / ld.1

diff --git a/usr/man/man1/ld.1 b/usr/man/man1/ld.1
index 86bdda8..e9d2249 100644 (file)
--- a/usr/man/man1/ld.1
+++ b/usr/man/man1/ld.1
@@ -1,4 +1,5 @@
-.TH LD 1 "UNIX/32V"
+.TH LD 1 VAX-11
+.UC

 .SH NAME
 ld \- link editor
 .SH SYNOPSIS
 .SH NAME
 ld \- link editor
 .SH SYNOPSIS


@@ -98,9 +99,11 @@ when the output file is executed,
 the text portion will be read-only and shared
 among all users executing the file.
 This involves moving the data areas up to the first
 the text portion will be read-only and shared
 among all users executing the file.
 This involves moving the data areas up to the first

-possible 512 byte boundary following the
-end of the text.  This option is the default under UNIX/32V;
-the only other choice is \-N.
+possible 1024 byte boundary following the
+end of the text.  This option is the default on the VAX-11;
+the only other choice is \-N,
+but see also
+.B \-z.

 .TP 
 .B  \-o
 The
 .TP 
 .B  \-o
 The


@@ -127,7 +130,7 @@ and suppresses the `undefined symbol' diagnostics.
 .B  \-s
 `Strip' the output, that is, remove the symbol table
 and relocation bits to save space (but impair the
 .B  \-s
 `Strip' the output, that is, remove the symbol table
 and relocation bits to save space (but impair the

-usefulness of the debugger).
+usefulness of the debuggers).

 This information can also be removed by
 .IR  strip (1).
 .TP
 This information can also be removed by
 .IR  strip (1).
 .TP


@@ -158,12 +161,31 @@ Do not preserve local
 (non-.globl) symbols in the output symbol table; only enter
 external symbols.
 This option saves some space in the output file.
 (non-.globl) symbols in the output symbol table; only enter
 external symbols.
 This option saves some space in the output file.

+.TP
+.B \-z
+Arrange for the process to be loaded on
+demand from the resulting executable file (413 format)
+rather than preloaded.  This option implies
+.B \-n
+and results in a 1024 byte header on the output file followed by
+a text and data segment each of which have size a multiple of 1024 bytes
+(being padded out with nulls in the file if necessary).  This format is more
+efficient for very large programs (say 100K bytes or larger) especially
+when they contain a large number of features not all of which are used
+in any one run.
+With this format the first few BSS segment symbols may actually appear
+(from the output of
+.IR size (2))
+to live in the data segment;
+this to avoid wasting the space resulting from data segment size roundup.

 .SH FILES
 .SH FILES

-.ta \w'/usr/lib/lib*.a\ \ 'u
+.ta \w'/usr/local/lib/lib*.a\ \ 'u

 /lib/lib*.a    libraries
 .br
 /usr/lib/lib*.a        more libraries
 .br
 /lib/lib*.a    libraries
 .br
 /usr/lib/lib*.a        more libraries
 .br

+/usr/local/lib/lib*.a  still more libraries
+.br

 a.out  output file
 .SH "SEE ALSO"
 as(1), ar(1), cc(1)
 a.out  output file
 .SH "SEE ALSO"
 as(1), ar(1), cc(1)