cmddump(1)

📦 version 4.9d, in debian bookworm, debian trixie, ubuntu jammy, ubuntu questing, ubuntu resolute, ubuntu stonking

cmddump 💾✨

okay bestie, welcome to the General Commands Manual section for cmddump — she's a simulated TRS-80 CMD file loader and she is, lowkey, the moment. 🎀

🌸 NAME 🌸

cmddump — simulated TRS-80 CMD file loader 💅

✨ SYNOPSIS ✨

cmddump [-d] [-i n] [-m] [-p entry] [-q] [-s] [-t] [-x] infile [outfile
        startbyte nbytes]

🦋 DESCRIPTION 🦋

so cmddump literally just spills the tea about TRS-80 DOS CMD files, aka binary executables, aka the files that Do Things on a very vintage machine. 🫶

You have to hand her an input CMD file, infile — that one's mandatory, no skipping, periodt. Then there's an optional lil trio you can pass after it: an output file outfile, a starting offset startbyte into the CMD file infile, and a number of bytes to dump, nbytes. 📦

If startbytes is specified, the byte range you asked for gets dumped from the simulated memory after loading. not before. after. timing matters bestie 💖

oh and — the numeric arguments, including the one that goes with -i, can be in any format strtol(3) recognizes. so basically the classic C literals: decimal, octal, hexadecimal. go off, bases 🔥

👑 OPTIONS 👑

The optional arguments and their parameters direct cmddump as follows. she takes notes, she follows orders. 💅

  • -d — print the detailed map. it's the same as -m, except it does not coalesce adjacent blocks. no merging, we keep every block separate and we respect the boundaries. 💀
  • -i n — select ISAM entry n. pick your entry, bestie ✨
  • -m — print a running load map as the file is parsed, coalescing adjacent blocks. this one implies -t, and it's the default. so if you don't say anything, this is the vibe you're getting 🌈
  • -p entry — select PDS entry entry. cmddump will truncate or right-pad entry with spaces, as needed, to the required fixed field width. she's making it fit, she's not asking questions 🎀
  • -q — quiet mode 🫶. turns off -d, -m, -s, and -t. but ngl, later flags can override this, so order matters, iykyk
  • -s — print a summary load map after the file is parsed. the recap episode 🌸
  • -t — print the text of module headers, PDS headers, patch names, and copyright notices. all the receipts 💖
  • -x — ignore anything after the first transfer address. that's it, that's the whole personality. goodbye 👋

💜 AUTHOR 💜

cmddump was written by Timothy Mann. king behavior honestly 👑

🌟 SEE ALSO 🌟

  • xtrs(1)
  • The LDOS Quarterly, April 1, 1982 (Vol 1, No 4), has documentation of the TRS-80 DOS CMD file format. yes, a whole zine issue, and it's iconic for this 📖✨
k that's the whole page bestie, go dump some CMD files responsibly 🧚💖

sourced from xtrs, dated 2017-04-04 — mwah, that's the wrap, slay 💅🎀

📦 where this page comes from