restore(1M) restore(1M)
NAME
restore - initiate restores of file systems, data partitions,
or disks
SYNOPSIS
restore -P [-mn] [-s|v] [-o target] [-d date] partdev . . .
restore -A [-mn] [-s|v] [-o target] [-d date] diskdev . . .
restore -S [-mn] [-s|v] [-o target] [-d date] fsdev . . .
restore [-w] [-i] [-O] [-T] [-W device | [pattern[pattern]] . . .
DESCRIPTION
Two restore facilities are delivered: the basic version and
the extended version. A basic restore command (providing five
options) is delivered in the Personal Edition. It provides a
facility that is adequate for most small machines and machines
with a minimal amount of software installed. If you install
the Extended Backup and Restore package, however, you'll have
access to the extended restore command. This section
describes the options available with both facilities.
Although many options cannot be run unless a user has
privileges to do so, some options to the basic restore command
can be executed by any user without special privileges.
The restore command cannot restore data that was backed up
using the emergency_disk(1M) and emergency_rec(1M) commands.
Data backed up using those commands should be restored using
the diskette created when running the emergency_disk command.
The Extended Restore Facility
restore posts requests for the restore of a data partition, a
file system partition, or a disk from most system-maintained
archives. (The exception is any archive created by specifying
-m ffile or -m incfile on the backreg command line. To
restore an archive created in this way, run the urestore
command.) If the appropriate archive containing the required
partition is online, the partition is restored immediately.
If not, a request to restore the specified archive of the
partition is posted to a restore status table. The restore
status table is /etc/bkup/rsstatus.tab. The restore request
is assigned a restore jobid that can be used to monitor the
progress of the restore or to cancel it. A restore request
that has been posted must later be resolved by an operator
[see rsoper(1M)].
Copyright 1994 Novell, Inc. Page 1
restore(1M) restore(1M)
If restore -A diskdev is issued, the fdisk (full disk
recovery) method is used to repartition and repopulate disk
diskdev. diskdev is the name of the device that refers to the
entire disk. For example, the name might be /dev/rdsk/*,
where the value of * is machine specific.
Options Available with the Personal Edition
-w A complete restore. All files on the tape are
restored.
-T Indicates that the tape device is to be used.
-W device device is the device special pathname to be used.
It defaults to /dev/rdsk/f0. A raw device must be
used to do multi-volume restore operations.
-i Retrieve the index file.
-O Overwrite the existing file.
Options Available with Extended Backup/Restore
-d date Restores the partition as of date. This may or may
not be the latest archive. See getdate(3C) for
valid date formats.
-i Gets the index file off the medium. This works only
when the archive was created using backup. The
output is a list of all the files on the medium. No
files are actually restored.
-m If the restore cannot be carried out immediately,
this option notifies the invoking user [via mail(1)]
when the request has been completed.
-n Displays a list of all archived versions of the
object contained in the backup history log, but does
not attempt to restore the object.
-o target Instead of restoring directly to the specified
object (partdev or fsdev), this option restores the
archive to target. target is of the form:
[oname][:odev]
where oname is the name of the file system to be
restored to (for -S archives) and odev is the name
of the partition to be restored to (for -P and -A
Copyright 1994 Novell, Inc. Page 2
restore(1M) restore(1M)
archives). This option allows you to overwrite
files. If the file being restored already exists,
it will not be restored unless this option is
specified.
-s While a restore operation is occurring, displays a
``.'' for each 100 (512-byte) blocks transferred
from the destination device.
-v Displays the name of each object as it is restored.
Only those archiving methods that restore named
directories and files (incfile, ffile) support this
option.
-A Initiates restore of the entire disk.
-O Overwrite existing files. If the file being
restored already exists it will not be restored
unless this option is specified.
-P Initiates restore of the data partition.
-S Initiates restore of the file system partition.
DIAGNOSTICS
The exit codes for the extended restore command are as
follows:
0 The task completed successfully.
1 One or more parameters to restore are invalid.
2 An error has occurred, causing restore to fail to
complete all portions of its task.
NOTICES
If a backup or restore is aborted or fails to complete, then
in some cases the devices which were being used may be left
reserved to the original backup or restore process. This may
prevent subsequent backup or restore operations from working.
You can check whether devices are reserved by typing:
devreserv
which reports any reserved devices, with the process id of the
process to which each is attached. To free a reserved device
for reuse, enter:
Copyright 1994 Novell, Inc. Page 3
restore(1M) restore(1M)
devfree pid
where pid is the process id reported by devreserv.
If you are doing a restore operation on the UnixWare Desktop,
and are restoring from a Release 1.1 backup onto a Release 2.0
system, you will encounter strange system behavior. Refer to
the Troubleshooting section in the "Installation Handbook" for
complete information.
EXAMPLES
The following examples show several uses of the extended
restore command.
Example 1:
restore -S -m /usr
posts a request to restore the most current archived version
of /usr. If the restore cannot be carried out immediately,
notify the invoking user when the request has been completed.
Example 2:
restore -P -o /dev/rdsk/* /dev/rdsk/y
posts a request that the archived data partition /dev/rdsk/y
be restored to the target device partition /dev/rdsk/*, where
the value of * and y are machine specific.
Example 3:
restore -A -d "december 1, 1987" /dev/rdsk/*
posts a request for the restore of the entire disk
/dev/rdsk/*, where the value of * is machine specific. The
restore should be made as of December 1, 1987.
Example 4:
restore -P -n /dev/rdsk/*
requests the system to display the backup date and an ls -l
listing from the backup history log of all archived versions
of the data partition /dev/rdsk/*, where the value of * is
machine specific. The data partition is not restored.
FILES
The following files are used by the extended restore command.
Copyright 1994 Novell, Inc. Page 4
restore(1M) restore(1M)
/etc/bkup/bkhist.tab
lists the labels of all volumes that have
been used for backup operations
/etc/bkup/rsstatus.tab
lists the status of all restore requests from
users
/etc/bkup/rsnotify.tab
lists the email address of the operator to be
notified whenever restore requests require
operator intervention
REFERENCES
emergency_disk(1M), emergency_rec(1M), getdate(3C), mail(1),
rsoper(1M), urestore(1M)
Copyright 1994 Novell, Inc. Page 5