aboutsummaryrefslogtreecommitdiff
path: root/ksiders/atrdir.1
blob: ed6e0205b979f62b4aa21f5ce66d5dd5c5d15f28 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
.\" 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 "ATRDIR" 1 "2024-05-10" "0.9.0" "Ken Siders' Atari 8-bit Tools"
.SH NAME
atrdir \- atrdir - print the directory of a DOS 2.0S ATR disk image
.SH SYNOPSIS
.sp
atrdir \fIimagefile.atr\fP [\fIwildcard\fP]
.SH DESCRIPTION
.sp
\fBatrdir\fP prints the directory of an Atari DOS 2.x or MyDOS compatible
ATR disk image. Sample output:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
Directory of dos_20s.atr:*.*:
sector size = 128    sector count = 720

Directory of \(aqdos_20s.atr\(aq:

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
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
The f column contains an asterisk (\fI*\fP) for a locked file, a \fID\fP for
a deleted file, \fI:\fP for a MyDOS subdirectory, \fI<\fP for a DOS 2.5 file
that uses sectors above 720, or nothing for any other file.
.sp
\fIwildcard\fP is an optional glob pattern, such as \fI*.sys\fP\&. If not given,
the default is \fI*.*\fP\&. \fIwildcard\fP is case insensitive; \fI*.txt\fP
is equivalent to \fI*.TXT\fP\&. Most shells will require the argument to be
quoted, to avoid the shell\(aqs normal wildcard expansion. The globbing
semantics are similar to those of Atari DOS or POSIX sh, but are not
identical to either.
.sp
\fBatrdir\fP does not take any other options.
.SH NOTES
.sp
DOS 2.5 disk images are not fully supported. Specifically, \fBatrdir\fP
is unable to determine the size of files that use sectors above 720
(those that are listed with \fI<\fP). Instead, the size will be reported
as \fB??\fP\&.
.sp
MyDOS large disk images (aka hard disk images) are supported.
.sp
XFD format images are not supported.
.sp
The current version of \fBatrdir\fP cannot determine the size of a MyDOS
directory. Instead, the size is reported as \fB??\fP\&.
.sp
\fBatrdir\fP cannot print the contents of MyDOS subdirectories.
.sp
Exit status is zero for success, non\-zero for failure.
.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),
\fBsortatr\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.
.