From e4a6e722021bf69b667822bea1862d6709d13564 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Fri, 10 May 2024 17:40:31 -0400 Subject: convert ksiders man pages to RST, part 1 (atrdir). --- ksiders/atrdir.rst | 66 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 ksiders/atrdir.rst (limited to 'ksiders/atrdir.rst') diff --git a/ksiders/atrdir.rst b/ksiders/atrdir.rst new file mode 100644 index 0000000..290a937 --- /dev/null +++ b/ksiders/atrdir.rst @@ -0,0 +1,66 @@ +====== +atrdir +====== + +--------------------------------------------------------- +atrdir - print the directory of a DOS 2.0S ATR disk image +--------------------------------------------------------- + +.. include:: manhdr.rst + +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. + +.. include:: manftr.rst -- cgit v1.2.3