Bugfixes.
* bootstrap (symlink_to_dir): Fix symlink calculation. * doc/tar.texi: Minor fixes by Victor Villa and Stepan Kasal.
This commit is contained in:
7
.gitignore
vendored
7
.gitignore
vendored
@@ -11,21 +11,20 @@
|
|||||||
ABOUT-NLS
|
ABOUT-NLS
|
||||||
ChangeLog
|
ChangeLog
|
||||||
INSTALL
|
INSTALL
|
||||||
|
Make.rules
|
||||||
Makefile
|
Makefile
|
||||||
Makefile.in
|
Makefile.in
|
||||||
Make.rules
|
|
||||||
aclocal.m4
|
aclocal.m4
|
||||||
autom4te.cache
|
autom4te.cache
|
||||||
|
build-aux/
|
||||||
config.h
|
config.h
|
||||||
config.h.in
|
config.h.in
|
||||||
config.log
|
config.log
|
||||||
config.status
|
config.status
|
||||||
configure
|
configure
|
||||||
|
gnu
|
||||||
gnulib
|
gnulib
|
||||||
libtool
|
libtool
|
||||||
m4
|
m4
|
||||||
paxutils
|
paxutils
|
||||||
stamp-h1
|
stamp-h1
|
||||||
build-aux/
|
|
||||||
gnu
|
|
||||||
|
|
||||||
|
|||||||
@@ -415,6 +415,7 @@ symlink_to_dir()
|
|||||||
/*) ;;
|
/*) ;;
|
||||||
*)
|
*)
|
||||||
case /$dst/ in
|
case /$dst/ in
|
||||||
|
/./*) ;;
|
||||||
*//* | */../* | */./* | /*/*/*/*/*/)
|
*//* | */../* | */./* | /*/*/*/*/*/)
|
||||||
echo >&2 "$0: invalid symlink calculation: $src -> $dst"
|
echo >&2 "$0: invalid symlink calculation: $src -> $dst"
|
||||||
exit 1;;
|
exit 1;;
|
||||||
|
|||||||
4
doc/.gitignore
vendored
4
doc/.gitignore
vendored
@@ -1,4 +1,6 @@
|
|||||||
|
genfile.texi
|
||||||
getdate.texi
|
getdate.texi
|
||||||
|
header.texi
|
||||||
manual
|
manual
|
||||||
stamp-vti
|
stamp-vti
|
||||||
tar.aux
|
tar.aux
|
||||||
@@ -22,5 +24,3 @@ tar.toc
|
|||||||
tar.tp
|
tar.tp
|
||||||
tar.vr
|
tar.vr
|
||||||
version.texi
|
version.texi
|
||||||
genfile.texi
|
|
||||||
header.texi
|
|
||||||
|
|||||||
33
doc/tar.texi
33
doc/tar.texi
@@ -1429,12 +1429,12 @@ example:
|
|||||||
|
|
||||||
@smallexample
|
@smallexample
|
||||||
@group
|
@group
|
||||||
$ @kbd{tar cfv archive /etc/mail}
|
$ @kbd{tar --create --verbose --file archive /etc/mail}
|
||||||
tar: Removing leading `/' from member names
|
tar: Removing leading `/' from member names
|
||||||
/etc/mail/
|
/etc/mail/
|
||||||
/etc/mail/sendmail.cf
|
/etc/mail/sendmail.cf
|
||||||
/etc/mail/aliases
|
/etc/mail/aliases
|
||||||
$ @kbd{tar tf archive}
|
$ @kbd{tar --test --file archive}
|
||||||
etc/mail/
|
etc/mail/
|
||||||
etc/mail/sendmail.cf
|
etc/mail/sendmail.cf
|
||||||
etc/mail/aliases
|
etc/mail/aliases
|
||||||
@@ -1879,15 +1879,14 @@ will act on the entire contents of the archive.
|
|||||||
@cindex return status
|
@cindex return status
|
||||||
Besides successful exits, @GNUTAR{} may fail for
|
Besides successful exits, @GNUTAR{} may fail for
|
||||||
many reasons. Some reasons correspond to bad usage, that is, when the
|
many reasons. Some reasons correspond to bad usage, that is, when the
|
||||||
@command{tar} command is improperly written. Errors may be
|
@command{tar} command line is improperly written. Errors may be
|
||||||
encountered later, while encountering an error processing the archive
|
encountered later, while processing the archive or the files. Some
|
||||||
or the files. Some errors are recoverable, in which case the failure
|
errors are recoverable, in which case the failure is delayed until
|
||||||
is delayed until @command{tar} has completed all its work. Some
|
@command{tar} has completed all its work. Some errors are such that
|
||||||
errors are such that it would not meaningful, or at least risky, to
|
it would be not meaningful, or at least risky, to continue processing:
|
||||||
continue processing: @command{tar} then aborts processing immediately.
|
@command{tar} then aborts processing immediately. All abnormal exits,
|
||||||
All abnormal exits, whether immediate or delayed, should always be
|
whether immediate or delayed, should always be clearly diagnosed on
|
||||||
clearly diagnosed on @code{stderr}, after a line stating the nature of
|
@code{stderr}, after a line stating the nature of the error.
|
||||||
the error.
|
|
||||||
|
|
||||||
Possible exit codes of @GNUTAR{} are summarized in the following
|
Possible exit codes of @GNUTAR{} are summarized in the following
|
||||||
table:
|
table:
|
||||||
@@ -1924,7 +1923,7 @@ remote device (@pxref{Remote Tape Server}).
|
|||||||
allow you to perform a variety of tasks. You are required to choose
|
allow you to perform a variety of tasks. You are required to choose
|
||||||
one operating mode each time you employ the @command{tar} program by
|
one operating mode each time you employ the @command{tar} program by
|
||||||
specifying one, and only one operation as an argument to the
|
specifying one, and only one operation as an argument to the
|
||||||
@command{tar} command (two lists of four operations each may be found
|
@command{tar} command (the corresponding options may be found
|
||||||
at @ref{frequent operations} and @ref{Operations}). Depending on
|
at @ref{frequent operations} and @ref{Operations}). Depending on
|
||||||
circumstances, you may also wish to customize how the chosen operating
|
circumstances, you may also wish to customize how the chosen operating
|
||||||
mode behaves. For example, you may wish to change the way the output
|
mode behaves. For example, you may wish to change the way the output
|
||||||
@@ -3747,7 +3746,7 @@ If @option{--block-number} (@option{-R}) is used, @command{tar} prints, along wi
|
|||||||
every message it would normally produce, the block number within the
|
every message it would normally produce, the block number within the
|
||||||
archive where the message was triggered. Also, supplementary messages
|
archive where the message was triggered. Also, supplementary messages
|
||||||
are triggered when reading blocks full of NULs, or when hitting end of
|
are triggered when reading blocks full of NULs, or when hitting end of
|
||||||
file on the archive. As of now, if the archive if properly terminated
|
file on the archive. As of now, if the archive is properly terminated
|
||||||
with a NUL block, the reading of the file may stop before end of file
|
with a NUL block, the reading of the file may stop before end of file
|
||||||
is met, so the position of end of file will not usually show when
|
is met, so the position of end of file will not usually show when
|
||||||
@option{--block-number} (@option{-R}) is used. Note that @GNUTAR{}
|
@option{--block-number} (@option{-R}) is used. Note that @GNUTAR{}
|
||||||
@@ -5352,9 +5351,9 @@ and @command{mv}, for example) offer similar options.
|
|||||||
Backup options may prove unexpectedly useful when extracting archives
|
Backup options may prove unexpectedly useful when extracting archives
|
||||||
containing many members having identical name, or when extracting archives
|
containing many members having identical name, or when extracting archives
|
||||||
on systems having file name limitations, making different members appear
|
on systems having file name limitations, making different members appear
|
||||||
has having similar names through the side-effect of name truncation.
|
as having similar names through the side-effect of name truncation.
|
||||||
(This is true only if we have a good scheme for truncated backup names,
|
@FIXME{This is true only if we have a good scheme for truncated backup names,
|
||||||
which I'm not sure at all: I suspect work is needed in this area.)
|
which I'm not sure at all: I suspect work is needed in this area.}
|
||||||
When any existing file is backed up before being overwritten by extraction,
|
When any existing file is backed up before being overwritten by extraction,
|
||||||
then clashing files are automatically be renamed to be unique, and the
|
then clashing files are automatically be renamed to be unique, and the
|
||||||
true name is kept for only the last file of a series of clashing files.
|
true name is kept for only the last file of a series of clashing files.
|
||||||
@@ -9286,7 +9285,7 @@ is, file names having characters with the eight bit set, because they
|
|||||||
use signed checksums, while @GNUTAR{} uses unsigned
|
use signed checksums, while @GNUTAR{} uses unsigned
|
||||||
checksums while creating archives, as per @acronym{POSIX} standards. On
|
checksums while creating archives, as per @acronym{POSIX} standards. On
|
||||||
reading, @GNUTAR{} computes both checksums and
|
reading, @GNUTAR{} computes both checksums and
|
||||||
accept any. It is somewhat worrying that a lot of people may go
|
accepts any. It is somewhat worrying that a lot of people may go
|
||||||
around doing backup of their files using faulty (or at least
|
around doing backup of their files using faulty (or at least
|
||||||
non-standard) software, not learning about it until it's time to
|
non-standard) software, not learning about it until it's time to
|
||||||
restore their missing files with an incompatible file extractor, or
|
restore their missing files with an incompatible file extractor, or
|
||||||
|
|||||||
Reference in New Issue
Block a user