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
|
.TH RDIFFDIR 1 "$reldate" "Version $version" "User Manuals" \" -*- nroff -*-
.SH NAME
rdiffdir \- compute and apply signatures and diffs to directories
.SH SYNOPSIS
.B rdiffdir
.BI [ options ]
.B sig[nature]
.I basis_dir signature_file
.B rdiffdir
.BI [ options ]
.B delta
.I full_sigtar
.BI { incr_sigtar }
.I new_dir delta_file
.B rdiffdir
.BI [ options ]
.B patch
.I basis_dir delta_file
.B rdiffdir
.BI [ options ]
.B tar
.I basis_dir tar_file
If
.I signature_file
or
.I delta_file
are "-", the data will be read from stdin or written to stdout as appropriate.
.SH DESCRIPTION
.B rdiffdir
is supposed to be like rdiff, but can operate on directories. See
.BR rdiff (1)
for more information. The syntax is similar.
Regarding the
.B delta
command, the
.I full_sigtar
operand is a
.I signature_file
written by an earlier
.B signature
or
.B tar
command (the latter using the
.B --write-sig-to
option). The optional
.I incr_sigtar
operands are signature files written by earlier
.B delta
commands using the
.I --write-sig-to
option. This way the Nth invocation of the
.B delta
command can parse (and extend) the signature chain that has been founded by the
first
.B signature
or
.B tar
command with a full signature, and then extended by the subsequent N-1
.B delta
invocations with incremental signatures. It is the responsibility of the user
to specify the sigtar operands in logical increment order.
.SH OPTIONS
.TP
.BI "--write-sig-to " sigfile
This option is only used in
.B delta
and
.B tar
modes. When specified, rdiffdir will write a signature of the
directory it is processing to sigfile. The end result will be a delta
and a new signature calculated over the
.B same
data.
.TP
.B -z, --gzip-compress
Enable gzip compression and decompression of signature and delta
files.
.SH SELECTION OPTIONS
In
.B signature
and
.B delta
modes, rdiffdir accepts
.BR duplicity -like
selection options including --exclude, --exclude-filelist-stdin, etc.
See the
.BR duplicity (1)
manual page for more information.
.SH BUGS
Hard links are currently unsupported (they will be treated as
non-linked regular files).
Bad signatures will be treated as empty instead of logging appropriate
error message.
.SH AUTHOR
Ben Escoto <bescoto@stanford.edu>
.SH SEE ALSO
.BR duplicity (1),
.BR python (1),
.BR rdiff (1),
.BR rdiff-backup (1).
|