1bup-bloom(1)                                                      bup-bloom(1)
2
3
4

NAME

6       bup-bloom - generates, regenerates, updates bloom filters
7

SYNOPSIS

9       bup bloom [-d dir] [-o outfile] [-k hashes] [-c idxfile] [-f] [--ruin]
10

DESCRIPTION

12       bup bloom  builds a bloom filter file for a bup repository.  If one al‐
13       ready exists, it checks the filter and updates  or  regenerates  it  as
14       needed.
15

OPTIONS

17       --ruin destroy  bloom  filters  by  setting the whole bitmask to zeros.
18              you really want to know what you are doing if run this  and  you
19              want to delete the resulting bloom when you are done with it.
20
21       -f, --force
22              don't  update  the  existing bloom file; generate a new one from
23              scratch.
24
25       -d, --dir=directory
26              the directory, containing .idx files, to process.   Defaults  to
27              $BUP_DIR/objects/pack
28
29       -o, --outfile=outfile
30              the   file   to   write   the  bloom  filter  to.   defaults  to
31              $dir/bup.bloom
32
33       -k, --hashes=hashes
34              number of hash functions to use only 4 and  5  are  valid.   de‐
35              faults  to 5 for repositories < 2 TiB, or 4 otherwise.  See com‐
36              ments in git.py for more on this value.
37
38       -c, --check=idxfile
39              checks the bloom file (counterintuitively outfile)  against  the
40              specified  .idx  file,  first  checks  that  the bloom filter is
41              claiming to contain the .idx, then checks that it does  actually
42              contain all of the objects in the .idx.  Does not write anything
43              and ignores the -k option.
44

BUP

46       Part of the bup(1) suite.
47

AUTHORS

49       Brandon Low <lostlogic@lostlogicx.com>.
50
51
52
53Bup 0.29.1                        2017-03-26                      bup-bloom(1)