dir2atr — create Atari disk image from directory
dir2atr
[options
] [sectors
] imagefile
directory
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.
-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.
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.