X-Git-Url: https://git.distorted.org.uk/~mdw/rsync-backup/blobdiff_plain/915b95f48e8754956e3ac6c1f27b91beafc619e8..HEAD:/fshash.1 diff --git a/fshash.1 b/fshash.1 index 51580b8..8577d65 100644 --- a/fshash.1 +++ b/fshash.1 @@ -12,10 +12,20 @@ .IR cache ] .RB [ \-f .IR format ] +.RB [ \-C +.IR version ] .RB [ \-H .IR hash ] .RI [ file \&...] +.br +.B fshash +.RB \-u +.B \-c +.I cache +.RB [ \-H +.IR hash ] +.RI [ dir ] .SH DESCRIPTION The .B fshash @@ -87,6 +97,20 @@ format doesn't work well: see .B BUGS below.) .TP +.B \-C, \-\-compat=\fIversion +Produce a manifest with the given compatibility +.IR version . +Alas, +.B fshash +has bugs in the way it produces manifests. Fixing the bugs makes the +output better, but now it can't be compared with old manifests which +were made with the bugs. By default, +.B fshash +produces manifests in the most recent format, but this option will force +it to be compatible with old versions. The original version was 1; all +later versions print a comment reporting the version number at the start +of the manifest. The current version is 2. +.TP .B \-H, \-\-hash=\fIhash Use the .I hash @@ -94,6 +118,14 @@ function, which can be any hash function supported by Python's .BR hashlib . This option may be omitted: if it is, then the hash is read from the cache file; if there is no cache file either, then an error is reported. +.TP +.B \-u, \-\-udiff +Rather than produce a manifest, read a unified +.BR diff (1) +from standard input, and clear from the cache all files mentioned as +being different. Filenames in the diff are considered relative to +.I dir , +defaulting to the current working directory. .PP Positional arguments are interpreted as files and directories to be processed, in order. A directory name which ends in @@ -110,7 +142,6 @@ hexadecimal. For other kinds of filesystem object, a description of the object type and any special information about it, in square brackets, and padded with spaces so as to take the same width as a hash; see below for details. -as follows. .hP 2. A `virtual inode identifier': a string which will be the same in two lines if and only if they represent hard links to the same underlying