File: xdelta3.1

package info (click to toggle)
xdelta3 3.0.8-dfsg-1
  • links: PTS
  • area: main
  • in suites: jessie-kfreebsd
  • size: 3,364 kB
  • sloc: ansic: 14,645; sh: 11,168; cpp: 2,285; python: 885; objc: 224; makefile: 122
file content (153 lines) | stat: -rw-r--r-- 2,516 bytes parent folder | download | duplicates (3)
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
145
146
147
148
149
150
151
152
153
.TH XDELTA3 "1" "August 2009" "Xdelta3"
.SH NAME
xdelta3 \- VCDIFF (RFC 3284) binary diff tool
.SH SYNOPSIS
.B xdelta3 
.RI [ command ]
.RI [ options ] 
.RI [ input 
.RI [ output ]]
.SH DESCRIPTION
.B xdelta3
is a binary diff tool that uses the VCDIFF (RFC 3284) format and compression.
.SH COMMANDS
.TP
.BI config
prints xdelta3 configuration
.TP
.BI decode
decompress the input, also set by -d
.TP
.BI encode
compress the input, also set by -e (default)
.TP
.BI test
run the builtin tests
.TP
.BI printdelta
print information about the entire delta
.TP
.BI printhdr
print information about the first window
.TP
.BI printhdrs
print information about all windows
.TP
.BI recode
encode with new application/secondary settings

.SH OPTIONS
standard options:
.TP
.BI "\-0 .. \-9"
compression level
.TP
.BI "\-c"
use stdout
.TP
.BI "\-d"
decompress
.TP
.BI \-e
compress
.TP
.BI \-f
force overwrite
.TP
.BI \-h
show help
.TP
.BI \-q
be quiet
.TP
.BI \-v
be verbose (max 2)
.TP
.BI \-V
show version

.TP
memory options:
.TP
.BI \-B 
.RI bytes
source window size
.TP
.BI \-W 
.RI bytes
input window size
.TP
.BI \-P 
.RI size
compression duplicates window
.TP
.BI \-I 
.RI size
instruction buffer size (0 = unlimited)

.TP
compression options:
.TP
.BI \-s
.RI source
source file to copy from (if any)
.TP
.BI "\-S " [djw|fgk|lzma|none]
enable/disable secondary compression
.TP
.BI \-N
disable small string-matching compression
.TP
.BI \-D
disable external decompression (encode/decode)
.TP
.BI \-R
disable external recompression (decode)
.TP
.BI \-n
disable checksum (encode/decode)
.TP
.BI \-C 
soft config (encode, undocumented)
.TP
.BI "\-A " [apphead]
disable/provide application header (encode)
.TP
.BI \-J
disable output (check/compute only)
.TP
.BI \-T
use alternate code table (test)

.SH NOTES
The 
.B XDELTA
environment variable may contain extra args:

.RS
XDELTA="-s source-x.y.tar.gz" \\
.br
tar --use-compress-program=xdelta3 -cf \\
.br
target-x.z.tar.gz.vcdiff target-x.y/

.SH EXAMPLES

Compress the differences between SOURCE and TARGET, yielding OUT, 
using "djw" secondary compression:

xdelta3 -S djw -s SOURCE TARGET OUT

Do the same, using standard input and output:

xdelta3 -S djw -s SOURCE < TARGET > OUT

To decompress OUT, using SOURCE, yielding TARGET:

xdelta3 -d -s SOURCE OUT TARGET

.SH AUTHOR
xdelta3 was written by Josh MacDonald <josh.macdonald@gmail.com>.
.PP
This manual page was written by Leo 'costela' Antunes <costela@debian.org>
for the Debian project (but may be used by others).