changing datastore API to support replication level --- not fully implemented --...
[oweals/gnunet.git] / doc / man / gnunet-pseudonym.1
index 60e3c9ba98fc7e75a2dbeb8bc45a5e8d9f52b21b..5d3c41b6219959a7ce9c49ff5671aaaf83242615 100644 (file)
@@ -22,12 +22,6 @@ For more details about GNUnet namespaces and content encoding please read the 'E
 \fB\-a \fILEVEL\fR, \fB\-\-anonymity=LEVEL\fR
 set desired level of sender anonymity.  Default is 1.
 
-.TP
-\fB\-A\fR, \fB\-\-automate\fR
-Start a (new) collection.  Works only in conjunction with the \-C option.  A collection is an automatically managed directory in a namespace.  In essence, after starting the collection every file that you insert into GNUnet will automatically be placed into the collection.  Other users can browse your collection and be certain (thanks to cryptography) that all of these files were inserted into GNUnet by the same user (they do not necessarily know who it is, but if you specify your realname (\-r) they will be able to see that handle).  Collections are useful for establishing a reputation for your GNUnet content, such that readers can form an opinion about quality and availability.  Namespaces can be used to achieve the same thing, but collections are automatic and thus less work for you.
-
-Using collections has some security implications since it is possible for an adversary to see that all of these files originate from the same user.  This may help a correlation attack to break anonymity.  Nevertheless we encourage using collections, they are likely to be the right choice for most users.
-
 .TP
 \fB\-C NAME\fR, \fB\-\-create=NAME\fR
 Creates a new pseudonym with the given NAME or creates a new advertisement for the pseudonym with the given NAME (if the pseudonym already exists).
@@ -36,10 +30,6 @@ Creates a new pseudonym with the given NAME or creates a new advertisement for t
 \fB\-D NAME\fR, \fB\-\-delete=NAME\fR
 Delete the pseudonym with the given NAME.
 
-.TP
-\fB\-e\fR, \fB\-\-end\fR
-End a collection.  This option is the opposite of the \-A option in that it stops the collection.  Note that currently, once you stop a collection you can never restart it.  However, you can start a new collection.  There can only be one collection at any given point in time for a particular user.
-
 .TP
 \fB\-h\fR, \fB\-\-help\fR
 Print help page.
@@ -48,17 +38,13 @@ Print help page.
 \fB\-k KEYWORD\fR, \fB\-\-keyword=KEYWORD\fR
 Publish a namespace advertisement under the keyword 'KEYWORD'.  Default is 'namespace' (use with \-C).  You can specify \-k multiple times.  In that case, the namespace will be published under each of those keywords.
 
-.TP
-\fB\-l\fR, \fB\-\-local\-only\fR
-display names of local namespaces (those that we can extend with content because we created them)
-
 .TP
 \fB\-m \fITYPE:VALUE\fR, \fB\-\-meta=\fITYPE:VALUE\fR
 For the main file (or directory), set the metadata of the given TYPE to the given VALUE.  Note that this will not add the respective VALUE to the set of keywords under which the file can be found.
 
 .TP
-\fB\-n\fR, \fB\-\-no\-advertisement\fR
-Do not generate an advertisement for the namespace (use with \-C).
+\fB\-o\fR, \fB\-\-only\-local\fR
+display names of local namespaces (those that we can extend with content because we created them)
 
 .TP
 \fB\-p \fIPRIORITY\fR, \fB\-\-prio=\fIPRIORITY\fR
@@ -69,8 +55,12 @@ Set the priority of the namespace advertisement (default: 365).  If the local da
 Do not print the list of pseudonyms (only perform create or delete operation).
 
 .TP
-\fB\-r IDENTIFIER\fR, \fB\-\-root=IDENTIFIER\fR
-Specify the identifier for the root of the namespace.  Used in the namespace advertisement to tell users that find the namespace advertisement about an entry\-point into the namespace (use with \-C).
+\fB\-r \fILEVEL\fR, \fB\-\-replication=\fILEVEL\fR
+Set the desired replication level.  If CONTENT_PUSHING is set to YES, GNUnet will push each block (for the file) LEVEL times to other peers before doing nomral "random" replication of all content.  This option can be used to push some content out into the network harder. Note that pushing content LEVEL times into the network does not guarantee that there will actually be LEVEL replicas.
+
+.TP
+\fB\-R IDENTIFIER\fR, \fB\-\-root=IDENTIFIER\fR
+Specify the identifier for the root of the namespace.  Used in the namespace advertisement to tell users that find the namespace advertisement about an entry\-point into the namespace (use with \-C).  Advertisements are only created if "\-C" and "\-r" are specified.
 
 .TP
 \fB\-s ID:VALUE\fR, \fB\-\-set-rating=ID:VALUE\fR
@@ -81,10 +71,6 @@ Change the rating for the namespace identified by ID by VALUE.  For example, "\-
 ~/.gnunet/data/pseudonyms/
 Directory where the pseudonyms are stored
 
-.TP
-~/.gnunet/data/collection
-File where information about the currently active collection is kept (if any)
-
 .SH "REPORTING BUGS"
 Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org>
 .SH "SEE ALSO"