aboutsummaryrefslogtreecommitdiff
path: root/doc/man
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man')
-rw-r--r--doc/man/gnunet-arm.130
-rw-r--r--doc/man/gnunet-auto-share.151
-rw-r--r--doc/man/gnunet-bcd.123
-rw-r--r--doc/man/gnunet-cadet.151
-rw-r--r--doc/man/gnunet-config.151
-rw-r--r--doc/man/gnunet-conversation-test.121
-rw-r--r--doc/man/gnunet-conversation.133
-rw-r--r--doc/man/gnunet-datastore.12
-rw-r--r--doc/man/gnunet-directory.119
-rw-r--r--doc/man/gnunet-download.151
-rw-r--r--doc/man/gnunet-ecc.135
-rw-r--r--doc/man/gnunet-fs.124
-rw-r--r--doc/man/gnunet-gns-proxy.129
-rw-r--r--doc/man/gnunet-gns.137
-rw-r--r--doc/man/gnunet-identity.12
-rw-r--r--doc/man/gnunet-namecache.127
-rw-r--r--doc/man/gnunet-namestore-fcfsd.123
-rw-r--r--doc/man/gnunet-namestore.19
-rw-r--r--doc/man/gnunet-nat-auto.127
-rw-r--r--doc/man/gnunet-nat-server.125
-rw-r--r--doc/man/gnunet-nat.143
-rw-r--r--doc/man/gnunet-peerinfo.147
-rw-r--r--doc/man/gnunet-publish.189
-rw-r--r--doc/man/gnunet-reclaim.171
-rw-r--r--doc/man/gnunet-resolver.127
-rw-r--r--doc/man/gnunet-revocation.141
-rw-r--r--doc/man/gnunet-scrypt.136
-rw-r--r--doc/man/gnunet-search.149
-rw-r--r--doc/man/gnunet-statistics.158
-rw-r--r--doc/man/gnunet-testbed-profiler.139
-rw-r--r--doc/man/gnunet-testing-run-service.115
-rw-r--r--doc/man/gnunet-testing.143
-rw-r--r--doc/man/gnunet-timeout.13
-rw-r--r--doc/man/gnunet-transport-certificate-creation.13
-rw-r--r--doc/man/gnunet-unindex.123
-rw-r--r--doc/man/gnunet-uri.120
-rw-r--r--doc/man/gnunet-vpn.156
-rw-r--r--doc/man/gnunet-zoneimport.129
38 files changed, 621 insertions, 641 deletions
diff --git a/doc/man/gnunet-arm.1 b/doc/man/gnunet-arm.1
index 7e15b171d..80d65ef94 100644
--- a/doc/man/gnunet-arm.1
+++ b/doc/man/gnunet-arm.1
@@ -55,39 +55,47 @@ ARM starts services on-demand or as configured and restarts them
55if they crash. 55if they crash.
56.Bl -tag -width indent 56.Bl -tag -width indent
57.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME 57.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
58Use the configuration file FILENAME. 58Use the configuration file
59.Pa FILENAME Ns .
59.It Fl d | -delete 60.It Fl d | -delete
60Delete config file and directory on exit. 61Delete configuration file and directory on exit.
61.It Fl e | -end 62.It Fl e | -end
62Shutdown all GNUnet services (including ARM itself). 63Shutdown all GNUnet services (including ARM itself).
63Running "gnunet-arm -e" is the usual way to shutdown a GNUnet peer. 64Running "gnunet-arm -e" is the usual way to shutdown a GNUnet peer.
64.It Fl E | -no-stderr 65.It Fl E | -no-stderr
65Don't let gnunet-arm inherit standard error. 66Don't let gnunet-arm inherit stderr (standard error).
66.It Fl h | -help 67.It Fl h | -help
67Print short help on options. 68Print short help on options.
68.It Fl i Ar SERVICE | Fl -init= Ns Ar SERVICE 69.It Fl i Ar SERVICE | Fl -init= Ns Ar SERVICE
69Starts the specified SERVICE if it is not already running. 70Starts the specified
71.Ar SERVICE
72if it is not already running.
70More specifically, this makes the service behave as if it were in 73More specifically, this makes the service behave as if it were in
71the default services list. 74the default services list.
72.It Fl I | -info 75.It Fl I | -info
73List all running services. 76List all running services.
74.It Fl k Ar SERVICE | Fl -kill= Ns Ar SERVICE 77.It Fl k Ar SERVICE | Fl -kill= Ns Ar SERVICE
75Stop the specified SERVICE if it is running. 78Stop
79.Ar SERVICE
80if it is running.
76While this will kill the service right now, the service may be 81While this will kill the service right now, the service may be
77restarted immediately if other services depend on it (service is 82restarted immediately if other services depend on it (the service is
78then started 'on-demand'). 83then started 'on-demand').
79If the service used to be a 'default' service, its default-service 84If the service used to be a 'default' service, its default-service
80status will be revoked. 85status will be revoked.
81If the service was not a default service, it will just 86If the service was not a default service, it will just
82be (temporarily) stopped, but could be re-started on-demand at any time. 87be (temporarily) stopped, but could be re-started on-demand at any time.
83.It Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME 88.It Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
84Write logs to FILENAME. 89Write logs to
90.Pa FILENAME Ns .
85.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL 91.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
86Use LOGLEVEL for logging. 92Use
93.Ar LOGLEVEL
94for logging.
87Valid values are DEBUG, INFO, WARNING and ERROR. 95Valid values are DEBUG, INFO, WARNING and ERROR.
88.It Fl m | -monitor 96.It Fl m | -monitor
89Monitor service activity of ARM. 97Monitor service activity of ARM.
90In this mode, the command will not terminate until the user presses CTRL-C. 98In this mode, the command will not terminate until the user presses CTRL-C (thus sending SIGTERM or SIGINT).
91.It Fl O | -no-stdout 99.It Fl O | -no-stdout
92Don't let gnunet-arm inherit standard output 100Don't let gnunet-arm inherit standard output
93.It Fl q | -quiet 101.It Fl q | -quiet
@@ -100,7 +108,9 @@ Naturally, if a service is demanded by a default service, it will
100then also be started. 108then also be started.
101Running "gnunet-arm -s" is the usual way to start a GNUnet peer. 109Running "gnunet-arm -s" is the usual way to start a GNUnet peer.
102.It Fl T DELAY | -timeout= Ns Ar DELAY 110.It Fl T DELAY | -timeout= Ns Ar DELAY
103Exit with error status if operation does not finish after DELAY 111Exit with error status if operation does not finish after
112.Ar DELAY Ns ,
113provided in number of microseconds.
104.It Fl v | -version 114.It Fl v | -version
105Print GNUnet version number. 115Print GNUnet version number.
106.El 116.El
diff --git a/doc/man/gnunet-auto-share.1 b/doc/man/gnunet-auto-share.1
index 0a0e8f702..939a75888 100644
--- a/doc/man/gnunet-auto-share.1
+++ b/doc/man/gnunet-auto-share.1
@@ -26,21 +26,20 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-auto-share 28.Nm gnunet-auto-share
29.Nd 29.Nd a 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 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 32.Op Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl D | \-disable-extractor 34.Op Fl D | -disable-extractor
36.Op Fl d | \-disable-creation-time 35.Op Fl d | -disable-creation-time
37.Op Fl h | \-help 36.Op Fl h | -help
38.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 37.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
39.Op Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 38.Op Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
40.Op Fl p Ar PRIORITY | Fl \-prio= Ns Ar PRIORITY 39.Op Fl p Ar PRIORITY | Fl -prio= Ns Ar PRIORITY
41.Op Fl r Ar LEVEL | Fl \-replication= Ns Ar LEVEL 40.Op Fl r Ar LEVEL | Fl -replication= Ns Ar LEVEL
42.Op Fl V | \-verbose 41.Op Fl V | -verbose
43.Op Fl v | \-version 42.Op Fl v | -version
44.Ao Ar DIRNAME Ac 43.Ao Ar DIRNAME Ac
45.Sh DESCRIPTION 44.Sh DESCRIPTION
46In order to share files with other GNUnet users, the files must first be made available to GNUnet. 45In order to share files with other GNUnet users, the files must first be made available to GNUnet.
@@ -55,7 +54,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). 54You can use automatic meta-data extraction (based on libextractor).
56The options are as follows: 55The options are as follows:
57.Bl -tag -width indent 56.Bl -tag -width indent
58.It Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 57.It Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
59This option can be used to specify additional anonymity constraints. 58This option can be used to specify additional anonymity constraints.
60The default is 1. 59The 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. 60If 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 +62,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). 62If 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. 63However, 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). 64You 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. 65This 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. 66This 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. 67However, 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: 68The 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. 69Given 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. 70The 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. 71Note 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 72.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
74Use alternate config file (if this option is not specified, the default is 73Use alternate config file (if this option is not specified, the default is
75.Pa ~/.config/gnunet.conf Ns ). 74.Pa ~/.config/gnunet.conf Ns ).
76.It Fl D | \-disable-extractor 75.It Fl D | -disable-extractor
77Disable use of GNU libextractor for finding additional keywords and metadata. 76Disable use of GNU libextractor for finding additional keywords and metadata.
78.It Fl d | \-disable-creation-time 77.It Fl d | -disable-creation-time
79Disable adding the creation time to the metadata of the uploaded file. 78Disable adding the creation time to the metadata of the uploaded file.
80.It Fl h | \-help 79.It Fl h | -help
81Print a brief help page with all the options. 80Print a brief help page with all the options.
82.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 81.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
83Change the loglevel. 82Change the loglevel.
84Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. 83Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
85.It Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 84.It Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
86Configure logging to write logs to FILENAME. 85Configure logging to write logs to FILENAME.
87.It Fl p Ar PRIORITY | Fl \-prio= Ns Ar PRIORITY 86.It Fl p Ar PRIORITY | Fl -prio= Ns Ar PRIORITY
88Executive summary: You probably don't need it. 87Executive summary: You probably don't need it.
89Set the priority of the published content (default: 365). 88Set the priority of the published content (default: 365).
90If the local database is full, GNUnet will discard the content with the lowest ranking. 89If the local database is full, GNUnet will discard the content with the lowest ranking.
91Note that ranks change over time depending on popularity. 90Note 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. 91The 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 92.It Fl r Ar LEVEL | Fl -replication= Ns Ar LEVEL
94Set the desired replication level. 93Set 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. 94If 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. 95This 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. 96Note that pushing content LEVEL times into the network does not guarantee that there will actually be LEVEL replicas.
98.It Fl V | \-verbose 97.It Fl V | -verbose
99Be verbose. 98Be 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. 99Using 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 100.It Fl v | -version
102Print the version number. 101Print the version number.
103.El 102.El
104.Sh EXAMPLES 103.Sh EXAMPLES
diff --git a/doc/man/gnunet-bcd.1 b/doc/man/gnunet-bcd.1
index 0a1399ba3..b12446cac 100644
--- a/doc/man/gnunet-bcd.1
+++ b/doc/man/gnunet-bcd.1
@@ -26,15 +26,14 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-bcd 28.Nm gnunet-bcd
29.Nd 29.Nd run HTTP server to create GNS business cards
30run HTTP server to create GNS business cards
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl p Ar PORT | Fl \-port= Ns Ar PORT 32.Op Fl p Ar PORT | Fl -port= Ns Ar PORT
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl h | \-help 34.Op Fl h | -help
36.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 35.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
37.Op Fl v | \-version 36.Op Fl v | -version
38.Sh DESCRIPTION 37.Sh DESCRIPTION
39.Nm 38.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. 39can 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 +44,16 @@ If it does not work for you, try installing the full TeXLive distribution first,
45.Xr apt 1 44.Xr apt 1
46execute "apt-get install texlive-full". 45execute "apt-get install texlive-full".
47.Bl -tag -width indent 46.Bl -tag -width indent
48.It Fl p Ar PORT | Fl \-port= Ns Ar PORT 47.It Fl p Ar PORT | Fl -port= Ns Ar PORT
49Run the HTTP server on port PORT. 48Run the HTTP server on port PORT.
50.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 49.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
51Use the configuration file FILENAME. 50Use the configuration file FILENAME.
52.It Fl h | \-help 51.It Fl h | -help
53Print short help on options. 52Print short help on options.
54.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 53.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
55Use LOGLEVEL for logging. 54Use LOGLEVEL for logging.
56Valid values are DEBUG, INFO, WARNING and ERROR. 55Valid values are DEBUG, INFO, WARNING and ERROR.
57.It Fl v | \-version 56.It Fl v | -version
58Print GNUnet version number. 57Print GNUnet version number.
59.El 58.El
60.Sh SEE ALSO 59.Sh SEE ALSO
diff --git a/doc/man/gnunet-cadet.1 b/doc/man/gnunet-cadet.1
index bb2ce637e..224ac98b4 100644
--- a/doc/man/gnunet-cadet.1
+++ b/doc/man/gnunet-cadet.1
@@ -26,22 +26,21 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-cadet 28.Nm gnunet-cadet
29.Nd 29.Nd create or obtain information about CADET tunnels and peers
30create or obtain information about CADET tunnels and peers
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl C Ar CONNECTION_ID | Fl \-connection= Ns Ar CONNECTION_ID 32.Op Fl C Ar CONNECTION_ID | Fl -connection= Ns Ar CONNECTION_ID
34.Op Fl d | \-dump 33.Op Fl d | -dump
35.Op Fl e | \-echo 34.Op Fl e | -echo
36.Op Fl o Ar SHARED_SECRET | Fl \-open-port= Ns Ar SHARED_SECRET 35.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 36.Op Fl p Ar PEER_ID | Fl -peer= Ns Ar PEER_ID
38.Op Fl P | \-peers 37.Op Fl P | -peers
39.Op Fl T | \-tunnels 38.Op Fl T | -tunnels
40.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 39.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
41.Op Fl h | \-help 40.Op Fl h | -help
42.Op Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 41.Op Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
43.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 42.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
44.Op Fl v | \-version 43.Op Fl v | -version
45.Ao Ar PEER_ID Ac 44.Ao Ar PEER_ID Ac
46.Ao Ar SHARED_SECRET Ac 45.Ao Ar SHARED_SECRET Ac
47.Sh DESCRIPTION 46.Sh DESCRIPTION
@@ -63,36 +62,36 @@ For one-to-many communication
63.Xr gnunet-social 1 62.Xr gnunet-social 1
64may be better suited, however. 63may be better suited, however.
65.Bl -tag -width indent 64.Bl -tag -width indent
66.It Fl C Ar CONNECTION_ID | Fl \-connection= Ns Ar CONNECTION_ID 65.It Fl C Ar CONNECTION_ID | Fl -connection= Ns Ar CONNECTION_ID
67Provide information about the connection 66Provide information about the connection
68.Ar CONNECTION_ID . 67.Ar CONNECTION_ID .
69.It Fl d | \-dump 68.It Fl d | -dump
70Dump debug information to stderr. 69Dump debug information to stderr.
71.It Fl e | \-echo 70.It Fl e | -echo
72Activate echo mode. 71Activate echo mode.
73.It Fl o Ar SHARED_SECRET | Fl \-open-port= Ns Ar SHARED_SECRET 72.It Fl o Ar SHARED_SECRET | Fl -open-port= Ns Ar SHARED_SECRET
74Listen for connections using a shared secret, provided as 73Listen for connections using a shared secret, provided as
75.Ar SHARED_SECRET , 74.Ar SHARED_SECRET ,
76among sender and recipient. 75among sender and recipient.
77.It Fl p Ar PEER_ID | Fl \-peer= Ns Ar PEER_ID 76.It Fl p Ar PEER_ID | Fl -peer= Ns Ar PEER_ID
78Provide information about the peer 77Provide information about the peer
79.Ar PEER_ID . 78.Ar PEER_ID .
80.It Fl P | \-peers 79.It Fl P | -peers
81Provide information about all (known) peers. 80Provide information about all (known) peers.
82.It Fl T | \-tunnels 81.It Fl T | -tunnels
83Provide information about all tunnels. 82Provide information about all tunnels.
84.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 83.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
85Use the configuration file 84Use the configuration file
86.Ar FILENAME . 85.Ar FILENAME .
87.It Fl h | \-help 86.It Fl h | -help
88Print the help page. 87Print the help page.
89.It Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 88.It Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
90Configure logging to write logs to 89Configure logging to write logs to
91.Ar FILENAME . 90.Ar FILENAME .
92.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 91.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
93Use LOGLEVEL for logging. 92Use LOGLEVEL for logging.
94Valid values are DEBUG, INFO, WARNING and ERROR. 93Valid values are DEBUG, INFO, WARNING and ERROR.
95.It Fl v | \-version 94.It Fl v | -version
96Print the GNUnet version number. 95Print the GNUnet version number.
97.El 96.El
98.Sh SEE ALSO 97.Sh SEE ALSO
diff --git a/doc/man/gnunet-config.1 b/doc/man/gnunet-config.1
index 95dc98811..f6166cbca 100644
--- a/doc/man/gnunet-config.1
+++ b/doc/man/gnunet-config.1
@@ -26,51 +26,50 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-config 28.Nm gnunet-config
29.Nd 29.Nd manipulate GNUnet configuration files
30manipulate GNUnet configuration files
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl b Ar BACKEND | Fl \-supported-backend= Ns Ar BACKEND 32.Op Fl b Ar BACKEND | Fl -supported-backend= Ns Ar BACKEND
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl f | \-filename 34.Op Fl f | -filename
36.Op Fl h | \-help 35.Op Fl h | -help
37.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 36.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
38.Op Fl o Ar OPTION | Fl \-option= Ns Ar OPTION 37.Op Fl o Ar OPTION | Fl -option= Ns Ar OPTION
39.Op Fl S |\-list-sections 38.Op Fl S |-list-sections
40.Op Fl s Ar SECTION | Fl \-section= Ns Ar SECTION 39.Op Fl s Ar SECTION | Fl -section= Ns Ar SECTION
41.Op Fl V Ar VALUE | Fl \-value Ar VALUE 40.Op Fl V Ar VALUE | Fl -value Ar VALUE
42.Op Fl v | \-version 41.Op Fl v | -version
43.Op Fl W | \-rewrite 42.Op Fl W | -rewrite
44.Sh DESCRIPTION 43.Sh DESCRIPTION
45.Nm 44.Nm
46can be used to read or modify GNUnet configuration files. 45can be used to read or modify GNUnet configuration files.
47.Bl -tag -width indent 46.Bl -tag -width indent
48.It Fl b Ar BACKEND | Fl \-supported-backend= Ns Ar BACKEND 47.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). 48Tests 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 49.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
51Use the configuration file FILENAME. 50Use the configuration file FILENAME.
52.It Fl f | \-filename 51.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). 52Try 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 53.It Fl h | -help
55Print short help on options. 54Print short help on options.
56.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 55.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
57Use LOGLEVEL for logging. 56Use LOGLEVEL for logging.
58Valid values are DEBUG, INFO, WARNING and ERROR. 57Valid values are DEBUG, INFO, WARNING and ERROR.
59.It Fl o Ar OPTION | Fl \-option= Ns Ar OPTION 58.It Fl o Ar OPTION | Fl -option= Ns Ar OPTION
60Which configuration option should be accessed or edited. 59Which configuration option should be accessed or edited.
61Required to set a value. 60Required to set a value.
62If not given, all values of a given section will be printed in the format "OPTION = VALUE". 61If not given, all values of a given section will be printed in the format "OPTION = VALUE".
63.It Fl S |\-list-sections 62.It Fl S |-list-sections
64List available configuration sections for use with \-\-section. 63List available configuration sections for use with --section.
65.It Fl s Ar SECTION | Fl \-section= Ns Ar SECTION 64.It Fl s Ar SECTION | Fl -section= Ns Ar SECTION
66Which configuration section should be accessed or edited. 65Which configuration section should be accessed or edited.
67Required option. 66Required option.
68.It Fl V Ar VALUE | Fl \-value Ar VALUE 67.It Fl V Ar VALUE | Fl -value Ar VALUE
69Configuration value to store in the given section under the given option. 68Configuration value to store in the given section under the given option.
70Must only be given together with \-s and \-o options. 69Must only be given together with -s and -o options.
71.It Fl v | \-version 70.It Fl v | -version
72Print GNUnet version number. 71Print GNUnet version number.
73.It Fl W | \-rewrite 72.It Fl W | -rewrite
74Consider differences to defaults only. 73Consider differences to defaults only.
75.El 74.El
76.Sh SEE ALSO 75.Sh SEE ALSO
diff --git a/doc/man/gnunet-conversation-test.1 b/doc/man/gnunet-conversation-test.1
index 1cc445f6f..c2b50ff79 100644
--- a/doc/man/gnunet-conversation-test.1
+++ b/doc/man/gnunet-conversation-test.1
@@ -26,30 +26,29 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-conversation-test 28.Nm gnunet-conversation-test
29.Nd 29.Nd check your speaker and microphone settings
30check your speaker and microphone settings
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 33.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 34.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl v | \-version 35.Op Fl v | -version
37.Ao Ar URI Ac 36.Ao Ar URI Ac
38.Sh DESCRIPTION 37.Sh DESCRIPTION
39.Nm 38.Nm
40can be used to check your speaker and microphone settings. 39can be used to check your speaker and microphone settings.
41It will record you for five seconds and then play the recording back to you. 40It 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). 41If 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. 42You can use gnunet-conversation-test without having a peer running on your computer.
44.Bl -tag -width indent 43.Bl -tag -width indent
45.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 44.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
46Use the configuration file FILENAME. 45Use the configuration file FILENAME.
47.It Fl h | \-help 46.It Fl h | -help
48Print short help on options. 47Print short help on options.
49.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 48.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
50Use LOGLEVEL for logging. 49Use LOGLEVEL for logging.
51Valid values are DEBUG, INFO, WARNING and ERROR. 50Valid values are DEBUG, INFO, WARNING and ERROR.
52.It Fl v | \-version 51.It Fl v | -version
53Print GNUnet version number. 52Print GNUnet version number.
54.El 53.El
55.\".Sh EXAMPLES 54.\".Sh EXAMPLES
diff --git a/doc/man/gnunet-conversation.1 b/doc/man/gnunet-conversation.1
index 62909224d..709cbed72 100644
--- a/doc/man/gnunet-conversation.1
+++ b/doc/man/gnunet-conversation.1
@@ -26,38 +26,37 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-conversation 28.Nm gnunet-conversation
29.Nd 29.Nd have a conversation with your peers
30have a conversation with your peers
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl e Ar NAME | Fl \-ego= Ns Ar NAME 33.Op Fl e Ar NAME | Fl -ego= Ns Ar NAME
35.Op Fl h | \-help 34.Op Fl h | -help
36.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 35.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
37.Op Fl p Ar LINE | Fl \-phone= Ns Ar LINE 36.Op Fl p Ar LINE | Fl -phone= Ns Ar LINE
38.Op Fl v | \-version 37.Op Fl v | -version
39.Ao Ar URI Ac 38.Ao Ar URI Ac
40.Sh DESCRIPTION 39.Sh DESCRIPTION
41.Nm 40.Nm
42can be used to have a conversation with other GNUnet users. 41can be used to have a conversation with other GNUnet users.
43You can make calls and receive incoming calls. 42You can make calls and receive incoming calls.
44You need to setup an ego using gnunet\-identity first. 43You 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). 44For 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. 45gnunet-conversation has an interactive help system via the /help command.
47.Bl -tag -width indent 46.Bl -tag -width indent
48.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 47.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
49Use the configuration file FILENAME. 48Use the configuration file FILENAME.
50.It Fl e Ar NAME | Fl \-ego= Ns Ar NAME 49.It Fl e Ar NAME | Fl -ego= Ns Ar NAME
51Specifies the NAME of the ego to use (for caller ID). 50Specifies the NAME of the ego to use (for caller ID).
52.It Fl h | \-help 51.It Fl h | -help
53Print short help on options. 52Print short help on options.
54.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 53.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
55Use LOGLEVEL for logging. 54Use LOGLEVEL for logging.
56Valid values are DEBUG, INFO, WARNING and ERROR. 55Valid values are DEBUG, INFO, WARNING and ERROR.
57.It Fl p Ar LINE | Fl \-phone= Ns Ar LINE 56.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. 57Optional 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. 58The default LINE is zero, which should be fine for most users.
60.It Fl v | \-version 59.It Fl v | -version
61Print GNUnet version number. 60Print GNUnet version number.
62.El 61.El
63.\".Sh EXAMPLES 62.\".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..8ea92edb2 100644
--- a/doc/man/gnunet-directory.1
+++ b/doc/man/gnunet-directory.1
@@ -26,14 +26,13 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-directory 28.Nm gnunet-directory
29.Nd 29.Nd display directories
30display directories
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 33.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 34.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl v | \-version 35.Op Fl v | -version
37.Ao Ar FILENAME Ac 36.Ao Ar FILENAME Ac
38.Sh DESCRIPTION 37.Sh DESCRIPTION
39.Nm 38.Nm
@@ -42,15 +41,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. 41The names of the directory files must be passed as command-line arguments to gnunet-directory.
43The options are as follows: 42The options are as follows:
44.Bl -tag -width indent 43.Bl -tag -width indent
45.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 44.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
46Configuration file to use. 45Configuration file to use.
47This option is useless, since gnunet-directory does not really depend on any configuration options. 46This option is useless, since gnunet-directory does not really depend on any configuration options.
48.It Fl h | \-help 47.It Fl h | -help
49Print the help page. 48Print the help page.
50.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 49.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
51Change the loglevel. 50Change the loglevel.
52Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. 51Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
53.It Fl v | \-version 52.It Fl v | -version
54Print the version number. 53Print the version number.
55.El 54.El
56.Ss NOTES 55.Ss NOTES
diff --git a/doc/man/gnunet-download.1 b/doc/man/gnunet-download.1
index 56f18e050..6244dbf6b 100644
--- a/doc/man/gnunet-download.1
+++ b/doc/man/gnunet-download.1
@@ -26,28 +26,27 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-download 28.Nm gnunet-download
29.Nd 29.Nd a command line interface for downloading files from GNUnet
30a command line interface for downloading files from GNUnet
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 32.Op Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl D | \-delete\-incomplete 34.Op Fl D | -delete-incomplete
36.Op Fl h | \-help 35.Op Fl h | -help
37.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 36.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
38.Op Fl n | \-no-network 37.Op Fl n | -no-network
39.Op Fl o Ar FILENAME | Fl \-output= Ns Ar FILENAME 38.Op Fl o Ar FILENAME | Fl -output= Ns Ar FILENAME
40.Op Fl p Ar DOWNLOADS | Fl \-parallelism= Ns Ar DOWNLOADS 39.Op Fl p Ar DOWNLOADS | Fl -parallelism= Ns Ar DOWNLOADS
41.Op Fl r Ar REQUESTS | Fl \-request-parallelism= Ns Ar REQUESTS 40.Op Fl r Ar REQUESTS | Fl -request-parallelism= Ns Ar REQUESTS
42.Op Fl R | \-recursive 41.Op Fl R | -recursive
43.Op Fl v | \-version 42.Op Fl v | -version
44.Op Fl V | \-verbose 43.Op Fl V | -verbose
45.Ao Ar GNUNET_URI Ac 44.Ao Ar GNUNET_URI Ac
46.Sh DESCRIPTION 45.Sh DESCRIPTION
47Download files from GNUnet. 46Download files from GNUnet.
48The options are as follows: 47The options are as follows:
49.Bl -tag -width indent 48.Bl -tag -width indent
50.It Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 49.It Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
51This option can be used to specify additional anonymity constraints. 50This option can be used to specify additional anonymity constraints.
52The default is 1. 51The 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. 52If 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 +61,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. 61Given 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. 62The 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. 63Note 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 64.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
66Use config file (default: 65Use config file (default:
67.Pa ~/.config/gnunet.conf Ns ) 66.Pa ~/.config/gnunet.conf Ns )
68.It Fl D | \-delete\-incomplete 67.It Fl D | -delete-incomplete
69Causes gnunet-download to delete incomplete downloads when aborted with CTRL-C. 68Causes 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. 69Note 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. 70Without 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. 71If gnunet-download runs to (normal) completion finishing the download, this option has no effect.
73.It Fl h | \-help 72.It Fl h | -help
74Print the help page. 73Print the help page.
75.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 74.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
76Change the loglevel. 75Change the loglevel.
77Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. 76Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
78.It Fl n | \-no-network 77.It Fl n | -no-network
79Only search locally, do not forward requests to other peers. 78Only search locally, do not forward requests to other peers.
80.It Fl o Ar FILENAME | Fl \-output= Ns Ar FILENAME 79.It Fl o Ar FILENAME | Fl -output= Ns Ar FILENAME
81Write the file to 80Write the file to
82.Ar FILENAME . 81.Ar FILENAME .
83Hint: when recursively downloading a directory, append a '/' to the end of the FILENAME to create a directory of that name. 82Hint: when recursively downloading a directory, append a '/' to the end of the FILENAME to create a directory of that name.
@@ -85,7 +84,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 84The final filename is constructed based on meta-data extracted using
86.Xr libextractor 1 85.Xr libextractor 1
87(if available). 86(if available).
88.It Fl p Ar DOWNLOADS | Fl \-parallelism= Ns Ar DOWNLOADS 87.It Fl p Ar DOWNLOADS | Fl -parallelism= Ns Ar DOWNLOADS
89Set the maximum number of allowed parallel downloads to 88Set the maximum number of allowed parallel downloads to
90.Ar DOWNLOADS . 89.Ar DOWNLOADS .
91More parallel downloads can, to some extent, improve the overall time to download content. 90More parallel downloads can, to some extent, improve the overall time to download content.
@@ -97,7 +96,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. 96can be used to limit the number of blocks that are concurrently requested.
98As a result, the value only matters for recursive downloads. 97As a result, the value only matters for recursive downloads.
99The default value is 32. 98The default value is 32.
100.It Fl r Ar REQUESTS | Fl \-request-parallelism= Ns Ar REQUESTS 99.It Fl r Ar REQUESTS | Fl -request-parallelism= Ns Ar REQUESTS
101Set the maximum number of parallel requests that is allowed. 100Set 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. 101If 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. 102This is useful since, for example, downloading dozens of multi-gigabyte files in parallel could exhaust memory resources and would hardly improve performance.
@@ -107,16 +106,16 @@ Consider raising this limit for large recursive downloads with many large files
107is not reached. 106is not reached.
108This option also only matters for recursive downloads. 107This option also only matters for recursive downloads.
109The default value is 4092. 108The default value is 4092.
110.It Fl R | \-recursive 109.It Fl R | -recursive
111Download directories recursively (and in parallel). 110Download directories recursively (and in parallel).
112Note that the URI must belong to a GNUnet directory and that the filename given to 111Note that the URI must belong to a GNUnet directory and that the filename given to
113.Fl o 112.Fl o
114must end in '.gnd' \(em otherwise, you will receive an error. 113must 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". 114You 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". 115However, 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 116.It Fl v | -version
118Print the version number. 117Print the version number.
119.It Fl V | \-verbose 118.It Fl V | -verbose
120Print progress information. 119Print progress information.
121.El 120.El
122.Ss NOTES 121.Ss NOTES
diff --git a/doc/man/gnunet-ecc.1 b/doc/man/gnunet-ecc.1
index d99b6c00b..cb8f8b45c 100644
--- a/doc/man/gnunet-ecc.1
+++ b/doc/man/gnunet-ecc.1
@@ -26,18 +26,17 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-ecc 28.Nm gnunet-ecc
29.Nd 29.Nd manipulate GNUnet ECC key files
30manipulate GNUnet ECC key files
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl g Ar COUNT | Fl \-generate-keys= Ns Ar COUNT 32.Op Fl g Ar COUNT | Fl -generate-keys= Ns Ar COUNT
34.Op Fl p | \-print-public-key 33.Op Fl p | -print-public-key
35.Op Fl P | \-print-private-key 34.Op Fl P | -print-private-key
36.Op Fl x | \-print-hex 35.Op Fl x | -print-hex
37.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 36.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
38.Op Fl h | \-help 37.Op Fl h | -help
39.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 38.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
40.Op Fl v | \-version 39.Op Fl v | -version
41.Ao Ar FILENAME Ac 40.Ao Ar FILENAME Ac
42.sp 41.sp
43.Sh DESCRIPTION 42.Sh DESCRIPTION
@@ -50,26 +49,26 @@ If the option
50.Fl p 49.Fl p
51is given, the corresponding public key will be printed to the console. 50is given, the corresponding public key will be printed to the console.
52.Bl -tag -width indent 51.Bl -tag -width indent
53.It Fl g Ar COUNT | Fl \-generate-keys= Ns Ar COUNT 52.It Fl g Ar COUNT | Fl -generate-keys= Ns Ar COUNT
54Create COUNT public-private key pairs and write them to FILENAME. 53Create COUNT public-private key pairs and write them to FILENAME.
55Used for creating a file for testing. 54Used for creating a file for testing.
56.It Fl p | \-print-public-key 55.It Fl p | -print-public-key
57Print the corresponding public key to stdout. 56Print the corresponding public key to stdout.
58This is the value used for PKEY records in GNS. 57This is the value used for PKEY records in GNS.
59.It Fl P | \-print-private-key 58.It Fl P | -print-private-key
60Print the corresponding private key to stdout. 59Print the corresponding private key to stdout.
61This is the value used for PKEY records in GNS. 60This is the value used for PKEY records in GNS.
62.It Fl x | \-print-hex 61.It Fl x | -print-hex
63Print the corresponding public key to stdout in HEX format. 62Print the corresponding public key to stdout in HEX format.
64Useful for comparing to Ed25519 keys in X.509 tools. 63Useful for comparing to Ed25519 keys in X.509 tools.
65.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 64.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
66Use the configuration file FILENAME. 65Use the configuration file FILENAME.
67.It Fl h | \-help 66.It Fl h | -help
68Print short help on options. 67Print short help on options.
69.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 68.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
70Use LOGLEVEL for logging. 69Use LOGLEVEL for logging.
71Valid values are DEBUG, INFO, WARNING and ERROR. 70Valid values are DEBUG, INFO, WARNING and ERROR.
72.It Fl v | \-version 71.It Fl v | -version
73Print GNUnet version number. 72Print GNUnet version number.
74.El 73.El
75.Sh SEE ALSO 74.Sh SEE ALSO
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..16b3b42f1 100644
--- a/doc/man/gnunet-gns-proxy.1
+++ b/doc/man/gnunet-gns-proxy.1
@@ -26,39 +26,38 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-gns-proxy 28.Nm gnunet-gns-proxy
29.Nd 29.Nd run a client-side GNS SOCKS proxy
30run a client side GNS SOCKS proxy
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl a Ar AUTHORITY | Fl \-authority= Ns Ar AUTHORITY 33.Op Fl a Ar AUTHORITY | Fl -authority= Ns Ar AUTHORITY
35.Op Fl p Ar PORT | Fl \-port= Ns Ar PORT 34.Op Fl p Ar PORT | Fl -port= Ns Ar PORT
36.Op Fl h | \-help 35.Op Fl h | -help
37.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 36.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
38.Op Fl v | \-version 37.Op Fl v | -version
39.Sh DESCRIPTION 38.Sh DESCRIPTION
40Most users will want to run this SOCKS proxy. 39Most users will want to run this SOCKS proxy.
41It can be used in combination with browsers that support the SOCKS 4a protocol. 40It can be used in combination with browsers that support the SOCKS 4a protocol.
42.Pp 41.Pp
43The proxy will perform SSL authentication of GNS names and rewrite GNS enabled HTML content. 42The 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. 43To 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. 44Thus "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 45.Bl -tag -width indent
47.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 46.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
48Use the configuration file FILENAME. 47Use the configuration file FILENAME.
49.It Fl a Ar AUTHORITY | Fl \-authority= Ns Ar AUTHORITY 48.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. 49Path 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]": 50The default port is specified in the configuration file for the gns service under "[gns-proxy]":
52"[gns-proxy]" 51"[gns-proxy]"
53PROXY_CACERT 52PROXY_CACERT
54.It Fl p Ar PORT | Fl \-port= Ns Ar PORT 53.It Fl p Ar PORT | Fl -port= Ns Ar PORT
55The port this proxy should listen on. Default is 7777. 54The port this proxy should listen on. Default is 7777.
56.It Fl h | \-help 55.It Fl h | -help
57Print short help on options. 56Print short help on options.
58.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 57.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
59Use LOGLEVEL for logging. 58Use LOGLEVEL for logging.
60Valid values are DEBUG, INFO, WARNING and ERROR. 59Valid values are DEBUG, INFO, WARNING and ERROR.
61.It Fl v | \-version 60.It Fl v | -version
62Print GNUnet version number. 61Print GNUnet version number.
63.El 62.El
64.\".Sh EXAMPLES 63.\".Sh EXAMPLES
diff --git a/doc/man/gnunet-gns.1 b/doc/man/gnunet-gns.1
index 0743290b4..5595981b0 100644
--- a/doc/man/gnunet-gns.1
+++ b/doc/man/gnunet-gns.1
@@ -26,47 +26,46 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-gns 28.Nm gnunet-gns
29.Nd 29.Nd access to GNU Name System
30access to GNU Name System
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 33.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 34.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 35.Op Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
37.Op Fl r | \-raw 36.Op Fl r | -raw
38.Op Fl t Ar TYPE | Fl \-type= Ns Ar TYPE 37.Op Fl t Ar TYPE | Fl -type= Ns Ar TYPE
39.Op Fl u Ar NAME | Fl \-lookup= Ns Ar NAME 38.Op Fl u Ar NAME | Fl -lookup= Ns Ar NAME
40.Op Fl v | \-version 39.Op Fl v | -version
41.Sh DESCRIPTION 40.Sh DESCRIPTION
42.Nm 41.Nm
43can be used to lookup and process GNU Name Service names. 42can be used to lookup and process GNU Name Service names.
44.Bl -tag -width indent 43.Bl -tag -width indent
45.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 44.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
46Use the configuration file FILENAME. 45Use the configuration file FILENAME.
47.It Fl h | \-help 46.It Fl h | -help
48Print short help on options. 47Print short help on options.
49.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 48.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
50Use LOGLEVEL for logging. 49Use LOGLEVEL for logging.
51Valid values are DEBUG, INFO, WARNING and ERROR. 50Valid values are DEBUG, INFO, WARNING and ERROR.
52.It Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 51.It Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
53Write logs to FILENAME. 52Write logs to FILENAME.
54.It Fl r | \-raw 53.It Fl r | -raw
55No unneeded output. 54No unneeded output.
56This is a quiet mode where only important information is displayed. 55This 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. 56For 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 57.It Fl t Ar TYPE | Fl -type= Ns Ar TYPE
59Resource Record Type (TYPE) to look for. 58Resource 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. 59Supported TYPE's are: A, AAAA, CNAME, NS, PKEY, PSEU, TLSA, SRV, SOA, MX, LEHO, VPN, REV, PTR, TXT.
61Defaults to "A". 60Defaults to "A".
62.It Fl u Ar NAME | Fl \-lookup= Ns Ar NAME 61.It Fl u Ar NAME | Fl -lookup= Ns Ar NAME
63Name to lookup. 62Name to lookup.
64Resolve the specified name using the GNU Name System. 63Resolve the specified name using the GNU Name System.
65.It Fl T Ar TIMEOUT | Fl \-timeout= Ns Ar TIMEOUT 64.It Fl T Ar TIMEOUT | Fl -timeout= Ns Ar TIMEOUT
66How much time to wait for a resolution to finish. 65How much time to wait for a resolution to finish.
67Example: "5s" for 5 seconds or "3m" for 3 minutes. 66Example: "5s" for 5 seconds or "3m" for 3 minutes.
68Defaults to "forver" (No timeout). 67Defaults to "forver" (No timeout).
69.It Fl v | \-version 68.It Fl v | -version
70Print GNUnet version number. 69Print GNUnet version number.
71.El 70.El
72.Sh DIAGNOSTICS 71.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..5917fe079 100644
--- a/doc/man/gnunet-namecache.1
+++ b/doc/man/gnunet-namecache.1
@@ -26,33 +26,32 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-namecache 28.Nm gnunet-namecache
29.Nd 29.Nd inspect namecache
30inspect namecache
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 33.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 34.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl n Ar NAME | Fl \-name= Ns Ar NAME 35.Op Fl n Ar NAME | Fl -name= Ns Ar NAME
37.Op Fl v | \-version 36.Op Fl v | -version
38.Op Fl z Ar PKEY | Fl \-zone= Ns Ar PKEY 37.Op Fl z Ar PKEY | Fl -zone= Ns Ar PKEY
39.Sh DESCRIPTION 38.Sh DESCRIPTION
40.Nm 39.Nm
41can be used to inspect values in the namecache. 40can 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. 41It 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 42.Bl -tag -width indent
44.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 43.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
45Use the configuration file FILENAME. 44Use the configuration file FILENAME.
46.It Fl h | \-help 45.It Fl h | -help
47Print short help on options. 46Print short help on options.
48.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 47.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
49Use LOGLEVEL for logging. 48Use LOGLEVEL for logging.
50Valid values are DEBUG, INFO, WARNING and ERROR. 49Valid values are DEBUG, INFO, WARNING and ERROR.
51.It Fl n Ar NAME | Fl \-name= Ns Ar NAME 50.It Fl n Ar NAME | Fl -name= Ns Ar NAME
52Name (label) of the record to display (mandatory option). 51Name (label) of the record to display (mandatory option).
53.It Fl v | \-version 52.It Fl v | -version
54Print GNUnet version number. 53Print GNUnet version number.
55.It Fl z Ar PKEY | Fl \-zone= Ns Ar PKEY 54.It Fl z Ar PKEY | Fl -zone= Ns Ar PKEY
56Specifies the public key of the zone to inspect (mandatory option) 55Specifies the public key of the zone to inspect (mandatory option)
57.El 56.El
58.\".Sh EXAMPLES 57.\".Sh EXAMPLES
diff --git a/doc/man/gnunet-namestore-fcfsd.1 b/doc/man/gnunet-namestore-fcfsd.1
index e1a09afe4..39bb9fcbc 100644
--- a/doc/man/gnunet-namestore-fcfsd.1
+++ b/doc/man/gnunet-namestore-fcfsd.1
@@ -26,15 +26,14 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-namestore-fcfsd 28.Nm gnunet-namestore-fcfsd
29.Nd 29.Nd HTTP 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 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 33.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 34.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl v | \-version 35.Op Fl v | -version
37.Op Fl z Ar EGO | \-zone= Ns Ar EGO 36.Op Fl z Ar EGO | -zone= Ns Ar EGO
38.Sh DESCRIPTION 37.Sh DESCRIPTION
39Most users will not want to run an FCFS-zone and thus will not need this program. 38Most users will not want to run an FCFS-zone and thus will not need this program.
40.Pp 39.Pp
@@ -58,16 +57,16 @@ After that, you can start the FCFSD service (possibly using
58.Pp 57.Pp
59The options are as follows: 58The options are as follows:
60.Bl -tag -width indent 59.Bl -tag -width indent
61.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 60.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
62Use the configuration file FILENAME. 61Use the configuration file FILENAME.
63.It Fl h | \-help 62.It Fl h | -help
64Print short help on options. 63Print short help on options.
65.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 64.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
66Use LOGLEVEL for logging. 65Use LOGLEVEL for logging.
67Valid values are DEBUG, INFO, WARNING and ERROR. 66Valid values are DEBUG, INFO, WARNING and ERROR.
68.It Fl v | \-version 67.It Fl v | -version
69Print GNUnet version number. 68Print GNUnet version number.
70.It Fl z Ar EGO | \-zone= Ns Ar EGO 69.It Fl z Ar EGO | -zone= Ns Ar EGO
71Specifies for which 70Specifies for which
72.Ar EGO 71.Ar EGO
73FCFSD should manage the zone. 72FCFSD should manage the zone.
diff --git a/doc/man/gnunet-namestore.1 b/doc/man/gnunet-namestore.1
index e53bb7d95..b9bbff027 100644
--- a/doc/man/gnunet-namestore.1
+++ b/doc/man/gnunet-namestore.1
@@ -26,8 +26,7 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-namestore 28.Nm gnunet-namestore
29.Nd 29.Nd manipulate GNU Name System (GNS) zone data
30manipulate GNU Name System (GNS) zone data
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl a | -add 32.Op Fl a | -add
@@ -61,11 +60,11 @@ Desired operation is adding a record.
61Use the configuration file FILENAME. 60Use the configuration file FILENAME.
62.It Fl d | -delete 61.It Fl d | -delete
63Desired operation is deleting records under the given name that match 62Desired operation is deleting records under the given name that match
64the specified type (\-t) and value (\-V). 63the specified type (-t) and value (-V).
65If type or value are not specified, it means that all types (or 64If type or value are not specified, it means that all types (or
66values) should be assumed to match (and possibly multiple or all 65values) should be assumed to match (and possibly multiple or all
67values under the given label will be deleted). 66values under the given label will be deleted).
68Specifying a label (\-n) is mandatory. 67Specifying a label (-n) is mandatory.
69Note that matching by expiration time or flags is (currently) not 68Note that matching by expiration time or flags is (currently) not
70supported. 69supported.
71.It Fl D | -display 70.It Fl D | -display
@@ -85,7 +84,7 @@ suggested name for this zone.
85Use LOGLEVEL for logging. 84Use LOGLEVEL for logging.
86Valid values are DEBUG, INFO, WARNING and ERROR. 85Valid values are DEBUG, INFO, WARNING and ERROR.
87.It Fl m | -monitor 86.It Fl m | -monitor
88Monitor changes to the zone on an ongoing basis (in contrast to \-D, 87Monitor changes to the zone on an ongoing basis (in contrast to -D,
89which merely displays the current records). 88which merely displays the current records).
90.It Fl n Ar NAME | Fl -name= Ns Ar NAME 89.It Fl n Ar NAME | Fl -name= Ns Ar NAME
91Label or name of the record to add/delete/display. 90Label 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..f5ec12d47 100644
--- a/doc/man/gnunet-nat-auto.1
+++ b/doc/man/gnunet-nat-auto.1
@@ -26,34 +26,33 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-nat-auto 28.Nm gnunet-nat-auto
29.Nd 29.Nd autoconfigure and test NAT traversal
30autoconfigure and test NAT traversal
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl a | \-auto 32.Op Fl a | -auto
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl S Ar NAME | Fl \-section= Ns Ar NAME 34.Op Fl S Ar NAME | Fl -section= Ns Ar NAME
36.Op Fl t | \-tcp 35.Op Fl t | -tcp
37.Op Fl u | \-udp 36.Op Fl u | -udp
38.Op Fl w | \-write 37.Op Fl w | -write
39.Sh DESCRIPTION 38.Sh DESCRIPTION
40.Nm 39.Nm
41allows testing various NAT traversal functions, as well as attempting auto-configuration. 40allows testing various NAT traversal functions, as well as attempting auto-configuration.
42The options are as follows: 41The options are as follows:
43.Bl -tag -width indent 42.Bl -tag -width indent
44.It Fl a | \-auto 43.It Fl a | -auto
45Attempt auto-configuration for NAT traversal. 44Attempt auto-configuration for NAT traversal.
46.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 45.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
47Use the configuration file 46Use the configuration file
48.Ar FILENAME . 47.Ar FILENAME .
49.It Fl S Ar NAME | Fl \-section= Ns Ar NAME 48.It Fl S Ar NAME | Fl -section= Ns Ar NAME
50Name of the configuration section with details about the configuration to test. 49Name of the configuration section with details about the configuration to test.
51For example "transport-tcp". 50For example "transport-tcp".
52.It Fl t | \-tcp 51.It Fl t | -tcp
53Use TCP. 52Use TCP.
54.It Fl u | \-udp 53.It Fl u | -udp
55Use UDP. 54Use UDP.
56.It Fl w | \-write 55.It Fl w | -write
57Write configuration to configuration file, useful in combination with auto-configuration 56Write configuration to configuration file, useful in combination with auto-configuration
58.Pq Fl a . 57.Pq Fl a .
59.El 58.El
diff --git a/doc/man/gnunet-nat-server.1 b/doc/man/gnunet-nat-server.1
index 77a5eec26..bb772139a 100644
--- a/doc/man/gnunet-nat-server.1
+++ b/doc/man/gnunet-nat-server.1
@@ -26,15 +26,14 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-nat-server 28.Nm gnunet-nat-server
29.Nd 29.Nd help GNUnet setup test network setup with NAT
30help GNUnet setup test network setup with NAT
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl d | \-daemonize 33.Op Fl d | -daemonize
35.Op Fl h | \-help 34.Op Fl h | -help
36.Op Fl L Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 35.Op Fl L Ar FILENAME | Fl -logfile= Ns Ar FILENAME
37.Op Fl v | \-version 36.Op Fl v | -version
38.Ao Ar PORT Ac 37.Ao Ar PORT Ac
39.Sh DESCRIPTION 38.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. 39Running 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 +59,20 @@ In fact, distributions are encouraged to consider not shipping it at all.
60.Pp 59.Pp
61The options are as follows: 60The options are as follows:
62.Bl -tag -width indent 61.Bl -tag -width indent
63.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 62.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
64Use the configuration file 63Use the configuration file
65.Ar FILENAME . 64.Ar FILENAME .
66.It Fl d | \-daemonize 65.It Fl d | -daemonize
67Daemonize gnunet-nat-server (detach from terminal). 66Daemonize gnunet-nat-server (detach from terminal).
68.It Fl h | \-help 67.It Fl h | -help
69Print the help page. 68Print the help page.
70.It Fl L Ar LOGLEVEL | Fl \-log= Ns Ar LOGLEVEL 69.It Fl L Ar LOGLEVEL | Fl -log= Ns Ar LOGLEVEL
71Configure logging to use 70Configure logging to use
72.Ar LOGLEVEL . 71.Ar LOGLEVEL .
73.It Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 72.It Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
74Configure logging to write logs to 73Configure logging to write logs to
75.Ar FILENAME . 74.Ar FILENAME .
76.It Fl v | \-version 75.It Fl v | -version
77Print the GNUnet version. 76Print the GNUnet version.
78.El 77.El
79.\".Sh EXAMPLES 78.\".Sh EXAMPLES
diff --git a/doc/man/gnunet-nat.1 b/doc/man/gnunet-nat.1
index 1ffdc5c7c..585b84605 100644
--- a/doc/man/gnunet-nat.1
+++ b/doc/man/gnunet-nat.1
@@ -26,45 +26,44 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-nat 28.Nm gnunet-nat
29.Nd 29.Nd interact with the NAT service
30interact with the NAT service
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl b Ar ADDRESS | Fl \-bind= Ns Ar ADDRESS 32.Op Fl b Ar ADDRESS | Fl -bind= Ns Ar ADDRESS
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl e Ar ADDRESS | Fl \-external= Ns Ar ADDRESS 34.Op Fl e Ar ADDRESS | Fl -external= Ns Ar ADDRESS
36.Op Fl i Ar ADDRESS | Fl \-in= Ns Ar ADDRESS 35.Op Fl i Ar ADDRESS | Fl -in= Ns Ar ADDRESS
37.Op Fl r Ar ADDRESS | Fl \-remote= Ns Ar ADDRESS 36.Op Fl r Ar ADDRESS | Fl -remote= Ns Ar ADDRESS
38.Op Fl S Ar NAME | Fl \-section= Ns Ar NAME 37.Op Fl S Ar NAME | Fl -section= Ns Ar NAME
39.Op Fl s | \-stun 38.Op Fl s | -stun
40.Op Fl t | \-tcp 39.Op Fl t | -tcp
41.Op Fl u | \-udp 40.Op Fl u | -udp
42.Op Fl W | \-watch 41.Op Fl W | -watch
43.Sh DESCRIPTION 42.Sh DESCRIPTION
44This tool allows testing various NAT traversal functions, as well as attempting auto-configuration. 43This tool allows testing various NAT traversal functions, as well as attempting auto-configuration.
45.Sh OPTIONS 44.Sh OPTIONS
46.Bl -tag -width indent 45.Bl -tag -width indent
47.It Fl b Ar ADDRESS | Fl \-bind= Ns Ar ADDRESS 46.It Fl b Ar ADDRESS | Fl -bind= Ns Ar ADDRESS
48Assume that the service is (locally) bound to ADDRESS. 47Assume that the service is (locally) bound to ADDRESS.
49.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 48.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
50Use the configuration file FILENAME. 49Use the configuration file FILENAME.
51.It Fl e Ar ADDRESS | Fl \-external= Ns Ar ADDRESS 50.It Fl e Ar ADDRESS | Fl -external= Ns Ar ADDRESS
52Assume that ADDRESS is the globally visible address of the peer. 51Assume that ADDRESS is the globally visible address of the peer.
53.It Fl i Ar ADDRESS | Fl \-in= Ns Ar ADDRESS 52.It Fl i Ar ADDRESS | Fl -in= Ns Ar ADDRESS
54Assuming we are listening at ADDRESS for connection reversal requests. 53Assuming we are listening at ADDRESS for connection reversal requests.
55.It Fl r Ar ADDRESS | Fl \-remote= Ns Ar ADDRESS 54.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. 55Ask 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 56.It Fl S Ar NAME | Fl -section= Ns Ar NAME
58Name of section in configuration file to use for additional options. 57Name of section in configuration file to use for additional options.
59.It Fl s | \-stun 58.It Fl s | -stun
60Enable processing of STUN requests. 59Enable processing of STUN requests.
61Will try to read UDP packets from the bind address and handle the packets if they are STUN packets. 60Will try to read UDP packets from the bind address and handle the packets if they are STUN packets.
62Will only work with UDP. 61Will only work with UDP.
63.It Fl t | \-tcp 62.It Fl t | -tcp
64Use TCP. 63Use TCP.
65.It Fl u | \-udp 64.It Fl u | -udp
66Use UDP. 65Use UDP.
67.It Fl W | \-watch 66.It Fl W | -watch
68Watch for connection reversal requests. 67Watch for connection reversal requests.
69.El 68.El
70.Sh EXAMPLES 69.Sh EXAMPLES
diff --git a/doc/man/gnunet-peerinfo.1 b/doc/man/gnunet-peerinfo.1
index 143295dad..94951af86 100644
--- a/doc/man/gnunet-peerinfo.1
+++ b/doc/man/gnunet-peerinfo.1
@@ -26,50 +26,49 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-peerinfo 28.Nm gnunet-peerinfo
29.Nd 29.Nd display information about other peers
30display information about other peers
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl g | \-get\-hello 33.Op Fl g | -get-hello
35.Op Fl h | \-help 34.Op Fl h | -help
36.Op Fl i | \-info 35.Op Fl i | -info
37.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 36.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
38.Op Fl l Ar LOGFILE | Fl \-logfile= ns Ar LOGFILE 37.Op Fl l Ar LOGFILE | Fl -logfile= ns Ar LOGFILE
39.Op Fl n | \-numeric 38.Op Fl n | -numeric
40.Op Fl p Ar HELLO | Fl \-put\-hello= Ns Ar HELLO 39.Op Fl p Ar HELLO | Fl -put-hello= Ns Ar HELLO
41.Op Fl q | \-quiet 40.Op Fl q | -quiet
42.Op Fl s | \-self 41.Op Fl s | -self
43.Op Fl v | \-version 42.Op Fl v | -version
44.Sh DESCRIPTION 43.Sh DESCRIPTION
45.Nm 44.Nm
46displays the known addresses and trust of known peers. 45displays the known addresses and trust of known peers.
47.Bl -tag -width indent 46.Bl -tag -width indent
48.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 47.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
49Load config file, default FILENAME of the config is 48Load config file, default FILENAME of the config is
50.Pa ~/.config/gnunet.conf . 49.Pa ~/.config/gnunet.conf .
51.It Fl g | \-get\-hello 50.It Fl g | -get-hello
52Output HELLO uri(s) 51Output HELLO uri(s)
53.It Fl h | \-help 52.It Fl h | -help
54Print the help page. 53Print the help page.
55.It Fl i | \-info 54.It Fl i | -info
56List all known peers (and their addresses). 55List all known peers (and their addresses).
57.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 56.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
58Set the loglevel 57Set the loglevel
59.It Fl l Ar LOGFILE | Fl \-logfile= ns Ar LOGFILE 58.It Fl l Ar LOGFILE | Fl -logfile= ns Ar LOGFILE
60Log messages to LOGFILE 59Log messages to LOGFILE
61.It Fl n | \-numeric 60.It Fl n | -numeric
62Disable resolution of IPs to hostnames 61Disable resolution of IPs to hostnames
63.It Fl p Ar HELLO | Fl \-put\-hello= Ns Ar HELLO 62.It Fl p Ar HELLO | Fl -put-hello= Ns Ar HELLO
64Add given HELLO uri to the database 63Add given HELLO uri to the database
65.It Fl q | \-quiet 64.It Fl q | -quiet
66Do not print anything but the peer identities 65Do not print anything but the peer identities
67.It Fl s | \-self 66.It Fl s | -self
68Print only our own identity. 67Print only our own identity.
69Together with 68Together with
70.Fl q , 69.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. 70this 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 71.It Fl v | -version
73Print the version number 72Print the version number
74.El 73.El
75.Sh SEE ALSO 74.Sh SEE ALSO
diff --git a/doc/man/gnunet-publish.1 b/doc/man/gnunet-publish.1
index 04293102c..b6985463a 100644
--- a/doc/man/gnunet-publish.1
+++ b/doc/man/gnunet-publish.1
@@ -26,29 +26,28 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-publish 28.Nm gnunet-publish
29.Nd 29.Nd a command line interface for publishing new content into GNUnet
30a command line interface for publishing new content into GNUnet
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 32.Op Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl D | \-disable\-extractor 34.Op Fl D | -disable-extractor
36.Op Fl E | \-enable\-creation\-time 35.Op Fl E | -enable-creation-time
37.Op Fl e | \-extract 36.Op Fl e | -extract
38.Op Fl h | \-help 37.Op Fl h | -help
39.Op Fl k Ar KEYWORD | Fl \-key= Ns Ar KEYWORD 38.Op Fl k Ar KEYWORD | Fl -key= Ns Ar KEYWORD
40.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 39.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
41.Op Fl m Ar TYPE:VALUE | Fl \-meta= Ns Ar TYPE:VALUE 40.Op Fl m Ar TYPE:VALUE | Fl -meta= Ns Ar TYPE:VALUE
42.Op Fl n | \-noindex 41.Op Fl n | -noindex
43.Op Fl N Ar ID | Fl \-next= Ns Ar ID 42.Op Fl N Ar ID | Fl -next= Ns Ar ID
44.Op Fl p Ar PRIORITY | Fl \-prio= Ns Ar PRIORITY 43.Op Fl p Ar PRIORITY | Fl -prio= Ns Ar PRIORITY
45.Op Fl P Ar NAME | Fl \-pseudonym= Ns Ar NAME 44.Op Fl P Ar NAME | Fl -pseudonym= Ns Ar NAME
46.Op Fl r Ar LEVEL | Fl \-replication= Ns Ar LEVEL 45.Op Fl r Ar LEVEL | Fl -replication= Ns Ar LEVEL
47.Op Fl s | \-simulate-only 46.Op Fl s | -simulate-only
48.Op Fl t Ar ID | Fl \-this= Ns Ar ID 47.Op Fl t Ar ID | Fl -this= Ns Ar ID
49.Op Fl u Ar URI | Fl \-uri= Ns Ar URI 48.Op Fl u Ar URI | Fl -uri= Ns Ar URI
50.Op Fl v | \-version 49.Op Fl v | -version
51.Op Fl V | \-verbose 50.Op Fl V | -verbose
52.Ao Ar FILENAME Ac 51.Ao Ar FILENAME Ac
53.Sh DESCRIPTION 52.Sh DESCRIPTION
54In order to share files with other GNUnet users, the files must first be made available to GNUnet. 53In order to share files with other GNUnet users, the files must first be made available to GNUnet.
@@ -109,10 +108,10 @@ to specify meta-data.
109For the 108For the
110.Fl m 109.Fl m
111option you need to use the form keyword-type:value. 110option you need to use the form keyword-type:value.
112For example, use "\-m os:Linux" to specify that the operating system is Linux. 111For 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". 112Common 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 113A full list can be obtained from the extract tool using the option
115.Fl \-list . 114.Fl -list .
116The meta-data is used to help users in searching for files on the network. 115The meta-data is used to help users in searching for files on the network.
117The keywords are case-sensitive. 116The keywords are case-sensitive.
118.Pp 117.Pp
@@ -128,7 +127,7 @@ If you publish or index a file and then leave the network, it will almost always
128.Pp 127.Pp
129The options are as follows: 128The options are as follows:
130.Bl -tag -width indent 129.Bl -tag -width indent
131.It Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 130.It Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
132This option can be used to specify additional anonymity constraints. 131This option can be used to specify additional anonymity constraints.
133The default is 1. 132The 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. 133If 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 +142,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. 142Given 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. 143The 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. 144Note 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 145.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
147Use alternate config file FILENAME. 146Use alternate config file FILENAME.
148If this option is not specified, the default is 147If this option is not specified, the default is
149.Pa ~/.config/gnunet.conf . 148.Pa ~/.config/gnunet.conf .
150.It Fl D | \-disable\-extractor 149.It Fl D | -disable-extractor
151Disable use of GNU libextractor for finding additional keywords and metadata. 150Disable use of GNU libextractor for finding additional keywords and metadata.
152.It Fl E | \-enable\-creation\-time 151.It Fl E | -enable-creation-time
153Enable use of creation time timestamp in metadata. 152Enable use of creation time timestamp in metadata.
154Setting this information will leak information about the time at which a file was made available. 153Setting this information will leak information about the time at which a file was made available.
155.It Fl e | \-extract 154.It Fl e | -extract
156Print the list of keywords that will be used for each file given the current options. 155Print the list of keywords that will be used for each file given the current options.
157Do not perform any indexing or publishing. 156Do not perform any indexing or publishing.
158.It Fl h | \-help 157.It Fl h | -help
159Print the help page. 158Print the help page.
160.It Fl k Ar KEYWORD | Fl \-key= Ns Ar KEYWORD 159.It Fl k Ar KEYWORD | Fl -key= Ns Ar KEYWORD
161Additional key to index the content with (to add multiple keys, specify multiple times). 160Additional key to index the content with (to add multiple keys, specify multiple times).
162Each additional key is case\-sensitive. 161Each additional key is case-sensitive.
163Can be specified multiple times. 162Can be specified multiple times.
164The keyword is only applied to the top\-level file or directory. 163The keyword is only applied to the top-level file or directory.
165.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 164.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
166Change the loglevel. 165Change the loglevel.
167Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. 166Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
168.It Fl m Ar TYPE:VALUE | Fl \-meta= Ns Ar TYPE:VALUE 167.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. 168For 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. 169Note 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 170.It Fl n | -noindex
172Executive summary: You probably don't need it. 171Executive summary: You probably don't need it.
173Do not index, full publishing. 172Do not index, full publishing.
174Note that directories, information for keyword search, namespace search and indexing data are always published (even without this option). 173Note 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. 174With 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. 175While 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 176.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. 177Specifies 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 178This option is only valid together with the
180.Fl P 179.Fl P
@@ -187,36 +186,36 @@ and
187without 186without
188.Fl t 187.Fl t
189is not allowed. 188is not allowed.
190.It Fl p Ar PRIORITY | Fl \-prio= Ns Ar PRIORITY 189.It Fl p Ar PRIORITY | Fl -prio= Ns Ar PRIORITY
191Executive summary: You probably don't need it. 190Executive summary: You probably don't need it.
192Set the priority of the published content (default: 365). 191Set the priority of the published content (default: 365).
193If the local database is full, GNUnet will discard the content with the lowest ranking. 192If the local database is full, GNUnet will discard the content with the lowest ranking.
194Note that ranks change over time depending on popularity. 193Note 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. 194The 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 195.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. 196For 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 197NAME must be a valid pseudonym managed by
199.Xr gnunet-identity 1 . 198.Xr gnunet-identity 1 .
200.It Fl r Ar LEVEL | Fl \-replication= Ns Ar LEVEL 199.It Fl r Ar LEVEL | Fl -replication= Ns Ar LEVEL
201Set the desired replication level. 200Set 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. 201If 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. 202This 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. 203Note that pushing content LEVEL times into the network does not guarantee that there will actually be LEVEL replicas.
205.It Fl s | \-simulate-only 204.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. 205When 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. 206This 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 207.It Fl t Ar ID | Fl -this= Ns Ar ID
209Specifies the identifier under which the file is to be published under a pseudonym. 208Specifies the identifier under which the file is to be published under a pseudonym.
210This option is only valid together with the 209This option is only valid together with the
211.Fl P 210.Fl P
212option. 211option.
213.It Fl u Ar URI | Fl \-uri= Ns Ar URI 212.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). 213This 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. 214Instead 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. 215This 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 216.It Fl v | -version
218Print the version number. 217Print the version number.
219.It Fl V | \-verbose 218.It Fl V | -verbose
220Be verbose. 219Be 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. 220Using 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 221.El
diff --git a/doc/man/gnunet-reclaim.1 b/doc/man/gnunet-reclaim.1
index c1ab0d1aa..049bff155 100644
--- a/doc/man/gnunet-reclaim.1
+++ b/doc/man/gnunet-reclaim.1
@@ -26,66 +26,65 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-reclaim 28.Nm gnunet-reclaim
29.Nd 29.Nd Command-line tools for re:claimID subsystem
30Command-line tools for re:claimID subsystem
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 33.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 34.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOGFILE 35.Op Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
37.Op Fl e Ar EGO | Fl \-ego= Ns Ar EGO 36.Op Fl e Ar EGO | Fl -ego= Ns Ar EGO
38.Op Fl a Ar NAME | Fl \-add= Ns Ar NAME 37.Op Fl a Ar NAME | Fl -add= Ns Ar NAME
39.Op Fl V Ar VALUE | Fl \-value= Ns Ar VALUE 38.Op Fl V Ar VALUE | Fl -value= Ns Ar VALUE
40.Op Fl d Ar ID | Fl \-delete= Ns Ar ID 39.Op Fl d Ar ID | Fl -delete= Ns Ar ID
41.Op Fl r Ar RP | Fl \-rp= Ns Ar RP 40.Op Fl r Ar RP | Fl -rp= Ns Ar RP
42.Op Fl D | \-dump 41.Op Fl D | -dump
43.Op Fl i Ar A1,A2,... | Fl \-issue= Ns Ar A1,A2,... 42.Op Fl i Ar A1,A2,... | Fl -issue= Ns Ar A1,A2,...
44.Op Fl C Ar TICKET | Fl \-consume= Ns Ar TICKET 43.Op Fl C Ar TICKET | Fl -consume= Ns Ar TICKET
45.Op Fl R Ar TICKET | Fl \-revoke= Ns Ar TICKET 44.Op Fl R Ar TICKET | Fl -revoke= Ns Ar TICKET
46.Op Fl t Ar TYPE | Fl \-type= Ns Ar TYPE 45.Op Fl t Ar TYPE | Fl -type= Ns Ar TYPE
47.Op Fl T | \-tickets 46.Op Fl T | -tickets
48.Op Fl E Ar INTERVAL | Fl \-expiration= Ns Ar INTERVAL 47.Op Fl E Ar INTERVAL | Fl -expiration= Ns Ar INTERVAL
49.Op Fl v | \-version 48.Op Fl v | -version
50.Sh DESCRIPTION 49.Sh DESCRIPTION
51.Nm 50.Nm
52allows you to manage identity attributes and manage authorizations. 51allows you to manage identity attributes and manage authorizations.
53.Bl -tag -width indent 52.Bl -tag -width indent
54.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 53.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
55Use the configuration file FILENAME. 54Use the configuration file FILENAME.
56.It Fl h | \-help 55.It Fl h | -help
57Print short help on options. 56Print short help on options.
58.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 57.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
59Use LOGLEVEL for logging. 58Use LOGLEVEL for logging.
60Valid values are DEBUG, INFO, WARNING and ERROR. 59Valid values are DEBUG, INFO, WARNING and ERROR.
61.It Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOGFILE 60.It Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
62Configure logging to write logs to LOGFILE. 61Configure logging to write logs to LOGFILE.
63.It Fl e Ar EGO | Fl \-ego= Ns Ar EGO 62.It Fl e Ar EGO | Fl -ego= Ns Ar EGO
64Specify identity to use. Always required. 63Specify identity to use. Always required.
65.It Fl a Ar NAME | Fl \-add= Ns Ar NAME 64.It Fl a Ar NAME | Fl -add= Ns Ar NAME
66Add an attribute with NAME. Must be used in conjunction with -V 65Add an attribute with NAME. Must be used in conjunction with -V
67.It Fl V Ar VALUE | Fl \-value= Ns Ar VALUE 66.It Fl V Ar VALUE | Fl -value= Ns Ar VALUE
68Specify value of attribute to add. 67Specify value of attribute to add.
69.It Fl t Ar TYPE | Fl \-type= Ns Ar TYPE 68.It Fl t Ar TYPE | Fl -type= Ns Ar TYPE
70Specify type of attribute to add (Default: STRING) 69Specify type of attribute to add (Default: STRING)
71.It Fl d Ar ID | Fl \-delete= Ns Ar ID 70.It Fl d Ar ID | Fl -delete= Ns Ar ID
72Delete an attribute with ID. 71Delete an attribute with ID.
73.It Fl E Ar INTERVAL | Fl \-expiration= Ns Ar INTERVAL 72.It Fl E Ar INTERVAL | Fl -expiration= Ns Ar INTERVAL
74Specify relative expiration interval (freshness) of attribute. 73Specify relative expiration interval (freshness) of attribute.
75.It Fl D | \-dump 74.It Fl D | -dump
76List all attributes for given identity. 75List all attributes for given identity.
77.It Fl i Ar A1,A2,... | Fl \-issue= Ns Ar A1,A2,... 76.It Fl i Ar A1,A2,... | Fl -issue= Ns Ar A1,A2,...
78Authorize a relying party to access a set of attributes. Must be 77Authorize a relying party to access a set of attributes. Must be
79used in conjunction with -r. Returns a TICKET. 78used in conjunction with -r. Returns a TICKET.
80.It Fl r Ar RP | Fl \-rp= Ns Ar RP 79.It Fl r Ar RP | Fl -rp= Ns Ar RP
81The relying party to authorize (see -i). RP is a PKEY of the entity. 80The relying party to authorize (see -i). RP is a PKEY of the entity.
82.It Fl C Ar TICKET | Fl \-consume= Ns Ar TICKET 81.It Fl C Ar TICKET | Fl -consume= Ns Ar TICKET
83Consume TICKET and retrieve shared attributes. To be used by RP. 82Consume TICKET and retrieve shared attributes. To be used by RP.
84.It Fl R Ar TICKET | Fl \-revoke= Ns Ar TICKET 83.It Fl R Ar TICKET | Fl -revoke= Ns Ar TICKET
85Revoke TICKET. To be used by identity which issued TICKET. 84Revoke TICKET. To be used by identity which issued TICKET.
86.It Fl T | \-tickets 85.It Fl T | -tickets
87List issued tickets. 86List issued tickets.
88.It Fl v | \-version 87.It Fl v | -version
89Print GNUnet version number. 88Print GNUnet version number.
90.El 89.El
91.\".Sh EXAMPLES 90.\".Sh EXAMPLES
diff --git a/doc/man/gnunet-resolver.1 b/doc/man/gnunet-resolver.1
index 843b4e2a0..71ec25b77 100644
--- a/doc/man/gnunet-resolver.1
+++ b/doc/man/gnunet-resolver.1
@@ -26,33 +26,32 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-resolver 28.Nm gnunet-resolver
29.Nd 29.Nd built-in GNUnet stub resolver
30built-in GNUnet stub resolver
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 33.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 34.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOGFILE 35.Op Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
37.Op Fl r | \-reverse 36.Op Fl r | -reverse
38.Op Fl v | \-version 37.Op Fl v | -version
39.Ao Ar hostname Ac 38.Ao Ar hostname Ac
40.Sh DESCRIPTION 39.Sh DESCRIPTION
41.Nm 40.Nm
42allows you to use the build-in GNUnet stub resolver. 41allows you to use the build-in GNUnet stub resolver.
43.Bl -tag -width indent 42.Bl -tag -width indent
44.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 43.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
45Use the configuration file FILENAME. 44Use the configuration file FILENAME.
46.It Fl h | \-help 45.It Fl h | -help
47Print short help on options. 46Print short help on options.
48.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 47.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
49Use LOGLEVEL for logging. 48Use LOGLEVEL for logging.
50Valid values are DEBUG, INFO, WARNING and ERROR. 49Valid values are DEBUG, INFO, WARNING and ERROR.
51.It Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOGFILE 50.It Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
52Configure logging to write logs to LOGFILE. 51Configure logging to write logs to LOGFILE.
53.It Fl r | \-reverse 52.It Fl r | -reverse
54Perform a reverse lookup. 53Perform a reverse lookup.
55.It Fl v | \-version 54.It Fl v | -version
56Print GNUnet version number. 55Print GNUnet version number.
57.El 56.El
58.\".Sh EXAMPLES 57.\".Sh EXAMPLES
diff --git a/doc/man/gnunet-revocation.1 b/doc/man/gnunet-revocation.1
index 16f954a2e..0c447a94f 100644
--- a/doc/man/gnunet-revocation.1
+++ b/doc/man/gnunet-revocation.1
@@ -26,18 +26,17 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-revocation 28.Nm gnunet-revocation
29.Nd 29.Nd revoke private keys (of egos) in GNUnet
30revoke private keys (of egos) in GNUnet
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl t Ar KEY | Fl \-test= Ns Ar KEY 32.Op Fl t Ar KEY | Fl -test= Ns Ar KEY
34.Op Fl R Ar NAME | Fl \-revoke= Ns Ar NAME 33.Op Fl R Ar NAME | Fl -revoke= Ns Ar NAME
35.Op Fl p | \-perform 34.Op Fl p | -perform
36.Op Fl f Ar NAME | Fl \-filename= Ns Ar NAME 35.Op Fl f Ar NAME | Fl -filename= Ns Ar NAME
37.Op Fl c Ar FILENAME, Fl \-config= Ns Ar FILENAME 36.Op Fl c Ar FILENAME, Fl -config= Ns Ar FILENAME
38.Op Fl h | \-help 37.Op Fl h | -help
39.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 38.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
40.Op Fl v | \-version 39.Op Fl v | -version
41.Sh DESCRIPTION 40.Sh DESCRIPTION
42.Nm 41.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. 42can 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 +48,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. 48Note that performing a revocation proof-of-work is deliberately VERY expensive.
50Depending on your CPU, the calculation can take days or weeks. 49Depending on your CPU, the calculation can take days or weeks.
51.Bl -tag -width indent 50.Bl -tag -width indent
52.It Fl t Ar KEY | Fl \-test= Ns Ar KEY 51.It Fl t Ar KEY | Fl -test= Ns Ar KEY
53Check if the given KEY (ASCII\-encoded public key required) has been revoked. 52Check if the given KEY (ASCII-encoded public key required) has been revoked.
54.It Fl R Ar NAME | Fl \-revoke= Ns Ar NAME 53.It Fl R Ar NAME | Fl -revoke= Ns Ar NAME
55Calculate or perform revocation for the ego with the given NAME. 54Calculate or perform revocation for the ego with the given NAME.
56.It Fl p | \-perform 55.It Fl p | -perform
57Actually perform the revocation as soon as possible (do not just generate a revocation certificate, use it). 56Actually perform the revocation as soon as possible (do not just generate a revocation certificate, use it).
58Must be supplied to actually perform the revocation. 57Must be supplied to actually perform the revocation.
59.It Fl f Ar NAME | Fl \-filename= Ns Ar NAME 58.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. 59Use 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. 60Intermediate 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. 61When 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. 62If 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 63.It Fl c Ar FILENAME, Fl -config= Ns Ar FILENAME
65Use the configuration file FILENAME. 64Use the configuration file FILENAME.
66.It Fl h | \-help 65.It Fl h | -help
67Print short help on options. 66Print short help on options.
68.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 67.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
69Use LOGLEVEL for logging. 68Use LOGLEVEL for logging.
70Valid values are DEBUG, INFO, WARNING and ERROR. 69Valid values are DEBUG, INFO, WARNING and ERROR.
71.It Fl v | \-version 70.It Fl v | -version
72Print GNUnet version number. 71Print GNUnet version number.
73.El 72.El
74.Sh SEE ALSO 73.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..a1c88f869 100644
--- a/doc/man/gnunet-search.1
+++ b/doc/man/gnunet-search.1
@@ -26,21 +26,20 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-search 28.Nm gnunet-search
29.Nd 29.Nd a command line interface to search for content on GNUnet
30a command line interface to search for content on GNUnet
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 32.Op Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl h | \-help 34.Op Fl h | -help
36.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 35.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
37.Op Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 36.Op Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
38.Op Fl o Ar FILENAME | Fl \-output= Ns Ar FILENAME 37.Op Fl o Ar FILENAME | Fl -output= Ns Ar FILENAME
39.Op Fl n | \-no-network 38.Op Fl n | -no-network
40.Op Fl N Ar VALUE | Fl \-results= Ns Ar VALUE 39.Op Fl N Ar VALUE | Fl -results= Ns Ar VALUE
41.Op Fl t Ar DELAY | Fl \-timeout= Ns Ar DELAY 40.Op Fl t Ar DELAY | Fl -timeout= Ns Ar DELAY
42.Op Fl v | \-version 41.Op Fl v | -version
43.Op Fl V | \-verbose 42.Op Fl V | -verbose
44.Ao KEYWORD Ac Ao +KEYWORD Ac | Ao Ar URI Ac Ao Ar +URI Ac 43.Ao KEYWORD Ac Ao +KEYWORD Ac | Ao Ar URI Ac Ao Ar +URI Ac
45.Sh DESCRIPTION 44.Sh DESCRIPTION
46Search for content on GNUnet. 45Search for content on GNUnet.
@@ -49,7 +48,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. 48can be used both for a search in the global namespace as well as for searching a private subspace.
50The options are as follows: 49The options are as follows:
51.Bl -tag -width indent 50.Bl -tag -width indent
52.It Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL 51.It Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL
53This option can be used to specify additional anonymity constraints. 52This option can be used to specify additional anonymity constraints.
54The default is 1. 53The 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. 54If 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 +63,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. 63Given 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. 64The 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. 65Note 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 66.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
68Use the configuration file 67Use the configuration file
69.Ar FILENAME 68.Ar FILENAME
70(default: 69(default:
71.Pa ~/.config/gnunet.conf ) 70.Pa ~/.config/gnunet.conf )
72.It Fl h | \-help 71.It Fl h | -help
73Print the help page. 72Print the help page.
74.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 73.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
75Change the loglevel. 74Change the loglevel.
76Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. 75Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
77.It Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME 76.It Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
78Write logs to 77Write logs to
79.Ar FILENAME . 78.Ar FILENAME .
80.It Fl o Ar FILENAME | Fl \-output= Ns Ar FILENAME 79.It Fl o Ar FILENAME | Fl -output= Ns Ar FILENAME
81Writes a GNUnet directory containing all of the search results to 80Writes a GNUnet directory containing all of the search results to
82.Ar FILENAME . 81.Ar FILENAME .
83.It Fl n | \-no-network 82.It Fl n | -no-network
84Only search locally, do not forward requests to other peers. 83Only search locally, do not forward requests to other peers.
85.It Fl N Ar VALUE | Fl \-results= Ns Ar VALUE 84.It Fl N Ar VALUE | Fl -results= Ns Ar VALUE
86Automatically terminate the search after receiving 85Automatically terminate the search after receiving
87.Ar VALUE 86.Ar VALUE
88results. 87results.
89.It Fl t Ar DELAY | Fl \-timeout= Ns Ar DELAY 88.It Fl t Ar DELAY | Fl -timeout= Ns Ar DELAY
90Automatically timeout search after 89Automatically timeout search after
91.Ar DELAY . 90.Ar DELAY .
92The value given must be a number followed by a space and a time unit, for example "500 ms". 91The 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. 92Note that the quotes are required on the shell.
94Otherwise the search runs until gnunet-search is aborted with CTRL\-C. 93Otherwise the search runs until gnunet-search is aborted with CTRL-C.
95.It Fl v | \-version 94.It Fl v | -version
96print the version number 95print the version number
97.It Fl V | \-verbose 96.It Fl V | -verbose
98print meta data from search results as well 97print meta data from search results as well
99.El 98.El
100You can run gnunet-search with an URI instead of a keyword. 99You 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..b39544641 100644
--- a/doc/man/gnunet-testbed-profiler.1
+++ b/doc/man/gnunet-testbed-profiler.1
@@ -26,42 +26,41 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-testbed-profiler 28.Nm gnunet-testbed-profiler
29.Nd 29.Nd profiling driver for the testbed
30profiling driver for the testbed
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl e Ar COUNT | Fl \-num-errors= Ns Ar COUNT 33.Op Fl e Ar COUNT | Fl -num-errors= Ns Ar COUNT
35.Op Fl H Ar FILENAME | Fl \-hosts= Ns Ar FILENAME 34.Op Fl H Ar FILENAME | Fl -hosts= Ns Ar FILENAME
36.Op Fl h | \-help 35.Op Fl h | -help
37.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 36.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
38.Op Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOGFILE 37.Op Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
39.Op Fl n | \-non-interactive 38.Op Fl n | -non-interactive
40.Op Fl p Ar COUNT | Fl \-num-peers= Ns Ar COUNT 39.Op Fl p Ar COUNT | Fl -num-peers= Ns Ar COUNT
41.Op Fl v | \-version 40.Op Fl v | -version
42.Sh DESCRIPTION 41.Sh DESCRIPTION
43.Nm 42.Nm
44is a command line profiling driver for the testbed. 43is a command line profiling driver for the testbed.
45.Sh OPTIONS 44.Sh OPTIONS
46.Bl -tag -width indent 45.Bl -tag -width indent
47.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 46.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
48Use the configuration file FILENAME. 47Use the configuration file FILENAME.
49.It Fl e Ar COUNT | Fl \-num-errors= Ns Ar COUNT 48.It Fl e Ar COUNT | Fl -num-errors= Ns Ar COUNT
50Tolerate COUNT number of continious timeout failures. 49Tolerate COUNT number of continious timeout failures.
51.It Fl H Ar FILENAME | Fl \-hosts= Ns Ar FILENAME 50.It Fl H Ar FILENAME | Fl -hosts= Ns Ar FILENAME
52Name of the file with the login information for the testbed. 51Name of the file with the login information for the testbed.
53.It Fl h | \-help 52.It Fl h | -help
54Print short help on options. 53Print short help on options.
55.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 54.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
56Use LOGLEVEL for logging. 55Use LOGLEVEL for logging.
57Valid values are DEBUG, INFO, WARNING and ERROR. 56Valid values are DEBUG, INFO, WARNING and ERROR.
58.It Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOGFILE 57.It Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
59Configure logging to write logs to LOGFILE. 58Configure logging to write logs to LOGFILE.
60.It Fl n | \-non-interactive 59.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. 60Run 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 61.It Fl p Ar COUNT | Fl -num-peers= Ns Ar COUNT
63Create COUNT number of peers. 62Create COUNT number of peers.
64.It Fl v | \-version 63.It Fl v | -version
65Print GNUnet version number. 64Print GNUnet version number.
66.El 65.El
67.Sh SEE ALSO 66.Sh SEE ALSO
diff --git a/doc/man/gnunet-testing-run-service.1 b/doc/man/gnunet-testing-run-service.1
index 4f3c5c74b..8ec81d846 100644
--- a/doc/man/gnunet-testing-run-service.1
+++ b/doc/man/gnunet-testing-run-service.1
@@ -26,13 +26,12 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-testing-run-service 28.Nm gnunet-testing-run-service
29.Nd 29.Nd command line tool to start a service for testing
30command line tool to start a service for testing
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 33.Op Fl h | -help
35.Op Fl s Ar SERVICE | Fl \-service= Ns Ar SERVICE 34.Op Fl s Ar SERVICE | Fl -service= Ns Ar SERVICE
36.Sh DESCRIPTION 35.Sh DESCRIPTION
37.Nm 36.Nm
38is a command line tool to start a service for testing. 37is a command line tool to start a service for testing.
@@ -43,11 +42,11 @@ When reading the character 'r' from stdin, the running service is restarted with
43.Pp 42.Pp
44This executable is intended to be used by gnunet-java, in order to reliably start and stop services for test cases. 43This 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 44.Bl -tag -width indent
46.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 45.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
47Name of the template configuration file to use (optional). 46Name of the template configuration file to use (optional).
48.It Fl h | \-help 47.It Fl h | -help
49Print short help on options. 48Print short help on options.
50.It Fl s Ar SERVICE | Fl \-service= Ns Ar SERVICE 49.It Fl s Ar SERVICE | Fl -service= Ns Ar SERVICE
51Name of the service to run. 50Name of the service to run.
52.El 51.El
53.Sh SEE ALSO 52.Sh SEE ALSO
diff --git a/doc/man/gnunet-testing.1 b/doc/man/gnunet-testing.1
index 659e46fbc..7d40152ac 100644
--- a/doc/man/gnunet-testing.1
+++ b/doc/man/gnunet-testing.1
@@ -26,47 +26,46 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-testing 28.Nm gnunet-testing
29.Nd 29.Nd command line tool to access the testing library
30command line tool to access the testing library
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl C | \-cfg 32.Op Fl C | -cfg
34.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 33.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35.Op Fl H | \-hostkeys 34.Op Fl H | -hostkeys
36.Op Fl h | \-help 35.Op Fl h | -help
37.Op Fl k | \-key 36.Op Fl k | -key
38.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 37.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
39.Op Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOFILE 38.Op Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOFILE
40.Op Fl n | \-number 39.Op Fl n | -number
41.Op Fl t | \-template 40.Op Fl t | -template
42.Op Fl v | \-version 41.Op Fl v | -version
43.Sh DESCRIPTION 42.Sh DESCRIPTION
44.Nm 43.Nm
45is a command line tool to access the testing library. 44is a command line tool to access the testing library.
46.Sh OPTIONS 45.Sh OPTIONS
47.Bl -tag -width indent 46.Bl -tag -width indent
48.It Fl C | \-cfg 47.It Fl C | -cfg
49Create unique configuration files. 48Create unique configuration files.
50.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 49.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
51Use the configuration file 50Use the configuration file
52.Ar FILENAME . 51.Ar FILENAME .
53.It Fl H | \-hostkeys 52.It Fl H | -hostkeys
54Host key file. 53Host key file.
55.It Fl h | \-help 54.It Fl h | -help
56Print short help on options. 55Print short help on options.
57.It Fl k | \-key 56.It Fl k | -key
58Create hostkey files from pre-computed hostkey list. 57Create hostkey files from pre-computed hostkey list.
59.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 58.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
60Use LOGLEVEL for logging. 59Use LOGLEVEL for logging.
61Valid values are DEBUG, INFO, WARNING and ERROR. 60Valid values are DEBUG, INFO, WARNING and ERROR.
62.It Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOFILE 61.It Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOFILE
63Configure logging to write logs to 62Configure logging to write logs to
64.Ar LOGFILE . 63.Ar LOGFILE .
65.It Fl n | \-number 64.It Fl n | -number
66Number of unique configuration files or hostkeys to create. 65Number of unique configuration files or hostkeys to create.
67.It Fl t | \-template 66.It Fl t | -template
68Configuration template. 67Configuration template.
69.It Fl v | \-version 68.It Fl v | -version
70Print GNUnet version number. 69Print GNUnet version number.
71.El 70.El
72.Sh SEE ALSO 71.Sh SEE ALSO
diff --git a/doc/man/gnunet-timeout.1 b/doc/man/gnunet-timeout.1
index 1ac99cebd..a36141c36 100644
--- a/doc/man/gnunet-timeout.1
+++ b/doc/man/gnunet-timeout.1
@@ -26,8 +26,7 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-timeout 28.Nm gnunet-timeout
29.Nd 29.Nd run process with timeout
30run process with timeout
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Ao Ar duration Ac 32.Ao Ar duration Ac
diff --git a/doc/man/gnunet-transport-certificate-creation.1 b/doc/man/gnunet-transport-certificate-creation.1
index 7e4086d83..c10e2c8fc 100644
--- a/doc/man/gnunet-transport-certificate-creation.1
+++ b/doc/man/gnunet-transport-certificate-creation.1
@@ -26,8 +26,7 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-transport-certificate-creation 28.Nm gnunet-transport-certificate-creation
29.Nd 29.Nd create certificate for HTTPS transport
30create certificate for HTTPS transport
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op privatekey 32.Op privatekey
diff --git a/doc/man/gnunet-unindex.1 b/doc/man/gnunet-unindex.1
index 886793ed9..546db559d 100644
--- a/doc/man/gnunet-unindex.1
+++ b/doc/man/gnunet-unindex.1
@@ -26,31 +26,30 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-unindex 28.Nm gnunet-unindex
29.Nd 29.Nd a command line interface for deleting indexed files from GNUnet
30a command line interface for deleting indexed files from GNUnet
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 33.Op Fl h | -help
35.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 34.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
36.Op Fl v | \-version 35.Op Fl v | -version
37.Op Fl V | \-verbose 36.Op Fl V | -verbose
38FILENAME 37FILENAME
39.Sh DESCRIPTION 38.Sh DESCRIPTION
40.Nm 39.Nm
41is used for deleting indexed files from GNUnet. 40is used for deleting indexed files from GNUnet.
42.Bl -tag -width indent 41.Bl -tag -width indent
43.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME 42.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
44Use config file FILENAME as config (default: 43Use config file FILENAME as config (default:
45.Pa ~/.config/gnunet.conf Ns ). 44.Pa ~/.config/gnunet.conf Ns ).
46.It Fl h | \-help 45.It Fl h | -help
47Print the help page. 46Print the help page.
48.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL 47.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
49Change the loglevel. 48Change the loglevel.
50Possible values for LOGLEVEL are NOTHING, ERROR, WARNING, INFO and DEBUG. 49Possible values for LOGLEVEL are NOTHING, ERROR, WARNING, INFO and DEBUG.
51.It Fl v | \-version 50.It Fl v | -version
52Print the version number. 51Print the version number.
53.It Fl V | \-verbose 52.It Fl V | -verbose
54Be verbose. 53Be verbose.
55.El 54.El
56.Sh NOTES 55.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..657038428 100644
--- a/doc/man/gnunet-zoneimport.1
+++ b/doc/man/gnunet-zoneimport.1
@@ -26,15 +26,14 @@
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm gnunet-zoneimport 28.Nm gnunet-zoneimport
29.Nd 29.Nd import DNS zone into GNS zone
30import DNS zone into GNS zone
31.Sh SYNOPSIS 30.Sh SYNOPSIS
32.Nm 31.Nm
33.Op Fl c Ar FILENAME | \-config= Ns Ar FILENAME 32.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
34.Op Fl h | \-help 33.Op Fl h | -help
35.Op Fl m Ar RELATIVETIME | Fl \-minimum-expiration= Ns Ar RELATIVETIME 34.Op Fl m Ar RELATIVETIME | Fl -minimum-expiration= Ns Ar RELATIVETIME
36.Op Fl s Ar MAPSIZE | Fl \-size= Ns Ar MAPSIZE 35.Op Fl s Ar MAPSIZE | Fl -size= Ns Ar MAPSIZE
37.Op Ar \IP 36.Ao Ar IP Ac
38.Sh DESCRIPTION 37.Sh DESCRIPTION
39.Nm 38.Nm
40reads a list of domain names (FQDN) from stdin and issues DNS queries for each of the domain names given. 39reads a list of domain names (FQDN) from stdin and issues DNS queries for each of the domain names given.
@@ -56,27 +55,27 @@ Thus, it is fine to restart gnunet-zoneimport whenever the list of domain names
56Finally, gnunet-zoneimport keeps information for each domain name in memory. 55Finally, 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. 56This consumes about 200 bytes per domain name, or 1 GB for 5 million labels.
58.Bl -tag -width indent 57.Bl -tag -width indent
59.It Fl c Ar FILENAME | \-config= Ns Ar FILENAME 58.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
60Use the configuration file FILENAME. 59Use the configuration file FILENAME.
61.It Fl h | \-help 60.It Fl h | -help
62Print short help on options. 61Print short help on options.
63.It Fl m Ar RELATIVETIME | Fl \-minimum-expiration= Ns Ar RELATIVETIME 62.It Fl m Ar RELATIVETIME | Fl -minimum-expiration= Ns Ar RELATIVETIME
64Ensure that imported DNS records never have an expiration time that is less than RELATIVETIME into the future. 63Ensure 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". 64RELATIVETIME 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). 65If 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. 66Default is zero.
68.It Fl s Ar MAPSIZE | Fl \-size= Ns Ar MAPSIZE 67.It Fl s Ar MAPSIZE | Fl -size= Ns Ar MAPSIZE
69Specifies the size (in number of entries) to use for the main hash map. 68Specifies 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. 69The 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). 70This 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. 71Do not worry about this unless you are importing millions of domain names from a zone.
73.It Ar \IP 72.It Ao Ar IP Ac
74IP Is the list of IPs given. 73IP Is the list of IPs given.
75.El 74.El
76.Sh EXAMPLES 75.Sh EXAMPLES
77Typical invocaton would be: 76Typical invocation would be:
78.Pp 77.Pp
79.Dl $ gnunet\-zoneimport 1.2.3.4 < names.txt 78.Dl $ gnunet-zoneimport 1.2.3.4 < names.txt
80.Sh SEE ALSO 79.Sh SEE ALSO
81.Xr gnunet-gns 1 , 80.Xr gnunet-gns 1 ,
82.Xr gnunet-namestore 1 81.Xr gnunet-namestore 1
generated by cgit v1.2.3 (git 2.39.1) at 2024-04-27 19:07:54 +0000