From e2ba8458a5cfdfacfaf103e7ba97d610afa6c970 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Mon, 29 Aug 2022 16:11:13 -0400 Subject: initial commit --- atrsize.1 | 216 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 216 insertions(+) create mode 100644 atrsize.1 (limited to 'atrsize.1') diff --git a/atrsize.1 b/atrsize.1 new file mode 100644 index 0000000..3b9b571 --- /dev/null +++ b/atrsize.1 @@ -0,0 +1,216 @@ +.\" 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 "2022-08-27" "0.2.0" "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), +\fBcart2xex\fP(1), +\fBdasm2atasm\fP(1), +\fBfenders\fP(1), +\fBrom2cart\fP(1), +\fBunmac65\fP(1), +\fBxexcat\fP(1), +\fBxexsplit\fP(1), +\fBxfd2atr\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. +. -- cgit v1.2.3