1bup-gc(1) bup-gc(1)
2
6 bup-gc - remove unreferenced, unneeded data (CAUTION: EXPERIMENTAL)
7
9 bup gc [-#|–verbose] <branch|save...>
10
12 bup gc removes (permanently deletes) unreachable data from the reposi‐
13 tory, data that isn't referred to directly or indirectly by the current
14 set of branches (backup sets) and tags. But bear in mind that given
15 deduplication, deleting a save and running the garbage collector might
16 or might not actually delete anything (or reclaim any space).
17 With the current, proababilistic implementation, some fraction of the
19 unreachable data may be retained. In exchange, the garbage collection
20 should require much less RAM than might by some more precise approach‐
21 es.
22 Typically, the garbage collector would be invoked after some set of in‐
24 vocations of bup rm.
25 WARNING: This is one of the few bup commands that modifies your archive
27 in intentionally destructive ways. Though if an attempt to join or re‐
28 store the data you still care about after a gc succeeds, that's a fair‐
29 ly encouraging sign that the commands worked correctly. (The t/com‐
30 pare-trees command in the source tree can be used to help test be‐
31 fore/after results.)
32
34 --threshold=N
35 only rewrite a packfile if it's over N percent garbage; other‐
36 wise leave it alone. The default threshold is 10%.
37 -v, --verbose
39 increase verbosity (can be used more than once). With one -v,
40 bup prints every directory name as it gets backed up. With two
41 -v, it also prints every filename.
42 -#, --compress=#
44 set the compression level to # (a value from 0-9, where 9 is the
45 highest and 0 is no compression). The default is 1 (fast, loose
46 compression).
47
49 # Remove all saves of "home" and most of the otherwise unreferenced data.
50 $ bup rm home
51 $ bup gc
52
54 bup-rm(1) and bup-fsck(1)
55
57 Part of the bup(1) suite.
58
60 Rob Browning <rlb@defaultvalue.org>.
61Bup 0.29.1 2017-03-26 bup-gc(1)