gnunet-handbook

The GNUnet Handbook
Log | Files | Refs

commit 04ac4ce2c69ea11bd309345f4336faf728f2a994
parent 824f7ae4bb0a5a716548546433c3d57fbdc1aeac
Author: Martin Schanzenbach <schanzen@gnunet.org>
Date:   Fri,  8 Sep 2023 20:41:51 +0200

use external gana

Diffstat:
Dgana/dot_alt.rst | 24------------------------
Dgana/gnu_name_system_record_flags.rst | 54------------------------------------------------------
Dgana/gnu_name_system_record_types.rst | 244-------------------------------------------------------------------------------
Dgana/gnunet_dht_block_types.rst | 157-------------------------------------------------------------------------------
Dgana/gnunet_error_codes.rst | 224-------------------------------------------------------------------------------
Dgana/gnunet_signatures.rst | 334-------------------------------------------------------------------------------
Dgana/index.rst | 19-------------------
Dgana/intro.rst | 49-------------------------------------------------
Dgana/tlds.rst | 22----------------------
Mindex.rst | 2+-
10 files changed, 1 insertion(+), 1128 deletions(-)

diff --git a/gana/dot_alt.rst b/gana/dot_alt.rst @@ -1,24 +0,0 @@ -.alt Subdomains ---------------- - - - - -=================== =========================================================== -Label gns -------------------- ----------------------------------------------------------- -Contact Martin Schanzenbach <schanzen@gnunet.org> -References RFC XXXX -Description The .alt subdomain for GNS -=================== =========================================================== - - - -=================== =========================================================== -Label xn--fsq -------------------- ----------------------------------------------------------- -Contact Martin Schanzenbach <schanzen@gnunet.org> -References None -Description Unreserved unicode example -=================== =========================================================== - diff --git a/gana/gnu_name_system_record_flags.rst b/gana/gnu_name_system_record_flags.rst @@ -1,54 +0,0 @@ -GNS Record Flags ----------------- - - - - -=================== =========================================================== -Name CRITICAL -------------------- ----------------------------------------------------------- -Number 15 -Comment This record is critical. If it cannot be processed (for example because the record type is unknown) resolution MUST fail -References https://lsd.gnunet.org/lsd0001 -=================== =========================================================== - - - -=================== =========================================================== -Name SHADOW -------------------- ----------------------------------------------------------- -Number 14 -Comment This record should not be used unless all (other) records in the set with an absolute expiration time have expired. -References https://lsd.gnunet.org/lsd0001 -=================== =========================================================== - - - -=================== =========================================================== -Name SUPPLEMENTAL -------------------- ----------------------------------------------------------- -Number 13 -Comment This is a supplemental record. -References https://lsd.gnunet.org/lsd0001 -=================== =========================================================== - - - -=================== =========================================================== -Name RELATIVE_EXPIRATION -------------------- ----------------------------------------------------------- -Number 1 -Comment This expiration time of the record is a relative time (not an absolute time). Used in GNUnet implementation. -References https://git.gnunet.org/gnunet.git -=================== =========================================================== - - - -=================== =========================================================== -Name PRIVATE -------------------- ----------------------------------------------------------- -Number 0 -Comment This is a private record of this peer and it should thus not be published. -References https://git.gnunet.org/gnunet.git -=================== =========================================================== - diff --git a/gana/gnu_name_system_record_types.rst b/gana/gnu_name_system_record_types.rst @@ -1,244 +0,0 @@ -GNS Record Types ----------------- - - - - -=================== =========================================================== -Name PKEY -------------------- ----------------------------------------------------------- -Number 65536 -Comment GNS zone delegation (PKEY) -References https://lsd.gnunet.org/lsd0001 -=================== =========================================================== - - - -=================== =========================================================== -Name NICK -------------------- ----------------------------------------------------------- -Number 65537 -Comment GNS zone nickname -References https://lsd.gnunet.org/lsd0001 -=================== =========================================================== - - - -=================== =========================================================== -Name LEHO -------------------- ----------------------------------------------------------- -Number 65538 -Comment GNS legacy hostname -References https://lsd.gnunet.org/lsd0001 -=================== =========================================================== - - - -=================== =========================================================== -Name VPN -------------------- ----------------------------------------------------------- -Number 65539 -Comment VPN resolution -References -=================== =========================================================== - - - -=================== =========================================================== -Name GNS2DNS -------------------- ----------------------------------------------------------- -Number 65540 -Comment Delegation to DNS -References https://lsd.gnunet.org/lsd0001 -=================== =========================================================== - - - -=================== =========================================================== -Name BOX -------------------- ----------------------------------------------------------- -Number 65541 -Comment Box record -References https://lsd.gnunet.org/lsd0001 -=================== =========================================================== - - - -=================== =========================================================== -Name PLACE -------------------- ----------------------------------------------------------- -Number 65542 -Comment social place for SecuShare -References -=================== =========================================================== - - - -=================== =========================================================== -Name PHONE -------------------- ----------------------------------------------------------- -Number 65543 -Comment Endpoint for conversation -References -=================== =========================================================== - - - -=================== =========================================================== -Name RECLAIM_ATTRIBUTE -------------------- ----------------------------------------------------------- -Number 65544 -Comment identity attribute -References -=================== =========================================================== - - - -=================== =========================================================== -Name RECLAIM_TICKET -------------------- ----------------------------------------------------------- -Number 65545 -Comment local ticket reference -References -=================== =========================================================== - - - -=================== =========================================================== -Name DELEGATE -------------------- ----------------------------------------------------------- -Number 65548 -Comment For ABD policies -References -=================== =========================================================== - - - -=================== =========================================================== -Name ATTRIBUTE -------------------- ----------------------------------------------------------- -Number 65549 -Comment For ABD reverse lookups -References -=================== =========================================================== - - - -=================== =========================================================== -Name RECLAIM_ATTRIBUTE_REF -------------------- ----------------------------------------------------------- -Number 65550 -Comment for reclaim records -References -=================== =========================================================== - - - -=================== =========================================================== -Name REDIRECT -------------------- ----------------------------------------------------------- -Number 65551 -Comment Redirection record -References -=================== =========================================================== - - - -=================== =========================================================== -Name RECLAIM_OIDC_CLIENT -------------------- ----------------------------------------------------------- -Number 65552 -Comment For reclaim OIDC client names. -References -=================== =========================================================== - - - -=================== =========================================================== -Name RECLAIM_OIDC_REDIRECT -------------------- ----------------------------------------------------------- -Number 65553 -Comment Used reclaimID OIDC client redirect URIs. -References -=================== =========================================================== - - - -=================== =========================================================== -Name RECLAIM_CREDENTIAL -------------------- ----------------------------------------------------------- -Number 65554 -Comment Record type for an attribute attestation (e.g. JWT). -References -=================== =========================================================== - - - -=================== =========================================================== -Name RECLAIM_PRESENTATION -------------------- ----------------------------------------------------------- -Number 65555 -Comment Record type for a presentation of a credential. -References -=================== =========================================================== - - - -=================== =========================================================== -Name EDKEY -------------------- ----------------------------------------------------------- -Number 65556 -Comment GNS zone delegation (EDKEY) -References -=================== =========================================================== - - - -=================== =========================================================== -Name ERIS_READ_CAPABILITY -------------------- ----------------------------------------------------------- -Number 65557 -Comment Encoding for Robust Immutable Storage (ERIS) binary read capability -References http://purl.org/eris -=================== =========================================================== - - - -=================== =========================================================== -Name MESSENGER_ROOM_ENTRY -------------------- ----------------------------------------------------------- -Number 65558 -Comment Record type to share an entry of a messenger room -References -=================== =========================================================== - - - -=================== =========================================================== -Name TOMBSTONE -------------------- ----------------------------------------------------------- -Number 65559 -Comment Record type to indicate a previously delete record (PRIVATE only) -References -=================== =========================================================== - - - -=================== =========================================================== -Name MESSENGER_ROOM_DETAILS -------------------- ----------------------------------------------------------- -Number 65560 -Comment Record type to store details about a messenger room -References -=================== =========================================================== - - - -=================== =========================================================== -Name DID_DOCUMENT -------------------- ----------------------------------------------------------- -Number 65561 -Comment Record type to store DID Documents -References -=================== =========================================================== - diff --git a/gana/gnunet_dht_block_types.rst b/gana/gnunet_dht_block_types.rst @@ -1,157 +0,0 @@ -R5N DHT Block Types -------------------- - - - - -=================== =========================================================== -Name ANY -------------------- ----------------------------------------------------------- -Number 0 -Comment Identifier for any block. -=================== =========================================================== - - - -=================== =========================================================== -Name FS_DBLOCK -------------------- ----------------------------------------------------------- -Number 1 -Comment Data block (leaf) in the CHK tree. -=================== =========================================================== - - - -=================== =========================================================== -Name FS_IBLOCK -------------------- ----------------------------------------------------------- -Number 2 -Comment Inner block in the CHK tree. -=================== =========================================================== - - - -=================== =========================================================== -Name FS_ONDEMAND -------------------- ----------------------------------------------------------- -Number 6 -Comment Type of a block representing a block to be encoded on demand from disk. Should never appear on the network directly. -=================== =========================================================== - - - -=================== =========================================================== -Name LEGACY_HELLO -------------------- ----------------------------------------------------------- -Number 7 -Comment Legacy type of a block that contains a HELLO for a peer. -=================== =========================================================== - - - -=================== =========================================================== -Name TEST -------------------- ----------------------------------------------------------- -Number 8 -Comment Block for testing. -=================== =========================================================== - - - -=================== =========================================================== -Name FS_UBLOCK -------------------- ----------------------------------------------------------- -Number 9 -Comment Type of a block representing any type of search result (universal). -=================== =========================================================== - - - -=================== =========================================================== -Name DNS -------------------- ----------------------------------------------------------- -Number 10 -Comment Block for storing DNS exit service advertisements. -=================== =========================================================== - - - -=================== =========================================================== -Name GNS_NAMERECORD -------------------- ----------------------------------------------------------- -Number 11 -Comment Block for storing GNS record data. -=================== =========================================================== - - - -=================== =========================================================== -Name REVOCATION -------------------- ----------------------------------------------------------- -Number 12 -Comment Block type for a revocation message by which a key is revoked. -=================== =========================================================== - - - -=================== =========================================================== -Name DHT_HELLO -------------------- ----------------------------------------------------------- -Number 13 -Comment Type of a block that contains a DHT-NG HELLO for a peer. -=================== =========================================================== - - - -=================== =========================================================== -Name REGEX -------------------- ----------------------------------------------------------- -Number 22 -Comment Block to store a cadet regex state -=================== =========================================================== - - - -=================== =========================================================== -Name REGEX_ACCEPT -------------------- ----------------------------------------------------------- -Number 23 -Comment Block to store a cadet regex accepting state -=================== =========================================================== - - - -=================== =========================================================== -Name SET_TEST -------------------- ----------------------------------------------------------- -Number 24 -Comment Block for testing set/consensus. If first byte of the block is non-zero, the block is considered invalid. -=================== =========================================================== - - - -=================== =========================================================== -Name CONSENSUS_ELEMENT -------------------- ----------------------------------------------------------- -Number 25 -Comment Block type for consensus elements. Contains either special marker elements or a nested block. -=================== =========================================================== - - - -=================== =========================================================== -Name SETI_TEST -------------------- ----------------------------------------------------------- -Number 26 -Comment Block for testing set intersection. If first byte of the block is non-zero, the block is considered invalid. -=================== =========================================================== - - - -=================== =========================================================== -Name SETU_TEST -------------------- ----------------------------------------------------------- -Number 27 -Comment Block for testing set union. If first byte of the block is non-zero, the block is considered invalid. -=================== =========================================================== - diff --git a/gana/gnunet_error_codes.rst b/gana/gnunet_error_codes.rst @@ -1,224 +0,0 @@ -GNUnet Error Codes ------------------- - - - - -=================== =========================================================== -Name GNUNET_EC_NONE -------------------- ----------------------------------------------------------- -Value 0 -HTTP Status Code 0 -Description No error (success). -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_UNKNOWN -------------------- ----------------------------------------------------------- -Value 1 -HTTP Status Code 500 -Description Unknown and unspecified error. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_SERVICE_COMMUNICATION_FAILED -------------------- ----------------------------------------------------------- -Value 101 -HTTP Status Code 500 -Description Communication with service failed. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_IDENTITY_NOT_FOUND -------------------- ----------------------------------------------------------- -Value 200 -HTTP Status Code 404 -Description Ego not found. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_IDENTITY_NAME_CONFLICT -------------------- ----------------------------------------------------------- -Value 201 -HTTP Status Code 409 -Description Identifier already in use for another ego. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_IDENTITY_INVALID -------------------- ----------------------------------------------------------- -Value 202 -HTTP Status Code 500 -Description The given ego is invalid or malformed. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_UNKNOWN -------------------- ----------------------------------------------------------- -Value 5000 -HTTP Status Code 500 -Description Unknown namestore error. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_ITERATION_FAILED -------------------- ----------------------------------------------------------- -Value 5001 -HTTP Status Code 500 -Description Zone iteration failed. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_ZONE_NOT_FOUND -------------------- ----------------------------------------------------------- -Value 5002 -HTTP Status Code 404 -Description Zone not found. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_RECORD_NOT_FOUND -------------------- ----------------------------------------------------------- -Value 5003 -HTTP Status Code 404 -Description Record not found. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_RECORD_DELETE_FAILED -------------------- ----------------------------------------------------------- -Value 5004 -HTTP Status Code 500 -Description Zone iteration failed. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_ZONE_EMPTY -------------------- ----------------------------------------------------------- -Value 5005 -HTTP Status Code 404 -Description Zone does not contain any records. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_LOOKUP_ERROR -------------------- ----------------------------------------------------------- -Value 5006 -HTTP Status Code 500 -Description Failed to lookup record. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_NO_RECORDS_GIVEN -------------------- ----------------------------------------------------------- -Value 5007 -HTTP Status Code 400 -Description No records given. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_RECORD_DATA_INVALID -------------------- ----------------------------------------------------------- -Value 5008 -HTTP Status Code 400 -Description Record data invalid. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_NO_LABEL_GIVEN -------------------- ----------------------------------------------------------- -Value 5009 -HTTP Status Code 400 -Description No label given. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_NO_RESULTS -------------------- ----------------------------------------------------------- -Value 5010 -HTTP Status Code 404 -Description No results given. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_RECORD_EXISTS -------------------- ----------------------------------------------------------- -Value 5011 -HTTP Status Code 409 -Description Record already exists. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_RECORD_TOO_BIG -------------------- ----------------------------------------------------------- -Value 5012 -HTTP Status Code 500 -Description Record size exceeds maximum limit. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_BACKEND_FAILED -------------------- ----------------------------------------------------------- -Value 5013 -HTTP Status Code 500 -Description There was an error in the database backend. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_STORE_FAILED -------------------- ----------------------------------------------------------- -Value 5014 -HTTP Status Code 500 -Description Failed to store the given records. -=================== =========================================================== - - - -=================== =========================================================== -Name GNUNET_EC_NAMESTORE_LABEL_INVALID -------------------- ----------------------------------------------------------- -Value 5015 -HTTP Status Code 400 -Description Label invalid or malformed. -=================== =========================================================== - diff --git a/gana/gnunet_signatures.rst b/gana/gnunet_signatures.rst @@ -1,334 +0,0 @@ -GNUnet Signature Purposes -------------------------- - - - - -=================== =========================================================== -Name TEST -------------------- ----------------------------------------------------------- -Number 0 -Subsystem GNUnet -Comment Test signature, not valid for anything other than writing a test. (Note that the signature verification code will accept this value). -=================== =========================================================== - - - -=================== =========================================================== -Name TRANSPORT_PONG_OWN -------------------- ----------------------------------------------------------- -Number 1 -Subsystem GNUnet-TRANSPORT -Comment Signature for confirming that this peer uses a particular address. -=================== =========================================================== - - - -=================== =========================================================== -Name TRANSPORT_DISCONNECT -------------------- ----------------------------------------------------------- -Number 2 -Subsystem GNUnet-TRANSPORT -Comment Signature for confirming that this peer intends to disconnect. -=================== =========================================================== - - - -=================== =========================================================== -Name GNS_REVOCATION -------------------- ----------------------------------------------------------- -Number 3 -Subsystem GNS -Comment GNS zone key revocation -=================== =========================================================== - - - -=================== =========================================================== -Name NAMESPACE_ADVERTISEMENT -------------------- ----------------------------------------------------------- -Number 4 -Subsystem GNUnet-FS -Comment Signature for a namespace/pseudonym advertisement (by the namespace owner). -=================== =========================================================== - - - -=================== =========================================================== -Name PEER_PLACEMENT -------------------- ----------------------------------------------------------- -Number 5 -Subsystem GNUnet-FS -Comment Signature by which a peer affirms that it is providing a certain bit of content for use in LOCation URIs. -=================== =========================================================== - - - -=================== =========================================================== -Name DHT_HOP -------------------- ----------------------------------------------------------- -Number 6 -Subsystem GNUnet-DHT -Comment Signature by which a peer affirms that it forwarded a message in the DHT. -=================== =========================================================== - - - -=================== =========================================================== -Name HELLO -------------------- ----------------------------------------------------------- -Number 7 -Subsystem GNUnet-HELLO -Comment Signature by which a peer affirms its address. -=================== =========================================================== - - - -=================== =========================================================== -Name DNS_RECORD -------------------- ----------------------------------------------------------- -Number 11 -Subsystem GNUnet-DNS+Exit -Comment Signature on a GNUNET_DNS_Advertisement. -=================== =========================================================== - - - -=================== =========================================================== -Name CHAT_MESSAGE -------------------- ----------------------------------------------------------- -Number 12 -Subsystem GNUnet-MESSENGER -Comment Signature of a chat message. -=================== =========================================================== - - - -=================== =========================================================== -Name CHAT_RECEIPT -------------------- ----------------------------------------------------------- -Number 13 -Subsystem GNUnet-MESSENGER -Comment Signature of confirmation receipt for a chat message. -=================== =========================================================== - - - -=================== =========================================================== -Name NSE_SEND -------------------- ----------------------------------------------------------- -Number 14 -Subsystem GNUnet-NSE -Comment Signature of a network size estimate message. -=================== =========================================================== - - - -=================== =========================================================== -Name GNS_RECORD_SIGN -------------------- ----------------------------------------------------------- -Number 15 -Subsystem GNS -Comment GNS record set signature -=================== =========================================================== - - - -=================== =========================================================== -Name SET_ECC_KEY -------------------- ----------------------------------------------------------- -Number 16 -Subsystem GNUnet-CORE -Comment Purpose is to set a session key. -=================== =========================================================== - - - -=================== =========================================================== -Name FS_UBLOCK -------------------- ----------------------------------------------------------- -Number 17 -Subsystem GNUnet-FS -Comment UBlock Signature, done using DSS, not ECC -=================== =========================================================== - - - -=================== =========================================================== -Name REGEX_ACCEPT -------------------- ----------------------------------------------------------- -Number 18 -Subsystem GNUnet-REGEX -Comment Accept state in regex DFA. Peer affirms that it offers the matching service. -=================== =========================================================== - - - -=================== =========================================================== -Name CONVERSATION_RING -------------------- ----------------------------------------------------------- -Number 20 -Subsystem GNUnet-CONVERSATION -Comment Signature of a conversation ring. -=================== =========================================================== - - - -=================== =========================================================== -Name SECRETSHARING_DKG1 -------------------- ----------------------------------------------------------- -Number 21 -Subsystem GNUnet-SECRETSHARING -Comment Signature for the first round of distributed key generation. -=================== =========================================================== - - - -=================== =========================================================== -Name SECRETSHARING_DKG2 -------------------- ----------------------------------------------------------- -Number 22 -Subsystem GNUnet-SECRETSHARING -Comment Signature for the second round of distributed key generation. -=================== =========================================================== - - - -=================== =========================================================== -Name SECRETSHARING_DECRYPTION -------------------- ----------------------------------------------------------- -Number 23 -Subsystem GNUnet-SECRETSHARING -Comment Signature for the cooperative decryption. -=================== =========================================================== - - - -=================== =========================================================== -Name RECLAIM_CODE_SIGN -------------------- ----------------------------------------------------------- -Number 27 -Subsystem Reclaim -Comment Signature for a GNUid Ticket -=================== =========================================================== - - - -=================== =========================================================== -Name DELEGATE -------------------- ----------------------------------------------------------- -Number 28 -Subsystem Reclaim -Comment Signature for a GNUnet credential -=================== =========================================================== - - - -=================== =========================================================== -Name TRANSPORT_ADDRESS -------------------- ----------------------------------------------------------- -Number 29 -Subsystem GNUnet-TRANSPORT -Comment Signature by a peer affirming that this is one of its addresses for the given time period. -=================== =========================================================== - - - -=================== =========================================================== -Name TRANSPORT_EPHEMERAL -------------------- ----------------------------------------------------------- -Number 30 -Subsystem GNUnet-TRANSPORT -Comment Signature by a peer affirming that the given ephemeral key is currently in use by that peer's transport service. -=================== =========================================================== - - - -=================== =========================================================== -Name COMMUNICATOR_TCP_HANDSHAKE -------------------- ----------------------------------------------------------- -Number 31 -Subsystem GNUnet-TRANSPORT-TCP -Comment Signature used by TCP communicator handshake. -=================== =========================================================== - - - -=================== =========================================================== -Name COMMUNICATOR_TCP_REKEY -------------------- ----------------------------------------------------------- -Number 32 -Subsystem GNUnet-TRANSPORT-TCP -Comment Signature used by TCP communicator rekey. -=================== =========================================================== - - - -=================== =========================================================== -Name COMMUNICATOR_UDP_HANDSHAKE -------------------- ----------------------------------------------------------- -Number 33 -Subsystem GNUnet-TRANSPORT-UDP -Comment Signature used by UDP communicator handshake. -=================== =========================================================== - - - -=================== =========================================================== -Name COMMUNICATOR_UDP_BROADCAST -------------------- ----------------------------------------------------------- -Number 34 -Subsystem GNUnet-TRANSPORT-UDP -Comment Signature used by UDP broadcasts. -=================== =========================================================== - - - -=================== =========================================================== -Name TRANSPORT_CHALLENGE -------------------- ----------------------------------------------------------- -Number 35 -Subsystem GNUnet-TRANSPORT -Comment Signature by a peer affirming that it received a challenge (and stating how long it expects the address on which the challenge was received to remain valid). -=================== =========================================================== - - - -=================== =========================================================== -Name TRANSPORT_DV_HOP -------------------- ----------------------------------------------------------- -Number 36 -Subsystem GNUnet-TRANSPORT -Comment Signature by a peer affirming that it is on a DV path. -=================== =========================================================== - - - -=================== =========================================================== -Name TRANSPORT_DV_INITIATOR -------------------- ----------------------------------------------------------- -Number 37 -Subsystem GNUnet-TRANSPORT -Comment Signature by a peer affirming that it originated the DV path. -=================== =========================================================== - - - -=================== =========================================================== -Name CADET_CONNECTION_INITIATOR -------------------- ----------------------------------------------------------- -Number 38 -Subsystem GNUnet-CADET -Comment Signature by a peer that like to create a connection. -=================== =========================================================== - - - -=================== =========================================================== -Name COMMUNICATOR_TCP_HANDSHAKE_ACK -------------------- ----------------------------------------------------------- -Number 39 -Subsystem GNUnet-TRANSPORT-TCP -Comment Signature by a peer sending back the nonce received at initial handshake. -=================== =========================================================== - diff --git a/gana/index.rst b/gana/index.rst @@ -1,19 +0,0 @@ -.. _GANA: - -GANA -==== - -.. include:: intro.rst - -Registries ----------- - -.. toctree:: - - gnunet_error_codes - gnu_name_system_record_types - gnu_name_system_record_flags - gnunet_dht_block_types - gnunet_signatures - dot_alt - tlds diff --git a/gana/intro.rst b/gana/intro.rst @@ -1,49 +0,0 @@ -The GNUnet Assigned Numbers Authority (GANA) contains various registries -we maintain, for GNUnet other projects that need names and numbers for -use in network protocols. If you need to open a new registry, please -feel free to contact us at gana@gnunet.org. - -The registries can be found here: https://git.gnunet.org/gana.git - -History -------- - -Barry Leiba wrote on April 4th 2020 that “Neither IANA nor participants -in the IETF will have any necessary expertise to evaluate registration -requests in the sort of registry described, and no one will be well -served by the creation of such a registry at IANA. It would be far -better to have a registration process be described in this document -involving experts from the industry as reviewers and maintenance of the -registrations by an industry organization, rather than by IANA.” - -So here we are. As IETF/IANA “lack the necessary expertise to operate a -registry” for names and numbers used in network protocols, the GNUnet -project is happy to step up. - -License -------- - -The GANA database is licensed under the GPL. See ``COPYING`` in the Git -repository. - -Design ------- - -Each registry must have a unique name and all associated information -lives in a directory under that unique name in the Git repository. - -Each registry must include at least the following files: - -- ``README[.*]``: document describing the purpose of the registry in - English -- ``POLICY[.*]``: registration policy, explaining required fields and - the procedure for adding, updating and deleting entries -- ``registry.rec``: GNU recutils data file with all of the current - entries in the registry -- ``Makefile``: GNU make makefile with a ``make check`` target to run - the validation logic. Ideally, the registry.rec should be written - such that the ``check`` target is simply invoking - ``recfix --check registry.rec``. Additional targets to convert - ``data.rec`` to various formats may be defined. In particular, see - ``format.sh`` in the root directory of the Git repository (try - ``--help``). diff --git a/gana/tlds.rst b/gana/tlds.rst @@ -1,22 +0,0 @@ -GNS Default Top-Level-Domains ------------------------------ - - - - -=================== =========================================================== -Suffix pin -------------------- ----------------------------------------------------------- -Zone Key 000G001MF6DVMZZ4Y8XRZQDXM1PB3D3VGEK29ZHXBA57EPSNW1QBPKT8J0 -Comment The FCFS authority managed by GNUnet e.V. -=================== =========================================================== - - - -=================== =========================================================== -Suffix gnunet.org -------------------- ----------------------------------------------------------- -Zone Key 000G0047M3HN599H57MPXZK4VB59SWK4M9NRD68E1JQFY3RWAHDMKAPN30 -Comment The authoritative zone of the GNUnet project -=================== =========================================================== - diff --git a/index.rst b/index.rst @@ -10,7 +10,7 @@ Welcome to GNUnet’s documentation! users/index developers/index livingstandards - gana/index + GANA <https://gana.gnunet.org> guis/index faq Bibliography <https://bib.gnunet.org>