LLVM-MC(1)

✨ NAME ✨

okay so bestie, pull up a chair — this is the manual page for llvm-mc, version 13, section 1 (User Commands). It's literally the coolest little playground for machine code and I'm gonna walk you through every single flag, no skips, no cap. 💖

---

🎀 DESCRIPTION 🎀

🌈 OVERVIEW

llvm machine code playground — that's it, that's the vibe. It's giving sandbox energy. ✨

🦋 USAGE

llvm-mc [options] <input file>

💅 OPTIONS:

bestie listen. There are a LOT of options. Do not panic. We're going through all of them together, in order, and every single one is staying right where it is. 🫶

⭐ Color Options:

• --color — use colors in output, obvi. The default is autodetect, so it figures out for itself whether your terminal is that girl. 🌸

👑 Generic Options:

• --help — display the available options. Pass --help-hidden if you want the extra secret menu. 🙈
• --help-list — display a list of the available options. Pass --help-list-hidden for more. 🎀
• --version — display the version of this program. iykyk. ✨

🔥 MC Options:

• -I=<directory> — directory of include files.
• -M=<string> — disassembler options.
• --arch=<string> — target arch to assemble for. Not sure what's available? Run -version, it'll tell you. 💜

🧚 Action to perform:

• --as-lex — lex tokens from a .s file.
• --assemble — assemble a .s file. This one's the default, so if you just hit enter, this is what you get. main character energy fr. ⭐
• --disassemble — disassemble strings of hex bytes.
• --mdis — marked up disassembly of strings of hex bytes.
• --compress-debug-sections=<value> — choose your DWARF debug sections compression, bestie:
  • =none — no compression.
  • =zlib — use zlib compression.
  • =zlib-gnu — use zlib-gnu compression. heads up: this one is deprecated. 💀
• --defsym=<string> — defines a symbol to be an integer constant.
• --fdebug-compilation-dir=<string> — specifies the debug info's compilation dir.
• --fdebug-prefix-map=<= separated key-value pairs> — map file source paths in debug info.
• --filetype=<value> — choose an output file type:
  • =asm — emit an assembly (.s) file.
  • =null — don't emit anything at all. It's for timing purposes, so think of it as the "just vibing, producing nothing" mode. 🍓
  • =obj — emit a native object (.o) file.
• -g — generate dwarf debugging info for assembly source files.
• --large-code-model — create cfi directives that assume the code might be more than 2gb away.
• --main-file-name=<string> — specifies the name we should consider the input file.
• --masm-hexfloats — enable MASM-style hex float initializers (3F800000r).
• --masm-integers — enable binary and hex masm integers (0b110 and 0ABCh).
• --mattr=<a1,+a2,-a3,...> — target specific attributes. Need the deets? -mattr=help. 🦋
• --mcpu=<cpu-name> — target a specific cpu type. Again, -mcpu=help for details. ✨
• --motorola-integers — enable binary and hex Motorola integers (%110 and $ABC).
• -n — don't assume the assembly file starts in the text section.
• --no-exec-stack — file doesn't need an exec stack.
• -o=<filename> — output filename.
• --output-asm-variant=<uint> — syntax variant to use for output printing.
• --position-independent — position independent.
• --preserve-comments — preserve comments in outputted assembly.
• --print-imm-hex — prefer hex format for immediate values.
• --relax-relocations — emit R_X86_64_GOTPCRELX instead of R_X86_64_GOTPCREL.
• --save-temp-labels — don't discard temporary labels.
• --show-encoding — show instruction encodings.
• --show-inst — show internal instruction representation.
• --show-inst-operands — show instructions operands as parsed.
• --split-dwarf-file=<filename> — DWO output filename.
• --triple=<string> — target triple to assemble for. And yes, -version lists the available targets, we been knew. 🌈

---

and that's the whole page, bestie, you ate it. 💅

this has been llvm-mc version 13, from July 2023, manual page LLVM-MC(1) — mwah, go compile something iconic 👑✨