.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "ADIR" 1 "2024-05-16" "0.67" "Jindroush's Atari 8-bit tools"
.SH NAME
adir \- list and extract files from Atari 8-bit disk images
.SH SYNOPSIS
.sp
adir [ [\fB\-help*] | [\fP\-dos2** | [\fB\-dos3\fP] | [\fB\-mydos\fP] | [\fB\-spdos\fP] | [\fB\-kboot\fP] | [\fB\-bas2boot\fP ] | [\fB\-jonw\fP] | [\fB\-robc\fP] | [\fB\-howf\fP] | [\fB\-boot] ] [\fP\-e**] [\fB\-dir\fP \fIpath\fP] [\fB\-dontrepair\fP] \fBdisk\-image\fP [\fBmask\fP]
.SH DESCRIPTION
.sp
\fBadir\fP 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.
.sp
The image types supported are:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B ATR
Originally defined by SIOPC; the modern standard format.
.TP
.B XFD
Originally defined by the XFormer emulator; raw images.
.TP
.B DCM
DiskComm (Disk Communicator) images.
.TP
.B SCP
SpartaDOS SCOPY images.
.TP
.B DI
XL/ST link / XLDJ disk images.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
The image type is autodetected; there are no options to override the
detection.
.sp
The filesystems supported are:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
Atari DOS 2.0/2.5 and compatibles
.IP \(bu 2
Atari DOS 3.0
.IP \(bu 2
MyDOS
.IP \(bu 2
Sparta DOS and compatibles (BeWe, RealDOS)
.IP \(bu 2
K\-Boot images
.IP \(bu 2
HowFen DOS
.IP \(bu 2
JonW multiboot
.IP \(bu 2
RobC multiboot
.IP \(bu 2
Bas2Boot images
.IP \(bu 2
boot images (extracts boot sector only)
.UNINDENT
.UNINDENT
.UNINDENT
.sp
By default, \fBadir\fP attempts to autodetect the filesystem type, but it can
be set explicitly by one of the options, below.
.sp
\fBmask\fP is a wildcard mask of filenames to extract. Note that
it\(aqs case\-sensitive, meaning it generally will have to be given in
uppercase since most Atari filesystems don\(aqt support lowercase.
.SH OPTIONS
.INDENT 0.0
.TP
.B \fB\-dos2\fP, \fB\-dos3\fP, \fB\-mydos\fP, \fB\-spdos\fP, \fB\-kboot\fP, \fB\-bas2boot\fP, \fB\-jonw\fP, \fB\-robc\fP, \fB\-howf\fP, \fB\-boot\fP
Set the filesystem type (see list, above).
.TP
.B \fB\-e\fP
Extracts files from the image. If a wildcard \fBmask\fP is given,
files matching the wildcard will be listed (and extracted, with
\fB\-e\fP). Without a \fBmask\fP, all files on the image will be
listed/extracted.
.TP
.B \fB\-dir\fP \fIpath\fP
Write extracted files to this directory, which will be created if it
doesn\(aqt already exist. Default is "." (the current directory).
.TP
.B \fB\-dontrepair\fP
Don\(aqt attempt to automatically repair invalid files.
.UNINDENT
.SH EXIT STATUS
.sp
Zero for success, non\-zero for failure.
.SH COPYRIGHT
.sp
This utility is released under the GNU General Public License.
.SH AUTHORS
.sp
This utility was written by Jindrich Kubec, AKA Jindroush.
.sp
This page was written by B. Watson <\fI\%urchlay@slackware.uk\fP>.
.SH SEE ALSO
.sp
\fBacvt\fP(1),
\fBaext\fP(1),
\fBbas2boot\fP(1),
\fBchkbas\fP(1),
\fBchkexe\fP(1),
\fBchkrom\fP(1).
.\" Generated by docutils manpage writer.
.