xrestore(1M) 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(1M) command. The key specifies what is to be
done. key is one of the characters xt, 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.
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
Copyright 1994 Novell, Inc. Page 1
xrestore(1M) xrestore(1M)
(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.
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.
NOTICES
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
Copyright 1994 Novell, Inc. Page 2
xrestore(1M) xrestore(1M)
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.
Copyright 1994 Novell, Inc. Page 3