Merge remote-tracking branch 'origin/master' into credentials
[oweals/gnunet.git] / doc / man / gnunet-gns.1
1 .TH GNUNET\-GNS 1 "Aug 23, 2013" "GNUnet"
2
3 .SH NAME
4 gnunet\-gns \- Access to GNUnet Name Service
5
6 .SH SYNOPSIS
7 .B gnunet\-gns
8 .RI [ options ]
9 .br
10
11 .SH DESCRIPTION
12 \fBgnunet\-gns\fP can be used to lookup and process GNUnet Name Service names.
13
14 .SH OPTIONS
15 .B
16 .IP "\-c FILENAME,  \-\-config=FILENAME"
17 Use the configuration file FILENAME.
18 .B
19 .IP "\-r, \-\-raw"
20 No unneeded output.
21 This is a quiet mode where only important information is displayed.
22 For example a lookup for an IP address will only yield the IP address, no
23 descriptive text.
24 .B
25 .IP "\-h, \-\-help"
26 Print short help on options.
27 .B
28 .IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
29 Use LOGLEVEL for logging.  Valid values are DEBUG, INFO, WARNING and ERROR.
30 .B
31 .IP "\-u NAME, \-\-lookup=NAME"
32 Name to lookup.
33 Resolve the specified name using the GNUnet Name System.
34 .B
35 .IP "\-p PKEY, \-\-public-key=PKEY"
36 Public key of the zone to perform the lookup in.  This option should be used if the lookup is to be performed against a zone not controlled by this peer (alternatively, you could pass a ".zkey" for the name).
37 .B
38 .IP "\-T DELAY, \-\-timeout=DELAY"
39 Set the timeout to DELAY.  By default, gnunet\-gns will continue to try to resolve the name until there is a definitive answer or until the user aborts with CTRL\-C.
40 .B
41 .IP "\-t TYPE, \-\-type=TYPE"
42 Resource Record Type (TYPE) to look for.
43 Supported TYPE's are: A, AAAA, CNAME, NS, PKEY, PSEU, TLSA, SRV, SOA, MX, LEHO, VPN, REV, PTR, TXT
44
45 Defaults to "A".
46 .B
47 .IP "\-z NAME, \-\-zone=NAME"
48 Name of the ego of the zone to lookup the record in.  The public key associated with the ego will be used for the zone.
49 .B
50 .IP "\-v, \-\-version"
51 Print GNUnet version number.
52 .B
53
54
55 .SH BUGS
56 Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org>
57
58
59 .SH "SEE ALSO"
60 \fBgnunet\-namestore\fP(1), \fBgnunet\-identity\fP(1)