summaryrefslogtreecommitdiffstats
path: root/system/atarisio/casinfo.rst
blob: a7e85cee9233618147f8b098030efb4c080f1a63 (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
.. RST source for casinfo(1) man page. Convert with:
..   rst2man.py casinfo.rst > casinfo.1
.. rst2man.py comes from the SBo development/docutils package.

.. |version| replace:: 0.30-210714
.. |date| date::

=======
casinfo
=======

--------------------------------------------
print info about Atari 8-bit cassette images
--------------------------------------------

:Manual section: 1
:Manual group: HiassofT Atari 8-bit Tools
:Date: |date|
:Version: |version|

SYNOPSIS
========

casinfo **file**

DESCRIPTION
===========

**casinfo** reads an Atari 8-bit cassette image (aka CAS file) and prints
the following information:

  - Description
  - Number of Parts (aka Stages or Files)
  - Number of Blocks
  - The metadata for each block:

    - Block Number
    - Record Type (data or fsk)
    - Part (0 for the first file/stage, 1 for the 2nd, etc)
    - Baud (bits/sec; normally 600)
    - Gap aka PRWT (Pre-Record Write Tone, in milliseconds)
    - Block length in bytes (normally 132)

If an invalid file (not a CAS image) is given, **casinfo** will print
**Error: "file" doesn't start with FUJI header** 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.

EXAMPLE
=======

::

   $ 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

AUTHOR
======

Matthias Reichl <hias@horus.com>.

Man page by B. Watson <urchlay@urchlay.com>.

SEE ALSO
========

**atariserver**\(1), **atarixfer**\(1), **dir2atr**\(1), **adir**\(1), **ataricom**\(1).

AtariSIO home page: https://www.horus.com/~hias/atari/