OS Manuals

/usr/lib/llvm-15/bin/llvm-gsymutil

Low-level virtual machine 15 - core frameworks

From llvm-15 15.0.7-r32 (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:

Conversion Options:

  --arch=<arch>          - 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=<path>       - 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.
  --num-threads=<n>      - 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=<path>      - 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.
  --quiet                - Do not output warnings about the debug information
  --verify               - Verify the generated GSYM file against the information in the file that was converted.

Generic Options:

  --help                 - Display available options (--help-hidden for more)
  --help-list            - Display list of available options (--help-list-hidden for more)
  --version              - Display the version of this program

Lookup Options:

  --address=<addr>       - 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>

Options:

  --verbose              - Enable verbose logging and encoding details.
Options (11)
OptionDescriptionSource
--arch arch- Process debug information for the specified CPU architecture only.help
--convert path- Convert the specified file to the GSYM format.help
--num-threads n- Specify the maximum number (n) of simultaneous threads to use when converting files to GSYM.help
--out-file path- Specify the path where the converted GSYM file will be saved.help
--quiet- Do not output warnings about the debug informationhelp
--verify- Verify the generated GSYM file against the information in the file that was converted.help
--help- Display available options (--help-hidden for more)help
--help-list- Display list of available options (--help-list-hidden for more)help
--version- Display the version of this programhelp
--address addr- Lookup an address in a GSYM filehelp
--verbose- Enable verbose logging and encoding details.help

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