restore(1M)     UNIX System V(System Administration Utilities)      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 only be executed 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.




10/89                                                                    Page 1

restore(1M)     UNIX System V(System Administration Utilities)      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/0s8 -P /dev/rdsk/1s2

      posts a request that the archived data partition /dev/rdsk/0s8 be
      restored to the target device partition /dev/rdsk/c1d0s8.

      Example 3:

          restore -d "december 1, 1987" -A /dev/rdsk/0s6

      posts a request for the restore of the entire disk /dev/rdsk/0s6.  The
      restore should be made as of December 1, 1987.

      Example 4:

          restore -n -P /dev/drsk/0s1

      requests the system to display the backup date and an ls -l listing from
      the backup history log of all archived versions of the data partition
      /dev/rdsk/0s1.  The data partition is not restored.



Page 2                                                                    10/89

restore(1M)     UNIX System V(System Administration Utilities)      restore(1M)


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
      fdisk(1M), getdate(3), mail(1M), rsnotify(1M), rsoper(1M), rsstatus(1M),
      urestore(1M), ursstatus(1M)










































10/89                                                                    Page 3