diff options
Diffstat (limited to 'doc/man/gnunet-download.1')
-rw-r--r-- | doc/man/gnunet-download.1 | 43 |
1 files changed, 16 insertions, 27 deletions
diff --git a/doc/man/gnunet-download.1 b/doc/man/gnunet-download.1 index e2c4ab365..f278694c3 100644 --- a/doc/man/gnunet-download.1 +++ b/doc/man/gnunet-download.1 | |||
@@ -24,8 +24,22 @@ a command line interface for downloading files from GNUnet | |||
24 | Download files from GNUnet. | 24 | Download files from GNUnet. |
25 | .Bl -tag -width Ds | 25 | .Bl -tag -width Ds |
26 | .It Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL | 26 | .It Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL |
27 | Set desired level of receiver anonymity. | 27 | This option can be used to specify additional anonymity constraints. The default is 1. |
28 | 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. |
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). | ||
30 | 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. | ||
32 | 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. | ||
34 | This should confound an adversaries traffic analysis, increasing the time and effort it would | ||
35 | take to discover your identity. However, it also can significantly reduce performance, as | ||
36 | your requests will be delayed until sufficient cover traffic is available. The specific | ||
37 | numeric value (for anonymity levels above 1) is simple: | ||
38 | Given an anonymity level L (above 1), each request FS makes on your behalf must be hidden in L-1 equivalent | ||
39 | requests of cover traffic (traffic your peer routes for others) in the same time\-period. | ||
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. | ||
29 | .It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME | 43 | .It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME |
30 | Use config file (default: | 44 | Use config file (default: |
31 | .Pa ~/.config/gnunet.conf Ns ) | 45 | .Pa ~/.config/gnunet.conf Ns ) |
@@ -88,31 +102,6 @@ If you ever have to abort a download, you can at any time continue it by re-issu | |||
88 | In that case GNUnet will not download blocks again that are already present. | 102 | In that case GNUnet will not download blocks again that are already present. |
89 | GNUnet's file-encoding will ensure file integrity, even if the existing file was not downloaded from GNUnet in the first place. | 103 | GNUnet's file-encoding will ensure file integrity, even if the existing file was not downloaded from GNUnet in the first place. |
90 | Temporary information will be appended to the target file until the download is completed. | 104 | Temporary information will be appended to the target file until the download is completed. |
91 | .Ss SETTING ANONYMITY LEVEL | ||
92 | The | ||
93 | .Fl a | ||
94 | option can be used to specify additional anonymity constraints. | ||
95 | If set to 0, GNUnet will try to download the file as fast as possible, including using non-anonymous methods. | ||
96 | If you set it to 1 (default), you use the standard anonymous routing algorithm (which does not explicitly leak your identity). | ||
97 | However, a powerful adversary may still be able to perform traffic analysis (statistics) to over time infer data about your identity. | ||
98 | You can gain better privacy by specifying a higher level of anonymity, which increases the amount of cover traffic your own traffic will get, at the expense of performance. | ||
99 | Note that your download performance is not only determined by your own anonymity level, but also by the anonymity level of the peers publishing the file. | ||
100 | So even if you download with anonymity level 0, the peers publishing the data might be sharing with a higher anonymity level, which in this case will determine performance. | ||
101 | Also, peers that cache content in the network always use anonymity level 1. | ||
102 | .Pp | ||
103 | This option can be used to limit requests further than that. | ||
104 | In particular, you can require GNUnet to receive certain amounts of traffic from other peers before sending your queries. | ||
105 | This way, you can gain very high levels of anonymity - at the expense of much more traffic and much higher latency. | ||
106 | So set it only if you really believe you need it. | ||
107 | .Pp | ||
108 | The definition of ANONYMITY\-RECEIVE is the following. | ||
109 | 0 means no anonymity is required. | ||
110 | Otherwise a value of 'v' means that 1 out of v bytes of "anonymous" traffic can be from the local user, leaving 'v-1' bytes of cover traffic per byte on the wire. | ||
111 | Thus, if GNUnet routes n bytes of messages from foreign peers (using anonymous routing), it may originate n/(v-1) bytes of queries in the same time\-period. | ||
112 | The time\-period is twice the average delay that GNUnet defers forwarded queries. | ||
113 | .Pp | ||
114 | The default is 1 and this should be fine for most users. | ||
115 | Also notice that if you choose very large values, you may end up having no throughput at all, especially if many of your fellow GNUnet\-peers all do the same. | ||
116 | .Sh FILES | 105 | .Sh FILES |
117 | .Pa ~/.config/gnunet.conf | 106 | .Pa ~/.config/gnunet.conf |
118 | GNUnet configuration file | 107 | GNUnet configuration file |