/usr/share/doc/bup/bup-bloom.html is in bup-doc 0.29-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="generator" content="pandoc" />
<meta name="author" content="Brandon Low lostlogic@lostlogicx.com" />
<meta name="date" content="2017-04-01" />
<title>bup-bloom(1) Bup debian/0.29-3</title>
<style type="text/css">code{white-space: pre;}</style>
</head>
<body>
<div id="header">
<h1 class="title">bup-bloom(1) Bup debian/0.29-3</h1>
<h2 class="author">Brandon Low <a href="mailto:lostlogic@lostlogicx.com">lostlogic@lostlogicx.com</a></h2>
<h3 class="date">2017-04-01</h3>
</div>
<h1 id="name">NAME</h1>
<p>bup-bloom - generates, regenerates, updates bloom filters</p>
<h1 id="synopsis">SYNOPSIS</h1>
<p>bup bloom [-d dir] [-o outfile] [-k hashes] [-c idxfile] [-f] [--ruin]</p>
<h1 id="description">DESCRIPTION</h1>
<p><code>bup bloom</code> builds a bloom filter file for a bup repository. If one already exists, it checks the filter and updates or regenerates it as needed.</p>
<h1 id="options">OPTIONS</h1>
<dl>
<dt>--ruin</dt>
<dd>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.
</dd>
<dt>-f, --force</dt>
<dd>don't update the existing bloom file; generate a new one from scratch.
</dd>
<dt>-d, --dir=<em>directory</em></dt>
<dd>the directory, containing <code>.idx</code> files, to process. Defaults to $BUP_DIR/objects/pack
</dd>
<dt>-o, --outfile=<em>outfile</em></dt>
<dd>the file to write the bloom filter to. defaults to $dir/bup.bloom
</dd>
<dt>-k, --hashes=<em>hashes</em></dt>
<dd>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.
</dd>
<dt>-c, --check=<em>idxfile</em></dt>
<dd>checks the bloom file (counterintuitively outfile) against the specified <code>.idx</code> file, first checks that the bloom filter is claiming to contain the <code>.idx</code>, then checks that it does actually contain all of the objects in the <code>.idx</code>. Does not write anything and ignores the <code>-k</code> option.
</dd>
</dl>
<h1 id="bup">BUP</h1>
<p>Part of the <code>bup</code>(1) suite.</p>
</body>
</html>
|