usr.bin/ldd/ldd.1

   1 .\" $FreeBSD: head/usr.bin/ldd/ldd.1 199871 2009-11-28 11:05:22Z danger $
   2 .\"
   3 .Dd February 20, 2011
   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 EXAMPLES
  61 The following is an example of a shell pipeline which uses the
  62 .Fl f
  63 option.
  64 It will print a report of all ELF binaries in the current directory,
  65 which 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
  72 A
  73 .Nm
  74 utility first appeared in SunOS 4.0, it appeared in its current form in
  75 .Fx 1.1 .
  76 .Pp
  77 The
  78 .Fl v
  79 support is based on code written by
  80 .An John Polstra Aq jdp@polstra.com