summaryrefslogtreecommitdiffstats
path: root/system/atarisio/casinfo.1
blob: 8276050148ba669a58e1dd91f0a6d037d39b6271 (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
.\" 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.
.