OS Manuals

/usr/bin/llvm-gsymutil

Low-level virtual machine 23 - core frameworks

From llvm-23 23.1.5-r0 (os), captured 2026-11-05 by running llvm-gsymutil --help (exit 0). permalink

Also provided by 9 other package versions
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
  --output-version=<value>
                         Set the GSYM output version (1 or 2). Default: 1.
  -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
  --symtab-file=<value>  Specify a separate file to read the symbol table from during GSYM conversion.
                         Use when the symbol table and debug info are in separate files.
                         Matching architectures are selected automatically for universal binaries
  --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 (19)
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
--output-version valueSet the GSYM output version (1 or 2).help
-o valueAlias for --out-filehelp
--quietDo not output warnings about the debug informationhelp
--symtab-file valueSpecify a separate file to read the symbol table from during GSYM conversion.help
--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.