OS Manuals

/usr/bin/llvm-gsymutil

Low-level virtual machine 21 - core frameworks

From llvm-21 21.1.8-r17 (os), captured 2026-11-05 by running llvm-gsymutil --help (exit 0). permalink

OVERVIEW: A tool for dumping, searching and creating GSYM files.

Specify one or more GSYM paths as arguments to dump all of the information in each GSYM file.
Specify a single GSYM file along with one or more --lookup options to lookup addresses within that GSYM file.
Use the --convert option to specify a file with option --out-file option to convert to GSYM format.


USAGE: llvm-gsymutil [options] <input GSYM files>

OPTIONS:
  --address=<value>      Lookup an address in a GSYM file
  --addresses-from-stdin Lookup addresses in a GSYM file that are read from stdin
                         Each input line is expected to be of the following format: <addr> <gsym-path>
  --arch=<value>         Process debug information for the specified CPU architecture only.
                         Architectures may be specified by name or by number.
                         This option can be specified multiple times, once for each desired architecture
  --convert=<value>      Convert the specified file to the GSYM format.
                         Supported files include ELF and mach-o files that will have their debug info (DWARF) and symbol table converted
  --dwarf-callsites      Load call site info from DWARF, if available
  --help                 Display this help
  -h                     Alias for --help
  --json-summary-file=<value>
                         Output a categorized summary of errors into the JSON file specified.
  --merged-functions-filter=<value>
                         When used with --address/--addresses-from-stdin and --merged-functions,
                         filters the merged functions output to only show functions matching any of the specified regex patterns.
                         Can be specified multiple times.
  --merged-functions     When used with --convert, encodes merged function information for functions in debug info that have matching address ranges.
                         Without this option one function per unique address range will be emitted.
                         When used with --address/--addresses-from-stdin, all merged functions for a particular address will be displayed.
                         Without this option only one function will be displayed.
  --num-threads=<value>  Specify the maximum number (n) of simultaneous threads to use when converting files to GSYM.
                         Defaults to the number of cores on the current machine
  --out-file=<value>     Specify the path where the converted GSYM file will be saved.
                         When not specified, a '.gsym' extension will be appended to the file name specified in the --convert option
  -o <value>             Alias for --out-file
  --quiet                Do not output warnings about the debug information
  --segment-size=<value> Specify the size in bytes of the size the final GSYM file should be segmented into. This allows GSYM files to be split across multiple files
  --verbose              Enable verbose logging and encoding details
  --verify               Verify the generated GSYM file against the information in the file that was converted
  --version              Display the version
  -v                     Alias for --version
Options (17)
OptionDescriptionSource
--address valueLookup an address in a GSYM filehelp
--arch valueProcess debug information for the specified CPU architecture only.help
--convert valueConvert the specified file to the GSYM format.help
--dwarf-callsitesLoad call site info from DWARF, if availablehelp
--helpDisplay this helphelp
-hAlias for --helphelp
--json-summary-file valueOutput a categorized summary of errors into the JSON file specified.help
--merged-functions-filter valueWhen used with --address/--addresses-from-stdin and --merged-functions, filters the merged functions output to only show functions matching any of the specified regex patterns.help
--merged-functionsWhen used with --convert, encodes merged function information for functions in debug info that have matching address ranges.help
--num-threads valueSpecify the maximum number (n) of simultaneous threads to use when converting files to GSYM.help
--out-file valueSpecify the path where the converted GSYM file will be saved.help
-o valueAlias for --out-filehelp
--quietDo not output warnings about the debug informationhelp
--verboseEnable verbose logging and encoding detailshelp
--verifyVerify the generated GSYM file against the information in the file that was convertedhelp
--versionDisplay the versionhelp
-vAlias for --versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.