syntax
[oweals/gnunet.git] / doc / man / gnunet-dns2gns.1
1 .Dd March 5, 2018
2 .Dt GNUNET-DNS2GNS 1
3 .Os
4 .Sh NAME
5 .Nm gnunet-dns2gns
6 .Nd
7 run a DNS-to-GNS proxy
8 .Sh SYNOPSIS
9 .Nm
10 .Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME
11 .Op Fl d Ar IP | Fl \-dns= Ns Ar IP
12 .Op Fl h | \-help
13 .Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL
14 .Op Fl v | \-version
15 .Sh DESCRIPTION
16 .Nm
17 runs a DNS resolver which delegates requests GNS if the TLD matches one configured for GNS.
18 All other requests are forwarded to DNS.
19 This DNS proxy is useful for enabling non-personalized GNS\-resolution to an entire network or to offer GNS\-resolution to DNS users.
20 .Bl -tag -width Ds
21 .It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME
22 Use the configuration file FILENAME.
23 .It Fl d Ar IP | Fl \-dns= Ns Ar IP
24 IP address of a recursive DNS resolver that should be used for non-GADS hostnames.
25 .It Fl h | \-help
26 Print short help on options.
27 .It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL
28 Use LOGLEVEL for logging.
29 Valid values are DEBUG, INFO, WARNING and ERROR.
30 .It Fl v | \-version
31 Print GNUnet version number.
32 .El
33 .Sh SEE ALSO
34 .Xr gnunet-gns-fcfs 1 ,
35 .Xr gnunet-gns 1 ,
36 .Xr gnunet-identity 1
37 .sp
38 The full documentation for gnunet is maintained as a Texinfo manual.
39 If the
40 .Xr info 1
41 and gnunet programs are properly installed at your site, the command
42 .Pp
43 .Dl info gnunet
44 .Pp
45 should give you access to the complete handbook,
46 .Pp
47 .Dl info gnunet-c-tutorial
48 .Pp
49 will give you access to a tutorial for developers.
50 .sp
51 Depending on your installation, this information is also available in
52 .Xr gnunet 7 and
53 .Xr gnunet-c-tutorial 7 .
54 .\".Sh HISTORY
55 .\".Sh AUTHORS
56 .Sh BUGS
57 Report bugs by using
58 .Lk https://bugs.gnunet.org
59 or by sending electronic mail to
60 .Aq Mt gnunet-developers@gnu.org .