diff options
author | Christian Grothoff <christian@grothoff.org> | 2019-04-20 21:45:25 +0200 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2019-04-20 21:45:25 +0200 |
commit | 32485c3b58983ada1943b3fa27eac3b0cff2a9da (patch) | |
tree | 1e439c5054194faef2f52a86f16a7c13f5f5aa20 /doc/man/gnunet-search.1 | |
parent | 5fab02b10baef639121723aacf3b1351e5db8003 (diff) | |
download | gnunet-32485c3b58983ada1943b3fa27eac3b0cff2a9da.tar.gz gnunet-32485c3b58983ada1943b3fa27eac3b0cff2a9da.zip |
try to address #5660:
Diffstat (limited to 'doc/man/gnunet-search.1')
-rw-r--r-- | doc/man/gnunet-search.1 | 37 |
1 files changed, 16 insertions, 21 deletions
diff --git a/doc/man/gnunet-search.1 b/doc/man/gnunet-search.1 index d4ad4b516..58e16ea7b 100644 --- a/doc/man/gnunet-search.1 +++ b/doc/man/gnunet-search.1 | |||
@@ -24,30 +24,25 @@ Search for content on GNUnet. | |||
24 | The keywords are case-sensitive. | 24 | The keywords are case-sensitive. |
25 | .Nm | 25 | .Nm |
26 | can be used both for a search in the global namespace as well as for searching a private subspace. | 26 | can be used both for a search in the global namespace as well as for searching a private subspace. |
27 | .Sh OPTIONS | ||
27 | .Bl -tag -width Ds | 28 | .Bl -tag -width Ds |
28 | .It Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL | 29 | .It Fl a Ar LEVEL | Fl \-anonymity= Ns Ar LEVEL |
29 | The \fB\-a\fR option can be used to specify additional anonymity constraints. | 30 | This option can be used to specify additional anonymity constraints. The default is 1. |
30 | If set to 0, GNUnet will try to download the file as fast as possible, including using non-anonymous methods. | 31 | 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. |
32 | 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 | If you set it to 1 (default), you use the standard anonymous routing algorithm (which does not explicitly leak your identity). | 33 | If you set it to 1 (default), you use the standard anonymous routing algorithm (which does not explicitly leak your identity). |
32 | However, a powerful adversary may still be able to perform traffic analysis (statistics) to over time infer data about your identity. | 34 | However, a powerful adversary may still be able to perform traffic analysis (statistics) to over time discovery your identity. |
33 | 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. | 35 | You can gain better privacy by specifying a higher level of anonymity (using values above 1). |
34 | 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. | 36 | This tells FS that it must hide your own requests in equivalent\-looking cover traffic. |
35 | 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. | 37 | This should confound an adversaries traffic analysis, increasing the time and effort it would |
36 | Also, peers that cache content in the network always use anonymity level 1. | 38 | take to discover your identity. However, it also can significantly reduce performance, as |
37 | .sp | 39 | your requests will be delayed until sufficient cover traffic is available. The specific |
38 | This option can be used to limit requests further than that. | 40 | numeric value (for anonymity levels above 1) is simple: |
39 | In particular, you can require GNUnet to receive certain amounts of traffic from other peers before sending your queries. | 41 | Given an anonymity level L (above 1), each request FS makes on your behalf must be hidden in L\-1 equivalent |
40 | This way, you can gain very high levels of anonymity \- at the expense of much more traffic and much higher latency. | 42 | requests of cover traffic (traffic your peer routes for others) in the same time\-period. |
41 | So set it only if you really believe you need it. | 43 | The time\-period is twice the average delay by which GNUnet artificially delays traffic. |
42 | .sp | 44 | Note that regardless of the anonymity level you choose, peers that cache content in the |
43 | The definition of ANONYMITY\-RECEIVE is the following. | 45 | network always use anonymity level 1. |
44 | 0 means no anonymity is required. | ||
45 | 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. | ||
46 | 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. | ||
47 | The time\-period is twice the average delay that GNUnet defers forwarded queries. | ||
48 | .sp | ||
49 | The default is 1 and this should be fine for most users. | ||
50 | 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. | ||
51 | .It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME | 46 | .It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME |
52 | use config file (defaults: ~/.config/gnunet.conf) | 47 | use config file (defaults: ~/.config/gnunet.conf) |
53 | .It Fl h | \-help | 48 | .It Fl h | \-help |