aboutsummaryrefslogtreecommitdiff
path: root/doc/man/gnunet-dns2gns.1
blob: 03f471ed81026163d0e97cd3f439923f5e1555b3 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
.TH GNUNET\-DNS2GNS 1 "Oct 25, 2012" "GNUnet"

.SH NAME
gnunet\-dns2gns \- run a DNS-to-GNS proxy

.SH SYNOPSIS
.B gnunet\-dns2gns
.RI [ options ]
.br

.SH DESCRIPTION
Most users will not want to run an DNS to GADS proxy/gateway and thus will not need this program.

\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.

A DNS\-to\-GNS proxy using gnunet\-dns2gns is available at ".zkey.eu"

If 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".

.SH OPTIONS
.B
.IP "\-c FILENAME,  \-\-config=FILENAME"
Use the configuration file FILENAME.
.B
.IP "\-d IP,  \-\-dns=IP"
IP address of a recursive DNS resolver that should be used for non-GADS hostnames.
.B
.IP "\-f NAME,  \-\-fcfs=NAME"
Authoritative FCFS suffix to use.  This is the name under which the local zone's names will be made available.  Default is "fcfs.zkey.eu".
.B
.IP "\-h, \-\-help"
Print short help on options.
.B
.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
Use LOGLEVEL for logging.  Valid values are DEBUG, INFO, WARNING and ERROR.
.B
.IP "\-s SUFFIX,  \-\-suffix=SUFFIX"
Authoritative DNS suffix to use.  This is the name under which the GADS ".zkey" zone is mapped into the DNS namespace.  Default is "zkey.eu".
.B
.IP "\-v, \-\-version"
Print GNUnet version number.
.B
.IP "\-z PUBLICKEY, \-\-zone=PUBLICKEY"
Use 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.


.SH BUGS
Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <bug\-gnunet@gnu.org>

.SH SEE ALSO
gnunet\-gns\-fcfs(1), gnunet\-gns(1), gnunet\-identity(1)