summaryrefslogtreecommitdiffstats
path: root/doc/man3/EC_GROUP_copy.pod
diff options
context:
space:
mode:
authorslontis <shane.lontis@oracle.com>2022-05-04 12:04:43 +1000
committerPauli <pauli@openssl.org>2022-05-09 10:08:07 +1000
commitb40c753b6e09eb6df06c161cdf771c704898b050 (patch)
tree86165ecf2d5a9c538957e9b06f4df9e8189c3458 /doc/man3/EC_GROUP_copy.pod
parentfcbd8be18229ef7aa32369d2e9c747348f7d6490 (diff)
Add documentation for key validation that indicates the difference between the
EVP_PKEY_XXX_check() calls for the default and fips providers. Reviewed-by: Tomas Mraz <tomas@openssl.org> Reviewed-by: Paul Dale <pauli@openssl.org> (Merged from https://github.com/openssl/openssl/pull/18235) (cherry picked from commit 0b3d2594d060dc19269d3740ad672f065ec6398a)
Diffstat (limited to 'doc/man3/EC_GROUP_copy.pod')
-rw-r--r--doc/man3/EC_GROUP_copy.pod5
1 files changed, 3 insertions, 2 deletions
diff --git a/doc/man3/EC_GROUP_copy.pod b/doc/man3/EC_GROUP_copy.pod
index 3702f7368c..2f776cc8c5 100644
--- a/doc/man3/EC_GROUP_copy.pod
+++ b/doc/man3/EC_GROUP_copy.pod
@@ -159,9 +159,10 @@ The function EC_GROUP_check_discriminant() calculates the discriminant for the c
For a curve defined over Fp the discriminant is given by the formula 4*a^3 + 27*b^2 whilst for F2^m curves the discriminant is
simply b. In either case for the curve to be valid the discriminant must be non zero.
-The function EC_GROUP_check() performs a number of checks on a curve to verify that it is valid. Checks performed include
+The function EC_GROUP_check() behaves in the following way:
+For the OpenSSL default provider it performs a number of checks on a curve to verify that it is valid. Checks performed include
verifying that the discriminant is non zero; that a generator has been defined; that the generator is on the curve and has
-the correct order.
+the correct order. For the OpenSSL FIPS provider it uses EC_GROUP_check_named_curve() to conform to SP800-56Ar3.
The function EC_GROUP_check_named_curve() determines if the group's domain parameters match one of the built-in curves supported by the library.
The curve name is returned as a B<NID> if it matches. If the group's domain parameters have been modified then no match will be found.