urestore(1M) urestore(1M)
NAME
urestore - request restore of files and directories
SYNOPSIS
urestore -F [-mn] [-s|v] [-o target] [-d date] file . . .
urestore -D [-mn] [-s|v] [-o target] [-d date] dir . . .
urestore -c jobid
DESCRIPTION
urestore posts requests for files or directories to be
restored 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 directories
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 restore job ID that can be used to
monitor the progress of the restore or to cancel it.
The user must have write permission for the current directory
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
privileged user.
Options
-c jobid Cancels a previously issued restore request.
-d date Restores the file system or directory as of date.
(This may or may not be the latest archive.) See
getdate(3C) for valid date formats.
-m If the restore cannot be carried out immediately,
this option notifies the invoking user (via mail)
when the request has been completed.
-n Displays a list of all archived versions of the file
system or directory contained in the backup history
log but does not attempt to restore the file system
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 specified
Copyright 1994 Novell, Inc. Page 1
urestore(1M) urestore(1M)
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 restored.
Only those archiving methods that restore named
directories and files (incfile, ffile) support this
option.
-D Initiates a restore operation for directories.
-F Initiates a restore operation for 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 -F -m bigfile
posts a request to restore the most current archived version
of the file bigfile. If the restore operation cannot be
carried out immediately, 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 -F -o /testfiles/myfile.b /testfiles/myfile.a
posts a request for the archived file /testfiles/myfile.a to
be restored as /testfiles/myfile.b
Copyright 1994 Novell, Inc. Page 2
urestore(1M) urestore(1M)
Example 4:
urestore -D -d "december 1, 1987" -v /user1
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 output while the restore is underway.
Example 5:
urestore -D -n /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. The directory is not restored.
FILES
/etc/bkup/bkhist.tab contains the labels of all
volumes that have been used
for backup operations
/etc/bkup/rsstatus.tab contains status information
about all restore requests
from users
/etc/bkup/rsnotify.tab contains the electronic mail
address of the operator to be
notified whenever restore
requests require operator
intervention
REFERENCES
getdate(3C), mail(1), restore(1M)
Copyright 1994 Novell, Inc. Page 3