xrestore(1M) UNIX System V(Base System) xrestore(1M)
NAME
xrestore, xrestor - invoke XENIX incremental filesystem restorer
SYNOPSIS
xrestore key [ arguments ]
xrestor key [ arguments ]
DESCRIPTION
xrestore is used to read archive media backed up with the XENIX backup(C)
command. The key specifies what is to be done. Key is one of the
characters rRxt, optionally combined with f. xrestor is an alternate
spelling for the same command.
f Uses the first argument as the name of the archive instead of the
default.
F num Specifies the file number of the first volume to be restored.
k vsize Specifies the size of the volume to be restored.
r , R The archive is read and loaded into the filesystem specified in
argument. This should not be done lightly (see below). If the
key is R , xrestore asks which archive of a multivolume set to
start on. This allows xrestore to be interrupted and then
restarted (an fsck must be done before the restart).
x Each file on the archive named by an argument is extracted. The
filename has all ``mount'' prefixes removed; for example, if /usr
is a mounted filesystem, /usr/bin/lpr is named /bin/lpr on the
archive. The extracted file is placed in a file with a numeric
name supplied by xrestore (actually the inode number). In order
to keep the amount of archive read to a minimum, the following
procedure is recommended:
1. Mount volume 1 of the set of backup archives.
2. Type the xrestore command.
3. r1restore will announce whether or not it found the files,
give the numeric name that it will assign to the file, and in
the case of a tape, rewind to the start of the archive.
4. It then asks you to ``mount the desired tape volume''. Type
the number of the volume you choose. On a multivolume backup
the recommended procedure is to mount the volumes, last
through first. restore checks to see if any of the requested
files are on the mounted archive (or a later archive-thus the
reverse order). If the requested files are not there,
xrestore doesn't read through the tape. If you are working
with a single-volume backup or if the number of files being
restored is large, respond to the query with 1 , and xrestore
10/89 Page 1
xrestore(1M) UNIX System V(Base System) xrestore(1M)
will read the archives in sequential order.
X files Puts files in the directory specified by arguments.
t Prints the date the archive was written and the date the
filesystem was backed up.
T This causes xrestore to behave like dumpdir (C) except that it
doesn't list directories.
The r option should only be used to restore a complete backup archive
onto a clear filesystem, or to restore an incremental backup archive onto
a filesystem so created. Thus:
/etc/mkfs /dev/dsk/0s3 10000
xrestore r /dev/dsk/0s3
is a typical sequence to restore a complete backup. Another xrestore can
be done to get an incremental backup in on top of this.
A backup followed by a mkfs and a xrestore is used to change the size of
a filesystem.
FILES
rst* Temporary files
/etc/default/xrestore Name of default archive device
The default archive unit varies with installation.
NOTES
xrestore is for XENIX compatibility and should only be used to restore
filesystems that were backed up under XENIX.
It is not possible to successfully restore an entire active root
filesystem.
DIAGNOSTICS
There are various diagnostics involved with reading the archive and
writing the disk. There are also diagnostics if the i-list or the free
list of the filesystem is not large enough to hold the dump.
If the dump extends over more than one disk or tape, it may ask you to
change disks or tapes. Reply with a NEWLINE when the next unit has been
mounted.
Page 2 10/89