ATASM(1)

📦
version 1.30 · 3 versions
, in fedora 43, fedora 44

💖 ATASM(1) 💖

okay bestie, gather round, because today we're talking about atasm — a General Commands Manual legend in section 1, and honestly? she's iconic. she's an assembler targeted for the 6502 CPU with Atari-specific features, and she's about to become your whole personality. no cap. 🎀

✨ SYNOPSIS ✨

atasm [options] filename

that's it. that's the vibe. options go in, filename goes in, magic comes out. 🦋

🌸 DESCRIPTION 🌸

so like, atasm takes your 6502 code and assembles it into an Atari DOS executable, an Atari XFD disk image, or a raw binary file. three options, all slay, pick your fighter. 💅

and the syntax? it's compatible with the Atari 8-bit assembler MAC/65, with a few extensions — notably 6502 illegal opcode support 👑 — so if you already know MAC/65 you're literally already fluent, and if you don't, you're about to be. iykyk.

✨ OPTIONS ✨

one bullet per option, bestie, and i'm not skipping a single one because every single flag here is a main character:

  • -ofilename — saves the object file to filename instead of the default sourcefile [.65o]. so you get to name your baby. 🍼
  • -Dsymbol=value — defines symbol to value before assembly even begins. this is exactly equivalent to sneaking a line like symbol=value in before the very first line of your source file. pre-gaming, but for symbols. 💜
  • -Idirectory — specifies a search directory for .INCLUDE directives. your includes have a home now, she's housed. 🏠
  • -v — prints assembly trace. watch her work. obsessed. 👀
  • -s — prints the symbol table when assembly is completed. a little post-assembly treat. 🍓
  • -u — enables undocumented opcodes. equivalent to using .OPTILL in the source file. but heads up bestie — this command-line parameter is overriden by any directives in the source files. the source file wins, always. periodt. 💀
  • -mfilename — defines the template emulator state file. that's filename's whole job. ✨
  • -xfilename — saves the object file to .XFD image filename. disk image era. 🌈
  • -r — saves object code as a raw binary image. no frills, just bytes. ⭐
  • -fvalue — sets the raw binary fill byte to value. filling in the gaps, we love a completionist. 🫶

🎀 NOTES 🎀

real talk: this man page is nowhere near complete. i know, i know. 😭

for the full documentation, go read:

/usr/share/doc/atasm/atasm.txt

that's where the real lore lives. go, read, absorb, ascend. 🧚

this lil cutie is brought to you by Contributed Software, dated April 2015 — yeah she's been serving since 2015 and she's still eating. 💖 bye bestie, go assemble something iconic ✨👑

📦 where this page comes from