LLVM-MC(1)

📦
version 15.0.7 · 3 versions
, in ubuntu jammy

💖 NAME 💖

llvm-mc — the manual page for llvm-mc 15, bestie. That's it, that's the name section, periodt. 🎀

✨ DESCRIPTION ✨

OVERVIEW: it's literally a llvm machine code playground 🎠✨ (that's the official vibe, I'm not making it up)

USAGE:

llvm-mc [options] <input file>

OPTIONS: okay so here comes the whole menu. And yes, we're going through every single one — no skimming, no "you get the gist", none of that 🙅‍♀️💅

🎀 Color Options 🎀

  • --color — use colors in output, obviously, we love a pop of color. Default is autodetect — she figures it out herself, main character energy.

🦋 Generic Options 🦋

  • --help — display available options. There's also --help-hidden if you want more, because of course there is. 👀
  • --help-list — display a list of available options. And yup, --help-list-hidden exists too for the extra ones.
  • --version — display the version of this program. slay, know thyself.

👑 MC Options 👑

  • -I <directory> — directory of include files. Where your little include besties live 📁
  • -M <string> — disassembler options.
  • --arch=<string> — target arch to assemble for. Not sure which targets exist? Run -version, she'll tell you. 🌈

🌸 Action to perform: 🌸

  • --as-lex — lex tokens from a .s file. Just vibing with the tokens, no assembling 💅
  • --assemble — assemble a .s file. This is the default, so if you don't pick anything, this is what you get 🫶
  • --disassemble — disassemble strings of hex bytes. Reverse uno card 🔄
  • --mdis — marked up disassembly of strings of hex bytes. Same thing but with the ✨aesthetic✨

🍓 Back to the MC Options 🍓

  • --compress-debug-sections=<value> — choose DWARF debug sections compression. The options are:
    • =none — no compression. Raw, unfiltered, iconic.
    • =zlib — use zlib compression. Squish it 🗜️
  • --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. Your choices, bestie:
    • =asm — emit an assembly (.s) file
    • =null — don't emit anything at all. For timing purposes only, so like... a little experiment, not a lifestyle 😭
    • =obj — emit a native object (.o) file
  • -g — generate dwarf debugging info for assembly source files. Debug girlies rise 🧚
  • --large-code-model — create cfi directives that assume the code might be more than 2gb away. She's thinking big.
  • --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 tea? Use -mattr=help for details.
  • --mcpu=<cpu-name> — target a specific cpu type. Again, -mcpu=help for details, she's helpful like that 💜
  • --motorola-integers — enable binary and hex Motorola integers (%110 and $ABC).
  • -n — don't assume the assembly file starts in the text section. Rude to assume, honestly.
  • --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. She doesn't need anybody 🦋
  • --preserve-comments — preserve comments in outputted assembly. Respect the author's notes, fr fr 💖
  • --print-imm-hex — prefer hex format for immediate values.
  • --relax-relocations — emit R_X86_64_GOTPCRELX instead of R_X86_64_GOTPCREL. Very specific, very cunty, we love her for it.
  • --save-temp-labels — don't discard temporary labels. Keep the little guys 🥺
  • --show-encoding — show instruction encodings.
  • --show-inst — show internal instruction representation.
  • --show-inst-operands — show instructions operands as parsed. (Yep, that's the exact wording, I'm not touching it 🙈)
  • --split-dwarf-file=<filename> — DWO output filename.
  • --triple=<string> — target triple to assemble for. Wanna know what's available? -version, always -version ✨
okay so real talk, bestie: this whole page is from llvm-mc 15, dated July 2023, and the man page itself answers to LLVM-MC(1). That's the footer, and I'm folding it into a little goodbye kiss instead of a boring line 💋

mwah 💅 thanks for reading the whole thing, you ate that. now go assemble something iconic 👑

📦 where this page comes from