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 If one is given, it sets
  36 .Ev LD_TRACE_LOADED_OBJECTS_FMT1 .
  37 If two are given, they set
  38 .Ev LD_TRACE_LOADED_OBJECTS_FMT1
  39 and
  40 .Ev LD_TRACE_LOADED_OBJECTS_FMT2 ,
  41 respectively.
  42 See
  43 .Xr rtld 1
  44 for details, including a list of recognized conversion characters.
  45 .Pp
  46 The
  47 .Fl a
  48 option displays the list of all objects that are needed by each loaded
  49 object.
  50 This option does not work with
  51 .Xr a.out 5
  52 binaries.
  53 .Pp
  54 The
  55 .Fl v
  56 option displays a verbose listing of the dynamic linking headers
  57 encoded in the executable.
  58 See the source code and include
  59 files for the definitive meaning of all the fields.
  60 .Sh SEE ALSO
  61 .Xr ld 1 ,
  62 .Xr nm 1 ,
  63 .Xr rtld 1
  64 .Sh HISTORY
  65 A
  66 .Nm
  67 utility first appeared in SunOS 4.0, it appeared in its current form in
  68 .Fx 1.1 .
  69 .Pp
  70 The
  71 .Fl v
  72 support is based on code written by
  73 .An John Polstra Aq jdp@polstra.com