.\" 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 "ATREXTR" 1 "2024-05-10" "0.9.0" "Ken Siders' Atari 8-bit Tools"
.SH NAME
atrextr \- extract files from an ATR image
.SH SYNOPSIS
.sp
\fBatrextr\fP \fIimagefile.atr\fP [\fIfile\fP] [\fIdir\fP]
.SH DESCRIPTION
.sp
\fBatrextr\fP extracts one or more files from an Atari DOS 2.x or MyDOS
compatible ATR disk image. Extracted files are written to the current
directory, by default.
.sp
\fIfile\fP is an optional filename or wildcard pattern, such as \fIautorun.sys\fP
or \fI*.sys\fP\&. If not given, the default is \fI*.*\fP\&. \fIfile\fP is case
insensitive: \fIreadme.txt\fP is equivalent to \fIREADME.TXT\fP, and \fI*.txt\fP is
equivalent to \fI*.TXT\fP\&. If a wildcard is used, most shells will require
the argument to be quoted, to avoid the shell\(aqs normal wildcard
expansion. The wildcard semantics are similar to those of Atari DOS or
POSIX sh, but are not identical to either.
.sp
\fIdir\fP is the directory to extract files to. If omitted, the default is
the current directory. If \fIdir\fP is to be given, \fIfile\fP must also be given
(although it may be specified as \fI""\fP, equivalent to \fI*.*\fP).
.sp
\fBatrextr\fP does not take any other options.
.SH NOTES
.sp
DOS 2.5 disk images are not fully supported. Specifically, \fBatrextr\fP
is unable to extract files that use sectors above 720 (those that
are listed with \fI<\fP, in \fIatrdir\fP or Atari DOS 2.5). These files will be
silently skipped, exactly as Atari DOS 2.0S does when reading a 2.5
enhanced density disk.
.sp
MyDOS subdirectories are not supported. Only files in the root
directory of a disk image can be extracted.
.sp
MyDOS large disk images (aka hard disk images) are supported, though
without subdirectory support, \fBatrextr\fP can\(aqt extract most of the files
in a typical hard disk image.
.sp
XFD format images are not supported. Neither are SpartaDOS, Atari DOS
3/4, DOS XE, or other non\-standard DOS formats.
.sp
There should be options to translate Atari EOL characters to and from
UNIX newlines, and to convert the extracted filenames to lowercase.
.sp
Exit status is zero if all files were extracted successfully, or
non\-zero if any errors occurred. In case of a non\-zero return,
some files may still have been extracted (though some or all of them
may be truncated or corrupt).
.SH COPYRIGHT
.sp
Copyright 1997, Ken Siders.
.SH AUTHOR
.sp
Ken Siders was the original author of this utility.
.sp
Man page and Linux port done by B. Watson <\fI\%urchlay@slackware.uk\fP>;
Urchlay on irc.libera.chat \fI##atari\fP\&.
.SH SEE ALSO
.sp
\fBatrdir\fP(1),
\fBatrextr\fP(1),
\fBmakeatr\fP(1),
\fBsort\fP(1).
.sp
Any good Atari 8\-bit book: \fIDe Re Atari\fP, \fIThe Atari BASIC  Reference
Manual\fP,  the  \fIOS Users\(aq Guide\fP, \fIMapping the Atari\fP, etc.
.\" Generated by docutils manpage writer.
.