ATRDIR(1)

NAME
atrdir - atrdir - print the directory of a DOS 2.0S ATR disk image

SYNOPSIS

atrdir imagefile.atr [wildcard]

DESCRIPTION

atrdir prints the directory of an Atari DOS 2.x or MyDOS compatible ATR disk image. Sample output:

---------------------------------------------------------------------
Directory of dos_20s.atr:*.*:
sector size = 128    sector count = 720
Directory of 'dos_20s.atr':
no f filename ext  secs  length  startSec
-- - -------- ---  ----  ------  --------
 0 * DOS      SYS   039  4875    4
 1 * DUP      SYS   042  5126    43
 2   AUTORUN  SYS   001  88      85
---------------------------------------------------------------------

The f column contains an asterisk (*) for a locked file, a D for a deleted file, : for a MyDOS subdirectory, < for a DOS 2.5 file that uses sectors above 720, or nothing for any other file.

wildcard is an optional glob pattern, such as *.sys. If not given, the default is *.*. wildcard is case insensitive; *.txt is equivalent to *.TXT. Most shells will require the argument to be quoted, to avoid the shell's normal wildcard expansion. The globbing semantics are similar to those of Atari DOS or POSIX sh, but are not identical to either.

atrdir does not take any other options.

NOTES

DOS 2.5 disk images are not fully supported. Specifically, atrdir is unable to determine the size of files that use sectors above 720 (those that are listed with <). Instead, the size will be reported as ??.

MyDOS large disk images (aka hard disk images) are supported.

XFD format images are not supported.

The current version of atrdir cannot determine the size of a MyDOS directory. Instead, the size is reported as ??.

atrdir cannot print the contents of MyDOS subdirectories.

Exit status is zero for success, non-zero for failure.

COPYRIGHT

Copyright 1997, Ken Siders.

AUTHOR

Ken Siders was the original author of this utility.

Man page and Linux port done by B. Watson <urchlay@slackware.uk>; Urchlay on irc.libera.chat ##atari.

SEE ALSO

atrdir(1), atrextr(1), makeatr(1), sortatr(1).

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