OS Manuals

/usr/bin/llvm-mca

Low-level virtual machine 23 - core frameworks

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

Also provided by 9 other package versions
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
  --instruction-tables=<value>            - Print instruction tables
    =none                                 -   Do not print instruction tables
    =normal                               -   Print instruction tables
    =full                                 -   Print instruction tables with additional information: bypass latency, LLVM opcode, used resources
  --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).
  --disable-im                            - Disable instrumentation manager (use the default class which ignores instruments.).
  --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
  --skip-unsupported-instructions=<value> - Force analysis to continue in the presence of unsupported instructions
    =none                                 -   Exit with an error when an instruction is unsupported for any reason (default)
    =lack-sched                           -   Skip instructions on input which lack scheduling information
    =parse-failure                        -   Skip lines on the input which fail to parse for any reason
    =any                                  -   Skip instructions or lines on input which are unsupported for any reason
  --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 (34)
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
--disable-im- Disable instrumentation manager (use the default class which ignores instruments.).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
--timeline-max-iterations uint- Maximum number of iterations to print in timeline viewhelp

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