X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=NEWS;h=c1df7e5e8c6b84e42c7420c8bae46724c9c09276;hb=338add8d10a787aafb6fd57aeae497a79a8d5855;hp=5767601bf3b60fafb8d37b4d12aae7d507cb9759;hpb=c78356fedadbe36aae1e063c69d11636c86d35e6;p=chaz%2Ftar diff --git a/NEWS b/NEWS index 5767601..c1df7e5 100644 --- a/NEWS +++ b/NEWS @@ -1,8 +1,143 @@ -GNU tar NEWS - User visible changes. 2008-09-24 +GNU tar NEWS - User visible changes. 2010-03-10 Please send GNU tar bug reports to -version 1.20.90 (CVS) +version 1.22.91 (Git) + +* Record size autodetection + +When listing or extracting archives, the actual record size is +reported only if the archive is read from a device (as opposed +to regular files and pipes). + +* Seekable archives + +When a read-only operation (e.g. --list or --extract) is requested +on a regular file, tar attemtps to speed up accesses by using lseek. + +* New command line option `--warning' + +The `--warning' command line option allows to suppress or enable +particular warning messages during `tar' run. It takes a single +argument (a `keyword'), identifying the class of warning messages +to affect. If the argument is prefixed with `no-', such warning +messages are suppressed. For example, + + tar --warning=no-alone-zero-block -x -f archive + +suppresses the output of `A lone zero block' diagnostics, which is +normally issued if `archive' ends with a single block of zeros. + +See Tar Manual, section 3.9 "Controlling Warning Messages", for a +detailed discussion. + +* New command line option `--level' + +The `--level=N' option sets the incremental dump level N. It +is valid when used in conjunction with the -c and --listed-incremental +options. So far the only meaningful value for N is 0. The +`--level=0' option forces creating the level 0 dump, by truncating +the snapshot file if it exists. + +* Files removed during incremental dumps + +If a file or directory is removed while incremental dump is +in progress, tar exact actions depend on whether this file +was explicitly listed in the command line, or was gathered +during file system scan. + +If the file was explicitly listed in the command line, tar +issues error message and exits with the code 2, meaning +fatal error. + +Otherwise, if the file was gathered during the file system +scan, tar issues a warning, saying "File removed before we read it", +and sets the exit code to 1, which means "some files differ". +If the --warning=no-file-removed option is given, no warning +is issued and the exit code remains 0. + +* Modification times of PAX extended headers. + +Modification times in the ustar header blocks for the +extended headers are set to the mtimes of the corresponding archive +members. This can be overridden by the + + --pax-opion='exthdr.mtime=STRING' + +command line option. The STRING is either the number of seconds since +the Epoch or a `Time reference' (see below). + +Modification times in the ustar header blocks for the global +extended headers are set to the time when tar was invoked. + +This can be overridden by the + + --pax-opion='globexthdr.mtime=STRING' + +command line option. The STRING is either the number of seconds since +the Epoch or a `Time reference' (see below). + +* Time references in --pax-option argument. + +Any value from the --pax-option argument that is enclosed in a pair +of curly braces represents a time reference. The string between the +braces is understood either as a textual time representation, as described in +chapter 7, "Date input formats", of the Tar manual, or as a name of +an existing file, starting with `/' or `.'. In the latter +case, the value is replaced with the modification time of that file. + +* Environment of --to-command script. + +The environment passed to the --to-command script is extended with +the following variables: + + TAR_VERSION GNU tar version number + TAR_ARCHIVE The name of the archive + TAR_VOLUME Ordinal number of the volume + TAR_FORMAT Format of the archive + TAR_BLOCKING_FACTOR Current blocking factor + +* Bugfixes +** Fix handling of hard link targets by -c --transform. +** Fix hard links recognition with -c --remove-files. +** Fix restoring files from backup (debian bug #508199). +** Correctly restore modes and permissions on existing directories. +** The --remove-files option removes the files only if they were +succesfully stored in the archive. +** Fix storing and listing of the volume labels in POSIX format. +** Improve algorithm for splitting long file names (ustar +format). +** Fix possible memory overflow in the rmt client code (CVE-2010-0624). + + +version 1.22 - Sergey Poznyakoff, 2009-03-05 + +* Support for xz compression + +Tar uses xz for compression if one of the following conditions is met: + + 1. The option --xz or -J (see below) is used. + 2. The xz binary is set as compressor using --use-compress-program option. + 3. The file name of the archive being created ends in `.xz' and + auto-compress option (-a) is used. + +Xz is used for decompression if one of the following conditions is met: + + 1. The option --xz or -J is used. + 2. The xz binary is set as compressor using --use-compress-program option. + 3. The file is recognized as xz compressed stream data. + +* Short option -J reassigned as a short equivalent of --xz + +* New option -I + +The -I option is assigned as a short equivalent for +--use-compress-program. + +* The --no-recursive option works in incremental mode. + + +version 1.21 - Sergey Poznyakoff, 2008-12-27 * New short option -J @@ -28,10 +163,43 @@ back to using archive suffix to determine it. Using --exclude-vcs handles also files used internally by Bazaar, Mercurial and Darcs. +* Transformation scope flags + +Name transformation expressions understand additional flags that +control type of archive members affected by them. The flags are: + + - r + Apply transformation to regular archive members. + + - s + Apply transformation to symbolic link targets. + + - h + Apply transformation to hard link targets. + +Corresponding upper-case letters negate the meaning, so that +`H' means ``do not apply transformation to hard link targets.'' + +The scope flags are listed in the third part of an `s' expression, +e.g.: + + tar --transform 's|^|/usr/local/|S' + +Default is `rsh', which means that transformations are applied to +both regular archive members and to the targets of symbolic and hard +links. If several transform expressions are used, the default flags +can be changed using `flags=' statement before the expressions, e.g.: + + tar --transform 'flags=S;s|^|/usr/local/|S' + * Bugfixes ** The --null option disabled handling of tar options in list files. This is fixed. +** Fixed record size autodetection. If detected record size differs from +the expected value (either default, or set on the command line), tar +always prints a warning if verbosity level is set to 1 or greater, +i.e. if either -t or -v option is given. @@ -1031,7 +1199,7 @@ Versions 1.07 back to 1.00 by Jay Fenlason. Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2003, -2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. +2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc. This file is part of GNU tar.