From f889c5e1ed2ca2bf21985b50b5385c34e3d116b2 Mon Sep 17 00:00:00 2001 From: Alexander Neumann Date: Thu, 30 Apr 2015 00:31:21 +0200 Subject: [PATCH] doc: Add comment about pack header --- doc/Design.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/Design.md b/doc/Design.md index 93805c339..083cba818 100644 --- a/doc/Design.md +++ b/doc/Design.md @@ -102,7 +102,11 @@ The Pack's structure is as follows: At the end of the Pack is a header, which describes the content and is encrypted and signed. `Header_Length` is the length of the encrypted header -encoded as a is a four byte integer in little-endian encoding. +encoded as a four byte integer in little-endian encoding. Placing the header at +the end of a file allows writing the blobs in a continuous stream as soon as +they are read during the backup phase. This reduces code complexity and avoids +having to re-write a file once the pack is complete and the content and length +of the header is known. All the blobs (`EncryptedBlob1`, `EncryptedBlobN` etc.) are signed and encrypted independently. This enables repository reorganisation without having