LLVM-DIS(1)

💅 LLVM-DIS(1) — the LLVM disassembler, bestie edition

okay so real talk, this is the llvm-dis page from the LLVM manual set, and I'm gonna walk you through it like we're texting at 2am 🦋

---

✨ NAME ✨

llvm-dis — literally the LLVM disassembler. that's her job title, that's her whole brand 💅

---

🎀 SYNOPSIS 🎀

llvm-dis [options] [filename]

---

🌸 DESCRIPTION 🌸

okay so picture this: llvm-dis is the LLVM disassembler, and she is so good at it. she takes an LLVM bitcode file (you know, the crunchy binary one) and converts it into human-readable LLVM assembly language. it's giving translator, it's giving glow-up, it's giving "i can fix him" but for files 💖

if filename is omitted, or you literally just pass -, then llvm-dis reads its input from standard input. no file? no problem. she's flexible like that 🫶

and here's the part where you gotta pay attention, bestie: if the input is being read from standard input, then llvm-dis will send its output to standard output by default. makes sense, right? but otherwise — like when you actually gave her a real file — the output gets written to a file named after the input file, with a .ll suffix added. and lowkey important: any existing .bc suffix will first be removed, so you don't end up with something cursed like thing.bc.ll 🙈

you can override the choice of output file using the -o option. main character energy, she lets you 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 (she's protective, she's looking out for you). with this option though, llvm-dis will write raw bitcode regardless of the output device. no cap, she said what she said 💀
• -help — print a summary of command line options. that's your "wait what were the flags again" button, and honestly we all need it 😭
• -o filename — specify the output file name. and if filename is -, then the output is sent to standard output. iconic, consistent, we love her 🔥

---

🌈 EXIT STATUS 🌈

if llvm-dis succeeds, it will exit with 0. slay 🎉

otherwise, if an error occurs, it will exit with a non-zero value. so like, if you see a non-zero, something went sideways, go check your vibes check 🫶

---

⭐ SEE ALSO ⭐

llvm-as(1) — the other half of the duo, iykyk 👑

---

🧚 AUTHOR 🧚

maintained by the LLVM Team (https://llvm.org/). yes, the LLVM Team. royalty 🌸

---

👑 COPYRIGHT 👑

2003-2023, LLVM Project — periodt 💅

---

and that's the whole page, bestie!! this lil walkthrough came to you courtesy of the LLVM-DIS(1) manual page, page 17, dated 2023-12-01, from the LLVM book itself. mwah, go disassemble something 🍓💜