usr.bin/ldd/ldd.1

   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
  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 a
  41 option displays the list of all objects that are needed by each loaded
  42 object.
  43 This option does not work with
  44 .Xr a.out 5
  45 binaries.
  46 .Pp
  47 The
  48 .Fl v
  49 option displays a verbose listing of the dynamic linking headers
  50 encoded in the executable.
  51 See the source code and include
  52 files 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
  58 A
  59 .Nm
  60 utility first appeared in SunOS 4.0, it appeared in its current form in
  61 .Fx 1.1 .
  62 .Pp
  63 The
  64 .Fl v
  65 support is based on code written by
  66 .An John Polstra Aq jdp@polstra.com