borgbackup/docs
Thomas Waldmann 29a760e2b3
repo-create: split --encryption into --encryption + --id-hash, #9168
The combined --encryption value packed two orthogonal dimensions (cipher / AE
algorithm and id hash function) into a single string, causing a combinatorial
explosion of mode names. Key location was already split out into --key-location.

Now:
- --encryption selects only the cipher / AE algorithm:
  none, authenticated, aes256-ocb, chacha20-poly1305
- --id-hash selects the id hash function: sha256 (default) or blake3
- --key-location (unchanged) selects key storage: repokey (default) or keyfile

The old combined names were removed (clean break): select a BLAKE3 suite via
--encryption ... --id-hash blake3 instead of blake3-*. aes-ocb was renamed to
aes256-ocb (key NAME shown by repo-info and ARG_NAME in JSON updated to match).
"none" has no key, so it only supports the sha256 id hash.

No on-disk format, key-type byte, or crypto behavior changes: the existing key
classes form a clean cross-product of {cipher} x {id-hash}, selected via the new
ENC_NAME / IDHASH_NAME class attributes.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-15 17:44:38 +02:00
..
3rd_party fixed typos and grammar (AI) 2025-09-23 14:56:23 +02:00
_static revert logo colour to #00dd00 (per @TW) 2017-08-16 17:50:59 +02:00
_templates docs: offer a PDF download and link offline formats in the sidebar, fixes #9731 2026-06-09 02:08:14 +02:00
binaries CI: use macOS 15 for binary builds 2025-12-15 17:40:51 +01:00
borg_theme/css docs: offer a PDF download and link offline formats in the sidebar, fixes #9731 2026-06-09 02:08:14 +02:00
deployment remove ssh:// and socket:// remote repository for current repos 2026-06-08 08:04:59 +02:00
internals remove xxhash / xxh64 requirement, mentions 2026-06-10 00:38:18 +02:00
man Merge pull request #9769 from ThomasWaldmann/docs-key-subcommands 2026-06-13 23:47:58 +02:00
misc manual corrections/reverts 2025-09-23 14:56:35 +02:00
usage repo-create: split --encryption into --encryption + --id-hash, #9168 2026-06-15 17:44:38 +02:00
authors.rst fix levels in authors section 2016-11-04 21:14:59 -04:00
book.rst fixed typos and grammar (AI) 2025-09-23 14:56:23 +02:00
changes.rst repo-create: split --encryption into --encryption + --id-hash, #9168 2026-06-15 17:44:38 +02:00
changes_0.x.rst fixed typos and grammar (AI) 2025-09-23 14:56:23 +02:00
changes_1.x.rst fixed typos and grammar (AI) 2025-09-23 14:56:23 +02:00
conf.py docs: offer a PDF download and link offline formats in the sidebar, fixes #9731 2026-06-09 02:08:14 +02:00
deployment.rst add non-root deployment strategy 2024-02-24 21:17:01 +01:00
development.rst CI: use locked requirements, add canary job, fixes #9361 2026-03-12 15:01:00 +01:00
faq.rst remove xxhash / xxh64 requirement, mentions 2026-06-10 00:38:18 +02:00
global.rst.inc remove xxhash / xxh64 requirement, mentions 2026-06-10 00:38:18 +02:00
index.rst fixed typos and grammar (AI) 2025-09-23 14:56:23 +02:00
installation.rst remove python 3.10 support (master branch), fixes #9707 2026-06-06 15:34:05 +02:00
internals.rst docs: add pack file format design and internals documentation, refs #8572 2026-05-27 13:26:18 +05:30
introduction.rst fixed typos and grammar (AI) 2025-09-23 14:56:23 +02:00
Makefile fixed typos and grammar (AI) 2025-09-23 14:56:23 +02:00
man_intro.rst fixed typos and grammar (AI) 2025-09-23 14:56:23 +02:00
quickstart.rst improve docs / comments 2026-06-09 00:49:50 +02:00
quickstart_example.rst.inc key: unify keyfile/repokey classes, locate key independent of type byte (#9743) 2026-06-12 23:48:45 +02:00
support.rst docs: reflow some really long lines 2020-03-11 16:27:57 -07:00
usage.rst repo-compress: remove this command for now 2026-05-22 13:00:13 +02:00
usage_general.rst.inc [DOCS] #4587 – Make Sphinx warnings break docs build 2020-03-16 19:22:59 +01:00