aboutsummaryrefslogtreecommitdiff
path: root/doc/man/gnunet-auto-share.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man/gnunet-auto-share.1')
-rw-r--r--doc/man/gnunet-auto-share.148
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 @@
30a command line tool to automatically share an entire directory with other users 30a 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
46In order to share files with other GNUnet users, the files must first be made available to GNUnet. 46In 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
55You can use automatic meta-data extraction (based on libextractor). 55You can use automatic meta-data extraction (based on libextractor).
56The options are as follows: 56The 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
59This option can be used to specify additional anonymity constraints. 59This option can be used to specify additional anonymity constraints.
60The default is 1. 60The default is 1.
61If 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. 61If 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
63If you set it to 1 (default), you use the standard anonymous routing algorithm (which does not explicitly leak your identity). 63If you set it to 1 (default), you use the standard anonymous routing algorithm (which does not explicitly leak your identity).
64However, a powerful adversary may still be able to perform traffic analysis (statistics) to over time discovery your identity. 64However, a powerful adversary may still be able to perform traffic analysis (statistics) to over time discovery your identity.
65You can gain better privacy by specifying a higher level of anonymity (using values above 1). 65You can gain better privacy by specifying a higher level of anonymity (using values above 1).
66This tells FS that it must hide your own requests in equivalent\-looking cover traffic. 66This tells FS that it must hide your own requests in equivalent-looking cover traffic.
67This should confound an adversaries traffic analysis, increasing the time and effort it would take to discover your identity. 67This should confound an adversaries traffic analysis, increasing the time and effort it would take to discover your identity.
68However, it also can significantly reduce performance, as your requests will be delayed until sufficient cover traffic is available. 68However, it also can significantly reduce performance, as your requests will be delayed until sufficient cover traffic is available.
69The specific numeric value (for anonymity levels above 1) is simple: 69The specific numeric value (for anonymity levels above 1) is simple:
70Given 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. 70Given 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.
71The time-period is twice the average delay by which GNUnet artificially delays traffic. 71The time-period is twice the average delay by which GNUnet artificially delays traffic.
72Note that regardless of the anonymity level you choose, peers that cache content in the network always use anonymity level 1. 72Note 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
74Use alternate config file (if this option is not specified, the default is 74Use 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
77Disable use of GNU libextractor for finding additional keywords and metadata. 77Disable use of GNU libextractor for finding additional keywords and metadata.
78.It Fl d | \-disable-creation-time 78.It Fl d | -disable-creation-time
79Disable adding the creation time to the metadata of the uploaded file. 79Disable adding the creation time to the metadata of the uploaded file.
80.It Fl h | \-help 80.It Fl h | -help
81Print a brief help page with all the options. 81Print 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
83Change the loglevel. 83Change the loglevel.
84Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. 84Possible 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
86Configure logging to write logs to FILENAME. 86Configure 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
88Executive summary: You probably don't need it. 88Executive summary: You probably don't need it.
89Set the priority of the published content (default: 365). 89Set the priority of the published content (default: 365).
90If the local database is full, GNUnet will discard the content with the lowest ranking. 90If the local database is full, GNUnet will discard the content with the lowest ranking.
91Note that ranks change over time depending on popularity. 91Note that ranks change over time depending on popularity.
92The default should be high enough to preserve the locally published content in favor of content that migrates from other peers. 92The 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
94Set the desired replication level. 94Set the desired replication level.
95If 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. 95If 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.
96This option can be used to push some content out into the network harder. 96This option can be used to push some content out into the network harder.
97Note that pushing content LEVEL times into the network does not guarantee that there will actually be LEVEL replicas. 97Note 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
99Be verbose. 99Be verbose.
100Using 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. 100Using 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
102Print the version number. 102Print the version number.
103.El 103.El
104.Sh EXAMPLES 104.Sh EXAMPLES