OVERVIEW: llvm system compiler
USAGE: llc [options]
OPTIONS:
Color Options:
--color - Use colors in output (default=autodetect)
DXContainer Options:
--compress-srci= - Choose SCRI part compression:
=none - No compression
=zlib - Use zlib
General options:
-I - include search path
-M - InstPrinter options
-O - Optimization level. [-O0, -O1, -O2, or -O3] (default = '-O2')
--abort-on-max-devirt-iterations-reached - Abort when the max iterations for devirtualization CGSCC repeat pass is reached
--addrsig - Emit an address-significance table
--align-loops= - Default alignment for loops
--allow-ginsert-as-artifact - Allow G_INSERT to be considered an artifact. Hack around AMDGPU test infinite loops.
--arc-contract-use-objc-claim-rv - Enable generation of calls to objc_claimAutoreleasedReturnValue
--asm-show-inst - Emit internal instruction representation to assembly file
--asm-verbose - Add comments to directives.
--atomic-counter-update-promoted - Do counter update using atomic fetch add for promoted counters only
--atomic-first-counter - Use atomic fetch add for first counter in a function (usually the entry counter)
--basic-block-address-map - Emit the basic block address map section
--basic-block-section-match-infer - Enable matching and inference when generating basic block sections
--basic-block-sections= | labels | none> - Emit basic blocks into separate sections
--bounds-checking-single-trap - Use one trap block per function
--bpf-stack-size= - Specify the BPF stack size limit
--call-graph-section - Emit a call graph section
--cfg-hide-cold-paths= - Hide blocks with relative frequency below the given value
--cfg-hide-deoptimize-paths -
--cfg-hide-unreachable-paths -
--check-functions-filter= - Only emit checks for arguments of functions whose names match the given regular expression
--code-model= - Choose code model
=tiny - Tiny code model
=small - Small code model
=kernel - Kernel code model
=medium - Medium code model
=large - Large code model
--conditional-counter-update - Do conditional counter updates in single byte counters mode)
--cost-kind= - Target cost kind
=throughput - Reciprocal throughput
=latency - Instruction latency
=code-size - Code size
=size-latency - Code size and latency
=all - Print all cost kinds
--crel - Use CREL relocation format for ELF
--ctx-profile-force-is-specialized - Treat the given module as-if it were containing the post-thinlink module containing the root
--data-sections - Emit data into separate sections
--debug-entry-values - Enable debug info for the debug entry values.
--debugger-tune= - Tune debug info for a particular debugger
=gdb - gdb
=lldb - lldb
=dbx - dbx
=sce - SCE targets (e.g. PS4)
--debugify-atoms -
--debugify-func-limit= - Set max number of processed functions per pass.
--debugify-level= - Kind of debug info to add
=locations - Locations only
=location+variables - Locations and Variables
--debugify-quiet - Suppress verbose debugify output
--denormal-fp-math= - Select which denormal numbers the code is permitted to require
=ieee - IEEE 754 denormal numbers
=preserve-sign - the sign of a flushed-to-zero number is preserved in the sign of 0
=positive-zero - denormals are flushed to positive zero
=dynamic - denormals have unknown treatment
--denormal-fp-math-f32= - Select which denormal numbers the code is permitted to require for float
=ieee - IEEE 754 denormal numbers
=preserve-sign - the sign of a flushed-to-zero number is preserved in the sign of 0
=positive-zero - denormals are flushed to positive zero
=dynamic - denormals have unknown treatment
--devirtualize-speculatively - Enable speculative devirtualization optimization
--disable-auto-upgrade-debug-info - Disable autoupgrade of debug info
--disable-i2p-p2i-opt - Disables inttoptr/ptrtoint roundtrip optimization
--disable-simplify-libcalls - Disable simplify-libcalls
--disable-tail-calls - Never emit tail calls
--do-counter-promotion - Do counter register promotion
--dot-cfg-mssa= - file name for generated dot file
--dwarf-version= - Dwarf version
--dwarf64 - Generate debugging info in the 64-bit DWARF format
--dx-embed-debug - Embed PDB in shader container
--elide-all-zero-branch-weights -
--emit-bb-hash - Emit the hash of basic block in the SHT_LLVM_BB_ADDR_MAP section.
--emit-call-site-info - Emit call site debug information, if debug information is enabled.
--emit-compact-unwind-non-canonical - Whether to try to emit Compact Unwind for non canonical entries.
--emit-dwarf-unwind= - Whether to emit DWARF EH frame entries.
=always - Always emit EH frame entries
=no-compact-unwind - Only emit EH frame entries when compact unwind is not available
=dwarf-only - Force compact unwind to reference DWARF
=default - Use target platform default
--emulated-tls - Use emulated TLS model
--enable-cse-in-irtranslator - Should enable CSE in irtranslator
--enable-cse-in-legalizer - Should enable CSE in Legalizer
--enable-devirtualize-speculatively - Enable speculative devirtualization optimization
--enable-gvn-hoist - Enable the GVN hoisting pass (default = off)
--enable-gvn-memdep -
--enable-gvn-memoryssa -
--enable-gvn-sink - Enable the GVN sinking pass (default = off)
--enable-jmc-instrument - Instrument functions with a call to __CheckForDebuggerJustMyCode
--enable-jump-table-to-switch - Enable JumpTableToSwitch pass (default = true)
--enable-load-in-loop-pre -
--enable-load-pre -
--enable-loop-simplifycfg-term-folding -
--enable-name-compression - Enable name/filename string compression
--enable-new-pm - Enable the new pass manager
--enable-no-trapping-fp-math - Enable setting the FP exceptions build attribute not to use exceptions
--enable-poison-reuse-guard - Enable poison-reuse guard
--enable-split-backedge-in-load-pre -
--enable-split-loopiv-heuristic - Enable loop iv regalloc heuristic
--enable-tlsdesc - Enable the use of TLS Descriptors
--enable-vtable-profile-use - If ThinLTO and WPD is enabled and this option is true, vtable profiles will be used by ICP pass for more efficient indirect call sequence. If false, type profiles won't be used.
--enable-vtable-value-profiling - If true, the virtual table address will be instrumented to know the types of a C++ pointer. The information is used in indirect call promotion to do selective vtable-based comparison.
--exception-model= - exception model
=default - default exception handling model
=dwarf - DWARF-like CFI based exception handling
=sjlj - SjLj exception handling
=arm - ARM EHABI exceptions
=wineh - Windows exception model
=wasm - WebAssembly exception handling
--expand-variadics-override= - Override the behaviour of expand-variadics
=unspecified - Use the implementation defaults
=disable - Disable the pass entirely
=optimize - Optimise without changing ABI
=lowering - Change variadic calling convention
--experimental-debug-variable-locations - Use experimental new value-tracking variable locations
--fatal-warnings - Treat warnings as errors
--fdpic - Use the FDPIC ABI
--filetype= - Choose a file type (not all types are supported by all targets):
=asm - Emit an assembly ('.s') file
=obj - Emit a native object ('.o') file
=null - Emit nothing, for performance testing
--float-abi= - Choose float ABI type
=default - Target default float ABI type
=soft - Soft float ABI (implied by -soft-float)
=hard - Hard float ABI (uses FP registers)
--force-dwarf-frame-section - Always emit a debug frame section.
--force-tail-folding-style= - Force the tail folding style
=none - Disable tail folding
=data - Create lane mask for data only, using active.lane.mask intrinsic
=data-without-lane-mask - Create lane mask with compare/stepvector
=data-and-control - Create lane mask using active.lane.mask intrinsic, and use it for both data and control flow
=data-with-evl - Use predicated EVL instructions for tail folding. If EVL is unsupported, fallback to data-without-lane-mask.
--fp-contract= - Enable aggressive formation of fused FP ops
=fast - Fuse FP ops whenever profitable
=on - Only fuse 'blessed' FP ops.
=off - Only fuse FP ops when the result won't be affected.
--frame-pointer= - Specify frame pointer elimination optimization
=all - Disable frame pointer elimination
=non-leaf - Disable frame pointer elimination for non-leaf frame but reserve the register in leaf functions
=non-leaf-no-reserve - Disable frame pointer elimination for non-leaf frame
=reserved - Enable frame pointer elimination, but reserve the frame pointer register
=none - Enable frame pointer elimination
--fs-profile-debug-bw-threshold= - Only show debug message if the source branch weight is greater than this value.
--fs-profile-debug-prob-diff-threshold= - Only show debug message if the branch probability is greater than this value (in percentage).
--function-sections - Emit functions into separate sections
--generate-merged-base-profiles - When generating nested context-sensitive profiles, always generate extra base profile for function with all its context profiles merged into it.
--gsframe - Whether to emit .sframe unwind sections.
--hash-based-counter-split - Rename counter variable of a comdat function based on cfg hash
--hot-cold-split - Enable hot-cold splitting pass
--hwasan-percentile-cutoff-hot= - Hot percentile cutoff.
--hwasan-random-rate= - Probability value in the range [0.0, 1.0] to keep instrumentation of a function. Note: instrumentation can be skipped randomly OR because of the hot percentile cutoff, if both are supplied.
--ignore-xcoff-visibility - Not emit the visibility attribute for asm in AIX OS or give all symbols 'unspecified' visibility in XCOFF object file
--implicit-mapsyms - Allow mapping symbol at section beginning to be implicit, lowering number of mapping symbols at the expense of some portability. Recommended for projects that can build all their object files using this option
--import-all-index - Import all external functions in index.
--incremental-linker-compatible - When used with filetype=obj, emit an object file which can be used with an incremental linker
--instcombine-code-sinking - Enable code sinking
--instcombine-guard-widening-window= - How wide an instruction window to bypass looking for another guard
--instcombine-max-num-phis= - Maximum number phis to handle in intptr/ptrint folding
--instcombine-max-sink-users= - Maximum number of undroppable users for instruction sinking
--instcombine-maxarray-size= - Maximum array size considered when doing a combine
--instcombine-negator-enabled - Should we attempt to sink negations?
--instcombine-negator-max-depth= - What is the maximal lookup depth when trying to check for viability of negation sinking.
--instrprof-atomic-counter-update-all - Make all profile counter updates atomic (for testing only)
--instrumentor-read-config-files= - Read the instrumentor configuration from the specified JSON files (comma separated)
--instrumentor-read-config-paths-file= - Read the instrumentor configuration file paths from the specified file (newline separated)
--instrumentor-write-config-file= - Write the instrumentor configuration into the specified JSON file
--internalize-public-api-file= - A file containing list of symbol names to preserve
--internalize-public-api-list= - A list of symbol names to preserve
--intrinsic-cost-strategy= - Costing strategy for intrinsic instructions
=instruction-cost - Use TargetTransformInfo::getInstructionCost
=intrinsic-cost - Use TargetTransformInfo::getIntrinsicInstrCost
=type-based-intrinsic-cost - Calculate the intrinsic cost based only on argument types
--iterative-counter-promotion - Allow counter promotion across the whole loop nest.
--large-data-threshold= - Choose large data threshold for x86_64 medium code model
--large-eh-encoding - Force 8-byte (sdata8) pointer encodings for ELF exception-handling sections to avoid relocation overflows in large binaries (x86_64: FDE/personality/LSDA/TType; AArch64/PPC64: FDE only, the rest are already sdata8)
--load= - Load the specified plugin
--load-pass-plugin= - Load plugin library
--lower-allow-check-percentile-cutoff-hot= - Hot percentile cutoff.
--lower-allow-check-random-rate= - Probability value in the range [0.0, 1.0] of unconditional pseudo-random checks.
--march= - Architecture to generate code for (see --version)
--matrix-default-layout= - Sets the default matrix layout
=column-major - Use column-major layout
=row-major - Use row-major layout
--matrix-print-after-transpose-opt -
--mattr= - Target specific attributes (-mattr=help for details)
--max-counter-promotions= - Max number of allowed counter promotions
--max-counter-promotions-per-loop= - Max number counter promotions per loop to avoid increasing register pressure too much
--mc-relax-all - When used with filetype=obj, relax all fixups in the emitted object file
--mcpu= - Target a specific cpu type (-mcpu=help for details)
--meabi= - Set EABI type (default depends on triple):
=default - Triple default EABI version
=4 - EABI version 4
=5 - EABI version 5
=gnu - EABI GNU
--mir-strip-debugify-only - Should mir-strip-debug only strip debug info from debugified modules by default
--misexpect-tolerance= - Prevents emitting diagnostics when profile counts are within N% of the threshold..
--ms-secure-hotpatch-functions-file= - A file containing list of mangled function names to mark for Windows Secure Hot-Patching
--ms-secure-hotpatch-functions-list= - A list of mangled function names to mark for Windows Secure Hot-Patching
--mtriple= - Override target triple for module
--mtune= - Tune for a specific CPU microarchitecture (-mtune=help for details)
--mxcoff-roptr - When set to true, const objects with relocatable address values are put into the RO data section.
--no-deprecated-warn - Suppress all deprecated warnings
--no-discriminators - Disable generation of discriminator information.
--no-integrated-as - Disable integrated assembler
--no-type-check - Suppress type errors (Wasm)
--no-warn - Suppress all warnings
--nozero-initialized-in-bss - Don't place zero-initialized symbols into bss section
-o - Output filename
--object-size-offset-visitor-max-visit-instructions= - Maximum number of instructions for ObjectSizeOffsetVisitor to look at
--offload-pgo-sampling= - Log2 of the sampling period for offload PGO instrumentation. Only 1 in every 2^N blocks is instrumented. 0 = all blocks, 1 = 50%, 2 = 25%, 3 = 12.5% (default). Higher values reduce overhead at the cost of sparser profiles.
--output-asm-variant= - Syntax variant to use for output printing
--partition-static-data-sections - Partition data sections using profile information.
--pass-remarks-filter= - Only record optimization remarks from passes whose names match the given regular expression
--pass-remarks-format= - The format used for serializing remarks (default: YAML)
--pass-remarks-output= - Output filename for pass remarks
--passes= - A textual description of the pass pipeline. To have analysis passes available before a certain pass, add 'require'.
--pgo-block-coverage - Use this option to enable basic block coverage instrumentation
--pgo-temporal-instrumentation - Use this option to enable temporal instrumentation
--pgo-view-block-coverage-graph - Create a dot file of CFGs with block coverage inference information
--print-pipeline-passes= - Print string describing the pipeline (best-effort only).
- =text Print a '-passes' compatible string describing the pipeline.
- =tree Print a tree-like structure describing the pipeline.
--profcheck-annotate-select - Also inject (if missing) and verify MD_prof for `select` instructions
--profcheck-default-function-entry-count= -
--profcheck-default-select-false-weight= - When annotating `select` instructions, this value will be used for the second ('false') case.
--profcheck-default-select-true-weight= - When annotating `select` instructions, this value will be used for the first ('true') case.
--profcheck-weights-for-test - Generate weights with small values for tests.
--profile-correlate= - Use debug info or binary file to correlate profiles.
= - No profile correlation
=debug-info - Use debug info to correlate
=binary - Use binary to correlate
--propeller-infer-threshold= - Threshold for infer stale profile
--reloc-section-sym= - Control section symbol conversion for relocations
=all - Use section symbols for all eligible local symbols
=internal - Only use section symbols for internal local symbols
=none - Never use section symbols
--relocation-model= - Choose relocation model
=static - Non-relocatable code
=pic - Fully relocatable, position independent code
=dynamic-no-pic - Relocatable external references, non-relocatable code
=ropi - Code and read-only data relocatable, accessed PC-relative
=rwpi - Read-write data relocatable, accessed relative to static base
=ropi-rwpi - Combination of ropi and rwpi
--run-pass= - Run compiler only for specified passes (comma separated list)
--runtime-counter-relocation - Enable relocating counters at runtime.
--safepoint-ir-verifier-print-only -
--sample-profile-check-record-coverage= - Emit a warning if less than N% of records in the input profile are matched to the IR.
--sample-profile-check-sample-coverage= - Emit a warning if less than N% of samples in the input profile are matched to the IR.
--sample-profile-max-propagate-iterations= - Maximum number of iterations to go through when propagating sample block/edge weights through the CFG.
--sampled-instr-burst-duration= - Set the profile instrumentation burst duration, which can range from 1 to the value of 'sampled-instr-period' (0 is invalid). This number of samples will be recorded for each 'sampled-instr-period' count update. Setting to 1 enables simple sampling, in which case it is recommended to set 'sampled-instr-period' to a prime number.
--sampled-instr-period= - Set the profile instrumentation sample period. A sample period of 0 is invalid. For each sample period, a fixed number of consecutive samples will be recorded. The number is controlled by 'sampled-instr-burst-duration' flag. The default sample period of 65536 is optimized for generating efficient code that leverages unsigned short integer wrapping in overflow, but this is disabled under simple sampling (burst duration = 1).
--sampled-instrumentation - Do PGO instrumentation sampling
--save-stats - Save LLVM statistics to a file in the current directory(`-save-stats`/`-save-stats=cwd`) or the directory of the outputfile (`-save-stats=obj`). (default: cwd)
--save-stats= - Save LLVM statistics to a file in the current directory(`-save-stats`/`-save-stats=cwd`) or the directory of the outputfile (`-save-stats=obj`). (default: cwd)
=cwd - Save to the current working directory
=obj - Save to the output file directory
--save-temp-labels - Don't discard temporary labels
--separate-named-sections - Use separate unique sections for named sections
--skip-ret-exit-block - Suppress counter promotion if exit blocks contain ret.
--speculative-counter-promotion-max-exiting= - The max number of exiting blocks of a loop to allow speculative counter promotion
--speculative-counter-promotion-to-loop - When the option is false, if the target block is in a loop, the promotion will be disallowed unless the promoted counter update can be further/iteratively promoted into an acyclic region.
--split-dwarf-file= - Specify the name of the .dwo file to encode in the DWARF output
--split-dwarf-output= - .dwo output filename
--split-machine-functions - Split out cold basic blocks from machine functions based on profile information
--stack-size-section - Emit a section containing stack size metadata
--stack-symbol-ordering - Order local stack symbols.
--stackrealign - Force align the stack to the minimum alignment
--strict-dwarf - use strict dwarf
--summary-file= - The summary file to use for function importing.
--swift-async-fp= - Determine when the Swift async frame pointer should be set
=auto - Determine based on deployment target
=always - Always set the bit
=never - Never set the bit
--tailcallopt - Turn fastcc calls into tail calls by (potentially) changing ABI.
--target-abi= - The name of the ABI to be targeted from the backend.
--thread-model= - Choose threading model
=posix - POSIX thread model
=single - Single thread model
--time-trace - Record time trace
--time-trace-file= - Specify time trace file destination
--tls-size= - Bit size of immediate TLS offsets
--unique-basic-block-section-names - Give unique names to every basic block section
--unique-section-names - Give unique names to every section
--use-ctors - Use .ctors instead of .init_array.
--vec-extabi - Enable the AIX Extended Altivec ABI.
--verify-atomic-counter-promoted - Check that all profile counter updates were made atomic; no-op if atomic updates are not requested (-fprofile-update=atomic)
--verify-each - Verify after each transform
--verify-region-info - Verify region info (time consuming)
--vp-counters-per-site= - The average number of profile counters allocated per value profiling site.
--vp-static-alloc - Do static counter allocation for value profiler
-x - Input language ('ir' or 'mir')
--x86-relax-relocations - Emit GOTPCRELX/REX_GOTPCRELX/CODE_4_GOTPCRELX instead of GOTPCREL on x86-64 ELF
--x86-sse2avx - Specify that the assembler should encode SSE instructions with VEX prefix
--xcoff-traceback-table - Emit the XCOFF traceback table
--xray-function-index - Emit xray_fn_idx section
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
IR2Vec Options:
--ir2vec-arg-weight= - Weight for argument embeddings
--ir2vec-kind= - IR2Vec embedding kind
=symbolic - Generate symbolic embeddings
=flow-aware - Generate flow-aware embeddings
--ir2vec-opc-weight= - Weight for opcode embeddings
--ir2vec-type-weight= - Weight for type embeddings
--ir2vec-vocab-path= - Path to the vocabulary file for IR2Vec
MIR2Vec Options:
--mir2vec-common-operand-weight= - Weight for common operand embeddings
--mir2vec-kind= - MIR2Vec embedding kind
=symbolic - Generate symbolic embeddings for MIR
--mir2vec-opc-weight= - Weight for machine opcode embeddings
--mir2vec-print-all-vocab-entries - Print all vocabulary entries including zero embeddings
--mir2vec-reg-operand-weight= - Weight for register operand embeddings
--mir2vec-vocab-path= - Path to the vocabulary file for MIR2Vec