This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

This manual page is associated with the Mac OS X developer tools. The software or headers described may not be present on your Mac OS X installation until you install the developer tools package. This package is available on your Mac OS X installation DVD, and the latest versions can be downloaded from developer.apple.com.

For more information about the manual page format, see the manual page for manpages(5).

dsymutil(1)               BSD General Commands Manual              dsymutil(1)

NAME
     dsymutil -- manipulate archived DWARF debug symbol files.

SYNOPSIS
     dsymutil [--arch=ARCH] [--out=path] exe_path

DESCRIPTION
     dsymutil links the DWARF debug information found in the object files for an executable exe_path by
     using debug map information contained in its symbol table.

     A list of flags and their descriptions:

     --arch=ARCH
              Link DWARF debug information only for specified CPU architecture types.  Architectures may be
              specified by name or by number.  When using this option, an error will be returned if any
              architectures can not be properly linked.  This option can be specified multiple times, once
              for each desired architecture.  All cpu architectures will be linked by default and any archi-tectures architectures
              tectures that can't be properly linked will not cause dsymutil to return an error as long as
              at least one architecture was able to link successfully.

     -h, --help
              Display the help documentation for this command.

     -o path, --out=path
              Specifies an alternate path to place the .dSYM bundle. The default dSYM bundle path is created
              by appending '.dSYM' to the executable name.

     --oso-prepend-path=path
              Specifies a path to prepend to all debug map object file paths.

     -s, --symtab
              Dumps the symbol table found in executable or object file(s) and exits.

     -v, --version
              Display the current version and build date of the dsymutil binary.

     --verbose
              Display verbose information when linking.

SEE ALSO
     dwarfdump(1)

Darwin                           April 2, 2008                          Darwin