1 .TH GNUNET\-NAMESTORE 1 "Apr 15, 2014" "GNUnet"
4 gnunet\-namestore \- manipulate GNU Name System (GNS) zone data
8 .RI [ options ] -z ZONEFILE
12 \fBgnunet\-namestore\fP can be used to manipulate records in a GNS zone.
17 Desired operation is adding a record
19 .IP "\-c FILENAME, \-\-config=FILENAME"
20 Use the configuration file FILENAME.
23 Desired operation is deleting records under the given name that match
24 the specified type (\-t) and value (\-V). If type or value are not
25 specified, it means that all types (or values) should be assumed to
26 match (and possibly multiple or all values under the given label will
27 be deleted). Specifying a label (\-n) is mandatory. Note that
28 matching by expiration time or flags is (currently) not supported.
30 .IP "\-D, \-\-display"
31 Desired operation is listing of matching records
33 .IP "\-e TIME, \-\-expiration=TIME"
34 Specifies expiration time of record to add; format is relative time,
35 i.e "1 h" or "7 d 30 m". Supported units are "ms", "s", "min" or
36 "minutes", "h" (hours), "d" (days) and "a" (years).
39 Print short help on options.
41 .IP "\-i NICKNAME, \-\-nick=NICKNAME"
42 Set the desired NICKNAME for the zone. The nickname will be included
43 in all (public) records and used as the suggested name for this zone.
45 .IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
46 Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and
49 .IP "\-m, \-\-monitor"
50 Monitor changes to the zone on an ongoing basis (in contrast to \-D,
51 which merely displays the current records)
53 .IP "\-n NAME, \-\-name=NAME"
54 Label or name of the record to add/delete/display
57 Create a record that is public (shared with other users that know the
60 .IP "\-r PKEY, \-\-reverse=PKEY"
61 Determine our GNS name for the given public key (reverse lookup of the
62 PKEY) in the given zone.
65 Create a record that is a shadow record. Shadow records are only used
66 once all other records of the same type under the same label have
69 .IP "\-t TYPE, \-\-type=TYPE"
70 Type of the record to add/delete/display (i.e. "A", "AAAA", "NS",
73 .IP "\-u URI, \-\-uri=URI"
74 Add PKEY record from gnunet://gns/-URI to our zone; the record type is
75 always PKEY, if no expiration is given FOREVER is used
77 .IP "\-v, \-\-version"
78 Print GNUnet version number.
80 .IP "\-V VALUE, \-\-value=VALUE"
81 Value to store or remove from the GNS zone. Specific format depends
82 on the record type. A records expect a dotted decimal IPv4 address,
83 AAAA records an IPv6 address, PKEY a public key in GNUnet's printable
84 format, and CNAME and NS records should be a domain name.
86 .IP "\-z EGO, \-\-zone=EGO"
87 Specifies the name of the ego controlling the private key for the zone
92 Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org>
94 \fBgnunet\-gns\fP(1), \fBgnunet\-namestore\-gtk\fP(1)
95 The full documentation for
97 is maintained as a Texinfo manual. If the
101 programs are properly installed at your site, the command
105 should give you access to the complete handbook,
107 .B info gnunet-c-tutorial
109 will give you access to a tutorial for developers.
111 Depending on your installation, this information is also
113 \fBgnunet\fP(7) and \fBgnunet-c-tutorial\fP(7).