restore(1M) restore(1M)
NAME
restore - initiate restores of filesystems, data partitions, or disks
SYNOPSIS
restore [-o target] [-d date] [-mn] [-s|v] -P partdev
restore [-o target] [-d date] [-mn] [-s|v] -S odevice
restore [-o target] [-d date] [-mn] [-s|v] -A partdev
DESCRIPTION
restore posts requests for the restore of a data partition, a
filesystem partition, or a disk from system-maintained archives. 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)).
restore may be executed only by a user with superuser privilege.
If restore -A partdev is issued, the fdisk(1M) (full disk recovery)
method is used to repartition and repopulate disk partdev. partdev
is the name of the device that refers to the entire disk. For the
supported DeltaSERIES reference platforms, it is /dev/rdsk/c?d?s7.
Options
-d date Restores the partition as of date. This may or may not be
the latest archive. See getdate(1M) for valid date
formats.
-m If the restore cannot be carried out immediately, this
option notifies the invoking user (via mail(1M)) 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 filesystem to be restored to
(for -S archives) and odev is the name of the partition to
be restored to (for -P and -A archives).
8/91 Page 1
restore(1M) restore(1M)
-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 partdev
Initiates restore of the entire disk partdev.
-P partdev
Initiates restore of the data partition partdev.
-S odevice
Initiates restore of the filesystem partition odevice.
DIAGNOSTICS
The exit codes for restore are the following:
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
EXAMPLES
Example 1:
restore -m -S /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 -o /dev/rdsk/c1d0s8 -P /dev/rdsk/c1d1s2
posts a request that the archived data partition /dev/rdsk/c1d1s2 be
restored to the target device partition /dev/rdsk/c1d0s8.
Example 3:
restore -d "december 1, 1987" -A /dev/rdsk/c1d0s6
posts a request for the restore of the entire disk /dev/rdsk/c1d0s6.
The restore should be made as of December 1, 1987.
Example 4:
Page 2 8/91
restore(1M) restore(1M)
restore -n -P /dev/rdsk/c1d0s1
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/c1d0s1. The data partition is not restored.
FILES
/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
SEE ALSO
fdisk(1M), mail(1M), rsnotify(1M), rsoper(1M), rsstatus(1M),
urestore(1M), ursstatus(1M).
getdate(3C) in the Programmer's Reference Manual.
8/91 Page 3