urestore(1M)      MISC. REFERENCE MANUAL PAGES       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 ...  ure-
     store -c jobid

DESCRIPTION
     urestore posts requests  for  files  or  directories  to  be
     restored  from system-maintained archives.  If the appropri-
     ate 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  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 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.

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




          Last change: System Administration Utilities          1

urestore(1M)      MISC. REFERENCE MANUAL PAGES       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 out-
put while the restore is underway.  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 informa-
                                  tion about all restore
                                  requests from users






          Last change: System Administration Utilities          2

urestore(1M)      MISC. REFERENCE MANUAL PAGES       urestore(1M)



     /etc/bkup/rsnotify.tab   -   contains the electronic
                                  mail address of the
                                  operator to be notified
                                  whenever restore requests
                                  require operator inter-
                                  vention

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












































          Last change: System Administration Utilities          3