ExternalVendorCode/tahoe-lafs
1
0
Fork 0
mirror of https://github.com/tahoe-lafs/tahoe-lafs.git synced 2024-12-18 20:47:54 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Fix 4116 and accept reviewer's feedback

Browse Source
This commit is contained in:
blaisep 2024-10-23 15:38:51 -04:00
parent 06219ad669
commit 2cfbfa89f1
2 changed files with 28 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

60
docs/specifications/http-storage-node-protocol.rst
View File

@ -16,51 +16,47 @@ The Tahoe-LAFS client will also need to change but it is not expected that it wi
Glossary Glossary
-------- --------
Foolscap `Foolscap <https://github.com/warner/foolscap/>`_
an RPC/RMI (Remote Procedure Call / Remote Method Invocation) protocol for use with Twisted an RPC/RMI (Remote Procedure Call / Remote Method Invocation) protocol for use with Twisted
storage server storage server
a Tahoe-LAFS process configured to offer storage and reachable over the network for store and retrieve operations a Tahoe-LAFS process configured to offer storage and reachable over the network for store and retrieve operations
storage service storage service
a Python object held in memory in the storage server which provides the implementation of the storage protocol a Python object held in memory in the storage server which provides the implementation of the storage protocol
introducer introducer
a Tahoe-LAFS process at a known location configured to re-publish announcements about the location of storage servers a Tahoe-LAFS process at a known location configured to re-publish announcements about the location of storage servers
:ref:`fURLs <fURLs>` :ref:`fURLs <fURLs>`
a self-authenticating URL-like string which can be used to locate a remote object using the Foolscap protocol a self-authenticating URL-like string which can be used to locate a remote object using the Foolscap protocol (the storage service is an example of such an object)
(the storage service is an example of such an object)
:ref:`NURLs <NURLs>` :ref:`NURLs <NURLs>`
a self-authenticating URL-like string almost exactly like a fURL but without being tied to Foolscap a self-authenticating URL-like string almost exactly like a fURL but without being tied to Foolscap
swissnum swissnum
a short random string which is part of a fURL/NURL and which acts as a shared secret to authorize clients to use a storage service a short random string which is part of a fURL/NURL and which acts as a shared secret to authorize clients to use a storage service
lease lease
state associated with a share informing a storage server of the duration of storage desired by a client state associated with a share informing a storage server of the duration of storage desired by a client
share share
a single unit of client-provided arbitrary data to be stored by a storage server a single unit of client-provided arbitrary data to be stored by a storage server (in practice, one of the outputs of applying ZFEC encoding to some ciphertext with some additional metadata attached)
(in practice, one of the outputs of applying ZFEC encoding to some ciphertext with some additional metadata attached)
bucket bucket
a group of one or more immutable shares held by a storage server and having a common storage index a group of one or more immutable shares held by a storage server and having a common storage index
slot slot
a group of one or more mutable shares held by a storage server and having a common storage index a group of one or more mutable shares held by a storage server and having a common storage index (sometimes "slot" is considered a synonym for "storage index of a slot")
(sometimes "slot" is considered a synonym for "storage index of a slot")
storage index storage index
a 16 byte string which can address a slot or a bucket a 16 byte string which can address a slot or a bucket (in practice, derived by hashing the encryption key associated with contents of that slot or bucket)
(in practice, derived by hashing the encryption key associated with contents of that slot or bucket)
write enabler write enabler
a short secret string which storage servers require to be presented before allowing mutation of any mutable share a short secret string which storage servers require to be presented before allowing mutation of any mutable share
lease renew secret lease renew secret
a short secret string which storage servers required to be presented before allowing a particular lease to be renewed a short secret string which storage servers required to be presented before allowing a particular lease to be renewed
Additional terms related to the Tahoe-LAFS project in general are defined in the :doc:`../glossary` Additional terms related to the Tahoe-LAFS project in general are defined in the :doc:`../glossary`

0
newsfragments/4116.documention → newsfragments/4116.documentation
View File