LLVM-AS(1)

💅 llvm-as — the LLVM assembler, bestie

okay so like, this is the manpage for llvm-as, and it's part of the LLVM manual family. yes it's a whole manual section, we're being fancy today. let me tell you everything, no cap. ✨

---

🌸 NAME 🌸

llvm-as — the LLVM assembler 🛠️💖

---

🎀 SYNOPSIS 🎀

llvm-as [options] [filename]

that's it. that's the whole vibe. ✨

---

🦋 DESCRIPTION 🦋

okay so llvm-as is the LLVM assembler. it reads a file that has human-readable LLVM assembly language in it, translates that into LLVM bitcode, and then writes the result into a file or straight to standard output. it's giving translator energy, but make it compilers. 💅

if you don't give it a filename, or if filename is literally just -, then llvm-as reads its input from standard input. so you can pipe stuff in, slay. 🫶

and if you don't specify an output file with the -o option, then llvm-as sends its output to a file or to standard output by following these rules, and yes bestie you need to know all three:

• If the input is standard input, then the output is standard output. ✨
• If the input is a file that ends with .ll, then the output file is of the same name, except that the suffix is changed to .bc. so like, glow-up but for file extensions. 🦋
• If the input is a file that does not end with the .ll suffix, then the output file has the same name as the input file, except that the .bc suffix is appended. no suffix left behind. 💖

---

✨ OPTIONS ✨

• -f — Enable binary output on terminals. Normally, llvm-as will refuse to write raw bitcode output if the output stream is a terminal. With this option, llvm-as will write raw bitcode regardless of the output device. so basically it's the "i know what i'm doing" flag. it's giving fearless. 🔥
• -help — Print a summary of command line options. when you're lost, ask for help, that's main character energy fr fr. 🌈
• -o filename — Specify the output file name. If filename is -, then llvm-as sends its output to standard output. yes, dash means "send it to stdout," iconic behavior honestly. 💅

---

💀 EXIT STATUS 💀

If llvm-as succeeds, it will exit with 0. Otherwise, if an error occurs, it will exit with a non-zero value. so like, 0 = we ate, non-zero = we did not eat. 😭

---

👑 SEE ALSO 👑

llvm-dis(1), as(1)

go read those too, they're part of the lore, iykyk. 🧚

---

🌸 AUTHOR 🌸

Maintained by the LLVM Team (https://llvm.org/). they're the parents of this whole ecosystem, we love them for it. 🫶

---

💜 COPYRIGHT 💜

2003-2025, LLVM Project

---

and that's the whole thing, bestie!! 💖 this page is from the LLVM manual, dated 2025-09-03, and it's the LLVM-AS(1) page — like page one of the LLVM manual section, periodt. now go assemble something iconic. ✨🎀🦋