LLVM-DIS(1)

💅 LLVM-DIS(1) — bestie's guide to the LLVM disassembler

okay so this is llvm-dis, the LLVM disassembler ✨ (yes, the page header literally says LLVM-DIS(1) — that's how you know it's official). Sit down, grab a strawberry 🍓, we're turning robot-brain bitcode back into something a human can actually read.

---

🌸 SYNOPSIS 🌸

llvm-dis [options] [filename]

---

🦋 DESCRIPTION 🦋

okay so the llvm-dis command is the LLVM disassembler. it takes an LLVM bitcode file and converts it into human-readable LLVM assembly language. that's it. that's the vibe check and it passed 💅

if filename is omitted or specified as -, llvm-dis reads its input from standard input. lowkey convenient.

and here's the auto-pilot part: if the input is being read from standard input, then llvm-dis will send its output to standard output by default. otherwise, the output will be written to a file named after the input file, with a .ll suffix added (any existing .bc suffix will first be removed — yes, it does the little cleanup for you, icon behavior ✨). you can override the choice of output file using the -o option.

no cap, this is the whole tool: bitcode in, assembly out, filenames handled for you.

---

🎀 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" main character energy 🔥
• -help — print a summary of command line options. the little cheat sheet, the group-chat recap, the iykyk 👑
• -o filename — specify the output file name. if filename is -, then the output is sent to standard output. simple as that 🫶

---

💀 EXIT STATUS 💀

if llvm-dis succeeds, it will exit with 0. otherwise, if an error occurs, it will exit with a non-zero value. so like... 0 means slay, non-zero means something went wrong and you should go read the error 😭

---

🌈 SEE ALSO 🌈

• llvm-as(1) — the other half of the duo, the reversible bestie 💜

---

👑 AUTHOR 👑

maintained by the LLVM Team (https://llvm.org/). they're literally keeping the lights on, respect 🫶

---

⭐ COPYRIGHT ⭐

2003-2023, LLVM Project

---

and that's the whole page, bestie 🧚 — signed off from the LLVM source, dated 2023-01-14, and yes it's page 15 of the LLVM-DIS(1) manual. periodt 💅✨