path: root/atrsize.1

.\" 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-05-03" "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),
\fBdasm2atasm\fP(1),
\fBf2toxex\fP(1),
\fBfenders\fP(1),
\fBrom2cart\fP(1),
\fBunmac65\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.
.