LLVM-MC(1)

📦
version 16.0.6 · 2 versions
, in ubuntu noble

💖 NAME 💖

llvm-mc — bestie, this is the manual page for llvm-mc 16. It's the LLVM machine code playground, and yes we ARE playing in it. 🛝✨

🌈 DESCRIPTION 🌈

okay so, straight from the source, the OVERVIEW is literally: llvm machine code playground 🎢

And the USAGE? Here's exactly how you run it, no notes:

llvm-mc [options] <input file>

then it's just… OPTIONS: and a whole buffet of them. let's go, we're going down the list one by one because I love you and I refuse to let you skip any. 💅

🎨 Color Options

  • --color — use colors in output 💖 the default here is autodetect, meaning it peeks around and decides for itself whether your terminal can handle the sparkle. 🦋

🛠️ Generic Options

  • --help — display available options (and --help-hidden for more, if you're nosy 👀)
  • --help-list — display a list of available options (--help-list-hidden for more, same energy)
  • --version — display the version of this program. iconic. 👑

🧚 MC Options

  • -I <directory> — directory of include files 📁
  • -M <string> — disassembler options
  • --arch=<string> — target arch to assemble for, see -version for available targets

💫 Action to perform:

  • --as-lex — lex tokens from a .s file 🔤
  • --assemble — assemble a .s file. this one is the default, so if you say nothing, it's already doing this. main character behavior fr 🫶
  • --disassemble — disassemble strings of hex bytes 🔢
  • --mdis — marked up disassembly of strings of hex bytes ✨

back to the rest of the MC options 💅

  • --compress-debug-sections=<value> — choose DWARF debug sections compression. your vibes-based menu is:
    • =none — no compression 🍃
    • =zlib — use zlib
    • =zstd — use zstd
  • --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 (for timing purposes) 👻
    • =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 (-mattr=help for details) ⚙️
  • --mcpu=<cpu-name> — target a specific cpu type (-mcpu=help for details) 🧠
  • --motorola-integers — enable binary and hex Motorola integers (%110 and $ABC) 🏍️
  • -n — don't assume 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, see -version for available targets 🎯
bestie that's the whole list, every single one, I did not gatekeep a thing. 🫶

and that's a wrap on llvm-mc 16, brought to you by the April 2024 edition of the page. go assemble something cute. byeee 💜✨🎀

📦 where this page comes from