LLVM-DIS(1)

💖 llvm-dis — the LLVM disassembler 💖

okay bestie, welcome to the LLVM corner of the group chat, section 1, page LLVM-DIS(1), and today we're talking about the lil tool that turns crunchy robot bytes back into something your eyeballs can actually read. no cap. 🦋

---

✨ NAME ✨

llvm-dis — the LLVM disassembler, aka the un-scrambler, aka the glow-up machine 🫶

---

🌸 SYNOPSIS 🌸

llvm-dis [options] [filename]

---

💅 DESCRIPTION 💅

so llvm-dis is the LLVM disassembler. it takes an LLVM bitcode file and converts it into human-readable LLVM assembly language. that's the whole vibe. bitcode in, gorgeous legible assembly out. ate. 🔥

if filename is omitted, or if it's specified as -, then llvm-dis reads its input from standard input. literally just pipes it straight into its lil heart. 🥺

and here's the part where you gotta pay attention: if the input is being read from standard input, then llvm-dis will send its output to standard output by default. but otherwise, the output gets written to a file named after the input file, with a .ll suffix added — and before that happens, any existing .bc suffix will first be removed. so your thing.bc becomes thing.ll, iconic behaviour honestly. ✨

you can override the choice of output file using the -o option. you're the main character, you get to decide. 👑

---

🎀 OPTIONS 🎀

• -f — enable binary output on terminals. normally, llvm-dis will refuse to write raw bitcode output if the output stream is a terminal. with this option, llvm-dis will write raw bitcode regardless of the output device. it's giving "i know what i'm doing" energy, and maybe you do, and maybe you don't, but either way it's gonna do it. 💀
• -help — print a summary of command line options. your friendly lil menu, no judgment, just facts. 📋
• -o filename — specify the output file name. if filename is -, then the output is sent to standard output. simple as that, bestie. 🍓

---

🦋 EXIT STATUS 🦋

if llvm-dis succeeds, it will exit with 0. clean. flawless. no notes. ✨

otherwise, if an error occurs, it will exit with a non-zero value. 😭 we don't love that for us, but at least you'll know.

---

🌈 SEE ALSO 🌈

llvm-as(1) — the other half of the situationship, the one that goes the other direction. iykyk. 💜

---

💖 AUTHOR 💖

maintained by the LLVM Team (https://llvm.org/). they're doing the lord's work fr fr. 🙏

---

👑 COPYRIGHT 👑

2003-2025, LLVM Project

---

and that's the whole page, babes — this was page 14 of LLVM-DIS(1), dated 2025-05-22, brought to you by the LLVM crew. go disassemble something and feel like a genius. mwah. 💅🎀🌸