LLVM-AS(1)

✨ LLVM-AS(1) ✨

okay so this is the llvm-as page from the LLVM manual, bestie — the LLVM assembler. and like, section "19", dated 2025-01-17, from the LLVM fam. we'll get to that at the end, don't worry 💅

---

🌸 NAME 🌸

llvm-as — the LLVM assembler. that's it, that's the whole vibe. she assembles. 🫶

---

🦋 SYNOPSIS 🦋

llvm-as [options] [filename]

yes that's literally it. options AND a filename, both optional, she's flexible like that ✨

---

💖 DESCRIPTION 💖

so llvm-as is the LLVM assembler, and honestly? main character energy. here's the tea: she reads a file that contains human-readable LLVM assembly language, translates it into LLVM bitcode, and then writes the result into a file or straight to standard output. glow-up complete 🔥

if filename is omitted, or if it's just -, then llvm-as reads its input from standard input. no filename? no problem, she'll take it from stdin like a champ.

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

• if the input is standard input, then the output is standard output. simple, symmetric, iconic.
• 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.
• 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.

so like, .ll gets swapped to .bc, but anything else gets .bc stapled on the end. little detail, huge consequences, iykyk 💀

---

🎀 OPTIONS 🎀

• -f — enable binary output on terminals. normally llvm-as will refuse to write raw bitcode output if the output stream is a terminal (she's got boundaries, respect them 🙈). with this option, llvm-as will write raw bitcode regardless of the output device. raw and unfiltered, no cap.
• -help — print a summary of command line options. when you forget everything, she reminds you. bestie behavior fr fr 💜
• -o filename — specify the output file name. and if filename is -, then llvm-as sends its output to standard output. dash means stdout, always and forever ✨

---

🌈 EXIT STATUS 🌈

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

otherwise, if an error occurs, it will exit with a non-zero value. not slay. 😭 but at least the terminal knows something went wrong, which is honestly the most you can ask for.

---

🧚 SEE ALSO 🧚

• llvm-dis(1)
• as(1)

the reverse girlie and the classic. go read those too, bestie, cross-referencing is self-care 🦋

---

👑 AUTHOR 👑

maintained by the LLVM Team (https://llvm.org/). they keep the lights on, we stan 🫶

---

⭐ COPYRIGHT ⭐

2003-2025, LLVM Project

---

k that's the whole page, you're officially educated, go assemble something gorgeous 💅

~ and a lil sign-off: this cutie came out as page 19 of the manual, dated 2025-01-17, under the LLVM-AS(1) title. see you in the group chat 💖