OS Manuals

/usr/bin/llvm-mca

Low-level virtual machine 15 - core frameworks

From llvm-15 15.0.7-r32 (os), captured 2026-11-05 by running llvm-mca --help (exit 0). permalink

OVERVIEW: llvm machine code performance analyzer.

USAGE: llvm-mca [options] <input file>

OPTIONS:

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

Tool Options:

  --dispatch=<uint>                - Override the processor dispatch width
  --instruction-tables             - Print instruction tables
  --iterations=<uint>              - Number of iterations to run
  --json                           - Print the output in json format
  --lqueue=<uint>                  - Size of the load queue
  --march=<string>                 - Target architecture. See -version for available targets
  --mattr=<a1,+a2,-a3,...>         - Target specific attributes (-mattr=help for details)
  --mcpu=<cpu-name>                - Target a specific cpu type (-mcpu=help for details)
  --mtriple=<string>               - Target triple. See -version for available targets
  --noalias                        - If set, assume that loads and stores do not alias
  -o <filename>                    - Output filename
  --output-asm-variant=<int>       - Syntax variant to use for output printing
  --print-imm-hex                  - Prefer hex format when printing immediate values
  --register-file-size=<uint>      - Maximum number of physical registers which can be used for register mappings
  --squeue=<uint>                  - Size of the store queue

View Options:

  --all-stats                      - Print all hardware statistics
  --all-views                      - Print all views including hardware statistics
  --bottleneck-analysis            - Enable bottleneck analysis (disabled by default)
  --disable-cb                     - Disable custom behaviour (use the default class which does nothing).
  --dispatch-stats                 - Print dispatch statistics
  --instruction-info               - Print the instruction info view (enabled by default)
  --register-file-stats            - Print register file statistics
  --resource-pressure              - Print the resource pressure view (enabled by default)
  --retire-stats                   - Print retire control unit statistics
  --scheduler-stats                - Print scheduler statistics
  --show-barriers                  - Print memory barrier information in the instruction info view
  --show-encoding                  - Print encoding information in the instruction info view
  --timeline                       - Print the timeline view
  --timeline-max-cycles=<uint>     - Maximum number of cycles in the timeline view, or 0 for unlimited. Defaults to 80 cycles
  --timeline-max-iterations=<uint> - Maximum number of iterations to print in timeline view
Options (32)
OptionDescriptionSource
--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
--dispatch uint- Override the processor dispatch widthhelp
--instruction-tables- Print instruction tableshelp
--iterations uint- Number of iterations to runhelp
--json- Print the output in json formathelp
--lqueue uint- Size of the load queuehelp
--march string- Target architecture.help
--mattr, -a3 a1- Target specific attributes (-mattr=help for details)help
--mcpu cpu-name- Target a specific cpu type (-mcpu=help for details)help
--mtriple string- Target triple.help
--noalias- If set, assume that loads and stores do not aliashelp
-o filename- Output filenamehelp
--output-asm-variant int- Syntax variant to use for output printinghelp
--print-imm-hex- Prefer hex format when printing immediate valueshelp
--register-file-size uint- Maximum number of physical registers which can be used for register mappingshelp
--squeue uint- Size of the store queuehelp
--all-stats- Print all hardware statisticshelp
--all-views- Print all views including hardware statisticshelp
--bottleneck-analysis- Enable bottleneck analysis (disabled by default)help
--disable-cb- Disable custom behaviour (use the default class which does nothing).help
--dispatch-stats- Print dispatch statisticshelp
--instruction-info- Print the instruction info view (enabled by default)help
--register-file-stats- Print register file statisticshelp
--resource-pressure- Print the resource pressure view (enabled by default)help
--retire-stats- Print retire control unit statisticshelp
--scheduler-stats- Print scheduler statisticshelp
--show-barriers- Print memory barrier information in the instruction info viewhelp
--show-encoding- Print encoding information in the instruction info viewhelp
--timeline- Print the timeline viewhelp
--timeline-max-cycles uint- Maximum number of cycles in the timeline view, or 0 for unlimited.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.