mirror of
https://github.com/wfjm/w11.git
synced 2026-03-02 10:06:43 +00:00
109 lines
4.3 KiB
Groff
109 lines
4.3 KiB
Groff
.\" -*- nroff -*-
|
|
.\" $Id: tap2file.1 1237 2022-05-15 07:51:47Z mueller $
|
|
.\" SPDX-License-Identifier: GPL-3.0-or-later
|
|
.\" Copyright 2015-2022 by Walter F.J. Mueller <W.F.J.Mueller@gsi.de>
|
|
.\"
|
|
.\" ------------------------------------------------------------------
|
|
.
|
|
.TH TAP2FILE 1 2019-07-08 "Retro Project" "Retro Project Manual"
|
|
.\" ------------------------------------------------------------------
|
|
.SH NAME
|
|
tap2file \- split a tap format tape container into individual files
|
|
.\" ------------------------------------------------------------------
|
|
.SH SYNOPSIS
|
|
.
|
|
.SY tap2file
|
|
.OP \-\-pref=p
|
|
.OP \-\-v
|
|
.I FILE
|
|
.
|
|
.SY tap2file
|
|
.B \-\-help
|
|
.YS
|
|
.
|
|
.\" ------------------------------------------------------------------
|
|
.SH DESCRIPTION
|
|
Reads the tap format tape container \fIFILE\fR and creates for tape file an
|
|
individual disk file. The created files are named \fIpref\fR_nn.dat, where
|
|
\fIpref\fR is either the prefix given with the \fB\-\-pref\fR option or the
|
|
stem of \fIFILE\fR.
|
|
|
|
\fBtap2file\fR writes to \fIstdout\fP a one-line message for each created file
|
|
which gives the filename, the number of tape records, and the record length.
|
|
In case the record length is variable the minimal and the maximal record
|
|
length is given.
|
|
.
|
|
.\" ------------------------------------------------------------------
|
|
.SH OPTIONS
|
|
.
|
|
.\" ----------------------------------------------
|
|
.IP "\fB\-pref\fR=\fIp\fR"
|
|
use \fIp\fR as a prefix to generate the names of all generated files. If not
|
|
specified the stem of the input file name is taken.
|
|
.
|
|
.\" ----------------------------------------------
|
|
.IP "\fB\-v\fR"
|
|
verbose mode, prints a message per processed record which contains file number,
|
|
record number, record length, and the first 16 bytes as hex dump. EOF and
|
|
EOT markers are also indicated. Can be useful for tapes with varying record
|
|
length files or for debugging.
|
|
.
|
|
.\" ----------------------------------------------
|
|
.IP "\fB\-help\fR"
|
|
print full help text and exit.
|
|
.\" ------------------------------------------------------------------
|
|
.SH EXAMPLES
|
|
.IP "\fBtap2file tmscptape.tap\fR" 4
|
|
reads the file \fItmscptape.tap\fR and creates a file for each tape file.
|
|
Because no \fB\-\-pref\fR option is given the output files will be named
|
|
"tmscptape_nn.dat". The \fIstdout\fP output might look like
|
|
|
|
.EX
|
|
tmscptape_00.dat: 73 records, length 512
|
|
tmscptape_01.dat: 38 records, length 1024
|
|
tmscptape_02.dat: 34 records, length 1024
|
|
tmscptape_03.dat: 36 records, length 1024
|
|
tmscptape_04.dat: 33 records, length 1024
|
|
tmscptape_05.dat: 501 records, length 10240
|
|
tmscptape_06.dat: 3516 records, length 10240
|
|
tmscptape_07.dat: 903 records, length 10240
|
|
tmscptape_08.dat: 4168 records, length 10240
|
|
.EE
|
|
|
|
which indicates that the first file had 512 byte records, the next four 1024
|
|
byte records, and the remaining ones 10240 byte records. In the case of a tape
|
|
generated by a Unix system a record length of 10240 is a good hint this the
|
|
file contains a \fBtar\fR(1) archive.
|
|
|
|
.IP "\fBtap2file -v test.tap\fR" 4
|
|
reads the file \fItest.tap\fR and writes a one-line trace info for each record.
|
|
The \fIstdout\fP output might look like
|
|
|
|
.EX
|
|
0, 0 : 80 : 00 00 00 00 50 00 06 07 08 09 0a 0b 0c 0d ...
|
|
0, 1 : 80 : 00 00 01 00 50 00 06 07 08 09 0a 0b 0c 0d ...
|
|
0, 2 : 160 : 00 00 02 00 a0 00 06 07 08 09 0a 0b 0c 0d ...
|
|
0, 3 : 160 : 00 00 03 00 a0 00 06 07 08 09 0a 0b 0c 0d ...
|
|
0, 4 : ---EOF---
|
|
test_00.dat: 4 records, length min= 80, max= 160
|
|
1, 0 : 92 : 01 00 00 00 5c 00 06 07 08 09 0a 0b 0c 0d ...
|
|
1, 1 : 92 : 01 00 01 00 5c 00 06 07 08 09 0a 0b 0c 0d ...
|
|
1, 2 : 92 : 01 00 02 00 5c 00 06 07 08 09 0a 0b 0c 0d ...
|
|
1, 3 : 100 : 01 00 03 00 64 00 06 07 08 09 0a 0b 0c 0d ...
|
|
1, 4 : 100 : 01 00 04 00 64 00 06 07 08 09 0a 0b 0c 0d ...
|
|
1, 5 : 96 : 01 00 05 00 60 00 06 07 08 09 0a 0b 0c 0d ...
|
|
1, 6 : 96 : 01 00 06 00 60 00 06 07 08 09 0a 0b 0c 0d ...
|
|
1, 7 : ---EOF---
|
|
test_01.dat: 7 records, length min= 92, max= 100
|
|
5, 0 : ---EOF---
|
|
6, 0 : ---EOT---
|
|
.EE
|
|
|
|
.\" ------------------------------------------------------------------
|
|
.SH "SEE ALSO"
|
|
.BR file2tap (1)
|
|
|
|
.\" ------------------------------------------------------------------
|
|
.SH AUTHOR
|
|
Walter F.J. Mueller <W.F.J.Mueller@gsi.de>
|