make html in doc/man using mandoc (sans Toc feature)
[oweals/gnunet.git] / doc / man / gnunet-dns2gns.1
1 .TH GNUNET\-DNS2GNS 1 "March 5, 2018" "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 GNS proxy/gateway and thus will not
13 need this program.
14
15 \fBgnunet\-dns2gns\fP runs a DNS resolver which delegates requests GNS if
16 the TLD matches one configured for GNS.  All other requests are forwarded
17 to DNS.  This DNS proxy is useful for enabling non-personalized
18 GNS\-resolution to an entire network or to offer GNS\-resolution to DNS users.
19
20 .SH OPTIONS
21 .IP "\-c FILENAME,  \-\-config=FILENAME"
22 Use the configuration file FILENAME.
23 .IP "\-d IP,  \-\-dns=IP"
24 IP address of a recursive DNS resolver that should be used for non-GADS hostnames.
25 .IP "\-h, \-\-help"
26 Print short help on options.
27 .IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
28 Use LOGLEVEL for logging.  Valid values are DEBUG, INFO, WARNING and ERROR.
29 .IP "\-v, \-\-version"
30 Print GNUnet version number.
31
32 .SH BUGS
33 Report bugs by using Mantis <https://bugs.gnunet.org/> or by sending
34 electronic mail to <bug\-gnunet@gnu.org>
35 .SH SEE ALSO
36 gnunet\-gns\-fcfs(1), gnunet\-gns(1), gnunet\-identity(1)
37 The full documentation for
38 .B gnunet
39 is maintained as a Texinfo manual.  If the
40 .B info
41 and
42 .B gnunet
43 programs are properly installed at your site, the command
44 .IP
45 .B info gnunet
46 .PP
47 should give you access to the complete handbook,
48 .IP
49 .B info gnunet-c-tutorial
50 .PP
51 will give you access to a tutorial for developers.
52 .PP
53 Depending on your installation, this information is also
54 available in
55 \fBgnunet\fP(7) and \fBgnunet-c-tutorial\fP(7).