Name

dir2atr — create Atari disk image from directory

Synopsis

dir2atr [options] [sectors] imagefile directory

Description

dir2atr creates an Atari DOS 2.x or MyDOS compatible disk image containing the files from directory. Despite the name, dir2atr can create ATR, DCM and XFD images, depending on the extension of the image filename.

Options

-d

Create image with double density sectors (256 bytes). Default is single density (128 bytes per sector).

-m

Create disk image in MyDOS format instead of standard DOS 2.x format. This is the default unless you explicitly create a standard single density image (720 SD sectors), enhanced 1050 image (1040 SD sectors) or double density image (720 DD sectors).

If MyDOS format is selected dir2atr will also recurse into subdirectories.

-p

Create PICONAME.TXT file in disk image, containing the long filename information (used by MyPicoDos).

-b boottype

Create a bootable disk for the specified DOS. boottype must be one of:

Dos20, Dos25, MyDos453, TurboDos21, TurboDos21HS

for Atari Dos 2.0, Atari Dos 2.5, MyDos 4.53, TurboDos 2.1 and TurboDos 2.1HS, respectively.

When using one of these options, the directory must already contain a matching DOS.SYS file!

MyPicoDos403, MyPicoDos403HS, MyPicoDos404, MyPicoDos404N, MyPicoDos404R, MyPicoDos404RN, MyPicoDos404B

for MyPicoDos version 4.03 standard, 4.03 highspeed or MyPicoDos 4.04. As for version 4.04 the suffixes have the following meaning:

N defaults to normal speed SIO (instead of highspeed SIO). The highspeed SIO code is still present but disabled by default. It can later be enabled in the MyPicoDos menu with the H key. This can be helpful if you plan to use the image with an Atari emulator on your PC which often don't emulate highspeed SIO properly.

R versions include the AtariSIO remote console.

B is the "barebone" without highspeed SIO code and without AtariSIO remote console.

When using one of these options, dir2atr automatically adds the PICODOS.SYS file to the disk image. It is recommended that you also add the -p option to add a PICONAME.TXT file.

sectors

Numbers of sectors in the disk image. Must be between 720 and 65535.

If the number of sectors is omitted, dir2atr will automatically calculate it so that all files in the directory fit into the image.

If sectors is specified but too small for all files in directory, you will get an error message but dir2atr still creates an image file. Note: dir2atr stops on the first file that doesn't fit into the disk image, so you might end up with an empty image file if the first file was too big.

imagefile

Name of the Atari disk image file. Depending on the extension an ATR, DCM or XFD file is created. Note: DCM files are limited to standard single/enhanced/double density format.

directory

Source directory with files to be copied to the disk image.

The files are copied in ascending alphabetical order (case sensitive). If MyDOS format is used, dir2atr also recurses into subdirectories. Note: empty subdirectories will not be added to the image. Only real files will be added, symlinks etc. will be skipped.

Filenames will automatically be converted to uppercase "8.3" names, as required by Atari DOS.

Notes

The maximum supported size for Atari 8-bit disks is 16MB (65535 double density sectors).

MyDOS and most other DOS2.x compatible DOSes support a maximum of 64 entries per (sub-)directory. If you create a bootable MyPicoDos disk image keep in mind that the first entry of the root directory is used by the PICODOS.SYS file.

If you use the -p option, a PICONAME.TXT file is added at the end of each directory. So, a bootable MyPicoDos disk can store 62 entries (files, subdirectories) in the root directory and 63 entries in each subdirectory.

See also

adir(1), atariserver(1), atarixfer(1)

AtariSIO website: http://www.horus.com/~hias/atari/