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