xref: /freebsd/usr.bin/ldd/ldd.1 (revision d056fa046c6a91b90cd98165face0e42a33a5173)
1.\" $FreeBSD$
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 a
12.Op Fl v
13.Op Fl f Ar format
14.Ar program ...
15.Sh DESCRIPTION
16The
17.Nm
18utility displays all shared objects that are needed to run the given program or
19to load the given shared object.
20Contrary to
21.Xr nm 1 ,
22the list includes
23.Dq indirect
24dependencies that are the result of needed shared objects which themselves
25depend on yet other shared objects.
26.Pp
27Zero, one or two
28.Fl f
29options may be given.
30The argument is a format string passed to
31.Xr rtld 1
32and allows customization of
33.Nm Ns 's
34output.
35See
36.Xr rtld 1
37for a list of recognized conversion characters.
38.Pp
39The
40.Fl a
41option displays the list of all objects that are needed by each loaded
42object.
43This option does not work with
44.Xr a.out 5
45binaries.
46.Pp
47The
48.Fl v
49option displays a verbose listing of the dynamic linking headers
50encoded in the executable.
51See the source code and include
52files for the definitive meaning of all the fields.
53.Sh SEE ALSO
54.Xr ld 1 ,
55.Xr nm 1 ,
56.Xr rtld 1
57.Sh HISTORY
58A
59.Nm
60utility first appeared in SunOS 4.0, it appeared in its current form in
61.Fx 1.1 .
62.Pp
63The
64.Fl v
65support is based on code written by
66.An John Polstra Aq jdp@polstra.com
67