XRESTORE(1M) INTERACTIVE UNIX System XRESTORE(1M)
NAME
xrestore, xrestor - invoke XENIX incremental filesystem res-
torer
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 com-
bined 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.
Fnum Specifies the file number of the first volume to be
restored.
kvsize 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 res-
tarted (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 filesys-
tem, /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. Restore 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
Rev. Base System Page 1
XRESTORE(1M) INTERACTIVE UNIX System XRESTORE(1M)
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 will read the archives in
sequential order.
Xfiles 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.
Rev. Base System Page 2
XRESTORE(1M) INTERACTIVE UNIX System XRESTORE(1M)
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.
Rev. Base System Page 3