RESTORE(1M)                                                        RESTORE(1M)



NAME
     restore - restore files from backup

SYNOPSIS
     /usr/sysadm/privbin/restore -f source [ -v ] [ -r root ] [ -E file ] [-l
     file ]

DESCRIPTION
     restore is a privileged command that restores files from a backup made by
     tar(1) or by cpio(1).  restore is little more than a wrapper around
     cpio(1) so that privileged users can restore from backups.  The
     backup(1M) privileged command uses cpio(1) to create its backups.

     restore can be run by ordinary users without going through runpriv(1M).
     Ordinary users cannot write files in directories they don't have
     permission to write, and they cannot overwrite files they don't have
     permission to write.

OPTIONS
     -f source Specify the source where the backup is stored.  This is
               typically a tape device such as /dev/tape or
               user@remotehost:/dev/tape, but can also be a tar(1) or cpio(1)
               file for backups to disk.

     -v        Output of the restore is to be verbose.  Specifying -v to
               backup causes v to be included in the arguments to cpio(1).

     -r root   Restore files relative to root.  Normally, files are restored
               to their original locations, which would overwrite any files of
               the same name already there.  The -r option can be used to
               restore files to an alternate location.  If the tar(1) or
               cpio(1) archive was created with absolute pathnames, this
               option will have no effect.

     -E file   Specify an input file (file) that contains a list of filenames
               to be extracted from the backup (one filename per line).

     -l file   List files in the backup without restoring any of those files.
               The list of files will be displayed to stdout and will also be
               sorted and written to the named output file (file).

SEE ALSO
     sysmgr(1M), runpriv(1M), cpio(1), BackupAndRestoreManager(1M),
     backup(1M).











                                                                        Page 1