updated man page
[oweals/gnunet.git] / doc / man / gnunet-dns2gns.1
1 .TH GNUNET\-DNS2GNS 1 "Oct 25, 2012" "GNUnet"
2
3 .SH NAME
4 gnunet\-dns2gns \- run a DNS-to-GNS proxy
5
6 .SH SYNOPSIS
7 .B gnunet\-dns2gns
8 .RI [ options ]
9 .br
10
11 .SH DESCRIPTION
12 Most users will not want to run an DNS to GADS proxy/gateway and thus will not need this program.
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.  
15
16 A DNS\-to\-GNS proxy using gnunet\-dns2gns is available at ".zkey.eu" 
17
18 .SH OPTIONS
19 .B
20 .IP "\-c FILENAME,  \-\-config=FILENAME"
21 Use the configuration file FILENAME.
22 .B
23 .IP "\-d IP,  \-\-dns=IP"
24 IP address of a recursive DNS resolver that should be used for non-GADS hostnames.
25 .B
26 .IP "\-f NAME,  \-\-fcfs=NAME"
27 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".
28 .B
29 .IP "\-h, \-\-help"
30 Print short help on options.
31 .B
32 .IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
33 Use LOGLEVEL for logging.  Valid values are DEBUG, INFO, WARNING and ERROR.
34 .B
35 .IP "\-s SUFFIX,  \-\-suffix=SUFFIX"
36 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".
37 .B
38 .IP "\-v, \-\-version"
39 Print GNUnet version number.
40
41
42 .SH BUGS
43 Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <bug\-gnunet@gnu.org>
44
45 .SH SEE ALSO
46 gnunet\-gns\-fcfs(1), gnunet\-gns(1)