urestore(1M) SYSTEM ADMINISTRATION COMMANDS urestore(1M)
NAME
urestore - request restore of files and directories
SYNOPSIS
urestore [-o target] [-d date] [-mn] [-s|v] -F file ...
urestore [-o target] [-d date] [-mn] [-s|v] -D dir ... ure-
store -c jobid
DESCRIPTION
urestore posts requests for the restore of files or direc-
tories from system-maintained archives. If the appropriate
archive containing the requested files or directories is
on-line, the files or directories are restored immediately.
If not, a request to restore the specified files or direc-
tories is posted to a restore status table,
/etc/bkup/rsstatus.tab. A restore request that has been
posted must later be resolved by an operator (see
rsoper(1M)). Each file or directory to be restored is
assigned a restorejobid that can be used to monitor the pro-
gress of the restore (see ursstatus(1M)) or to cancel it.
The user must have write permission for the current direc-
tory and any subdirectories to be traversed in storing the
restored files or directories. Requests for restores may be
made only by the user who owned the files or directories at
the time the archive containing the files or directories was
made, or by a user with superuser privileges. urestore-c
cancels a previously issued restore request.
Options
-d date Restores the filesystem or directory as of date.
(This may or may not be the latest archive.) See
getdate(3) for valid date formats.
-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
filesystem or directory contained in the backup
history log but does not attempt to restore the
filesystem or directory.
-o target Instead of restoring directly to the specified
file or directory, this option replaces the file
or directory target with the archive of the speci-
fied file or directory.
-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
1
urestore(1M) SYSTEM ADMINISTRATION COMMANDS urestore(1M)
restored. Only those archiving methods that
restore named directories and files (incfile,
ffile) support this option.
-D Initiates restore of directories.
-F Initiates restore of files.
DIAGNOSTICS
The exit codes for urestore are the following:
0 = the task completed successfully
1 = one or more parameters to urestore are invalid
2 = an error has occurred, causing urestore to fail to
complete all portions of its task.
EXAMPLES
Example 1:
urestore -m -F bigfile
posts a request to restore the most current archived version of
the file bigfile. If the restore cannot be carried out immedi-
ately, it notifies the invoking user when the request has been
completed. Example 2:
urestore -c rest-256a,rest-256b
cancels restore requests with job id numbers rest-256a and rest-
256b. Example 3:
urestore -o /testfiles/myfile.b -F /testfiles/myfile.a
posts a request for the archived file /testfiles/myfile.a to be
restored as /testfiles/myfile.b Example 4:
urestore -d "december 1, 1987" -D /user1 -v
posts a request for the archived directory structure /user1, with
all its files and subdirectories, to be restored as of December
1, 1987. If the restore is done immediately from an on-line
archive, the name of each file will be displayed on standard out-
put while the restore is occurring. Example 5:
urestore -n -D /pr3/reports
requests the system to display the backup dates and an ls -l
listing from the backup history log of all archived versions of
the directory /pr3/reports. A restore of the directory is not
performed.
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
getdate(3), mail(1), restore(1M), ursstatus(1M)
2
urestore(1M) SYSTEM ADMINISTRATION COMMANDS urestore(1M)
3