NAME

xrestore − restore file to original directory

SYNOPSIS

xrestore [−c] [−i] [−o] [−t] [−d device] | [pattern [pattern]. . .]

DESCRIPTION

-c complete restore.  All files on the tape are restored. 

-i gets the index file off of the medium.  This only works when the archive was created using xbackup.  The output is a list of all the files on the medium.  No files are actually restored. 

-o overwrite existing files.  If the file being restored already exists it will not be restored unless this option is specified. 

-t indicates that the tape device is to be used.  Must be used with the -d option when restoring from tape. 

-d device is the raw device to be used.  It defaults to dev/rmt/ctape1

When doing a restore, one or more patterns can be specified.  These patterns are matched against the files on the tape.  When a match is found, the file is restored.  Since backups are done using full pathnames, the file is restored to its original directory.  Metacharacters can be used to match multiple files.  The patterns should be in quotes to prevent the characters from being expanded before they are passed to the command.  If no patterns are specified, it defaults to restoring all files.  If a pattern does not match any file on the tape, a message is printed. 

When end of medium is reached, the user is prompted for the next media.  The user can exit at this point by typing q.  (This may cause files to be corrupted if a file happens to span a medium.)  In general, quitting in the middle is not a good idea. 

If the file already exists and an attempt is made to restore it without the -o option, the file name will be printed on the screen followed by a question mark.  This file will not be restored. 

In order for multi-volume restores to work correctly, the raw device must be used. 

SEE ALSO

sh(1), xbackup(1). 

  —  XENIX Compatibility Package