initial version of gnunet-identity command-line tool
[oweals/gnunet.git] / doc / man / gnunet-identity.1
1 .TH GNUNET-IDENTITY "1" "16 Jul 2013" "GNUnet"
2 .SH NAME
3 gnunet\-identity \- create, delete or list egos
4 .SH SYNOPSIS
5 .B gnunet\-identity
6 [options]
7 .SH DESCRIPTION
8 .PP
9 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.
10
11 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).
12
13 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.
14
15 .TP
16 \fB\-C NAME\fR, \fB\-\-create=NAME\fR
17 Creates a new ego with the given NAME.
18
19 .TP
20 \fB\-D NAME\fR, \fB\-\-delete=NAME\fR
21 Delete the ego with the given NAME.
22
23 .TP
24 \fB\-h\fR, \fB\-\-help\fR
25 Print help page.
26
27 .TP
28 \fB\-L\fR, \fB\-\-list\fR
29 list all ouf our egos
30
31 .TP
32 \fB\-m\fR, \fB\-\-monitor\fR
33 run in monitor mode, listing all ouf our egos until CTRL-C is pressed
34
35
36 .SH FILES
37 .TP
38 ~/.gnunet/egos/
39 Directory where the egos are stored (by default)
40
41 .SH "REPORTING BUGS"
42 Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org>
43 .SH "SEE ALSO"
44 \fBgnunet\-pseudonym\fP(1), \fBgnunet\-gns\fP(1)