diff options
Diffstat (limited to 'doc/man/gnunet-auto-share.1')
-rw-r--r-- | doc/man/gnunet-auto-share.1 | 48 |
1 files changed, 24 insertions, 24 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 |