Annotation of src/usr.bin/lorder/lorder.1, Revision 1.9
1.9 ! sobrado 1: .\" $OpenBSD: lorder.1,v 1.8 2007/05/31 19:20:12 jmc Exp $
1.1 deraadt 2: .\" $NetBSD: lorder.1,v 1.5 1995/08/31 22:42:44 jtc Exp $
3: .\"
4: .\" Copyright (c) 1990, 1993
5: .\" The Regents of the University of California. All rights reserved.
6: .\"
7: .\" Redistribution and use in source and binary forms, with or without
8: .\" modification, are permitted provided that the following conditions
9: .\" are met:
10: .\" 1. Redistributions of source code must retain the above copyright
11: .\" notice, this list of conditions and the following disclaimer.
12: .\" 2. Redistributions in binary form must reproduce the above copyright
13: .\" notice, this list of conditions and the following disclaimer in the
14: .\" documentation and/or other materials provided with the distribution.
1.7 millert 15: .\" 3. Neither the name of the University nor the names of its contributors
1.1 deraadt 16: .\" may be used to endorse or promote products derived from this software
17: .\" without specific prior written permission.
18: .\"
19: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29: .\" SUCH DAMAGE.
30: .\"
31: .\" @(#)lorder.1 8.2 (Berkeley) 4/28/95
32: .\"
1.9 ! sobrado 33: .Dd $Mdocdate: May 31 2007 $
1.1 deraadt 34: .Dt LORDER 1
35: .Os
36: .Sh NAME
37: .Nm lorder
38: .Nd list dependencies for object files
39: .Sh SYNOPSIS
40: .Nm lorder
1.9 ! sobrado 41: .Ar
1.1 deraadt 42: .Sh DESCRIPTION
43: The
1.5 aaron 44: .Nm
1.1 deraadt 45: utility uses
46: .Xr nm 1
47: to determine interdependencies in the list of object files
48: specified on the command line.
1.5 aaron 49: .Nm
1.1 deraadt 50: outputs a list of file names where the first file contains a symbol
51: which is defined by the second file.
52: .Pp
53: The output is normally used with
1.4 aaron 54: .Xr tsort 1
1.1 deraadt 55: when a library is created to determine the optimum ordering of the
56: object modules so that all references may be resolved in a single
57: pass of the loader.
58: .Sh EXAMPLES
1.5 aaron 59: .Bd -literal
1.6 deraadt 60: $ ar cr library.a `lorder ${OBJS} | tsort`
1.1 deraadt 61: .Ed
62: .Sh SEE ALSO
63: .Xr ar 1 ,
64: .Xr ld 1 ,
65: .Xr nm 1 ,
66: .Xr ranlib 1 ,
67: .Xr tsort 1
68: .Sh HISTORY
69: An
1.5 aaron 70: .Nm
1.1 deraadt 71: utility appeared in
72: .At v7 .