X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=Documentation%2Fbup-bloom.md;h=9efea60b87b1485ed26553b35c54d29b252f7950;hb=b8c7652b9a64a178a913a5c66a9e2cab1ab4fcc4;hp=4b947776f5d46978423e9d7591dffccac409528d;hpb=249326eb94c4f78c4114cb29272ef700d8dcfbd0;p=bup.git

diff --git a/Documentation/bup-bloom.md b/Documentation/bup-bloom.md
index 4b94777..9efea60 100644
--- a/Documentation/bup-bloom.md
+++ b/Documentation/bup-bloom.md
@@ -8,23 +8,46 @@ bup-bloom - generates, regenerates, updates bloom filters
 
 # SYNOPSIS
 
-bup daemon [-d dir] [-o outfile]
+bup bloom [-d dir] [-o outfile] [-k hashes] [-c idxfile] [-f] [\--ruin]
 
 # DESCRIPTION
 
-`bup bloom` builds a bloom filter file for a bup repo, if
-one already exists, it checks it and updates or regenerates
-it if needed.
+`bup bloom` builds a bloom filter file for a bup
+repository. If one already exists, it checks the filter and
+updates or regenerates it as needed.
 
 # OPTIONS
 
--d, --dir=*directory*
-:   the directory, containing .idx files, to process.
-    defaults to $BUP_DIR/objects/pack
-
--o, --outfile=*outfile*
-:   the file to write the bloom filter to.
-    defaults to $dir/bup.bloom
+\--ruin
+:   destroy bloom filters by setting the whole bitmask to
+    zeros.  you really want to know what you are doing if
+    run this and you want to delete the resulting bloom
+    when you are done with it.
+
+-f, \--force
+:   don't update the existing bloom file; generate a new
+    one from scratch.
+
+-d, \--dir=*directory*
+:   the directory, containing `.idx` files, to process.
+    Defaults to $BUP_DIR/objects/pack
+
+-o, \--outfile=*outfile*
+:   the file to write the bloom filter to.  defaults to
+    $dir/bup.bloom
+
+-k, \--hashes=*hashes*
+:   number of hash functions to use only 4 and 5 are valid.
+    defaults to 5 for repositories < 2 TiB, or 4 otherwise.
+    See comments in git.py for more on this value.
+
+-c, \--check=*idxfile*
+:   checks the bloom file (counterintuitively outfile)
+    against the specified `.idx` file, first checks that the
+    bloom filter is claiming to contain the `.idx`, then
+    checks that it does actually contain all of the objects
+    in the `.idx`.  Does not write anything and ignores the
+    `-k` option.
 
 # BUP