Initial import from FreeBSD RELENG_4:
[dragonfly.git] / usr.bin / ldd / ldd.1
1 .\" $FreeBSD: src/usr.bin/ldd/ldd.1,v 1.12.2.7 2002/06/21 15:27:41 charnier Exp $
2 .\"
3 .Dd October 22, 1993
4 .Dt LDD 1
5 .Os
6 .Sh NAME
7 .Nm ldd
8 .Nd list dynamic object dependencies
9 .Sh SYNOPSIS
10 .Nm
11 .Op Fl v
12 .Op Fl f Ar format
13 .Ar program ...
14 .Sh DESCRIPTION
15 The
16 .Nm
17 utility displays all shared objects that are needed to run the given program or
18 to load the given shared object.
19 Contrary to
20 .Xr nm 1 ,
21 the list includes
22 .Dq indirect
23 dependencies that are the result of needed shared objects which themselves
24 depend on yet other shared objects.
25 .Pp
26 Zero, one or two
27 .Fl f
28 options may be given.
29 The argument is a format string passed to
30 .Xr rtld 1
31 and allows customization of
32 .Nm Ns 's
33 output.
34 See
35 .Xr rtld 1
36 for a list of recognized conversion characters.
37 .Pp
38 The
39 .Fl v
40 option displays an verbose listing of the dynamic linking headers
41 encoded in the executable.  See the source code and include
42 files for the definitive meaning of all the fields.
43 .Sh SEE ALSO
44 .Xr ld 1 ,
45 .Xr nm 1 ,
46 .Xr rtld 1
47 .Sh HISTORY
48 A
49 .Nm
50 utility first appeared in SunOS 4.0, it appeared in its current form in
51 .Fx 1.1 .
52 .Pp
53 The
54 .Fl v
55 support is based on code written by
56 .An John Polstra Aq jdp@polstra.com