| dsymutil - manipulate archived DWARF debug symbol files | |
| ======================================================= | |
| SYNOPSIS | |
| -------- | |
| | :program:`dsymutil` [*options*] *executable* | |
| DESCRIPTION | |
| ----------- | |
| :program:`dsymutil` links the DWARF debug information found in the object files | |
| for an executable *executable* by using debug symbols information contained in | |
| its symbol table. By default, the linked debug information is placed in a | |
| ``.dSYM`` bundle with the same name as the executable. | |
| OPTIONS | |
| ------- | |
| .. option:: --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 | |
| architectures will be linked by default and any architectures that can't be | |
| properly linked will cause :program:`dsymutil` to return an error. | |
| .. option:: --dump-debug-map | |
| Dump the *executable*'s debug-map (the list of the object files containing the | |
| debug information) in YAML format and exit. Not DWARF link will take place. | |
| .. option:: -f, --flat | |
| Produce a flat dSYM file. A ``.dwarf`` extension will be appended to the | |
| executable name unless the output file is specified using the -o option. | |
| .. option:: -z, --minimize | |
| When used when creating a dSYM file, this option will suppress the emission of | |
| the .debug_inlines, .debug_pubnames, and .debug_pubtypes sections since | |
| dsymutil currently has better equivalents: .apple_names and .apple_types. When | |
| used in conjunction with --update option, this option will cause redundant | |
| accelerator tables to be removed. | |
| .. option:: --no-odr | |
| Do not use ODR (One Definition Rule) for uniquing C++ types. | |
| .. option:: --no-output | |
| Do the link in memory, but do not emit the result file. | |
| .. option:: --no-swiftmodule-timestamp | |
| Don't check the timestamp for swiftmodule files. | |
| .. option:: -j <n>, --num-threads=<n> | |
| Specifies the maximum number (``n``) of simultaneous threads to use when | |
| linking multiple architectures. | |
| .. option:: -o <filename> | |
| Specifies an alternate ``path`` to place the dSYM bundle. The default dSYM | |
| bundle path is created by appending ``.dSYM`` to the executable name. | |
| .. option:: --oso-prepend-path=<path> | |
| Specifies a ``path`` to prepend to all debug symbol object file paths. | |
| .. option:: --papertrail | |
| When running dsymutil as part of your build system, it can be desirable for | |
| warnings to be part of the end product, rather than just being emitted to the | |
| output stream. When enabled warnings are embedded in the linked DWARF debug | |
| information. | |
| .. option:: -s, --symtab | |
| Dumps the symbol table found in *executable* or object file(s) and exits. | |
| .. option:: --toolchain | |
| Embed the toolchain in the dSYM bundle's property list. | |
| .. option:: -u, --update | |
| Update an existing dSYM file to contain the latest accelerator tables and | |
| other DWARF optimizations. This option will rebuild the '.apple_names' and | |
| '.apple_types' hashed accelerator tables. | |
| .. option:: -v, --verbose | |
| Display verbose information when linking. | |
| .. option:: --version | |
| Display the version of the tool. | |
| .. option:: -y | |
| Treat *executable* as a YAML debug-map rather than an executable. | |
| EXIT STATUS | |
| ----------- | |
| :program:`dsymutil` returns 0 if the DWARF debug information was linked | |
| successfully. Otherwise, it returns 1. | |
| SEE ALSO | |
| -------- | |
| :manpage:`llvm-dwarfdump(1)` |