WASM-TOOLS(1)

📦 version 1.239.0, in ubuntu stonking

✨ WASM-TOOLS — the strip one ✨

okay so bestie, this is a page from the wasm-tools manual, and honestly? it's giving "understood the assignment." 💅

🌸 NAME 🌸

wasm-tools strip — Removes custom sections from an input WebAssembly file.

no cap, that's the whole mission. custom sections? gone. 🧹✨

💖 SYNOPSIS 💖

wasm-tools strip [OPTIONS] [INPUT]

look at her. so compact. so powerful. 🫶

🦋 DESCRIPTION 🦋

Removes custom sections from an input WebAssembly file.

So like, by default this command will strip all custom sections — think DWARF debugging information, all that extra luggage — straight out of a wasm file. ✨

BUT. and this is the important part, bestie — it will not strip the name section by default unless you pass the --all flag. so if you're like "wait why is the name section still here 😭" — that's why. it's on purpose. the name section gets special treatment, iykyk. 👑

📁 Arguments:

  • [INPUT] — Input file to process.

If it's not provided, or if it's literally just -, then stdin is read entirely and processed. and ngl, for most subcommands this input can either be a binary *.wasm file or a textual format *.wat file. both are welcome here, we don't gatekeep. 🌈

💅 OPTIONS 💅

  • --generate-dwarf <lines|full> — Optionally generate DWARF debugging information from WebAssembly text files.

so when the input to this command is a WebAssembly text file, like a *.wat, this option tells the text parser to insert DWARF debugging information that maps binary locations back to the original source locations in the input *.wat file. so you can actually trace stuff back. obsessed. 🔥

heads up though: this option has no effect if the INPUT argument is already a WebAssembly binary, or if the text format uses (module binary ...). literally nothing happens. it just sits there. 💀
  • -g — Shorthand for --generate-dwarf full. cute little shortcut, we love efficiency. ⭐
  • -o, --output <OUTPUT> — Where to place output.

If it's not provided, then stdout is used. default behaviour is default behaviour, periodt. 🎀

  • -v, --verbose... — Use verbose output (-v info, -vv debug, -vvv trace). the more v's, the more it tells you. main character energy with receipts. 👑
  • --color <COLOR> — Configuration over whether terminal colors are used in output.

Supports one of auto|never|always|always-ansi. The default is to detect what to do based on the terminal environment, for example by using isatty.

[default: auto] — she just figures it out herself. self-aware queen. ✨

  • -a, --all — Remove all custom sections, regardless of name. yes, even the name one. this is the one that finally gets her. 🫶
  • -d, --delete <REGEX> — Remove custom sections matching the specified regex. surgical. precise. iconic. 🎯
  • -t, --wat — Output the text format of WebAssembly instead of the binary format. so you get the readable version. very demure, very mindful. 🌸
  • -h, --help — Print help (see a summary with -h). always check the help bestie, it never lies. 💜
🌟 lowkey the vibe check here: default behaviour strips everything custom except name, --all removes literally all custom sections, -d only nukes the ones matching your regex, and --generate-dwarf is only doing anything when your input is a *.wat. get that right and you ate. 🍓

and that's the page, bestie!! 🦋💖 this was wasm-tools strip, version 1.239.0+ds, dated August 2026. go forth and strip responsibly. mwah. 💅✨👑

📦 where this page comes from