'\"macro stdmacro
.if n .pH g1a.frec @(#)frec	40.6 of 1/17/90
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} frec 1M "Cartridge Tape Utilities" "\&"
.if \nX=1 .ds x} frec 1M "Cartridge Tape Utilities"
.if \nX=2 .ds x} frec 1M "" "\&"
.if \nX=3 .ds x} frec "" "" "\&"
.TH \*(x}
.SH NAME
\f4frec\f1 \- recover files from a backup tape
.SH SYNOPSIS
\f4/usr/sbin/frec\f1
\f1[\|\f4\-p\f2 path\f1]
\f1[\|\f4\-f\f2 reqfile\f1]
\f2raw_tape\f1
\f2i_number\f4:\f2name . . .\f1
.SH DESCRIPTION
\f4frec\fP
recovers files 
from the specified
.I raw_tape
backup tape written by \f4volcopy\fP or \f4finc\fP, given their
.IR i_numbers .
The data for each recovery request will be written into the
file given by
.I name .
.PP
The
\f4\-p\f1
option allows you to specify a default prefixing
.I path 
different from your current working directory.
This will be prefixed to any
\f2names\f1
that are not fully qualified (i.e. that do not begin with \f4/\f1
or \f4\&./\f1).
If any directories are missing in the paths of recovery
\f2names\f1,
they will be created.
.TP 16
\f4\-p\f2 path\f1
Specifies a prefixing
.I path\^
to be used to fully qualify any names
that do not start with
\f4/\f1
or 
\f4\&./\f1.
.TP 16
\f4\-f\f2 reqfile\f1
Specifies a file which contains recovery requests. The format is
\f2i_number:newname\f1, one per line.
.SH EXAMPLES
To recover a file, \f2i_number\f1 \f41216\f1 when backed-up, into a file
named \f4junk\f1
in your current working directory:
.PP
.RS
\f4frec \|/dev/rSA/ctape1 \|1216:junk\f1
.RE
.PP
To recover files with \f2i_numbers\f1 \f414156\f1, \f41232\f1, and \f43141\f1
into files 
\f4/usr/src/cmd/a\f1,
\f4/usr/src/cmd/b\f1
and
\f4/usr/joe/a.c\f1:
.PP
.RS
.nf
\f4frec \|\-p \|/usr/src/cmd \|/dev/rSA/ctape1 \|14156:a \|1232:b \e
         3141:/usr/joe/a.c\f1
.RE
.PP
.SH "SEE ALSO"
\f4ff\fP(1M),
\f4finc\fP(1M),
\f4labelit\fP(1M),
\f4volcopy\fP(1M).
.br
\f4cpio\fP(1) in the
\f2User's Reference Manual\f1.
.SH NOTES
While paving a path (i.e., creating the intermediate directories
contained in a pathname) 
\f4frec\fP
can only recover inode fields for those directories contained
on the tape and requested for recovery.
.\"	@(#)frec.1m	5.2 of 5/18/82
.Ee
