1
0
mirror of https://github.com/wfjm/w11.git synced 2026-01-12 00:43:01 +00:00
wfjm.w11/tools/man/man1/file2tap.1
wfjm 66f3f5d085 GitHub actions: disable-at-0 fix; man page cosmetics
- the CI/CD workflow did not defined the TBW_GHDL_OPTS environment variable,
  as consequence VHDL IEEE package warnings at t=0ms were not suppressed and
  polluted the log files
- that problem was already in .travis.yml and was carried over to ci.yml
- now fixed, and log files are not cluttered anymore with essentially
  unavoidable but harmless warnings at t=0ms.
2022-05-07 08:36:23 +02:00

74 lines
2.7 KiB
Groff

.\" -*- nroff -*-
.\" $Id: file2tap.1 1233 2022-04-30 07:01:23Z mueller $
.\" SPDX-License-Identifier: GPL-3.0-or-later
.\" Copyright 2015- by Walter F.J. Mueller <W.F.J.Mueller@gsi.de>
.\"
.\" ------------------------------------------------------------------
.
.TH FILE2TAP 1 2015-06-03 "Retro Project" "Retro Project Manual"
.\" ------------------------------------------------------------------
.SH NAME
file2tap \- create a tap format tape container from individual files
.\" ------------------------------------------------------------------
.SH SYNOPSIS
.
.SY file2tap
.B -c
.I TNAM
.B -b
.I n
.IR FLIST ...
.SY file2tap
.B -a
.I TNAM
.B -b
.I n
.IR FLIST ...
.YS
.
.\" ------------------------------------------------------------------
.SH DESCRIPTION
Creates (\fB-c\fR) a new or appends (\fB-a\fR) to an existing tap format tape
container file \fTNAM\fR and adds files. The tape record size is specified
with a \fB-b\fR option followed by the record size in units 512 bytes.
Each tape file is built from a comma-separated list of disk files \fIFLIST\fR,
which are concatenated and written with a record size given by the last
\fB-b\fR option.
\fBfile2tap\fR writes to stdout a one-line message for each created file which
gives the file number, number of records, the record size in bytes and the
names of the disk files used to build the tape file.
.
.\" ------------------------------------------------------------------
.SH OPTIONS
.
.\" ----------------------------------------------
.IP "\fB\-c \fITNAM\fR"
create a new tap format tape container with the name \fITNAM\fR.
.IP "\fB\-a \fITNAM\fR"
append to the existing tap format tape container \fITNAM\fR.
.IP "\fB\-b \fIn\fR"
gives the record size, in units of 512 bytes, for the following files.
.
.\" ------------------------------------------------------------------
.SH EXAMPLES
.IP "\fBfile2tap -c tape.tap -b 20 patch.tar\fR" 4
converts the \fBtar\fR(1) archive file \fIpatch.tar\fR into a tape
container file \fItape.tap\fR. The record size is 20*512 or 10240 bytes,
the standard block size of Unix V7 format tar archives.
.IP "\fBfile2tap -c tape.tap -b 1 b0,b1,b2 -b 2 f1 f2 -b 20 f3 f4 f5\fR" 4
creates a tape container file \fItape.tap\fR with six tape files. The first
has a record length of 512 bytes and is composed of the concatenation of the
disk files \fIb0\fR, \fIb1\fR, and \fIb2\fR. The second and third tape file
have a record length of 1024 bytes and are created from \fIf1\fR and \fIf2\fR,
respectively. The remaining three files have a record length of 10240 bytes.
.\" ------------------------------------------------------------------
.SH "SEE ALSO"
.BR tap2file (1)
.\" ------------------------------------------------------------------
.SH AUTHOR
Walter F.J. Mueller <W.F.J.Mueller@gsi.de>