bup-get(1) General Commands Manual bup-get(1) (NAME) bup-get - bup (SYNOPSIS) bup get [-s source-path] [-r host:path] OPTIONS <(METHOD ref [dest])>... (DESCRIPTION) bup get (ref) ( --bup-dir BUP_DIR) METHOD METHOD --ff --ff: --append --append: --pick --pick: --force-pick --force-pick: --new-tag --new-tag: --replace --replace: --unnamed . (--copy) (--rewrite) (deduplication granularity) (--repair). <<>> . ref dest . dest METHOD . : bup get -s /source/repo --ff foo bup get -s /source/repo --ff: foo/latest bar bup get -s /source/repo --pick: foo/2010-10-10-101010 bar bup get -s /source/repo --pick: foo/2010-10-10-101010 .tag/bar METHOD ref dest (branch) (save) (tag) . ref "latest" bup "latest" "latest" bup get foo/latest bup get foo/2013-01-01-030405 . bup get << >> ("fast-forward") ( ). --replace --force-pick . ( --append --pick ) (author) (committer) . bup (tree) . . (ref) --remote <<"bup on HOST get ...">> . bup-on(1) <<>> . : bup . (join) . ( dev/compare-trees .) (METHODS) --ff ref, --ff: ref dest (fast-forward) dest ref. dest ref (save) dest . dest ref dest . --append ref, --append: ref dest ref dest . ref / . dest ref dest ref . dest ref dest . --pick ref, --pick: ref dest ref dest . dest ref dest ref . dest ref dest . --force-pick ref, --force-pick: ref dest --pick (parent) ref . --new-tag ref, --new-tag: ref dest dest ref . dest ref dest . --replace ref, --replace: ref dest dest ref . dest ref dest . --unnamed ref ref / ref ( bup tag). --copy . (OPTIONS) -s path, -S url, --source path, --source-url url* path url . <> bup(1) . -r, --remote=[user@]host:[path], --remote=URL ref SSH . <> bup(1) . -c, --print-commits . -t, --print-trees . --print-tags . --copy ( ). . --rewrite bup.split.files bup.split.trees . ( <<>> ). --rewrite --repair --copy --rewrite (append) (pick) ( ) . git bup . --rewrite bup get ( <<>> ). . ( << >> ). --repair --rewrite . <<>> . ( << >> ). --repair-id ID UUID ( ) . (--repair) . ASCII DEL ( >= 20 < 127 ). ( << >> ). --ignore-missing . --unnamed . --exclude-rx=pattern pattern (http://docs.python.org/library/re.html). (anchoring) <<"x/y">> <<"ox/yard">> <<"box/yards">> . /tmp <<"^/tmp/.">> . ( ) : o /foo$ - foo o /foo/$ - foo o /foo/. - foo o ^/tmp/. - tmp . ( << >> ). --exclude-rx-from=filename --exclude-rx filename ( ). . . ( << >> ). --no-excludes --exclude-rx --exclude-rx-from. ( << >> ). -v, --verbose ( ). -v -vv -vvv . --bwlimit=bytes/sec bytes/sec . . k M G * ** . -#, --compress=# # ( 0 9 9 0 ). pack.compression core.compression 1 ( ) . (CONTEXTUAL OPTIONS) --repair --ignore-missing METHOD METHOD . : bup get ... --ignore-missing --unnamed REF \ --no-ignore-missing --rewrite --append REF --no-ignore-missing --ignore-missing --rewrite . (excludes) METHOD METHOD . (REPAIRS) bup get --repair ( ) << >> --rewrite . o bup 0.25 0.30.1 ( bup-validate-refs(1) --bupm ). () . .bupm --repair .bupm <<".">> ( ) . bup-restore(1) bup-ls(1) ( umask 077 ). o bup get bup gc 0.33.5 ( bup-validate-object-links(1) ). --repair << >> . . --repair-id . . 0.33.5 (0.33.5-from-0.33.4.md) . <<>> -- . bup . . (EXAMPLES) # archives src-repo . $ bup get -s src-repo --ff archives # archives pruned-archives. $ bup get -s src-repo --pick: archives/2013-01-01-030405 pruned-archives # archives remotehost . $ bup on remotehost get --ff archives # archives remotehost. $ bup get -r remotehost: --ff archives # archives src-repo remotehost. $ bup get -s src-repo -r remotehost: --ff archives # archives-2 remotehost archives. # archives-2 archives # bup . $ bup get -r remotehost: --ff: archives archives-2 # y x. $ bup get --replace: x y # archives foo. $ bup get -r remotehost: --pick: archives/latest .tag/foo # foo : $ bup get -r remotehost: --force-pick: archives/latest .tag/foo # foo ( ) other-archives. $ bup on remotehost get --append: .tag/foo other-archives # /home archives/latest only-home. $ bup get -s "$BUP_DIR" --append: archives/latest/home only-home # () archives. # archives # . pick # . ( BUP_DIR # .) # $ git --git-dir "$BUP_DIR" config bup.split.trees true $ git --git-dir "$BUP_DIR" config bup.split.files legacy:16 $ bup get --rewrite --append: archives archives-resplit # # archives-resplit # ( <<>> ) # ... # $ bup rm archives $ bup gc $ git --git-dir "$BUP_DIR" branch -m archives-resplit archives # # . $ bup get --repair --pick archives/latest fixed # # fixed/latest # ( <<>> ). (EXIT STATUS) 3 . (SEE ALSO) bup-on(1) bup-tag(1) ssh_config(5) BUP (BUP) bup(1). (AUTHORS) Rob Browning . Bup 0.34+ 2026-09-01 bup-get(1)