1 .\" This file is part of GNUnet.
2 .\" Copyright (C) 2001-2019 GNUnet e.V.
4 .\" Permission is granted to copy, distribute and/or modify this document
5 .\" under the terms of the GNU Free Documentation License, Version 1.3 or
6 .\" any later version published by the Free Software Foundation; with no
7 .\" Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
8 .\" copy of the license is included in the file
11 .\" A copy of the license is also available from the Free Software
12 .\" Foundation Web site at http://www.gnu.org/licenses/fdl.html}.
14 .\" Alternately, this document is also available under the General
15 .\" Public License, version 3 or later, as published by the Free Software
16 .\" Foundation. A copy of the license is included in the file
19 .\" A copy of the license is also available from the Free Software
20 .\" Foundation Web site at http://www.gnu.org/licenses/gpl.html
22 .\" SPDX-License-Identifier: GPL3.0-or-later OR FDL1.3-or-later
29 .Nd create, delete or list egos
32 .Op Fl C Ar NAME | Fl -create= Ns Ar NAME
33 .Op Fl D Ar NAME | Fl -delete= Ns Ar NAME
35 .Op Fl e Ar NAME | Fl -ego= Ns Ar NAME
38 .Op Fl p | \-private-keys
40 .Op Fl s Ar SUBSYSTEM | Fl -set= Ns Ar SUBSYSTEM
44 is a tool for managing egos.
45 An ego is the persona that controls a namespace.
46 It is identical to a public-private ECC key pair.
48 gnunet-identity can be used to list all of the egos that were
49 created locally, to create new egos, and to delete
50 existing egos (the namespace will continue to exist, but it will
51 be impossible to add additional data to it).
53 Creating a new ego requires using the
55 option together with an identifier (name) that is to be used for
57 This identifier is only used locally for this peer and not shared
59 The options are as follows:
60 .Bl -tag -width indent
61 .It Fl C Ar NAME | Fl -create= Ns Ar NAME
62 Creates a new ego with the given
64 .It Fl D Ar NAME | Fl -delete= Ns Ar NAME
65 Delete the ego with the given
68 Display all of our egos.
69 .It Fl e Ar NAME | Fl -ego= Ns Ar NAME
70 Perform "set" operation with the respective ego or restrict "display"
71 operation to the respective ego.
75 Run in monitor mode, listing all ouf our egos until CTRL-C is pressed.
76 Each ego is listed together with a unique pointer value; if
77 egos are renamed, that pointer value remains the same,
78 if egos are deleted, they are listed one more time with a name of "<null>".
79 .It Fl p | -private-keys
80 Print the private keys (in Crockford Base32 encoding), and not just the public
81 keys. The second column shows the public key, the third column shows the
84 Be quiet, in particular outputs only the public key when listing egos.
85 .It Fl s Ar SUBSYSTEM | Fl -set= Ns Ar SUBSYSTEM
86 Perform "set" operation for the specified
88 with the respective ego.
89 Needs to be used together with option
91 After this, the given SUBSYSTEM will use the ego with the specified NAME.
96 Be verbose, in particular outputs the public key of freshly created egos.
99 .Pa ~/.local/share/gnunet/identity/egos
100 Directory where the egos are stored by default
104 .Xr gnunet-namestore 1
106 The full documentation for gnunet is maintained as a Texinfo manual.
109 and gnunet programs are properly installed at your site, the command
113 should give you access to the complete handbook,
115 .Dl info gnunet-c-tutorial
117 will give you access to a tutorial for developers.
119 Depending on your installation, this information is also available in
121 .Xr gnunet-c-tutorial 7 .
126 .Lk https://bugs.gnunet.org
127 or by sending electronic mail to
128 .Aq Mt gnunet-developers@gnu.org .