[net.sources] man page for dbcopy/fscopy

dmmartindale@watcgl.UUCP (Dave Martindale) (01/10/85)

Someone asked if I had a man page for dbcopy.  I checked, and there was
one, so here it is:  (I didn't write the man page; one of the local
gnomes must have).

dbcopy.8:
---------------------------------------------------------------
.TH DBCOPY 8 "University of Waterloo"
.SH NAME
dbcopy, fscopy \- double buffered copy programmes
.SH SYNOPSIS
.B dbcopy
[
.B \-o
] [
.B \-v
] [
[
.B \-t
] [
.B \-b
bufsize
] [
.B \-l
length
] [
.B \-c
count
] input output
.PP
.B fscopy
input output
.SH DESCRIPTION
The file
.I input
is copied onto
.IR output .
This is done using two processes synchronized via pipes, one
doing a read on
.I input
while the other does a write on
.IR output .
.I Fscopy
is an interface to
.I dbcopy
which assumes input of a filesystem, and gets appropriate blocking
and sizes from the input superblock.
.PP
On
.IR dbcopy ,
the option -b specifies the number of bytes to be transfered per io
in bytes; on a disk this should be some multiple of the track size
for optimal performance.
This defaults to 32 sectors.
The -l and -c options are to control the termination of the copy,
the total bytes copied and the number of blocks copied respectively.
The -t option indicates that the drives are both tapes, and
all blocks and end-of-file marks will be copied until two consecutive
end-of-file marks are encountered.
In this case, the blocksize parameter is the maximum blocksize;
note that on most drives no error will be given if any block longer than
this is encountered and it will be silently truncated.
If the -o option is not specified, both tapes will be taken offline if possible
following the copy.
.PP
If the -v option is specified, the number of bytes copied is given for disks;
for tapes each file copied and the number of blocks in that file.