borg/docs/usage
Marian Beermann a3ee9d2c5f borg recreate: Re-create existing archives.
Use with caution: permanent data loss by specifying incorrect patterns
is easily possible. Make a dry run to make sure you got everything right.

borg recreate has many uses:
- Can selectively remove files/dirs from old archives, e.g. to free
  space or purging picturarum biggus dickus from history
- Recompress data
- Rechunkify data, to have upgraded Attic / Borg 0.xx archives deduplicate
  with Borg 1.x archives. (Or to experiment with chunker-params for
  specific use cases

It is interrupt- and resumable.

Chunks are not freed on-the-fly.
Rationale:
  Makes only sense when rechunkifying, but logic on which new chunks to
  free what input chunks is complicated and *very* delicate.

Future TODOs:
- Refactor tests using py.test fixtures
  -- would require porting ArchiverTestCase to py.test: many changes,
     this changeset is already borderline too large.
- Possibly add a --target option to not replace the source archive
  -- with the target possibly in another Repo
     (better than "cp" due to full integrity checking, and deduplication
      at the target)
- Detect and skip (unless --always-recompress) already recompressed chunks

Fixes #787 #686 #630 #70 (and probably some I overlooked)
Also see #757 and #770
2016-04-10 13:54:44 +02:00
..
break-lock.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
change-passphrase.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
check.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
comment.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
common-options.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
create.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
debug-delete-obj.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
debug-dump-archive-items.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
debug-get-obj.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
debug-put-obj.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
delete.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
diff.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
extract.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
help.rst.inc ran setup.py build_usage 2016-01-23 20:54:20 +01:00
info.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
init.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
list.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
migrate-to-repokey.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
mount.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
prune.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
recreate.rst.inc borg recreate: Re-create existing archives. 2016-04-10 13:54:44 +02:00
rename.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
serve.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
upgrade.rst.inc Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00