NAME

       gnunet-identity — create, delete or list egos

SYNOPSIS

       gnunet-identity   [-C   NAME   |   --create=NAME]   [-D   NAME   |   --delete=NAME]   [-d   |  --display]
                       [-e  NAME  |  --ego=NAME]  [-h  |  --help]  [-m  |  --monitor]  [-p   |   --private-keys]
                       [-q | --quiet] [-s SUBSYSTEM | --set=SUBSYSTEM] [-V | --verbose] [-X | --eddsa]

DESCRIPTION

       gnunet-identity  is  a  tool  for managing egos.  An ego is the persona that controls a namespace.  It is
       identical to a public-private ECC key pair.

       gnunet-identity can be used to list all of the egos that were created locally, to create new egos, and to
       delete existing egos (the namespace will continue to exist, but it will be impossible to  add  additional
       data to it).

       Creating a new ego requires using the -C option together with an identifier (name) that is to be used for
       the  new  ego.   This identifier is only used locally for this peer and not shared with other peers.  The
       options are as follows:

       -C NAME | --create=NAME
               Creates a new ego with the given NAME.

       -D NAME | --delete=NAME
               Delete the ego with the given NAME.

       -d | --display
               Display all of our egos.

       -e NAME | --ego=NAME
               Perform "set" operation with the respective ego or restrict "display" operation to the respective
               ego.

       -h | --help
               Print the help page.

       -m | --monitor
               Run in monitor mode, listing all ouf our egos until  CTRL-C  is  pressed.   Each  ego  is  listed
               together  with  a unique pointer value; if egos are renamed, that pointer value remains the same,
               if egos are deleted, they are listed one more time with a name of "<null>".

       -p | --private-keys
               Print the private keys (in Crockford Base32 encoding), and not just the public keys.  The  second
               column shows the public key, the third column shows the private key.

       -q | --quiet
               Be quiet, in particular outputs only the public key when listing egos.

       -s SUBSYSTEM | --set=SUBSYSTEM
               Perform  "set"  operation  for the specified SUBSYSTEM with the respective ego.  Needs to be used
               together with option -e.  After this, the given SUBSYSTEM will use the  ego  with  the  specified
               NAME.  This will fail if NAME does not yet exist.

       -V | --verbose
               Be verbose, in particular outputs the public key of freshly created egos.

       -X | --eddsa
               Use EdDSA instead of ECDSA.

FILES

       ~/.local/share/gnunet/identity/egos Directory where the egos are stored by default

SEE ALSO

       gnunet-gns(1), gnunet-namestore(1)

       The  full documentation for gnunet is maintained as a Texinfo manual.  If the info(1) and gnunet programs
       are properly installed at your site, the command

             info gnunet

       should give you access to the complete handbook,

             info gnunet-c-tutorial

       will give you access to a tutorial for developers.

       Depending on your installation, this information is also available in gnunet(7) and gnunet-c-tutorial(7).

BUGS

       Report   bugs   by    using    https://bugs.gnunet.org    or    by    sending    electronic    mail    to
       ⟨gnunet-developers@gnu.org⟩.

Debian                                          September 5, 2013                             GNUNET-IDENTITY(1)