aboutsummaryrefslogtreecommitdiff
path: root/doc/man
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man')
-rw-r--r--doc/man/gnunet-auto-share.148
-rw-r--r--doc/man/gnunet-bcd.120
-rw-r--r--doc/man/gnunet-cadet.148
-rw-r--r--doc/man/gnunet-config.148
-rw-r--r--doc/man/gnunet-conversation-test.118
-rw-r--r--doc/man/gnunet-conversation.130
-rw-r--r--doc/man/gnunet-datastore.12
-rw-r--r--doc/man/gnunet-directory.116
-rw-r--r--doc/man/gnunet-download.148
-rw-r--r--doc/man/gnunet-fs.124
-rw-r--r--doc/man/gnunet-gns-proxy.126
-rw-r--r--doc/man/gnunet-gns.134
-rw-r--r--doc/man/gnunet-identity.12
-rw-r--r--doc/man/gnunet-namecache.124
-rw-r--r--doc/man/gnunet-namestore-fcfsd.120
-rw-r--r--doc/man/gnunet-namestore.16
-rw-r--r--doc/man/gnunet-nat-auto.124
-rw-r--r--doc/man/gnunet-nat-server.122
-rw-r--r--doc/man/gnunet-nat.140
-rw-r--r--doc/man/gnunet-peerinfo.144
-rw-r--r--doc/man/gnunet-publish.186
-rw-r--r--doc/man/gnunet-reclaim.168
-rw-r--r--doc/man/gnunet-resolver.124
-rw-r--r--doc/man/gnunet-revocation.138
-rw-r--r--doc/man/gnunet-scrypt.136
-rw-r--r--doc/man/gnunet-search.146
-rw-r--r--doc/man/gnunet-statistics.158
-rw-r--r--doc/man/gnunet-testbed-profiler.136
-rw-r--r--doc/man/gnunet-testing-run-service.112
-rw-r--r--doc/man/gnunet-testing.140
-rw-r--r--doc/man/gnunet-unindex.120
-rw-r--r--doc/man/gnunet-uri.120
-rw-r--r--doc/man/gnunet-vpn.156
-rw-r--r--doc/man/gnunet-zoneimport.126
34 files changed, 555 insertions, 555 deletions
diff --git a/doc/man/gnunet-auto-share.1 b/doc/man/gnunet-auto-share.1
index 0a0e8f702..0a50de21c 100644
--- a/doc/man/gnunet-auto-share.1
+++ b/doc/man/gnunet-auto-share.1
@@ -30,17 +30,17 @@
30a command line tool to automatically share an entire directory with other users 30a command line tool to automatically share an entire directory with other users
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 33.Op Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 34.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl D | \-disable-extractor 35.Op Fl D | -disable-extractor
36.Op Fl d | \-disable-creation-time 36.Op Fl d | -disable-creation-time
37.Op Fl h | \-help 37.Op Fl h | -help
38.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 38.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
39.Op Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 39.Op Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
40.Op Fl p Ar PRIORITY | Fl \-prio= Ns Ar PRIORITY 40.Op Fl p Ar PRIORITY | Fl -prio= Ns Ar PRIORITY
41.Op Fl r Ar LEVEL | Fl \-replication= Ns Ar LEVEL 41.Op Fl r Ar LEVEL | Fl -replication= Ns Ar LEVEL
42.Op Fl V | \-verbose 42.Op Fl V | -verbose
43.Op Fl v | \-version 43.Op Fl v | -version
44.Ao Ar DIRNAME Ac 44.Ao Ar DIRNAME Ac
45.Sh DESCRIPTION 45.Sh DESCRIPTION
46In order to share files with other GNUnet users, the files must first be made available to GNUnet. 46In order to share files with other GNUnet users, the files must first be made available to GNUnet.
@@ -55,7 +55,7 @@ gnunet-auto-share has many options in common with gnunet-publish, but can only b
55You can use automatic meta-data extraction (based on libextractor). 55You can use automatic meta-data extraction (based on libextractor).
56The options are as follows: 56The options are as follows:
57.Bl -tag -width indent 57.Bl -tag -width indent
58.It Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 58.It Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
59This option can be used to specify additional anonymity constraints. 59This option can be used to specify additional anonymity constraints.
60The default is 1. 60The default is 1.
61If set to 0, GNUnet will publish the file non-anonymously and in fact sign the advertisement for the file using your peer's private key. 61If set to 0, GNUnet will publish the file non-anonymously and in fact sign the advertisement for the file using your peer's private key.
@@ -63,42 +63,42 @@ This will allow other users to download the file as fast as possible, including
63If you set it to 1 (default), you use the standard anonymous routing algorithm (which does not explicitly leak your identity). 63If you set it to 1 (default), you use the standard anonymous routing algorithm (which does not explicitly leak your identity).
64However, a powerful adversary may still be able to perform traffic analysis (statistics) to over time discovery your identity. 64However, a powerful adversary may still be able to perform traffic analysis (statistics) to over time discovery your identity.
65You can gain better privacy by specifying a higher level of anonymity (using values above 1). 65You can gain better privacy by specifying a higher level of anonymity (using values above 1).
66This tells FS that it must hide your own requests in equivalent\-looking cover traffic. 66This tells FS that it must hide your own requests in equivalent-looking cover traffic.
67This should confound an adversaries traffic analysis, increasing the time and effort it would take to discover your identity. 67This should confound an adversaries traffic analysis, increasing the time and effort it would take to discover your identity.
68However, it also can significantly reduce performance, as your requests will be delayed until sufficient cover traffic is available. 68However, it also can significantly reduce performance, as your requests will be delayed until sufficient cover traffic is available.
69The specific numeric value (for anonymity levels above 1) is simple: 69The specific numeric value (for anonymity levels above 1) is simple:
70Given an anonymity level L (above 1), each request FS makes on your behalf must be hidden in L\-1 equivalent requests of cover traffic (traffic your peer routes for others) in the same time-period. 70Given an anonymity level L (above 1), each request FS makes on your behalf must be hidden in L-1 equivalent requests of cover traffic (traffic your peer routes for others) in the same time-period.
71The time-period is twice the average delay by which GNUnet artificially delays traffic. 71The time-period is twice the average delay by which GNUnet artificially delays traffic.
72Note that regardless of the anonymity level you choose, peers that cache content in the network always use anonymity level 1. 72Note that regardless of the anonymity level you choose, peers that cache content in the network always use anonymity level 1.
73.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 73.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
74Use alternate config file (if this option is not specified, the default is 74Use alternate config file (if this option is not specified, the default is
75.Pa ~/.config/gnunet.conf Ns ). 75.Pa ~/.config/gnunet.conf Ns ).
76.It Fl D | \-disable-extractor 76.It Fl D | -disable-extractor
77Disable use of GNU libextractor for finding additional keywords and metadata. 77Disable use of GNU libextractor for finding additional keywords and metadata.
78.It Fl d | \-disable-creation-time 78.It Fl d | -disable-creation-time
79Disable adding the creation time to the metadata of the uploaded file. 79Disable adding the creation time to the metadata of the uploaded file.
80.It Fl h | \-help 80.It Fl h | -help
81Print a brief help page with all the options. 81Print a brief help page with all the options.
82.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 82.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
83Change the loglevel. 83Change the loglevel.
84Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. 84Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
85.It Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 85.It Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
86Configure logging to write logs to FILENAME. 86Configure logging to write logs to FILENAME.
87.It Fl p Ar PRIORITY | Fl \-prio= Ns Ar PRIORITY 87.It Fl p Ar PRIORITY | Fl -prio= Ns Ar PRIORITY
88Executive summary: You probably don't need it. 88Executive summary: You probably don't need it.
89Set the priority of the published content (default: 365). 89Set the priority of the published content (default: 365).
90If the local database is full, GNUnet will discard the content with the lowest ranking. 90If the local database is full, GNUnet will discard the content with the lowest ranking.
91Note that ranks change over time depending on popularity. 91Note that ranks change over time depending on popularity.
92The default should be high enough to preserve the locally published content in favor of content that migrates from other peers. 92The default should be high enough to preserve the locally published content in favor of content that migrates from other peers.
93.It Fl r Ar LEVEL | Fl \-replication= Ns Ar LEVEL 93.It Fl r Ar LEVEL | Fl -replication= Ns Ar LEVEL
94Set the desired replication level. 94Set the desired replication level.
95If CONTENT_PUSHING is set to YES, GNUnet will push each block (for the file) LEVEL times to other peers before doing normal "random" replication of all content. 95If CONTENT_PUSHING is set to YES, GNUnet will push each block (for the file) LEVEL times to other peers before doing normal "random" replication of all content.
96This option can be used to push some content out into the network harder. 96This option can be used to push some content out into the network harder.
97Note that pushing content LEVEL times into the network does not guarantee that there will actually be LEVEL replicas. 97Note that pushing content LEVEL times into the network does not guarantee that there will actually be LEVEL replicas.
98.It Fl V | \-verbose 98.It Fl V | -verbose
99Be verbose. 99Be verbose.
100Using this option causes gnunet-publish to print progress information and at the end the file identification that can be used to download the file from GNUnet. 100Using this option causes gnunet-publish to print progress information and at the end the file identification that can be used to download the file from GNUnet.
101.It Fl v | \-version 101.It Fl v | -version
102Print the version number. 102Print the version number.
103.El 103.El
104.Sh EXAMPLES 104.Sh EXAMPLES
diff --git a/doc/man/gnunet-bcd.1 b/doc/man/gnunet-bcd.1
index 0a1399ba3..edc0fea41 100644
--- a/doc/man/gnunet-bcd.1
+++ b/doc/man/gnunet-bcd.1
@@ -30,11 +30,11 @@
30run HTTP server to create GNS business cards 30run HTTP server to create GNS business cards
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl p Ar PORT | Fl \-port= Ns Ar PORT 33.Op Fl p Ar PORT | Fl -port= Ns Ar PORT
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 34.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl h | \-help 35.Op Fl h | -help
36.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 36.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
37.Op Fl v | \-version 37.Op Fl v | -version
38.Sh DESCRIPTION 38.Sh DESCRIPTION
39.Nm 39.Nm
40can be used to create an business card with a QR code containing the public key of a zone from the GNU Name System. 40can be used to create an business card with a QR code containing the public key of a zone from the GNU Name System.
@@ -45,16 +45,16 @@ If it does not work for you, try installing the full TeXLive distribution first,
45.Xr apt 1 45.Xr apt 1
46execute "apt-get install texlive-full". 46execute "apt-get install texlive-full".
47.Bl -tag -width indent 47.Bl -tag -width indent
48.It Fl p Ar PORT | Fl \-port= Ns Ar PORT 48.It Fl p Ar PORT | Fl -port= Ns Ar PORT
49Run the HTTP server on port PORT. 49Run the HTTP server on port PORT.
50.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 50.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
51Use the configuration file FILENAME. 51Use the configuration file FILENAME.
52.It Fl h | \-help 52.It Fl h | -help
53Print short help on options. 53Print short help on options.
54.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 54.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
55Use LOGLEVEL for logging. 55Use LOGLEVEL for logging.
56Valid values are DEBUG, INFO, WARNING and ERROR. 56Valid values are DEBUG, INFO, WARNING and ERROR.
57.It Fl v | \-version 57.It Fl v | -version
58Print GNUnet version number. 58Print GNUnet version number.
59.El 59.El
60.Sh SEE ALSO 60.Sh SEE ALSO
diff --git a/doc/man/gnunet-cadet.1 b/doc/man/gnunet-cadet.1
index bb2ce637e..fcc4fb2a5 100644
--- a/doc/man/gnunet-cadet.1
+++ b/doc/man/gnunet-cadet.1
@@ -30,18 +30,18 @@
30create or obtain information about CADET tunnels and peers 30create or obtain information about CADET tunnels and peers
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl C Ar CONNECTION_ID | Fl \-connection= Ns Ar CONNECTION_ID 33.Op Fl C Ar CONNECTION_ID | Fl -connection= Ns Ar CONNECTION_ID
34.Op Fl d | \-dump 34.Op Fl d | -dump
35.Op Fl e | \-echo 35.Op Fl e | -echo
36.Op Fl o Ar SHARED_SECRET | Fl \-open-port= Ns Ar SHARED_SECRET 36.Op Fl o Ar SHARED_SECRET | Fl -open-port= Ns Ar SHARED_SECRET
37.Op Fl p Ar PEER_ID | Fl \-peer= Ns Ar PEER_ID 37.Op Fl p Ar PEER_ID | Fl -peer= Ns Ar PEER_ID
38.Op Fl P | \-peers 38.Op Fl P | -peers
39.Op Fl T | \-tunnels 39.Op Fl T | -tunnels
40.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 40.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
41.Op Fl h | \-help 41.Op Fl h | -help
42.Op Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 42.Op Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
43.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 43.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
44.Op Fl v | \-version 44.Op Fl v | -version
45.Ao Ar PEER_ID Ac 45.Ao Ar PEER_ID Ac
46.Ao Ar SHARED_SECRET Ac 46.Ao Ar SHARED_SECRET Ac
47.Sh DESCRIPTION 47.Sh DESCRIPTION
@@ -63,36 +63,36 @@ For one-to-many communication
63.Xr gnunet-social 1 63.Xr gnunet-social 1
64may be better suited, however. 64may be better suited, however.
65.Bl -tag -width indent 65.Bl -tag -width indent
66.It Fl C Ar CONNECTION_ID | Fl \-connection= Ns Ar CONNECTION_ID 66.It Fl C Ar CONNECTION_ID | Fl -connection= Ns Ar CONNECTION_ID
67Provide information about the connection 67Provide information about the connection
68.Ar CONNECTION_ID . 68.Ar CONNECTION_ID .
69.It Fl d | \-dump 69.It Fl d | -dump
70Dump debug information to stderr. 70Dump debug information to stderr.
71.It Fl e | \-echo 71.It Fl e | -echo
72Activate echo mode. 72Activate echo mode.
73.It Fl o Ar SHARED_SECRET | Fl \-open-port= Ns Ar SHARED_SECRET 73.It Fl o Ar SHARED_SECRET | Fl -open-port= Ns Ar SHARED_SECRET
74Listen for connections using a shared secret, provided as 74Listen for connections using a shared secret, provided as
75.Ar SHARED_SECRET , 75.Ar SHARED_SECRET ,
76among sender and recipient. 76among sender and recipient.
77.It Fl p Ar PEER_ID | Fl \-peer= Ns Ar PEER_ID 77.It Fl p Ar PEER_ID | Fl -peer= Ns Ar PEER_ID
78Provide information about the peer 78Provide information about the peer
79.Ar PEER_ID . 79.Ar PEER_ID .
80.It Fl P | \-peers 80.It Fl P | -peers
81Provide information about all (known) peers. 81Provide information about all (known) peers.
82.It Fl T | \-tunnels 82.It Fl T | -tunnels
83Provide information about all tunnels. 83Provide information about all tunnels.
84.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 84.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
85Use the configuration file 85Use the configuration file
86.Ar FILENAME . 86.Ar FILENAME .
87.It Fl h | \-help 87.It Fl h | -help
88Print the help page. 88Print the help page.
89.It Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 89.It Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
90Configure logging to write logs to 90Configure logging to write logs to
91.Ar FILENAME . 91.Ar FILENAME .
92.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 92.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
93Use LOGLEVEL for logging. 93Use LOGLEVEL for logging.
94Valid values are DEBUG, INFO, WARNING and ERROR. 94Valid values are DEBUG, INFO, WARNING and ERROR.
95.It Fl v | \-version 95.It Fl v | -version
96Print the GNUnet version number. 96Print the GNUnet version number.
97.El 97.El
98.Sh SEE ALSO 98.Sh SEE ALSO
diff --git a/doc/man/gnunet-config.1 b/doc/man/gnunet-config.1
index 95dc98811..e5babce2d 100644
--- a/doc/man/gnunet-config.1
+++ b/doc/man/gnunet-config.1
@@ -30,47 +30,47 @@
30manipulate GNUnet configuration files 30manipulate GNUnet configuration files
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl b Ar BACKEND | Fl \-supported-backend= Ns Ar BACKEND 33.Op Fl b Ar BACKEND | Fl -supported-backend= Ns Ar BACKEND
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 34.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl f | \-filename 35.Op Fl f | -filename
36.Op Fl h | \-help 36.Op Fl h | -help
37.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 37.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
38.Op Fl o Ar OPTION | Fl \-option= Ns Ar OPTION 38.Op Fl o Ar OPTION | Fl -option= Ns Ar OPTION
39.Op Fl S |\-list-sections 39.Op Fl S |-list-sections
40.Op Fl s Ar SECTION | Fl \-section= Ns Ar SECTION 40.Op Fl s Ar SECTION | Fl -section= Ns Ar SECTION
41.Op Fl V Ar VALUE | Fl \-value Ar VALUE 41.Op Fl V Ar VALUE | Fl -value Ar VALUE
42.Op Fl v | \-version 42.Op Fl v | -version
43.Op Fl W | \-rewrite 43.Op Fl W | -rewrite
44.Sh DESCRIPTION 44.Sh DESCRIPTION
45.Nm 45.Nm
46can be used to read or modify GNUnet configuration files. 46can be used to read or modify GNUnet configuration files.
47.Bl -tag -width indent 47.Bl -tag -width indent
48.It Fl b Ar BACKEND | Fl \-supported-backend= Ns Ar BACKEND 48.It Fl b Ar BACKEND | Fl -supported-backend= Ns Ar BACKEND
49Tests whether the specified BACKEND is supported by the current installation. The backend must match the name of a plugin, i.e. "namestore_postgres" for the Postgres database backend of the "NAMESTORE" service. If the BACKEND is supported, gnunet-config will return a status code of 0 (success), otherwise 77 (unsupported). When this option is specified, no other options may be specified. Specifying this option together with other options will cause gnunet-config to return a status code of 1 (error). 49Tests whether the specified BACKEND is supported by the current installation. The backend must match the name of a plugin, i.e. "namestore_postgres" for the Postgres database backend of the "NAMESTORE" service. If the BACKEND is supported, gnunet-config will return a status code of 0 (success), otherwise 77 (unsupported). When this option is specified, no other options may be specified. Specifying this option together with other options will cause gnunet-config to return a status code of 1 (error).
50.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 50.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
51Use the configuration file FILENAME. 51Use the configuration file FILENAME.
52.It Fl f | \-filename 52.It Fl f | -filename
53Try to perform expansions as if the option values represent filenames (will also be applied even if the option is not really a filename). 53Try to perform expansions as if the option values represent filenames (will also be applied even if the option is not really a filename).
54.It Fl h | \-help 54.It Fl h | -help
55Print short help on options. 55Print short help on options.
56.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 56.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
57Use LOGLEVEL for logging. 57Use LOGLEVEL for logging.
58Valid values are DEBUG, INFO, WARNING and ERROR. 58Valid values are DEBUG, INFO, WARNING and ERROR.
59.It Fl o Ar OPTION | Fl \-option= Ns Ar OPTION 59.It Fl o Ar OPTION | Fl -option= Ns Ar OPTION
60Which configuration option should be accessed or edited. 60Which configuration option should be accessed or edited.
61Required to set a value. 61Required to set a value.
62If not given, all values of a given section will be printed in the format "OPTION = VALUE". 62If not given, all values of a given section will be printed in the format "OPTION = VALUE".
63.It Fl S |\-list-sections 63.It Fl S |-list-sections
64List available configuration sections for use with \-\-section. 64List available configuration sections for use with --section.
65.It Fl s Ar SECTION | Fl \-section= Ns Ar SECTION 65.It Fl s Ar SECTION | Fl -section= Ns Ar SECTION
66Which configuration section should be accessed or edited. 66Which configuration section should be accessed or edited.
67Required option. 67Required option.
68.It Fl V Ar VALUE | Fl \-value Ar VALUE 68.It Fl V Ar VALUE | Fl -value Ar VALUE
69Configuration value to store in the given section under the given option. 69Configuration value to store in the given section under the given option.
70Must only be given together with \-s and \-o options. 70Must only be given together with -s and -o options.
71.It Fl v | \-version 71.It Fl v | -version
72Print GNUnet version number. 72Print GNUnet version number.
73.It Fl W | \-rewrite 73.It Fl W | -rewrite
74Consider differences to defaults only. 74Consider differences to defaults only.
75.El 75.El
76.Sh SEE ALSO 76.Sh SEE ALSO
diff --git a/doc/man/gnunet-conversation-test.1 b/doc/man/gnunet-conversation-test.1
index 1cc445f6f..395f27244 100644
--- a/doc/man/gnunet-conversation-test.1
+++ b/doc/man/gnunet-conversation-test.1
@@ -30,26 +30,26 @@
30check your speaker and microphone settings 30check your speaker and microphone settings
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 34.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 35.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl v | \-version 36.Op Fl v | -version
37.Ao Ar URI Ac 37.Ao Ar URI Ac
38.Sh DESCRIPTION 38.Sh DESCRIPTION
39.Nm 39.Nm
40can be used to check your speaker and microphone settings. 40can be used to check your speaker and microphone settings.
41It will record you for five seconds and then play the recording back to you. 41It will record you for five seconds and then play the recording back to you.
42If this fails, you might want to use the \fBpavucontrol\fP tool to check which microphone or speaker were assigned to GNUnet by PulseAudio (you may have more than one set of microphones or speakers known to your computer). 42If this fails, you might want to use the \fBpavucontrol\fP tool to check which microphone or speaker were assigned to GNUnet by PulseAudio (you may have more than one set of microphones or speakers known to your computer).
43You can use gnunet\-conversation\-test without having a peer running on your computer. 43You can use gnunet-conversation-test without having a peer running on your computer.
44.Bl -tag -width indent 44.Bl -tag -width indent
45.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 45.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
46Use the configuration file FILENAME. 46Use the configuration file FILENAME.
47.It Fl h | \-help 47.It Fl h | -help
48Print short help on options. 48Print short help on options.
49.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 49.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
50Use LOGLEVEL for logging. 50Use LOGLEVEL for logging.
51Valid values are DEBUG, INFO, WARNING and ERROR. 51Valid values are DEBUG, INFO, WARNING and ERROR.
52.It Fl v | \-version 52.It Fl v | -version
53Print GNUnet version number. 53Print GNUnet version number.
54.El 54.El
55.\".Sh EXAMPLES 55.\".Sh EXAMPLES
diff --git a/doc/man/gnunet-conversation.1 b/doc/man/gnunet-conversation.1
index 62909224d..c319a231b 100644
--- a/doc/man/gnunet-conversation.1
+++ b/doc/man/gnunet-conversation.1
@@ -30,34 +30,34 @@
30have a conversation with your peers 30have a conversation with your peers
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl e Ar NAME | Fl \-ego= Ns Ar NAME 34.Op Fl e Ar NAME | Fl -ego= Ns Ar NAME
35.Op Fl h | \-help 35.Op Fl h | -help
36.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 36.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
37.Op Fl p Ar LINE | Fl \-phone= Ns Ar LINE 37.Op Fl p Ar LINE | Fl -phone= Ns Ar LINE
38.Op Fl v | \-version 38.Op Fl v | -version
39.Ao Ar URI Ac 39.Ao Ar URI Ac
40.Sh DESCRIPTION 40.Sh DESCRIPTION
41.Nm 41.Nm
42can be used to have a conversation with other GNUnet users. 42can be used to have a conversation with other GNUnet users.
43You can make calls and receive incoming calls. 43You can make calls and receive incoming calls.
44You need to setup an ego using gnunet\-identity first. 44You need to setup an ego using gnunet-identity first.
45For others to be able to call you, you must add a PHONE record to your zone in the GNU Name System (using gnunet\-namestore). 45For others to be able to call you, you must add a PHONE record to your zone in the GNU Name System (using gnunet-namestore).
46gnunet\-conversation has an interactive help system via the /help command. 46gnunet-conversation has an interactive help system via the /help command.
47.Bl -tag -width indent 47.Bl -tag -width indent
48.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 48.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
49Use the configuration file FILENAME. 49Use the configuration file FILENAME.
50.It Fl e Ar NAME | Fl \-ego= Ns Ar NAME 50.It Fl e Ar NAME | Fl -ego= Ns Ar NAME
51Specifies the NAME of the ego to use (for caller ID). 51Specifies the NAME of the ego to use (for caller ID).
52.It Fl h | \-help 52.It Fl h | -help
53Print short help on options. 53Print short help on options.
54.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 54.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
55Use LOGLEVEL for logging. 55Use LOGLEVEL for logging.
56Valid values are DEBUG, INFO, WARNING and ERROR. 56Valid values are DEBUG, INFO, WARNING and ERROR.
57.It Fl p Ar LINE | Fl \-phone= Ns Ar LINE 57.It Fl p Ar LINE | Fl -phone= Ns Ar LINE
58Optional argument that can be used to specify the phone LINE to be used with the conversation service. 58Optional argument that can be used to specify the phone LINE to be used with the conversation service.
59The default LINE is zero, which should be fine for most users. 59The default LINE is zero, which should be fine for most users.
60.It Fl v | \-version 60.It Fl v | -version
61Print GNUnet version number. 61Print GNUnet version number.
62.El 62.El
63.\".Sh EXAMPLES 63.\".Sh EXAMPLES
diff --git a/doc/man/gnunet-datastore.1 b/doc/man/gnunet-datastore.1
index fede02185..81347dcae 100644
--- a/doc/man/gnunet-datastore.1
+++ b/doc/man/gnunet-datastore.1
@@ -31,7 +31,7 @@
31.Nm 31.Nm
32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
33.Op Fl d | -dump 33.Op Fl d | -dump
34.Op Fl f Ar FILENAME | Fl \-file= Ns Ar FILENAME 34.Op Fl f Ar FILENAME | Fl -file= Ns Ar FILENAME
35.Op Fl h | -help 35.Op Fl h | -help
36.Op Fl i | -insert 36.Op Fl i | -insert
37.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL 37.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
diff --git a/doc/man/gnunet-directory.1 b/doc/man/gnunet-directory.1
index 4a0696179..65c8e41ae 100644
--- a/doc/man/gnunet-directory.1
+++ b/doc/man/gnunet-directory.1
@@ -30,10 +30,10 @@
30display directories 30display directories
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 34.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 35.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl v | \-version 36.Op Fl v | -version
37.Ao Ar FILENAME Ac 37.Ao Ar FILENAME Ac
38.Sh DESCRIPTION 38.Sh DESCRIPTION
39.Nm 39.Nm
@@ -42,15 +42,15 @@ A GNUnet directory is a binary file that contains a list of GNUnet file-sharing
42The names of the directory files must be passed as command-line arguments to gnunet-directory. 42The names of the directory files must be passed as command-line arguments to gnunet-directory.
43The options are as follows: 43The options are as follows:
44.Bl -tag -width indent 44.Bl -tag -width indent
45.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 45.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
46Configuration file to use. 46Configuration file to use.
47This option is useless, since gnunet-directory does not really depend on any configuration options. 47This option is useless, since gnunet-directory does not really depend on any configuration options.
48.It Fl h | \-help 48.It Fl h | -help
49Print the help page. 49Print the help page.
50.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 50.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
51Change the loglevel. 51Change the loglevel.
52Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. 52Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
53.It Fl v | \-version 53.It Fl v | -version
54Print the version number. 54Print the version number.
55.El 55.El
56.Ss NOTES 56.Ss NOTES
diff --git a/doc/man/gnunet-download.1 b/doc/man/gnunet-download.1
index 56f18e050..951c4a979 100644
--- a/doc/man/gnunet-download.1
+++ b/doc/man/gnunet-download.1
@@ -30,24 +30,24 @@
30a command line interface for downloading files from GNUnet 30a command line interface for downloading files from GNUnet
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 33.Op Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 34.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl D | \-delete\-incomplete 35.Op Fl D | -delete-incomplete
36.Op Fl h | \-help 36.Op Fl h | -help
37.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 37.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
38.Op Fl n | \-no-network 38.Op Fl n | -no-network
39.Op Fl o Ar FILENAME | Fl \-output= Ns Ar FILENAME 39.Op Fl o Ar FILENAME | Fl -output= Ns Ar FILENAME
40.Op Fl p Ar DOWNLOADS | Fl \-parallelism= Ns Ar DOWNLOADS 40.Op Fl p Ar DOWNLOADS | Fl -parallelism= Ns Ar DOWNLOADS
41.Op Fl r Ar REQUESTS | Fl \-request-parallelism= Ns Ar REQUESTS 41.Op Fl r Ar REQUESTS | Fl -request-parallelism= Ns Ar REQUESTS
42.Op Fl R | \-recursive 42.Op Fl R | -recursive
43.Op Fl v | \-version 43.Op Fl v | -version
44.Op Fl V | \-verbose 44.Op Fl V | -verbose
45.Ao Ar GNUNET_URI Ac 45.Ao Ar GNUNET_URI Ac
46.Sh DESCRIPTION 46.Sh DESCRIPTION
47Download files from GNUnet. 47Download files from GNUnet.
48The options are as follows: 48The options are as follows:
49.Bl -tag -width indent 49.Bl -tag -width indent
50.It Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 50.It Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
51This option can be used to specify additional anonymity constraints. 51This option can be used to specify additional anonymity constraints.
52The default is 1. 52The default is 1.
53If set to 0, GNUnet will publish the file non-anonymously and in fact sign the advertisement for the file using your peer's private key. 53If set to 0, GNUnet will publish the file non-anonymously and in fact sign the advertisement for the file using your peer's private key.
@@ -62,22 +62,22 @@ The specific numeric value (for anonymity levels above 1) is simple:
62Given an anonymity level L (above 1), each request FS makes on your behalf must be hidden in L-1 equivalent requests of cover traffic (traffic your peer routes for others) in the same time-period. 62Given an anonymity level L (above 1), each request FS makes on your behalf must be hidden in L-1 equivalent requests of cover traffic (traffic your peer routes for others) in the same time-period.
63The time-period is twice the average delay by which GNUnet artificially delays traffic. 63The time-period is twice the average delay by which GNUnet artificially delays traffic.
64Note that regardless of the anonymity level you choose, peers that cache content in the network always use anonymity level 1. 64Note that regardless of the anonymity level you choose, peers that cache content in the network always use anonymity level 1.
65.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 65.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
66Use config file (default: 66Use config file (default:
67.Pa ~/.config/gnunet.conf Ns ) 67.Pa ~/.config/gnunet.conf Ns )
68.It Fl D | \-delete\-incomplete 68.It Fl D | -delete-incomplete
69Causes gnunet-download to delete incomplete downloads when aborted with CTRL-C. 69Causes gnunet-download to delete incomplete downloads when aborted with CTRL-C.
70Note that complete files that are part of an incomplete recursive download will not be deleted even with this option. 70Note that complete files that are part of an incomplete recursive download will not be deleted even with this option.
71Without this option, terminating gnunet-download with a signal will cause incomplete downloads to stay on disk. 71Without this option, terminating gnunet-download with a signal will cause incomplete downloads to stay on disk.
72If gnunet-download runs to (normal) completion finishing the download, this option has no effect. 72If gnunet-download runs to (normal) completion finishing the download, this option has no effect.
73.It Fl h | \-help 73.It Fl h | -help
74Print the help page. 74Print the help page.
75.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 75.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
76Change the loglevel. 76Change the loglevel.
77Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. 77Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
78.It Fl n | \-no-network 78.It Fl n | -no-network
79Only search locally, do not forward requests to other peers. 79Only search locally, do not forward requests to other peers.
80.It Fl o Ar FILENAME | Fl \-output= Ns Ar FILENAME 80.It Fl o Ar FILENAME | Fl -output= Ns Ar FILENAME
81Write the file to 81Write the file to
82.Ar FILENAME . 82.Ar FILENAME .
83Hint: when recursively downloading a directory, append a '/' to the end of the FILENAME to create a directory of that name. 83Hint: when recursively downloading a directory, append a '/' to the end of the FILENAME to create a directory of that name.
@@ -85,7 +85,7 @@ If no FILENAME is specified, gnunet-download constructs a temporary ID from the
85The final filename is constructed based on meta-data extracted using 85The final filename is constructed based on meta-data extracted using
86.Xr libextractor 1 86.Xr libextractor 1
87(if available). 87(if available).
88.It Fl p Ar DOWNLOADS | Fl \-parallelism= Ns Ar DOWNLOADS 88.It Fl p Ar DOWNLOADS | Fl -parallelism= Ns Ar DOWNLOADS
89Set the maximum number of allowed parallel downloads to 89Set the maximum number of allowed parallel downloads to
90.Ar DOWNLOADS . 90.Ar DOWNLOADS .
91More parallel downloads can, to some extent, improve the overall time to download content. 91More parallel downloads can, to some extent, improve the overall time to download content.
@@ -97,7 +97,7 @@ This option is used to limit the number of files that are downloaded in parallel
97can be used to limit the number of blocks that are concurrently requested. 97can be used to limit the number of blocks that are concurrently requested.
98As a result, the value only matters for recursive downloads. 98As a result, the value only matters for recursive downloads.
99The default value is 32. 99The default value is 32.
100.It Fl r Ar REQUESTS | Fl \-request-parallelism= Ns Ar REQUESTS 100.It Fl r Ar REQUESTS | Fl -request-parallelism= Ns Ar REQUESTS
101Set the maximum number of parallel requests that is allowed. 101Set the maximum number of parallel requests that is allowed.
102If multiple files are downloaded, gnunet-download will not run them in parallel if this would cause the number of pending requests to possibly exceed the given value. 102If multiple files are downloaded, gnunet-download will not run them in parallel if this would cause the number of pending requests to possibly exceed the given value.
103This is useful since, for example, downloading dozens of multi-gigabyte files in parallel could exhaust memory resources and would hardly improve performance. 103This is useful since, for example, downloading dozens of multi-gigabyte files in parallel could exhaust memory resources and would hardly improve performance.
@@ -107,16 +107,16 @@ Consider raising this limit for large recursive downloads with many large files
107is not reached. 107is not reached.
108This option also only matters for recursive downloads. 108This option also only matters for recursive downloads.
109The default value is 4092. 109The default value is 4092.
110.It Fl R | \-recursive 110.It Fl R | -recursive
111Download directories recursively (and in parallel). 111Download directories recursively (and in parallel).
112Note that the URI must belong to a GNUnet directory and that the filename given to 112Note that the URI must belong to a GNUnet directory and that the filename given to
113.Fl o 113.Fl o
114must end in '.gnd' \(em otherwise, you will receive an error. 114must end in '.gnd' \(em otherwise, you will receive an error.
115You may want to use "DIRNAME/.gnd" for the filename, this way a directory "DIRNAME/" will be created, and GNUnet's internal directory information will be stored in "DIRNAME/.gnd". 115You may want to use "DIRNAME/.gnd" for the filename, this way a directory "DIRNAME/" will be created, and GNUnet's internal directory information will be stored in "DIRNAME/.gnd".
116However, it is also possible to specify "DIRNAME.gnd", in which case the files from the directory will end up in "DIRNAME/", while GNUnet's directory meta data will be in "DIRNAME.gnd". 116However, it is also possible to specify "DIRNAME.gnd", in which case the files from the directory will end up in "DIRNAME/", while GNUnet's directory meta data will be in "DIRNAME.gnd".
117.It Fl v | \-version 117.It Fl v | -version
118Print the version number. 118Print the version number.
119.It Fl V | \-verbose 119.It Fl V | -verbose
120Print progress information. 120Print progress information.
121.El 121.El
122.Ss NOTES 122.Ss NOTES
diff --git a/doc/man/gnunet-fs.1 b/doc/man/gnunet-fs.1
index e87d9a3e2..f964acbb1 100644
--- a/doc/man/gnunet-fs.1
+++ b/doc/man/gnunet-fs.1
@@ -29,12 +29,12 @@
29.Nd measure and control the FS subsystem 29.Nd measure and control the FS subsystem
30.Sh SYNOPSIS 30.Sh SYNOPSIS
31.Nm 31.Nm
32.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
33.Op Fl h | \-help 33.Op Fl h | -help
34.Op Fl i | \-list-indexed 34.Op Fl i | -list-indexed
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 35.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl v | \-version 36.Op Fl v | -version
37.Op Fl V | \-verbose 37.Op Fl V | -verbose
38.Sh DESCRIPTION 38.Sh DESCRIPTION
39.Nm 39.Nm
40is a tool to access various functions of GNUnet's FS subsystem 40is a tool to access various functions of GNUnet's FS subsystem
@@ -43,18 +43,18 @@ Most of these are not expected to be useful for end-users.
43gnunet-fs can currently only be used to obtain a list of indexed files. 43gnunet-fs can currently only be used to obtain a list of indexed files.
44Other functions should be added in the near future. 44Other functions should be added in the near future.
45.Bl -tag -width indent 45.Bl -tag -width indent
46.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 46.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
47Configuration file to use. 47Configuration file to use.
48.It Fl h | \-help 48.It Fl h | -help
49Print the help page. 49Print the help page.
50.It Fl i | \-list-indexed 50.It Fl i | -list-indexed
51Print information about files that are currently indexed by file-sharing. 51Print information about files that are currently indexed by file-sharing.
52.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 52.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
53Change the loglevel. 53Change the loglevel.
54Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. 54Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
55.It Fl v | \-version 55.It Fl v | -version
56Print the version number. 56Print the version number.
57.It Fl V | \-verbose 57.It Fl V | -verbose
58Be verbose. 58Be verbose.
59.El 59.El
60.Sh SEE ALSO 60.Sh SEE ALSO
diff --git a/doc/man/gnunet-gns-proxy.1 b/doc/man/gnunet-gns-proxy.1
index d985ee0d9..770cb4fe2 100644
--- a/doc/man/gnunet-gns-proxy.1
+++ b/doc/man/gnunet-gns-proxy.1
@@ -30,35 +30,35 @@
30run a client side GNS SOCKS proxy 30run a client side GNS SOCKS proxy
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl a Ar AUTHORITY | Fl \-authority= Ns Ar AUTHORITY 34.Op Fl a Ar AUTHORITY | Fl -authority= Ns Ar AUTHORITY
35.Op Fl p Ar PORT | Fl \-port= Ns Ar PORT 35.Op Fl p Ar PORT | Fl -port= Ns Ar PORT
36.Op Fl h | \-help 36.Op Fl h | -help
37.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 37.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
38.Op Fl v | \-version 38.Op Fl v | -version
39.Sh DESCRIPTION 39.Sh DESCRIPTION
40Most users will want to run this SOCKS proxy. 40Most users will want to run this SOCKS proxy.
41It can be used in combination with browsers that support the SOCKS 4a protocol. 41It can be used in combination with browsers that support the SOCKS 4a protocol.
42.Pp 42.Pp
43The proxy will perform SSL authentication of GNS names and rewrite GNS enabled HTML content. 43The proxy will perform SSL authentication of GNS names and rewrite GNS enabled HTML content.
44To assert the validity of GNS names a local root CA certificate has to be generated that is used by the proxy. 44To assert the validity of GNS names a local root CA certificate has to be generated that is used by the proxy.
45Thus "gnunet-gns-proxy-setup-ca" should be executed before the first launch of this proxy or the \-\-authority switch is used to specify an appropriate CA certificate that is already trusted by the browser. 45Thus "gnunet-gns-proxy-setup-ca" should be executed before the first launch of this proxy or the --authority switch is used to specify an appropriate CA certificate that is already trusted by the browser.
46.Bl -tag -width indent 46.Bl -tag -width indent
47.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 47.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
48Use the configuration file FILENAME. 48Use the configuration file FILENAME.
49.It Fl a Ar AUTHORITY | Fl \-authority= Ns Ar AUTHORITY 49.It Fl a Ar AUTHORITY | Fl -authority= Ns Ar AUTHORITY
50Path to a PEM CA file that contains the certificate and private key of the CA to use to assert the validity of GNS names. 50Path to a PEM CA file that contains the certificate and private key of the CA to use to assert the validity of GNS names.
51The default port is specified in the configuration file for the gns service under "[gns-proxy]": 51The default port is specified in the configuration file for the gns service under "[gns-proxy]":
52"[gns-proxy]" 52"[gns-proxy]"
53PROXY_CACERT 53PROXY_CACERT
54.It Fl p Ar PORT | Fl \-port= Ns Ar PORT 54.It Fl p Ar PORT | Fl -port= Ns Ar PORT
55The port this proxy should listen on. Default is 7777. 55The port this proxy should listen on. Default is 7777.
56.It Fl h | \-help 56.It Fl h | -help
57Print short help on options. 57Print short help on options.
58.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 58.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
59Use LOGLEVEL for logging. 59Use LOGLEVEL for logging.
60Valid values are DEBUG, INFO, WARNING and ERROR. 60Valid values are DEBUG, INFO, WARNING and ERROR.
61.It Fl v | \-version 61.It Fl v | -version
62Print GNUnet version number. 62Print GNUnet version number.
63.El 63.El
64.\".Sh EXAMPLES 64.\".Sh EXAMPLES
diff --git a/doc/man/gnunet-gns.1 b/doc/man/gnunet-gns.1
index 0743290b4..310198f74 100644
--- a/doc/man/gnunet-gns.1
+++ b/doc/man/gnunet-gns.1
@@ -30,43 +30,43 @@
30access to GNU Name System 30access to GNU Name System
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 34.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 35.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 36.Op Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
37.Op Fl r | \-raw 37.Op Fl r | -raw
38.Op Fl t Ar TYPE | Fl \-type= Ns Ar TYPE 38.Op Fl t Ar TYPE | Fl -type= Ns Ar TYPE
39.Op Fl u Ar NAME | Fl \-lookup= Ns Ar NAME 39.Op Fl u Ar NAME | Fl -lookup= Ns Ar NAME
40.Op Fl v | \-version 40.Op Fl v | -version
41.Sh DESCRIPTION 41.Sh DESCRIPTION
42.Nm 42.Nm
43can be used to lookup and process GNU Name Service names. 43can be used to lookup and process GNU Name Service names.
44.Bl -tag -width indent 44.Bl -tag -width indent
45.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 45.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
46Use the configuration file FILENAME. 46Use the configuration file FILENAME.
47.It Fl h | \-help 47.It Fl h | -help
48Print short help on options. 48Print short help on options.
49.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 49.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
50Use LOGLEVEL for logging. 50Use LOGLEVEL for logging.
51Valid values are DEBUG, INFO, WARNING and ERROR. 51Valid values are DEBUG, INFO, WARNING and ERROR.
52.It Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 52.It Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
53Write logs to FILENAME. 53Write logs to FILENAME.
54.It Fl r | \-raw 54.It Fl r | -raw
55No unneeded output. 55No unneeded output.
56This is a quiet mode where only important information is displayed. 56This is a quiet mode where only important information is displayed.
57For example a lookup for an IP address will only yield the IP address, no descriptive text. 57For example a lookup for an IP address will only yield the IP address, no descriptive text.
58.It Fl t Ar TYPE | Fl \-type= Ns Ar TYPE 58.It Fl t Ar TYPE | Fl -type= Ns Ar TYPE
59Resource Record Type (TYPE) to look for. 59Resource Record Type (TYPE) to look for.
60Supported TYPE's are: A, AAAA, CNAME, NS, PKEY, PSEU, TLSA, SRV, SOA, MX, LEHO, VPN, REV, PTR, TXT. 60Supported TYPE's are: A, AAAA, CNAME, NS, PKEY, PSEU, TLSA, SRV, SOA, MX, LEHO, VPN, REV, PTR, TXT.
61Defaults to "A". 61Defaults to "A".
62.It Fl u Ar NAME | Fl \-lookup= Ns Ar NAME 62.It Fl u Ar NAME | Fl -lookup= Ns Ar NAME
63Name to lookup. 63Name to lookup.
64Resolve the specified name using the GNU Name System. 64Resolve the specified name using the GNU Name System.
65.It Fl T Ar TIMEOUT | Fl \-timeout= Ns Ar TIMEOUT 65.It Fl T Ar TIMEOUT | Fl -timeout= Ns Ar TIMEOUT
66How much time to wait for a resolution to finish. 66How much time to wait for a resolution to finish.
67Example: "5s" for 5 seconds or "3m" for 3 minutes. 67Example: "5s" for 5 seconds or "3m" for 3 minutes.
68Defaults to "forver" (No timeout). 68Defaults to "forver" (No timeout).
69.It Fl v | \-version 69.It Fl v | -version
70Print GNUnet version number. 70Print GNUnet version number.
71.El 71.El
72.Sh DIAGNOSTICS 72.Sh DIAGNOSTICS
diff --git a/doc/man/gnunet-identity.1 b/doc/man/gnunet-identity.1
index ec1a7ab37..1adfdf4d0 100644
--- a/doc/man/gnunet-identity.1
+++ b/doc/man/gnunet-identity.1
@@ -35,7 +35,7 @@
35.Op Fl e Ar NAME | Fl -ego= Ns Ar NAME 35.Op Fl e Ar NAME | Fl -ego= Ns Ar NAME
36.Op Fl h | -help 36.Op Fl h | -help
37.Op Fl m | -monitor 37.Op Fl m | -monitor
38.Op Fl p | \-private-keys 38.Op Fl p | -private-keys
39.Op Fl q | -quiet 39.Op Fl q | -quiet
40.Op Fl s Ar SUBSYSTEM | Fl -set= Ns Ar SUBSYSTEM 40.Op Fl s Ar SUBSYSTEM | Fl -set= Ns Ar SUBSYSTEM
41.Op Fl V | -verbose 41.Op Fl V | -verbose
diff --git a/doc/man/gnunet-namecache.1 b/doc/man/gnunet-namecache.1
index a040622b0..7abd9a449 100644
--- a/doc/man/gnunet-namecache.1
+++ b/doc/man/gnunet-namecache.1
@@ -30,29 +30,29 @@
30inspect namecache 30inspect namecache
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 34.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 35.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl n Ar NAME | Fl \-name= Ns Ar NAME 36.Op Fl n Ar NAME | Fl -name= Ns Ar NAME
37.Op Fl v | \-version 37.Op Fl v | -version
38.Op Fl z Ar PKEY | Fl \-zone= Ns Ar PKEY 38.Op Fl z Ar PKEY | Fl -zone= Ns Ar PKEY
39.Sh DESCRIPTION 39.Sh DESCRIPTION
40.Nm 40.Nm
41can be used to inspect values in the namecache. 41can be used to inspect values in the namecache.
42It is passed the mandatory option 'z' ('--zone=') with the argument PKEY, and the mandatory option 'n' ('--name=') with the argument NAME. 42It is passed the mandatory option 'z' ('--zone=') with the argument PKEY, and the mandatory option 'n' ('--name=') with the argument NAME.
43.Bl -tag -width indent 43.Bl -tag -width indent
44.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 44.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
45Use the configuration file FILENAME. 45Use the configuration file FILENAME.
46.It Fl h | \-help 46.It Fl h | -help
47Print short help on options. 47Print short help on options.
48.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 48.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
49Use LOGLEVEL for logging. 49Use LOGLEVEL for logging.
50Valid values are DEBUG, INFO, WARNING and ERROR. 50Valid values are DEBUG, INFO, WARNING and ERROR.
51.It Fl n Ar NAME | Fl \-name= Ns Ar NAME 51.It Fl n Ar NAME | Fl -name= Ns Ar NAME
52Name (label) of the record to display (mandatory option). 52Name (label) of the record to display (mandatory option).
53.It Fl v | \-version 53.It Fl v | -version
54Print GNUnet version number. 54Print GNUnet version number.
55.It Fl z Ar PKEY | Fl \-zone= Ns Ar PKEY 55.It Fl z Ar PKEY | Fl -zone= Ns Ar PKEY
56Specifies the public key of the zone to inspect (mandatory option) 56Specifies the public key of the zone to inspect (mandatory option)
57.El 57.El
58.\".Sh EXAMPLES 58.\".Sh EXAMPLES
diff --git a/doc/man/gnunet-namestore-fcfsd.1 b/doc/man/gnunet-namestore-fcfsd.1
index e1a09afe4..ee79a1784 100644
--- a/doc/man/gnunet-namestore-fcfsd.1
+++ b/doc/man/gnunet-namestore-fcfsd.1
@@ -30,11 +30,11 @@
30HTTP server for GNU Name System First-Come-First-Served name registration 30HTTP server for GNU Name System First-Come-First-Served name registration
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 34.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 35.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl v | \-version 36.Op Fl v | -version
37.Op Fl z Ar EGO | \-zone= Ns Ar EGO 37.Op Fl z Ar EGO | -zone= Ns Ar EGO
38.Sh DESCRIPTION 38.Sh DESCRIPTION
39Most users will not want to run an FCFS-zone and thus will not need this program. 39Most users will not want to run an FCFS-zone and thus will not need this program.
40.Pp 40.Pp
@@ -58,16 +58,16 @@ After that, you can start the FCFSD service (possibly using
58.Pp 58.Pp
59The options are as follows: 59The options are as follows:
60.Bl -tag -width indent 60.Bl -tag -width indent
61.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 61.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
62Use the configuration file FILENAME. 62Use the configuration file FILENAME.
63.It Fl h | \-help 63.It Fl h | -help
64Print short help on options. 64Print short help on options.
65.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 65.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
66Use LOGLEVEL for logging. 66Use LOGLEVEL for logging.
67Valid values are DEBUG, INFO, WARNING and ERROR. 67Valid values are DEBUG, INFO, WARNING and ERROR.
68.It Fl v | \-version 68.It Fl v | -version
69Print GNUnet version number. 69Print GNUnet version number.
70.It Fl z Ar EGO | \-zone= Ns Ar EGO 70.It Fl z Ar EGO | -zone= Ns Ar EGO
71Specifies for which 71Specifies for which
72.Ar EGO 72.Ar EGO
73FCFSD should manage the zone. 73FCFSD should manage the zone.
diff --git a/doc/man/gnunet-namestore.1 b/doc/man/gnunet-namestore.1
index e53bb7d95..e0d68fed1 100644
--- a/doc/man/gnunet-namestore.1
+++ b/doc/man/gnunet-namestore.1
@@ -61,11 +61,11 @@ Desired operation is adding a record.
61Use the configuration file FILENAME. 61Use the configuration file FILENAME.
62.It Fl d | -delete 62.It Fl d | -delete
63Desired operation is deleting records under the given name that match 63Desired operation is deleting records under the given name that match
64the specified type (\-t) and value (\-V). 64the specified type (-t) and value (-V).
65If type or value are not specified, it means that all types (or 65If type or value are not specified, it means that all types (or
66values) should be assumed to match (and possibly multiple or all 66values) should be assumed to match (and possibly multiple or all
67values under the given label will be deleted). 67values under the given label will be deleted).
68Specifying a label (\-n) is mandatory. 68Specifying a label (-n) is mandatory.
69Note that matching by expiration time or flags is (currently) not 69Note that matching by expiration time or flags is (currently) not
70supported. 70supported.
71.It Fl D | -display 71.It Fl D | -display
@@ -85,7 +85,7 @@ suggested name for this zone.
85Use LOGLEVEL for logging. 85Use LOGLEVEL for logging.
86Valid values are DEBUG, INFO, WARNING and ERROR. 86Valid values are DEBUG, INFO, WARNING and ERROR.
87.It Fl m | -monitor 87.It Fl m | -monitor
88Monitor changes to the zone on an ongoing basis (in contrast to \-D, 88Monitor changes to the zone on an ongoing basis (in contrast to -D,
89which merely displays the current records). 89which merely displays the current records).
90.It Fl n Ar NAME | Fl -name= Ns Ar NAME 90.It Fl n Ar NAME | Fl -name= Ns Ar NAME
91Label or name of the record to add/delete/display. 91Label or name of the record to add/delete/display.
diff --git a/doc/man/gnunet-nat-auto.1 b/doc/man/gnunet-nat-auto.1
index 2dbfaa599..f6d52abc6 100644
--- a/doc/man/gnunet-nat-auto.1
+++ b/doc/man/gnunet-nat-auto.1
@@ -30,30 +30,30 @@
30autoconfigure and test NAT traversal 30autoconfigure and test NAT traversal
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl a | \-auto 33.Op Fl a | -auto
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 34.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl S Ar NAME | Fl \-section= Ns Ar NAME 35.Op Fl S Ar NAME | Fl -section= Ns Ar NAME
36.Op Fl t | \-tcp 36.Op Fl t | -tcp
37.Op Fl u | \-udp 37.Op Fl u | -udp
38.Op Fl w | \-write 38.Op Fl w | -write
39.Sh DESCRIPTION 39.Sh DESCRIPTION
40.Nm 40.Nm
41allows testing various NAT traversal functions, as well as attempting auto-configuration. 41allows testing various NAT traversal functions, as well as attempting auto-configuration.
42The options are as follows: 42The options are as follows:
43.Bl -tag -width indent 43.Bl -tag -width indent
44.It Fl a | \-auto 44.It Fl a | -auto
45Attempt auto-configuration for NAT traversal. 45Attempt auto-configuration for NAT traversal.
46.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 46.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
47Use the configuration file 47Use the configuration file
48.Ar FILENAME . 48.Ar FILENAME .
49.It Fl S Ar NAME | Fl \-section= Ns Ar NAME 49.It Fl S Ar NAME | Fl -section= Ns Ar NAME
50Name of the configuration section with details about the configuration to test. 50Name of the configuration section with details about the configuration to test.
51For example "transport-tcp". 51For example "transport-tcp".
52.It Fl t | \-tcp 52.It Fl t | -tcp
53Use TCP. 53Use TCP.
54.It Fl u | \-udp 54.It Fl u | -udp
55Use UDP. 55Use UDP.
56.It Fl w | \-write 56.It Fl w | -write
57Write configuration to configuration file, useful in combination with auto-configuration 57Write configuration to configuration file, useful in combination with auto-configuration
58.Pq Fl a . 58.Pq Fl a .
59.El 59.El
diff --git a/doc/man/gnunet-nat-server.1 b/doc/man/gnunet-nat-server.1
index 77a5eec26..92ea9fd38 100644
--- a/doc/man/gnunet-nat-server.1
+++ b/doc/man/gnunet-nat-server.1
@@ -30,11 +30,11 @@
30help GNUnet setup test network setup with NAT 30help GNUnet setup test network setup with NAT
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl d | \-daemonize 34.Op Fl d | -daemonize
35.Op Fl h | \-help 35.Op Fl h | -help
36.Op Fl L Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 36.Op Fl L Ar FILENAME | Fl -logfile= Ns Ar FILENAME
37.Op Fl v | \-version 37.Op Fl v | -version
38.Ao Ar PORT Ac 38.Ao Ar PORT Ac
39.Sh DESCRIPTION 39.Sh DESCRIPTION
40Running a gnunet-nat-server is similar to running a hostlist server: it is a special service to the community with special requirements and no benefit to those running the service. 40Running a gnunet-nat-server is similar to running a hostlist server: it is a special service to the community with special requirements and no benefit to those running the service.
@@ -60,20 +60,20 @@ In fact, distributions are encouraged to consider not shipping it at all.
60.Pp 60.Pp
61The options are as follows: 61The options are as follows:
62.Bl -tag -width indent 62.Bl -tag -width indent
63.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 63.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
64Use the configuration file 64Use the configuration file
65.Ar FILENAME . 65.Ar FILENAME .
66.It Fl d | \-daemonize 66.It Fl d | -daemonize
67Daemonize gnunet-nat-server (detach from terminal). 67Daemonize gnunet-nat-server (detach from terminal).
68.It Fl h | \-help 68.It Fl h | -help
69Print the help page. 69Print the help page.
70.It Fl L Ar LOGLEVEL | Fl \-log= Ns Ar LOGLEVEL 70.It Fl L Ar LOGLEVEL | Fl -log= Ns Ar LOGLEVEL
71Configure logging to use 71Configure logging to use
72.Ar LOGLEVEL . 72.Ar LOGLEVEL .
73.It Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 73.It Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
74Configure logging to write logs to 74Configure logging to write logs to
75.Ar FILENAME . 75.Ar FILENAME .
76.It Fl v | \-version 76.It Fl v | -version
77Print the GNUnet version. 77Print the GNUnet version.
78.El 78.El
79.\".Sh EXAMPLES 79.\".Sh EXAMPLES
diff --git a/doc/man/gnunet-nat.1 b/doc/man/gnunet-nat.1
index 1ffdc5c7c..f0e36cb29 100644
--- a/doc/man/gnunet-nat.1
+++ b/doc/man/gnunet-nat.1
@@ -30,41 +30,41 @@
30interact with the NAT service 30interact with the NAT service
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl b Ar ADDRESS | Fl \-bind= Ns Ar ADDRESS 33.Op Fl b Ar ADDRESS | Fl -bind= Ns Ar ADDRESS
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 34.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl e Ar ADDRESS | Fl \-external= Ns Ar ADDRESS 35.Op Fl e Ar ADDRESS | Fl -external= Ns Ar ADDRESS
36.Op Fl i Ar ADDRESS | Fl \-in= Ns Ar ADDRESS 36.Op Fl i Ar ADDRESS | Fl -in= Ns Ar ADDRESS
37.Op Fl r Ar ADDRESS | Fl \-remote= Ns Ar ADDRESS 37.Op Fl r Ar ADDRESS | Fl -remote= Ns Ar ADDRESS
38.Op Fl S Ar NAME | Fl \-section= Ns Ar NAME 38.Op Fl S Ar NAME | Fl -section= Ns Ar NAME
39.Op Fl s | \-stun 39.Op Fl s | -stun
40.Op Fl t | \-tcp 40.Op Fl t | -tcp
41.Op Fl u | \-udp 41.Op Fl u | -udp
42.Op Fl W | \-watch 42.Op Fl W | -watch
43.Sh DESCRIPTION 43.Sh DESCRIPTION
44This tool allows testing various NAT traversal functions, as well as attempting auto-configuration. 44This tool allows testing various NAT traversal functions, as well as attempting auto-configuration.
45.Sh OPTIONS 45.Sh OPTIONS
46.Bl -tag -width indent 46.Bl -tag -width indent
47.It Fl b Ar ADDRESS | Fl \-bind= Ns Ar ADDRESS 47.It Fl b Ar ADDRESS | Fl -bind= Ns Ar ADDRESS
48Assume that the service is (locally) bound to ADDRESS. 48Assume that the service is (locally) bound to ADDRESS.
49.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 49.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
50Use the configuration file FILENAME. 50Use the configuration file FILENAME.
51.It Fl e Ar ADDRESS | Fl \-external= Ns Ar ADDRESS 51.It Fl e Ar ADDRESS | Fl -external= Ns Ar ADDRESS
52Assume that ADDRESS is the globally visible address of the peer. 52Assume that ADDRESS is the globally visible address of the peer.
53.It Fl i Ar ADDRESS | Fl \-in= Ns Ar ADDRESS 53.It Fl i Ar ADDRESS | Fl -in= Ns Ar ADDRESS
54Assuming we are listening at ADDRESS for connection reversal requests. 54Assuming we are listening at ADDRESS for connection reversal requests.
55.It Fl r Ar ADDRESS | Fl \-remote= Ns Ar ADDRESS 55.It Fl r Ar ADDRESS | Fl -remote= Ns Ar ADDRESS
56Ask the peer at ADDRESS for connection reversal, using the local address for the target address of the reversal. 56Ask the peer at ADDRESS for connection reversal, using the local address for the target address of the reversal.
57.It Fl S Ar NAME | Fl \-section= Ns Ar NAME 57.It Fl S Ar NAME | Fl -section= Ns Ar NAME
58Name of section in configuration file to use for additional options. 58Name of section in configuration file to use for additional options.
59.It Fl s | \-stun 59.It Fl s | -stun
60Enable processing of STUN requests. 60Enable processing of STUN requests.
61Will try to read UDP packets from the bind address and handle the packets if they are STUN packets. 61Will try to read UDP packets from the bind address and handle the packets if they are STUN packets.
62Will only work with UDP. 62Will only work with UDP.
63.It Fl t | \-tcp 63.It Fl t | -tcp
64Use TCP. 64Use TCP.
65.It Fl u | \-udp 65.It Fl u | -udp
66Use UDP. 66Use UDP.
67.It Fl W | \-watch 67.It Fl W | -watch
68Watch for connection reversal requests. 68Watch for connection reversal requests.
69.El 69.El
70.Sh EXAMPLES 70.Sh EXAMPLES
diff --git a/doc/man/gnunet-peerinfo.1 b/doc/man/gnunet-peerinfo.1
index 143295dad..49d059d4f 100644
--- a/doc/man/gnunet-peerinfo.1
+++ b/doc/man/gnunet-peerinfo.1
@@ -30,46 +30,46 @@
30display information about other peers 30display information about other peers
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl g | \-get\-hello 34.Op Fl g | -get-hello
35.Op Fl h | \-help 35.Op Fl h | -help
36.Op Fl i | \-info 36.Op Fl i | -info
37.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 37.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
38.Op Fl l Ar LOGFILE | Fl \-logfile= ns Ar LOGFILE 38.Op Fl l Ar LOGFILE | Fl -logfile= ns Ar LOGFILE
39.Op Fl n | \-numeric 39.Op Fl n | -numeric
40.Op Fl p Ar HELLO | Fl \-put\-hello= Ns Ar HELLO 40.Op Fl p Ar HELLO | Fl -put-hello= Ns Ar HELLO
41.Op Fl q | \-quiet 41.Op Fl q | -quiet
42.Op Fl s | \-self 42.Op Fl s | -self
43.Op Fl v | \-version 43.Op Fl v | -version
44.Sh DESCRIPTION 44.Sh DESCRIPTION
45.Nm 45.Nm
46displays the known addresses and trust of known peers. 46displays the known addresses and trust of known peers.
47.Bl -tag -width indent 47.Bl -tag -width indent
48.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 48.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
49Load config file, default FILENAME of the config is 49Load config file, default FILENAME of the config is
50.Pa ~/.config/gnunet.conf . 50.Pa ~/.config/gnunet.conf .
51.It Fl g | \-get\-hello 51.It Fl g | -get-hello
52Output HELLO uri(s) 52Output HELLO uri(s)
53.It Fl h | \-help 53.It Fl h | -help
54Print the help page. 54Print the help page.
55.It Fl i | \-info 55.It Fl i | -info
56List all known peers (and their addresses). 56List all known peers (and their addresses).
57.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 57.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
58Set the loglevel 58Set the loglevel
59.It Fl l Ar LOGFILE | Fl \-logfile= ns Ar LOGFILE 59.It Fl l Ar LOGFILE | Fl -logfile= ns Ar LOGFILE
60Log messages to LOGFILE 60Log messages to LOGFILE
61.It Fl n | \-numeric 61.It Fl n | -numeric
62Disable resolution of IPs to hostnames 62Disable resolution of IPs to hostnames
63.It Fl p Ar HELLO | Fl \-put\-hello= Ns Ar HELLO 63.It Fl p Ar HELLO | Fl -put-hello= Ns Ar HELLO
64Add given HELLO uri to the database 64Add given HELLO uri to the database
65.It Fl q | \-quiet 65.It Fl q | -quiet
66Do not print anything but the peer identities 66Do not print anything but the peer identities
67.It Fl s | \-self 67.It Fl s | -self
68Print only our own identity. 68Print only our own identity.
69Together with 69Together with
70.Fl q , 70.Fl q ,
71this is the exact line that other peers would have to put in to their friends file in order to consider this peer one of their friends in F2F mode. 71this is the exact line that other peers would have to put in to their friends file in order to consider this peer one of their friends in F2F mode.
72.It Fl v | \-version 72.It Fl v | -version
73Print the version number 73Print the version number
74.El 74.El
75.Sh SEE ALSO 75.Sh SEE ALSO
diff --git a/doc/man/gnunet-publish.1 b/doc/man/gnunet-publish.1
index 04293102c..a54a1717f 100644
--- a/doc/man/gnunet-publish.1
+++ b/doc/man/gnunet-publish.1
@@ -30,25 +30,25 @@
30a command line interface for publishing new content into GNUnet 30a command line interface for publishing new content into GNUnet
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 33.Op Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 34.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl D | \-disable\-extractor 35.Op Fl D | -disable-extractor
36.Op Fl E | \-enable\-creation\-time 36.Op Fl E | -enable-creation-time
37.Op Fl e | \-extract 37.Op Fl e | -extract
38.Op Fl h | \-help 38.Op Fl h | -help
39.Op Fl k Ar KEYWORD | Fl \-key= Ns Ar KEYWORD 39.Op Fl k Ar KEYWORD | Fl -key= Ns Ar KEYWORD
40.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 40.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
41.Op Fl m Ar TYPE:VALUE | Fl \-meta= Ns Ar TYPE:VALUE 41.Op Fl m Ar TYPE:VALUE | Fl -meta= Ns Ar TYPE:VALUE
42.Op Fl n | \-noindex 42.Op Fl n | -noindex
43.Op Fl N Ar ID | Fl \-next= Ns Ar ID 43.Op Fl N Ar ID | Fl -next= Ns Ar ID
44.Op Fl p Ar PRIORITY | Fl \-prio= Ns Ar PRIORITY 44.Op Fl p Ar PRIORITY | Fl -prio= Ns Ar PRIORITY
45.Op Fl P Ar NAME | Fl \-pseudonym= Ns Ar NAME 45.Op Fl P Ar NAME | Fl -pseudonym= Ns Ar NAME
46.Op Fl r Ar LEVEL | Fl \-replication= Ns Ar LEVEL 46.Op Fl r Ar LEVEL | Fl -replication= Ns Ar LEVEL
47.Op Fl s | \-simulate-only 47.Op Fl s | -simulate-only
48.Op Fl t Ar ID | Fl \-this= Ns Ar ID 48.Op Fl t Ar ID | Fl -this= Ns Ar ID
49.Op Fl u Ar URI | Fl \-uri= Ns Ar URI 49.Op Fl u Ar URI | Fl -uri= Ns Ar URI
50.Op Fl v | \-version 50.Op Fl v | -version
51.Op Fl V | \-verbose 51.Op Fl V | -verbose
52.Ao Ar FILENAME Ac 52.Ao Ar FILENAME Ac
53.Sh DESCRIPTION 53.Sh DESCRIPTION
54In order to share files with other GNUnet users, the files must first be made available to GNUnet. 54In order to share files with other GNUnet users, the files must first be made available to GNUnet.
@@ -109,10 +109,10 @@ to specify meta-data.
109For the 109For the
110.Fl m 110.Fl m
111option you need to use the form keyword-type:value. 111option you need to use the form keyword-type:value.
112For example, use "\-m os:Linux" to specify that the operating system is Linux. 112For example, use "-m os:Linux" to specify that the operating system is Linux.
113Common meta-data types are "author", "title", "mimetype", "filename", "language", "subject" and "keywords". 113Common meta-data types are "author", "title", "mimetype", "filename", "language", "subject" and "keywords".
114A full list can be obtained from the extract tool using the option 114A full list can be obtained from the extract tool using the option
115.Fl \-list . 115.Fl -list .
116The meta-data is used to help users in searching for files on the network. 116The meta-data is used to help users in searching for files on the network.
117The keywords are case-sensitive. 117The keywords are case-sensitive.
118.Pp 118.Pp
@@ -128,7 +128,7 @@ If you publish or index a file and then leave the network, it will almost always
128.Pp 128.Pp
129The options are as follows: 129The options are as follows:
130.Bl -tag -width indent 130.Bl -tag -width indent
131.It Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 131.It Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
132This option can be used to specify additional anonymity constraints. 132This option can be used to specify additional anonymity constraints.
133The default is 1. 133The default is 1.
134If set to 0, GNUnet will publish the file non-anonymously and in fact sign the advertisement for the file using your peer's private key. 134If set to 0, GNUnet will publish the file non-anonymously and in fact sign the advertisement for the file using your peer's private key.
@@ -143,38 +143,38 @@ The specific numeric value (for anonymity levels above 1) is simple:
143Given an anonymity level L (above 1), each request FS makes on your behalf must be hidden in L-1 equivalent requests of cover traffic (traffic your peer routes for others) in the same time-period. 143Given an anonymity level L (above 1), each request FS makes on your behalf must be hidden in L-1 equivalent requests of cover traffic (traffic your peer routes for others) in the same time-period.
144The time-period is twice the average delay by which GNUnet artificially delays traffic. 144The time-period is twice the average delay by which GNUnet artificially delays traffic.
145Note that regardless of the anonymity level you choose, peers that cache content in the network always use anonymity level 1. 145Note that regardless of the anonymity level you choose, peers that cache content in the network always use anonymity level 1.
146.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 146.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
147Use alternate config file FILENAME. 147Use alternate config file FILENAME.
148If this option is not specified, the default is 148If this option is not specified, the default is
149.Pa ~/.config/gnunet.conf . 149.Pa ~/.config/gnunet.conf .
150.It Fl D | \-disable\-extractor 150.It Fl D | -disable-extractor
151Disable use of GNU libextractor for finding additional keywords and metadata. 151Disable use of GNU libextractor for finding additional keywords and metadata.
152.It Fl E | \-enable\-creation\-time 152.It Fl E | -enable-creation-time
153Enable use of creation time timestamp in metadata. 153Enable use of creation time timestamp in metadata.
154Setting this information will leak information about the time at which a file was made available. 154Setting this information will leak information about the time at which a file was made available.
155.It Fl e | \-extract 155.It Fl e | -extract
156Print the list of keywords that will be used for each file given the current options. 156Print the list of keywords that will be used for each file given the current options.
157Do not perform any indexing or publishing. 157Do not perform any indexing or publishing.
158.It Fl h | \-help 158.It Fl h | -help
159Print the help page. 159Print the help page.
160.It Fl k Ar KEYWORD | Fl \-key= Ns Ar KEYWORD 160.It Fl k Ar KEYWORD | Fl -key= Ns Ar KEYWORD
161Additional key to index the content with (to add multiple keys, specify multiple times). 161Additional key to index the content with (to add multiple keys, specify multiple times).
162Each additional key is case\-sensitive. 162Each additional key is case-sensitive.
163Can be specified multiple times. 163Can be specified multiple times.
164The keyword is only applied to the top\-level file or directory. 164The keyword is only applied to the top-level file or directory.
165.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 165.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
166Change the loglevel. 166Change the loglevel.
167Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. 167Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
168.It Fl m Ar TYPE:VALUE | Fl \-meta= Ns Ar TYPE:VALUE 168.It Fl m Ar TYPE:VALUE | Fl -meta= Ns Ar TYPE:VALUE
169For the main file (or directory), set the metadata of the given TYPE to the given VALUE. 169For the main file (or directory), set the metadata of the given TYPE to the given VALUE.
170Note that this will not add the respective VALUE to the set of keywords under which the file can be found. 170Note that this will not add the respective VALUE to the set of keywords under which the file can be found.
171.It Fl n | \-noindex 171.It Fl n | -noindex
172Executive summary: You probably don't need it. 172Executive summary: You probably don't need it.
173Do not index, full publishing. 173Do not index, full publishing.
174Note that directories, information for keyword search, namespace search and indexing data are always published (even without this option). 174Note that directories, information for keyword search, namespace search and indexing data are always published (even without this option).
175With this option, every block of the actual files is stored in encrypted form in the block database of the local peer. 175With this option, every block of the actual files is stored in encrypted form in the block database of the local peer.
176While this adds security if the local node is compromised (the adversary snags your machine), it is significantly less efficient compared to on-demand encryption and is definitely not recommended for large files. 176While this adds security if the local node is compromised (the adversary snags your machine), it is significantly less efficient compared to on-demand encryption and is definitely not recommended for large files.
177.It Fl N Ar ID | Fl \-next= Ns Ar ID 177.It Fl N Ar ID | Fl -next= Ns Ar ID
178Specifies the next identifier of a future version of the file to be published under the same pseudonym. 178Specifies the next identifier of a future version of the file to be published under the same pseudonym.
179This option is only valid together with the 179This option is only valid together with the
180.Fl P 180.Fl P
@@ -187,36 +187,36 @@ and
187without 187without
188.Fl t 188.Fl t
189is not allowed. 189is not allowed.
190.It Fl p Ar PRIORITY | Fl \-prio= Ns Ar PRIORITY 190.It Fl p Ar PRIORITY | Fl -prio= Ns Ar PRIORITY
191Executive summary: You probably don't need it. 191Executive summary: You probably don't need it.
192Set the priority of the published content (default: 365). 192Set the priority of the published content (default: 365).
193If the local database is full, GNUnet will discard the content with the lowest ranking. 193If the local database is full, GNUnet will discard the content with the lowest ranking.
194Note that ranks change over time depending on popularity. 194Note that ranks change over time depending on popularity.
195The default should be high enough to preserve the locally published content in favor of content that migrates from other peers. 195The default should be high enough to preserve the locally published content in favor of content that migrates from other peers.
196.It Fl P Ar NAME | Fl \-pseudonym= Ns Ar NAME 196.It Fl P Ar NAME | Fl -pseudonym= Ns Ar NAME
197For the top-level directory or file, places the file into the namespace identified by the pseudonym NAME. 197For the top-level directory or file, places the file into the namespace identified by the pseudonym NAME.
198NAME must be a valid pseudonym managed by 198NAME must be a valid pseudonym managed by
199.Xr gnunet-identity 1 . 199.Xr gnunet-identity 1 .
200.It Fl r Ar LEVEL | Fl \-replication= Ns Ar LEVEL 200.It Fl r Ar LEVEL | Fl -replication= Ns Ar LEVEL
201Set the desired replication level. 201Set the desired replication level.
202If CONTENT_PUSHING is set to YES, GNUnet will push each block (for the file) LEVEL times to other peers before doing normal "random" replication of all content. 202If CONTENT_PUSHING is set to YES, GNUnet will push each block (for the file) LEVEL times to other peers before doing normal "random" replication of all content.
203This option can be used to push some content out into the network harder. 203This option can be used to push some content out into the network harder.
204Note that pushing content LEVEL times into the network does not guarantee that there will actually be LEVEL replicas. 204Note that pushing content LEVEL times into the network does not guarantee that there will actually be LEVEL replicas.
205.It Fl s | \-simulate-only 205.It Fl s | -simulate-only
206When this option is used, gnunet\-publish will not actually publish the file but just simulate what would be done. 206When this option is used, gnunet-publish will not actually publish the file but just simulate what would be done.
207This can be used to compute the GNUnet URI for a file without actually sharing it. 207This can be used to compute the GNUnet URI for a file without actually sharing it.
208.It Fl t Ar ID | Fl \-this= Ns Ar ID 208.It Fl t Ar ID | Fl -this= Ns Ar ID
209Specifies the identifier under which the file is to be published under a pseudonym. 209Specifies the identifier under which the file is to be published under a pseudonym.
210This option is only valid together with the 210This option is only valid together with the
211.Fl P 211.Fl P
212option. 212option.
213.It Fl u Ar URI | Fl \-uri= Ns Ar URI 213.It Fl u Ar URI | Fl -uri= Ns Ar URI
214This option can be used to specify the URI of a file instead of a filename (this is the only case where the otherwise mandatory filename argument must be omitted). 214This option can be used to specify the URI of a file instead of a filename (this is the only case where the otherwise mandatory filename argument must be omitted).
215Instead of publishing a file or directory and using the corresponding URI, gnunet-publish will use this URI and perform the selected namespace or keyword operations. 215Instead of publishing a file or directory and using the corresponding URI, gnunet-publish will use this URI and perform the selected namespace or keyword operations.
216This can be used to add additional keywords to a file that has already been shared or to add files to a namespace for which the URI is known but the content is not locally available. 216This can be used to add additional keywords to a file that has already been shared or to add files to a namespace for which the URI is known but the content is not locally available.
217.It Fl v | \-version 217.It Fl v | -version
218Print the version number. 218Print the version number.
219.It Fl V | \-verbose 219.It Fl V | -verbose
220Be verbose. 220Be verbose.
221Using this option causes gnunet-publish to print progress information and at the end the file identification that can be used to download the file from GNUnet. 221Using this option causes gnunet-publish to print progress information and at the end the file identification that can be used to download the file from GNUnet.
222.El 222.El
diff --git a/doc/man/gnunet-reclaim.1 b/doc/man/gnunet-reclaim.1
index c1ab0d1aa..5003ef070 100644
--- a/doc/man/gnunet-reclaim.1
+++ b/doc/man/gnunet-reclaim.1
@@ -30,62 +30,62 @@
30Command-line tools for re:claimID subsystem 30Command-line tools for re:claimID subsystem
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 34.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 35.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOGFILE 36.Op Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
37.Op Fl e Ar EGO | Fl \-ego= Ns Ar EGO 37.Op Fl e Ar EGO | Fl -ego= Ns Ar EGO
38.Op Fl a Ar NAME | Fl \-add= Ns Ar NAME 38.Op Fl a Ar NAME | Fl -add= Ns Ar NAME
39.Op Fl V Ar VALUE | Fl \-value= Ns Ar VALUE 39.Op Fl V Ar VALUE | Fl -value= Ns Ar VALUE
40.Op Fl d Ar ID | Fl \-delete= Ns Ar ID 40.Op Fl d Ar ID | Fl -delete= Ns Ar ID
41.Op Fl r Ar RP | Fl \-rp= Ns Ar RP 41.Op Fl r Ar RP | Fl -rp= Ns Ar RP
42.Op Fl D | \-dump 42.Op Fl D | -dump
43.Op Fl i Ar A1,A2,... | Fl \-issue= Ns Ar A1,A2,... 43.Op Fl i Ar A1,A2,... | Fl -issue= Ns Ar A1,A2,...
44.Op Fl C Ar TICKET | Fl \-consume= Ns Ar TICKET 44.Op Fl C Ar TICKET | Fl -consume= Ns Ar TICKET
45.Op Fl R Ar TICKET | Fl \-revoke= Ns Ar TICKET 45.Op Fl R Ar TICKET | Fl -revoke= Ns Ar TICKET
46.Op Fl t Ar TYPE | Fl \-type= Ns Ar TYPE 46.Op Fl t Ar TYPE | Fl -type= Ns Ar TYPE
47.Op Fl T | \-tickets 47.Op Fl T | -tickets
48.Op Fl E Ar INTERVAL | Fl \-expiration= Ns Ar INTERVAL 48.Op Fl E Ar INTERVAL | Fl -expiration= Ns Ar INTERVAL
49.Op Fl v | \-version 49.Op Fl v | -version
50.Sh DESCRIPTION 50.Sh DESCRIPTION
51.Nm 51.Nm
52allows you to manage identity attributes and manage authorizations. 52allows you to manage identity attributes and manage authorizations.
53.Bl -tag -width indent 53.Bl -tag -width indent
54.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 54.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
55Use the configuration file FILENAME. 55Use the configuration file FILENAME.
56.It Fl h | \-help 56.It Fl h | -help
57Print short help on options. 57Print short help on options.
58.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 58.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
59Use LOGLEVEL for logging. 59Use LOGLEVEL for logging.
60Valid values are DEBUG, INFO, WARNING and ERROR. 60Valid values are DEBUG, INFO, WARNING and ERROR.
61.It Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOGFILE 61.It Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
62Configure logging to write logs to LOGFILE. 62Configure logging to write logs to LOGFILE.
63.It Fl e Ar EGO | Fl \-ego= Ns Ar EGO 63.It Fl e Ar EGO | Fl -ego= Ns Ar EGO
64Specify identity to use. Always required. 64Specify identity to use. Always required.
65.It Fl a Ar NAME | Fl \-add= Ns Ar NAME 65.It Fl a Ar NAME | Fl -add= Ns Ar NAME
66Add an attribute with NAME. Must be used in conjunction with -V 66Add an attribute with NAME. Must be used in conjunction with -V
67.It Fl V Ar VALUE | Fl \-value= Ns Ar VALUE 67.It Fl V Ar VALUE | Fl -value= Ns Ar VALUE
68Specify value of attribute to add. 68Specify value of attribute to add.
69.It Fl t Ar TYPE | Fl \-type= Ns Ar TYPE 69.It Fl t Ar TYPE | Fl -type= Ns Ar TYPE
70Specify type of attribute to add (Default: STRING) 70Specify type of attribute to add (Default: STRING)
71.It Fl d Ar ID | Fl \-delete= Ns Ar ID 71.It Fl d Ar ID | Fl -delete= Ns Ar ID
72Delete an attribute with ID. 72Delete an attribute with ID.
73.It Fl E Ar INTERVAL | Fl \-expiration= Ns Ar INTERVAL 73.It Fl E Ar INTERVAL | Fl -expiration= Ns Ar INTERVAL
74Specify relative expiration interval (freshness) of attribute. 74Specify relative expiration interval (freshness) of attribute.
75.It Fl D | \-dump 75.It Fl D | -dump
76List all attributes for given identity. 76List all attributes for given identity.
77.It Fl i Ar A1,A2,... | Fl \-issue= Ns Ar A1,A2,... 77.It Fl i Ar A1,A2,... | Fl -issue= Ns Ar A1,A2,...
78Authorize a relying party to access a set of attributes. Must be 78Authorize a relying party to access a set of attributes. Must be
79used in conjunction with -r. Returns a TICKET. 79used in conjunction with -r. Returns a TICKET.
80.It Fl r Ar RP | Fl \-rp= Ns Ar RP 80.It Fl r Ar RP | Fl -rp= Ns Ar RP
81The relying party to authorize (see -i). RP is a PKEY of the entity. 81The relying party to authorize (see -i). RP is a PKEY of the entity.
82.It Fl C Ar TICKET | Fl \-consume= Ns Ar TICKET 82.It Fl C Ar TICKET | Fl -consume= Ns Ar TICKET
83Consume TICKET and retrieve shared attributes. To be used by RP. 83Consume TICKET and retrieve shared attributes. To be used by RP.
84.It Fl R Ar TICKET | Fl \-revoke= Ns Ar TICKET 84.It Fl R Ar TICKET | Fl -revoke= Ns Ar TICKET
85Revoke TICKET. To be used by identity which issued TICKET. 85Revoke TICKET. To be used by identity which issued TICKET.
86.It Fl T | \-tickets 86.It Fl T | -tickets
87List issued tickets. 87List issued tickets.
88.It Fl v | \-version 88.It Fl v | -version
89Print GNUnet version number. 89Print GNUnet version number.
90.El 90.El
91.\".Sh EXAMPLES 91.\".Sh EXAMPLES
diff --git a/doc/man/gnunet-resolver.1 b/doc/man/gnunet-resolver.1
index 843b4e2a0..8952dc14e 100644
--- a/doc/man/gnunet-resolver.1
+++ b/doc/man/gnunet-resolver.1
@@ -30,29 +30,29 @@
30built-in GNUnet stub resolver 30built-in GNUnet stub resolver
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 34.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 35.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOGFILE 36.Op Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
37.Op Fl r | \-reverse 37.Op Fl r | -reverse
38.Op Fl v | \-version 38.Op Fl v | -version
39.Ao Ar hostname Ac 39.Ao Ar hostname Ac
40.Sh DESCRIPTION 40.Sh DESCRIPTION
41.Nm 41.Nm
42allows you to use the build-in GNUnet stub resolver. 42allows you to use the build-in GNUnet stub resolver.
43.Bl -tag -width indent 43.Bl -tag -width indent
44.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 44.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
45Use the configuration file FILENAME. 45Use the configuration file FILENAME.
46.It Fl h | \-help 46.It Fl h | -help
47Print short help on options. 47Print short help on options.
48.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 48.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
49Use LOGLEVEL for logging. 49Use LOGLEVEL for logging.
50Valid values are DEBUG, INFO, WARNING and ERROR. 50Valid values are DEBUG, INFO, WARNING and ERROR.
51.It Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOGFILE 51.It Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
52Configure logging to write logs to LOGFILE. 52Configure logging to write logs to LOGFILE.
53.It Fl r | \-reverse 53.It Fl r | -reverse
54Perform a reverse lookup. 54Perform a reverse lookup.
55.It Fl v | \-version 55.It Fl v | -version
56Print GNUnet version number. 56Print GNUnet version number.
57.El 57.El
58.\".Sh EXAMPLES 58.\".Sh EXAMPLES
diff --git a/doc/man/gnunet-revocation.1 b/doc/man/gnunet-revocation.1
index 16f954a2e..812c2633e 100644
--- a/doc/man/gnunet-revocation.1
+++ b/doc/man/gnunet-revocation.1
@@ -30,14 +30,14 @@
30revoke private keys (of egos) in GNUnet 30revoke private keys (of egos) in GNUnet
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl t Ar KEY | Fl \-test= Ns Ar KEY 33.Op Fl t Ar KEY | Fl -test= Ns Ar KEY
34.Op Fl R Ar NAME | Fl \-revoke= Ns Ar NAME 34.Op Fl R Ar NAME | Fl -revoke= Ns Ar NAME
35.Op Fl p | \-perform 35.Op Fl p | -perform
36.Op Fl f Ar NAME | Fl \-filename= Ns Ar NAME 36.Op Fl f Ar NAME | Fl -filename= Ns Ar NAME
37.Op Fl c Ar FILENAME, Fl \-config= Ns Ar FILENAME 37.Op Fl c Ar FILENAME, Fl -config= Ns Ar FILENAME
38.Op Fl h | \-help 38.Op Fl h | -help
39.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 39.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
40.Op Fl v | \-version 40.Op Fl v | -version
41.Sh DESCRIPTION 41.Sh DESCRIPTION
42.Nm 42.Nm
43can be used to verify if a key has been revoked, to create a revocation certificate for later revocation, to instantly revoke a key and to use a pre-generated revocation certificate to revoke a key. 43can be used to verify if a key has been revoked, to create a revocation certificate for later revocation, to instantly revoke a key and to use a pre-generated revocation certificate to revoke a key.
@@ -49,26 +49,26 @@ gnunet-revocation also makes is possible to resume the pre-calculation of a revo
49Note that performing a revocation proof-of-work is deliberately VERY expensive. 49Note that performing a revocation proof-of-work is deliberately VERY expensive.
50Depending on your CPU, the calculation can take days or weeks. 50Depending on your CPU, the calculation can take days or weeks.
51.Bl -tag -width indent 51.Bl -tag -width indent
52.It Fl t Ar KEY | Fl \-test= Ns Ar KEY 52.It Fl t Ar KEY | Fl -test= Ns Ar KEY
53Check if the given KEY (ASCII\-encoded public key required) has been revoked. 53Check if the given KEY (ASCII-encoded public key required) has been revoked.
54.It Fl R Ar NAME | Fl \-revoke= Ns Ar NAME 54.It Fl R Ar NAME | Fl -revoke= Ns Ar NAME
55Calculate or perform revocation for the ego with the given NAME. 55Calculate or perform revocation for the ego with the given NAME.
56.It Fl p | \-perform 56.It Fl p | -perform
57Actually perform the revocation as soon as possible (do not just generate a revocation certificate, use it). 57Actually perform the revocation as soon as possible (do not just generate a revocation certificate, use it).
58Must be supplied to actually perform the revocation. 58Must be supplied to actually perform the revocation.
59.It Fl f Ar NAME | Fl \-filename= Ns Ar NAME 59.It Fl f Ar NAME | Fl -filename= Ns Ar NAME
60Use NAME as the name of the file that is to contain the revocation certificate. 60Use NAME as the name of the file that is to contain the revocation certificate.
61Intermediate computation results will be stored here, as well as the final revocation certificate. 61Intermediate computation results will be stored here, as well as the final revocation certificate.
62When used together with \-p, this file will be inspected to see if it contains a valid certificate for instant revocation, in which case the revocation can be performed instantly. 62When used together with -p, this file will be inspected to see if it contains a valid certificate for instant revocation, in which case the revocation can be performed instantly.
63If the given file contains anything (a valid certificate, with or without the completed proof-of-work) there is no need to supply the "\-R" option or to still have the private key of the ego to perform the revocation. 63If the given file contains anything (a valid certificate, with or without the completed proof-of-work) there is no need to supply the "-R" option or to still have the private key of the ego to perform the revocation.
64.It Fl c Ar FILENAME, Fl \-config= Ns Ar FILENAME 64.It Fl c Ar FILENAME, Fl -config= Ns Ar FILENAME
65Use the configuration file FILENAME. 65Use the configuration file FILENAME.
66.It Fl h | \-help 66.It Fl h | -help
67Print short help on options. 67Print short help on options.
68.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 68.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
69Use LOGLEVEL for logging. 69Use LOGLEVEL for logging.
70Valid values are DEBUG, INFO, WARNING and ERROR. 70Valid values are DEBUG, INFO, WARNING and ERROR.
71.It Fl v | \-version 71.It Fl v | -version
72Print GNUnet version number. 72Print GNUnet version number.
73.El 73.El
74.Sh SEE ALSO 74.Sh SEE ALSO
diff --git a/doc/man/gnunet-scrypt.1 b/doc/man/gnunet-scrypt.1
index 16a377443..ab1188348 100644
--- a/doc/man/gnunet-scrypt.1
+++ b/doc/man/gnunet-scrypt.1
@@ -29,41 +29,41 @@
29.Nd manipulate GNUnet proof of work files 29.Nd manipulate GNUnet proof of work files
30.Sh SYNOPSIS 30.Sh SYNOPSIS
31.Nm 31.Nm
32.Op Fl b Ar BITS | Fl \-bits= Ns Ar BITS 32.Op Fl b Ar BITS | Fl -bits= Ns Ar BITS
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 34.Op Fl h | -help
35.Op Fl k Ar FILENAME | Fl \-keyfile= Ns Ar FILENAME 35.Op Fl k Ar FILENAME | Fl -keyfile= Ns Ar FILENAME
36.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 36.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
37.Op Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 37.Op Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
38.Op Fl o Ar FILENAME | Fl \-outfile= Ns Ar FILENAME 38.Op Fl o Ar FILENAME | Fl -outfile= Ns Ar FILENAME
39.Op Fl t Ar DELAY | Fl \-timeout= Ns Ar DELAY 39.Op Fl t Ar DELAY | Fl -timeout= Ns Ar DELAY
40.Op Fl v | \-version 40.Op Fl v | -version
41.Sh DESCRIPTION 41.Sh DESCRIPTION
42.Nm 42.Nm
43is a command line tool to manipulate GNUnet proof of work files. 43is a command line tool to manipulate GNUnet proof of work files.
44.Bl -tag -width indent 44.Bl -tag -width indent
45.It Fl b Ar BITS | Fl \-bits= Ns Ar BITS 45.It Fl b Ar BITS | Fl -bits= Ns Ar BITS
46Number of bits to require for the proof of work. 46Number of bits to require for the proof of work.
47.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 47.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
48Use the configuration file 48Use the configuration file
49.Ar FILENAME . 49.Ar FILENAME .
50.It Fl h | \-help 50.It Fl h | -help
51Print short help on options. 51Print short help on options.
52.It Fl k Ar FILENAME | Fl \-keyfile= Ns Ar FILENAME 52.It Fl k Ar FILENAME | Fl -keyfile= Ns Ar FILENAME
53Use 53Use
54.Ar FILENAME 54.Ar FILENAME
55as the file with private key, otherwise the default 55as the file with private key, otherwise the default
56private key file is used. 56private key file is used.
57.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 57.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
58Use LOGLEVEL for logging. 58Use LOGLEVEL for logging.
59Valid values are DEBUG, INFO, WARNING and ERROR. 59Valid values are DEBUG, INFO, WARNING and ERROR.
60.It Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 60.It Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
61Configure logging to write logs to FILENAME. 61Configure logging to write logs to FILENAME.
62.It Fl o Ar FILENAME | Fl \-outfile= Ns Ar FILENAME 62.It Fl o Ar FILENAME | Fl -outfile= Ns Ar FILENAME
63File with proof of work, otherwise default is used. 63File with proof of work, otherwise default is used.
64.It Fl t Ar DELAY | Fl \-timeout= Ns Ar DELAY 64.It Fl t Ar DELAY | Fl -timeout= Ns Ar DELAY
65Time to wait between calculations. 65Time to wait between calculations.
66.It Fl v | \-version 66.It Fl v | -version
67Print GNUnet version number. 67Print GNUnet version number.
68.Sh SEE ALSO 68.Sh SEE ALSO
69The full documentation for gnunet is maintained as a Texinfo manual. 69The full documentation for gnunet is maintained as a Texinfo manual.
diff --git a/doc/man/gnunet-search.1 b/doc/man/gnunet-search.1
index 59263c1b1..c670da3d2 100644
--- a/doc/man/gnunet-search.1
+++ b/doc/man/gnunet-search.1
@@ -30,17 +30,17 @@
30a command line interface to search for content on GNUnet 30a command line interface to search for content on GNUnet
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 33.Op Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 34.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl h | \-help 35.Op Fl h | -help
36.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 36.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
37.Op Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 37.Op Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
38.Op Fl o Ar FILENAME | Fl \-output= Ns Ar FILENAME 38.Op Fl o Ar FILENAME | Fl -output= Ns Ar FILENAME
39.Op Fl n | \-no-network 39.Op Fl n | -no-network
40.Op Fl N Ar VALUE | Fl \-results= Ns Ar VALUE 40.Op Fl N Ar VALUE | Fl -results= Ns Ar VALUE
41.Op Fl t Ar DELAY | Fl \-timeout= Ns Ar DELAY 41.Op Fl t Ar DELAY | Fl -timeout= Ns Ar DELAY
42.Op Fl v | \-version 42.Op Fl v | -version
43.Op Fl V | \-verbose 43.Op Fl V | -verbose
44.Ao KEYWORD Ac Ao +KEYWORD Ac | Ao Ar URI Ac Ao Ar +URI Ac 44.Ao KEYWORD Ac Ao +KEYWORD Ac | Ao Ar URI Ac Ao Ar +URI Ac
45.Sh DESCRIPTION 45.Sh DESCRIPTION
46Search for content on GNUnet. 46Search for content on GNUnet.
@@ -49,7 +49,7 @@ The keywords are case-sensitive.
49can be used both for a search in the global namespace as well as for searching a private subspace. 49can be used both for a search in the global namespace as well as for searching a private subspace.
50The options are as follows: 50The options are as follows:
51.Bl -tag -width indent 51.Bl -tag -width indent
52.It Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 52.It Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
53This option can be used to specify additional anonymity constraints. 53This option can be used to specify additional anonymity constraints.
54The default is 1. 54The default is 1.
55If set to 0, GNUnet will publish the file non-anonymously and in fact sign the advertisement for the file using your peer's private key. 55If set to 0, GNUnet will publish the file non-anonymously and in fact sign the advertisement for the file using your peer's private key.
@@ -64,37 +64,37 @@ The specific numeric value (for anonymity levels above 1) is simple:
64Given an anonymity level L (above 1), each request FS makes on your behalf must be hidden in L-1 equivalent requests of cover traffic (traffic your peer routes for others) in the same time-period. 64Given an anonymity level L (above 1), each request FS makes on your behalf must be hidden in L-1 equivalent requests of cover traffic (traffic your peer routes for others) in the same time-period.
65The time-period is twice the average delay by which GNUnet artificially delays traffic. 65The time-period is twice the average delay by which GNUnet artificially delays traffic.
66Note that regardless of the anonymity level you choose, peers that cache content in the network always use anonymity level 1. 66Note that regardless of the anonymity level you choose, peers that cache content in the network always use anonymity level 1.
67.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 67.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
68Use the configuration file 68Use the configuration file
69.Ar FILENAME 69.Ar FILENAME
70(default: 70(default:
71.Pa ~/.config/gnunet.conf ) 71.Pa ~/.config/gnunet.conf )
72.It Fl h | \-help 72.It Fl h | -help
73Print the help page. 73Print the help page.
74.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 74.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
75Change the loglevel. 75Change the loglevel.
76Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. 76Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
77.It Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 77.It Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
78Write logs to 78Write logs to
79.Ar FILENAME . 79.Ar FILENAME .
80.It Fl o Ar FILENAME | Fl \-output= Ns Ar FILENAME 80.It Fl o Ar FILENAME | Fl -output= Ns Ar FILENAME
81Writes a GNUnet directory containing all of the search results to 81Writes a GNUnet directory containing all of the search results to
82.Ar FILENAME . 82.Ar FILENAME .
83.It Fl n | \-no-network 83.It Fl n | -no-network
84Only search locally, do not forward requests to other peers. 84Only search locally, do not forward requests to other peers.
85.It Fl N Ar VALUE | Fl \-results= Ns Ar VALUE 85.It Fl N Ar VALUE | Fl -results= Ns Ar VALUE
86Automatically terminate the search after receiving 86Automatically terminate the search after receiving
87.Ar VALUE 87.Ar VALUE
88results. 88results.
89.It Fl t Ar DELAY | Fl \-timeout= Ns Ar DELAY 89.It Fl t Ar DELAY | Fl -timeout= Ns Ar DELAY
90Automatically timeout search after 90Automatically timeout search after
91.Ar DELAY . 91.Ar DELAY .
92The value given must be a number followed by a space and a time unit, for example "500 ms". 92The value given must be a number followed by a space and a time unit, for example "500 ms".
93Note that the quotes are required on the shell. 93Note that the quotes are required on the shell.
94Otherwise the search runs until gnunet-search is aborted with CTRL\-C. 94Otherwise the search runs until gnunet-search is aborted with CTRL-C.
95.It Fl v | \-version 95.It Fl v | -version
96print the version number 96print the version number
97.It Fl V | \-verbose 97.It Fl V | -verbose
98print meta data from search results as well 98print meta data from search results as well
99.El 99.El
100You can run gnunet-search with an URI instead of a keyword. 100You can run gnunet-search with an URI instead of a keyword.
diff --git a/doc/man/gnunet-statistics.1 b/doc/man/gnunet-statistics.1
index a2ada90a4..b745c9897 100644
--- a/doc/man/gnunet-statistics.1
+++ b/doc/man/gnunet-statistics.1
@@ -29,61 +29,61 @@
29.Nd display statistics about your GNUnet system 29.Nd display statistics about your GNUnet system
30.Sh SYNOPSIS 30.Sh SYNOPSIS
31.Nm 31.Nm
32.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
33.Op Fl h | \-help 33.Op Fl h | -help
34.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 34.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
35.Op Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 35.Op Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
36.Op Fl n Ar NAME | Fl \-name= Ns Ar NAME 36.Op Fl n Ar NAME | Fl -name= Ns Ar NAME
37.Op Fl o Ar PORT | Fl \-port= Ns Ar PORT 37.Op Fl o Ar PORT | Fl -port= Ns Ar PORT
38.Op Fl p | \-persistent 38.Op Fl p | -persistent
39.Op Fl q | \-quiet 39.Op Fl q | -quiet
40.Op Fl r Ar REMOTE | Fl \-remote= Ns Ar REMOTE 40.Op Fl r Ar REMOTE | Fl -remote= Ns Ar REMOTE
41.Op Fl S Ar SEPARATOR | Fl \-csv-separator= Ns Ar SEPARATOR 41.Op Fl S Ar SEPARATOR | Fl -csv-separator= Ns Ar SEPARATOR
42.Op Fl s Ar SUBSYSTEM | Fl \-subsystem= Ns Ar SUBSYSTEM 42.Op Fl s Ar SUBSYSTEM | Fl -subsystem= Ns Ar SUBSYSTEM
43.Op Fl t Ar PATH | Fl \-testbed= Ns Ar PATH 43.Op Fl t Ar PATH | Fl -testbed= Ns Ar PATH
44.Op Fl v | \-version 44.Op Fl v | -version
45.Op Fl w | \-watch 45.Op Fl w | -watch
46.Ao Ar VALUE Ac 46.Ao Ar VALUE Ac
47.Sh DESCRIPTION 47.Sh DESCRIPTION
48.Nm 48.Nm
49is used to display detailed information about various aspect of GNUnet's operation. 49is used to display detailed information about various aspect of GNUnet's operation.
50This tool only works if the "statistics" service is available. 50This tool only works if the "statistics" service is available.
51gnunet-statistics can be used to set a value by giving the options \-n, \-s and also a VALUE. 51gnunet-statistics can be used to set a value by giving the options -n, -s and also a VALUE.
52.Bl -tag -width indent 52.Bl -tag -width indent
53.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 53.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
54Use the configuration file FILENAME. 54Use the configuration file FILENAME.
55.It Fl h | \-help 55.It Fl h | -help
56Print short help on options. 56Print short help on options.
57.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 57.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
58Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and ERROR. 58Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and ERROR.
59.It Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 59.It Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
60Configure logging to write logs to FILENAME 60Configure logging to write logs to FILENAME
61.It Fl n Ar NAME | Fl \-name= Ns Ar NAME 61.It Fl n Ar NAME | Fl -name= Ns Ar NAME
62Each statistic has a NAME that is unique with in its subsystem. 62Each statistic has a NAME that is unique with in its subsystem.
63With this option, the output can be restricted to statistics that have a particular NAME. 63With this option, the output can be restricted to statistics that have a particular NAME.
64.It Fl o Ar PORT | Fl \-port= Ns Ar PORT 64.It Fl o Ar PORT | Fl -port= Ns Ar PORT
65PORT for remote host 65PORT for remote host
66.It Fl p | \-persistent 66.It Fl p | -persistent
67When setting a value, make the value persistent. 67When setting a value, make the value persistent.
68If the value used to be persistent and this flag is not given, it will be marked as non-persistent. 68If the value used to be persistent and this flag is not given, it will be marked as non-persistent.
69.It Fl q | \-quiet 69.It Fl q | -quiet
70Just print the statistics value 70Just print the statistics value
71.It Fl r Ar REMOTE | Fl \-remote= Ns Ar REMOTE 71.It Fl r Ar REMOTE | Fl -remote= Ns Ar REMOTE
72Connect to a remote host given as REMOTE. 72Connect to a remote host given as REMOTE.
73.It Fl S Ar SEPARATOR | Fl \-csv-separator= Ns Ar SEPARATOR 73.It Fl S Ar SEPARATOR | Fl -csv-separator= Ns Ar SEPARATOR
74Specify a separator for generating csv-output. 74Specify a separator for generating csv-output.
75.It Fl s Ar SUBSYSTEM | Fl \-subsystem= Ns Ar SUBSYSTEM 75.It Fl s Ar SUBSYSTEM | Fl -subsystem= Ns Ar SUBSYSTEM
76Statistics are kept for various subsystems. 76Statistics are kept for various subsystems.
77With this option, the output can be restricted to a particular subsystem only. 77With this option, the output can be restricted to a particular subsystem only.
78.It Fl t Ar PATH | Fl \-testbed= Ns Ar PATH 78.It Fl t Ar PATH | Fl -testbed= Ns Ar PATH
79When running testbed, you can get statistics of all peers with specefying the 79When running testbed, you can get statistics of all peers with specefying the
80folder containing the data of all testbed nodes like 80folder containing the data of all testbed nodes like
81.Pp 81.Pp
82.Dl $ gnunet-statistics -t /tmp/testbedARtmQv 82.Dl $ gnunet-statistics -t /tmp/testbedARtmQv
83.Pp 83.Pp
84.It Fl v | \-version 84.It Fl v | -version
85Print GNUnet version number. 85Print GNUnet version number.
86.It Fl w | \-watch 86.It Fl w | -watch
87Watch value continuously. 87Watch value continuously.
88.El 88.El
89.Sh SEE ALSO 89.Sh SEE ALSO
diff --git a/doc/man/gnunet-testbed-profiler.1 b/doc/man/gnunet-testbed-profiler.1
index 475884df2..5d1737e72 100644
--- a/doc/man/gnunet-testbed-profiler.1
+++ b/doc/man/gnunet-testbed-profiler.1
@@ -30,38 +30,38 @@
30profiling driver for the testbed 30profiling driver for the testbed
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl e Ar COUNT | Fl \-num-errors= Ns Ar COUNT 34.Op Fl e Ar COUNT | Fl -num-errors= Ns Ar COUNT
35.Op Fl H Ar FILENAME | Fl \-hosts= Ns Ar FILENAME 35.Op Fl H Ar FILENAME | Fl -hosts= Ns Ar FILENAME
36.Op Fl h | \-help 36.Op Fl h | -help
37.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 37.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
38.Op Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOGFILE 38.Op Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
39.Op Fl n | \-non-interactive 39.Op Fl n | -non-interactive
40.Op Fl p Ar COUNT | Fl \-num-peers= Ns Ar COUNT 40.Op Fl p Ar COUNT | Fl -num-peers= Ns Ar COUNT
41.Op Fl v | \-version 41.Op Fl v | -version
42.Sh DESCRIPTION 42.Sh DESCRIPTION
43.Nm 43.Nm
44is a command line profiling driver for the testbed. 44is a command line profiling driver for the testbed.
45.Sh OPTIONS 45.Sh OPTIONS
46.Bl -tag -width indent 46.Bl -tag -width indent
47.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 47.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
48Use the configuration file FILENAME. 48Use the configuration file FILENAME.
49.It Fl e Ar COUNT | Fl \-num-errors= Ns Ar COUNT 49.It Fl e Ar COUNT | Fl -num-errors= Ns Ar COUNT
50Tolerate COUNT number of continious timeout failures. 50Tolerate COUNT number of continious timeout failures.
51.It Fl H Ar FILENAME | Fl \-hosts= Ns Ar FILENAME 51.It Fl H Ar FILENAME | Fl -hosts= Ns Ar FILENAME
52Name of the file with the login information for the testbed. 52Name of the file with the login information for the testbed.
53.It Fl h | \-help 53.It Fl h | -help
54Print short help on options. 54Print short help on options.
55.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 55.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
56Use LOGLEVEL for logging. 56Use LOGLEVEL for logging.
57Valid values are DEBUG, INFO, WARNING and ERROR. 57Valid values are DEBUG, INFO, WARNING and ERROR.
58.It Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOGFILE 58.It Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
59Configure logging to write logs to LOGFILE. 59Configure logging to write logs to LOGFILE.
60.It Fl n | \-non-interactive 60.It Fl n | -non-interactive
61Run profiler in non-interactive mode where upon testbed setup the profiler does not wait for a keystroke but continues to run until a termination signal is received. 61Run profiler in non-interactive mode where upon testbed setup the profiler does not wait for a keystroke but continues to run until a termination signal is received.
62.It Fl p Ar COUNT | Fl \-num-peers= Ns Ar COUNT 62.It Fl p Ar COUNT | Fl -num-peers= Ns Ar COUNT
63Create COUNT number of peers. 63Create COUNT number of peers.
64.It Fl v | \-version 64.It Fl v | -version
65Print GNUnet version number. 65Print GNUnet version number.
66.El 66.El
67.Sh SEE ALSO 67.Sh SEE ALSO
diff --git a/doc/man/gnunet-testing-run-service.1 b/doc/man/gnunet-testing-run-service.1
index 4f3c5c74b..5aa13fd22 100644
--- a/doc/man/gnunet-testing-run-service.1
+++ b/doc/man/gnunet-testing-run-service.1
@@ -30,9 +30,9 @@
30command line tool to start a service for testing 30command line tool to start a service for testing
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 34.Op Fl h | -help
35.Op Fl s Ar SERVICE | Fl \-service= Ns Ar SERVICE 35.Op Fl s Ar SERVICE | Fl -service= Ns Ar SERVICE
36.Sh DESCRIPTION 36.Sh DESCRIPTION
37.Nm 37.Nm
38is a command line tool to start a service for testing. 38is a command line tool to start a service for testing.
@@ -43,11 +43,11 @@ When reading the character 'r' from stdin, the running service is restarted with
43.Pp 43.Pp
44This executable is intended to be used by gnunet-java, in order to reliably start and stop services for test cases. 44This executable is intended to be used by gnunet-java, in order to reliably start and stop services for test cases.
45.Bl -tag -width indent 45.Bl -tag -width indent
46.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 46.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
47Name of the template configuration file to use (optional). 47Name of the template configuration file to use (optional).
48.It Fl h | \-help 48.It Fl h | -help
49Print short help on options. 49Print short help on options.
50.It Fl s Ar SERVICE | Fl \-service= Ns Ar SERVICE 50.It Fl s Ar SERVICE | Fl -service= Ns Ar SERVICE
51Name of the service to run. 51Name of the service to run.
52.El 52.El
53.Sh SEE ALSO 53.Sh SEE ALSO
diff --git a/doc/man/gnunet-testing.1 b/doc/man/gnunet-testing.1
index 659e46fbc..c1dad78e0 100644
--- a/doc/man/gnunet-testing.1
+++ b/doc/man/gnunet-testing.1
@@ -30,43 +30,43 @@
30command line tool to access the testing library 30command line tool to access the testing library
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl C | \-cfg 33.Op Fl C | -cfg
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 34.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl H | \-hostkeys 35.Op Fl H | -hostkeys
36.Op Fl h | \-help 36.Op Fl h | -help
37.Op Fl k | \-key 37.Op Fl k | -key
38.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 38.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
39.Op Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOFILE 39.Op Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOFILE
40.Op Fl n | \-number 40.Op Fl n | -number
41.Op Fl t | \-template 41.Op Fl t | -template
42.Op Fl v | \-version 42.Op Fl v | -version
43.Sh DESCRIPTION 43.Sh DESCRIPTION
44.Nm 44.Nm
45is a command line tool to access the testing library. 45is a command line tool to access the testing library.
46.Sh OPTIONS 46.Sh OPTIONS
47.Bl -tag -width indent 47.Bl -tag -width indent
48.It Fl C | \-cfg 48.It Fl C | -cfg
49Create unique configuration files. 49Create unique configuration files.
50.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 50.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
51Use the configuration file 51Use the configuration file
52.Ar FILENAME . 52.Ar FILENAME .
53.It Fl H | \-hostkeys 53.It Fl H | -hostkeys
54Host key file. 54Host key file.
55.It Fl h | \-help 55.It Fl h | -help
56Print short help on options. 56Print short help on options.
57.It Fl k | \-key 57.It Fl k | -key
58Create hostkey files from pre-computed hostkey list. 58Create hostkey files from pre-computed hostkey list.
59.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 59.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
60Use LOGLEVEL for logging. 60Use LOGLEVEL for logging.
61Valid values are DEBUG, INFO, WARNING and ERROR. 61Valid values are DEBUG, INFO, WARNING and ERROR.
62.It Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOFILE 62.It Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOFILE
63Configure logging to write logs to 63Configure logging to write logs to
64.Ar LOGFILE . 64.Ar LOGFILE .
65.It Fl n | \-number 65.It Fl n | -number
66Number of unique configuration files or hostkeys to create. 66Number of unique configuration files or hostkeys to create.
67.It Fl t | \-template 67.It Fl t | -template
68Configuration template. 68Configuration template.
69.It Fl v | \-version 69.It Fl v | -version
70Print GNUnet version number. 70Print GNUnet version number.
71.El 71.El
72.Sh SEE ALSO 72.Sh SEE ALSO
diff --git a/doc/man/gnunet-unindex.1 b/doc/man/gnunet-unindex.1
index 886793ed9..36d59edf0 100644
--- a/doc/man/gnunet-unindex.1
+++ b/doc/man/gnunet-unindex.1
@@ -30,27 +30,27 @@
30a command line interface for deleting indexed files from GNUnet 30a command line interface for deleting indexed files from GNUnet
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 34.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 35.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl v | \-version 36.Op Fl v | -version
37.Op Fl V | \-verbose 37.Op Fl V | -verbose
38FILENAME 38FILENAME
39.Sh DESCRIPTION 39.Sh DESCRIPTION
40.Nm 40.Nm
41is used for deleting indexed files from GNUnet. 41is used for deleting indexed files from GNUnet.
42.Bl -tag -width indent 42.Bl -tag -width indent
43.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 43.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
44Use config file FILENAME as config (default: 44Use config file FILENAME as config (default:
45.Pa ~/.config/gnunet.conf Ns ). 45.Pa ~/.config/gnunet.conf Ns ).
46.It Fl h | \-help 46.It Fl h | -help
47Print the help page. 47Print the help page.
48.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 48.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
49Change the loglevel. 49Change the loglevel.
50Possible values for LOGLEVEL are NOTHING, ERROR, WARNING, INFO and DEBUG. 50Possible values for LOGLEVEL are NOTHING, ERROR, WARNING, INFO and DEBUG.
51.It Fl v | \-version 51.It Fl v | -version
52Print the version number. 52Print the version number.
53.It Fl V | \-verbose 53.It Fl V | -verbose
54Be verbose. 54Be verbose.
55.El 55.El
56.Sh NOTES 56.Sh NOTES
diff --git a/doc/man/gnunet-uri.1 b/doc/man/gnunet-uri.1
index 1d8380631..38b901697 100644
--- a/doc/man/gnunet-uri.1
+++ b/doc/man/gnunet-uri.1
@@ -29,11 +29,11 @@
29.Nd invoke default handler for GNUnet URIs 29.Nd invoke default handler for GNUnet URIs
30.Sh SYNOPSIS 30.Sh SYNOPSIS
31.Nm 31.Nm
32.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
33.Op Fl h | \-help 33.Op Fl h | -help
34.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 34.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
35.Op Fl l | \-logfile= Ns Ar FILENAME 35.Op Fl l | -logfile= Ns Ar FILENAME
36.Op Fl v | \-version 36.Op Fl v | -version
37URI 37URI
38.Sh DESCRIPTION 38.Sh DESCRIPTION
39.Nm 39.Nm
@@ -43,17 +43,17 @@ thus the specific tool to handle the URI depends on the subsystem.
43gnunet-uri will determine the correct tool (by looking for SUBSYSTEM 43gnunet-uri will determine the correct tool (by looking for SUBSYSTEM
44in the configuration section "uri") and invoke it. 44in the configuration section "uri") and invoke it.
45.Bl -tag -width indent 45.Bl -tag -width indent
46.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 46.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
47Use the configuration file FILENAME. 47Use the configuration file FILENAME.
48.It Fl h | \-help 48.It Fl h | -help
49Print short help on options. 49Print short help on options.
50.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 50.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
51Use LOGLEVEL for logging. 51Use LOGLEVEL for logging.
52Valid values are DEBUG, INFO, WARNING and ERROR. 52Valid values are DEBUG, INFO, WARNING and ERROR.
53.It Fl l | \-logfile= Ns Ar FILENAME 53.It Fl l | -logfile= Ns Ar FILENAME
54Configure logging to write logs to 54Configure logging to write logs to
55.Ar FILENAME . 55.Ar FILENAME .
56.It Fl v | \-version 56.It Fl v | -version
57Print GNUnet version number. 57Print GNUnet version number.
58.El 58.El
59.Sh SEE ALSO 59.Sh SEE ALSO
diff --git a/doc/man/gnunet-vpn.1 b/doc/man/gnunet-vpn.1
index 477358f22..210476b79 100644
--- a/doc/man/gnunet-vpn.1
+++ b/doc/man/gnunet-vpn.1
@@ -29,19 +29,19 @@
29.Nd manually setup a GNUnet VPN tunnel 29.Nd manually setup a GNUnet VPN tunnel
30.Sh SYNOPSIS 30.Sh SYNOPSIS
31.Nm 31.Nm
32.Op Fl 4 | \-ipv4 32.Op Fl 4 | -ipv4
33.Op Fl 6 | \-ipv6 33.Op Fl 6 | -ipv6
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 34.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl d Ar TIME | Fl \-duration Ar TIME 35.Op Fl d Ar TIME | Fl -duration Ar TIME
36.Op Fl h | \-help 36.Op Fl h | -help
37.Op Fl i Ar IP | Fl \-ip Ar IP 37.Op Fl i Ar IP | Fl -ip Ar IP
38.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 38.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
39.Op Fl p Ar PEERID | Fl \-peer= Ns Ar PEERID 39.Op Fl p Ar PEERID | Fl -peer= Ns Ar PEERID
40.Op Fl s Ar NAME | Fl \-service= Ns Ar NAME 40.Op Fl s Ar NAME | Fl -service= Ns Ar NAME
41.Op Fl t | \-tcp 41.Op Fl t | -tcp
42.Op Fl u | \-udp 42.Op Fl u | -udp
43.Op Fl V | \-verbose 43.Op Fl V | -verbose
44.Op Fl v | \-version 44.Op Fl v | -version
45.Sh DESCRIPTION 45.Sh DESCRIPTION
46.Nm 46.Nm
47can be used to manually setup a VPN tunnel via the GNUnet network. 47can be used to manually setup a VPN tunnel via the GNUnet network.
@@ -70,41 +70,41 @@ The address can be displayed as soon as it has been allocated, or only after
70.Pq Fl a 70.Pq Fl a
71the tunnel has been created. 71the tunnel has been created.
72.Bl -tag -width indent 72.Bl -tag -width indent
73.It Fl 4 | \-ipv4 73.It Fl 4 | -ipv4
74Desired IP address on this end of the tunnel should be an IPv4 address. 74Desired IP address on this end of the tunnel should be an IPv4 address.
75.It Fl 6 | \-ipv6 75.It Fl 6 | -ipv6
76Desired IP address on this end of the tunnel should be an IPv6 address. 76Desired IP address on this end of the tunnel should be an IPv6 address.
77.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 77.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
78Use the configuration file FILENAME. 78Use the configuration file FILENAME.
79.It Fl d Ar TIME | Fl \-duration Ar TIME 79.It Fl d Ar TIME | Fl -duration Ar TIME
80The mapping should be established for TIME. 80The mapping should be established for TIME.
81The value given must be a number followed by a space and a time unit, for example "500 ms". 81The value given must be a number followed by a space and a time unit, for example "500 ms".
82Note that the quotes are required on the shell. 82Note that the quotes are required on the shell.
83The default vaue is 5 minutes. 83The default vaue is 5 minutes.
84.It Fl h | \-help 84.It Fl h | -help
85Print short help on options. 85Print short help on options.
86.It Fl i Ar IP | Fl \-ip Ar IP 86.It Fl i Ar IP | Fl -ip Ar IP
87Tunnel should be to an exit node and connect to the given IPv4 or IPv6 87Tunnel should be to an exit node and connect to the given IPv4 or IPv6
88IP address. 88IP address.
89Note that you can specify an IPv6 address as the target here, even in 89Note that you can specify an IPv6 address as the target here, even in
90combination with "\-4" (4to6) and similarly you can specify an IPv4 90combination with "-4" (4to6) and similarly you can specify an IPv4
91address in combination with "\-6" (6to4). 91address in combination with "-6" (6to4).
92.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 92.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
93Use LOGLEVEL for logging. 93Use LOGLEVEL for logging.
94Valid values are DEBUG, INFO, WARNING and ERROR. 94Valid values are DEBUG, INFO, WARNING and ERROR.
95.It Fl p Ar PEERID | Fl \-peer= Ns Ar PEERID 95.It Fl p Ar PEERID | Fl -peer= Ns Ar PEERID
96Name of the peer offering the service to connect to. 96Name of the peer offering the service to connect to.
97Cannot be used in conjunction with 97Cannot be used in conjunction with
98.Fl i , 98.Fl i ,
99requires 99requires
100.Fl s . 100.Fl s .
101.It Fl s Ar NAME | Fl \-service= Ns Ar NAME 101.It Fl s Ar NAME | Fl -service= Ns Ar NAME
102Name of the service running on the target peer. 102Name of the service running on the target peer.
103Cannot be used in conjunction with 103Cannot be used in conjunction with
104.Fl i , 104.Fl i ,
105requires 105requires
106.Fl p . 106.Fl p .
107.It Fl t | \-tcp 107.It Fl t | -tcp
108Service runs TCP. 108Service runs TCP.
109Either 109Either
110.Fl t 110.Fl t
@@ -112,7 +112,7 @@ or
112.Fl u 112.Fl u
113must be specified when using 113must be specified when using
114.Fl s . 114.Fl s .
115.It Fl u | \-udp 115.It Fl u | -udp
116Service runs UDP. 116Service runs UDP.
117Either 117Either
118.Fl t 118.Fl t
@@ -120,9 +120,9 @@ or
120.Fl u 120.Fl u
121must be specified when using 121must be specified when using
122.Fl s . 122.Fl s .
123.It Fl V | \-verbose 123.It Fl V | -verbose
124Be verbose. 124Be verbose.
125.It Fl v | \-version 125.It Fl v | -version
126Print GNUnet version number. 126Print GNUnet version number.
127.El 127.El
128.Sh SEE ALSO 128.Sh SEE ALSO
diff --git a/doc/man/gnunet-zoneimport.1 b/doc/man/gnunet-zoneimport.1
index f09544912..f3f60bfb4 100644
--- a/doc/man/gnunet-zoneimport.1
+++ b/doc/man/gnunet-zoneimport.1
@@ -30,11 +30,11 @@
30import DNS zone into GNS zone 30import DNS zone into GNS zone
31.Sh SYNOPSIS 31.Sh SYNOPSIS
32.Nm 32.Nm
33.Op Fl c Ar FILENAME | \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 34.Op Fl h | -help
35.Op Fl m Ar RELATIVETIME | Fl \-minimum-expiration= Ns Ar RELATIVETIME 35.Op Fl m Ar RELATIVETIME | Fl -minimum-expiration= Ns Ar RELATIVETIME
36.Op Fl s Ar MAPSIZE | Fl \-size= Ns Ar MAPSIZE 36.Op Fl s Ar MAPSIZE | Fl -size= Ns Ar MAPSIZE
37.Op Ar \IP 37.Ao Ar IP Ac
38.Sh DESCRIPTION 38.Sh DESCRIPTION
39.Nm 39.Nm
40reads a list of domain names (FQDN) from stdin and issues DNS queries for each of the domain names given. 40reads a list of domain names (FQDN) from stdin and issues DNS queries for each of the domain names given.
@@ -56,27 +56,27 @@ Thus, it is fine to restart gnunet-zoneimport whenever the list of domain names
56Finally, gnunet-zoneimport keeps information for each domain name in memory. 56Finally, gnunet-zoneimport keeps information for each domain name in memory.
57This consumes about 200 bytes per domain name, or 1 GB for 5 million labels. 57This consumes about 200 bytes per domain name, or 1 GB for 5 million labels.
58.Bl -tag -width indent 58.Bl -tag -width indent
59.It Fl c Ar FILENAME | \-config= Ns Ar FILENAME 59.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
60Use the configuration file FILENAME. 60Use the configuration file FILENAME.
61.It Fl h | \-help 61.It Fl h | -help
62Print short help on options. 62Print short help on options.
63.It Fl m Ar RELATIVETIME | Fl \-minimum-expiration= Ns Ar RELATIVETIME 63.It Fl m Ar RELATIVETIME | Fl -minimum-expiration= Ns Ar RELATIVETIME
64Ensure that imported DNS records never have an expiration time that is less than RELATIVETIME into the future. 64Ensure that imported DNS records never have an expiration time that is less than RELATIVETIME into the future.
65RELATIVETIME is a time given like "1 week" or "1 h". 65RELATIVETIME is a time given like "1 week" or "1 h".
66If 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). 66If 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).
67Default is zero. 67Default is zero.
68.It Fl s Ar MAPSIZE | Fl \-size= Ns Ar MAPSIZE 68.It Fl s Ar MAPSIZE | Fl -size= Ns Ar MAPSIZE
69Specifies the size (in number of entries) to use for the main hash map. 69Specifies the size (in number of entries) to use for the main hash map.
70The value provided should be at least twice the number of domain names that will be given to the tool. 70The value provided should be at least twice the number of domain names that will be given to the tool.
71This 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). 71This 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).
72Do not worry about this unless you are importing millions of domain names from a zone. 72Do not worry about this unless you are importing millions of domain names from a zone.
73.It Ar \IP 73.It Ao Ar IP Ac
74IP Is the list of IPs given. 74IP Is the list of IPs given.
75.El 75.El
76.Sh EXAMPLES 76.Sh EXAMPLES
77Typical invocaton would be: 77Typical invocation would be:
78.Pp 78.Pp
79.Dl $ gnunet\-zoneimport 1.2.3.4 < names.txt 79.Dl $ gnunet-zoneimport 1.2.3.4 < names.txt
80.Sh SEE ALSO 80.Sh SEE ALSO
81.Xr gnunet-gns 1 , 81.Xr gnunet-gns 1 ,
82.Xr gnunet-namestore 1 82.Xr gnunet-namestore 1
generated by cgit v1.2.3 (git 2.39.1) at 2024-04-16 22:44:04 +0000