LLVM-MC(1)

💅 LLVM-MC(1)

okay so this is the llvm-mc manual page, and it lives in the User Commands manual — yes, the manual name is folded in right here at the top like a little name tag 🫶. It's the page for llvm-mc 18, and bestie, we're gonna go through it together, no cap ✨.

🌸 NAME

llvm-mc - manual page for llvm-mc 18. That's the whole name section: short, iconic, periodt 💅.

🌈 DESCRIPTION

okay so here's the vibe. OVERVIEW: llvm machine code playground.

USAGE: the usage is literally:

llvm-mc [options] <input file>

Then it's giving OPTIONS: — and bestie, I got you, every single one is below 🫶. No skipping, no summarizing, fr fr.

💅 OPTIONS

Full options buffet. Zero crumbs left behind, periodt 💅.

🎨 Color Options

• --color — Use colors in output (default=autodetect). The default is autodetect, so it's not just gonna assume — it checks first 🎀.

🧚 Generic Options

• --help — Display available options (--help-hidden for more). Very helpful, very demure.
• --help-list — Display list of available options (--help-list-hidden for more). List girlie 📋.
• --version — Display the version of this program. Version check, slay ✅.

🔥 MC Options

• -I <directory> — Directory of include files. Include path vibes 📁.
• -M <string> — Disassembler options. Disassembler knob moment.
• --arch=<string> — Target arch to assemble for, see -version for available targets. Arch check!

Action to perform:

• --as-lex — Lex tokens from a .s file. Token tea 🍵.
• --assemble — Assemble a .s file (default). This is the default, bestie 👑.
• --disassemble — Disassemble strings of hex bytes. Hex goblin mode 🔥.
• --mdis — Marked up disassembly of strings of hex bytes. Marked-up moment ✨.
• --cdis — Colored disassembly of strings of hex bytes. Colorful chaos 🌈.
• --compress-debug-sections=<value> — Choose DWARF debug sections compression:
  • =none — No compression
  • =zlib — Use zlib
  • =zstd — Use zstd
• --defsym=<string> — Defines a symbol to be an integer constant. Symbol slay.
• --fdebug-compilation-dir=<string> — Specifies the debug info's compilation dir. Debug dir details.
• --fdebug-prefix-map=<= separated key-value pairs> — Map file source paths in debug info. Path mapping, iykyk.
• --filetype=<value> — Choose an output file type:
  • =asm — Emit an assembly (.s) file
  • =null — Don't emit anything (for timing purposes)
  • =obj — Emit a native object (.o) file
• -g — Generate dwarf debugging info for assembly source files. Debug info era 🐛.
• --large-code-model — Create cfi directives that assume the code might be more than 2gb away. Big code model energy.
• --main-file-name=<string> — Specifies the name we should consider the input file. Main character file name 👑.
• --masm-hexfloats — Enable MASM-style hex float initializers (3F800000r). Hex float moment.
• --masm-integers — Enable binary and hex masm integers (0b110 and 0ABCh). Masm integer vibes.
• --mattr=<a1,+a2,-a3,...> — Target specific attributes (-mattr=help for details). Attribute check!.
• --mcpu=<cpu-name> — Target a specific cpu type (-mcpu=help for details). CPU moment.
• --motorola-integers — Enable binary and hex Motorola integers (%110 and $ABC). Motorola integers, iconic.
• -n — Don't assume assembly file starts in the text section. No assumptions.
• --no-exec-stack — File doesn't need an exec stack. Stack says no.
• -o <filename> — Output filename. Output go brrr.
• --output-asm-variant=<uint> — Syntax variant to use for output printing. Syntax variant tea.
• --position-independent — Position independent. PIE vibes.
• --preserve-comments — Preserve Comments in outputted assembly. Keep the comments! 💬.
• --print-imm-hex — Prefer hex format for immediate values. Hex immediates, slay.
• --relax-relocations — Emit R_X86_64_GOTPCRELX instead of R_X86_64_GOTPCREL. Relocation glow-up.
• --save-temp-labels — Don't discard temporary labels. Save the temp labels 🎀.
• --show-encoding — Show instruction encodings. Encoding reveal.
• --show-inst — Show internal instruction representation. Internal representation moment.
• --show-inst-operands — Show instructions operands as parsed. Operands as parsed, periodt.
• --split-dwarf-file=<filename> — DWO output filename. DWO file name.
• --triple=<string> — Target triple to assemble for, see -version for available targets. Triple check!

---

k bye bestie 💖 — this page is from llvm-mc 18, dated June 2025, under LLVM-MC(1). slay, go assemble something cute ✨.