diff options
author | ng0 <ng0@n0.is> | 2019-04-21 20:08:52 +0000 |
---|---|---|
committer | ng0 <ng0@n0.is> | 2019-04-21 20:08:52 +0000 |
commit | a07991f9be04ede254b6e4991c7cfda44bd53700 (patch) | |
tree | 4f85ecaaea370bb36d6e5cd4aa661cd6eb0e3f51 /doc/man/gnunet-download.1 | |
parent | abc12a14473dc304b2388901add772ba0711f087 (diff) | |
download | gnunet-a07991f9be04ede254b6e4991c7cfda44bd53700.tar.gz gnunet-a07991f9be04ede254b6e4991c7cfda44bd53700.zip |
manpages.
Diffstat (limited to 'doc/man/gnunet-download.1')
-rw-r--r-- | doc/man/gnunet-download.1 | 25 |
1 files changed, 12 insertions, 13 deletions
diff --git a/doc/man/gnunet-download.1 b/doc/man/gnunet-download.1 index f278694c3..1c7776ff1 100644 --- a/doc/man/gnunet-download.1 +++ b/doc/man/gnunet-download.1 | |||
@@ -22,24 +22,23 @@ a command line interface for downloading files from GNUnet | |||
22 | .Ao Ar GNUNET_URI Ac | 22 | .Ao Ar GNUNET_URI Ac |
23 | .Sh DESCRIPTION | 23 | .Sh DESCRIPTION |
24 | Download files from GNUnet. | 24 | Download files from GNUnet. |
25 | The options are as follows: | ||
25 | .Bl -tag -width Ds | 26 | .Bl -tag -width Ds |
26 | .It Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL | 27 | .It Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL |
27 | This option can be used to specify additional anonymity constraints. The default is 1. | 28 | This option can be used to specify additional anonymity constraints. |
29 | The default is 1. | ||
28 | 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. | 30 | 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. |
29 | This will allow other users to download the file as fast as possible, including using non-anonymous methods (discovery via DHT and CADET transfer). | 31 | This will allow other users to download the file as fast as possible, including using non-anonymous methods (discovery via DHT and CADET transfer). |
30 | If you set it to 1 (default), you use the standard anonymous routing algorithm (which does not explicitly leak your identity). | 32 | If you set it to 1 (default), you use the standard anonymous routing algorithm (which does not explicitly leak your identity). |
31 | However, a powerful adversary may still be able to perform traffic analysis (statistics) to over time discovery your identity. | 33 | However, a powerful adversary may still be able to perform traffic analysis (statistics) to over time discovery your identity. |
32 | You can gain better privacy by specifying a higher level of anonymity (using values above 1). | 34 | You can gain better privacy by specifying a higher level of anonymity (using values above 1). |
33 | This tells FS that it must hide your own requests in equivalent\-looking cover traffic. | 35 | This tells FS that it must hide your own requests in equivalent-looking cover traffic. |
34 | This should confound an adversaries traffic analysis, increasing the time and effort it would | 36 | This should confound an adversaries traffic analysis, increasing the time and effort it would take to discover your identity. |
35 | take to discover your identity. However, it also can significantly reduce performance, as | 37 | However, it also can significantly reduce performance, as your requests will be delayed until sufficient cover traffic is available. |
36 | your requests will be delayed until sufficient cover traffic is available. The specific | 38 | The specific numeric value (for anonymity levels above 1) is simple: |
37 | numeric value (for anonymity levels above 1) is simple: | 39 | 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. |
38 | Given an anonymity level L (above 1), each request FS makes on your behalf must be hidden in L-1 equivalent | 40 | The time-period is twice the average delay by which GNUnet artificially delays traffic. |
39 | requests of cover traffic (traffic your peer routes for others) in the same time\-period. | 41 | Note that regardless of the anonymity level you choose, peers that cache content in the network always use anonymity level 1. |
40 | The time\-period is twice the average delay by which GNUnet artificially delays traffic. | ||
41 | Note that regardless of the anonymity level you choose, peers that cache content in the | ||
42 | network always use anonymity level 1. | ||
43 | .It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME | 42 | .It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME |
44 | Use config file (default: | 43 | Use config file (default: |
45 | .Pa ~/.config/gnunet.conf Ns ) | 44 | .Pa ~/.config/gnunet.conf Ns ) |
@@ -89,9 +88,9 @@ must end in '.gnd' \(em otherwise, you will receive an error. | |||
89 | 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". | 88 | 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". |
90 | 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". | 89 | 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". |
91 | .It Fl v | \-version | 90 | .It Fl v | \-version |
92 | print the version number | 91 | Print the version number. |
93 | .It Fl V | \-verbose | 92 | .It Fl V | \-verbose |
94 | print progress information | 93 | Print progress information. |
95 | .El | 94 | .El |
96 | .Ss NOTES | 95 | .Ss NOTES |
97 | The GNUNET_URI is typically obtained from | 96 | The GNUNET_URI is typically obtained from |