Provided by: gnunet-client_0.9.3-7build1_amd64 
NAME
gnunet-pseudonym - create, delete or list pseudonyms
SYNOPSIS
gnunet-pseudonym [options]
DESCRIPTION
gnunet-pseudonym is a tool for managing pseudonyms and namespaces. A pseudonym is the persona that
controls a namespace. As such, it is identical to a public-private RSA key pair. A namespace is a
collection of files that have been signed by the corresponding private RSA key. A namespace is typically
associated with a nickname and other metadata.
Namespaces are an important tool for providing assurances about content integrity and authenticity in
GNUnet. Since all of the content in the namespace must have been provided by the same entity, users can
form an opinion about that entity and learn to search (or avoid) certain namespaces.
gnunet-pseudonym can be used to list all of the pseudonyms that were created locally, to create new
pseudonyms, to delete existing pseudonyms (the namespace will continue to exist, but it will be
impossible to add additional data to it) and to list all of the namespaces (with their meta-data) known
to the local user. By default, gnunet-pseudonym lists all pseudonyms that were discovered so far.
Creating a new pseudonym requires using the -C option together with a nickname that is to be used for the
namespace. Nicknames must be unique for each user, global uniqueness is desirable but not necessary. If
two namespaces in GNUnet use the same nickname all GNUnet tools will display the nickname together with a
number which ensures that the name becomes locally unique to avoid ambiguity. Additional options can be
passed together with the -C option to provide additional meta-data that describes the namespace.
Possible meta-data includes the 'realname' of the person controlling the namespace, a description, the
mime-type for content in the namespace (useful if the namespace is dedicated to some specific type of
content) and contact information. One important piece of meta-data that can be specified is the
identifier of a document root, that is the name of a file in the namespace that is a portal to the rest
of the content. This is useful to help users find this root in the absence of conventions. Note that
all of this meta-data is optional and should never be trusted blindly.
As mentioned before, by default, gnunet-pseudonym simply lists the meta-data available for other
namespaces. Namespaces can be discovered whenever the peer obtains the namespace advertisement.
Namespace advertisements can be found using ordinary keyword-based searches (by default gnunet-pseudonym
publishes the namespace advertisement under the keyword 'namespace', but the -k option can be used to
specify other keywords) and under the 'empty' identifier of the respective namespace (using a
namespace-search if the namespace ID is already known).
For more details about GNUnet namespaces and content encoding please read the 'Encoding for
Censorship-resistant Sharing' (ECRS) paper which can be found on the GNUnet webpage.
-a LEVEL, --anonymity=LEVEL
set desired level of sender anonymity. Default is 1.
-C NAME, --create=NAME
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).
-D NAME, --delete=NAME
Delete the pseudonym with the given NAME.
-h, --help
Print help page.
-k KEYWORD, --keyword=KEYWORD
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.
-m TYPE:VALUE, --meta=TYPE:VALUE
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.
-o, --only-local
display names of local namespaces (those that we can extend with content because we created them)
-p PRIORITY, --prio=PRIORITY
Set the priority of the namespace advertisement (default: 365). If the local database is full,
GNUnet will discard the content with the lowest ranking. Note that ranks change over time
depending on popularity. The default should be high enough to preserve the locally inserted
content in favor of content that migrates from other peers.
-q, --quiet
Do not print the list of pseudonyms (only perform create or delete operation).
-r LEVEL, --replication=LEVEL
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.
-R IDENTIFIER, --root=IDENTIFIER
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.
-s ID:VALUE, --set-rating=ID:VALUE
Change the rating for the namespace identified by ID by VALUE. For example, "-s test:-3"
decrements the rating of the pseudonym "test" by 3. Note that ratings are purely local. Each
user has his own independent rating of namespaces. The rating is merely a way for each user to
keep track of his own experience with a given namespace.
FILES
~/.gnunet/data/pseudonyms/
Directory where the pseudonyms are stored
REPORTING BUGS
Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to
<gnunet-developers@gnu.org>
SEE ALSO
gnunet-publish(1), gnunet-search(1)
GNUnet 25 Feb 2012 GNUNET-PSEUDONYM(1)