xref: /freebsd/usr.bin/ldd/ldd.1 (revision 195ebc7e9e4b129de810833791a19dfb4349d6a9)
1.\" $FreeBSD$
2.\"
3.Dd May 15, 2008
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.
35If one is given, it sets
36.Ev LD_TRACE_LOADED_OBJECTS_FMT1 .
37If two are given, they set
38.Ev LD_TRACE_LOADED_OBJECTS_FMT1
39and
40.Ev LD_TRACE_LOADED_OBJECTS_FMT2 ,
41respectively.
42See
43.Xr rtld 1
44for details, including a list of recognized conversion characters.
45.Pp
46The
47.Fl a
48option displays the list of all objects that are needed by each loaded
49object.
50This option does not work with
51.Xr a.out 5
52binaries.
53.Pp
54The
55.Fl v
56option displays a verbose listing of the dynamic linking headers
57encoded in the executable.
58See the source code and include
59files for the definitive meaning of all the fields.
60.Sh EXAMPLES
61The following is an example of a shell pipeline which uses the
62.Fl f
63option.
64It will print a report of all ELF binaries in the current directory,
65which link against libc.so.6:
66.Dl "find . -type f | xargs -n1 file -F " " | grep ELF | cut -f1 -d' ' | xargs ldd -f '%A %o\en' | grep libc.so.6"
67.Sh SEE ALSO
68.Xr ld 1 ,
69.Xr nm 1 ,
70.Xr rtld 1
71.Sh HISTORY
72A
73.Nm
74utility first appeared in SunOS 4.0, it appeared in its current form in
75.Fx 1.1 .
76.Pp
77The
78.Fl v
79support is based on code written by
80.An John Polstra Aq jdp@polstra.com
81