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

NAME

6       bup-gc - remove unreferenced, unneeded data (CAUTION: EXPERIMENTAL)
7

SYNOPSIS

9       bup gc [-#|–verbose] <branch|save...>
10

DESCRIPTION

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
18       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
23       Typically, the garbage collector would be invoked after some set of in‐
24       vocations of bup rm.
25
26       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

OPTIONS

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
38       -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
43       -#, --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

EXAMPLES

49              # Remove all saves of "home" and most of the otherwise unreferenced data.
50              $ bup rm home
51              $ bup gc
52

SEE ALSO

54       bup-rm(1) and bup-fsck(1)
55

BUP

57       Part of the bup(1) suite.
58

AUTHORS

60       Rob Browning <rlb@defaultvalue.org>.
61
62
63
64Bup 0.29.1                        2017-03-26                         bup-gc(1)
Impressum