diff options
author | ru <ru@FreeBSD.org> | 2001-02-01 16:38:02 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2001-02-01 16:38:02 +0000 |
commit | 8a6f8b5fe456b5b3a8f1d86173f81cfcae6cfe19 (patch) | |
tree | b428fc12404c6d6be2c1fce52490993ab3744097 /gnu/usr.bin/ld/ld.1aout | |
parent | 4923ae6c3fe2f82d94fec60b85ed2a6272b2fd67 (diff) | |
download | FreeBSD-src-8a6f8b5fe456b5b3a8f1d86173f81cfcae6cfe19.zip FreeBSD-src-8a6f8b5fe456b5b3a8f1d86173f81cfcae6cfe19.tar.gz |
mdoc(7) police: split punctuation characters + misc fixes.
Diffstat (limited to 'gnu/usr.bin/ld/ld.1aout')
-rw-r--r-- | gnu/usr.bin/ld/ld.1aout | 43 |
1 files changed, 20 insertions, 23 deletions
diff --git a/gnu/usr.bin/ld/ld.1aout b/gnu/usr.bin/ld/ld.1aout index 7fbbd5d..ddd4899 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 |