1
0
Fork 0
mirror of https://github.com/borgbackup/borg.git synced 2024-12-26 09:47:58 +00:00
borg/docs
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
..
_static Document logo font. Recreate logo png. Remove GIMP logo file. 2016-03-31 21:37:30 +02:00
borg_theme/css Better help texts and Sphinx reproduction of usage 2016-04-10 01:28:19 +02:00
misc change the builtin default for --chunker-params, create 2MiB chunks, fixes #343 2016-01-24 15:44:09 +01:00
usage borg recreate: Re-create existing archives. 2016-04-10 13:54:44 +02:00
api.rst ran build_api build_usage 2016-04-08 23:38:46 +02:00
authors.rst move authors to a stub, include LICENSE 2015-10-07 18:33:31 -04:00
changes.rst update CHANGES 2016-04-08 23:41:15 +02:00
conf.py sphinx configuration: fix to create a simple man page from usage docs 2016-01-13 01:20:32 +01:00
deployment.rst docs: Updated examples in deployment.rst, fixes #644 2016-02-15 21:37:50 +01:00
development.rst fix order in release process docs 2016-02-07 14:44:49 +01:00
faq.rst document how to debug / file filesystem issues, fixes #664 2016-03-12 00:48:26 +01:00
global.rst.inc fix some minor cosmetic code/docs issues 2016-01-30 00:01:13 +01:00
index.rst docs/deployment: Add borg storage server setup example 2016-01-13 21:06:03 +01:00
installation.rst cleanup ubuntu in install list 2016-04-09 16:27:43 -04:00
internals.rst docs: updates and fixes 2016-02-01 03:22:02 +01:00
Makefile fix homepage URL in all remaining places 2015-10-09 15:54:04 -04:00
quickstart.rst update and improve docs 2016-02-27 17:22:56 +01:00
resources.rst add gource video to resources docs, fixes #507 2016-01-15 10:34:05 +01:00
support.rst docs: updates and fixes 2016-02-01 03:22:02 +01:00
usage.rst borg recreate: Re-create existing archives. 2016-04-10 13:54:44 +02:00