llvm-dsymutil(1) LLVM llvm-dsymutil(1)
NAME
llvm-dsymutil - manipulate archived DWARF debug symbol files.
SYNOPSIS
llvm-dsymutil [options] exe_file
llvm-dsymutil <i>asymbol-map=bcsymbolmap [options] exe_file
DESCRIPTION
llvm-dsymutil links the DWARF debug information found in the object
files for an executable exe_file by using debug symbols information
contained in its symbol table.
OPTIONS
-arch=ARCH
Link DWARF debug information only for specified CPU architecture
types. Architectures may be specified by name. 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 architec-
tures will be linked by default and any architectures that canat
be properly linked will cause llvm-dsymutil to return an error.
-f, --flat
Produce a flat dSYM file. A a.dwarfa extension will be appended
to the executable name unless the output file is specified using
the -o option.
-o path, --out=path
Specifies an alternate path to place the .dSYM bundle. The
default dSYM bundle path is created by appending a.dSYMa to the
executable name.
--oso-prepend-path=dir
Specifies a path to prepend to all debug symbol object file
paths.
-s, --symtab
Dumps the symbol table found in executable or object file(s) and
exits.
-t n, --threads=n
Specifies the maximum number (n) of simultaneous threads to use
when linking multiple architectures.
-v, --version
Display the current version of llvm-dsymutil.
--verbose
Display verbose information when linking.
-u, --update
Update an existing dSYM file to contain the latest accelerator
tables and other DWARF optimizations. This option will rebuild
the a.apple_namesa and a.apple_typesa hashed accelerator tables.
--minimize
When used when creating a dSYM file, this option will suppress
the emission of the a.debug_pubnamesa, and a.debug_pubtypesa
sections since llvm-dsymutil has better equivalents:
a.apple_namesa and a.apple_typesa. When used in conjunction with
aupdate option, this option will cause redundant accelerator
tables to be removed.
--symbol-map=*bcsymbolmap*
Either pass a .bcsymbolmap file or a directory containing the
collection of .bcsymbolmap files for the different versions or
architectures of your binary to unobfuscate the passed exe_file.
Implies -u.
--dump-debug-map
Dump the executable debug-map (the list of the object files con-
taining the debug information) in YAML format and exit.
-y Treat exe_file as a YAML debug-map rather than an executable.
AUTHOR
Maintained by The LLVM Team (http://llvm.org/).
COPYRIGHT
2003-2017, LLVM Project
Apple LLVM 9.0.0 2017-09-19 llvm-dsymutil(1)
Mac OS X 10.12.6 - Generated Sun Oct 29 10:40:59 CDT 2017