RELOC65(1)

💖 RELOC65 💖

okay bestie so this is reloc65, and it's a relocator for o65 object files ✨ it lives in the General Commands Manual section (that's section 1, iykyk) and it is literally so good at what it does.

---

🦋 SYNOPSIS 🦋

reloc65 [OPTION]... FILE...

like. give it some options. give it some files. she'll handle it 💅

---

🌸 DESCRIPTION 🌸

reloc65 is a relocator for files in the o65 object format. that's the whole vibe fr fr 🎀

---

✨ OPTIONS ✨

so many options. all iconic. all necessary. let's go 👑

• -o filename — set the output filename. the default is a.o65 (yes, really, that's her name 🍼).
• -v — verbose output. she'll tell you what's going on, like a good friend should 💬
• -b? addr — relocate segment ? to addr. the ? should be t, d, b or z — that's the text, data, bss or zero segment respectively 🧚 for the whole explanation, go read the xa(1) man page, she explains it better than me.
• -x? — extract segment ? from the file instead of writing back the whole file. valid arguments are t and d for the text or data segment respectively. not valid for bss or zero ⚠️ like, don't even try it.
• -X — extract text and data segment together from the file instead of writing back the whole file. this one relocates the data segment to the end of the text segment and the bss segment to the end of the data segment before extracting — and heads up, the -xd and -xb options override the derived address 👀 so she's not just guessing, she's computing.
• -C cputype — define a new CPU type for the output file. available values are:
  • 6502 — documented 6502 opcodes only
  • NMOS6502 — 6502 plus undocumented opcodes (spicy 🌶️)
  • 65SC02 — extends 6502 with CMOS opcodes, except for BBR/BBS/SMB and RMB
  • 65C02 — extends 65SC02 with the BBR/BBS/SMB and RMB opcodes
  • 65CE02 — extends 65C02 with additional CE-specific opcodes
  • 65816 — 65816 in 6502 emulation mode; extends 65SC02
• --help — show summary of options. your girl is helpful 💁‍♀️
• --version — show version of program. know her age, respect her journey 🌈

---

👀 SEE ALSO 👀

file65(1), ldo65(1), uncpk(1), dxa(1), xa(1) — the whole squad, go say hi 🫶

---

💜 AUTHOR 💜

this manual page was written by David Weinehall <tao@acc.umu.se> and Cameron Kaiser <ckaiser@floodgap.com>. Original xa package (C)1989-1997 Andre Fachat. Additional changes (C)1989-2024 Andre Fachat, Jolse Maginnis, David Weinehall and Cameron Kaiser. the current maintainer is Cameron Kaiser 👑

---

🌐 WEBSITE 🌐

http://www.floodgap.com/retrotech/xa/

---

ok that's the whole thing, no notes, she ate and left no crumbs 💅

5 March 2024 — that's the date on this beauty, and the source is RELOC65, section 1 of the General Commands Manual. periodt. 🎀✨💖