From 289687bd1c491d5741baca95c964ecaf9a4d4a86 Mon Sep 17 00:00:00 2001 From: Sergey Poznyakoff Date: Mon, 10 May 2004 11:36:40 +0000 Subject: [PATCH] Updated --- NEWS | 12 +++++++++++- README | 29 ++++++++++++++++++++++++++--- doc/tar.texi | 49 +++++++++++++++++++++++++++++++++---------------- 3 files changed, 70 insertions(+), 20 deletions(-) diff --git a/NEWS b/NEWS index 4cfe2d7..6063019 100644 --- a/NEWS +++ b/NEWS @@ -47,7 +47,17 @@ version 1.13.94 - Sergey Poznyakoff, 2004-04-04 * --incremental and --listed-incremental options work correctly on individual files, as well as on directories. -* New scripts: backup (replaces old level-0 and level-1) and restore +* New scripts: backup (replaces old level-0 and level-1) and restore. +The scripts are compiled and installed if --enable-backup-scripts +option is given to configure. + +* By default tar searches "rmt" utility in "$prefix/libexec/rmt", +which is consistent with the location where the version of "rmt" +included in the package is installed. Previous versions of tar +used "/etc/rmt". The full path name to the "rmt" utility may +be overridden either while configuring the package, by setting +DEFAULT_RMT_COMMAND variable, or on runtime, by giving option +--rmt-command to tar. * Removed obsolete command line options: ** --absolute-paths superseded by --absolute-names diff --git a/README b/README index 5ee115d..2fa8f3d 100644 --- a/README +++ b/README @@ -46,6 +46,28 @@ in the environment before configuring (the behavior of `-[0-7]' or `-[0-7]lmh' options in `tar' are then derived automatically). Similarly, `DEFAULT_BLOCKING' can be preset to something else than 20. +** Selecting full pathname of the "rmt" binary. + +Previous versions of tar always looked for "rmt" binary using +hardcoded path "/etc/rmt". However, the "rmt" program included +in the distribution was installed under "$prefix/libexec/rmt". +To fix this discrepancy, tar now looks for "$prefix/libexec/rmt". +If you do not want this behavior, specify full path name of +"rmt" binary using DEFAULT_RMT_COMMAND variable, e.g.: + +./configure DEFAULT_RMT_COMMAND=/etc/rmt + +** Installing backup scripts. + +This version of tar is shipped with the shell scripts for producing +incremental backups (dumps) and restoring filesystems from them. +The name of the backup script is "backup". The name of the +restore script is "restore". They are installed in "$prefix/sbin" +directory. + +Use option --enable-backup-scripts to compile and install these +scripts. + ** `--disable-largefile' omits support for large files, even if the operating system supports large files. Typically, large files are those larger on 2 GB on a 32-bit host. @@ -169,9 +191,10 @@ and new `tar' features. * What's next? -In the future we will try to release tar-1.14 as soon as possible and -start merging with paxutils afterwards. We'll also try to rewrite -some parts of the documentation after paxutils has been merged. +GNU tar will be merged into GNU paxutils: a project containing +several utilities related to creating and handling archives in +various formats. The project will include tar, cpio and pax +utilities. * Bug reporting. diff --git a/doc/tar.texi b/doc/tar.texi index 065f4ee..4afc7e5 100644 --- a/doc/tar.texi +++ b/doc/tar.texi @@ -393,6 +393,7 @@ @set xref-remove-files @xref{Writing} @set pxref-remove-files @pxref{Writing} +@set op-rmt-command @kbd{rmt-command=@var{command}} @set op-rsh-command @kbd{rsh-command=@var{command}} @set op-same-order @kbd{--same-order} (@kbd{--preserve-order}, @kbd{-s}) @@ -3206,6 +3207,11 @@ from the archive. @xref{Writing}. Directs @command{tar} to remove the source file from the file system after appending it to an archive. @FIXME-xref{} +@item --rmt-command=@var{cmd} + +Notifies @command{tar} that it should use @var{cmd} instead of +the default @file{/usr/libexec/rmt} (@pxref{Remote Tape Server}). + @item --rsh-command=@var{cmd} Notifies @command{tar} that is should use @var{cmd} to communicate with remote @@ -5950,8 +5956,11 @@ program, with a username of @var{user}. If the username is omitted (along with the @samp{@@} sign), then your user name will be used. (This is the normal @command{rsh} behavior.) It is necessary for the remote machine, in addition to permitting your @command{rsh} access, to -have the @file{/usr/ucb/rmt} program installed. If you need to use a -file whose name includes a colon, then the remote tape drive behavior +have the @file{rmt} program installed (This command is included in +the @GNUTAR{} distribution and by default is installed under +@file{@var{prefix}/libexec/rmt}, were @var{prefix} means your +installation prefix). If you need to use a file whose name includes a +colon, then the remote tape drive behavior can be inhibited by using the @value{op-force-local} option. @FIXME{i know we went over this yesterday, but bob (and now i do again, @@ -7165,7 +7174,7 @@ To use the older, obsolete, @command{compress} program, use the uses. You could be sued for patent infringement merely by running @command{compress}. -I have one question, or maybe it's a suggestion if there isn't a way +@FIXME{I have one question, or maybe it's a suggestion if there isn't a way to do it now. I would like to use @value{op-gzip}, but I'd also like the output to be fed through a program like @acronym{GNU} @command{ecc} (actually, right now that's @samp{exactly} what I'd like @@ -7197,7 +7206,7 @@ extraction is needed rather than creation. It has been reported that if one writes compressed data (through the @value{op-gzip} or @value{op-compress} options) to a DLT and tries to use the DLT compression mode, the data will actually get bigger and one will -end up with less space on the tape. +end up with less space on the tape.} @node sparse @subsection Archiving Sparse Files @@ -7918,12 +7927,19 @@ If the file name contains a @samp{:}, it is interpreted as @samp{hostname:file name}. If the @var{hostname} contains an @dfn{at} sign (@kbd{@@}), it is treated as @samp{user@@hostname:file name}. In either case, @command{tar} will invoke the command @command{rsh} (or -@command{remsh}) to start up an @file{/etc/rmt} on the remote machine. If -you give an alternate login name, it will be given to the @command{rsh}. -Naturally, the remote machine must have an executable @file{/etc/rmt}. -This program is free software from the University of California, and a -copy of the source code can be found with the sources for @command{tar}; -it's compiled and installed by default. +@command{remsh}) to start up an @command{/usr/libexec/rmt} on the remote +machine. If you give an alternate login name, it will be given to the +@command{rsh}. +Naturally, the remote machine must have an executable +@command{/usr/libexec/rmt}. This program is free software from the +University of California, and a copy of the source code can be found +with the sources for @command{tar}; it's compiled and installed by default. +The exact path to this utility is determined when configuring the package. +It is @file{@var{prefix}/libexec/rmt}, where @var{prefix} stands for +your installation prefix. This location may also be overridden at +runtime by using @value{op-rmt-command} option (@xref{Option Summary, +---rmt-command}, for detailed description of this option. @xref{Remote +Tape Server}, for the description of @command{rmt} command). If this option is not given, but the environment variable @env{TAPE} is set, its value is used; otherwise, old versions of @command{tar} @@ -8009,15 +8025,16 @@ nonzero status, exit. This implies @value{op-multi-volume}. @pindex rmt In order to access the tape drive on a remote machine, @command{tar} uses the remote tape server written at the University of California at -Berkeley. The remote tape server must be installed as @file{/etc/rmt} -on any machine whose tape drive you want to use. @command{tar} calls -@file{/etc/rmt} by running an @command{rsh} or @command{remsh} to the remote -machine, optionally using a different login name if one is supplied. +Berkeley. The remote tape server must be installed as +@file{@var{prefix}/libexec/rmt} on any machine whose tape drive you +want to use. @command{tar} calls @command{rmt} by running an +@command{rsh} or @command{remsh} to the remote machine, optionally +using a different login name if one is supplied. A copy of the source for the remote tape server is provided. It is Copyright @copyright{} 1983 by the Regents of the University of -California, but can be freely distributed. Instructions for compiling -and installing it are included in the @file{Makefile}. +California, but can be freely distributed. It is compiled and +installed by default. @cindex absolute file names Unless you use the @value{op-absolute-names} option, @GNUTAR{} -- 2.45.2