X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=doc%2Ftar.texi;h=abfb7e9d8c4f0dcfdca35883332be4a81b033d4c;hb=a2b6327edac1c568158a9ba5f65a664423fece9d;hp=9d1072d4befe44240ec128ad7568a278ced8133c;hpb=5f19de037215499a77312a67261dfb7f8d1615a1;p=chaz%2Ftar diff --git a/doc/tar.texi b/doc/tar.texi index 9d1072d..abfb7e9 100644 --- a/doc/tar.texi +++ b/doc/tar.texi @@ -97,6 +97,10 @@ document. The rest of the menu lists all the lower level nodes. * Date input formats:: * Formats:: * Media:: + +Appendices + +* Genfile:: * Free Software Needs Free Documentation:: * Copying This Manual:: * Index:: @@ -339,6 +343,10 @@ Using Multiple Tapes * Multi-Volume Archives:: Archives Longer than One Tape or Disk * Tape Files:: Tape Files +GNU tar test suite + +* Genfile:: + Copying This Manual * GNU Free Documentation License:: License for copying this manual @@ -4921,8 +4929,12 @@ using @option{--time} option (@pxref{Scripted Backups}). @end defvr @defvr {Backup variable} TAPE_FILE -The device @command{tar} writes the archive to. This device should be -attached to the host on which the dump scripts are run. + +The device @command{tar} writes the archive to. If @var{TAPE_FILE} +is a remote archive (@pxref{remote-dev}), backup script will suppose +that your @command{mt} is able to access remote devices. If @var{RSH} +(@pxref{RSH}) is set, @option{--rsh-command} option will be added to +invocations of @command{mt}. @end defvr @defvr {Backup variable} BLOCKING @@ -4979,17 +4991,23 @@ A path to the file containing the list of the individual files to backup or restore. By default it is @file{/etc/backup/files}. @end defvr -@defvr {Backup variable} RSH +@defvr {Backup variable} MT + +Full file name of @command{mt} binary. +@end defvr -Path to @code{rsh} binary or its equivalent. You may wish to +@defvr {Backup variable} RSH +@anchor{RSH} +Full file name of @command{rsh} binary or its equivalent. You may wish to set it to @code{ssh}, to improve security. In this case you will have to use public key authentication. @end defvr @defvr {Backup variable} RSH_COMMAND -Path to rsh binary on remote mashines. This will be passed via -@option{--rsh-command} option to the remote invocation of @GNUTAR{}. +Full file name of @command{rsh} binary on remote mashines. This will +be passed via @option{--rsh-command} option to the remote invocation +of @GNUTAR{}. @end defvr @defvr {Backup variable} VOLNO_FILE @@ -5034,7 +5052,7 @@ this will just be some literal text. @defvr {Backup variable} TAR -Pathname of the @GNUTAR{} executable. If this is not set, backup +Full file name of the @GNUTAR{} executable. If this is not set, backup scripts will search @command{tar} in the current shell path. @end defvr @@ -5473,6 +5491,7 @@ $ @kbd{cd sourcedir; tar -cf - . | (cd targetdir; tar -xf -)} @cindex Standard input and output @cindex tar to standard input and output +@anchor{remote-dev} To specify an archive file on a device attached to a remote machine, use the following: @@ -6707,7 +6726,7 @@ it issues a warning, as these time stamps are nonstandard and unportable. @cindex Storing archives in compressed format @GNUTAR{} is able to create and read compressed archives. It supports -@command{gzip} and @command{bzip2} compression programms. For backward +@command{gzip} and @command{bzip2} compression programs. For backward compatibilty, it also supports @command{compress} command, although we strongly recommend against using it, since there is a patent covering the algorithm it uses and you could be sued for patent @@ -8803,6 +8822,10 @@ changeable feature. @appendix Free Software Needs Free Documentation @include freemanuals.texi +@node Genfile +@appendix Genfile +@include genfile.texi + @node Copying This Manual @appendix Copying This Manual