MODULARIZE(1)

📦 version 12.0.1, in ubuntu jammy

🎀 MODULARIZE(1) 🎀

okay so hi bestie 💖 welcome to the manual page for modularize — that's modularize 12, and it lives in section 1 of the manual, aka User Commands. Grab a boba, we're doing this 💅

✨ NAME ✨

modularize — the manual page for modularize 12. That's literally it, that's the whole section 🫶

🦋 DESCRIPTION 🦋

OVERVIEW: modularize.

USAGE:

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

So you pass it your [options], then a list of one or more header list files, and then whatever arguments you want forwarded to the front end. That's the whole vibe ✨

🌈 OPTIONS 🌈

💖 Color Options 💖

--color — use colors in output (default=autodetect). She's giving ✨aesthetic✨ but only when your terminal says it's that girl.

🎀 General options 🎀

-I=<path> — include path for the coverage check. Point her at the right place bestie 📂
--aarch64-neon-syntax=<value> — choose the style of NEON code to emit from the AArch64 backend:
- =generic — emit generic NEON assembly
- =apple — emit Apple-style NEON assembly
--abort-on-max-devirt-iterations-reached — abort when the max iterations for the devirtualization CGSCC repeat pass is reached. She hits the limit, she stops, periodt 💀
--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-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 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 — the source gives us no description for this one, bestie, but she's real and she's here 🙈
--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.
--block-check-header-list-only — only warn if #include directives are inside extern or namespace blocks if 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 source, but she's on the list 💅
--cfg-hide-unreachable-paths — also flying description-free, iconic honestly 🦋
--code-model=<value> — choose 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
- =size-latency — code size and latency
--coverage-check-only — only do the coverage check. Nothing else, just the check 🎯
--cvp-dont-add-nowrap-flags — description not supplied by the source, but noted 👑
--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> — kind of debug info to add:
- =locations — locations only
- =location+variables — locations and variables
--debugify-quiet — suppress verbose debugify output. shhh 🤫
--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, 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.
--dot-cfg-mssa=<file name for generated dot file> — file name for 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 — source says nothing about this one, but it's here and we respect her 🙌
--enable-gvn-sink — enable the GVN sinking pass (default = off).
--enable-load-in-loop-pre — no description given, still slaying 💅
--enable-load-pre — likewise description-free, love that for her ✨
--enable-loop-simplifycfg-term-folding — again, no description in the source 🌸
--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 supplied, but noted bestie 🫶
--enable-unsafe-fp-math — enable optimizations that may decrease FP precision. Careful with this one, okay? 👀
--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. Experimental, so you know what that means 🧪
--fatal-warnings — treat warnings as errors. No chill, zero, none 💀
--filetype=<value> — pick a file type, bestie (and no, 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)
--force-dwarf-frame-section — always emit a debug frame section.
--fp-contract=<value> — 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=<value> — specify frame pointer elimination optimization
- =all — disable frame pointer elimination
- =non-leaf — disable frame pointer elimination for non-leaf frame
- =none — enable frame pointer elimination
--function-sections — emit functions into separate sections
--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
--hot-cold-split — enable hot-cold splitting pass
--ignore-xcoff-visibility — not emit the visibility attribute for asm in AIX OS or give all symbols 'unspecified' visibility in XCOFF object file
--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-iterations=<uint> — limit the maximum number of instruction combining iterations
--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
--instcombine-negator-enabled — should we attempt to sink negations?
--instcombine-negator-max-depth=<uint> — what is the maximal lookup depth when trying to check for viability of negation sinking.
--instcombine-unsafe-select-transform — enable poison-unsafe select to and/or transform
--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.
--lto-embed-bitcode=<value> — embed LLVM bitcode in object files produced by LTO
- =none — do not embed
- =optimized — embed after all optimization passes
- =post-merge-pre-opt — embed post merge, but before optimizations
--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
--march=<string> — 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 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)
--meabi=<value> — set EABI type (default depends on triple):
- =default — triple default EABI version
- =4 — EABI version 4
- =5 — EABI version 5
- =gnu — EABI GNU
--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
- =v67 — build for HVX v67
--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 — enable mips16 constant islands.
--mips16-hard-float — enable mips16 hard float.
--mir-strip-debugify-only — should mir-strip-debug only strip debug info from debugified modules by default
--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
--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.
--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
--no-coverage-check — don't do the coverage check.
--no-deprecated-warn — suppress all deprecated warnings
--no-discriminators — disable generation of discriminator information.
--no-warn — suppress all warnings
--no-xray-index — don't emit xray_fn_idx section
--nozero-initialized-in-bss — don't place zero-initialized symbols into bss section
--nvptx-sched4reg — NVPTX Specific: schedule for register pressue
--poison-checking-function-local — check that returns are non-poison (for testing)
--prefix=<string> — prepend header file paths with this prefix. If not specified, the files are considered to be 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.
--pseudo-probe-for-profiling — emit pseudo probes for AutoFDO
--r600-ir-structurize — use StructurizeCFG IR pass
--rdf-dump — (no description in the original — it's giving mystery)
--rdf-limit=<uint> — (no description in the original — it's giving mystery)
--relax-elf-relocations — emit GOTPCRELX/REX_GOTPCRELX instead of GOTPCREL on x86-64 ELF
--relocation-model=<value> — choose relocation model
- =static — non-relocatable code
- =pic — fully relocatable, position independent code

okay we're still deep in option city bestie, no exit yet, keep scrolling 💅

=dynamic-no-pic — relocatable external references but non-relocatable code
=ropi — code and read-only data are relocatable, and they get accessed PC-relative
=rwpi — read-write data is relocatable, accessed relative to the static base
=ropi-rwpi — both of the above, the iconic combo meal 🍓
--root-module=<string> — tell it the name of the root module
--runtime-counter-relocation — turns on relocating counters at runtime
--safepoint-ir-verifier-print-only — no description on the page for this one, it's giving mysterious 🫥
--sample-profile-check-record-coverage=<N> — emits a warning if less than N% of the records in the input profile actually match up to the IR
--sample-profile-check-sample-coverage=<N> — emits a warning if less than N% of the samples in the input profile match the IR
--sample-profile-max-propagate-iterations=<uint> — max number of iterations it goes through when propagating sample block/edge weights through the CFG
--skip-ret-exit-block — suppresses counter promotion if exit blocks contain ret
--speculative-counter-promotion-max-exiting=<uint> — the max number of exiting blocks a loop can have for speculative counter promotion to be allowed
--speculative-counter-promotion-to-loop — when this is false and the target block is in a loop, promotion gets disallowed unless the promoted counter update can be further/iteratively promoted into an acyclic region
--split-machine-functions — splits cold basic blocks out of machine functions, based on profile info
--stack-alignment=<uint> — overrides the default stack alignment
--stack-protector-guard=<string> — stack protector guard mode
--stack-protector-guard-offset=<uint> — stack protector guard offset
--stack-protector-guard-reg=<string> — stack protector guard register
--stack-size-section — emits a section that contains stack size metadata
--stack-symbol-ordering — orders local stack symbols
--stackrealign — forces the stack to align to the minimum alignment
--summary-file=<string> — the summary file used for function importing
--tail-predication=<value> — MVE tail-predication pass options, and it has moods:
- =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 — turns fastcc calls into tail calls by (potentially) changing the ABI
--thinlto-assume-merged — assumes the input has already been through ThinLTO function importing and the other pre-optimization pipeline changes
--thread-model=<value> — choose your threading model:
- =posix — POSIX thread model
- =single — single thread model
--threads=<int> — literally no description on the page, she's mysterious, she's lowkey hiding 🌸
--tls-size=<uint> — bit size of immediate TLS offsets
--unique-basic-block-section-names — gives unique names to every basic block section
--unique-section-names — gives unique names to every section
--use-ctors — uses .ctors instead of .init_array
--vec-extabi — enables the AIX Extended Altivec ABI
--verify-region-info — verifies region info (heads up: it's time consuming ⏳)
--vp-counters-per-site=<number> — the average number of profile counters allocated per value profiling site
--vp-static-alloc — does static counter allocation for the value profiler
--x86-align-branch=<string> — specify which 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> — controls 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 so they don't end up across or against the boundary of the specified size. The default value 0 doesn't align branches at all.
--x86-branches-within-32B-boundaries — aligns selected instructions to mitigate the negative performance impact of Intel's micro code update for errata skx102.

⚠️ This may break assumptions about labels corresponding to particular instructions, and should be used with caution. Not a vibe to be reckless with, bestie 💀

--x86-pad-max-prefix-size=<uint> — maximum number of prefixes to use for padding
--xcoff-traceback-table — emits the XCOFF traceback table

✨ Generic Options ✨

--help — displays available options (--help-hidden for more)
--help-list — displays the list of available options (--help-list-hidden for more)
--version — displays the version of this program

🌈 Polly Options 🌈

Configure the polly loop optimizer

--polly — enables the polly optimizer (only at -O3)
--polly-2nd-level-tiling — enables a 2nd level loop of loop tiling
--polly-ast-print-accesses — prints memory access functions
--polly-context=<isl parameter set> — provides 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.
--polly-delicm-max-ops=<int> — maximum number of isl operations to invest for lifetime analysis; 0=no limit
--polly-detect-full-functions — allows the detection of full functions
--polly-dump-after — dumps the module after Polly transformations into a file suffixed with "-after"
--polly-dump-after-file=<string> — dumps the module after Polly transformations into the given file
--polly-dump-before — dumps the module before Polly transformations into a file suffixed with "-before"
--polly-dump-before-file=<string> — dumps the module before Polly transformations into the given file
--polly-enable-simplify — simplifies SCoP after optimizations
--polly-ignore-func=<string> — ignores functions that match a regex. You can comma-separate multiple regexes. Scop detection will ignore all functions that match ANY of the regexes you provided.
--polly-isl-arg=<argument> — option passed to ISL
--polly-on-isl-error-abort — aborts if an isl error is encountered
--polly-only-func=<string> — only runs on functions matching 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 runs on certain regions (the provided identifier must appear in the name of the region's entry block
--polly-only-scop-detection — only runs scop detection, no other optimizations
--polly-optimized-scops — Polly - dumps the polyhedral description of Scops optimized with the isl scheduling optimizer, and the set of post-scheduling transformations is applied on the schedule tree
--polly-parallel — generates thread parallel code (isl codegen only)
--polly-parallel-force — forces generation of thread parallel code, ignoring any cost model
--polly-pattern-matching-based-opts — performs optimizations based on pattern matching
--polly-process-unprofitable — processes scops that are unlikely to benefit from Polly optimizations
--polly-register-tiling — enables register tiling
--polly-report — prints information about the activities of Polly

and that's where this part stops — there's more coming, don't you dare close the tab 🫶

--polly-show — lights up ✨the code regions that will be optimized✨ — and it shows them in both the CFG BBs and the LLVM-IR instructions, so you get the whole glow-up in one look 👀🔥
--polly-show-only — same energy, but only the CFG BBs get the highlight treatment. LLVM-IR instructions stay unbothered 💅
--polly-stmt-granularity=<value> — picks which algorithm we use to split basic blocks into multiple statements. The algorithm choice is giving very important decisions, so here are your options:
- =bb — one statement per basic block, simple as that 🎀
- =scalar-indep — the scalar independence heuristic, iykyk 🧚
- =store — store-level granularity, granular like a strawberry sugar scrub 🍓
--polly-target=<value> — the hardware we're targeting, bestie. Which hardware, you ask?
- =cpu — generate CPU code 💻
--polly-tiling — enable loop tiling 🔲✨ not to be confused with bathroom tiling, but honestly? same satisfying vibe
--polly-vectorizer=<value> — picks your vectorization strategy, main character energy only:
- =none — no vectorization. We're sitting this one out 🙈
- =polly — Polly's own internal vectorizer, homegrown and iconic 👑
- =stripmine — strip-mine outer loops so the loop-vectorizer can actually trigger. It's giving setup for success 🌈

and that's a wrap on the whole page, bestie!! 🎀 this one's modularize, release 12, dated February 2022, and it goes by MODULARIZE(1) when it's being formal 🦋 mwah, stan a well-documented man page 💖

📦 where this page comes from

ubuntu jammy: clang-tools-12 1:12.0.1-19ubuntu3 · 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