diff options
author | Christian Grothoff <christian@grothoff.org> | 2018-03-03 22:42:17 +0100 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2018-03-03 22:42:17 +0100 |
commit | 1f46cd73049570f21ff47cd3ee81ea88da45af07 (patch) | |
tree | 45052a73ba578a02172d7f8d7011604cf810f82e /doc/documentation | |
parent | bee1fc336bad21e456907eb9e6c35dc195b9a7e9 (diff) | |
download | gnunet-1f46cd73049570f21ff47cd3ee81ea88da45af07.tar.gz gnunet-1f46cd73049570f21ff47cd3ee81ea88da45af07.zip |
update developer manual to match GNS changes
Diffstat (limited to 'doc/documentation')
-rw-r--r-- | doc/documentation/chapters/developer.texi | 23 |
1 files changed, 13 insertions, 10 deletions
diff --git a/doc/documentation/chapters/developer.texi b/doc/documentation/chapters/developer.texi index 41db89df8..c7d7ddaac 100644 --- a/doc/documentation/chapters/developer.texi +++ b/doc/documentation/chapters/developer.texi | |||
@@ -6479,7 +6479,7 @@ Sets are modified with the @code{GNUNET_SERVICE_SET_ADD} and | |||
6479 | @c %@menu | 6479 | @c %@menu |
6480 | @c %* Results and Operation Status:: | 6480 | @c %* Results and Operation Status:: |
6481 | @c %* Iterating Sets:: | 6481 | @c %* Iterating Sets:: |
6482 | @c %@end menu | 6482 | @c %@end menu |
6483 | 6483 | ||
6484 | @node Results and Operation Status | 6484 | @node Results and Operation Status |
6485 | @subsubsection Results and Operation Status | 6485 | @subsubsection Results and Operation Status |
@@ -7307,8 +7307,9 @@ to securely resolve names to values. | |||
7307 | Names can be used to identify other users (for example, in social | 7307 | Names can be used to identify other users (for example, in social |
7308 | networking), or network services (for example, VPN services running at a | 7308 | networking), or network services (for example, VPN services running at a |
7309 | peer in GNUnet, or purely IP-based services on the Internet). | 7309 | peer in GNUnet, or purely IP-based services on the Internet). |
7310 | Users interact with GNS by typing in a hostname that ends in ".gnu" | 7310 | Users interact with GNS by typing in a hostname that ends in a |
7311 | or ".zkey". | 7311 | top-level domain that is configured in the ``GNS'' section, matches |
7312 | an identity of the user or ends in a Base32-encoded public key. | ||
7312 | 7313 | ||
7313 | Videos giving an overview of most of the GNS and the motivations behind | 7314 | Videos giving an overview of most of the GNS and the motivations behind |
7314 | it is available here and here. | 7315 | it is available here and here. |
@@ -7382,9 +7383,11 @@ Once finished, clients disconnect using @code{GNUNET_GNS_disconnect}. | |||
7382 | be resolved. This can be any valid DNS or GNS hostname. | 7383 | be resolved. This can be any valid DNS or GNS hostname. |
7383 | @item zone The client | 7384 | @item zone The client |
7384 | needs to specify the public key of the GNS zone against which the | 7385 | needs to specify the public key of the GNS zone against which the |
7385 | resolution should be done (the ".gnu" zone). | 7386 | resolution should be done. |
7386 | Note that a key must be provided, even if the name ends in ".zkey". | 7387 | Note that a key must be provided, the client should |
7387 | This should typically be the public key of the master-zone of the user. | 7388 | look up plausible values using its configuration, |
7389 | the identity service and by attempting to interpret the | ||
7390 | TLD as a base32-encoded public key. | ||
7388 | @item type This is the desired GNS or DNS record type | 7391 | @item type This is the desired GNS or DNS record type |
7389 | to look for. While all records for the given name will be returned, this | 7392 | to look for. While all records for the given name will be returned, this |
7390 | can be important if the client wants to resolve record types that | 7393 | can be important if the client wants to resolve record types that |
@@ -7569,8 +7572,8 @@ Using a second routing table in the Linux kernel these marked packets are | |||
7569 | then routed through our virtual network interface and can thus be | 7572 | then routed through our virtual network interface and can thus be |
7570 | captured unchanged. | 7573 | captured unchanged. |
7571 | 7574 | ||
7572 | Our application then reads the query and decides how to handle it: A | 7575 | Our application then reads the query and decides how to handle it. |
7573 | query to an address ending in ".gnu" or ".zkey" is hijacked by | 7576 | If the query can be addressed via GNS, it is passed to |
7574 | @code{gnunet-service-gns} and resolved internally using GNS. | 7577 | @code{gnunet-service-gns} and resolved internally using GNS. |
7575 | In the future, a reverse query for an address of the configured virtual | 7578 | In the future, a reverse query for an address of the configured virtual |
7576 | network could be answered with records kept about previous forward | 7579 | network could be answered with records kept about previous forward |
@@ -7638,8 +7641,8 @@ w32nsp-uninstall), as described in "Installation Handbook". | |||
7638 | 7641 | ||
7639 | libw32nsp is very simple and has almost no dependencies. As a response to | 7642 | libw32nsp is very simple and has almost no dependencies. As a response to |
7640 | NSPLookupServiceBegin(), it only checks that the provider GUID passed to | 7643 | NSPLookupServiceBegin(), it only checks that the provider GUID passed to |
7641 | it by the caller matches GNUnet DNS Provider GUID, checks that name being | 7644 | it by the caller matches GNUnet DNS Provider GUID, |
7642 | resolved ends in ".gnu" or ".zkey", then connects to | 7645 | then connects to |
7643 | gnunet-gns-helper-service-w32 at 127.0.0.1:5353 (hardcoded) and sends the | 7646 | gnunet-gns-helper-service-w32 at 127.0.0.1:5353 (hardcoded) and sends the |
7644 | name resolution request there, returning the connected socket to the | 7647 | name resolution request there, returning the connected socket to the |
7645 | caller. | 7648 | caller. |