WASM-CTOR-EVAL(1)

📦
version 131 · 3 versions
, in ubuntu stonking

💅 NAME

wasm-ctor-eval — bestie, it runs your code at compile time. Yes, literally before anything even runs. The manual is WASM-CTOR-EVAL(1) if you're the type to cite sources. ✨

🦋 DESCRIPTION

================================================================================
wasm-ctor-eval INFILE

Execute code at compile time
================================================================================

okay so, the whole vibe: you hand it an INFILE, and it executes the code at compile time. That's the plot. 🎀

👑 wasm-ctor-eval options

these are the ones that actually do the thing you came here for:

  • --output, -o — the output file, aka where your little treasure goes 🫶
  • --emit-text, -S — emit text instead of binary for the output file (so you can actually read it, periodt)
  • --debuginfo, -g — emit the names section and debug info, for when you need to see exactly what's going on 👀
  • --ctors, -c — a comma-separated list of global constructor functions to evaluate, no cap
  • --kept-exports, -ke — comma-separated list of ctors whose exports we keep around even if we eval those ctors. Protective bestie behavior 🥺
  • --ignore-external-input, -ipi — assumes no env vars are to be read, stdin is empty, etc. Full hermit mode 🙈
  • --quiet, -q — do not emit verbose logging about the eval process. Silence is golden 💅

🛠️ Tool options

the feature-flag section. it's giving ✨control freak✨ but in a helpful way:

  • --mvp-features, -mvp — disable all non-MVP features
  • --all-features, -all — enable all features. everything. all of it. 🔥
  • --detect-features — (deprecated - this flag does nothing) so like, don't bother 💀
  • --quiet, -q — emit less verbose output and hide trivial warnings. yes this one shows up again, it's just That Girl 🎀
  • --experimental-poppy — parse wast files as Poppy IR for testing purposes
  • --emit-module-names — emit module names, even if not emitting the rest of the names section
  • --enable-sign-ext — enable sign extension operations
  • --disable-sign-ext — disable sign extension operations
  • --enable-threads — enable atomic operations
  • --disable-threads — disable atomic operations
  • --enable-mutable-globals — enable mutable globals
  • --disable-mutable-globals — disable mutable globals
  • --enable-nontrapping-float-to-int — enable nontrapping float-to-int operations
  • --disable-nontrapping-float-to-int — disable nontrapping float-to-int operations
  • --enable-simd — enable SIMD operations and types
  • --disable-simd — disable SIMD operations and types
  • --enable-bulk-memory — enable bulk memory operations
  • --disable-bulk-memory — disable bulk memory operations
  • --enable-bulk-memory-opt — enable memory.copy and memory.fill
  • --disable-bulk-memory-opt — disable memory.copy and memory.fill
  • --enable-call-indirect-overlong — enable LEB encoding of call-indirect (Ignored for compatibility as it has no effect on Binaryen)
  • --disable-call-indirect-overlong — disable LEB encoding of call-indirect (Ignored for compatibility as it has no effect on Binaryen)
  • --enable-exception-handling — enable exception handling operations
  • --disable-exception-handling — disable exception handling operations
  • --enable-tail-call — enable tail call operations
  • --disable-tail-call — disable tail call operations
  • --enable-reference-types — enable reference types
  • --disable-reference-types — disable reference types
  • --enable-multivalue — enable multivalue functions
  • --disable-multivalue — disable multivalue functions
  • --enable-gc — enable garbage collection
  • --disable-gc — disable garbage collection
  • --enable-memory64 — enable memory64
  • --disable-memory64 — disable memory64
  • --enable-relaxed-simd — enable relaxed SIMD
  • --disable-relaxed-simd — disable relaxed SIMD
  • --enable-extended-const — enable extended const expressions
  • --disable-extended-const — disable extended const expressions
  • --enable-strings — enable strings
  • --disable-strings — disable strings
  • --enable-multimemory — enable multimemory
  • --disable-multimemory — disable multimemory
  • --enable-stack-switching — enable stack switching
  • --disable-stack-switching — disable stack switching
  • --enable-shared-everything — enable shared-everything threads
  • --disable-shared-everything — disable shared-everything threads
  • --enable-fp16 — enable float 16 operations
  • --disable-fp16 — disable float 16 operations
  • --enable-custom-descriptors — enable custom descriptors (RTTs) and exact references
  • --disable-custom-descriptors — disable custom descriptors (RTTs) and exact references
  • --enable-multibyte — enable multibyte array loads and stores
  • --disable-multibyte — disable multibyte array loads and stores
  • --enable-relaxed-atomics — enable acquire/release atomic memory operations
  • --disable-relaxed-atomics — disable acquire/release atomic memory operations
  • --enable-custom-page-sizes — enable custom page sizes
  • --disable-custom-page-sizes — disable custom page sizes
  • --enable-wide-arithmetic — enable wide arithmetic
  • --disable-wide-arithmetic — disable wide arithmetic
  • --enable-compact-imports — enable compact import section
  • --disable-compact-imports — disable compact import section
  • --enable-typed-function-references — Deprecated compatibility flag
  • --disable-typed-function-references — Deprecated compatibility flag
  • --no-validation, -n — disables validation, assumes inputs are correct 🫣 (it's trusting you. fully. be normal about it)
  • --pass-arg, -pa — an argument passed along to optimization passes being run. Must be in the form KEY@VALUE. If KEY is the name of a pass then it applies to the closest instance of that pass before us. If KEY is not the name of a pass then it is a global option that applies to all pass instances that read it.
  • --closed-world, -cw — assume code outside of the module does not inspect or interact with GC and function references, even if they are passed out. The outside may hold on to them and pass them back in, but not inspect their contents or call them.
  • --preserve-type-order — preserve the order of types from the input (useful for debugging and testing)
  • --generate-stack-ir — generate StackIR during writing
  • --optimize-stack-ir — optimize StackIR during writing
  • --print-stack-ir — print StackIR during writing

🌈 General options

the "hi, how are you" options. the little guys. 🍓

  • --version — output version information and exit
  • --help, -h — show this help message and exit
  • --debug, -d — print debug information to stderr
💖 heads up bestie: a whole bunch of these flags literally say "Deprecated compatibility flag" or "deprecated - this flag does nothing" in the actual source, so don't come for me, I'm just the messenger ✨

and that's the whole page!! mwah 💋 you ate. this was wasm-ctor-eval version 131, page dated August 2026 — go forth and evaluate your constructors at compile time, icon 🎀💅👑

📦 where this page comes from