diff options
Diffstat (limited to 'doc/man/gnunet-zoneimport.1')
-rw-r--r-- | doc/man/gnunet-zoneimport.1 | 29 |
1 files changed, 14 insertions, 15 deletions
diff --git a/doc/man/gnunet-zoneimport.1 b/doc/man/gnunet-zoneimport.1 index f09544912..657038428 100644 --- a/doc/man/gnunet-zoneimport.1 +++ b/doc/man/gnunet-zoneimport.1 | |||
@@ -26,15 +26,14 @@ | |||
26 | .Os | 26 | .Os |
27 | .Sh NAME | 27 | .Sh NAME |
28 | .Nm gnunet-zoneimport | 28 | .Nm gnunet-zoneimport |
29 | .Nd | 29 | .Nd import DNS zone into GNS zone |
30 | import DNS zone into GNS zone | ||
31 | .Sh SYNOPSIS | 30 | .Sh SYNOPSIS |
32 | .Nm | 31 | .Nm |
33 | .Op Fl c Ar FILENAME | \-config= Ns Ar FILENAME | 32 | .Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME |
34 | .Op Fl h | \-help | 33 | .Op Fl h | -help |
35 | .Op Fl m Ar RELATIVETIME | Fl \-minimum-expiration= Ns Ar RELATIVETIME | 34 | .Op Fl m Ar RELATIVETIME | Fl -minimum-expiration= Ns Ar RELATIVETIME |
36 | .Op Fl s Ar MAPSIZE | Fl \-size= Ns Ar MAPSIZE | 35 | .Op Fl s Ar MAPSIZE | Fl -size= Ns Ar MAPSIZE |
37 | .Op Ar \IP | 36 | .Ao Ar IP Ac |
38 | .Sh DESCRIPTION | 37 | .Sh DESCRIPTION |
39 | .Nm | 38 | .Nm |
40 | reads a list of domain names (FQDN) from stdin and issues DNS queries for each of the domain names given. | 39 | reads a list of domain names (FQDN) from stdin and issues DNS queries for each of the domain names given. |
@@ -56,27 +55,27 @@ Thus, it is fine to restart gnunet-zoneimport whenever the list of domain names | |||
56 | Finally, gnunet-zoneimport keeps information for each domain name in memory. | 55 | Finally, gnunet-zoneimport keeps information for each domain name in memory. |
57 | This consumes about 200 bytes per domain name, or 1 GB for 5 million labels. | 56 | This consumes about 200 bytes per domain name, or 1 GB for 5 million labels. |
58 | .Bl -tag -width indent | 57 | .Bl -tag -width indent |
59 | .It Fl c Ar FILENAME | \-config= Ns Ar FILENAME | 58 | .It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME |
60 | Use the configuration file FILENAME. | 59 | Use the configuration file FILENAME. |
61 | .It Fl h | \-help | 60 | .It Fl h | -help |
62 | Print short help on options. | 61 | Print short help on options. |
63 | .It Fl m Ar RELATIVETIME | Fl \-minimum-expiration= Ns Ar RELATIVETIME | 62 | .It Fl m Ar RELATIVETIME | Fl -minimum-expiration= Ns Ar RELATIVETIME |
64 | Ensure that imported DNS records never have an expiration time that is less than RELATIVETIME into the future. | 63 | Ensure that imported DNS records never have an expiration time that is less than RELATIVETIME into the future. |
65 | RELATIVETIME is a time given like "1 week" or "1 h". | 64 | RELATIVETIME is a time given like "1 week" or "1 h". |
66 | If DNS returns records with a shorter lifetime, gnunet\-zoneimport will simply bump the lifetime to the specified value (relative to the time of the import). | 65 | If DNS returns records with a shorter lifetime, gnunet-zoneimport will simply bump the lifetime to the specified value (relative to the time of the import). |
67 | Default is zero. | 66 | Default is zero. |
68 | .It Fl s Ar MAPSIZE | Fl \-size= Ns Ar MAPSIZE | 67 | .It Fl s Ar MAPSIZE | Fl -size= Ns Ar MAPSIZE |
69 | Specifies the size (in number of entries) to use for the main hash map. | 68 | Specifies the size (in number of entries) to use for the main hash map. |
70 | The value provided should be at least twice the number of domain names that will be given to the tool. | 69 | The value provided should be at least twice the number of domain names that will be given to the tool. |
71 | This option is required for very large zones where the number of records encountered is too large for the automatic growth mechanism to work (that one is limited to at most 16 MB allocations for security reasons). | 70 | This option is required for very large zones where the number of records encountered is too large for the automatic growth mechanism to work (that one is limited to at most 16 MB allocations for security reasons). |
72 | Do not worry about this unless you are importing millions of domain names from a zone. | 71 | Do not worry about this unless you are importing millions of domain names from a zone. |
73 | .It Ar \IP | 72 | .It Ao Ar IP Ac |
74 | IP Is the list of IPs given. | 73 | IP Is the list of IPs given. |
75 | .El | 74 | .El |
76 | .Sh EXAMPLES | 75 | .Sh EXAMPLES |
77 | Typical invocaton would be: | 76 | Typical invocation would be: |
78 | .Pp | 77 | .Pp |
79 | .Dl $ gnunet\-zoneimport 1.2.3.4 < names.txt | 78 | .Dl $ gnunet-zoneimport 1.2.3.4 < names.txt |
80 | .Sh SEE ALSO | 79 | .Sh SEE ALSO |
81 | .Xr gnunet-gns 1 , | 80 | .Xr gnunet-gns 1 , |
82 | .Xr gnunet-namestore 1 | 81 | .Xr gnunet-namestore 1 |