[net.sources] ts and tcp manual pages

lmc@denelvx.UUCP (Lyle McElhaney) (12/07/84)

Ok, here are the manual pages for ts and tcp. I've had > 8 requests,
and so I'll publish them (lazy old me).

				Lyle McElhaney
				...denelcor!lmc
: - - - - - - - - - - - - - cut here - - - - - - - - - - - - - - - - -
: This is a shar archieve.  Extract with sh, not csh.
: The rest of this file will extract:
: /usr/man/manl/ts.l /usr/man/manl/tcp.l
echo extracting - /usr/man/manl/ts.l
sed 's/^X//' > /usr/man/manl/ts.l << 'FUNKYSTUFF'
X.TH TS 1 "20 Aug 1984"
X.UC 4
X.SH NAME
Xts \- tape format synopsis
X.SH SYNOPSIS
X.B ts
X[
X.B \-1...15
X]
X.br
X.SH DESCRIPTION
X.I Ts
Xwill read a tape mounted on the
Xspecified tape drive an display
Xa synopsis of the files and record
Xstructure of the tape. The tape
Xdrive used is /dev/rmtX, where X
Xis specified by the option. Default
Xis to /dev/rmt0.
X.PP
XThe format of the display is:
X.nf
X.sp
X	file 0:
X		Records 0 through 2 (3 records), length = 512
X	file 1:
X		Records 0 through 0 (1 records), length = 512
X		Records 1 through 20 (20 records), length = 10240
X	End of tape reached.
X.sp
X.fi
XThe signal SIGINT is caught by
X.I ts
Xand the report is flushed up to the
Xlast block read, then
X.I ts
Xaborts.
X.SH DIAGNOSTICS
XThe usual usage diagnostic and
Xothers for cannot open and tape
Xread errors.
X.PP
XExit status is 0 normally, 1 for
Xusage error, 2 for tape read error,
Xand 3 for SIGINT caught.
X.SH DEFINES
X.I MAXBUF
Xdefines the maximum size of a tape
Xblock. Default at 16000 works with
X4.2bsd and S3 on an 11/44.
X.SH AUTHOR
XLyle McElhaney
FUNKYSTUFF
echo extracting - /usr/man/manl/tcp.l
sed 's/^X//' > /usr/man/manl/tcp.l << 'FUNKYSTUFF'
X.TH TCP 1 "21 Aug 1984"
X.UC 4
X.SH NAME
Xtcp \- tape copy with one tape drive
X.SH SYNOPSIS
X.B tcp
X[
X.B \-i
X] [
X.B \-o
X] [
X.B \-1..15
X] [
X.B \-c
X] [
X.B -nxx
X]
X.br
X.SH DESCRIPTION
XNeed to copy a tape, but only have a
Xsingle tape drive?
X.I Tcp
Xwill do it.
XIn the
X.I \-i
Xmode
X.I tcp
Xreads in all the files of a tape,
Xcopying them to disk along with enough
Xinformation to reconstruct the record
Xblocking. The tape is assumed to be
Xterminated with the usual double
Xtape marks.  In output mode (
X.I \-o
X)
X.I tcp
Xreads the files and rebuilds the tape
Xexactly as it was. The
X.I \-n
Xoption allows several tapes to be saved
Xin a single directory, if that is
Xrequired, by giving each a separate
Xnumber (0-99), and then specifying
Xthat number on both input and output.
XThe
X.I \-c
Xoption specifies that a conversational
Xmode is to be entered in the event
Xof tape read errors, in which the user
Xcan specify the action to be taken
Xwhen such an error occurs: ignore the
Xerror (copy whatever was received; this
Xmay not give desired results on some
Xsystems), retry the I/O, or abort the
Xentire copy operation. (Note that the
X.I \-c
Xoption is only available on Berkeley
Xsystems with mag tape ioctls.)
XThe numeric options allow the tape drive
Xdefault selection to be changed. The
Xinput operation uses /dev/rmtX, where
XX can be specified from 0 to 15, while
Xon output /dev/nrmtX is used (which
Xcan normally only accept 0-3 and 8-11
Xas valid drive numbers). In both cases
Xthe default drive is drive 0.
X.SH DIAGNOSTICS
XThe usual usage diagnostic and
Xothers for cannot open and tape
Xread errors.
X.PP
XExit status is 0 normally, 1 for
Xusage error and 2 for tape read error.
X.SH DEFINES
X.I MAXBUF
Xdefines the maximum size of a tape
Xblock. Default at 16000 works with both
X4.2bsd and S3 on an 11/44.
X.I MTIO,
Xif defined, compiles in the conversational
Xoption, which requires the mag tape
Xioctls from the Berkeley distributions.
X.SH AUTHOR
XLyle McElhaney
FUNKYSTUFF