From a4cc3ad3504d634e379369862c9f9fd8eed379f3 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Thu, 16 May 2024 01:43:09 -0400 Subject: Add Jindrich Kubec's tools. --- jindroush/man/adir.rst | 89 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 jindroush/man/adir.rst (limited to 'jindroush/man/adir.rst') 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 -- cgit v1.2.3