X-Git-Url: https://git.wh0rd.org/?a=blobdiff_plain;f=restore%2Frestore.8.in;h=ced86a47b463679bdaa44c984b0e1a738169e8ff;hb=80dea6355164a9c0231e8d7f4dcfb3fca0858f7d;hp=073cc8e45c018fb41717d9398c6f06dfa951c226;hpb=08db2b8641b95d3059d59e9c8204c891f7c5eecc;p=dump.git diff --git a/restore/restore.8.in b/restore/restore.8.in index 073cc8e..ced86a4 100644 --- a/restore/restore.8.in +++ b/restore/restore.8.in @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $Id: restore.8.in,v 1.8 2000/03/08 11:25:58 stelian Exp $ +.\" $Id: restore.8.in,v 1.19 2001/11/16 14:09:07 stelian Exp $ .\" .Dd __DATE__ .Dt RESTORE 8 @@ -40,65 +40,60 @@ .Sh SYNOPSIS .Nm restore .Fl C -.Op Fl ckMvy +.Op Fl cklMvVy .Op Fl b Ar blocksize .Op Fl D Ar filesystem .Op Fl f Ar file +.Op Fl F Ar script .Op Fl s Ar fileno .Op Fl T Ar directory .Nm restore .Fl i -.Op Fl chkmMNuvy +.Op Fl chklmMNuvVy .Op Fl b Ar blocksize .Op Fl f Ar file +.Op Fl F Ar script +.Op Fl Q Ar file .Op Fl s Ar fileno .Op Fl T Ar directory .Nm restore .Fl R -.Op Fl ckMNuvy +.Op Fl cklMNuvVy .Op Fl b Ar blocksize .Op Fl f Ar file +.Op Fl F Ar script .Op Fl s Ar fileno .Op Fl T Ar directory .Nm restore .Fl r -.Op Fl ckMNuvy +.Op Fl cklMNuvVy .Op Fl b Ar blocksize .Op Fl f Ar file +.Op Fl F Ar script .Op Fl s Ar fileno .Op Fl T Ar directory .Nm restore .Fl t -.Op Fl chkMNuvy -.Op Fl b Ar blocksize -.Op Fl f Ar file -.Op Fl s Ar fileno -.Op Fl T Ar directory -.Op file ... -.Nm restore -.Fl t -.Op Fl chkMNuvy +.Op Fl chklMNuvVy .Op Fl b Ar blocksize .Op Fl f Ar file +.Op Fl F Ar script +.Op Fl Q Ar file .Op Fl s Ar fileno .Op Fl T Ar directory .Op Fl X Ar filelist -.Nm restore -.Fl x -.Op Fl chkmMNuvy -.Op Fl b Ar blocksize -.Op Fl f Ar file -.Op Fl s Ar fileno -.Op Fl T Ar directory .Op file ... .Nm restore .Fl x -.Op Fl chkmMNuvy +.Op Fl chklmMNuvVy .Op Fl b Ar blocksize .Op Fl f Ar file +.Op Fl F Ar script +.Op Fl Q Ar file .Op Fl s Ar fileno .Op Fl T Ar directory .Op Fl X Ar filelist +.Op file ... .Pp .in (The @@ -347,6 +342,21 @@ or reads from the named file on the remote host using .Xr rmt 8 . .Pp +.It Fl F Ar script +Run script at the beginning of each tape. The device name and the +current volume number are passed on the command line. +The script must return 0 if +.Nm +should continue without asking the user to change the tape, 1 if +.Nm +should continue but ask the user to change the tape. +Any other exit code will cause +.Nm +to abort. +For security reasons, +.Nm +reverts back to the real user ID and the real group ID before +running the script. .It Fl k Use Kerberos authentication when contacting the remote tape server. (Only available if this options was enabled when @@ -358,6 +368,13 @@ Extract the actual directory, rather than the files that it references. This prevents hierarchical restoration of complete subtrees from the dump. +.It Fl l +When doing remote restores, assume the remote file is a +regular file (instead of a tape device). If you're restoring +a remote compressed file, you will need to specify this +option or +.Nm restore +will fail to access it correctly. .It Fl m Extract by inode numbers rather than by file name. This is useful if only a few files are being extracted, @@ -378,6 +395,23 @@ The flag causes .Nm to only print file names. Files are not extracted. +.It Fl Q Ar file +Use the file +.Ar file +in order to read tape position as stored using the dump Quick File +Access mode. +.Pp +It is recommended to set up the st driver to return logical tape +positions rather than physical before calling dump/restore with +parameter Q. Since not all tape devices support physical tape +positions those tape devices return an error during dump/restore when +the st driver is set to the default physical setting. +Please see the st man page, option MTSETDRVBUFFER, or the mt man +page, on how to set the driver to return logical tape positions. +.Pp +Before calling restore with parameter Q, always make sure the st +driver is set to return the same type of tape position used during the +call to dump. Otherwise restore may be confused. .It Fl s Ar fileno Read from the specified .Ar fileno @@ -406,10 +440,12 @@ The (verbose) flag causes it to type the name of each file it treats preceded by its file type. +.It Fl V +Enables reading multi-volume non-tape mediums like CDROMs. .It Fl X Ar filelist -Get the list of the files to be listed or extracted from the text file +Read list of files to be listed or extracted from the text file .Ar filelist -instead of reading them on the command line. This can be used in +in addition to those specified on the command line. This can be used in conjunction with the .Fl t or @@ -417,6 +453,10 @@ or commands. The file .Ar filelist should contain file names separated by newlines. +.Ar filelist +may be an ordinary file or +.Ql Fl +(the standard input). .It Fl y Do not ask the user whether to abort the restore in the event of an error. Always try to skip over the bad block(s) and continue. @@ -491,6 +531,14 @@ After a dump read error, may have to resynchronize itself. This message lists the number of blocks that were skipped over. .El +.Pp +.Nm Restore +exits with zero status on success. +Tape errors are indicated with an exit code of 1. +.Pp +When doing a comparison of files from a dump, an exit code +of 2 indicates that some files were modified or deleted since +the dump was made. .Sh ENVIRONMENT If the following environment variable exists it will be utilized by .Nm restore : @@ -528,6 +576,7 @@ remote shell command to use when doing a network restore (rsh, ssh etc.). If this variable is not set, .Xr rcmd 3 will be used, but only root will be able to do a network restore. +.El .Sh FILES .Bl -tag -width "./restoresymtable" -compact .It Pa /dev/st0 @@ -588,17 +637,17 @@ from the restore code - run setuid at your own risk.) .Sh AUTHOR The .Nm dump/restore -backup suit was ported to Linux's Second Extended File System +backup suite was ported to Linux's Second Extended File System by Remy Card . He maintained the initial versions of dump (up and including 0.4b4, released in january 1997). .Pp Starting with 0.4b5, the new maintainer is Stelian Pop .br -. +. .Sh AVAILABILITY The .Nm dump/restore -backup suit is available from +backup suite is available from .br http://dump.sourceforge.net .Sh HISTORY