c25d04f105bfc215aaffff4b56508cc9296108d5
[debian/tar] / NEWS
1 GNU tar NEWS - User visible changes. 2007-06-29
2 Please send GNU tar bug reports to <bug-tar@gnu.org>
3
4 \f
5 version 1.18 - Sergey Poznyakoff, 2007-06-29
6
7 * Licensed under the GPLv3
8
9 * Fixed several bugs in the testsuite
10
11 \f
12 version 1.17 - Sergey Poznyakoff, 2007-06-08
13
14 * Fix archivation of sparse files in posix mode.  Previous versions padded
15   sparse members with spurious zero blocks.
16
17 * Fix operation of --verify --listed-incremental.  Version 1.16.1 produced
18   a full dump when both options were given.
19
20 * Fix --occurrence.  In previous versions it continued scanning the archive
21   even though all requested members has already been extracted.
22
23 * Scope of --transform and --strip-components options.
24
25 In addition to affecting regular archive members, the --transform
26 option affects hard and soft link targets and the --strip-components
27 option affects hard link targets as well.
28
29 * End-of-volume script can send the new volume name to tar by writing
30   it to the file descriptor stored in the environment variable `TAR_FD'.
31
32 \f
33 version 1.16.1 - Sergey Poznyakoff, 2006-12-09
34
35 * New option --exclude-tag allows to specify "exclusion tag files", i.e.
36   files whose presence in a directory means that the directory should not
37   be archived.
38
39 * The --exclude-cache option excludes directories that contain the
40   CACHEDIR.TAG file from being archived.  Previous versions excluded
41   directory contents only, while the directories themselves were
42   still added to the archive.
43
44 * Support for reading ustar type 'N' header logical records has been removed.
45   This GNU extension was generated only by very old versions of GNU 'tar'.
46   Unfortunately its implementation had security holes; see
47   <http://archives.neohapsis.com/archives/fulldisclosure/2006-11/0344.html>.
48   We don't expect that any tar archives in practical use have type 'N'
49   records, but if you have one and you trust its contents, you can
50   decode it with GNU tar 1.16 or earlier.
51
52 * Race conditions have been fixed that in some cases briefly allowed
53   files extracted by 'tar -x --same-owner' (or plain 'tar -x', when
54   running as root) to be accessed by users that they shouldn't have been.
55
56 \f
57 version 1.16 - Sergey Poznyakoff, 2006-10-21
58
59 * After creating an archive, tar exits with code 1 if some files were
60 changed while being read.  Previous versions exited with code 2 (fatal
61 error), and only if some files were truncated while being archived.
62
63 * New option --mtime allows to set modification times for all archive
64 members during creation.
65
66 * Bug fixes
67 ** Avoid running off file descriptors when using multiple -C options.
68 ** tar --index-file=FILE --file=- sent the archive to FILE, and
69 the listing to stderr.
70
71 \f
72 version 1.15.91 - Sergey Poznyakoff, 2006-06-16
73
74 * Incompatible changes
75
76 ** Globbing
77
78 Previous versions of GNU tar assumed shell-style globbing when
79 extracting from or listing an archive.  For example:
80
81   tar xf foo.tar '*.c'
82
83 would extract all files whose names end in '.c'.  This behavior
84 was not documented and was incompatible with traditional tar
85 implementations.  Therefore, starting from this version, GNU tar
86 no longer uses globbing by default.  For example, the above invocation
87 is now interpreted as a request to extract from the archive the file
88 named '*.c'.
89
90 To treat member names as globbing patterns, use --wildcards option.
91 If you wish tar to mimic the behavior of versions up to 1.15.90,
92 add --wildcards to the value of the environment variable TAR_OPTIONS.
93
94 The exact way in which tar interprets member names is controlled by the
95 following command line options:
96
97      --wildcards              use wildcards
98      --anchored               patterns match file name start
99      --ignore-case            ignore case
100      --wildcards-match-slash  wildcards match `/'
101
102 Each of these options has a '--no-' counterpart that disables its
103 effect (e.g. --no-wildcards).
104
105 These options affect both the interpretation of member names from
106 command line and that of the exclusion patterns (given with --exclude
107 and --exclude-from options). The defaults are:
108
109  1. For member names: --no-wildcards --anchored
110  2. For exclusion patterns: --wildcards --no-anchored --wildcards-match-slash
111
112 The options can appear multiple times in the command line, thereby
113 changing the way command line arguments are interpreted.  For example,
114 to use case-insensitive matching in exclude patterns and to revert to
115 case-sensitive matching for the rest of command line, one could write:
116
117   tar xf foo.tar --ignore-case --exclude-from=FILE --no-ignore-case file.name
118
119 ** Short option -l is now an alias of --check-links option, which complies
120 with UNIX98.  This ends the transition period started with version 1.14.
121
122 * New features
123
124 ** New option --transform allows to transform file names before storing them
125 in the archive or member names before extracting.  The option takes a
126 sed replace expression as its argument.  For example,
127
128   tar cf foo.tar --transform 's,^,prefix/,'
129
130 will add 'prefix/' to all file names stored in foo.tar.
131
132 ** --strip-components option works when deleting and comparing.  In previous
133 versions it worked only with --extract.
134
135 ** New option --show-transformed-names enables display of transformed file
136 or archive.   It generalizes --show-stored-names option, introduced in
137 1.15.90.  In particular, when creating an archive in verbose mode, it lists
138 member names as stored in the archive, i.e., with any eventual prefixes
139 removed and file name transformations applied.  The option is useful,
140 for example, while comparing `tar cv' and `tar tv' outputs.
141
142 ** New incremental snapshot file format keeps information about file names
143 as well as that about directories.
144
145 ** The --checkpoint option takes an optional argument specifying the number
146 of records between the two successive checkpoints.   Optional dot
147 starting the argument intructs tar to print dots instead of textual
148 checkpoints.
149
150 ** The --totals option can be used with any tar operation (previous versions
151 understood it only with --create).  If an argument to this option is
152 given, it specifies the signal upon delivery of which the statistics
153 is to be printed.  Both forms of this option (with and without
154 argument) can be given to in a single invocation of tar.
155
156 * Bug fixes
157 ** Detect attempts to update compressed archives.
158
159 \f
160 version 1.15.90 - Sergey Poznyakoff, 2006-02-19
161
162 * New features
163
164 ** Any number of -T (--files-from) options may be used in the command line.
165 The file specified with -T may include any valid `tar' options,
166 including another -T option.
167 Compatibility note: older versions of tar would only recognize -C
168 as an option name within the file list file.  Now any file whose name
169 starts with - is handled as an option.  To insert file names starting with
170 dash, use the --add-file option.
171
172 ** List files containing null-separated file names are detected and processed
173 automatically.  It is no longer necessary to give the --null option.
174
175 ** New option --no-unquote disables the unquoting of input file names.
176 This is useful for processing output from `find dir -print0'.
177 An orthogonal option --unquote is provided as well.
178
179 ** New option --test-label tests the archive volume label.
180 If an argument is specified, the label is compared against its value.
181 Tar exits with code 0 if the two strings match, and with code 2 if
182 they do not.
183
184 If no argument is given, the --verbose option is implied.  In this case,
185 tar prints the label name if present and exits with code 0.
186
187 ** New option --show-stored-names.  When creating an archive in verbose mode,
188 it lists member names as stored in the archive, i.e., with any eventual
189 prefixes removed.  The option is useful, for example, while comparing
190 `tar cv' and `tar tv' outputs.
191
192 ** New option --to-command pipes the contents of archive members to the
193 specified command.
194
195 ** New option --atime-preserve=system, which uses the O_NOATIME feature
196 of recent Linux kernels to avoid some problems when preserving file
197 access times.
198
199 ** New option --delay-directory-restore delays restoring modification times
200 and permissions of extracted directories until the end of extraction.
201 This is necessary for restoring from archives with unusual member
202 ordering (in particular, those created with --no-recursion option).
203 This option is implied when restoring from incremental archives.
204
205 ** New option --restrict prohibits use of some potentially harmful tar
206 options.  Currently it disables '!' escape in multi-volume name menu.
207
208 ** New options --quoting-style and --quote-chars control the way tar
209 quotes member names on output. The --quoting-style takes an argument
210 specifying the quoting style to use (literal, shell, shell-always,
211 c, escape, locale, clocale). The argument to --quote-chars is a string
212 specifying characters to quote, even if the selected quoting style
213 would not quote them otherwise. The option --no-quote-chars is
214 provided to disable quoting certain characters.
215
216 ** The end-of-volume script (introduced with --info-script option) can
217 get current archive name from the environment variable TAR_ARCHIVE and
218 the volume number from the variable TAR_VOLUME.  It can alter the
219 archive name by writing new name to the file descriptor 3.
220
221 ** Better support for full-resolution time stamps.  Tar cannot restore
222 time stamps to full nanosecond resolution, though, until the kernel
223 guys get their act together and give us a system call to set file time
224 stamps to nanosecond resolution.
225
226 ** The -v option now prints time stamps only to 1-minute resolution,
227 not full resolution, to avoid using up too many output columns.
228 Nanosecond resolution is now supported, but that would be too much.
229
230 * Bug fixes
231
232 ** Allow non-option arguments to be interspersed with options.
233 ** When extracting or listing archives in old GNU format, tar
234 used to read an extra block of data after a long name header
235 if length of the member name was divisible by block size (512).
236 Consequently, the file pointer was set off and the next member
237 was not processed correctly.
238 ** Previous version created invalid archives when files shrink
239 during reading.
240 ** Compare mode (tar d) hung when trying to compare file contents.
241 ** Previous versions in certain cases failed to restore directory
242 modification times.
243 ** When creating an archive, do not attempt to store files whose
244 meta-data cannot be stored in the header due to format limitations
245 (for ustar and v7 formats).
246 ** The --version option now also outputs information about copyright,
247 license, and credits.  This reverts to the behavior of tar 1.14 and
248 earlier, and conforms to the GNU coding standards.  The --license (-L)
249 option introduced in tar 1.15 has been removed, since it's no longer
250 needed.
251
252 \f
253 version 1.15.1 - Sergey Poznyakoff, 2004-12-21
254
255 This version fixes a bug introduced in 1.15 which caused
256 tar to refuse to extract files from standard input.
257
258 \f
259 version 1.15 - Sergey Poznyakoff, 2004-12-20
260
261 * Compressed archives are recognised automatically, it is no longer
262 necessary to specify -Z, -z, or -j options to read them.  Thus, you can
263 now run `tar tf archive.tar.gz'.
264
265 * When restoring incremental dumps, --one-file-system option
266 prevents directory hierarchies residing on different devices
267 from being purged.
268
269 With the previous versions of tar it was dangerous to create
270 incremental dumps with --one-file-system option, since they
271 would recursively remove mount points when restoring from the
272 back up.  This change fixes the bug.
273
274 * Renamed --strip-path to --strip-components for consistency with
275 the GNU convention.
276
277 * Skipping archive members is sped up if the archive media supports
278 seeks.
279
280 * Restore script starts restoring only if it is given --all (-a) option,
281 or some patterns.  This is to prevent accidental restores.
282
283 * `tar --verify' prints a warning if during archive creation some of
284 the file names had their prefixes stripped off.
285
286 * New option --exclude-caches instructs tar to exclude cache directories
287 automatically on archive creation.  Cache directories are those
288 containing a standardized tag file, as specified at:
289
290         http://www.brynosaurus.com/cachedir/spec.html
291
292 * New configure option --with-rmt allows to specify full path name to
293 the `rmt' utility.  This supersedes DEFAULT_RMT_COMMAND variable
294 introduced in version 1.14
295
296 * New configure variable DEFAULT_RMT_DIR allows to specify the directory
297 where to install `rmt' utility.  This is necessary since modifying
298 --libexecdir as was suggested for version 1.14 produced a side effect: it
299 also modified installation prefix for backup scripts (if
300 --enable-backup-scripts was given).
301
302 * Bug fixes:
303 ** Fixed flow in recognizing files to be included in incremental dumps.
304 ** Correctly recognize sparse archive members when used with -T option.
305 ** GNU multivolume headers cannot store filenames longer than 100 characters.
306 Do not allow multivolume archives to begin with such filenames.
307 ** If a member with link count > 2 was stored in the archive twice,
308 previous versions of tar were not able to extract it, since they
309 were trying to link the file to itself, which always failed and
310 lead to removing the already extracted copy.  Preserve the first
311 extracted copy in such cases.
312 ** Restore script was passing improper argument to tar --listed option (which
313 didn't affect the functionality, but was logically incorrect).
314 ** Fixed verification of created archives.
315 ** Fixed unquoting of file names containing backslash escapes (previous
316 versions failed to recognize \a and \v).
317 ** When attempting to delete a non-existing member from the archive, previous
318 versions of tar used to overwrite last archive block with zeroes.
319
320 \f
321 version 1.14 - Sergey Poznyakoff, 2004-05-11
322
323 * Added support for POSIX.1-2001 and ustar archive formats.
324 * New option --format allows to select the output archive format
325 * The default output format can be selected at configuration time
326   by presetting the environment variable DEFAULT_ARCHIVE_FORMAT.
327   Allowed values are GNU, V7, OLDGNU and POSIX.
328 * New option --strip-path allows to cut off a given number of
329   path elements from the name of the file being extracted.
330
331 * New options --index-file, --no-overwrite-dir.  The --overwrite-dir
332   option is now the default; use --no-overwrite-dir if you prefer
333   the previous default behavior.
334
335 * The semantics of -o option is changed.  When extracting, it
336   does the same as --no-same-owner GNU tar option.  This is compatible
337   with UNIX98 tar.  Otherwise, its effect is the same as that of
338   --old-archive option.  This latter is deprecated and will be removed
339   in future.
340
341 * New option --check-links prints a message if not all links are dumped
342   for a file being archived.  This corresponds to the UNIX98 -l option.
343   The current semantics of the -l option is retained for compatibility
344   with previous releases, however such usage is strongly deprecated as
345   the option will change to its UNIX98 semantics in the future releases.
346
347 * New option --occurrence[=N] can be used in conjunction with one of
348   the subcommands --delete, --diff, --extract or --list when a list of
349   files is given either on the command line or via -T option.  This
350   option instructs tar to process only the Nth occurrence of each named
351   file.  N defaults to 1, so `tar -x -f archive --occurrence filename'
352   extracts the first occurrence of `filename' from `archive'
353   and terminates without scanning to the end of the archive.
354
355 * New option --pax-option allows to control the handling of POSIX
356   keywords in `pax' extended headers.  It is equivalent to `pax'
357   -o option.
358
359 * --incremental and --listed-incremental options work correctly on
360   individual files, as well as on directories.
361
362 * New scripts: backup (replaces old level-0 and level-1) and restore.
363 The scripts are compiled and installed if --enable-backup-scripts
364 option is given to configure.
365
366 * By default tar searches "rmt" utility in "$prefix/libexec/rmt",
367 which is consistent with the location where the version of "rmt"
368 included in the package is installed.  Previous versions of tar
369 used "/etc/rmt".  To install "rmt" to its traditional location,
370 run configure with option --libexecdir=/etc.  Otherwise, if you
371 already have rmt installed and wish to use it, instead of the
372 shipped in version, set the variable DEFAULT_RMT_COMMAND to
373 the full path name of the utility, e.g., ./configure
374 DEFAULT_RMT_COMMAND=/etc/rmt.
375
376 Notice also that the full path name of the "rmt" utility to
377 use can be set at runtime, by giving option --rmt-command to
378 tar.
379
380 * Removed obsolete command line options:
381 ** --absolute-paths superseded by --absolute-names
382 ** --block-compress is not needed any longer
383 ** --block-size superseded by --blocking-factor
384 ** --modification-time superseded by --touch
385 ** --read-full-blocks superseded by --read-full-records
386 ** --record-number superseded by --block-number
387 ** --version-control superseded by --backup
388
389 * New message translations fi (Finnish), gl (Galician), hr (Croatian),
390   hu (Hungarian), ms (Malaysian), nb (Norwegian), ro (Romanian), sk
391   (Slovak), zh_CN (Chinese simplified), zh_TW (Chinese traditional).
392   The code 'no' for Norwegian (Bokmål) has been withdrawn; use 'nb' instead.
393
394 * Bug fixes.
395
396 \f
397 version 1.13.25 - Paul Eggert, 2001-09-26
398
399 * Bug fixes.
400
401 \f
402 version 1.13.24 - Paul Eggert, 2001-09-22
403
404 * New option --overwrite-dir.
405 * Fixes for buffer overrun, porting, and copyright notice problems.
406 * The message translations for Korean are available again.
407
408 \f
409 version 1.13.23 - Paul Eggert, 2001-09-13
410
411 * Bug, porting, and copyright notice fixes.
412
413 \f
414 version 1.13.22 - Paul Eggert, 2001-08-29
415
416 * Bug fixes.
417
418 \f
419 version 1.13.21 - Paul Eggert, 2001-08-28
420
421 * Porting and copyright notice fixes.
422
423 \f
424 version 1.13.20 - Paul Eggert, 2001-08-27
425
426 * Some bugs were fixed:
427   - security problems
428   - hard links to symbolic links
429
430 * New option --recursion (the default) that is the inverse of --no-recursion.
431
432 * New options --anchored, --ignore-case, --wildcards,
433   --wildcards-match-slash, and their negations (e.g., --no-anchored).
434   Along with --recursion and --no-recursion, these options control how
435   exclude patterns are interpreted.
436
437 * The default interpretation of exclude patterns is now --no-anchored
438   --no-ignore-case --recursion --wildcards --wildcards-match-slash.
439   This is a quiet change to the semantics of --exclude.  The previous
440   semantics were a failed attempt at backward compatibility but it
441   became clear that the semantics were puzzling and did not satisfy
442   everybody.  Rather than continue to try to revive that dead horse we
443   thought it better to substitute cleaner semantics, with options so
444   that you can change the behavior more to your liking.
445
446 * New message translations for Indonesian and Turkish.
447   The translation for Korean has been withdrawn due to encoding errors.
448   It will be reissued once those are fixed.
449
450 \f
451 version 1.13.19 - Paul Eggert, 2001-01-13
452
453 * The -I option has been withdrawn, as it was buggy and confusing.
454   Eventually it is planned to be reintroduced, with the same meaning as -T.
455
456 * With an option like -N DATE, if DATE starts with "/" or ".", it is taken
457   to be a file name; the last-modified time of that file is used as the date.
458
459 \f
460 version 1.13.18 - Paul Eggert, 2000-10-29
461
462 * Some security problems have been fixed.  `tar -x' now modifies only
463   files under the working directory, unless you also specify an unsafe
464   option like --absolute-names or --overwrite.
465
466 * The short name of the --bzip option has been changed to -j,
467   and -I is now an alias for -T, for compatibility with Solaris tar.
468
469 * The manual is now distributed under the GNU Free Documentation License.
470
471 * The new environment variable TAR_OPTIONS holds default command-line options.
472
473 * The --no-recursion option now affects extraction too.
474
475 * The wording in some diagnostics has been changed slightly.
476
477 * Snapshot files now record whether each file was accessed via NFS.
478   The new file format is upward- and downward-compatible with the old.
479
480 * New language supported: da.
481
482 * Compilation by traditional (K&R) C compilers is no longer supported.
483   If you still use such a compiler, please use GCC instead.
484
485 * This version of tar works best with GNU gzip test version 1.3 or later.
486   Please see <ftp://alpha.gnu.org/gnu/gzip/>.
487
488 * `tar --delete -f -' now works again.
489
490 \f
491 version 1.13.17 - Paul Eggert, 2000-01-07.
492
493 * `tar --delete -f -' is no longer allowed; it was too buggy.
494 * Diagnostic messages have been made more regular and consistent.
495
496 \f
497 version 1.13.16 - Paul Eggert, 1999-12-13.
498
499 * By default, tar now refuses to overwrite an existing file when
500   extracting files from an archive; instead, it removes the file
501   before extracting it.  If the existing file is a symbolic link, the
502   link is removed and not the pointed-to file.  There is one
503   exception: existing nonempty directories are not removed, nor are
504   their ownerships or permissions extracted.  This fixes some
505   longstanding security problems.
506
507   The new --overwrite option enables the old default behavior.
508
509   For regular files, tar implements this change by using the O_EXCL
510   option of `open' to ensure that it creates the file; if this fails, it
511   removes the file and tries again.  This is similar to the behavior of
512   the --unlink-first option, but it is faster in the common case of
513   extracting a new directory.
514
515 * By default, tar now ignores file names containing a component of `..'
516   when extracting, and warns about such file names when creating an archive.
517   To enable the old behavior, use the -P or --absolute-names option.
518
519 * Tar now handles file names with multibyte encodings (e.g., UTF-8, Shift-JIS)
520   correctly.  It relies on the mbrtowc function to handle multibyte characters.
521
522 * The file generated by -g or --listed-incremental now uses a format
523   that is independent of locale, so that users need not worry about
524   locale when restoring a backup.  This is needed for proper support
525   of multibyte characters.  Old-format files can still be read, and
526   older versions of GNU tar can read new-format files, unless member
527   names have multibyte chars.
528
529 * Many diagnostics have been changed slightly, so that file names are
530   now output unambiguously.  File names in diagnostics now are either
531   `quoted like this' (in the default C locale) or are followed by
532   colon, newline, or space, depending on context.  Unprintable
533   characters are escaped with a C-like backslash conventions.
534   Terminating characters (e.g., close-quote, colon, newline)
535   are also escaped as needed.
536
537 * tar now ignores socket files when creating an archive.
538   Previously tar archived sockets as fifos, which caused problems.
539
540 \f
541 version 1.13.15 - Paul Eggert, 1999-12-03.
542
543 * If a file's ctime changes when being archived, report an error.
544   Previously tar looked at mtime, which missed some errors.
545
546 \f
547 version 1.13.14 - Paul Eggert, 1999-11-07.
548
549 * New translations ja, pt_BR.
550 * New options --help and --version for rmt.
551 * Ignore Solaris door files when creating an archive.
552
553 \f
554 version 1.13.13 - Paul Eggert, 1999-10-11.
555
556 * Invalid headers in tar files now elicit errors, not just warnings.
557 * `tar --version' output conforms to the latest GNU coding standards.
558 * If you specify an invalid date, `tar' now substitutes (time_t) -1.
559 * `configure --with-dmalloc' is no longer available.
560
561 \f
562 version 1.13.12 - Paul Eggert, 1999-09-24.
563
564 * `tar' now supports hard links to symbolic links.
565
566 * New options --no-same-owner, --no-same-permissions.
567
568 * --total now also outputs a human-readable size, and a throughput value.
569
570 * `tar' now uses two's-complement base-256 when outputting header
571   values that are out of the range of the standard unsigned base-8
572   format.  This affects archive members with negative or huge time
573   stamps or uids, and archive members 8 GB or larger.  The new tar
574   archives cannot be read by traditional tar, or by older versions of
575   GNU tar.  Use the --old-archive option to revert to the old
576   behavior, which uses unportable representations for negative values,
577   and which rejects large files.
578
579 * On 32-bit hosts, `tar' now assumes that an incoming time stamp T in
580   the range 2**31 <= T < 2**32 represents the negative time (T -
581   2**32).  This behavior is nonstandard and is not portable to 64-bit
582   time_t hosts, so `tar' issues a warning.
583
584 * `tar' no longer gives up extracting immediately upon discovering
585   that an archive contains garbage at the end.  It attempts to extract
586   as many files as possible from the good data before the garbage.
587
588 * A read error now causes a nonzero exit status, not just a warning.
589
590 * Some diagnostics have been reworded for consistency.
591
592 \f
593 version 1.13.11 - Paul Eggert, 1999-08-23.
594
595 * The short name of the --bzip option has been changed to -I,
596   for compatibility with paxutils.
597
598 * -T /dev/null now matches nothing; previously, it matched anything
599   if no explicit operands were given.
600
601 * The `--' option now works the same as with other GNU utilities;
602   it causes later operands to be interpreted as file names, not options,
603   even if they begin with `-'.
604
605 * For the --newer and --after-date options, the table of time zone
606   abbreviations like `EST' has been updated to match current practice.
607   Also, local time abbreviations are now recognized, even if they are
608   not in tar's hardwired table.  Remember, though, that you should use
609   numeric UTC offsets like `-0500' instead of abbreviations like
610   `EST', as abbreviations are not standardized and are ambiguous.
611
612 \f
613 version 1.13.10 - Paul Eggert, 1999-08-20.
614
615 * `tar' now uses signed base-64 when outputting header values that are
616   out of the range of the standard unsigned base-8 format.  [This
617   change was superseded in 1.13.12, described above.]
618
619 \f
620 version 1.13.9 - Paul Eggert, 1999-08-18.
621
622 * `tar' now writes two zero blocks at end-of-archive instead of just one.
623   POSIX.1 requires this, and some other `tar' implementations check for it.
624
625 * `tar' no longer silently accepts a block containing nonzero checksum bytes
626   as a zero block.
627
628 * `tar' now reads buggy tar files that have a null byte at the start of a
629   numeric header field.
630
631 \f
632 version 1.13.8 - Paul Eggert, 1999-08-16.
633
634 * For compatibility with traditional `tar', intermediate directories
635   created automatically by root are no longer given the uid and gid of
636   the original file or directory.
637
638 \f
639 version 1.13.7 - Paul Eggert, 1999-08-14.
640
641 * --listed-incremental and --newer are now incompatible options.
642
643 * When creating an archive, leading `./' is no longer stripped,
644   to match traditional tar's behavior (and simplify the documentation).
645
646 * --diff without --absolute-names no longer falls back on absolute names.
647
648 \f
649 version 1.13.6 - Paul Eggert, 1999-08-11.
650
651 * An --exclude pattern containing / now excludes a file only if it matches an
652   initial prefix of the file name; a pattern without / continues to
653   exclude a file if it matches any file name component.
654
655 * The protocol for talking to rmt has been extended slightly.
656   Open flags are now communicated in symbolic format as well as numeric.
657   The symbolic format (e.g., "O_WRONLY|O_CREAT|O_TRUNC") is for portability
658   when rmt is operating on a different operating system from tar.
659   The numeric format is retained, and rmt uses it if symbolic format is absent,
660   for backward compatibility with older versions of tar and rmt.
661
662 * When writing GNU tar format headers, tar now uses signed base-64
663   for values that cannot be represented in unsigned octal.
664   This supports larger files (2**66 - 1 bytes instead of 2**33 - 1 bytes),
665   larger uids, negative time stamps, etc.
666
667 * When extracting files with unknown ownership, tar now looks up the
668   uid and gid "nobody" on hosts whose headers do not define UID_NOBODY
669   and GID_NOBODY, and falls back on uid/gid -2 if there is no "nobody".
670
671 * tar -t --numeric-owner now prints numeric uids and gids, not symbolic.
672
673 * New option -y or --bzip2 for bzip2 compression, by popular request.
674
675 \f
676 version 1.13.5 - Paul Eggert, 1999-07-20.
677
678 * Do the delayed updates of file metadata even after a fatal error.
679
680 \f
681 version 1.13.4 - Paul Eggert, 1999-07-20.
682
683 * Do not chmod unless we are root or the -p option was given;
684   this matches historical practice.
685
686 \f
687 version 1.13.3 - Paul Eggert, 1999-07-16.
688
689 * A path name is excluded if any of its file name components matches an
690   excluded pattern, even if the path name was specified on the command line.
691   Also see 1.13.6 for later changes in this area.
692
693 \f
694 version 1.13.2 - Paul Eggert, 1999-07-14.
695
696 * Bug reporting address changed to <bug-tar@gnu.org>.
697
698 \f
699 version 1.13.1 - Paul Eggert, 1999-07-12.
700
701 * Bug fixes only.
702 \f
703 version 1.13 - Paul Eggert, 1999-07-08.
704
705 * Support for large files, e.g., files larger than 2 GB on many 32-bit hosts.
706   Also, support for larger uids, device ids, etc.
707 * Many bug fixes and porting fixes.
708 * This release is only for fixes.  A more ambitious test release,
709   with new features, is available as part of the paxutils.  Please see:
710     ftp://alpha.gnu.org/gnu/paxutils/
711   The fixes in this release are intended to be merged with paxutils
712   at some point, but they haven't been merged yet.
713 * An interim GNU tar alpha had new --bzip2 and --ending-file options,
714   but they have been removed to maintain compatibility with paxutils.
715   Please try --use=bzip2 instead of --bzip2.
716 \f
717 Version 1.12 - François Pinard, 1997-04.
718
719 Sensitive matters
720 * Use shell globbing patterns for --label, instead of regular expressions.
721 * Do not quote anymore internally over the quoting done by the shell.
722
723 Output for humans
724 * Offer internationalization capabilities of most recent GNU gettext.
725 * Messages available in many more languages, thanks to all translators!
726 * Usage of ISO 8601 dates in listings, instead of local American dates.
727 * More normalization and cleanup in error messages.
728
729 Creation
730 * For helping using tar with find, offer a --no-recursion option.
731 * Implement --numeric-owner for ignoring symbolic names at create time.
732 * New --owner, --group --mode options, still preliminary.
733 * Recognize creating an archive on /dev/null, so Amanda works faster.
734 * Object to the creation of an empty archive (like in `tar cf FILE').
735 * Barely start implementing --posix and POSIXLY_CORRECT.
736
737 Extraction
738 * Make a better job at restoring file and directory attributes.
739 * Automatically attempt deleting existing files when in the way.
740 * Option --unlink-first (-U) removes most files prior to extraction.
741 * Option --recursive-unlink removes non-empty directories when in the way.
742 * Option --numeric-owner ignores owner/group names, it uses UID/GID instead.
743 * Use global umask when creating missing intermediate directories.
744 * When symlinks are not available, extract symbolic links as hard links.
745 * Diagnose extraction of contiguous files as regular files.
746 * New --backup, --suffix and --version-control options.
747
748 Various changes
749 * Better support of huge archives with --tape-length and --totals.
750 * Rename option --read-full-blocks (-B) to --read-full-records (-B).
751 * Rename option --block-size (-b) to --blocking-factor (-b).
752 * Rename option --record-number (-R) to --block-number (-R).
753 * With --block-number (-R), report null blocks and end of file.
754 * Implement --record-size for introducing a size in bytes.
755 * Delete --block-compress option and rather decide it automatically.
756 * Rename option --modification-time to --touch.
757
758 Many bugs are squashed, while others still run free.
759 \f
760 Version 1.11.8 - François Pinard, 1995-06.
761
762 * Messages available in French, German, Portuguese and Swedish.
763 * The distribution provides a rudimentary Texinfo manual.
764 * The device defaults to stdin/stdout, unless overridden by the installer.
765 * Option --sparse (-S) should work on more systems.
766 * Option --rsh-command may select an alternative remote shell program.
767
768 Most changes are internal, and should yield better portability.
769 \f
770 Version 1.11.2 - Michael Bushnell, 1993-03.
771
772 * Changes in backup scripts: cleaned up considerably; notices error
773 conditions better over rsh; DUMP_REMIND_SCRIPT is now an option in
774 backup-specs; new file dump-remind is an example of a
775 DUMP_REMIND_SCRIPT.
776
777 * Superfluous "Reading dirname" was a bug; fixed.
778
779 * Incompatibility problems with a bug on Solaris are fixed.
780
781 * New option --gzip (aliases are --ungzip and -z); calls gzip instead
782 of compress.  Also, --use-compress-program lets you specify any
783 compress program.  --compress-block is renamed --block-compress and
784 now requires one of the three compression options to be specified.
785
786 * Several error messages are cleaned up.
787
788 * Directory owners are now set properly when running as root.
789
790 * Provide DUMP_REMIND_SCRIPT in backup-specs as a possible option
791 for --info-script.
792
793 * Behave better with broken rmt servers.
794
795 * Dump scripts no longer use --atime-preserve; this causes a nasty probem.
796
797 * Several Makefile cleanups.
798 \f
799 Version 1.11.1 - Michael Bushnell, 1992-09.
800
801 * Many bug fixes.
802 \f
803 Version 1.11 - Michael Bushnell, 1992-09.
804 Version 1.10.16 - 1992-07.
805 Version 1.10.15 - 1992-06.
806 Version 1.10.14 - 1992-05.
807 Version 1.10.13 - 1992-01.
808
809 * Many bug fixes.
810
811 * Now uses GNU standard configure, generated by Autoconf.
812
813 * Long options now use `--'; use of `+' is deprecated and support
814 for it will eventually be removed.
815
816 * New option --null causes filenames read by -T to be
817 null-terminated, and causes -C to be ignored.
818
819 * New option --remove-files deletes files (but not directories)
820 after they are added to the archive.
821
822 * New option --ignore-failed-read prevents read-errors from affecting
823 the exit status.
824
825 * New option --checkpoint prints occasional messages as the tape
826 is being read or written.
827
828 * New option --show-omitted-dirs prints the names of directories
829 omitted from the archive.
830
831 * Some tape drives which use a non-standard method of indicating
832 end-of-tape now work correctly with multi-tape archives.
833
834 * --volno-file: Read the volume number used in prompting the user
835 (but not in recording volume ID's on the archive) from a file.
836
837 * When using --multi-volume, you can now give multiple -f arguments;
838 the various tape drives will get used in sequence and then wrap
839 around to the beginning.
840
841 * Remote archive names no longer have to be in /dev: any file with a
842 `:' is interpreted as remote.  If new option --force-local is given,
843 then even archive files with a `:' are considered local.
844
845 * New option --atime-preserve restores (if possible) atimes to
846 their original values after dumping the file.
847
848 * No longer does tar confusingly dump "." when you don't tell it
849 what to dump.
850
851 * When extracting directories, tar now correctly restores their
852 modification and access times.
853
854 * Longnames support is redone differently--long name info directly
855 precedes the long-named file or link in the archive, so you no
856 longer have to wait for the extract to hit the end of the tape for
857 long names to work.
858 \f
859 Version 1.10 - Michael Bushnell, 1991-07.
860
861 * Filename to -G is optional.  -C works right.  Names +newer and
862 +newer-mtime work right.
863
864 * -g is now +incremental, -G is now +listed-incremental.
865
866 * Sparse files now work correctly.
867
868 * +volume is now called +label.
869
870 * +exclude now takes a filename argument, and +exclude-from does
871 what +exclude used to do.
872
873 * Exit status is now correct.
874
875 * +totals keeps track of total I/O and prints it when tar exits.
876
877 * When using +label with +extract, the label is now a regexp.
878
879 * New option +tape-length (-L) does multi-volume handling like BSD
880 dump: you tell tar how big the tape is and it will prompt at that
881 point instead of waiting for a write error.
882
883 * New backup scripts level-0 and level-1 which might be useful
884 to people.  They use a file "backup-specs" for information, and
885 shouldn't need local modification.  These are what we use to do
886 all our backups at the FSF.
887 \f
888 Version 1.09 - Jay Fenlason, 1990-10.
889 Version 1.08 - Jay Fenlason, 1990-01.
890 Versions 1.07 back to 1.00 by Jay Fenlason.
891
892 * See ChangeLog for more details.
893
894 \f
895
896 Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2003,
897 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
898
899 This file is part of GNU tar.
900
901 GNU tar is free software; you can redistribute it and/or modify
902 it under the terms of the GNU General Public License as published by
903 the Free Software Foundation; either version 3, or (at your option)
904 any later version.
905
906 GNU tar is distributed in the hope that it will be useful,
907 but WITHOUT ANY WARRANTY; without even the implied warranty of
908 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
909 GNU General Public License for more details.
910
911 You should have received a copy of the GNU General Public License
912 along with tar; see the file COPYING.  If not, write to
913 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
914 Boston, MA 02110-1301, USA.
915 \f
916 Local variables:
917 mode: outline
918 paragraph-separate: "[  \f]*$"
919 eval: (add-hook 'write-file-hooks 'time-stamp)
920 time-stamp-start: "changes. "
921 time-stamp-format: "%:y-%02m-%02d"
922 time-stamp-end: "\n"
923 end: