CLANG-REPL(1)

📦

version 13.0.1 · 3 versions

13.0.1 · ubuntu jammy (latest)
13.0.1 · ubuntu jammy
13.0.1 · debian bookworm

💖 clang-repl — the manual page, but make it make sense 💖

okay so bestie, welcome to clang-repl, from the User Commands corner of your manual, version 13. It's the interactive REPL for Clang and she is iconic. Let's get into it, no cap. 🦋

✨ NAME ✨

clang-repl — manual page for clang-repl 13 💅

🌸 DESCRIPTION 🌸

Here's how you actually run her:

USAGE: clang-repl [options] [code to run]

Like, you give her options, you give her code to run, and she does the thing. Simple. Periodt. ✨

OPTIONS:

🎀 Color Options 🎀

The aesthetic section. We love her.

--color — use colors in output, bestie 🌈 (default=autodetect — she'll figure out the vibe check on her own)

💜 General options 💜

This is the big one. Grab a snack, this list is long. 🍓

--Xcc=<string> — an argument to pass straight through to the CompilerInvocation 🫶
--aarch64-neon-syntax=<value> — pick which style of NEON code to emit from the AArch64 backend:
- =generic — emit generic NEON assembly
- =apple — emit Apple-style NEON assembly
--aarch64-use-aa — enable the use of AA during codegen. 🔥
--abort-on-max-devirt-iterations-reached — abort when the max iterations for the devirtualization CGSCC repeat pass is reached. Like, she will literally give up. 😭
--addrsig — emit an address-significance table
--allow-ginsert-as-artifact — allow G_INSERT to be considered an artifact. It's a hack around AMDGPU test infinite loops, iykyk. 🙈
--amdgpu-bypass-slow-div — skip 64-bit divide for dynamic 32-bit values
--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-flat-scratch — use flat scratch instructions
--amdgpu-enable-merge-m0 — merge and hoist M0 initializations
--amdgpu-promote-alloca-to-vector-limit=<uint> — maximum byte size to consider for promote alloca to vector
--amdgpu-reserve-vgpr-for-sgpr-spill — allocates one VGPR for future SGPR Spill
--amdgpu-sdwa-peephole — enable SDWA peepholer
--amdgpu-use-aa-in-codegen — enable the use of AA during codegen. 🔥
--amdgpu-verify-hsa-metadata — verify AMDGPU HSA Metadata
--amdgpu-vgpr-index-mode — use GPR indexing mode instead of movrel for vector indexing
--arm-add-build-attributes — (no description, she's mysterious 💅)
--arm-implicit-it=<value> — allow conditional instructions outside 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 the assembly file
--atomic-counter-update-promoted — do counter update using atomic fetch add for promoted counters only
--atomic-first-counter — use atomic fetch add for the first counter in a function (usually the entry counter)
--basic-block-sections=<all | <function list (file)> | labels | none> — emit basic blocks into separate sections
--bounds-checking-single-trap — use one trap block per function
--cfg-hide-cold-paths=<number> — hide blocks with relative frequency below the given value
--cfg-hide-deoptimize-paths — (no description, just vibes ✨)
--cfg-hide-unreachable-paths — (no description either, she's keeping it lowkey)
--code-model=<value> — choose your code model:
- =tiny — tiny code model
- =small — small code model
- =kernel — kernel code model
- =medium — medium code model
- =large — large code model
--cost-kind=<value> — the target cost kind:
- =throughput — reciprocal throughput
- =latency — instruction latency
- =code-size — code size
- =size-latency — code size and latency
--data-sections — emit data into separate sections
--debug-entry-values — enable debug info for the debug entry values. 🐛
--debugger-tune=<value> — tune debug info for a particular debugger:
- =gdb — gdb
- =lldb — lldb
- =dbx — dbx
- =sce — SCE targets (e.g. PS4)
--debugify-level=<value> — the kind of debug info to add:
- =locations — locations only
- =location+variables — locations and variables
--debugify-quiet — suppress verbose debugify output 🤫
--denormal-fp-math=<value> — 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
--denormal-fp-math-f32=<value> — same deal, but 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
--disable-i2p-p2i-opt — disables the inttoptr/ptrtoint roundtrip optimization
--disable-promote-alloca-to-lds — disable promote alloca to LDS
--disable-promote-alloca-to-vector — disable promote alloca to vector
--disable-tail-calls — never emit tail calls
--do-counter-promotion — do counter register promotion
--dot-cfg-mssa=<file name for generated dot file> — file name for the generated dot file
--dwarf-version=<int> — dwarf version
--dwarf64 — generate debugging info in the 64-bit DWARF format
--emit-call-site-info — emit call site debug information, if debug information is enabled.
--emscripten-cxx-exceptions-allowed=<string> — the list of function names in which Emscripten-style exception handling is enabled (see emscripten EMSCRIPTEN_CATCHING_ALLOWED options)
--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-emscripten-cxx-exceptions — WebAssembly Emscripten-style exception handling
--enable-emscripten-sjlj — WebAssembly Emscripten-style setjmp/longjmp handling
--enable-gvn-hoist — enable the GVN hoisting pass (default = off)
--enable-gvn-memdep — (no description, she said nothing and left 🫥)
--enable-gvn-sink — enable the GVN sinking pass (default = off)
--enable-load-in-loop-pre — (no description)
--enable-load-pre — (no description)
--enable-loop-simplifycfg-term-folding — (no description)
--enable-name-compression — enable name/filename string compression
--enable-no-infs-fp-math — enable FP math optimizations that assume no +-Infs
--enable-no-nans-fp-math — enable FP math optimizations that assume no NaNs
--enable-no-signed-zeros-fp-math — enable FP math optimizations that assume the sign of 0 is insignificant
--enable-no-trapping-fp-math — enable setting the FP exceptions build attribute not to use exceptions
--enable-split-backedge-in-load-pre — (no description)
--enable-unsafe-fp-math — enable optimizations that may decrease FP precision. Be careful bestie. 😭
--exception-model=<value> — 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
--execute-concurrency=<uint> — the number of threads used to process all files in parallel. Set to 0 for hardware concurrency. This flag only applies to all-TUs. 🧵
--executor=<string> — the name of the executor to use.
--experimental-debug-variable-locations — use experimental new value-tracking variable locations 🧪
--fatal-warnings — treat warnings as errors 💀
--filetype=<value> — choose a file type (not all types are supported by all targets):

and that's where part 1 stops, bestie — she's still going… 🦋

okay so these next three are still values for that option from up top, not new flags, don't @ me:

=asm — emits an assembly '.s' file ✨
=obj — emits a native object '.o' file 💅
=null — emits literally nothing, it's purely for performance testing 🫥

--filter=<string> — only processes files that match this filter. heads up bestie, this flag only applies to all-TUs. all-TUs and nothing else.
--float-abi=<value> — picks the float ABI type 🧚
- =default — whatever the target's default float ABI type is
- =soft — soft float ABI (this is what -soft-float implies)
- =hard — hard float ABI (it uses FP registers, fancy)
--force-dwarf-frame-section — always emit a debug frame section. no skipping. always.
--force-opaque-pointers — forces all pointers to be opaque pointers 👑
--fp-contract=<value> — turns on aggressive formation of fused FP ops 🔥
- =fast — fuse FP ops whenever it's profitable
- =on — only fuse the 'blessed' FP ops
- =off — only fuse FP ops when the result won't be affected
--frame-pointer=<value> — specifies the frame pointer elimination optimization
- =all — disables frame pointer elimination entirely
- =non-leaf — disables frame pointer elimination for non-leaf frames
- =none — enables frame pointer elimination
--function-sections — emits functions into separate sections
--gpsize=<uint> — Global Pointer Addressing Size. the default size is 8, that's the whole tea ☕
--hash-based-counter-split — renames the counter variable of a comdat function based on cfg hash
--hot-cold-split — enables the hot-cold splitting pass
--ignore-xcoff-visibility — doesn't emit the visibility attribute for asm in AIX OS, or gives all symbols 'unspecified' visibility in an XCOFF object file
--import-all-index — imports all external functions in index.
--incremental-linker-compatible — when you use it with filetype=obj, it emits an object file that can be used with an incremental linker
--instcombine-code-sinking — enables code sinking
--instcombine-guard-widening-window=<uint> — how wide an instruction window to bypass when looking for another guard
--instcombine-max-iterations=<uint> — caps the maximum number of instruction combining iterations
--instcombine-max-num-phis=<uint> — maximum number of phis to handle in intptr/ptrint folding
--instcombine-maxarray-size=<uint> — maximum array size considered when doing a combine
--instcombine-negator-enabled — should we attempt to sink negations? 🤔
--instcombine-negator-max-depth=<uint> — the maximal lookup depth when trying to check viability of negation sinking.
--instrprof-atomic-counter-update-all — makes all profile counter updates atomic (for testing only, don't ship this fr fr)
--internalize-public-api-file=<filename> — a file containing a list of symbol names to preserve
--internalize-public-api-list=<list> — a list of symbol names to preserve
--iterative-counter-promotion — allows counter promotion across the whole loop nest.
--lto-embed-bitcode=<value> — embeds LLVM bitcode in object files produced by LTO 💎
- =none — do not embed
- =optimized — embed after all the optimization passes
- =post-merge-pre-opt — embed post merge, but before optimizations
--lto-pass-remarks-filter=<regex> — only records 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
--march=<string> — the architecture to generate code for (see --version)
--matrix-default-layout=<value> — sets the default matrix layout 🧊
- =column-major — use column-major layout
- =row-major — use row-major layout
--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 of counter promotions per loop, so we don't increase register pressure too much
--mc-relax-all — when used with filetype=obj, relaxes all fixups in the emitted object file
--mcpu=<cpu-name> — target a specific cpu type (-mcpu=help for details)
--meabi=<value> — sets the EABI type (the default depends on triple):
- =default — triple default EABI version
- =4 — EABI version 4
- =5 — EABI version 5
- =gnu — EABI GNU
--merror-missing-parenthesis — errors on missing parenthesis around predicate registers
--merror-noncontigious-register — errors on register names that aren't contigious
--mhvx — enables Hexagon Vector eXtensions
--mhvx=<value> — enables Hexagon Vector eXtensions
- =v60 — build for HVX v60
- =v62 — build for HVX v62
- =v65 — build for HVX v65
- =v66 — build for HVX v66
- =v67 — build for HVX v67
- =v68 — build for HVX v68
--mips-compact-branches=<value> — MIPS specific: compact branch policy.
- =never — do not use compact branches if possible.
- =optimal — use compact branches where appropriate (default).
- =always — always use compact branches if possible.
--mips16-constant-islands — enables mips16 constant islands.
--mips16-hard-float — enables mips16 hard float.
--mir-strip-debugify-only — should mir-strip-debug only strip debug info from debugified modules by default? 🐛
--mno-compound — disables looking for compound instructions for Hexagon
--mno-fixup — disables fixing up resolved relocations for Hexagon
--mno-ldc1-sdc1 — expands double precision loads and stores into their single precision counterparts
--mno-pairing — disables looking for duplex instructions for Hexagon
--mwarn-missing-parenthesis — warns for missing parenthesis around predicate registers
--mwarn-noncontigious-register — warns for register names that arent contigious
--mwarn-sign-mismatch — warns for mismatching a signed and unsigned value
--no-deprecated-warn — suppresses all deprecated warnings
--no-discriminators — disables generation of discriminator information.
--no-type-check — suppresses type errors (Wasm)
--no-warn — suppresses all warnings
--no-xray-index — doesn't emit the xray_fn_idx section
--nozero-initialized-in-bss — doesn't place zero-initialized symbols into the bss section
--nvptx-sched4reg — NVPTX specific: schedule for register pressue
--poison-checking-function-local — checks that returns are non-poison (for testing)
--pseudo-probe-for-profiling — emits pseudo probes for AutoFDO
--r600-ir-structurize — uses the StructurizeCFG IR pass
--rdf-dump — (no description given, it's giving mystery 🕵️)
--rdf-limit=<uint> — (also no description, iconic and silent)
--relax-elf-relocations — emits GOTPCRELX/REX_GOTPCRELX instead of GOTPCREL on x86-64 ELF
--relocation-model=<value> — chooses the 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 — a combination of ropi and rwpi
--runtime-counter-relocation — enables relocating counters at runtime.
--safepoint-ir-verifier-print-only — (no description, just vibes)
--sample-profile-check-record-coverage=<N> — emits a warning if less than N% of records in the input profile are matched to the IR.
--sample-profile-check-sample-coverage=<N> — bestie it will warn you if fewer than N% of the samples in your input profile actually got matched up to the IR. like it's checking if the vibes align 💅
--sample-profile-max-propagate-iterations=<uint> — the max number of iterations it's willing to go through while propagating sample block/edge weights through the CFG. it will not loop forever, she has boundaries 🫶
--skip-ret-exit-block — suppresses counter promotion if the exit blocks contain ret. no promotion if there's a return chilling in there, periodt.
--speculative-counter-promotion-max-exiting=<uint> — the max number of exiting blocks of a loop that are allowed for speculative counter promotion. she has a cap ok ✨
--speculative-counter-promotion-to-loop — when this option is false, if the target block is in a loop, the promotion gets disallowed unless the promoted counter update can be further/iteratively promoted into an acyclic region. it's giving "only if you can escape the loop, queen" 🌀
--split-machine-functions — split out the cold basic blocks from machine functions, based on profile info. bye cold blocks, you're on your own 🥶
--stack-size-section — emit a section that contains stack size metadata. metadata slay 💖
--stack-symbol-ordering — order local stack symbols. keep it cute, keep it ordered 🌸
--stackrealign — force-align the stack to the minimum alignment. she is aligned and she is thriving ✨
--strict-dwarf — use strict dwarf. no notes, just strict dwarf 🧚
--summary-file=<string> — the summary file to use for function importing. give her the file, she'll handle the importing 💅
--tail-predication=<value> — MVE tail-predication pass options. the choices are:
- =disabled — Don't tail-predicate loops
- =enabled-no-reductions — Enable tail-predication, but not for reduction loops
- =enabled — Enable tail-predication, including reduction loops
- =force-enabled-no-reductions — Enable tail-predication, but not for reduction loops, and force this which might be unsafe ⚠️
- =force-enabled — Enable tail-predication, including reduction loops, and force this which might be unsafe ⚠️
--tailcallopt — turn fastcc calls into tail calls by (potentially) changing the ABI. she's changing the ABI, lowkey a big deal 👑
--thinlto-assume-merged — assume the input has already undergone ThinLTO function importing and the other pre-optimization pipeline changes. just trust her, ok? 🙈
--thread-model=<value> — choose threading model:
- =posix — POSIX thread model
- =single — Single thread model
--threads=<int> — no description given in the original, and honestly? mysterious queen behavior 💀 she said nothing and left
--tls-size=<uint> — bit size of immediate TLS offsets. tiny but mighty 🎀
--unique-basic-block-section-names — give unique names to every basic block section. no duplicates allowed, we're all individuals here 🌈
--unique-section-names — give unique names to every section. same energy, different scope 💅
--use-ctors — use .ctors instead of .init_array. old-school choice, respect it 🫶
--vec-extabi — enable the AIX Extended Altivec ABI. AIX girlies rise up 🔥
--verify-region-info — verify region info. and yes, it's time consuming — she warned you, don't be shocked ⏳
--vp-counters-per-site=<number> — the average number of profile counters allocated per value profiling site. averages, bestie ✨
--vp-static-alloc — do static counter allocation for value profiler. static > everything rn 💖
--x86-align-branch=<string> — specify types of branches to align, as a plus-separated list of types:
- jcc — indicates conditional jumps
- fused — indicates fused conditional jumps
- jmp — indicates direct unconditional jumps
- call — indicates direct and indirect calls
- ret — indicates rets
- indirect — indicates indirect unconditional jumps
--x86-align-branch-boundary=<uint> — control how the assembler should align branches with NOP. if the boundary's size isn't 0, it should be a power of 2 and no less than 32. branches get aligned to prevent them from being across or against the boundary of the specified size. and heads up: the default value 0 does not align branches 🫣
--x86-branches-within-32B-boundaries — align selected instructions to mitigate the negative performance impact of Intel's micro code update for errata skx102.

careful bestie — this may break assumptions about labels corresponding to particular instructions, and should be used with caution. ⚠️

--x86-pad-max-prefix-size=<uint> — maximum number of prefixes to use for padding. pad responsibly 💅
--xcoff-traceback-table — emit the XCOFF traceback table. table? emitted. iconic 📋

🌸 Generic Options 🌸

--help — display available options (--help-hidden for more). she's helpful like that 🫶
--help-list — display the list of available options (--help-list-hidden for more). a list! of options! 💖
--version — display the version of this program. know your version, queen 👑

🌈 Polly Options: Configure the polly loop optimizer 🌈

--polly — enable the polly optimizer (with -O1, -O2 or -O3). polly said let me in 🔥
--polly-2nd-level-tiling — enable a 2nd level loop of loop tiling. tiling but make it layered ✨
--polly-ast-print-accesses — print memory access functions. show me the accesses 📝
--polly-context=<isl parameter set> — provide additional constraints on the context parameters. boundaries, but make them isl 💅
--polly-dce-precise-steps=<int> — the number of precise steps between two approximating iterations. (A value of -1 schedules another approximation stage before the actual dead code elimination. — yes, the parenthesis in the original is left open, we are simply reporting it, no cap 🙈
--polly-delicm-max-ops=<int> — maximum number of isl operations to invest for lifetime analysis; 0 = no limit. invest in yourself bestie 💖
--polly-detect-full-functions — allow the detection of full functions. full send 🌸
--polly-dump-after — dump module after Polly transformations into a file suffixed with "-after". after pic incoming 📸
--polly-dump-after-file=<string> — dump module after Polly transformations to the given file. same but you pick the name 💅
--polly-dump-before — dump module before Polly transformations into a file suffixed with "-before". the before pic 📸
--polly-dump-before-file=<string> — dump module before Polly transformations to the given file. before pic, your filename, your rules ✨
--polly-enable-simplify — simplify SCoP after optimizations. clean it up after the glow-up 🧚
--polly-ignore-func=<string> — ignore functions that match a regex. multiple regexes can be comma separated. Scop detection will ignore all functions that match ANY of the regexes provided. not you, not you, definitely not you 🙅
--polly-isl-arg=<argument> — option passed to ISL. hand-delivered 🎀
--polly-on-isl-error-abort — abort if an isl error is encountered. isl error? we're OUT 💀
--polly-only-func=<string> — only run on functions that match a regex. multiple regexes can be comma separated. Scop detection will run on all functions that match ANY of the regexes provided. yes you, and you, come through 👑
--polly-only-region=<identifier> — only run on certain regions (the provided identifier must appear in the name of the region's entry block. — again, original parenthesis left open, we report it faithfully 🫶
--polly-only-scop-detection — only run scop detection, but no other optimizations. detection only, no glow-up, we're just looking 👀
--polly-optimized-scops — Polly - dump polyhedral description of Scops optimized with the isl scheduling optimizer and the set of post-scheduling transformations is applied on the schedule tree. a whole mouthful and we're saying it with our chest 💅
--polly-parallel — generate thread parallel code (isl codegen only). threads, parallel, iconic 🌈
--polly-parallel-force — force generation of thread parallel code ignoring any cost model. cost model said no, we said yes anyway 🔥
--polly-pattern-matching-based-opts — perform optimizations based on pattern matching. match the pattern, serve the look ✨
--polly-pragma-based-opts — apply user-directed transformation from metadata. user-directed, as in you directed it, bestie 🫵
--polly-process-unprofitable — process scops that are unlikely to benefit from Polly optimizations. giving unprofitable scops a chance anyway, we love an underdog 😭
--polly-register-tiling — enable register tiling. tiles for the registers specifically 💖
--polly-report — print information about the activities of Polly. what has polly been up to? let's find out 📢
--polly-show — highlight the code regions that will be optimized in a (CFG BBs and LLVM-IR instructions). — parenthesis as-is, she's dramatic like that 💅
--polly-show-only — highlight the code regions that will be optimized in a (CFG only BBs). — same energy, CFG only 🎀
--polly-stmt-granularity=<value> — algorithm to use for splitting basic blocks into multiple statements:
- =bb — One statement per basic block
- =scalar-indep — Scalar independence heuristic
- =store — Store-level granularity
--polly-target=<value> — the hardware to target:
- =cpu — generate CPU code
--polly-tiling — enable loop tiling. tiles! ✨
--polly-vectorizer=<value> — select the vectorization strategy:
- =none — No Vectorization
=polly — the Polly internal vectorizer, doing its lil optimization dance ✨
=stripmine — strip-mines the outer loops so the loop-vectorizer actually gets a chance to trigger 🔥 like it's clearing the runway so the plane can take off, iykyk

and that's the whole vibe, bestie — every flag, every pass, all of it 💅

this page is from clang-repl 13, dated July 2023 — go forth and REPL responsibly 🫶💖

📦 where this page comes from

ubuntu jammy: clang-tools-13 1:13.0.1-2ubuntu2.2 · APACHE-2-LLVM-EXCEPTIONS
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-13: a language model's rewrite of the original, under its terms