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