gzexe: fix count of lines to skip
[gzip.git] / NEWS
blob8a6b285aedad349681b8ab0ff284fd86a160f209
1 GNU gzip NEWS                                    -*- outline -*-
3 * Noteworthy changes in release ?.? (????-??-??) [?]
6 * Noteworthy changes in release 1.10 (2018-12-29) [stable]
8 ** Changes in behavior
10   Compressed gzip output no longer contains the current time as a
11   timestamp when the input is not a regular file.  Instead, the output
12   contains a null (zero) timestamp.  This makes gzip's behavior more
13   reproducible when used as part of a pipeline.  (As a reminder, even
14   regular files will use null timestamps after the year 2106, due to a
15   limitation in the gzip format.)
17 ** Bug fixes
19   A use of uninitialized memory on some malformed inputs has been fixed.
20   [bug present since the beginning]
22   A few theoretical race conditions in signal handers have been fixed.
23   These bugs most likely do not happen on practical platforms.
24   [bugs present since the beginning]
27 * Noteworthy changes in release 1.9 (2018-01-07) [stable]
29 ** Bug fixes
31   gzip -d -S SUFFIX file.SUFFIX would fail for any upper-case byte in SUFFIX.
32   E.g., before, this command would fail:
33     $ :|gzip > kT && gzip -d -S T kT
34     gzip: kT: unknown suffix -- ignored
35   [bug present since the beginning]
37   When decompressing data in 'pack' format, gzip no longer mishandles
38   leading zeros in the end-of-block code.  [bug introduced in gzip-1.6]
40   When converting from system-dependent time_t format to the 32-bit
41   unsigned MTIME format used in gzip files, if a timestamp does not
42   fit gzip now substitutes zero instead of the timestamp's low-order
43   32 bits, as per Internet RFC 1952.  When converting from MTIME to
44   time_t format, if a timestamp does not fit gzip now warns and
45   substitutes the nearest in-range value instead of crashing or
46   silently substituting an implementation-defined value (typically,
47   the timestamp's low-order bits).  This affects timestamps before
48   1970 and after 2106, and timestamps after 2038 on platforms with
49   32-bit signed time_t.  [bug present since the beginning]
51   Commands implemented via shell scripts are now more consistent about
52   failure status.  For example, 'gunzip --help >/dev/full' now
53   consistently exits with status 1 (error), instead of with status 2
54   (warning) on some platforms.  [bug present since the beginning]
56   Support for VMS and Amiga has been removed.  It was not working anyway,
57   and it reportedly caused file name glitches on MS-Windowsish platforms.
60 * Noteworthy changes in release 1.8 (2016-04-26) [stable]
62 ** Bug fixes
64   gzip -l no longer falsely reports a write error when writing to a pipe.
65   [bug introduced in gzip-1.7]
67   Port to Oracle Solaris Studio 12 on x86-64.
68   [bug present since at least gzip-1.2.4]
70   When configuring gzip, ./configure DEFS='...-DNO_ASM...' now
71   suppresses assembler again.  [bug introduced in gzip-1.3.5]
74 * Noteworthy changes in release 1.7 (2016-03-27) [stable]
76 ** Changes in behavior
78   The GZIP environment variable is now obsolescent; gzip now warns if
79   it is used, and rejects attempts to use dangerous options or operands.
80   You can use an alias or script instead.
82   Installed programs like 'zgrep' now use the PATH environment variable
83   as usual to find subsidiary programs like 'gzip' and 'grep'.
84   Previously they prepended the installation directory to the PATH,
85   which sometimes caused 'make check' to test the wrong gzip executable.
86   [bug introduced in gzip-1.3.13]
88 ** New features
90   gzip now accepts the --synchronous option, which causes it to use
91   fsync and similar primitives to transfer output data to the output
92   file's storage device when the file system supports this.  Although
93   this option makes gzip safer in the presence of system crashes, it
94   can make gzip considerably slower.
96   gzip now accepts the --rsyncable option. This option is accepted in
97   all modes, but has effect only when compressing: it makes the resulting
98   output more amenable to efficient use of rsync.  For example, when a
99   large input file gets a small change, a gzip --rsyncable image of
100   that file will remain largely unchanged, too.  Without --rsyncable,
101   even a tiny change in the input could result in a totally different
102   gzip-compressed output file.
104 ** Bug fixes
106   gzip -k -v no longer reports that files are replaced.
107   [bug present since the beginning]
109   zgrep -f A B C no longer reads A more than once if A is not a regular file.
110   This better supports invocations like 'zgrep -f <(COMMAND) B C' in Bash.
111   [bug introduced in gzip-1.2]
114 * Noteworthy changes in release 1.6 (2013-06-09) [stable]
116 ** New features
118   gzip now accepts the --keep (-k) option, for consistency with tools
119   like xz, lzip and bzip2.  With this option, gzip no longer removes
120   named input files when compressing or decompressing.
122 ** Bug fixes
124   gzip -d no longer malfunctions with certain invalid data in 'pack' format.
125   [bug introduced in gzip-0.8]
127   When overwriting, gzip no longer acts as if you typed "y" when you type "n",
128   on some platforms when compiled with optimization.
129   [bug introduced in gzip-1.3.6]
131   zgrep no longer malfunctions with a multi-digit context option like -15.
132   Now, it passes that option to grep (equivalent to -C15) just as it does
133   for single-digit options. [bug introduced in gzip-1.3.12]
135   zmore now acts more like 'more', and is more portable to POSIXish hosts.
138 * Noteworthy changes in release 1.5 (2012-06-17) [stable]
140 ** Bug fixes
142   gzip -d now decodes and checks header CRC16 checksums as specified by
143   the FHCRC section of Internet RFC 1952.
145   "gzip -d -S '' precious.gz" is now rejected immediately.  Before,
146   that command would emulate "rm -i precious.gz", but with an easily-
147   misunderstood prompt.  I.e., gzip would ask if it's ok to remove the
148   existing file, "precious.gz".  If you made the mistake of saying "yes",
149   it would remove that input file before attempting to uncompress it.
151   gzip -cdf now properly handles input consisting of gzip'd data followed
152   by uncompressed data.  Before it would output raw compressed input, too.
153   For example, now "(printf x|gzip; echo y)|gzip -dcf" prints "xy\n",
154   while before it would print "x<compressed data>y\n".
156   gzip -rf no longer compresses files more than once (e.g., replacing
157   FOO with FOO.gz.gz) on file systems such as ZFS where a readdir
158   loop that unlinks and creates files can revisit output files.
161 * Noteworthy changes in release 1.4 (2010-01-20) [stable]
163 ** Bug fixes
165   gzip -d could segfault and/or clobber the stack, possibly leading to
166   arbitrary code execution.  This affects x86_64 but not 32-bit systems.
167   This fixes CVE-2010-0001.
168   For more details, see https://bugzilla.redhat.com/554418
170   gzip -d would fail with a CRC error for some valid inputs.
171   So far, the only valid input known to exhibit this failure was
172   compressed "from FAT filesystem (MS-DOS, OS/2, NT)".  In addition,
173   to trigger the failure, your memcpy implementation must copy in
174   the "reverse" order.
177 * Noteworthy changes in release 1.3.14 (2009-10-30) [beta]
179 ** Bug fixes
181   gzip no longer fails when there is exactly one trailing NUL byte
182   gzip has always accepted trailing NUL bytes.  Note the plural.
184   zdiff would exit with status 2 (indicating an error) rather than 1 to
185   indicate differences when both inputs were compressed and different.
187   zdiff would fail to print differences in two compressed inputs
189   zgrep -f - didn't work
192 * Noteworthy changes in release 1.3.13 (2009-09-30) [stable]
194 ** 'gzip -f foo.gz' now creates a file foo.gz.gz instead of complaining.
196 ** Bug fixes
198   gzip -d no longer fails with "-" as 2nd or subsequent argument
200   gzip no longer ignores a close-induced write failure, e.g., on NFS
202   gzip -d no longer segfaults on certain invalid inputs
205 Major changes in Gzip 1.3.12 (2007-04-13)
207 * znew now uses $TMPDIR (default /tmp) instead of always using /tmp.
209 * It is now documented that gzip ignores case when examining file name
210   extensions; for example, 'gzip test.Gz' (without -f) fails because
211   the file name ends in '.Gz'.
213 Major changes in Gzip 1.3.11 (2007-02-05)
215 * As per the GNU coding standards, the behavior of gzip and its
216   companion executables no longer depend on the name used to invoke them.
217   For example, 'gzip' and 'gunzip' are no longer hard links;
218   instead, 'gunzip' is now a small program that invokes 'gzip -d'.
220 * zdiff now checks for subsidiary gzip failures, and works around
221   bugs in IRIX 6 sh, Tru64 4.0F ksh, and Solaris 8 bash.
223 Major changes in Gzip 1.3.10 (2006-12-30)
225 * gzip -c and zcat now work on special files, files with special mode bits,
226   and files with multiple hard links.
227 * gzip -q now exits with status 2 (not 1) when SIGPIPE is received.
228 * zcmp and zdiff did not work in the usual case, due to a typo.
229 * zgrep has many bugs fixed with argument handling, special characters,
230   and exit status.
231 * zless no longer mishandles $%=~ in file names.
233 Gzip 1.3.9 (2006-12-15)
235 * No major changes; only porting fixes.
237 Major changes in Gzip 1.3.8 (2006-12-08)
239 * Fix some gzip problems:
240   - A security fix from Debian 1.3.5-5 was inadvertently omitted.
241   - The assembler is now invoked with --noexecstack if supported,
242     so that gzip can better resist stack-smashing attacks.
244 Major changes in Gzip 1.3.7 (2006-12-06)
246 * Fix some gzip problems:
247   - Refuse to compress setuid or setgid files, or files with the sticky bit.
248   - Fix more race conditions in setting file permissions and owner,
249     removing output files, following symbolic links, and dealing with
250     special files.
251   - Remove most of the code working around ENAMETOOLONG deficiencies.
252     Systems with those deficiencies are long-dead, and the workarounds
253     had race conditions on modern hosts.
254   - Catch CPU time and file size limit signals, too.
255   - Check for read errors when closing files.
256   - Fix a core dump caused by a stray abort mistakenly introduced in 1.3.6.
257 * Fix some gzexe problems:
258   - Improve resistance to denial-of-service attacks.
259   - Fix some quoting and escaping bugs.
260   - Do not assume /tmp is sticky (though it should be!).
261   - Do not assume the working directory can be written.
262   - Rely on PATH in the generated executable, as the man page says.
263   - Don't assume IFS is sane.
264   - Exit with signal's status, if signaled.
266 Major changes in Gzip 1.3.6 (2006-11-20)
268 * Fix some race conditions in setting file timestamps, permissions, and owner.
269 * Fix some race conditions in signal handling.
270 * When gzip exits due to a signal, it exits with the signal's status, not 1.
271 * gzip now restores file timestamps to the resolution supported by the
272   time-setting primitives of the operating system, typically 1 microsecond.
273   Formerly it restored them only to the nearest second.
274 * gzip -r no longer attempts to reset the last-access times of directories
275   it reads, as this messes up when other processes are reading the directories.
276 * The options --version and --help now work on all gzip-installed executables,
277   and now use a format similar to other GNU programs.
278 * The manual is now distributed under the terms of the GNU Free
279   Documentation License without invariant sections or cover texts.
280 * Port to current versions of Autoconf, Automake, and Gnulib.
282 Major changes from 1.3.4 to 1.3.5
283 * gzip now removes any output symlink before writing output file.
284 * zgrep etc. scripts now port to POSIX 1003.1-2001 hosts.
285 * zforce no longer assumes 14-byte file name length limit.
286 * zless is now implemented using less and LESSOPEN, not zmore and PAGER.
287 * assembly-language speedups reenabled; were mistakenly disabled in 1.3.
289 Major changes from 1.3.3 to 1.3.4
290 * Less output is lost when decompressing a truncated file.
291 * The manual is now distributed under the terms of the GNU Free
292   Documentation License.
294 No major changes in 1.3.2 or 1.3.3 (bug fixes only)
296 Major changes from 1.3 to 1.3.1
297 * zgrep now supports --, -H, -h, -L, -l, -C, -d, -m and their long equivalents.
299 Major changes from 1.2.4 to 1.3
300 * Add support for large files, e.g. files larger than 2 GB on Solaris 2.6.
301 * Adjust file size listing format for files larger than 10 GB.
302 * New command `zless'.
303 * `zdiff' now reports exit status like `diff' does.
304 * `zcat' is now always called `zcat', not `gzcat'.
305   Similarly for `zdiff', `zgrep', `zmore', `znew', `zforce'.
306 * Warn about a compressed file's trailing zeros only if verbose,
307   for compatibility with recent versions of GNU tar.
308 * Conform to changes to GNU makefile standards.
309 * Port to Autoconf 2.13.
310 * Convert to Automake.
311 * Fix bugs in the following areas:
312   - files larger than 4 GB
313   - security hole involving symlinks from /tmp
314   - security hole involving long file names
315   - permissions bug when compressing a symbolic link to a file
316   - core dumps
317   - concatenated compressed files on INBUFSIZ boundaries
318   - porting bugs on hosts with signed chars
319   - porting bug with upper and lower case
320   - porting bug for hosts that reserve the names `basename' or `warning'
322 Major changes from 1.2.3 to 1.2.4
323 * By default, do not restore file name and timestamp from those saved
324   inside the .gz file (behave as 'compress'). Added the --name option
325   to force name and timestamp restoration.
326 * Accept - as synonym for stdin.
327 * Use manlinks=so or ln to support either hard links or .so in man pages
328 * Accept foo.gz~ in zdiff.
329 * Added support for Windows NT
330 * Handle ENAMETOOLONG for strict Posix systems
331 * Use --recursive instead of --recurse to comply with Webster and
332   the GNU stdandard.
333 * Allow installation of shell scripts with a g prefix: make G=g install
334 * Install by default zcat as gzcat if gzcat already exists in path.
335 * Let zmore behave as more when invoked without parameters (give help)
336 * Let gzip --list reject files not in gzip format even with --force.
337 * Don't complain about non gzip files for options -rt or -rl.
338 * Added advice in INSTALL for several systems.
340 Major changes from 1.2.2 to 1.2.3
341 * Don't display the output name when decompressing except with --verbose.
342 * Remove usage of alloca in getopt.c and all makefiles.
343 * Added the zfile shell script in subdirectory sample.
344 * Moved the list of compiler bugs from README to INSTALL.
345 * Added vms/Readme.vms.
347 Major changes from 1.2.1 to 1.2.2
348 * Fix a compilation error on Sun with cc (worked with gcc).
350 Major changes from 1.2 to 1.2.1
351 * Let zmore act as more if the data is not gzipped.
352 * made gzexe more secure (don't rely on PATH).
353 * By default, display output name only when the name was actually truncated.
355 Major changes from 1.1.2 to 1.2
356 * Added the --list option to display the file characteristics.
357 * Added the --no-name option: do not save or restore original filename
358   Save the original name by default.
359 * Allow gunzip --suffix "" to attempt decompression on any file
360   regardless of its extension if an original name is present.
361 * Add support for the SCO compress -H format.
362 * gzip --fast now compresses faster (speed close to that of compress)
363   with degraded compression ratio (but still better than compress).
364   Default level changed to -6 (acts exactly as previous level -5) to
365   be a better indication of its placement in the speed/ratio range.
366 * Use smart name truncation: 123456789012.c -> 123456789.c.gz
367    instead of 12345678901.gz
368 * With --force, let zcat pass non gzip'ed data unchanged (zcat == cat)
369 * Added the zgrep shell script.
370 * Made sub.c useful for 16 bit sound, 24 bit images, etc..
371 * Suppress warnings about suffix for gunzip -r, except with --verbose.
372 * On MSDOS, use .gz extension when possible (files without extension)
373 * Moved the sample programs to a subdirectory sample.
374 * Added a "Special targets" section in INSTALL.
376 Major changes from 1.1.1 to 1.1.2.
377 * Fix serious bug for VMS (-gz not removed when decompressing).
378 * Allow suffix other than .gz in znew.
379 * Do not display compression ratio when decompressing stdin.
380 * In zmore.in, work around brain damaged stty -g (Ultrix).
381 * Display a correct compression ratio for .Z files.
382 * Added .z to .gz renaming script in INTALL.
383 * Allow setting CFLAGS in configure.
385 Major changes from 1.1 to 1.1.1.
386 * Fix serious bug in vms.c (affects Vax/VMS only).
387 * Added --ascii option.
388 * Add workaround in configure.in for Ultrix (quote eval argument)
390 Major changes from 1.0.7 to 1.1.
391 * Use .gz suffix by default, add --suffix option.
392 * Let gunzip accept a "_z" suffix (used by one 'compress' on Vax/VMS).
393 * Quit when reading garbage from stdin instead of reporting an error.
394 * Added makefile for VAX/MMS and support for wildcards on VMS.
395 * Added support for MSC under OS/2.
396 * Added support for Prime/PRIMOS.
397 * Display compression ratio also when decompressing (with --verbose).
398 * Quit after --version (GNU standard)
399 * Use --force to bypass isatty() check
400 * Continue processing other files in case of recoverable error.
401 * Added comparison of zip and gzip in the readme file.
402 * Added small sample programs (ztouch, sub, add)
403 * Use less memory when compiled with -DSMALL_MEM (for MSDOS).
404 * Remove the "off by more than one minute" timestamp kludge
406 Major changes from 1.0.6 to 1.0.7.
407 * Allow zmore to read from standard input (like more).
408 * Support the 68000 (Atari ST) in match.S.
409 * Retry partial writes (required on Linux when gzip is suspended in a pipe).
410 * Allow full pathnames and renamings in gzexe.
411 * Don't let gzexe compress setuid executables or gzip itself.
412 * Added vms/Makefile.gcc for gcc on the Vax.
413 * Allow installation of binaries and shell scripts in different dirs.
414 * Allows complex PAGER variable in zmore (e.g.: PAGER="col -x | more")
415 * Allow installation of zcat as gzcat.
416 * Several small changes for portability to old or weird systems.
417 * Suppress help message and send compressed data to the terminal when
418   gzip is invoked without parameters and without redirection.
419 *  Add compile option GNU_STANDARD to respect the GNU coding standards:
420    with -DGNU_STANDARD, behave as gzip even if invoked under the name gunzip.
421 (I don't like the last two changes, which were requested by the FSF.)
423 Major changes from 1.0.5 to 1.0.6.
424 * Let gzexe detect executables that are already gzexe'd.
425 * Keep file attributes in znew and gzexe if cpmod is available.
426 * Don't try restoring record format on VMS (1.0.5 did not work correctly)
427 * Added asm version for 68000 in amiga/match.a.
428   Use asm version for Atari TT and NeXT.
429 * For OS/2, assume HPFS by default, add flag OS2FAT if necessary.
430 * Fixed some bugs in zdiff and define zcmp as a link to zdiff.
433 Major changes from 1.0.4 to 1.0.5.
434 * For VMS, restore the file type for variable record format, otherwise
435     extract in fixed length format (not perfect, but better than
436     forcing all files to be in stream_LF format).
437 * For VMS, use "-z" default suffix and accept a version number in file names.
438 * For Unix, allow compression of files with name ending in 'z'. Use only
439   .z, .*-z, .tgz, .taz as valid gzip extensions. In the last two cases,
440   extract to .tar by default.
441 * On some versions of MSDOS, files with a 3 character extension could not
442   be compressed.
443 * Garbage collect files in /tmp created by gzexe.
444 * Fix the 'OS code' byte in the gzip header.
445 * For the Amiga, add the missing utime.h and add support for gcc.
448 Major changes from 1.0.3 to 1.0.4.
449 * Added optimized asm version for 68020.
450 * Add support for DJGPP.
452 * Add support for the Atari ST.
453 * Added zforce to rename gzip'ed files with truncated names.
454 * Do not install with name uncompress (some systems rely on the
455   absence of any check in the old uncompress).
456 * Added missing function (fcfree) in msdos/tailor.c
457 * Let gunzip handle .tgz files, and let gzip skip them.
458 * Added -d option (decompress) for gzexe and try preserving file permissions.
459 * Suppress all warnings with -q.
460 * Use GZIP_OPT for VMS to avoid conflict with program name.
461 * ... and many other small changes (see ChangeLog)
464 Major changes from 1.0.2 to 1.0.3
465 * Added -K option for znew to keep old .Z files if smaller
466 * Added -q option (quiet) to cancel -v in GZIP env variable.
467 * Made gzexe safer on systems with filename limitation to 14 chars.
468 * Fixed bugs in handling of GZIP env variable and incorrect free with Turbo C.
471 Major changes from 1.0.1 to 1.0.2
472 * Added env variable GZIP for default options. Example:
473    for sh:   GZIP="-8 -v"; export GZIP
474    for csh:  setenv GZIP "-8 -v"
475 * Added support for the Amiga.
476 * znew now keeps the old .Z if it is smaller than the .z file.
477   This can happen for some large and very redundant files.
478 * Do not complain about trailing garbage for record oriented IO (Vax/VMS).
479   This implies however that multi-part gzip files are not supported
480   on such systems.
481 * Added gzexe to compress rarely used executables.
482 * Reduce memory usage (required for MSDOS and useful on all systems).
483 * Preserve timestamp in znew -P (pipe option) if touch -r works.
486 Major changes from 1.0 to 1.0.1
487 * fix trivial errors in the Borland makefile (msdos/Makefile.bor)
490 Major changes from 0.8.2 to 1.0
491 * gzip now runs on Vax/VMS
492 * gzip will not not overwrite files without -f when using /bin/sh in
493   background.
494 * Support the test option -t for compressed (.Z) files.
495   Allow some data recovery for bad .Z files.
496 * Added makefiles for MSDOS (Only tested for MSC, not Borland).
497 * still more changes to configure for several systems
500 Major changes from 0.8.1 to 0.8.2:
501 * yet more changes to configure for Linux and other systems
502 * Allow zcat on a file with multiple links.
505 Major changes from 0.8 to 0.8.1:
506 * znew has now a pipe option -P to reduce the disk space requirements,
507   but this option does not preserve timestamps.
508 * Fixed some #if directives for compilation with TurboC.
511 Major changes from 0.7 to 0.8:
512 * gzip can now extract .z files created by 'pack'.
513 * configure should no longer believe that every machine is a 386
514 * Fix the entry for /etc/magic in INSTALL.
515 * Add patch for GNU tar 1.11.1 and a pointer to crypt++.el
516 * Uncompress files with multiple links only with -f.
517 * Fix for uncompress of .Z files on 16-bit machines
518 * Create a correct output name for file names of exactly N-1 chars when
519   the system has a limit of N chars.
522 Major changes from 0.6 to 0.7:
523 * Use "make check" instead of "make test".
524 * Keep timestamp and pass options to gzip in znew.
525 * Do not create .z.z files with gzip -r.
526 * Allow again gunzip .zip files (was working in 0.5)
527 * Allow again compilation with TurboC 2.0 (was working in 0.4)
530 Major changes form 0.5 to 0.6:
531 * gunzip reported an error when extracting certain .z files. The .z files
532   produced by gzip 0.5 are correct and can be read by gunzip 0.6.
533 * gunzip now supports multiple compressed members within a single .z file.
534 * Fix the check for i386 in configure.
535 * Added "make test" to check for compiler bugs. (gcc -finline-functions
536   is broken at least on the NeXT.)
537 * Use environment variable PAGER in zmore if it is defined.
538 * Accept gzcat in addition to zcat for people having /usr/bin before
539   /usr/local/bin in their path.
542 ========================================================================
544 Copyright (C) 1999, 2001-2002, 2006-2007, 2009-2019 Free Software Foundation,
545 Inc.
546 Copyright (C) 1992, 1993 Jean-loup Gailly
548 Permission is granted to copy, distribute and/or modify this document
549 under the terms of the GNU Free Documentation License, Version 1.3 or
550 any later version published by the Free Software Foundation; with no
551 Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
552 Texts.  A copy of the license is included in the ``GNU Free
553 Documentation License'' file as part of this distribution.