vcdiff [-m] [-e] [-d] [-G] [-w] [-t] [source [target]] [< target] > delta
vcundiff [source [target]] [> target] < delta
vchuff [-r] [-f] [-w] [-t] [input [output]] [< input] [> output]
vcunhuff [input [output]] [< input] [> output]
vcmap [map] < input > output
vcdiff is a delta compressor, i.e., it can compress a
target file
given a
source file or it can just compress a target file by itself.
Source and target files can be given as a pair of arguments
or the source can be given as a single argument
and the target given as the standard input.
The symbol
- means
none for the source file and
standard input
for the target file. For example, below are valid invocations of
vcdiff:
vcdiff source < target > delta
vcdiff source - < target > delta
vcdiff source target > delta
vcdiff - target > delta
vcdiff < target > delta
Large target data may be partitioned into windows
suitable for in-core processing. These windows are matched against
source windows that may come from the source file or some earlier
part of the target file. By default, vcdiff uses a fast search
algorithms based on matching n-gram frequencies
Below are arguments for vcdiff:
- -m:
-
This option causes vcdiff to just mirror file offsets between matching
source and target windows.
-e\P:
This option causes vcdiff to perform an exhaustive search based on
n-gram frequencies to find a matching source window to a target window.
This search nearly always finds an optimally matching window but it is
slow, hence the name.
See the description of the windowing method Sfwslow
in vcodex(3) for details.
- -d:
-
This option causes vcdiff to compute only the differences
between source and target data. That is, it will not attempt
to compress target data using data from the target windows themselves.
- -G\P:
This option causes vcdiff
to compute a delta encoded with the GDIFF format
(http://www.w3.org/TR/NOTE-gdiff-19970901.html).
- -w:
-
This option sets the window size, i.e., amount of data to be processed
at one time.
- -t\P:
This option causes ]fBvcdiff to generate a trace of source and target
windows and results of their compression.
vcundiff decodes data produced by
vcdiff.
Thus, if the data was a result of compressing a target file
against a source file, then the source file must be given
in order to decode correctly.
Source and target files are given in a manner similar to that of
vcdiff
except that the target file is now an output file instead of an input file.
In addition, since the shell typically opens a standard output file only for
writing, if the compressed data was created
with
-g or
-s options in
vcdiff, the target file
should be given as an argument so that
vcunhuff can open it
for both reading and writing.
vchuff and
vcunhuff provide a pair of Huffman compressor
and decompressor.
- -r:
-
This causes vchuff to use
a recursive partitioning algorithm to compute areas with different statistical
models and compress them separately to improve compression.
- -f:
-
This causes vchuff to use
a first-fit partitioning algorithm to compute areas with different statistical
models and compress them separately to improve compression.
- -w:
-
This option sets the window size, i.e., amount of data to be processed
at one time.
- -t:
-
This causes vchuff to generate a trace of parts that are
compressed separately.
vcmap maps the bytes of the
input file
using the given
map and writes the result to
output.
If
map is not given,
vcmap use the
rot13 mapping.
A
map is a string with an even number of characters.
Each pair of letters specifies that the left character is mapped
to the right character. For example, the below call will map
all lower case 'a' to upper case 'A':
vcmap "aA" < input > output