File: xdelta.1

package info (click to toggle)
xdelta 1.0.0-1
  • links: PTS
  • area: main
  • in suites: slink
  • size: 876 kB
  • ctags: 696
  • sloc: ansic: 5,154; sh: 4,717; lisp: 777; makefile: 64
file content (144 lines) | stat: -rw-r--r-- 2,861 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
.ds p \&\s-1XDelta\s0
.if n .ds - \%--
.if t .ds - \(em
.if !\n(.g \{\
.	if !\w|\*(lq| \{\
.		ds lq ``
.		if \w'\(lq' .ds lq "\(lq
.	\}
.	if !\w|\*(rq| \{\
.		ds rq ''
.		if \w'\(rq' .ds rq "\(rq
.	\}
.\}
.de PE
.sp \\n()Pu
.ne 2
.nf
.IP
..
.de EP
.fi
.PP
.sp \\n()Pu
..
.TH XDelta 1
.SH NAME
xdelta \- Invoke XDelta
.SH SYNOPSIS
.B xdelta
.I subcommand
[
.IR option ".\|.\|.
] [
.IR operand .\|.\|.
]
.SH DESCRIPTION
XDelta provides the ability to generate deltas between a pair of files
and later apply those deltas.  It operates similar to the
.B diff
and
.B patch
commands, but works on binary files and does not produce a human
readable output.
.PP
XDelta has two subcommands, delta and patch.  Delta accepts two files
and produces a delta, while patch accepts one original file and a
delta and produces the other file.  As opposed to the the diff(1)
format, which can usually be reversed, these deltas are one way.

.SS Subcommands
Each subcommand will be detailed seperately.  In general, any input
file may be compressed with
.IR gzip (1)
and XDelta will automatically uncompress it into a temporary location
before examining the file.  This temporary location is either the
value of the
.ir TMPDIR
environment variable, if set, or "/tmp".
Unless turned off, XDelta always verifies the integrity of
reconstructed files with MD5 checksums.  By default, XDelta compresses
constructed deltas, but this feature may be turned off.

.SS Delta
The delta subcommand has the following synopsis:

.B xdelta
.I delta
[
.IR option ".\|.\|.
]
.IR from
.IR to
[
.IR patch
]

Computes a delta from
.IR from
to
.IR to
and writes it to
.IR patch
or the standard output if
.IR patch
is omitted or is named "-".

.SS Patch
The patch subcommand has the following synopsis:

.B xdelta
.I patch
[
.IR option ".\|.\|.
]
.IR patch
[
.IR from
[
.IR to
]]

Applies
.IR patch
to
.IR from.
If from was omitted, XDelta attempts to use the file with the original
from file name.
The from file must be identical to the one used to create the delta.
Its MD5 checksum is used to verify this condition.  The constructed
file will be written to
.IR to
unless to is named "-" or the original to file name if
.IR to
is omitted.

.SS Options

.IP -0..9
Set the zlib compression level.  Zero indicates no compression.  Nine
indicates maximum compression.

.IP -h
Print a short help message and exit.

.IP -v
Print the XDelta version number and exit.

.IP -V
Verbose.  Prints a bit of extra information.

.IP -n
No verify.  Turns off MD5 checksum verification of the input and
output files.

.IP -m=size
Set an upper bound on the size of an in-memory page cache.

.SH IDENTIFICATION
Author: Josh MacDonald
.br
.\" $Format: "Manual Page Revision: $Revision$; Release Date: $ProjectDate$."$
Manual Page Revision: 1.2; Release Date: Sun, 04 Oct 1998 23:20:58 -0700.
.br
Copyright \(co 1997, 1998