aboutsummaryrefslogtreecommitdiff
path: root/doc/man/gnunet-dns2gns.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man/gnunet-dns2gns.1')
-rw-r--r--doc/man/gnunet-dns2gns.120
1 files changed, 3 insertions, 17 deletions
diff --git a/doc/man/gnunet-dns2gns.1 b/doc/man/gnunet-dns2gns.1
index 03f471ed8..04fcb7f53 100644
--- a/doc/man/gnunet-dns2gns.1
+++ b/doc/man/gnunet-dns2gns.1
@@ -1,4 +1,4 @@
1.TH GNUNET\-DNS2GNS 1 "Oct 25, 2012" "GNUnet" 1.TH GNUNET\-DNS2GNS 1 "March 5, 2018" "GNUnet"
2 2
3.SH NAME 3.SH NAME
4gnunet\-dns2gns \- run a DNS-to-GNS proxy 4gnunet\-dns2gns \- run a DNS-to-GNS proxy
@@ -9,13 +9,9 @@ gnunet\-dns2gns \- run a DNS-to-GNS proxy
9.br 9.br
10 10
11.SH DESCRIPTION 11.SH DESCRIPTION
12Most users will not want to run an DNS to GADS proxy/gateway and thus will not need this program. 12Most users will not want to run an DNS to GNS proxy/gateway and thus will not need this program.
13 13
14\fBgnunet\-dns2gns\fP runs a DNS resolver which delegates requests to the ".gads" and ".zkey" zones to GADS. All other requests are forwarded to DNS. This DNS proxy is useful for enabling non-personalized GADS\-resolution to an entire network or to offer GADS\-resolution to DNS users. 14\fBgnunet\-dns2gns\fP runs a DNS resolver which delegates requests GNS if the TLD matches one configured for GNS. All other requests are forwarded to DNS. This DNS proxy is useful for enabling non-personalized GNS\-resolution to an entire network or to offer GNS\-resolution to DNS users.
15
16A DNS\-to\-GNS proxy using gnunet\-dns2gns is available at ".zkey.eu"
17
18If you do not want to specify a public key and are the owner of the zone that gnunet\-dns2gns will use for GNS lookups, you need to first create a pseudonym (using "gnunet\-identity \-C NAME"), and then assign it to be used for the "dns2gns" service using "gnunet\-identity \-e NAME \-s dns2gns". After that, you can start the dns2gns service (possibly using gnunet\-arm) without specifying a public key using "\-z".
19 15
20.SH OPTIONS 16.SH OPTIONS
21.B 17.B
@@ -25,24 +21,14 @@ Use the configuration file FILENAME.
25.IP "\-d IP, \-\-dns=IP" 21.IP "\-d IP, \-\-dns=IP"
26IP address of a recursive DNS resolver that should be used for non-GADS hostnames. 22IP address of a recursive DNS resolver that should be used for non-GADS hostnames.
27.B 23.B
28.IP "\-f NAME, \-\-fcfs=NAME"
29Authoritative FCFS suffix to use. This is the name under which the local zone's names will be made available. Default is "fcfs.zkey.eu".
30.B
31.IP "\-h, \-\-help" 24.IP "\-h, \-\-help"
32Print short help on options. 25Print short help on options.
33.B 26.B
34.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL" 27.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
35Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and ERROR. 28Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and ERROR.
36.B 29.B
37.IP "\-s SUFFIX, \-\-suffix=SUFFIX"
38Authoritative DNS suffix to use. This is the name under which the GADS ".zkey" zone is mapped into the DNS namespace. Default is "zkey.eu".
39.B
40.IP "\-v, \-\-version" 30.IP "\-v, \-\-version"
41Print GNUnet version number. 31Print GNUnet version number.
42.B
43.IP "\-z PUBLICKEY, \-\-zone=PUBLICKEY"
44Use PUBLICKEY for the zone to resolve GNS names in. The PUBLICKEY must be encoded in the text format which can be obtained using gnunet\-ecc, seen in PKEY records and output by gnunet\-identity. If this option is not specified, the default ego associated by gnunet\-identity for the "dns2gns" subsystem will be used.
45
46 32
47.SH BUGS 33.SH BUGS
48Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <bug\-gnunet@gnu.org> 34Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <bug\-gnunet@gnu.org>