summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorJakob Unterwurzacher2021-08-26 08:43:41 +0200
committerJakob Unterwurzacher2021-08-26 08:43:41 +0200
commit91d3b30c1c813a56ae057a373f045803fb788d60 (patch)
tree23d49fa3ba8f36b2b35962c90caaf1063719bd8f /Documentation
parent7b25ff39c81aea559e7a2fd3a5f6143e95521ce2 (diff)
doc: file-format.md: describe XChaCha20-Poly1305
Different nonce size.
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/file-format.md36
1 files changed, 30 insertions, 6 deletions
diff --git a/Documentation/file-format.md b/Documentation/file-format.md
index 04bd2fe..7cce72c 100644
--- a/Documentation/file-format.md
+++ b/Documentation/file-format.md
@@ -18,22 +18,46 @@ Data block, AES-SIV mode (used in reverse mode, or when explicitly enabled with
16 bytes SIV
1-4096 bytes encrypted data
-Full block overhead = 32/4096 = 1/128 = 0.78125 %
+Data block, XChaCha20-Poly1305 (enabled via `-init -xchacha`)
-Example: 1-byte file
---------------------
+ 24 bytes nonce
+ 1-4096 bytes encrypted data
+ 16 bytes Poly1305 tag
+
+Full block overhead (AES-GCM and AES-SIV mode) = 32/4096 = 1/128 = 0.78125 %
+
+Full block overhead (XChaCha20-Poly1305 mode) = 40/4096 = \~1 %
+
+Example: 1-byte file, AES-GCM and AES-SIV mode
+----------------------------------------------
Header 18 bytes
Data block 33 bytes
Total: 51 bytes
-
-Example: 5000-byte file
------------------------
+Example: 5000-byte file, , AES-GCM and AES-SIV mode
+---------------------------------------------------
Header 18 bytes
Data block 4128 bytes
Data block 936 bytes
Total: 5082 bytes
+
+Example: 1-byte file, XChaCha20-Poly1305 mode
+----------------------------------------------
+
+ Header 18 bytes
+ Data block 41 bytes
+
+Total: 59 bytes
+
+Example: 5000-byte file, XChaCha20-Poly1305 mode
+----------------------------------------------
+
+ Header 18 bytes
+ Data block 4136 bytes
+ Data block 944 bytes
+
+Total: 5098 bytes