borg/docs/internals
Thomas Waldmann 26ff43fdcc
repo-create: always write config/defaults, so its removal is detected, refs #346
Without the object, the commands silently fell back to the built-in defaults, so
anybody with write access to the store could remove a repository default (e.g. an
"obfuscate" compression) unnoticed: the key protects the content of the object,
not its presence.

Now "borg repo-create" always writes config/defaults (empty if no default was
given), and a missing object is an error (Repository.DefaultsMissing, rc 34) like
one that fails the authentication: the commands using the defaults refuse to run.
"borg check" reports such an object, "borg check --repair" replaces it by empty
defaults, so the repository can be used again (with the built-in defaults).

with_repository reads the defaults only after the security checks (assert_secure).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-27 17:09:59 +02:00
..
chunker.rst goldilocks-aes: build on 32bit archs (no __uint128_t there) 2026-08-25 19:05:12 +02:00
data-structures.rst repo-create: always write config/defaults, so its removal is detected, refs #346 2026-09-27 17:09:59 +02:00
encryption-aead.odg docs: update security docs about new one-step KDF 2023-12-02 20:35:16 +01:00
encryption-aead.png docs: update security docs about new one-step KDF 2023-12-02 20:35:16 +01:00
frontends.rst repo-create: always write config/defaults, so its removal is detected, refs #346 2026-09-27 17:09:59 +02:00
object-graph.odg docs: updates / removing outdated stuff 2024-09-08 12:00:50 +02:00
object-graph.png docs: updates / removing outdated stuff 2024-09-08 12:00:50 +02:00
pack-layout.excalidraw docs: address review, add excalidraw sources for pack figures 2026-07-03 17:22:36 +05:30
pack-layout.png docs: illustrate pack file format and sync packs.rst to multi-object packs, refs #8572 2026-07-03 10:40:36 +05:30
pack-objheader.excalidraw docs: address review, add excalidraw sources for pack figures 2026-07-03 17:22:36 +05:30
pack-objheader.png docs: address review, add excalidraw sources for pack figures 2026-07-03 17:22:36 +05:30
pack-write-order.excalidraw docs: address review, add excalidraw sources for pack figures 2026-07-03 17:22:36 +05:30
pack-write-order.png docs: illustrate pack file format and sync packs.rst to multi-object packs, refs #8572 2026-07-03 10:40:36 +05:30
packs.rst compact, repo-compress: clarify corrupt pack help and warning, add stats and internals docs, refs #10410 2026-09-25 09:47:02 +05:30
security.rst docs: lock objects are protected by the repository key, #8386 2026-09-25 19:16:40 +02:00
structure.odg docs: update structure diagram 2026-06-16 15:51:00 +02:00
structure.png docs: update structure diagram 2026-06-16 15:51:00 +02:00