xref: /freebsd/usr.bin/lorder/lorder.1 (revision 315ee00f)
1.\" Copyright (c) 1990, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\" 3. Neither the name of the University nor the names of its contributors
13.\"    may be used to endorse or promote products derived from this software
14.\"    without specific prior written permission.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.\"     @(#)lorder.1	8.2 (Berkeley) 4/28/95
29.\"
30.Dd March 21, 2023
31.Dt LORDER 1
32.Os
33.Sh NAME
34.Nm lorder
35.Nd list dependencies for object files
36.Sh DEPRECATION NOTICE
37.Nm
38is obsolete and may not be present in
39.Fx 14
40and later.
41.Sh SYNOPSIS
42.Nm
43.Ar
44.Sh DESCRIPTION
45The
46.Nm
47utility uses
48.Xr nm 1
49to determine interdependencies in the list of object files
50and library archives
51specified on the command line.
52The
53.Nm
54utility outputs a list of file names where the first file contains a symbol
55which is defined by the second file.
56.Pp
57The output is normally used with
58.Xr tsort 1
59when a library is created to determine the optimum ordering of the
60object modules so that all references may be resolved in a single
61pass of the loader.
62.Pp
63When linking static binaries,
64.Nm
65and
66.Xr tsort 1
67can be used to properly order library archives automatically.
68.Pp
69The use of
70.Nm
71is not required by contemporary linkers, and
72.Nm
73may be removed from a future version of
74.Fx .
75.Sh ENVIRONMENT
76.Bl -tag -width indent
77.It Ev NM
78Path to the
79.Xr nm 1
80binary, defaults to
81.Dq Li nm .
82.It Ev NMFLAGS
83Flags to pass to
84.Xr nm 1 .
85.El
86.Sh EXAMPLES
87.Bd -literal -offset indent
88ar cr library.a `lorder ${OBJS} | tsort`
89cc -o foo ${OBJS} `lorder ${STATIC_LIBS} | tsort`
90.Ed
91.Sh SEE ALSO
92.Xr ar 1 ,
93.Xr ld 1 ,
94.Xr nm 1 ,
95.Xr ranlib 1 ,
96.Xr tsort 1
97.Sh HISTORY
98A
99.Nm
100utility appeared in
101.At v7 .
102