ASMC(1)

📦 version 2.39.07, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 ASMC(1) — User Commands 💖

okay bestie, sit down, hydrate, because we're about to talk about asmc, aka the Asmc Macro Assembler. she's an assembler. she's iconic. she's gonna turn your little .asm files into actual machine code and she does NOT need an attitude about it. let's go 🦋

✨ NAME ✨

asmc — the Asmc Macro Assembler. that's it, that's the girl. 🎀

🌸 SYNOPSIS 🌸

asmc [options] filename [ [options] filename] ... [-link link_options]

literally just: options, filename, options, filename, repeat until you're happy, then optionally hand off to the linker. the way she just keeps accepting more files? main character energy fr. 💅

🫶 DESCRIPTION 🫶

Asmc Macro Assembler. that's the whole description and honestly? she said "I contain multitudes, look at the OPTIONS section." and she's right. 👑

💖 OPTIONS 💖

so this is the part where it gets long. do not panic. we're gonna go through every single one. every flag, every default, every letter. no skipping, no cap. 🙈

  • -{0|1|..|10}[p] — sets the CPU target, bestie. pick your vibe: 0=8086 (this is the default, she's a classic), 1=80186, 2=80286, 3=80386, 4=80486, 5=Pentium, 6=PPro, 7=P2, 8=P3, 9=P4, 10=x86-64. tack a p on the end and you get to use privileged instructions. (yes that's as dangerous as it sounds. behave. 🔥)
  • -arch:option — tells her which architecture to generate code for. valid options are: IA32, SSE, SSE2, AVX, AVX2, and AVX512. pick one, slay. ✨
  • -assert — generates .assert code. asserting your dominance over your own assertions. 💅
  • -autostack — calculates the stack space your arguments are gonna need. she does the math so you don't have to, and math is her passion. 🧚
  • -bin — generates a plain binary file. raw. unfiltered. no container, no ceremony. 💀
  • -Blfilename — selects an alternate linker, the one living at filename. yes, the filename is glued right onto the flag. iykyk.
  • -c — assembles only. does no linking. she does her part and then she's DONE, she is not doing your linker's job for them. 🚫
  • -Cs — pushes user registers before the stack-frame gets created in a proc. order matters, periodt.
  • -coff — generates a COFF format object file. windows girlies rise up. 🪟
  • -C{p|u|x} — sets OPTION CASEMAP. and here are the flavors:
    • -Cp — preserves the case of all user identifiers. she remembers EVERYTHING exactly how you wrote it. 💅
    • -Cu — maps all identifiers to upper case. this one is the default. (yeah, all caps by default, she's been yelling this whole time 😭)
    • -Cx — preserves case in public and extern symbols. selective memory, love that for her.
  • -Dsymbol[=value] — defines a text macro with the given symbol name. if the value is missing, it's just blank, no drama. and heads up: if you've got multiple tokens separated by spaces, you must wrap them in quotation marks. she will not be guessing what you meant. 🙈
  • -dotname — allows identifier names to begin with a period. little dots, big freedom. ⭐
  • -enumber — sets the error limit to number. after that many errors she's tapping out. 😭
  • -elf[64] — generates an ELF object file, and there's a little family here:
    • -elf — generates a 32-bit ELF object file.
    • -elf64 — generates a 64-bit ELF object file.
  • -endbr — inserts ENDBR at function entry. ending branches, starting beef. 🦋
  • -EP — generates a preprocessed source listing, and it gets sent to STDOUT. see also -Sf. ✨
  • -eq — don't display error messages. ignorance is bliss, technically. 🙈
  • -Fd[file] — writes an import definition file. the file part is optional, she's flexible like that.
  • -Fifile — forces file to be included. no negotiations, it's going in. 💅
  • -Fl[filename] — generates an assembled code listing. see -Sf. ✨
  • -Fofilename — names an object file. and listen: in case of wildcard, * may be used for the current file. 👑
  • -fpc — disallows floating-point instructions. no floats allowed. she's putting her foot down. 🚫
  • -FPi — generates emulator fix-ups for floating-point arithmetic. this is mixed language only, so don't get cute with it.
  • -FPi87 — 80x87 instructions. this is the default, so this is the energy she's on unless you say otherwise.
  • -fpic, -fno-pic — enables or disables the generation of position-independent code for ELF64. the default is -fno-pic. note that's two separate flags, one turns it on, one turns it off. 💖
  • -fpn — sets the FPU as n: 0=8087, 2=80287, 3=80387. (notice there's no 1 in that list. that's not a typo, that's just how it is, bestie.)
  • -frame — auto generates unwind information. she's got your back, literally, for when things unwind. 🧚
  • -Fwfilename — sets the errors file name to filename. errors, but make them a document. 📄
  • -G{c|d|z|v|s} — Pascal, C, Std/Vector/Sys-call. the whole calling-convention friend group:
    • -Gc — specifies use of FORTRAN-style or Pascal-style function calling and naming conventions.
    • -Gd — specifies use of C-style function calling and naming conventions.
    • -Gz — specifies use of STDCALL-style function calling and naming conventions. this one defines STDCALLSUPPORTED. ✨
    • -Gv — specifies use of VECTORCALL-style function calling and naming conventions.
    • -Gs — specifies use of SYSCALL (System V)-style function calling and naming conventions.
  • -Ge — emits a conditional _chkstk() inside the prologue. conditional!! in the prologue!! 💅
  • -help — displays a summary of Asmc command-line syntax and options. the classic "help me help you" moment. 🫶
  • -homeparams — forces parameters that were passed in registers to be written to their locations on the stack upon function entry. they're coming home. 🏠
  • -Ipathname — sets pathname for include files. she needs to know where to look. 👀
  • -idd[t] — assemble as binary data, or text. two moods:
    • -idd — assemble source as binary data.
    • -iddt — assemble source as a text file.
  • -logo — prints the logo string and exits. that's it. that's the whole job. she said "look at my logo" and left. 💀
  • -m{t|s|c|m|l|h|f} — sets the memory model. lowercase letters, big responsibilities.
  • -mz — generates a DOS MZ binary file. retro moment, we love to see it. 🕹️
  • -MD[d] — use for dynamic linking. defines _MSVCRT. and if you add the d, it also defines _DEBUG. two for one. 🎀
  • -MT[d] — use for static linking. defines _MT. and again, add the d and it also defines _DEBUG. consistent queen. 💖
  • -ncname — sets the class name of the code segment as name.
  • -ndname — sets the name of the data segment as name.
  • -nmname — sets the name of the module as name.
  • -ntname — sets the name of the text segment as name. (that's four segment/name flags in a row and yes, they all do slightly different things, keep up bestie ✨)
  • -nolib — ignores the INCLUDELIB directive. you said not today and she respects it.
  • -pe{c|g|d} — generates a PE binary file, 32/64-bit. and the letters mean: c=CUI (this is the default), g=GUI, d=DLL. pick your flavor. 🌈
  • -q — suppresses messages for successful assembly. only the good news gets deleted. silent but successful. 🤫
  • -nologo — suppresses the copyright message. (opposite energy from -logo, iconic.) 🎀
  • -r — recurse subdirectories when using wildcards. she will go deeper. 🌀
  • -Sa — turns on listing of all available information. ALL of it. she's not holding back. 👑
  • -safeseh — marks the object as either containing no exception handlers, or containing exception handlers that are all declared with SAFESEH. safety first, always. 🛡️
  • -Sf — adds first-pass listing to the listing file. first pass, best pass. ✨
  • -Sg — turns on listing of assembly-generated code. look at what she made!! 😭
  • -Sn — turns off the symbol table when producing a listing. she's being mysterious. 🙈
  • -Spn — sets segment alignment as n.
  • -stackalign — aligns stack variables to 16-byte. neat, tidy, aligned. 💅
  • -sysvregs — ignores RDI and RSI in USES for Linux64. linux girlies, this one's for you. 🐧
  • -Sx — turns on false conditionals in the listing. she's showing you the paths not taken. 💀
  • -w — same as -W0 -WX. that's it, she's just those two in a trench coat. (which, reminder: -WX makes warnings into errors, so this is a spicy combo. 🔥)
  • -Wlevel — sets the warning level, where level = 0, 1, 2, or 3. four settings, choose your chaos. 🌸
  • -win64 — generates a 64-bit COFF object. defines _WIN64. 🪟
  • -wsCodePage — stores quoted CodePage as Unicode. defines _UNICODE. ✨
  • -WX — treats all warnings as errors. no warnings allowed, only consequences. ⚠️
  • -X — ignores the INCLUDE environment path. she's not taking directions from the environment today.
  • -Z7 — adds full symbolic debugging information. everything, documented. 📝
  • -zcw — no decoration for C symbols. undecorated, unbothered. 💅
  • -Zd — generates line-number information in the object file. so you know exactly which line did that. 🔍
  • -Zf — makes all symbols public. everyone's invited. 🎉
  • -zf{0|1} — sets the FASTCALL type: MS/OW. two options, no in-between.
  • -Zg — generates code to match Masm. matching the ex, respectfully. 💀
  • -Zi{0|1|2|3}{|5|8} — adds symbolic debugging information. (yes the brace situation is a little unhinged, that's literally how it's written, don't @ her. 😭)
  • -zlc — no OMF records of data in code. 📦
  • -zld — no OMF records of far call. 📦
  • -Zm — enables MASM 5.10 compatibility. vintage era unlocked. 🕰️
  • -Zv8 — enables Masm v8+ PROC visibility. 👀
  • -Zne — disables syntax extensions that aren't supported, and enables syntax that's supported by Masm. trading one for the other.
  • -zl{f|p|s} — suppress items in COFF. the whole suppression collection:
    • -zlf — suppress items in COFF: no file entry.
    • -zlp — suppress items in COFF: no static procs.
    • -zls — suppress items in COFF: no section aux entry.
  • -Zp[alignment] — packs structures of the specified byte boundary by alignment. snug. 🫂
  • -Zs — performs a syntax check only. she's reading, not committing. 💅
  • -zt{0|1|2} — sets STDCALL decoration: FULL (the default), NONE, and HALF. three levels of decorated. 🎀
  • -zze — no export symbol decoration. 🚫
  • -zzs — stores the name of the start address. ✨

Copyright (C) 2011-2025 The Asmc Contributors. that's the whole section, and honestly? they earned it. 🫶

🌈 SEE ALSO 🌈

okay that's the whole page, you made it, I'm so proud of you 🥹 go assemble something iconic. this was the Asmc Macro Assembler, January 2025 edition, hanging out at the top of your terminal as ASMC(1) — no cap, she ate. ✨💅🎀🦋

📦 where this page comes from