ATR2XFD(1)

NAME
atr2xfd - Convert an Atari 8-bit ATR disk image to a raw (XFD) image

SYNOPSIS

atr2xfd infile.atr [outfile.xfd]

atrcheck infile.atr

DESCRIPTION

atr2xfd strips the 16-byte ATR header from an ATR image. While this could be done with a command like:

dd if=infile.atr outfile.xfd bs=16 skip=1

...**atr2xfd** first checks that its input is in fact an ATR file, then checks the ATR header and reports any problems it may find.

atrcheck performs the same checks as atr2xfd, but doesn't actually write an XFD image. In fact, atrcheck is a symbolic link to atr2xfd, which changes its behaviour (simply doesn't write any output) when called via the link. atrcheck also examines the boot sector of the ATR, and attempts to detect which Atari DOS is on the image (if any).

Neither atr2xfd nor atrcheck take any options.

NOTES

For both commands, you may use - for infile to read from standard input. For atr2xfd, use - for outfile to write to standard output. If a filename is supplied for outfile, it will always be used as-is (no .xfd extension will be appended).

If outfile is omitted, it is constructed like so:

•   If reading from standard input, write to standard output.

•   If reading from a file whose name ends with an .atr or .ATR extension, replace the extension with .xfd.

•   Otherwise, append .xfd to the input filename.

EXAMPLES

Check an image:

$ atrcheck dos_20s.atr
atrcheck: size is 5760 16-byte paragraphs
atrcheck: sectors: 720, sector size: 128 bytes
atrcheck: dos_20s.atr is a standard SS/SD image, 90K
atrcheck: ATR image OK (no fatal errors).
[ exit status is 0 ]

Check an image and convert to XFD:

$ atr2xfd dos_20s.atr
atr2xfd: input 'dos_20s.atr', output 'dos_20s.xfd'
atr2xfd: size is 5760 16-byte paragraphs
atr2xfd: sectors: 720, sector size: 128 bytes
atr2xfd: dos_20s.atr is a standard SS/SD image, 90K
atr2xfd: ATR image OK (no fatal errors).
atr2xfd: XFD image OK, wrote 92160 bytes
[ exit status is 0 ]

Attempt to use atrcheck with an XFD image:

$ atrcheck dos_20s.xfd
atrcheck: (fatal) dos_20s.xfd looks like an XFD image, not an ATR
[ exit status is 2 ]

Here, games001.atr is one of the old Yogi/Jellystone 1 meg images:

$ atrcheck games001.atr
atrcheck: size is 65536 16-byte paragraphs
atrcheck: sectors: 8192, sector size: 128 bytes
atrcheck: games001.atr is a high-capacity floppy or hard disk image, SD
atrcheck: ATR image OK (no fatal errors).
[ exit status is 0 ]

Here is an attempt to treat a non-image file as an image:

$ atrcheck /bin/ls
atrcheck: size is 5120 16-byte paragraphs
atrcheck: (fatal) /bin/ls not an ATR file (no NICKATARI signature)!
[ exit status is 2 ]

EXIT STATUS

Exit status is zero for success, non-zero for failure. Further, exit status will be 1 for errors involving file I/O (file not found, permissions, etc), and 2 for structural errors in the ATR file.

COPYRIGHT

WTFPL. See http://www.wtfpl.net/txt/copying/ for details.

AUTHOR

B.  Watson <urchlay@slackware.uk>; Urchlay on irc.libera.chat ##atari.

SEE ALSO

a8cat(1), a8eol(1), a8xd(1), atr2xfd(1), atrsize(1), axe(1), bas2aplus(1), blob2c(1), blob2xex(1), cart2xex(1), cxrefbas(1), dasm2atasm(1), diffbas(1), dumpbas(1), f2toxex(1), fenders(1), listbas(1), listamsb(1), protbas(1), renumbas(1), rom2cart(1), unmac65(1), unprotbas(1), vxrefbas(1), whichbas(1), xex1to2(1), xexamine(1), xexcat(1), xexsplit(1), xfd2atr(1), xex(5), atascii(7), fauxtari(7).

Any good Atari 8-bit book: De Re Atari, The Atari BASIC Reference Manual, the OS Users' Guide, Mapping the Atari, etc.