d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document some details better, making it easier to translate.

Browse Source
This commit is contained in:
Ruslan Ermilov 2006-12-20 15:34:01 +00:00
parent a9e42d31b7
commit 44fce1caa1
1 changed files with 31 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

52
usr.bin/tcopy/tcopy.1
View File

@ -32,7 +32,7 @@
.\" @(#)tcopy.1 8.2 (Berkeley) 4/17/94
.\" $FreeBSD$
.\"
.Dd April 17, 1994
.Dd December 20, 2006
.Dt TCOPY 1
.Os
.Sh NAME
@ -49,22 +49,27 @@ The
.Nm
utility is designed to copy magnetic tapes.
The only assumption made
about the tape is that there are two tape marks at the end.
The
about the tape layout is that there are two sequential EOF marks
at the end.
By default, the
.Nm
utility with only a source tape
.Pf ( Ar /dev/sa0
by default) specified will print
information about the sizes of records and tape files.
If a destination
is specified a copy will be made of the source tape.
utility will print
information about the sizes of records and files found
on the
.Pa /dev/sa0
tape, or on the tape specified by the
.Ar src
argument.
If a destination tape is also specified by the
.Ar dest
argument, a copy of the source tape will be made.
The blocking on the
destination tape will be identical to that used on the source tape.
Copying
a tape will yield the same output as if just printing the sizes.
a tape will yield the same program output as if just printing the sizes.
.Pp
Options:
.Bl -tag -width s_maxblk
The following options are available:
.Bl -tag -width ".Fl s Ar maxblk"
.It Fl c
Copy
.Ar src
@ -75,19 +80,21 @@ and then verify that the two tapes are identical.
Specify a maximum block size,
.Ar maxblk .
.It Fl v
Given the two tapes,
Given the two tapes
.Ar src
and
.Ar dest
.Ar dest ,
verify that they are identical.
.It Fl x
Output all informational messages to the standard error.
Output all informational messages to the standard error
instead of the standard output.
This option is useful when
.Ar dest
is
is given as
.Pa /dev/stdout .
.El
.Sh SEE ALSO
.Xr mt 1 ,
.Xr mtio 4
.Sh HISTORY
The
@ -102,18 +109,21 @@ the raw data.
Block size(s) and tape EOF marks are lost which would
otherwise be preserved in a tape-to-tape copy.
.It
EOD is determined by two sequential EOF marks with no data between.
There are old systems which typically wrote three EOF's between tape
End of data (EOD) is determined by two sequential EOF marks
with no data between them.
There used to be old systems which typically wrote three EOF's between tape
files.
The
.Nm
utility will erroneously stop copying early in this case.
.It
When using the copy/verify option \-c
When using the copy/verify option
.Fl c ,
.Nm
does not rewind the tapes prior to start.
A rewind is performed
after writing prior to the verification stage.
after writing, prior to the verification stage.
If one does not start
at BOT then the comparison may not be of the intended data.
at the beginning-of-tape (BOT) then the comparison
may not be of the intended data.
.El