Skip to content

Commit

Permalink
manpages: discuss about USK, SSK in fcpgenkey (1)
Browse files Browse the repository at this point in the history
Add a discussion about the sameness of USK and SSK keys into
the manpage for fcpgenkey as this is one of the things I found
harder to understand as a newbie.
  • Loading branch information
Soliloque committed Feb 22, 2015
1 parent fe46e4f commit 3caa1f7
Showing 1 changed file with 21 additions and 2 deletions.
23 changes: 21 additions & 2 deletions manpages/fcpgenkey.1
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,28 @@ fcpgenkey \- generate a single Freenet SSK@/USK@ keypair
fcpgenkey is a simple command\-line FCP client program for generating
new Freenet SSK@ or USK@ public/private keypairs.

The keypair generated is written to standard output stream, with
the public key, then a newline, then the private key.
The keypair generated is written to standard output stream as SSK@
keys, with the public key, then a newline, then the private key.

.SH "Converting an SSK@ key to an USK@ one"
.LP
USK@ are really just a user-friendly wrapper around SSK@, which hide
the process of searching for more recent versions of a site. Any
address written using an SSK@ key can also be written using an USK@
key.
.TP
.B
Syntax of address using SSK@ key:
http://127.0.0.1:8888/SSK@<key>/<name_of_site>-<version#>/
.TP
.B
Syntax of address using USK@ key:
http://127.0.0.1:8888/USK@<key>/<name_of_site>/<version#>/
.TP
.B
These two addresses are completely equivalent and can be inserted as either one:
http://localhost:8888/[email protected]/freenetdocwiki/17/
http://localhost:8888/[email protected]/freenetdocwiki-17/
.SH "OPTIONS"
.LP
.TP
Expand Down

0 comments on commit 3caa1f7

Please sign in to comment.