.th FSR VIII 4/21/86
.sh NAME
fsr - incremental file system restore
.sh SYNOPSIS
fsr filesystem [-citr] [-e extentseid] [-f device]
.sh DESCRIPTION
Fsr is used to restore files dumped using the fsd command.  It is
spawned by the Secure Server at the request of a user running at
OPERATOR or higher integrity level.  The dump tape (or extent) is read
and files are copied to the file system specified.  The jnode number of
a restored file will be equal to its number before it was dumped.  The
latest incremental dump must be restored first onto a clear file
system.  At this time, jnodes are created for all files on the
filesystem and they are restored locked to prevent their use for other
purposes (such as indirect slots).  As previous dumps are restored,
only files with a jnode in the restore locked state are actually copied
from the dump medium.  Thus, to restore a file system, the incremental
dumps must be restored in reverse order of that in which they were
made.  Optional arguments include:
.sp
.lp 13 8
c       If the tape overflows, increment the minor device number
and continue on the new drive.
.lp 13 8
e       Restore from the extent specified by the extentseid and not from tape.
.lp 13 8
r	Reconstruct the system space of the file system.
The first restore to a clear extent must be done with this option.
This should not be done lightly since any existing information on the extent
will be lost.
.lp 13 8
f	Read the dump from the tape drive specified by the next
argument instead of from the default
drive (the default is d11/0).
.lp 13 8
t       Print the numbers of all jnodes restored.
.lp 13 8
.i0
.sp
.sh "SEE ALSO"
fsd(VIII),dump(V)
.sh DIAGNOSTICS
If the security map on the dump tape and the system to which it is
being restored do not agree fsr sends an audit capture message and
aborts.
.sh NOTES
The c option is not yet implemented.  The capability to send an audit
capture message has not been implemented yet.
