18a4091d0dbae53313d134e3ce3e353ae15b3b5c
[oweals/gnunet.git] / doc / man / gnunet-namestore.1
1 .TH GNUNET\-NAMESTORE 1 "Mar 5, 2012" "GNUnet"
2
3 .SH NAME
4 gnunet\-namestore \- manipulate GNUnet zones
5
6 .SH SYNOPSIS
7 .B gnunet\-namestore
8 .RI [ options ] -z ZONEFILE
9 .br
10
11 .SH DESCRIPTION
12 \fBgnunet\-namestore\fP can be used to create and manipulate a GNS zone.
13
14 .SH OPTIONS
15 .B
16 .IP "\-a, \-\-add"
17 Desired operation is adding a record
18 .B
19 .IP "\-c FILENAME,  \-\-config=FILENAME"
20 Use the configuration file FILENAME.
21 .B
22 .IP "\-d, \-\-delete"
23 Desired operation is deleting all of the records under the given name
24 .B
25 .IP "\-D, \-\-display"
26 Desired operation is listing of matching records
27 .B
28 .IP "\-e TIME, \-\-expiration=TIME"
29 Specifies expiration time of record to add; format is relative time, i.e "1 h" or "7 d 30 m".  Supported units are "ms", "s", "min" or "minutes", "h" (hours), "d" (days) and "a" (years).
30 .B
31 .IP "\-h, \-\-help"
32 Print short help on options.
33 .B
34 .IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
35 Use LOGLEVEL for logging.  Valid values are DEBUG, INFO, WARNING and ERROR.
36 .B
37 .IP "\-m, \-\-monitor"
38 Monitor changes to the zone on an ongoing basis (in contrast to \-D, which merely displays the current records)
39 .B
40 .IP "\-n NAME, \-\-name=NAME"
41 Name of the record to add/delete/display
42 .B
43 .IP "\-t TYPE, \-\-type=TYPE"
44 Type of the record to add/delete/display (i.e. "A", "AAAA", "NS", "PKEY", "MX" etc.)
45 .B
46 .IP "\-u URI, \-\-uri=URI"
47 Add PKEY record from gnunet://gns/-URI to our zone; the record type is always PKEY, if no expiration is given FOREVER is used
48 .B
49 .IP "\-v, \-\-version"
50 Print GNUnet version number.
51 .B
52 .IP "\-V VALUE, \-\-value=VALUE"
53 Value to store or remove from the GNS zone.  Specific format depends on the record type.  A records expect a dotted decimal IPv4 address, AAAA records an IPv6 address, PKEY a public key in GNUnet's printable format, and CNAME and NS records should be a domain name.
54 .B
55 .IP "\-z EGO, \-\-zone=EGO"
56 Specifies the name of the ego controlling the private key for the zone (mandatory option)
57
58
59 .SH BUGS
60 Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org>
61
62
63 .SH "SEE ALSO"
64 \fBgnunet\-gns\fP(1)