MODULARIZE(1)

MODULARIZE(1) 💅

okay bestie, so this is the manual page for modularize, and it lives in the User Commands section of the manual 🎀 it's long, it's iconic, and we're gonna get through it together. no cap 🫶

---

✨ NAME ✨

modularize — the manual page for modularize 11 🌸

---

🦋 DESCRIPTION 🦋

OVERVIEW: modularize.

USAGE:

modularize [options] <list of one or more header list files> <arguments to be passed to front end>...

OPTIONS:

okay so this is the big part. buckle up, we're listing everything 💖

---

🎀 Color Options 🎀

• --color — use colors in output 💅 (default=autodetect)

---

🦋 General options 🦋

• -I=<path> — include path for the coverage check 🗂️
• --aarch64-neon-syntax=<value> — pick the style of NEON code that gets emitted from the AArch64 backend:
  • =generic — emit generic NEON assembly
  • =apple — emit Apple-style NEON assembly
• --addrsig — emit an address-significance table ✨
• --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-global-sgpr-addr — enable use of SGPR regs for GLOBAL LOAD/STORE instructions
• --amdgpu-enable-merge-m0 — merge and hoist M0 initializations
• --amdgpu-promote-alloca-to-vector-limit=<uint> — maximum byte size to consider promote alloca to vector
• --amdgpu-reserve-vgpr-for-sgpr-spill — allocates one VGPR for future SGPR Spill
• --amdgpu-sdwa-peephole — enable SDWA peepholer
• --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 — (the original gives us nothing here, no description, zero notes, it's giving 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)
• --basicblock-sections=<all | <function list (file)> | labels | none> — emit basic blocks into separate sections
• --block-check-header-list-only — only warn if #include directives are inside extern or namespace blocks when the included header is in the header list.
• --bounds-checking-single-trap — use one trap block per function
• --cfg-hide-deoptimize-paths — (no description in the original, bestie, it's just vibes 🙈)
• --cfg-hide-unreachable-paths — (again, no description given 😭)
• --code-model=<value> — choose the 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> — target cost kind:
  • =throughput — reciprocal throughput
  • =latency — instruction latency
  • =code-size — code size
• --coverage-check-only — only do the coverage check.
• --cvp-dont-add-nowrap-flags — (yep, no description here either 🫠)
• --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
  • =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> — select which denormal numbers the code is permitted to require, but 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-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
• --display-file-lists — display lists of good files (no compile errors), problem files, and a combined list with problem files preceded by a '#'.
• --do-counter-promotion — do counter register promotion
• --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, it's a mystery, we respect it 💜)
• --enable-gvn-sink — enable the GVN sinking pass (default = off)
• --enable-load-in-loop-pre — (no description given 🙈)
• --enable-load-pre — (no description given 🙈)
• --enable-loop-simplifycfg-term-folding — (no description given 🙈)
• --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-unsafe-fp-math — enable optimizations that may decrease FP precision
• --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.
• --fatal-warnings — treat warnings as errors 😤
• --filetype=<value> — 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
• --filter=<string> — only process files that match this filter. this flag only applies to all-TUs.
• --float-abi=<value> — 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)

---

bestie we are NOT done, the options keep going 😭 part 2 incoming 💖

✨ OPTIONS ✨

okay so like, this is the part where the magic happens 💫 every single flag you could ever want (and some you didn't know you needed) is right here. let's get into it, bestie 🫶

• --force-dwarf-frame-section — Always emit a debug frame section. like, no matter what, it's gonna be there 💁‍♀️
• --fp-contract=<value> — Enable aggressive formation of fused FP ops. here's the vibe:
  • =fast — Fuse FP ops whenever profitable. if it makes sense, do it 💅
  • =on — Only fuse 'blessed' FP ops. just the chosen ones ✨
  • =off — Only fuse FP ops when the result won't be affected. safety first, bestie 🛡️
• --frame-pointer=<value> — Specify frame pointer elimination optimization. choices, choices:
  • =all — Disable frame pointer elimination. keep that pointer around 👀
  • =non-leaf — Disable frame pointer elimination for non-leaf frame. only for the non-leaf ones 🌿
  • =none — Enable frame pointer elimination. bye bye pointer 👋
• --function-sections — Emit functions into separate sections. each function gets its own lil section 🎀
• --gpsize=<uint> — Global Pointer Addressing Size. The default size is 8. so like, if you don't say anything, it's 8, periodt 💯
• --hash-based-counter-split — Rename counter variable of a comdat function based on cfg hash. it's giving hash-based renaming 🔢
• --hot-cold-split — Enable hot-cold splitting pass. hot stuff and cold stuff get separated 🔥❄️
• --import-all-index — Import all external functions in index. bring 'em all in 🫂
• --incremental-linker-compatible — When used with filetype=obj, emit an object file which can be used with an incremental linker. so like, only when you're doing filetype=obj 🧩
• --instcombine-code-sinking — Enable code sinking. sinking code, not the vibe 💀
• --instcombine-guard-widening-window=<uint> — How wide an instruction window to bypass looking for another guard. how wide? you tell me 📏
• --instcombine-max-iterations=<uint> — Limit the maximum number of instruction combining iterations. don't overdo it, bestie 🛑
• --instcombine-max-num-phis=<uint> — Maximum number phis to handle in intptr/ptrint folding. max phis, got it 🔢
• --instcombine-maxarray-size=<uint> — Maximum array size considered when doing a combine. if it's too big, we don't combine it 🚫
• --instcombine-negator-enabled — Should we attempt to sink negations? like, should we? 🤔
• --instcombine-negator-max-depth=<uint> — What is the maximal lookup depth when trying to check for viability of negation sinking. how deep do we go? 🕵️‍♀️
• --instrprof-atomic-counter-update-all — Make all profile counter updates atomic (for testing only). testing only, don't @ me 🧪
• --internalize-public-api-file=<filename> — A file containing list of symbol names to preserve. keep these symbols safe 🛡️
• --internalize-public-api-list=<list> — A list of symbol names to preserve. same but as a list 📝
• --iterative-counter-promotion — Allow counter promotion across the whole loop nest. promote those counters everywhere 🚀
• --lto-embed-bitcode — Embed LLVM bitcode in object files produced by LTO. bitcode goes inside 🥚
• --lto-pass-remarks-filter=<regex> — Only record optimization remarks from passes whose names match the given regular expression. regex filter, fancy 💅
• --lto-pass-remarks-format=<format> — The format used for serializing remarks (default: YAML). default is YAML, fyi 📄
• --lto-pass-remarks-output=<filename> — Output filename for pass remarks. where do the remarks go? here 📁
• --march=<string> — Architecture to generate code for (see --version). check --version for the tea 🏗️
• --matrix-default-layout=<value> — Sets the default matrix layout. how do you like your matrices?
  • =column-major — Use column-major layout. columns first 🗂️
  • =row-major — Use row-major layout. rows first 📊
• --mattr=<a1,+a2,-a3,...> — Target specific attributes (-mattr=help for details). need help? -mattr=help is your friend 🆘
• --max-counter-promotions=<int> — Max number of allowed counter promotions. don't promote too many 🚦
• --max-counter-promotions-per-loop=<uint> — Max number counter promotions per loop to avoid increasing register pressure too much. keep that register pressure in check 🧘‍♀️
• --mc-relax-all — When used with filetype=obj, relax all fixups in the emitted object file. relax, take it easy 🛋️
• --mcpu=<cpu-name> — Target a specific cpu type (-mcpu=help for details). -mcpu=help has the deets 🖥️
• --meabi=<value> — Set EABI type (default depends on triple). depends on the triple, so like, it varies 🤷‍♀️
  • =default — Triple default EABI version. the default default 😅
  • =4 — EABI version 4. version 4, got it 4️⃣
  • =5 — EABI version 5. version 5, slay 5️⃣
  • =gnu — EABI GNU. GNU style 🐃
• --memop-size-large=<uint> — Set large value thresthold in memory intrinsic size profiling. Value of 0 disables the large value profiling. (yes, it says "thresthold" — we keep it exactly as is, bestie 💖)
• --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>. format is start:end, periodt 🎯
• --merror-missing-parenthesis — Error for missing parenthesis around predicate registers. missing parenthesis? error. simple 💥
• --merror-noncontigious-register — Error for register names that aren't contigious. (typo in the original — "contigious" stays 💀) if it's not contigious, error 🚨
• --mhvx — Enable Hexagon Vector eXtensions. HVX on, bestie ✨
• --mhvx=<value> — Enable Hexagon Vector eXtensions. which version?
  • =v60 — Build for HVX v60. v60 vibes 🌀
  • =v62 — Build for HVX v62. v62 vibes 🌀
  • =v65 — Build for HVX v65. v65 vibes 🌀
  • =v66 — Build for HVX v66. v66 vibes 🌀
  • =v67 — Build for HVX v67. v67 vibes 🌀
• --mips-compact-branches=<value> — MIPS Specific: Compact branch policy. MIPS only, just so you know 🧠
  • =never — Do not use compact branches if possible. never ever 🚫
  • =optimal — Use compact branches where appropriate (default). the default, optimal 💯
  • =always — Always use compact branches if possible. always, no exceptions 💯
• --mips16-constant-islands — Enable mips16 constant islands. islands of constants 🏝️
• --mips16-hard-float — Enable mips16 hard float. hard float, not soft 🧊
• --mir-strip-debugify-only — Should mir-strip-debug only strip debug info from debugified modules by default. only from debugified ones, by default 🤔
• --mno-compound — Disable looking for compound instructions for Hexagon. no compound for Hexagon 🚫
• --mno-fixup — Disable fixing up resolved relocations for Hexagon. no fixup for Hexagon 🚫
• --mno-ldc1-sdc1 — Expand double precision loads and stores to their single precision counterparts. double becomes single, interesting 🔄
• --mno-pairing — Disable looking for duplex instructions for Hexagon. no pairing for Hexagon 🚫
• --module-map-path=<string> — Turn on module map output and specify output path or file name. If no path is specified and if prefix option is specified, use prefix for file path. so like, if no path and prefix is there, use prefix 📂
• --mwarn-missing-parenthesis — Warn for missing parenthesis around predicate registers. warn, not error ⚠️
• --mwarn-noncontigious-register — Warn for register names that arent contigious. (another typo — "arent" and "contigious" stay exactly 💅) warn for non-contigious registers ⚠️
• --mwarn-sign-mismatch — Warn for mismatching a signed and unsigned value. signed vs unsigned mismatch? warn ⚠️
• --no-coverage-check — Don't do the coverage check. skip the coverage check, live a little 🎢
• --no-deprecated-warn — Suppress all deprecated warnings. no deprecated warnings, periodt 🚫
• --no-discriminators — Disable generation of discriminator information. no discriminators here 🚫
• --no-warn — Suppress all warnings. all warnings? gone. silence 🤫
• --no-xray-index — Don't emit xray_fn_idx section. no xray index section 🚫
• --nozero-initialized-in-bss — Don't place zero-initialized symbols into bss section. zero-init symbols not in bss 🚫
• --nvptx-sched4reg — NVPTX Specific: schedule for register pressue. (yep, "pressue" is another typo, we keep it 💖) NVPTX only, schedule for register pressue 🎯
• --poison-checking-function-local — Check that returns are non-poison (for testing). testing only, checking for poison ☠️
• --prefix=<string> — Prepend header file paths with this prefix. If not specified, the files are considered to be relative to the header list file. so like, if you don't give a prefix, they're relative to the header list file 📁
• --problem-files-list=<string> — List of files with compilation or modularization problems for assistant mode. This will be excluded. assistant mode, and these get excluded 🚫
• --r600-ir-structurize — Use StructurizeCFG IR pass. structurize that CFG 🏗️
• --rdf-dump — (no description, just vibes) 🤷‍♀️
• --rdf-limit=<uint> — (no description, just vibes) 🤷‍♀️
• --relax-elf-relocations — Emit GOTPCRELX/REX_GOTPCRELX instead of GOTPCREL on x86-64 ELF. x86-64 ELF specific, fancy relocations 💅
• --relocation-model=<value> — Choose relocation model. pick your fighter:
  • =static — Non-relocatable code. static, no relocation 🧱
  • =pic — Fully relocatable, position independent code. PIC, fully relocatable 🕊️
  • =dynamic-no-pic — Relocatable external references, non-relocatable code. dynamic but no pic 🤔
  • =ropi — Code and read-only data relocatable, accessed PC-relative. ropi, PC-relative 🖥️
  • =rwpi — Read-write data relocatable, accessed relative to static base. rwpi, static base 📍
  • =ropi-rwpi — Combination of ropi and rwpi. both, why not? 🤝
• --root-module=<string> — Specify the name of the root module. name that root module 🌳
• --runtime-counter-relocation — Enable relocating counters at runtime. relocate counters at runtime ⏱️
• --safepoint-ir-verifier-print-only — (no description, just vibes) 🤷‍♀️
• --sample-profile-check-record-coverage=<N> — Emit a warning if less than N% of records in the input profile are matched to the IR. less than N%? warning ⚠️
• --sample-profile-check-sample-coverage=<N> — Emit a warning if less than N% of samples in the input profile are matched to the IR. same but for samples ⚠️
• --sample-profile-max-propagate-iterations=<uint> — the max number of iterations to go through when you're propagating sample block/edge weights through the CFG. like, how many laps around the block before we stop. 🏃‍♀️
• --speculative-counter-promotion-max-exiting=<uint> — the max number of exiting blocks of a loop that's allowed before we'll do speculative counter promotion. over that count? nope.
• --speculative-counter-promotion-to-loop — when this 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. iykyk. 🔁
• --stack-alignment=<uint> — override the default stack alignment, bestie. you're the boss now.
• --stack-size-section — emit a section that holds stack size metadata. it's giving receipts. 🧾
• --stack-symbol-ordering — order local stack symbols. that's it, that's the whole thing.
• --stackrealign — force-align the stack to the minimum alignment. no negotiating. 💪
• --summary-file=<string> — the summary file to use for function importing.
• --tail-predication=<value> — MVE tail-predication options. here's the menu, pick your vibe:
  • =disabled — don't tail-predicate loops. 🚫
  • =enabled-no-reductions — enable tail-predication, but not for reduction loops.
  • =enabled — enable tail-predication, reduction loops included. ✅
  • =force-enabled-no-reductions — enable tail-predication, but not for reduction loops, and force this — which might be unsafe. ⚠️
  • =force-enabled — enable tail-predication, reduction loops included, and force this — which might be unsafe. ⚠️
• --tailcallopt — turn fastcc calls into tail calls by (potentially) changing the ABI. yes, the ABI. that's the tradeoff, bestie. 😭
• --thread-model=<value> — choose your threading model:
  • =posix — POSIX thread model.
  • =single — Single thread model.
• --threads=<int> — okay so this one literally has no description on the page. it's just sitting there. mysterious main character energy. 👑
• --tls-size=<uint> — bit size of immediate TLS offsets.
• --unique-bb-section-names — give unique names to every basic block section. no dupes allowed. ✨
• --unique-section-names — give unique names to every section. same energy, bigger scope.
• --use-ctors — use .ctors instead of .init_array. switching it up.
• --verify-region-info — verify region info. heads up: this is 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 the value profiler.
• --x86-align-branch=<string> — specify types of branches to align (it's a plus-separated list of types). the roster:
  • 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 has to be a power of 2 and no less than 32. branches get aligned so they don't end up across or against the boundary of the specified size. 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.

⚠️ real talk: this may break assumptions about labels corresponding to particular instructions, and should be used with caution. do not just send it. 💀

• --x86-pad-max-prefix-size=<uint> — maximum number of prefixes to use for padding.

---

✨ Generic Options ✨

the classics, the icons, the ones everyone knows:

• --help — display available options (--help-hidden for more). 🆘
• --help-list — display the list of available options (--help-list-hidden for more).
• --version — display the version of this program.

---

🌸 Polly Options: Configure the polly loop optimizer 🌸

• --polly — enable the polly optimizer (only at -O3, don't forget). 🦋
• --polly-2nd-level-tiling — enable a 2nd level loop of loop tiling.
• --polly-ast-print-accesses — print memory access functions.
• --polly-context=<isl parameter set> — provide additional constraints on the context parameters.
• --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. — and yes, the paren really is left hanging open like that, we don't fix it, we respect it 💅)
• --polly-delicm-max-ops=<int> — maximum number of isl operations to invest for lifetime analysis; 0 = no limit.
• --polly-detect-full-functions — allow the detection of full functions.
• --polly-dump-after — dump the module after Polly transformations into a file suffixed with "-after".
• --polly-dump-after-file=<string> — dump the module after Polly transformations to the given file.
• --polly-dump-before — dump the module before Polly transformations into a file suffixed with "-before".
• --polly-dump-before-file=<string> — dump the module before Polly transformations to the given file.
• --polly-enable-simplify — simplify SCoP after optimizations.
• --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.
• --polly-isl-arg=<argument> — option passed to ISL.
• --polly-on-isl-error-abort — abort if an isl error is encountered. 😵
• --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.
• --polly-only-region=<identifier> — only run on certain regions (the provided identifier must appear in the name of the region's entry block — again, the original paren just stops there, we keep it exactly as it is 🎀)
• --polly-only-scop-detection — only run scop detection, but no other optimizations.
• --polly-optimized-scops — Polly - dump the polyhedral description of Scops optimized with the isl scheduling optimizer and the set of post-scheduling transformations applied on the schedule tree.
• --polly-parallel — generate thread parallel code (isl codegen only).
• --polly-parallel-force — force generation of thread parallel code, ignoring any cost model. 💥
• --polly-pattern-matching-based-opts — perform optimizations based on pattern matching.
• --polly-process-unprofitable — process scops that are unlikely to benefit from Polly optimizations.
• --polly-register-tiling — enable register tiling.
• --polly-report — print information about the activities of Polly.
• --polly-show — highlight the code regions that will be optimized in a (CFG BBs and LLVM-IR instructions). 🌈
• --polly-show-only — highlight the code regions that will be optimized in a (CFG only BBs).
• --polly-stmt-granularity=<value> — the 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.
• --polly-vectorizer=<value> — select the vectorization strategy:
  • =none — no Vectorization.
  • =polly — Polly internal vectorizer.
  • =stripmine — strip-mine outer loops for the loop-vectorizer to trigger.

---

and that's a wrap on the whole page, bestie!! 🫶 you just read the entire thing, and honestly? iconic. this is modularize version 11, dated January 2022, from the MODULARIZE(1) manual page — go forth and modularize responsibly, mwah 💋✨