pristine-gz

Langue: en

Version: 2008-12-16 (ubuntu - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

pristine-gz - regenerate pristine gz files

SYNOPSIS

pristine-gz [-vdk] gengz delta file

pristine-gz [-vdk] gendelta file.gz delta

DESCRIPTION

This is a complement to the pristine-tar(1) command. Normally you don't need to run it by hand, since pristine-tar calls it as necessary to handle .tar.gz files.

pristine-gz gendelta takes the specified gz file, and generates a small binary delta file that can later be used by pristine-gz gengz to recreate the original file.

pristine-gz gengz takes the specified delta file, and compresses the specified input file (which must be identical to the contents of the original gz file). The resulting gz file will be identical to the original gz file.

The approach used to regenerate the original gz file is to figure out how it was produced --- what compression level was used, whether it was built with gzip(1) or with bsd-gzip(1), whether the --rsyncable option was used, etc, and to reproduce this build environment when regenerating the gz. In a few cases post-build fixups are also done to ensure that the gz is identical to the original.

This approach will work in the vast majority of cases. If it doesn't work, no delta will be generated. One example of a case it cannot currently support is a gz file that has been produced by appending together multiple gz files.

If the delta filename is ``-'', pristine-gz reads or writes it to stdio.

OPTIONS

-v
--verbose
Verbose mode, show each command that is run.
-d
--debug
Debug mode.
-k
--keep
Don't clean up the temporary directory on exit.

AUTHOR

Joey Hess <joeyh@debian.org>, Faidon Liambotis <paravoid@debian.org> Josh Triplett <josh@joshtriplett.org>

Licensed under the GPL, version 2.