aboutsummaryrefslogtreecommitdiff
path: root/atrsize.1
blob: 66cc59013b27242c64d1f4e5e179cf80997892f7 (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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
.\" 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 "ATRSIZE" 1 "2024-06-18" "0.2.1" "Urchlay's Atari 8-bit Tools"
.SH NAME
atrsize \- Change the size of an Atari 8-bit ATR disk image, or create a blank ATR image
.\" RST source for atrsize(1) man page. Convert with:
.
.\" rst2man.py atrsize.rst > atrsize.1
.
.\" rst2man.py comes from the SBo development/docutils package.
.
.SH SYNOPSIS
.sp
atrsize [\fB\-bB\fP] \fIinfile.atr\fP [\fIsectors\fP]
.SH DESCRIPTION
.sp
Without the \fB\-b\fP or \fB\-B\fP options:
.INDENT 0.0
.INDENT 3.5
\fIinfile.atr\fP will be backed up to \fIinfile.atr~\fP, and a new \fIinfile.atr\fP will
be  created.  If \fIsectors\fP is given, the new image file will be truncated
or extended to the new size. Without \fIsectors\fP, the new image\(aqs size will
be set as follows:
.TS
center;
|l|l|l|.
_
T{
Density
T}	T{
Original Sectors
T}	T{
New Sectors
T}
_
T{
Either
T}	T{
0 \- 2
T}	T{
Error
T}
_
T{
Either
T}	T{
3 \- 719
T}	T{
720
T}
_
T{
Either
T}	T{
720
T}	T{
720 (no change)
T}
_
T{
Single
T}	T{
721 \- 1039
T}	T{
1040 (aka 1050 enhanced density)
T}
_
T{
Single
T}	T{
1040
T}	T{
1040 (no change)
T}
_
T{
Single
T}	T{
1041 or more
T}	T{
Unknown (must specify size)
T}
_
T{
Double
T}	T{
721 \- 1339
T}	T{
1440 (aka double sided, double density)
T}
_
T{
Double
T}	T{
1440
T}	T{
1440 (no change)
T}
_
T{
Double
T}	T{
1441 or more
T}	T{
Unknown (must specify size)
T}
_
.TE
.sp
When  \fIsectors\fP  is  given,  its allowed range is from 3 to 65535. \fIinfile.atr\fP
will be rewritten at the new size.
.sp
When \fBatrsize\fP changes the size of an image, the new ATR header
will  reflect the new size. If the new image is larger than the old
image, \fBatrsize\fP pads the image with empty sectors containing all 0
data bytes.  If the  new  image is smaller than the old image, it is
truncated, and any data in the old image that resides in the removed
sectors will be lost.
.sp
For ATR images where the ATR header doesn\(aqt agree with the actual  size
of  the  file,  the actual file size is used to determine the number of
sectors. The output image will have its ATR header adjusted to  reflect
the actual file size of the image, if sectors is not given.
.UNINDENT
.UNINDENT
.sp
With \fB\-b\fP or \fB\-B\fP:
.INDENT 0.0
.INDENT 3.5
\fBatrsize\fP will create a new, blank image called \fIinfile.atr\fP\&. If
this file already  exists,  however,  it  will not be overwritten
(instead, \fBatrsize\fP will exit with a "file exists" message).
.sp
If \fIsectors\fP is given, the new image\(aqs size will be set to that many
sectors. If not given, the new image\(aqs size will be 720 sectors.
.sp
\fB\-b\fP creates a new image with 128\-byte sectors (single density)
.sp
\fB\-B\fP creates a new image with 256\-byte sectors (double density).
.sp
New images created with \fBatrsize\fP consist of a valid ATR header,
and sectors filled with zeroes. No boot sectors, directory, VTOC,
or  filesystem  are  created.  To  use  a  blank  image for file
storage, it must be formatted with an Atari DOS (either in an
emulator or with a real Atari  via  SIO2PC  cable). If you\(aqre
trying to create a blank DOS 2.0S disk, use \fBaxe \-b\fP\&.
.UNINDENT
.UNINDENT
.SH NOTES
.INDENT 0.0
.IP \(bu 2
\fBatrsize\fP cannot change the sector size (density) of an image under
any circumstances. Only the sector count may be changed.
.IP \(bu 2
\fBatrsize\fP will fail if the input file doesn\(aqt have a valid ATR header.
If it\(aqs an XFD (raw) image, use \fBxfd2atr\fP(1) to convert it to an ATR first.
.UNINDENT
.SH EXIT STATUS
.sp
Exit status is zero for success, non\-zero for failure.
.SH COPYRIGHT
.sp
WTFPL. See \fI\%http://www.wtfpl.net/txt/copying/\fP for details.
.SH AUTHOR
.INDENT 0.0
.IP B. 3
Watson <\fI\%urchlay@slackware.uk\fP>; Urchlay on irc.libera.chat \fI##atari\fP\&.
.UNINDENT
.SH SEE ALSO
.sp
\fBa8eol\fP(1),
\fBa8utf8\fP(1),
\fBatr2xfd\fP(1),
\fBatrsize\fP(1),
\fBaxe\fP(1),
\fBblob2c\fP(1),
\fBblob2xex\fP(1),
\fBcart2xex\fP(1),
\fBcxrefbas\fP(1),
\fBdasm2atasm\fP(1),
\fBdumpbas\fP(1),
\fBf2toxex\fP(1),
\fBfenders\fP(1),
\fBprotbas\fP(1),
\fBrenumbas\fP(1),
\fBrom2cart\fP(1),
\fBunmac65\fP(1),
\fBunprotbas\fP(1),
\fBvxrefbas\fP(1),
\fBxexamine\fP(1),
\fBxexcat\fP(1),
\fBxexsplit\fP(1),
\fBxfd2atr\fP(1),
\fBxex\fP(5),
\fBatascii\fP(7).
.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.
.