Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Kill spaces.

This commit is contained in:
pk 1995-10-15 13:12:18 +00:00
parent c3fae4e048
commit 9c21bb769d
2 changed files with 102 additions and 62 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

82
gnu/usr.bin/ld/ld.1
View File

@ -27,7 +27,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\" $Id: ld.1,v 1.8 1995/06/30 12:34:14 pk Exp $
.\" $Id: ld.1,v 1.9 1995/10/15 13:12:18 pk Exp $
.\"
.Dd October 14, 1993
.Dt LD 1
@ -41,13 +41,13 @@
.Bk -words
.Op Fl A Ar symbol-file
.Op Fl assert Ar keyword
.Op Fl B Ar linkmode
.Op Fl B Ns Ar linkmode
.Op Fl D Ar datasize
.Op Fl d Ar c
.Op Fl d Ar p
.Op Fl e Ar entry
.Op Fl l Ar library-specifier
.Op Fl L Ar library-search-path
.Op Fl l Ns Ar library-specifier
.Op Fl L Ns Ar library-search-path
.Op Fl nostdlib
.Op Fl o Ar filename
.Op Fl T Ar address
@ -70,41 +70,48 @@ The options are as follows:
.It Fl A Ar symbol-file
The the symbol-file is taken as a base for link-editing the object files
on the command line.
.It Fl a\&ssert Ar keyword
.It Fl assert Ar keyword
This option has currently no effect. It is here for compatibility with
SunOS ld. All conditions which would cause a Sun assertion to fail will
currently always cause error or warning messages from
.Nm ld\&.
.It Fl B Ar dynamic
.Nm ld .
.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
searches for a library of the from libx.so.n.m (see the
.Ar l
option) according to the search rules in effect. If such a file can not be
searches for a library of the from libx.so.n.m
.Po see the \&
.Fl l
option
.Pc
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 -Bstatic.
.It Fl B Ar static
The counterpart of -Bdynamic. This option turns off dynamic linking for
all library specifiers until a -Bdynamic is once again given. Any explicitly
.It Fl B Ns Ar static
The counterpart of
.Fl B Ns Ar dynamic .
This option turns off dynamic linking for
all library specifiers until a
.Fl B Ns Ar dynamic
is once again given. Any explicitly
mentioned shared object encountered on the command line while this option is
in effect is flagged as an error.
.It Fl B Ar shareable
.It Fl B Ns Ar shareable
Instructs the linker to build a shared object from the object files rather
than a normal executable image.
.It Fl B Ar symbolic
.It Fl B Ns Ar symbolic
This option causes all symbolic references in the output to be resolved in
this link-edit session. The only remaining run-time relocation requirements are
.Em base-relative
relocations, ie. translation with respect to the load address. Failure to
resolve any symbolic reference causes an error to be reported.
.It Fl B Ar forcearchive
.It Fl B Ns Ar forcearchive
Force all members of archives to be loaded, whether or not such members
contribute a definition to any plain object files. Useful for making a
shared library from an archive of PIC objects without having to unpack
the archive.
.It Fl B Ar silly
.It Fl B Ns Ar silly
Search for
.Em \.sa
silly archive companions of shared objects. Useful for compatibility with
@ -118,33 +125,41 @@ 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 L Ar path
.It Fl L Ns Ar path
Add
.Ar path
to the list of directories to search for libraries specified with the
.Ar -l
option.
.It Fl l Ar lib-spec
.It Fl l Ns Ar lib-spec
This option specifies a library to be considered for inclusion in the
output. If the -Bdynamic option is in effect, a shared library of the
form lib<spec>.so.m.n (where
form lib<spec>.so.m.n
.Po where \&
.Em m
is the major, and
.Em n
is the minor version number, respectively) is searched for first. The
is the minor version number, respectively
.Pc 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 -Bstatic options is in effect,
an archive of the form lib<spec>.a is looked for in the library seach path.
.It Fl M
Produce output about the mapping of segments of the input files and the
values assigned to (global) symbols in the output file.
values assigned to
.Pq global
symbols in the output file.
.It Fl N
Produce a OMAGIC output file.
Produce a
.Dv OMAGIC
output file.
.It Fl n
Produce a NMAGIC output file.
Produce a
.Dv NMAGIC
output file.
.It Fl nostdlib
Do not search the built-in path
.Po
@ -158,7 +173,9 @@ specified libraries.
Specifies the name of the output file. Defaults to
.Dq a.out.
.It Fl Q
Produce a QMAGIC output file.
Produce a
.Dv QMAGIC
output file.
.It Fl r
Produce relocatable object file, suitable for another pass through
.Nm ld.
@ -180,8 +197,9 @@ Force
to be marked as undefined. Useful to force loading of an archive member
in the absence of any other references to that member.
.It Fl V Ar version
Put the given version number into the output shared library (if one is
created). Useful to make shared libaries compatible with other operating
Put the given version number into the output shared library
.Pq if one is created .
Useful to make shared libaries compatible with other operating
systems. Eg. SunOS 4.x libraries use version number 3. Defaults to 8.
.It Fl X
Discard local symbols in the input files that start with the letter
@ -192,7 +210,9 @@ Discard all local symbols in the input files.
Trace the manipulations inflicted on
.Ar symbol
.It Fl z
Make a ZMAGIC output file. This is the default.
Make a
.Dv ZMAGIC
output file. This is the default.
.Sh FILES
.Sh SEE ALSO
.Xr ldconfig 1 ,
@ -200,7 +220,7 @@ Make a ZMAGIC output file. This is the default.
.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 ld .
.Sh BUGS
Shared objects are not properly checked for undefined symbols.
.Pp
@ -215,4 +235,4 @@ are needed from them.
.Sh HISTORY
The shared library model employed by
.Nm ld
appeared first in SunOS 4.0
appeared first in SunOS 4.0.

