X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=NEWS;h=501164abd0ef306b113cc2ce9ab5253365093fc2;hb=d30babc23b4f25be970ada2e63a50220a3672281;hp=1a264b050e216021eb2b9eadc8c0ab3674bf081d;hpb=eb3ba7cb06fdd0f8627b8f117d8453e297e18b64;p=debian%2Ftar diff --git a/NEWS b/NEWS index 1a264b05..501164ab 100644 --- a/NEWS +++ b/NEWS @@ -1,6 +1,157 @@ -GNU tar NEWS - User visible changes. 2013-11-17 +GNU tar NEWS - User visible changes. 2016-05-16 Please send GNU tar bug reports to + +version 1.29 - Sergey Poznyakoff, 2016-05-16 + +* New options: --verbatim-files-from, --no-verbatim-files-from + +The --verbatim-files-from option instructs tar to treat each line read +from a file list as a file name, even if it starts with a dash. + +File lists are supplied with the --files-from (-T) option. By +default, each line read from a file list is first stripped off the +leading and trailing whitespace and, if the result begins with a dash, +it is treated as tar command line option. + +Use the --verbatim-files-from option to disable this special handling. +This facilitates the use of tar with file lists created automatically +(e.g. by find(1) command). + +This option affects all --files-from options that occur after it in +the command line. Its effect is reverted by the +--no-verbatim-files-from option. + +* --null option reads file names verbatim + +The --null option implies --verbatim-files-from. I.e. each line +read from null-delimited file lists is treated as a file name. + +This restores the documented behavior, which was broken in version +1.27. + +* New options: --owner-map=FILE and --group-map=FILE + +These two options provide fine-grained control over what user/group +names (or IDs) should be mapped when adding files to archive. + +For both options, FILE is a plain text file with user or group +mappings. Empty lines are ignored. Comments are introduced with +# sign (unless quoted) and extend to the end of the corresponding +line. Each non-empty line defines translation for a single UID (GID). +It must consist of two fields, delimited by any amount of whitespace: + + OLDNAME NEWNAME[:NEWID] + +OLDNAME is either a valid user (group) name or a ID prefixed with +. Unless +NEWID is supplied, NEWNAME must also be either a valid name or a ++ID. Otherwise, both NEWNAME and NEWID need not be listed in the +system user database. + +* New option --clamp-mtime + +The new --clamp-mtime option changes the behavior of --mtime to only +use the time specified if the file mtime is newer than the given time. +The --clamp-mtime option can only be used together with --mtime. + +Typical use case is to make builds reproducible: to loose less +information, it's better to keep the original date of an archive, +except for files modified during the build process. In that case, using +reference (and thus reproducible) timestamps for the latter is good +enough. + +See for more information. + +* Deprecated --preserve option removed + +* Sparse file detection + +Tar now uses SEEK_DATA/SEEK_HOLE on systems that support it. This +allows for considerable speed-up in sparse-file detection. + +New option --hole-detection is provided, that allows the user to +select the algorithm used for hole detection. Available arguments +are: + + --hole-detection=seek + Use lseek(2) SEEK_DATA and SEEK_HOLE "whence" parameters. + + --hole-detection=raw + Scan entire file before storing it to determine where holes + are located. + +The default is to use "seek" whenever possible, and fall back to +"raw" otherwise. + + +version 1.28, 2014-07-28 + +* New checkpoint action: totals + +The --checkpoint-action=totals option instructs tar to output the +total number of bytes transferred at each checkpoint. + +* Extended checkpoint format specification. + +New conversion specifiers are implemented. Some of them take +optional arguments, supplied in curly braces between the percent +sign and the specifier letter. + + %d - Number of seconds since tar started. + %{r,w,d}T - I/O totals; optional arguments supply prefixes + to be used before number of bytes read, written and + deleted, correspondingly. + %{FMT}t - Current local time using FMT as strftime(3) format. + If {FMT} is omitted, use %c. + %{N}* - Pad output with spaces to the Nth column, or to the + current screen width, if {N} is not given. + %c - A shortcut for "%{%Y-%m-%d %H:%M:%S}t: %ds, %{read,wrote}T%*\r" + +* New option --one-top-level + +The option --one-top-level tells tar to extract all files into a +subdirectory named by the base name of the archive (minus standard +compression suffixes recognizable by --auto-compress). When used with +an argument, as in --one-top-level=DIR, the files are extracted into the +supplied DIRectory. This ensures that no archive members are +extracted outside of the specified directory, even if the archive is +crafted so as to put them elsewhere. + +* New option --sort + +The --sort=ORDER option instructs tar to sort directory entries +according to ORDER. It takes effect when creating archives. +Available ORDERs are: none (the default), name and inode. The +latter may be absent, if the underlying system does not provide +the necessary information. + +Using --sort=name ensures the member ordering in the created archive +is uniform and reproducible. Using --sort=inode reduces the number +of disk seeks made when creating the archive and thus can considerably +speed up archivation. + +* New exclusion options + + --exclude-ignore=FILE Before dumping a directory check if it + contains FILE, and if so read exclude + patterns for this directory from FILE. + --exclude-ignore-recursive=FILE + Same as above, but the exclusion patterns + read from FILE remain in effect for any + subdirectory, recursively. + --exclude-vcs-ignores Read exclude tags from VCS ignore files, + where such files exist. Supported VCS's + are: CVS, Git, Bazaar, Mercurial. + + +* Tar refuses to read input from and write output to a tty device. + +* Manpages + +This release includes official tar(1) and rmt(8) manpages. +Distribution maintainers are kindly asked to use these instead of the +home-made pages they have been providing so far. + version 1.27.1 - Sergey Poznyakoff, 2013-11-17 @@ -300,7 +451,7 @@ Modification times in ustar header blocks of extended headers are set to mtimes of the corresponding archive members. This can be overridden by the - --pax-opion='exthdr.mtime=STRING' + --pax-option='exthdr.mtime=STRING' command line option. The STRING is either number of seconds since the Epoch or a "Time reference" (see below). @@ -310,7 +461,7 @@ headers are set to the time when tar was invoked. This can be overridden by the - --pax-opion='globexthdr.mtime=STRING' + --pax-option='globexthdr.mtime=STRING' command line option. The STRING is either number of seconds since the Epoch or a "Time reference" (see below). @@ -1436,7 +1587,7 @@ Versions 1.07 back to 1.00 by Jay Fenlason. -Copyright 1994-2001, 2003-2010, 2013 Free Software Foundation, Inc. +Copyright 1994-2001, 2003-2010, 2013-2016 Free Software Foundation, Inc. This file is part of GNU tar.