SysTutorials

Linux Manual Pages › Section 1

llvm-mc-9(1)

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)
General options:
-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 -version for 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 -version for 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
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