hatari-prg-args(1)

📦 version 2.6.1, in arch rolling, debian bookworm, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 hatari-prg-args(1) 💖

okay so bestie, welcome to hatari-prg-args — it's part of the Hatari utilities manual, and it's genuinely one of the most underrated little tools in the whole kit. sit down, grab a strawberry 🍓, let's get into it.

✨ NAME ✨

hatari-prg-args — autorun Atari programs with arguments. yes. that's the whole vibe. it launches your Atari program and hands it the args it needs. iconic behavior honestly. 👑

🌸 SYNOPSIS 🌸

hatari-prg-args [-q] [Hatari args] -- <Atari program> <program args>

🦋 DESCRIPTION 🦋

So this is a utility that runs Hatari in a way where it autostarts the Atari program you give it, and then inserts the arguments you give into that program — like, directly into its basepage, using Hatari's builtin debugger facilities. no cap, it's basically the group chat translator between your Unix shell and TOS. 💅

Here's the path tea, because this is the part that trips people up:

  • If the Atari program's arguments share the same (host) path prefix as the Atari program you gave it, those prefixes get replaced with "C:\". Then the Unix path separators (/) get swapped for Atari ones (\), and the whole filename gets upper-cased. ✨
  • If the program and its input files live on a disk image, then all paths need to be given exactly as they are in TOS — and they will not be translated. don't @ me, that's just how it is. 🙈
  • Every other program argument? Passed through unmodified. untouched. pristine. 🎀

⭐ NOTES ⭐

The maximum Atari program command line length that you can give (in the basepage) is 126 characters. so keep it cute and keep it short bestie, there is no "one more arg" here. 💀
On Unix, the Atari/DOS path separator (\) needs to be quoted. fr fr, quote it or the shell will absolutely eat it. 😭

💅 OPTIONS 💅

  • -q — makes Hatari quit when the Atari program you started terminates. and listen — if you're gonna use it, it needs to be the very first argument. first. not second. first. periodt. 👑

🌈 EXAMPLES 🌈

Start a SID player in mono and tell it to play a given SID song 🎵

hatari-prg-args -m -- atari/sidplay.ttp atari/sids/test.sid

Run it from a disk image instead of a host directory 💾

hatari-prg-args -m -- 'A:\SIDPLAY.TTP' 'SIDS\TEST.SID'

see how the second one is all quoted and upper-cased? that's the TOS-path energy. no translation, just vibes. 🫶

👑 SEE ALSO 👑

hatari(1), hconsole(1)

🎀 AUTHOR 🎀

Written by Eero Tamminen <oak at helsinkinet fi>. thank you for your service, legend. 🫡

📜 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.

💀 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 that's the whole page bestie, go forth and autorun responsibly 💖✨ this was the Hatari hatari-prg-args(1) page, dated 2018-05-01, from the Hatari crew — mwah, slay, bye! 🦋🌸

📦 where this page comes from