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)