summaryrefslogtreecommitdiffstats
path: root/system/atarisio/casinfo.1
diff options
context:
space:
mode:
Diffstat (limited to 'system/atarisio/casinfo.1')
-rw-r--r--system/atarisio/casinfo.1109
1 files changed, 109 insertions, 0 deletions
diff --git a/system/atarisio/casinfo.1 b/system/atarisio/casinfo.1
new file mode 100644
index 0000000000..8276050148
--- /dev/null
+++ b/system/atarisio/casinfo.1
@@ -0,0 +1,109 @@
+.\" 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 "CASINFO" 1 "2022-07-14" "0.30-210714" "HiassofT Atari 8-bit Tools"
+.SH NAME
+casinfo \- print info about Atari 8-bit cassette images
+.\" RST source for casinfo(1) man page. Convert with:
+.
+.\" rst2man.py casinfo.rst > casinfo.1
+.
+.\" rst2man.py comes from the SBo development/docutils package.
+.
+.SH SYNOPSIS
+.sp
+casinfo \fBfile\fP
+.SH DESCRIPTION
+.sp
+\fBcasinfo\fP reads an Atari 8\-bit cassette image (aka CAS file) and prints
+the following information:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+Description
+.IP \(bu 2
+Number of Parts (aka Stages or Files)
+.IP \(bu 2
+Number of Blocks
+.IP \(bu 2
+The metadata for each block:
+.INDENT 2.0
+.IP \(bu 2
+Block Number
+.IP \(bu 2
+Record Type (data or fsk)
+.IP \(bu 2
+Part (0 for the first file/stage, 1 for the 2nd, etc)
+.IP \(bu 2
+Baud (bits/sec; normally 600)
+.IP \(bu 2
+Gap aka PRWT (Pre\-Record Write Tone, in milliseconds)
+.IP \(bu 2
+Block length in bytes (normally 132)
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+If an invalid file (not a CAS image) is given, \fBcasinfo\fP will print
+\fBError: "file" doesn\(aqt start with FUJI header\fP to stderr, then
+exit. Beware that the exit status is always 0 (success), so a script
+would have to capture and parse stderr to catch errors.
+.SH EXAMPLE
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+$ casinfo test.cas
+casinfo 0.30\-210714 (c) 2007\-2010 Matthias Reichl
+infos for "test.cas":
+Description: <none>
+Number of Parts: 1
+Number of Blocks: 3
+ 0: data part: 0 baud: 600 gap: 25647 length: 132
+ 1: data part: 0 baud: 600 gap: 252 length: 132
+ 2: data part: 0 baud: 600 gap: 254 length: 132
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+.sp
+Matthias Reichl <\fI\%hias@horus.com\fP>.
+.sp
+Man page by B. Watson <\fI\%urchlay@urchlay.com\fP>.
+.SH SEE ALSO
+.sp
+\fBatariserver\fP(1), \fBatarixfer\fP(1), \fBdir2atr\fP(1), \fBadir\fP(1), \fBataricom\fP(1).
+.sp
+AtariSIO home page: \fI\%https://www.horus.com/~hias/atari/\fP
+.\" Generated by docutils manpage writer.
+.