Edit the summary of the repository format/process
This commit is contained in:
parent
b6cd6f7138
commit
cc3fd5b985
1 changed files with 29 additions and 22 deletions
51
README.rst
51
README.rst
|
@ -114,30 +114,37 @@ Notes
|
||||||
Repository Format
|
Repository Format
|
||||||
.................
|
.................
|
||||||
|
|
||||||
::
|
``EncSign(X)``
|
||||||
|
Sign and Encrypt to GPG key holder
|
||||||
|
``Encrypt(K,X)``
|
||||||
|
Encrypt using symmetric-key algorithm
|
||||||
|
``Hash(X)``
|
||||||
|
SHA-2/256
|
||||||
|
|
||||||
EncSign(X) is sign+encrypt to a PGP key holder
|
``B``
|
||||||
Encrypt(K,X) is symmetric encryption
|
branch list
|
||||||
Hash(X) is SHA-256
|
``L``
|
||||||
|
list of the hash (``Hi``) and key (``Ki``) for each packfile
|
||||||
|
``R``
|
||||||
|
Repository ID
|
||||||
|
|
||||||
B: branch list
|
|
|
||||||
L: list of the hash (Hi) and key (Ki) for each packfile
|
| To write the repository:
|
||||||
R: Repository ID
|
|
|
||||||
|
| Store each packfile ``P`` as ``P'`` = ``Encrypt(Ki, P)`` in filename ``Hi``
|
||||||
Store Manifest as EncSign(B || L || R)
|
| where ``Ki`` is a new random string and ``Hi = Hash(P')``
|
||||||
Store each packfile P as P' = Encrypt(Ki, P) in filename Hi
|
| Store ``EncSign(B || L || R)`` in the manifest
|
||||||
where Hi = Hash(P') and Ki is a random string
|
|
|
||||||
|
| To read the repository:
|
||||||
To read the repository
|
|
|
||||||
|
| Decrypt and verify manifest using GPG keyring ``-> (B, L, R)``
|
||||||
decrypt+verify Manifest using private key -> (B, L, R)
|
| Warn if ``R`` does not match saved Repository ID for this remote
|
||||||
warn if R does not match saved Repository ID for this remote
|
| ``for each Hi, Ki in L``:
|
||||||
for Hi, Ki in L:
|
| Get file ``Hi`` from the server ``-> P'``
|
||||||
download file Hi from the server -> P'
|
| Verify ``Hash(P')`` matches ``Hi``
|
||||||
verify Hash(P') matches Hi
|
| Decrypt ``P'`` using ``Ki`` -> ``P`` then open ``P`` with git
|
||||||
decrypt P' using Ki -> P then open P with git
|
|
|
||||||
|
| Only packs mentioned in ``L`` are downloaded.
|
||||||
Only packs mentioned in L are downloaded.
|
|
||||||
|
|
||||||
Manifest file
|
Manifest file
|
||||||
.............
|
.............
|
||||||
|
|
Loading…
Reference in a new issue