OS Manuals

/usr/lib/llvm-18/bin/llvm-gsymutil

Low-level virtual machine 18 - core frameworks

From llvm-18 18.1.8-r30 (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
  --help                 Display this help
  -h                     Alias for --help
  --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 (13)
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
--helpDisplay this helphelp
-hAlias for --helphelp
--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.