Commit 82dd65a2 authored Mar 05, 2018 by Matt Caswell

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)

parent 0f987bda

doc/man7/Ed25519.pod

+10 −0

Original line number	Diff line number	Diff line
		@@ -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

doc/man7/X25519.pod

+10 −0

Original line number	Diff line number	Diff line
		@@ -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