ldd_ia(1)                                                         ldd_ia(1)
                        For Itanium(R)-based Systems



 NAME    [Toc]    [Back]
      ldd_ia: ldd - list dynamic dependencies of executable files or shared
      libraries

 SYNOPSIS    [Toc]    [Back]
      ldd [-d] [-r] [-s] [-v] filename...

 DESCRIPTION    [Toc]    [Back]
      ldd is a command that can list the dynamic dependencies of incomplete
      executable files or shared libraries.

      ldd lists verbose information about dynamic dependencies and symbol
      references.  If the object file is an executable file, ldd lists all
      shared libraries that would be loaded as a result of executing the
      file.  If it is a shared library, ldd lists all shared libraries that
      would be loaded as a result of loading the library.

      ldd uses the same algorithm as the dynamic loader
      (/usr/lib/hpux32/dld.so and /usr/lib/hpux64/dld.so) to locate the
      shared libraries at runtime.  See "Dynamic Path List" in dld.so(5) for
      more information.

    Options    [Toc]    [Back]
      ldd recognizes the following options:

           -d   Check reference to data symbols.

           -r   Check reference to data and code symbols.

           -s   Display the search path used to locate the shared libraries.

           -v   Display all dependency relationships.

 EXTERNAL INFLUENCES    [Toc]    [Back]
    Environment Variables
      ldd uses the following environment variables to locate shared
      libraries.

      LD_LIBRARY_PATH    [Toc]    [Back]
           A colon-separated list of path names which defines the search
           path for shared libraries at runtime.  See "Dynamic Path List" in
           dld.so(5) for more information.

      SHLIB_PATH    [Toc]    [Back]
           A colon-separated list of path names which defines the search
           path for shared libraries at runtime.  See "Dynamic Path List" in
           dld.so(5) for more information.

      The following internationalization variables affect the execution of
      ldd:




 Hewlett-Packard Company            - 1 -      HP-UX 11i Version 2: Sep 2004






 ldd_ia(1)                                                         ldd_ia(1)
                        For Itanium(R)-based Systems



      LANG Determines the locale category for native language, local customs
           and coded character set in the absence of LC_ALL and other LC_*
           environment variables.  If LANG is not specified or is set to the
           empty string, a default of C (see lang(5)) is used instead of
           LANG.

      LC_ALL    [Toc]    [Back]
           Determines the values for all locale categories and has
           precedence over LANG and other LC_* environment variables.

      LC_MESSAGES    [Toc]    [Back]
           Determines the locale that should be used to affect the format
           and contents of diagnostic messages written to standard error.

      LC_NUMERIC    [Toc]    [Back]
           Determines the locale category for numeric formatting.

      LC_CTYPE    [Toc]    [Back]
           Determines the locale category for character handling functions.

      NLSPATH    [Toc]    [Back]
           Determines the location of message catalogs for the processing of
           LC_MESSAGES.

      If any internationalization variable contains an invalid setting, ldd
      behaves as if all internationalization variables are set to C.  See
      environ(5).

 DIAGNOSTICS    [Toc]    [Back]
      ldd prints the record of shared library path names to stdout.  The
      optional list of symbol resolution problems are printed to stderr.

      ldd returns zero when the operation is successful.  A non-zero return
      code indicates that an error occurred.

 EXAMPLES    [Toc]    [Back]
      By default ldd prints a simple dynamic path information.  This
      consists of the dependencies recorded in the executable (or the shared
      library) followed by the physical location where these libraries are
      found.

      ldd a.out
          ./libx.so =>    ./libx.so
          libc.so =>       /usr/lib/hpux32/libc.so.1
          libdl.so =>      /usr/lib/hpux32/libdl.so.1

      The -v option causes ldd to print dependency relationship along with
      the dynamic path information.

           ldd -v a.out
             find library=./libx.so; required by a.out



 Hewlett-Packard Company            - 2 -      HP-UX 11i Version 2: Sep 2004






 ldd_ia(1)                                                         ldd_ia(1)
                        For Itanium(R)-based Systems



               ./libx.so =>    ./libx.so
             find library=libc.so; required by a.out
               libc.so =>       /usr/lib/hpux32/libc.so.1
             find library=libdl.so; required by /usr/lib/hpux32/libc.so.1
               libdl.so =>      /usr/lib/hpux32/libdl.so..1

      The -r option to ldd causes it to analyze all symbol references and
      print information about unsatisfied code and data symbols.

           ldd -r a.out
               ./libx.so =>    ./libx.so
               libc.so =>       /usr/lib/hpux32/libc.so.1
               libdl.so =>      /usr/lib/hpux32/libdl.so.1
               symbol not found: val1 (./libx.so)
               symbol not found: count (./libx.so)
               symbol not found: func1 (./libx.so)

 WARNINGS    [Toc]    [Back]
      ldd does not list shared libraries explicitly loaded using dlopen(3C)
      or shl_load(3X).

 FILES    [Toc]    [Back]
      a.out                           output file

      /usr/lib/hpux32/dld.so          32-bit Itanium(R)-based system dynamic
                                      loader

      /usr/lib/hpux64/dld.so          64-bit Itanium-based system dynamic
                                      loader

      /usr/ccs/lib/hpux32/lddstub     32-bit dummy executable loaded to
                                      check the dependencies of shared
                                      libraries

      /usr/ccs/lib/hpux64/lddstub     64-bit dummy executable loaded to
                                      check the dependencies of shared
                                      libraries

      /usr/lib/nls/$LANG/ldd.cat      message catalog

 SEE ALSO    [Toc]    [Back]
    System Tools
      ld(1)             invoke the link editor

    Miscellaneous    [Toc]    [Back]
      a.out(4)          assembler, compiler, and linker output
      dld.so(5)         dynamic loader

    Texts and Tutorials    [Toc]    [Back]
      HP-UX Linker and Libraries User's Guide


 Hewlett-Packard Company            - 3 -      HP-UX 11i Version 2: Sep 2004