Expand the 25519/448 overview man pages

Include more information about how to create keys for these algorithms.

Reviewed-by: Richard Levitte <levitte@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/5520)

diff --git a/doc/man7/Ed25519.pod b/doc/man7/Ed25519.pod
index da6cbc009c6f3d3509bd6bb1a6326f595b3fa8ea..f2f6fb2a326b7a090dc753100be704a2dfe732e5 100644 (file)
--- a/doc/man7/Ed25519.pod
+++ b/doc/man7/Ed25519.pod
@@ -39,6 +39,16 @@ For the B<Ed448> algorithm a context can be obtained by calling:
 
  EVP_PKEY_CTX *pctx = EVP_PKEY_CTX_new_id(EVP_PKEY_ED448, NULL);
 
+Ed25519 or Ed448 private keys can be set directly using
+L<EVP_PKEY_new_private_key(3)> or loaded from a PKCS#8 private key file using
+L<PEM_read_bio_PrivateKey(3)> (or similar function). Completely new keys can
+also be generated (see the example below). Setting a private key also sets the
+associated public key.
+
+Ed25519 or Ed448 public keys can be set directly using
+L<EVP_PKEY_new_public_key(3)> or loaded from a SubjectPublicKeyInfo structure
+in a PEM file using L<PEM_read_bio_PUBKEY(3)> (or similar function).
+
 =head1 EXAMPLE
 
 This example generates an B<ED25519> private key and writes it to standard

diff --git a/doc/man7/X25519.pod b/doc/man7/X25519.pod
index 69ab0b4a3de59efe58f7c41cb59ce38893c78a87..f1a9c4928ed8e75438325ea68c3bc2b47796ad35 100644 (file)
--- a/doc/man7/X25519.pod
+++ b/doc/man7/X25519.pod
@@ -27,6 +27,16 @@ For the B<X448> algorithm a context can be obtained by calling:
 
  EVP_PKEY_CTX *pctx = EVP_PKEY_CTX_new_id(EVP_PKEY_X448, NULL);
 
+X25519 or X448 private keys can be set directly using
+L<EVP_PKEY_new_private_key(3)> or loaded from a PKCS#8 private key file using
+L<PEM_read_bio_PrivateKey(3)> (or similar function). Completely new keys can
+also be generated (see the example below). Setting a private key also sets the
+associated public key.
+
+X25519 or X448 public keys can be set directly using
+L<EVP_PKEY_new_public_key(3)> or loaded from a SubjectPublicKeyInfo structure
+in a PEM file using L<PEM_read_bio_PUBKEY(3)> (or similar function).
+
 =head1 EXAMPLE
 
 This example generates an B<X25519> private key and writes it to standard