restore(1M)       MISC. REFERENCE MANUAL PAGES        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 restore jobid 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  be
     executed  only  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.



          Last change: System Administration Utilities          1

restore(1M)       MISC. REFERENCE MANUAL PAGES        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



          Last change: System Administration Utilities          2

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



     /etc/bkup/rsnotify.tab
                      lists the email address of the operator  to
                      be   notified   whenever  restore  requests
                      require operator intervention

SEE ALSO
     fdisk(1M), mail(1M), rsnotify(1M), rsoper(1M), rsstatus(1M),
     urestore(1M), ursstatus(1M).
     getdate(3C) in the Programmer's Reference Manual.














































          Last change: System Administration Utilities          3