xref: /dragonfly/usr.bin/ldd/ldd.1 (revision 23b3ef78)
1.\" $FreeBSD: head/usr.bin/ldd/ldd.1 199871 2009-11-28 11:05:22Z danger $
2.\"
3.Dd January 19, 2016
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 is left for compatibility and has no effect.
57.Sh EXAMPLES
58The following is an example of a shell pipeline which uses the
59.Fl f
60option.
61It will print a report of all ELF binaries in the current directory,
62which link against libc.so.6:
63.Pp
64.Dl "find . -type f | xargs -n1 file -F ' ' | grep ELF | cut -f1 -d' ' | xargs ldd -f '%A %o\en' | grep libc.so.6"
65.Sh SEE ALSO
66.Xr ld 1 ,
67.Xr nm 1 ,
68.Xr rtld 1
69.Sh HISTORY
70A
71.Nm
72utility first appeared in SunOS 4.0, it appeared in its current form in
73.Fx 1.1 .
74