/usr/bin/dsymutil

OVERVIEW: manipulate archived DWARF debug symbol files.

dsymutil links the DWARF debug information found in the object files
for the executable <input file> by using debug symbols information
contained in its symbol table.


USAGE: /usr/bin/dsymutil [options] <input files>

Dsymutil Options:
  --accelerator <accelerator type>
                          Specify the desired type of accelerator table. Valid options are 'Apple' (.apple_names, .apple_namespaces, .apple_types, .apple_objc), 'Dwarf' (.debug_names), 'Pub' (.debug_pubnames, .debug_pubtypes), 'Default' and 'None'
  --allow-section-header-offset-overflow
                          Allow emitting a 32-bit section offset that, when applied, may exceed the Mach-O 4 GB limit. This leverages the fact that the offset can be computed as a 64-bit value when sections are ordered (which is always the case for dsymutil). Note that this produces an invalid Mach-O and requires explicit support from the tools that consume it.
  --arch <arch>           Link DWARF debug information only for specified CPU architecture types. This option can be specified multiple times, once for each desired architecture. All CPU architectures will be linked by default.
  --build-variant-suffix <suffix=buildvariant>
                          Specify the build variant suffix used to build the executable file.
  --dump-debug-map        Parse and dump the debug map to standard output. No DWARF link will take place.
  -D <path>               Specify a directory that contain dSYM files to search for.
  --fat64                 Use a 64-bit header when emitting universal binaries.
  --flat                  Produce a flat dSYM file (not a bundle). Intended for testing and generally unsupported by tools that consume dSYMs.
  -f                      Alias for --flat
  --gen-reproducer        Generate a reproducer consisting of the input object files. Alias for --reproducer=GenerateOnExit.
  --help                  Prints this help output.
  -h                      Alias for --help
  --include-swiftmodules-from-interface
                          Whether or not to copy binary swiftmodules built from textual .swiftinterface files into the dSYM bundle. These typically come only from the SDK (since textual interfaces require library evolution) and thus are a waste of space to copy into the bundle. Turn this on if the swiftmodules are different from those in the SDK.
  -j <threads>            Alias for --num-threads
  --keep-function-for-static
                          Make a static variable keep the enclosing function even if it would have been omitted otherwise.
  --linker <DWARF linker type>
                          Specify the desired type of DWARF linker. Defaults to 'classic'
  --no-object-timestamp   Don't check timestamp for object files.
  --no-odr                Do not use ODR (One Definition Rule) for type uniquing.
  --no-output             Do the link in memory, but do not emit the result file.
  --no-swiftmodule-timestamp
                          Don't check timestamp for swiftmodule files.
  --num-threads <threads> Specifies the maximum number of simultaneous threads to use when linking multiple architectures.
  --object-prefix-map <prefix=remapped>
                          Remap object file paths (but no source paths) before processing. Use this for Clang objects where the module cache location was remapped using -fdebug-prefix-map; to help dsymutil find the Clang module cache.
  --oso-prepend-path <path>
                          Specify a directory to prepend to the paths of object files.
  --out <filename>        Alias for -o
  -o <filename>           Specify the output file. Defaults to <input file>.dwarf
  --quiet                 Enable quiet mode.
  -q                      Alias for --quiet
  --remarks-drop-without-debug
                          Drop remarks without valid debug locations. Without this flags, all remarks are kept.
  --remarks-output-format <format>
                          Specify the format to be used when serializing the linked remarks.
  --remarks-prepend-path <path>
                          Specify a directory to prepend to the paths of the external remark files.
  --reproducer <mode>     Specify the reproducer generation mode. Valid options are 'GenerateOnExit', 'GenerateOnCrash', 'Off'.
  --statistics            Print statistics about the contribution of each object file to the linked debug info. This prints a table after linking with the object file name, the size of the debug info in the object file (in bytes) and the size contributed (in bytes) to the linked dSYM. The table is sorted by the output size listing the object files with the largest contribution first.
  --symtab                Dumps the symbol table found in executable or object file(s) and exits.
  -S                      Output textual assembly instead of a binary dSYM companion file.
  -s                      Alias for --symtab
  --toolchain <toolchain> Embed toolchain information in dSYM bundle.
  --update                Updates existing dSYM files to contain the latest accelerator tables and other DWARF optimizations.
  --use-reproducer <path> Use the object files from the given reproducer path.
  -u                      Alias for --update
  --verbose               Enable verbose mode.
  --verify-dwarf <verification mode>
                          Run the DWARF verifier on the input and/or output. Valid options are 'none, 'input', 'output', 'all' or 'auto' which runs the output verifier only if input verification passed.
  --verify                Alias for --verify-dwarf=output
  --version               Prints the dsymutil version.
  -v                      Alias for --version
  -y                      Treat the input file is a YAML debug map rather than a binary.