diff options
author | xrs <xrs@mail36.net> | 2019-10-26 15:04:35 +0200 |
---|---|---|
committer | xrs <xrs@mail36.net> | 2019-10-26 15:04:35 +0200 |
commit | da87f37eb0766b7c0cf1664cfbfbaf6d15ef20bc (patch) | |
tree | 09912e95b697c4207a0026b34554e4fa7b22451f /doc/man/gnunet-publish.1 | |
parent | 99d9c81fc154e9196734be3c9f51f081859539ee (diff) | |
parent | 01f5a8120cc609782547fbcff27a0dc81d1129de (diff) | |
download | gnunet-da87f37eb0766b7c0cf1664cfbfbaf6d15ef20bc.tar.gz gnunet-da87f37eb0766b7c0cf1664cfbfbaf6d15ef20bc.zip |
obsolete due to alpine policy
Diffstat (limited to 'doc/man/gnunet-publish.1')
-rw-r--r-- | doc/man/gnunet-publish.1 | 89 |
1 files changed, 44 insertions, 45 deletions
diff --git a/doc/man/gnunet-publish.1 b/doc/man/gnunet-publish.1 index 04293102c..b6985463a 100644 --- a/doc/man/gnunet-publish.1 +++ b/doc/man/gnunet-publish.1 | |||
@@ -26,29 +26,28 @@ | |||
26 | .Os | 26 | .Os |
27 | .Sh NAME | 27 | .Sh NAME |
28 | .Nm gnunet-publish | 28 | .Nm gnunet-publish |
29 | .Nd | 29 | .Nd a command line interface for publishing new content into GNUnet |
30 | a command line interface for publishing new content into GNUnet | ||
31 | .Sh SYNOPSIS | 30 | .Sh SYNOPSIS |
32 | .Nm | 31 | .Nm |
33 | .Op Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL | 32 | .Op Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL |
34 | .Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME | 33 | .Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME |
35 | .Op Fl D | \-disable\-extractor | 34 | .Op Fl D | -disable-extractor |
36 | .Op Fl E | \-enable\-creation\-time | 35 | .Op Fl E | -enable-creation-time |
37 | .Op Fl e | \-extract | 36 | .Op Fl e | -extract |
38 | .Op Fl h | \-help | 37 | .Op Fl h | -help |
39 | .Op Fl k Ar KEYWORD | Fl \-key= Ns Ar KEYWORD | 38 | .Op Fl k Ar KEYWORD | Fl -key= Ns Ar KEYWORD |
40 | .Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL | 39 | .Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL |
41 | .Op Fl m Ar TYPE:VALUE | Fl \-meta= Ns Ar TYPE:VALUE | 40 | .Op Fl m Ar TYPE:VALUE | Fl -meta= Ns Ar TYPE:VALUE |
42 | .Op Fl n | \-noindex | 41 | .Op Fl n | -noindex |
43 | .Op Fl N Ar ID | Fl \-next= Ns Ar ID | 42 | .Op Fl N Ar ID | Fl -next= Ns Ar ID |
44 | .Op Fl p Ar PRIORITY | Fl \-prio= Ns Ar PRIORITY | 43 | .Op Fl p Ar PRIORITY | Fl -prio= Ns Ar PRIORITY |
45 | .Op Fl P Ar NAME | Fl \-pseudonym= Ns Ar NAME | 44 | .Op Fl P Ar NAME | Fl -pseudonym= Ns Ar NAME |
46 | .Op Fl r Ar LEVEL | Fl \-replication= Ns Ar LEVEL | 45 | .Op Fl r Ar LEVEL | Fl -replication= Ns Ar LEVEL |
47 | .Op Fl s | \-simulate-only | 46 | .Op Fl s | -simulate-only |
48 | .Op Fl t Ar ID | Fl \-this= Ns Ar ID | 47 | .Op Fl t Ar ID | Fl -this= Ns Ar ID |
49 | .Op Fl u Ar URI | Fl \-uri= Ns Ar URI | 48 | .Op Fl u Ar URI | Fl -uri= Ns Ar URI |
50 | .Op Fl v | \-version | 49 | .Op Fl v | -version |
51 | .Op Fl V | \-verbose | 50 | .Op Fl V | -verbose |
52 | .Ao Ar FILENAME Ac | 51 | .Ao Ar FILENAME Ac |
53 | .Sh DESCRIPTION | 52 | .Sh DESCRIPTION |
54 | In order to share files with other GNUnet users, the files must first be made available to GNUnet. | 53 | In order to share files with other GNUnet users, the files must first be made available to GNUnet. |
@@ -109,10 +108,10 @@ to specify meta-data. | |||
109 | For the | 108 | For the |
110 | .Fl m | 109 | .Fl m |
111 | option you need to use the form keyword-type:value. | 110 | 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. | 111 | 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". | 112 | 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 | 113 | A full list can be obtained from the extract tool using the option |
115 | .Fl \-list . | 114 | .Fl -list . |
116 | The meta-data is used to help users in searching for files on the network. | 115 | The meta-data is used to help users in searching for files on the network. |
117 | The keywords are case-sensitive. | 116 | The keywords are case-sensitive. |
118 | .Pp | 117 | .Pp |
@@ -128,7 +127,7 @@ If you publish or index a file and then leave the network, it will almost always | |||
128 | .Pp | 127 | .Pp |
129 | The options are as follows: | 128 | The options are as follows: |
130 | .Bl -tag -width indent | 129 | .Bl -tag -width indent |
131 | .It Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL | 130 | .It Fl a Ar LEVEL | Fl -anonymity= Ns Ar LEVEL |
132 | This option can be used to specify additional anonymity constraints. | 131 | This option can be used to specify additional anonymity constraints. |
133 | The default is 1. | 132 | 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. | 133 | 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 +142,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. | 142 | 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. | 143 | 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. | 144 | 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 | 145 | .It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME |
147 | Use alternate config file FILENAME. | 146 | Use alternate config file FILENAME. |
148 | If this option is not specified, the default is | 147 | If this option is not specified, the default is |
149 | .Pa ~/.config/gnunet.conf . | 148 | .Pa ~/.config/gnunet.conf . |
150 | .It Fl D | \-disable\-extractor | 149 | .It Fl D | -disable-extractor |
151 | Disable use of GNU libextractor for finding additional keywords and metadata. | 150 | Disable use of GNU libextractor for finding additional keywords and metadata. |
152 | .It Fl E | \-enable\-creation\-time | 151 | .It Fl E | -enable-creation-time |
153 | Enable use of creation time timestamp in metadata. | 152 | 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. | 153 | Setting this information will leak information about the time at which a file was made available. |
155 | .It Fl e | \-extract | 154 | .It Fl e | -extract |
156 | Print the list of keywords that will be used for each file given the current options. | 155 | Print the list of keywords that will be used for each file given the current options. |
157 | Do not perform any indexing or publishing. | 156 | Do not perform any indexing or publishing. |
158 | .It Fl h | \-help | 157 | .It Fl h | -help |
159 | Print the help page. | 158 | Print the help page. |
160 | .It Fl k Ar KEYWORD | Fl \-key= Ns Ar KEYWORD | 159 | .It Fl k Ar KEYWORD | Fl -key= Ns Ar KEYWORD |
161 | Additional key to index the content with (to add multiple keys, specify multiple times). | 160 | Additional key to index the content with (to add multiple keys, specify multiple times). |
162 | Each additional key is case\-sensitive. | 161 | Each additional key is case-sensitive. |
163 | Can be specified multiple times. | 162 | Can be specified multiple times. |
164 | The keyword is only applied to the top\-level file or directory. | 163 | The keyword is only applied to the top-level file or directory. |
165 | .It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL | 164 | .It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL |
166 | Change the loglevel. | 165 | Change the loglevel. |
167 | Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. | 166 | Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. |
168 | .It Fl m Ar TYPE:VALUE | Fl \-meta= Ns Ar TYPE:VALUE | 167 | .It Fl m Ar TYPE:VALUE | Fl -meta= Ns Ar TYPE:VALUE |
169 | For the main file (or directory), set the metadata of the given TYPE to the given VALUE. | 168 | 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. | 169 | 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 | 170 | .It Fl n | -noindex |
172 | Executive summary: You probably don't need it. | 171 | Executive summary: You probably don't need it. |
173 | Do not index, full publishing. | 172 | 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). | 173 | 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. | 174 | 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. | 175 | 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 | 176 | .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. | 177 | 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 | 178 | This option is only valid together with the |
180 | .Fl P | 179 | .Fl P |
@@ -187,36 +186,36 @@ and | |||
187 | without | 186 | without |
188 | .Fl t | 187 | .Fl t |
189 | is not allowed. | 188 | is not allowed. |
190 | .It Fl p Ar PRIORITY | Fl \-prio= Ns Ar PRIORITY | 189 | .It Fl p Ar PRIORITY | Fl -prio= Ns Ar PRIORITY |
191 | Executive summary: You probably don't need it. | 190 | Executive summary: You probably don't need it. |
192 | Set the priority of the published content (default: 365). | 191 | 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. | 192 | 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. | 193 | 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. | 194 | 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 | 195 | .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. | 196 | 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 | 197 | NAME must be a valid pseudonym managed by |
199 | .Xr gnunet-identity 1 . | 198 | .Xr gnunet-identity 1 . |
200 | .It Fl r Ar LEVEL | Fl \-replication= Ns Ar LEVEL | 199 | .It Fl r Ar LEVEL | Fl -replication= Ns Ar LEVEL |
201 | Set the desired replication level. | 200 | 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. | 201 | 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. | 202 | 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. | 203 | 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 | 204 | .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. | 205 | 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. | 206 | 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 | 207 | .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. | 208 | Specifies the identifier under which the file is to be published under a pseudonym. |
210 | This option is only valid together with the | 209 | This option is only valid together with the |
211 | .Fl P | 210 | .Fl P |
212 | option. | 211 | option. |
213 | .It Fl u Ar URI | Fl \-uri= Ns Ar URI | 212 | .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). | 213 | 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. | 214 | 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. | 215 | 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 | 216 | .It Fl v | -version |
218 | Print the version number. | 217 | Print the version number. |
219 | .It Fl V | \-verbose | 218 | .It Fl V | -verbose |
220 | Be verbose. | 219 | 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. | 220 | 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 | 221 | .El |