llvm-mc-9 (1) Linux Manual Page
NAME
llvm-mc – manual page for llvm-mc 9
DESCRIPTION
OVERVIEW: llvm machine code playground
USAGE: llvm-mc [options] <input file>
OPTIONS:
Color Options:
-
–color– Use colors in output (default=autodetect)
-
-I=<directory> – Directory of include files–aarch64-neon-syntax=<value> – Choose style of NEON code to emit from AArch64 backend:- =generic
- – Emit generic NEON assembly
- =apple
- – Emit Apple-style NEON assembly
-
–amdgpu-disable-loop-alignment– Do not align and prefetch loops–amdgpu-disable-power-sched– Disable scheduling to minimize mAI power bursts–amdgpu-dpp-combine– Enable DPP combiner–amdgpu-dump-hsa-metadata– Dump AMDGPU HSA Metadata–amdgpu-enable-global-sgpr-addr– Enable use of SGPR regs for GLOBAL LOAD/STORE instructions–amdgpu-enable-merge-m0– Merge and hoist M0 initializations–amdgpu-sdwa-peephole– Enable SDWA peepholer–amdgpu-spill-sgpr-to-smem– Use scalar stores to spill SGPRs if supported by subtarget–amdgpu-verify-hsa-metadata– Verify AMDGPU HSA Metadata–amdgpu-vgpr-index-mode– Use GPR indexing mode instead of movrel for vector indexing–arch=<string> – Target arch to assemble for, see-versionfor available targets–arm-add-build-attributes––arm-implicit-it=<value> – Allow conditional instructions outdside of an IT block- =always
- – Accept in both ISAs, emit implicit ITs in Thumb
- =never
- – Warn in ARM, reject in Thumb
- =arm
- – Accept in ARM, reject in Thumb
- =thumb
- – Warn in ARM, emit implicit ITs in Thumb
-
–asm-show-inst– Emit internal instruction representation to assembly file–atomic-counter-update-promoted– Do counter update using atomic fetch add -
- for promoted counters only
-
–bounds-checking-single-trap– Use one trap block per function–compress-debug-sections=<value> – Choose DWARF debug sections compression:- =none
- – No compression
- =zlib
- – Use zlib compression
- =zlib-gnu
- – Use zlib-gnu compression (deprecated)
-
–cost-kind=<value> – Target cost kind- =throughput
- – Reciprocal throughput
- =latency
- – Instruction latency
- =code-size
- – Code size
-
–cvp-dont-add-nowrap-flags––defsym=<string> – Defines a symbol to be an integer constant–disable-promote-alloca-to-lds– Disable promote alloca to LDS–disable-promote-alloca-to-vector– Disable promote alloca to vector -
- Action to perform:
-
–as-lex– Lex tokens from a .s file–assemble– Assemble a .s file (default)–disassemble– Disassemble strings of hex bytes–mdis– Marked up disassembly of strings of hex bytes–do-counter-promotion– Do counter register promotion–dwarf-version=<int> – Dwarf version–emscripten-cxx-exceptions-whitelist=<string> – The list of function names in which Emscripten-style exception handling is enabled (see emscripten EMSCRIPTEN_CATCHING_WHITELIST options)–enable-cse-in-irtranslator– Should enable CSE in irtranslator–enable-cse-in-legalizer– Should enable CSE in Legalizer–enable-emscripten-cxx-exceptions– WebAssembly Emscripten-style exception handling–enable-emscripten-sjlj– WebAssembly Emscripten-style setjmp/longjmp handling–enable-gvn-memdep––enable-load-pre––enable-loop-simplifycfg-term-folding––enable-name-compression– Enable name string compression–expensive-combines– Enable expensive instruction combines–fatal-warnings– Treat warnings as errors–fdebug-compilation-dir=<string> – Specifies the debug info’s compilation dir–fdebug-prefix-map=<= separated key-value pairs> – Map file source paths in debug info–filetype=<value> – Choose an output file type:- =asm
- – Emit an assembly (‘.s’) file
- =null
- – Don’t emit anything (for timing purposes)
- =obj
- – Emit a native object (‘.o’) file
-
-g– Generate dwarf debugging info for assembly source files–gpsize=<uint> – Global Pointer Addressing Size. -
- The default size is 8.
-
–hash-based-counter-split– Rename counter variable of a comdat function based on cfg hash–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=<uint> – How wide an instruction window to bypass looking for another guard–instcombine-max-num-phis=<uint> – Maximum number phis to handle in intptr/ptrint folding–instcombine-maxarray-size=<uint> – Maximum array size considered when doing a combine–instrprof-atomic-counter-update-all– Make all profile counter updates atomic (for testing only)–internalize-public-api-file=<filename> – A file containing list of symbol names to preserve–internalize-public-api-list=<list> – A list of symbol names to preserve–iterative-counter-promotion– Allow counter promotion across the whole loop nest.–large-code-model– Create cfi directives that assume the code might be more than 2gb away–lto-pass-remarks-filter=<regex> – Only record optimization remarks from passes whose names match the given regular expression–lto-pass-remarks-format=<format> – The format used for serializing remarks (default: YAML)–lto-pass-remarks-output=<filename> – Output filename for pass remarks–main-file-name=<string> – Specifies the name we should consider the input file–masm-integers– Enable binary and hex masm integers (0b110 and 0ABCh)–mattr=<a1,+a2,-a3,…> – Target specific attributes (-mattr=,help/ for details)–max-counter-promotions=<int> – Max number of allowed counter promotions–max-counter-promotions-per-loop=<uint> – 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=<cpu-name> – Target a specific cpu type (-mcpu=,help/ for details)–memop-size-large=<uint> – Set large value thresthold in memory intrinsic size profiling. Value of 0 disables the large value profiling.–memop-size-range=<string> – Set the range of size in memory intrinsic calls to be profiled precisely, in a format of <start_val>:<end_val>–merror-missing-parenthesis– Error for missing parenthesis around predicate registers–merror-noncontigious-register– Error for register names that aren’t contigious–mhvx– Enable Hexagon Vector eXtensions–mhvx=<value> – Enable Hexagon Vector eXtensions- =v60
- – Build for HVX v60
- =v62
- – Build for HVX v62
- =v65
- – Build for HVX v65
- =v66
- – Build for HVX v66
-
–mips-compact-branches=<value> – MIPS Specific: Compact branch policy.- =never
- – Do not use compact branches if possible.
- =optimal
- – Use compact branches where appropiate (default).
- =always
- – Always use compact branches if possible.
-
–mips16-constant-islands– Enable mips16 constant islands.–mips16-hard-float– Enable mips16 hard float.–mno-compound– Disable looking for compound instructions for Hexagon–mno-fixup– Disable fixing up resolved relocations for Hexagon–mno-ldc1-sdc1– Expand double precision loads and stores to their single precision counterparts–mno-pairing– Disable looking for duplex instructions for Hexagon–mwarn-missing-parenthesis– Warn for missing parenthesis around predicate registers–mwarn-noncontigious-register– Warn for register names that arent contigious–mwarn-sign-mismatch– Warn for mismatching a signed and unsigned value-n– Don’t assume assembly file starts in the text section–no-deprecated-warn– Suppress all deprecated warnings–no-discriminators– Disable generation of discriminator information.–no-exec-stack– File doesn’t need an exec stack–no-warn– Suppress all warnings–nvptx-sched4reg– NVPTX Specific: schedule for register pressue-o=<filename> – Output filename–output-asm-variant=<uint> – Syntax variant to use for output printing–pie-copy-relocations– PIE Copy Relocations–poison-checking-function-local– Check that returns are non-poison (for testing)–position-independent– Position independent–preserve-comments– Preserve Comments in outputted assembly–print-imm-hex– Prefer hex format for immediate values–r600-ir-structurize– Use StructurizeCFG IR pass–rdf-dump––rdf-limit=<uint> ––relax-relocations– Emit R_X86_64_GOTPCRELX instead of R_X86_64_GOTPCREL–remarks-section– Emit a section containing remark diagnostics metadata–safepoint-ir-verifier-print-only––sample-profile-check-record-coverage=<N> – Emit a warning if less than N% of records in the input profile are matched to the IR.–sample-profile-check-sample-coverage=<N> – Emit a warning if less than N% of samples in the input profile are matched to the IR.–sample-profile-max-propagate-iterations=<uint> – Maximum number of iterations to go through when propagating sample block/edge weights through the CFG.–save-temp-labels– Don’t discard temporary labels–show-encoding– Show instruction encodings–show-inst– Show internal instruction representation–show-inst-operands– Show instructions operands as parsed–speculative-counter-promotion-max-exiting=<uint> – 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=<filename> – DWO output filename–summary-file=<string> – The summary file to use for function importing.–threads=<int> ––time-trace-granularity=<uint> – Minimum time granularity (in microseconds) traced by time profiler–triple=<string> – Target triple to assemble for, see-versionfor available targets–verify-region-info– Verify region info (time consuming)–vp-counters-per-site=<number> – The average number of profile counters allocated per value profiling site.–vp-static-alloc– Do static counter allocation for value profiler
-
–help– Display available options (–help-hiddenfor more)–help-list– Display list of available options (–help-list-hiddenfor more)–version– Display the version of this program
