From 63f8d4df594bc98f56c76a149e41da770225d429 Mon Sep 17 00:00:00 2001 From: sneak Date: Fri, 6 Nov 2026 18:25:45 +0000 Subject: [PATCH] Turn two comma chains in ARCHITECTURE.md into lists Model: fable-5-1 --- ARCHITECTURE.md | 20 +++++++++++++++----- 1 file changed, 15 insertions(+), 5 deletions(-) diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index 48a44b2..c91f95d 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -1,8 +1,11 @@ # vaultik architecture -This document describes how the `vaultik` code is organised. It covers the -packages, how they are wired together, and what happens during a backup, a -restore, a verify and a prune. +This document describes how the `vaultik` code is organised. It covers three +things: + +- the packages +- how they are wired together +- what happens during a backup, a restore, a verify and a prune Two other documents cover the stored data: @@ -170,11 +173,18 @@ The walk handles each kind of entry differently: Data is stored once at two levels. - **Files.** A file is not read again when its record in the index still matches - it. The record matches when the size, modification time, mode, owner, group - and link target are all the same. + it. - **Chunks.** A chunk is named by the SHA-256 hash of its content. A chunk whose hash is already in the index is not stored again. +A file's record matches when all of these are unchanged: + +- the size +- the modification time +- the mode +- the owner and group +- the link target + One case overrides the file check. A file is read again when it lists a chunk that no uploaded blob holds. This happens after the only snapshot that used such a blob is removed. `loadFilesToRechunk` finds these files.