dskconv(1)

💾 dskconv(1) — the glow-up your disc image deserves ✨

okay bestie, welcome to dskconv from the Emulators manual section, bestie. she's giving format-converter main character energy and honestly? she ate.

---

🌸 NAME 🌸

dskconv — convert a disc image file from one format to another 💅

---

🎀 SYNOPSIS 🎀

dskconv [-itype TYPE] [-otype TYPE] [-icomp COMP] [-ocomp COMP] [-format
FMT] INPUT-IMAGE OUTPUT-IMAGE

that's it. that's the whole vibe. two files, some flags, and a dream 🦋

---

✨ DESCRIPTION ✨

okay so here's the tea: dskconv takes a disc image file and converts it from one format to another. periodt. 💖

but the way it's different from dsktrans(1)?? lowkey iconic. dskconv can handle files where different tracks have different sector layouts. not every tool can say that, and honestly not every tool should. slay.

BUT — and this is the important part, no cap — it cannot handle copying to/from devices that are not disc image files. so like, floppy drives? rcpmfs directories? nope. not happening. not her job. 🙈

if you need a more general copy, go check out dsktrans(1). and if you want something slower but more accurate that may preserve more of these details, dskdump(1) is your girl. different tools, different vibes, all valid 🫶

---

👑 OPTIONS 👑

• -itype TYPE — tells the tool which driver to use for reading from the source disc. here are some examples, bestie:
  • auto — picks according to the disc image file. this is the default, the auto-pilot, the "she just knows" option 💅
  • dsk — uses the DSK (CPCEmu format) image driver.
  • edsk — uses the extended version of the DSK format. fancy. extended. elevated. ✨
  • floppy — uses the floppy driver.
  • ntwdm — (under Windows 2000 and later) uses Simon Owen's FDRAWCMD floppy driver.
  • myz80 — uses the hard disk (MYZ80 format) image driver. ⚠️ heads up: this format cannot be autodetected.
  • cfi — uses the CFI (DOS fdcopy format) image driver. ⚠️ also cannot be autodetected.
  • apridisk — uses the ApriDisk image driver (from the utility of the same name). ⚠️ yeah you guessed it, this format cannot be autodetected either.
  • raw — uses the raw driver.
  • logical — similar to the raw driver, but the resulting disc image contains tracks laid out in logical filesystem order. mainly used for imaging discs in formats (such as ADFS) where the mapping of tracks to cylinders/heads does not match the way it's done on the PC. it's giving "we do things differently over here" 😌
  • qm — Sydex's CopyQM format.
  • tele — Sydex's Teledisk format.
• -otype TYPE — tells the tool which driver to use for writing to the destination disc. the drivers are the same as for -itype, so go read that list again, i'll wait 🍓
• -icomp COMP — picks the compression method used on the source disc image file. 📌 important note: this has no effect when reading a floppy disc. and if you want to disable transparent decompression of gzipped disc images (think: the Slackware installer rootdisks), just use 'none'. the options are:
  • auto — detects from the first few bytes of the file. this is the default.
  • sq — Huffman coded (SQ / USQ).
  • gz — Gzipped (gzip / gunzip).
  • bz2 — Burrows-Wheeler compressed (bzip2 / bunzip2).
• -ocomp COMP — picks the compression to be used on output. the compression methods are the same as for -icomp… except that bz2 cannot be used. 😭 sorry bestie, no bz2 on the way out. it's simply not that girl.

also yes, -format FMT is right there in the synopsis, hanging out with the rest of them. iconic of it honestly.

---

🌈 SEE ALSO 🌈

• dskdump(1) — slower but more accurate, and she may preserve more details 💜
• dsktrans(1) — the more general copy 🧚

---

💖 AUTHOR 💖

John Elliott <seasip.webmaster@gmail.com>.

Darren Salt wrote the man pages. we love a documentation moment 🎀

---

Version 1.5.9 · 17 September 2018 — that's the footer tea, and that's the whole page, bestie. go convert something cute. periodt 💅✨