urestore(1M)                                                   urestore(1M)


   NAME
         urestore - request restore of files and directories

   SYNOPSIS
         urestore [-mn] [-s|v] [-o target] [-d date] -F file ...

         urestore [-mn] [-s|v] [-o target] [-d date] -D 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 (see
         ursstatus(1M)) 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 user with superuser
         privileges.

      Options
         -c jobid  Cancels a previously issued restore request.

         -d date   Restores the filesystem 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 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 specified file or directory.

         -s        While a restore operation is occurring, displays a ``.''
                   for each 100 (512-byte) blocks transferred from the
                   destination device.


   8/91                                                                 Page 1

   urestore(1M)                                                   urestore(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.

         -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 -m -F 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 -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 output while the restore
         is underway.





   Page 2                                                                 8/91

   urestore(1M)                                                   urestore(1M)


         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.  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

   SEE ALSO
         restore(1M), ursstatus(1M).
         mail(1) in the User's Reference Manual.
         getdate(3C) in the Programmer's Reference Manual.

























   8/91                                                                 Page 3