.. RST source for atr2xfd(1) man page. Convert with:
..   rst2man.py atr2xfd.rst > atr2xfd.1
.. rst2man.py comes from the SBo development/docutils package.

=======
atr2xfd
=======

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

.. include:: manhdr.rst

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.

.. include:: manftr.rst
