diff options
author | Martin Schanzenbach <schanzen@gnunet.org> | 2022-02-05 20:28:55 +0100 |
---|---|---|
committer | Martin Schanzenbach <schanzen@gnunet.org> | 2022-02-05 20:28:55 +0100 |
commit | a3563c94b702719db253b05dab99b2783e35a0de (patch) | |
tree | b8f810e704afc3743f8ca75ad1f08e1a6af029c5 /doc | |
parent | 2c3a47c48049f78a9ce467f21dff20ae3a0ae494 (diff) | |
download | gnunet-a3563c94b702719db253b05dab99b2783e35a0de.tar.gz gnunet-a3563c94b702719db253b05dab99b2783e35a0de.zip |
-update handbook
Diffstat (limited to 'doc')
-rw-r--r-- | doc/handbook/chapters/user.texi | 29 |
1 files changed, 24 insertions, 5 deletions
diff --git a/doc/handbook/chapters/user.texi b/doc/handbook/chapters/user.texi index aa912f96f..0b44ab57c 100644 --- a/doc/handbook/chapters/user.texi +++ b/doc/handbook/chapters/user.texi | |||
@@ -1561,6 +1561,9 @@ The GNS currently supports the record types as defined in | |||
1561 | @uref{https://git.gnunet.org/gana.git/tree/gnu-name-system-record-types/registry.rec, GANA}. | 1561 | @uref{https://git.gnunet.org/gana.git/tree/gnu-name-system-record-types/registry.rec, GANA}. |
1562 | In addition, GNS supports DNS record types, such as A, AAAA or TXT. | 1562 | In addition, GNS supports DNS record types, such as A, AAAA or TXT. |
1563 | 1563 | ||
1564 | For a complete description of the records, please refer to the specification | ||
1565 | at @uref{https://lsd.gnunet.org/lsd0001, LSD0001}. | ||
1566 | |||
1564 | In the following, we discuss GNS records with specific behaviour or special | 1567 | In the following, we discuss GNS records with specific behaviour or special |
1565 | handling of DNS records. | 1568 | handling of DNS records. |
1566 | 1569 | ||
@@ -1570,8 +1573,9 @@ handling of DNS records. | |||
1570 | * BOX:: | 1573 | * BOX:: |
1571 | * LEHO:: | 1574 | * LEHO:: |
1572 | * VPN:: | 1575 | * VPN:: |
1573 | * CNAME:: | 1576 | * REDIRECT:: |
1574 | * GNS2DNS:: | 1577 | * GNS2DNS:: |
1578 | * TOMBSTONE:: | ||
1575 | * SOA SRV PTR and MX:: | 1579 | * SOA SRV PTR and MX:: |
1576 | @end menu | 1580 | @end menu |
1577 | 1581 | ||
@@ -1668,11 +1672,11 @@ having the following lines in the @file{gnunet.conf} configuration file: | |||
1668 | TCP_REDIRECTS = 80:localhost4:8080 | 1672 | TCP_REDIRECTS = 80:localhost4:8080 |
1669 | @end example | 1673 | @end example |
1670 | 1674 | ||
1671 | @node CNAME | 1675 | @node REDIRECT |
1672 | @subsubsection CNAME | 1676 | @subsubsection REDIRECT |
1673 | 1677 | ||
1674 | As specified in RFC 1035 whenever a CNAME is encountered the query | 1678 | As specified in LSD0001 whenever a REDIRECT is encountered the query |
1675 | needs to be restarted with the specified name. In GNS a CNAME | 1679 | needs to be restarted with the specified name. A REDIRECT |
1676 | can either be: | 1680 | can either be: |
1677 | 1681 | ||
1678 | @itemize @bullet | 1682 | @itemize @bullet |
@@ -1721,6 +1725,21 @@ However, imagine the nameserver was "ns.gnunet.org". In this case, | |||
1721 | delegating to "ns.gnunet.org" would mean that despite using GNS, | 1725 | delegating to "ns.gnunet.org" would mean that despite using GNS, |
1722 | censorship in the DNS ".org" zone would still be effective. | 1726 | censorship in the DNS ".org" zone would still be effective. |
1723 | 1727 | ||
1728 | @node TOMBSTONE | ||
1729 | @subsubsection TOMBSTONE | ||
1730 | |||
1731 | The GNUnet GNS implementation uses the TOMBSTONE record to ensure | ||
1732 | ciphertext indistinguishability for published records. | ||
1733 | It must be ensured that when relative expiration times are decreased, the | ||
1734 | expiration time of the next record block MUST be after the last published block. | ||
1735 | A similar issue arises if the record set under a label is deleted and reused | ||
1736 | later. | ||
1737 | |||
1738 | The creation and maintenance of the TOMBSTONE record is done automatically. | ||
1739 | You do not need to mind it yourself and can safely ignore any TOMBSTONE | ||
1740 | blocks you may see when investigating your zone(s). | ||
1741 | TOMBSTONE records are always private and will never be published. | ||
1742 | |||
1724 | @node SOA SRV PTR and MX | 1743 | @node SOA SRV PTR and MX |
1725 | @subsubsection SOA SRV PTR and MX | 1744 | @subsubsection SOA SRV PTR and MX |
1726 | 1745 | ||