aboutsummaryrefslogtreecommitdiff
path: root/jindroush/man/adir.rst
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2024-05-16 01:43:09 -0400
committerB. Watson <urchlay@slackware.uk>2024-05-16 01:43:09 -0400
commita4cc3ad3504d634e379369862c9f9fd8eed379f3 (patch)
tree7b6f55c352a4ca62dddaa1b4a6854799111d2d2f /jindroush/man/adir.rst
parentb33c25d1363110e6e4a714530f460b0ff951f56b (diff)
downloadbw-atari8-tools-a4cc3ad3504d634e379369862c9f9fd8eed379f3.tar.gz
Add Jindrich Kubec's tools.
Diffstat (limited to 'jindroush/man/adir.rst')
-rw-r--r--jindroush/man/adir.rst89
1 files changed, 89 insertions, 0 deletions
diff --git a/jindroush/man/adir.rst b/jindroush/man/adir.rst
new file mode 100644
index 0000000..eff5911
--- /dev/null
+++ b/jindroush/man/adir.rst
@@ -0,0 +1,89 @@
+.. |version| replace:: 0.67
+
+====
+adir
+====
+
+---------------------------------------------------
+list and extract files from Atari 8-bit disk images
+---------------------------------------------------
+
+.. include:: manhdr.rst
+
+SYNOPSIS
+========
+
+adir [ [**-help*] | [**-dos2** | [**-dos3**] | [**-mydos**] | [**-spdos**] | [**-kboot**] | [**-bas2boot** ] | [**-jonw**] | [**-robc**] | [**-howf**] | [**-boot] ] [**-e**] [**-dir** *path*] [**-dontrepair**] **disk-image** [**mask**]
+
+DESCRIPTION
+===========
+
+**adir** lists and extracts the files contained in an Atari 8-bit
+disk image. Many Atari DOS and DOS-like filesystems are supported,
+and disk images can be in various formats.
+
+The image types supported are:
+
+ ATR
+ Originally defined by SIOPC; the modern standard format.
+
+ XFD
+ Originally defined by the XFormer emulator; raw images.
+
+ DCM
+ DiskComm (Disk Communicator) images.
+
+ SCP
+ SpartaDOS SCOPY images.
+
+ DI
+ XL/ST link / XLDJ disk images.
+
+The image type is autodetected; there are no options to override the
+detection.
+
+The filesystems supported are:
+
+ - Atari DOS 2.0/2.5 and compatibles
+ - Atari DOS 3.0
+ - MyDOS
+ - Sparta DOS and compatibles (BeWe, RealDOS)
+ - K-Boot images
+ - HowFen DOS
+ - JonW multiboot
+ - RobC multiboot
+ - Bas2Boot images
+ - boot images (extracts boot sector only)
+
+By default, **adir** attempts to autodetect the filesystem type, but it can
+be set explicitly by one of the options, below.
+
+**mask** is a wildcard mask of filenames to extract. Note that
+it's case-sensitive, meaning it generally will have to be given in
+uppercase since most Atari filesystems don't support lowercase.
+
+OPTIONS
+=======
+
+**-dos2**, **-dos3**, **-mydos**, **-spdos**, **-kboot**, **-bas2boot**, **-jonw**, **-robc**, **-howf**, **-boot**
+ Set the filesystem type (see list, above).
+
+**-e**
+ Extracts files from the image. If a wildcard **mask** is given,
+ files matching the wildcard will be listed (and extracted, with
+ **-e**). Without a **mask**, all files on the image will be
+ listed/extracted.
+
+**-dir** *path*
+ Write extracted files to this directory, which will be created if it
+ doesn't already exist. Default is "." (the current directory).
+
+**-dontrepair**
+ Don't attempt to automatically repair invalid files.
+
+EXIT STATUS
+===========
+
+Zero for success, non-zero for failure.
+
+.. include:: manftr.rst