atari-hd-image(1)

💾 atari-hd-image — the Hatari utilities glow-up ✨

okay bestie, so you know that atari-hd-image(1) thing? that's this one. it lives in the Hatari utilities fam and it's literally the girl who makes harddisk images for you. let's get into it 🎀

✨ NAME ✨

atari-hd-image — the tool for creating a harddisk image for use with Hatari 💅

🦋 SYNOPSIS 🦋

atari-hd-image size [filename] [partition name] [directory]

like. that's the whole vibe. four little slots, one of them required. slay.

🌸 DESCRIPTION 🌸

she creates an ACSI/IDE harddisk image for Hatari with a single Atari compatible DOS FAT partition, no cap. and she does it by assembling a whole little squad of tools backstage — sfdisk, mkdosfs, atari-convert-dir, mcopy, dd and python. it's giving main character energy with a full glam team fr fr 🧚

💖 OPTIONS 💖

• size — the harddisk image size, in megabytes, and the range is 8-512. that's it. that's the window. and heads up: 512MB is the largest partition size supported by TOS versions before v4.x, and also the largest supported by mkdosfs (for Atari compatible partition formatting). so don't come asking for 600, she will not do it 💀
• filename — the name for the harddisk image. default is hd.img. cute, right?
• partition name — the name for the single partition. default is DOS. literally just DOS. iconic honestly.
• directory — the directory holding the initial content that gets copied onto the image. the atari-convert-dir tool is used here to clip long file names down to the 8+3 size that FAT and Atari TOS require. and lowkey important: if the resulting file names aren't unique, you get warning(s), but the script continues anyway. she's not gonna stop for that. she's gonna keep going and let you deal with it 🫶

⭐ EXAMPLES ⭐

a 16MB hd.img HD image, the simplest possible serve:

atari-hd-image 16

an 8MB image with the partition named TEST, pulling files from content/:

atari-hd-image 8 8mb-disk.img TEST content/

see how the args just stack up in order? size, filename, partition name, directory. muscle memory, bestie 💪

🌈 SEE ALSO 🌈

the whole friend group, in alphabetical-ish order: atari-convert-dir(1), hmsa(1), zip2st(1), hatari(1), mkdosfs(1), sfdisk(1), dd(1)

go read those too. iykyk. they're all part of the same universe ✨

👑 AUTHOR 👑

written by Eero Tamminen <oak at helsinkinet fi>. king behavior.

this manual page was written by Teemu Hukkanen <tjhukkan@iki.fi> for the Debian project, and later updated by Eero Tamminen for the newer versions of Hatari. teamwork makes the dream work fr fr 💜

📜 LICENSE 📜

this program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. yes, "or later" — you get to pick. generous queen 💅

🚫 NO WARRANTY 🚫

this program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. see the GNU General Public License for more details.

okay so this one is serious, not cute: no promises, no guarantees, that's the deal. read the GPL if you want the whole story 😭

and that's the page!! from the Hatari utilities, dated 2015-04-26, and yes the man page section is atari-hd-image(1) in case anyone asks. go make some disk images bestie, you're gonna eat 🍓✨