ASXXXX(1)

💖 ASXXXX 💖

okay bestie, pull up a chair — this is the man page for ASxxxx, a whole series of microprocessor cross assemblers for SDCC, from the General Commands Manual. No cap, it's a lot, but we're getting through it together. 🫶

---

✨ NAME ✨

ASxxxx</p紫色> — a series of microprocessor cross assemblers for SDCC. That's the whole vibe. 💅

---

🌸 SYNOPSIS 🌸

Like, the shape of every single command, bestie:

sdas8051 [options] file1 [file2 file3 ... file6]
sdasgb [options] file1 [file2 file3 ... file6]
sdasz80 [options] file1 [file2 file3 ... file6]
sdas6808 [options] file1 [file2 file3 ... file6]
sdas390 [options] file1 [file2 file3 ... file6]
sdasrab [options] file1 [file2 file3 ... file6]
sdasstm8 [options] file1 [file2 file3 ... file6]
sdastlcs90 [options] file1 [file2 file3 ... file6]

eight assemblers, same energy ✨

---

⚠️ WARNING ⚠️

Not me about to give you the tea: the info in this man page is literally just an extract from the full SDCC documentation, and it's limited to the meaning of the options. That's it. That's the whole scope. 😭

For the complete and current documentation, go read the ASxxxx Cross Assembler Documentation, which lives at:

/usr/share/doc/sdcc-doc/aslink

iykyk — the real docs are always in /usr/share/doc 💀

---

🦋 DESCRIPTION 🦋

The ASxxxx assemblers are a whole series of microprocessor assemblers, and every single one has a device-specific section. Periodt.

Here's the family tree, bestie:

• MCS51 family is supported by sdas8051.
• Z80 family is supported by sdasz80.
• GBZ80 (the GameBoy Z80-like CPU, iconic behavior honestly) is supported by sdasgb.
• Motorola 6808 family is supported by sdas6808.

---

👑 OPTIONS 👑

The ASxxxx assemblers are command line oriented, okay? The PC assemblers get started with the appropriate option(s) and file(s) to assemble, and those come right after the assembler name. So it's like assembler options files, in that order, no cap. ✨

• -d — decimal listing.
• -q — octal listing.
• -x — hex listing (default).

🌈 The listing radix affects the .lst, .rel, and .sym files. Like, all three. Don't forget it.

• -j — add line number and debug information to file.
• -g — undefined symbols made global.
• -a — all user symbols made global.
• -l — create list output file1.lst.
• -o — create object output file1.rel.
• -s — create symbol output file1.sym.
• -c — generate sdcdb debug information.
• -p — disable listing pagination.
• -w — wide listing format for symbol table.
• -z — enable case sensitivity for symbols.
• -f — flag relocatable references by ` in the listing file.
• -ff — flag relocatable reference by mode in the listing file.
• -I — add the named directory to the include file search path. This option may be used more than once. Directories are searched in the order given. 🧚

---

The file name for the .lst, .rel, and .sym files is the first file name specified in the command line. Every output file is an ascii text file — so yes bestie, you can edit it, copy it, do whatever, it's giving very editable. 💅

Also: the output files are the concatenation of all the input files. So if you want files assembled independently, you gotta invoke the assembler for each file. No shortcuts, sorry. 🙈

The .rel file contains a radix directive, so that the linker will use the proper conversion for this file. And linked files? They may have different radices. Iconic, honestly. ⭐

And last one, super important: if the list (l) option is specified without the symbol table (s) option, then the symbol table is placed at the end of the listing file. Slay. 🎀

---

🌈 SEE ALSO 🌈

Go read these too, bestie, they're all in the group chat:

• sdcc(1)
• aslink(1)
• asx8051
• as-z80(1)
• as-gbz80(1)

---

💜 AUTHOR 💜

This manual page was written by Aurelien Jarno <aurel32@debian.org>, for the Debian GNU/Linux system — but may be used by others, so like, go off. 🫶

---

okay and that's the whole page, bestie ✨ This was ASXXXX from the General Commands Manual — main character energy, first page and last page alike — and if you made it this far, you literally understood a whole man page. Obsessed. 💖🦋🌸👑🔥