summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMartin Schanzenbach <mschanzenbach@posteo.de>2021-05-28 10:54:08 +0200
committerMartin Schanzenbach <mschanzenbach@posteo.de>2021-05-28 10:54:08 +0200
commitaa25216fe5bb23bb5e7a118114c67a1478acde4c (patch)
tree92490203639f54f34bd69c14918624ab47563071 /doc
parentdff1f0c7fb3f1f4dacaeef557dd7d3eec5ff9084 (diff)
IDENTITY: Add EdDSA switch to handbook and manpage
Diffstat (limited to 'doc')
-rw-r--r--doc/handbook/chapters/user.texi17
-rw-r--r--doc/man/gnunet-identity.13
2 files changed, 14 insertions, 6 deletions
diff --git a/doc/handbook/chapters/user.texi b/doc/handbook/chapters/user.texi
index 409a89e47..aa912f96f 100644
--- a/doc/handbook/chapters/user.texi
+++ b/doc/handbook/chapters/user.texi
@@ -97,7 +97,7 @@ the peer identity. The IDENTITY service essentially stores the
private keys under human-readable names, and keeps a mapping of which
private key should be used for particular important system functions.
The existing identities can be listed using the command
-@command{gnunet-identity -d}
+@command{gnunet-identity --display}
@example
gnu - JTDVJC69NHU6GQS4B5721MV8VM7J6G2DVRGJV0ONIT6QH7OI6D50
@@ -1098,7 +1098,7 @@ selection is simply random.
@subsection Namespace Management
The @code{gnunet-identity} tool can be used to create egos.
-By default, @code{gnunet-identity -D} simply
+By default, @code{gnunet-identity --display} simply
lists all locally available egos.
@@ -1110,7 +1110,7 @@ lists all locally available egos.
@node Creating Egos
@subsubsection Creating Egos
-With the @command{-C NICK} option it can also be used to create a new
+With the @command{--create=NICK} option it can also be used to create a new
ego. An ego is the virtual identity of the entity in control of a
namespace or GNS zone. Anyone can create any number of egos. The
provided NICK name automatically corresponds to a GNU Name System
@@ -1118,6 +1118,11 @@ domain name. Thus, henceforth name resolution for any name ending in
``.NICK'' will use the NICK's zone. You should avoid using NICKs that
collide with well-known DNS names.
+Currently, the IDENTITY subsystem supports two types of identity keys:
+ECDSA and EdDSA. By default, ECDSA identities are creates with ECDSA keys.
+In order to create an identity with EdDSA keys, you can use the
+@command{--eddsa} flag.
+
@node Deleting Egos
@subsubsection Deleting Egos
@@ -1409,7 +1414,7 @@ You can create any number of zones using the gnunet-identity tool
using:
@example
-$ gnunet-identity -C "myzone"
+$ gnunet-identity --create="myzone"
@end example
Henceforth, on your system you control the TLD ``myzone''.
@@ -1418,7 +1423,7 @@ All of your zones can be listed (displayed) using the
@command{gnunet-identity} command line tool as well:
@example
-$ gnunet-identity -d
+$ gnunet-identity --display
@end example
@node Maintaining your own Zones
@@ -1929,7 +1934,7 @@ integrate reclaimID as an Identity Provider with little effort.
Before adding attributes to an identity, you must first create an ego:
@example
-$ gnunet-identity -C "user"
+$ gnunet-identity --create="user"
@end example
Henceforth, you can manage a new user profile of the user ``user''.
diff --git a/doc/man/gnunet-identity.1 b/doc/man/gnunet-identity.1
index 1adfdf4d0..599d3b269 100644
--- a/doc/man/gnunet-identity.1
+++ b/doc/man/gnunet-identity.1
@@ -39,6 +39,7 @@
.Op Fl q | -quiet
.Op Fl s Ar SUBSYSTEM | Fl -set= Ns Ar SUBSYSTEM
.Op Fl V | -verbose
+.Op Fl X | -eddsa
.Sh DESCRIPTION
.Nm
is a tool for managing egos.
@@ -94,6 +95,8 @@ This will fail if
does not yet exist.
.It Fl V | -verbose
Be verbose, in particular outputs the public key of freshly created egos.
+.It Fl X | -eddsa
+Use EdDSA instead of ECDSA.
.El
.Sh FILES
.Pa ~/.local/share/gnunet/identity/egos