restore(1M) SYSTEM ADMINISTRATION COMMANDS 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 restorejobid 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 only
be executed 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 AT&T 3B2, it is /dev/rdsk/c1d?s6.
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).
-s While a restore operation is occurring, displays a
"." for each 100 (512 byte) blocks transferred
from the destination device.
1
restore(1M) SYSTEM ADMINISTRATION COMMANDS restore(1M)
-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:
restore -n -P /dev/rdsk/c1d0s1
requests the system to display the backup date and an ls -l list-
ing 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
2
restore(1M) SYSTEM ADMINISTRATION COMMANDS restore(1M)
SEE ALSO
fdisk(1M), getdate(3), mail(1M), rsnotify(1M), rsoper(1M),
rsstatus(1M), urestore(1M), ursstatus(1M)
3