aboutsummaryrefslogtreecommitdiff
path: root/gnu/usr.bin/ld/ld.1aout
diff options
context:
space:
mode:
Diffstat (limited to 'gnu/usr.bin/ld/ld.1aout')
-rw-r--r--gnu/usr.bin/ld/ld.1aout43
1 files changed, 20 insertions, 23 deletions
diff --git a/gnu/usr.bin/ld/ld.1aout b/gnu/usr.bin/ld/ld.1aout
index 7fbbd5d6ac17..ddd4899e1905 100644
--- a/gnu/usr.bin/ld/ld.1aout
+++ b/gnu/usr.bin/ld/ld.1aout
@@ -63,7 +63,7 @@ combines the object and archive files given on the command line into a new
object file. The output object file is either an executable program, a
shared object suitable for loading at run-time, or an object file that can
once again be processed by
-.Nm ld.
+.Nm .
Object files and archives are processed in the order given on the command line.
.Pp
The options are as follows:
@@ -74,12 +74,12 @@ The the symbol-file is taken as a base for link-editing the object files
on the command line.
.It Fl assert Ar keyword
This option is here mainly for compatibility with SunOS
-.Nm ld .
+.Nm .
Most conditions which would cause a Sun assertion to fail will
currently always cause error or warning messages from
-.Nm ld .
+.Nm .
The only keyword implemented by
-.Nm ld
+.Nm
is
.Nm pure-text ,
which generates a warning if a position independent object is being
@@ -88,22 +88,21 @@ independent.
.It Fl B Ns Ar dynamic
Specifies that linking against dynamic libraries can take place. If a library
specifier of the form -lx appears on the command line,
-.Nm ld
+.Nm
searches for a library of the from libx.so.n.m
-.Po see the \&
+(see the
.Fl l
-option
-.Pc
+option)
according to the search rules in effect. If such a file can not be
found a traditional archive is looked for.
This options can appear anywhere on the command line and is complementary
to
-.Fl B Ns Ar static.
+.Fl B Ns Ar static .
.It Fl B Ns Ar forcedynamic
This is similar to
.Fl B Ns Ar dynamic
except that if no dynamic libraries are linked against,
-.Nm ld
+.Nm
will still produce a dynamic executable. This is useful for programs
which are static but still need to load dynamic objects at runtime.
.It Fl B Ns Ar static
@@ -143,7 +142,7 @@ Force allocation of commons even producing relocatable output.
Force alias definitions of procedure calls in non-PIC code. Useful to
obtain shareable code in the presence of run-time relocations as such
calls will be re-directed through the Procedure Linkage Table (see
-.Xr link 5)
+.Xr link 5 )
.It Fl e Ar entry-symbol
Specifies the entry symbol for an executable.
.It Fl f
@@ -161,12 +160,12 @@ output. If the
.Fl B Ns Ar dynamic
option is in effect, a shared library of the
form lib<spec>.so.m.n
-.Po where \&
+(where
.Em m
is the major, and
.Em n
-is the minor version number, respectively
-.Pc is searched for first. The
+is the minor version number, respectively)
+is searched for first. The
library with the highest version found in the search path is selected.
If no shared library is found or the
.Fl B Ns Ar static
@@ -187,29 +186,27 @@ Produce a
output file.
.It Fl nostdlib
Do not search the built-in path
-.Po
-usually
-.Dq /usr/lib
-.Pc
+(usually
+.Dq /usr/lib )
for
.Fl l
specified libraries.
.It Fl O Ar filename
Specifies the name of the output file.
The file is created as
-.Ar filename .tmp
+.Ar filename Ns Pa .tmp
and when output is complete renamed to
.Ar filename .
.It Fl o Ar filename
Specifies the name of the output file. Defaults to
-.Dq a.out.
+.Dq Pa a.out .
.It Fl Q
Produce a
.Dv QMAGIC
(FreeBSD/BSDi-i386) output file. This is the default.
.It Fl r
Produce relocatable object file, suitable for another pass through
-.Nm ld.
+.Nm .
.It Fl R
Record the given path within the executable for run-time library search.
This only applies to dynamically linked executables.
@@ -273,7 +270,7 @@ options and preceding the built-in path.
.Sh CAVEATS
An entry point must now explicitly be given if the output is intended to be
a normal executable program. This was not the case for the previous version of
-.Nm ld .
+.Nm .
.Sh BUGS
Shared objects are not properly checked for undefined symbols.
.Pp
@@ -282,7 +279,7 @@ Cascading of shared object defeats the
option.
.Pp
All shared objects presented to
-.Nm ld
+.Nm
are marked for run-time loading in the output file, even if no symbols
are needed from them.
.Sh HISTORY