82
gnu/usr.bin/ld/ld/ld.1
View File

@ -27,7 +27,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\" $Id: ld.1,v 1.8 1995/06/30 12:34:14 pk Exp $
.\" $Id: ld.1,v 1.9 1995/10/15 13:12:18 pk Exp $
.\"
.Dd October 14, 1993
.Dt LD 1
@ -41,13 +41,13 @@
.Bk -words
.Op Fl A Ar symbol-file
.Op Fl assert Ar keyword
.Op Fl B Ar linkmode
.Op Fl B Ns Ar linkmode
.Op Fl D Ar datasize
.Op Fl d Ar c
.Op Fl d Ar p
.Op Fl e Ar entry
.Op Fl l Ar library-specifier
.Op Fl L Ar library-search-path
.Op Fl l Ns Ar library-specifier
.Op Fl L Ns Ar library-search-path
.Op Fl nostdlib
.Op Fl o Ar filename
.Op Fl T Ar address
@ -70,41 +70,48 @@ The options are as follows:
.It Fl A Ar symbol-file
The the symbol-file is taken as a base for link-editing the object files
on the command line.
.It Fl a\&ssert Ar keyword
.It Fl assert Ar keyword
This option has currently no effect. It is here for compatibility with
SunOS ld. All conditions which would cause a Sun assertion to fail will
currently always cause error or warning messages from
.Nm ld\&.
.It Fl B Ar dynamic
.Nm ld .
.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
searches for a library of the from libx.so.n.m (see the
.Ar l
option) according to the search rules in effect. If such a file can not be
searches for a library of the from libx.so.n.m
.Po see the \&
.Fl l
option
.Pc
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 -Bstatic.
.It Fl B Ar static
The counterpart of -Bdynamic. This option turns off dynamic linking for
all library specifiers until a -Bdynamic is once again given. Any explicitly
.It Fl B Ns Ar static
The counterpart of
.Fl B Ns Ar dynamic .
This option turns off dynamic linking for
all library specifiers until a
.Fl B Ns Ar dynamic
is once again given. Any explicitly
mentioned shared object encountered on the command line while this option is
in effect is flagged as an error.
.It Fl B Ar shareable
.It Fl B Ns Ar shareable
Instructs the linker to build a shared object from the object files rather
than a normal executable image.
.It Fl B Ar symbolic
.It Fl B Ns Ar symbolic
This option causes all symbolic references in the output to be resolved in
this link-edit session. The only remaining run-time relocation requirements are
.Em base-relative
relocations, ie. translation with respect to the load address. Failure to
resolve any symbolic reference causes an error to be reported.
.It Fl B Ar forcearchive
.It Fl B Ns Ar forcearchive
Force all members of archives to be loaded, whether or not such members
contribute a definition to any plain object files. Useful for making a
shared library from an archive of PIC objects without having to unpack
the archive.
.It Fl B Ar silly
.It Fl B Ns Ar silly
Search for
.Em \.sa
silly archive companions of shared objects. Useful for compatibility with
@ -118,33 +125,41 @@ 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 L Ar path
.It Fl L Ns Ar path
Add
.Ar path
to the list of directories to search for libraries specified with the
.Ar -l
option.
.It Fl l Ar lib-spec
.It Fl l Ns Ar lib-spec
This option specifies a library to be considered for inclusion in the
output. If the -Bdynamic option is in effect, a shared library of the
form lib<spec>.so.m.n (where
form lib<spec>.so.m.n
.Po where \&
.Em m
is the major, and
.Em n
is the minor version number, respectively) is searched for first. The
is the minor version number, respectively
.Pc 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 -Bstatic options is in effect,
an archive of the form lib<spec>.a is looked for in the library seach path.
.It Fl M
Produce output about the mapping of segments of the input files and the
values assigned to (global) symbols in the output file.
values assigned to
.Pq global
symbols in the output file.
.It Fl N
Produce a OMAGIC output file.
Produce a
.Dv OMAGIC
output file.
.It Fl n
Produce a NMAGIC output file.
Produce a
.Dv NMAGIC
output file.
.It Fl nostdlib
Do not search the built-in path
.Po
@ -158,7 +173,9 @@ specified libraries.
Specifies the name of the output file. Defaults to
.Dq a.out.
.It Fl Q
Produce a QMAGIC output file.
Produce a
.Dv QMAGIC
output file.
.It Fl r
Produce relocatable object file, suitable for another pass through
.Nm ld.
@ -180,8 +197,9 @@ Force
to be marked as undefined. Useful to force loading of an archive member
in the absence of any other references to that member.
.It Fl V Ar version
Put the given version number into the output shared library (if one is
created). Useful to make shared libaries compatible with other operating
Put the given version number into the output shared library
.Pq if one is created .
Useful to make shared libaries compatible with other operating
systems. Eg. SunOS 4.x libraries use version number 3. Defaults to 8.
.It Fl X
Discard local symbols in the input files that start with the letter
@ -192,7 +210,9 @@ Discard all local symbols in the input files.
Trace the manipulations inflicted on
.Ar symbol
.It Fl z
Make a ZMAGIC output file. This is the default.
Make a
.Dv ZMAGIC
output file. This is the default.
.Sh FILES
.Sh SEE ALSO
.Xr ldconfig 1 ,
@ -200,7 +220,7 @@ Make a ZMAGIC output file. This is the default.
.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 ld .
.Sh BUGS
Shared objects are not properly checked for undefined symbols.
.Pp
@ -215,4 +235,4 @@ are needed from them.
.Sh HISTORY
The shared library model employed by
.Nm ld
appeared first in SunOS 4.0
appeared first in SunOS 4.0.