From: Richard Levitte <levitte@openssl.org>
Date: Tue, 26 May 2020 12:25:44 +0000 (+0200)
Subject: DOCS: add openssl-core_numbers.h(7)
X-Git-Tag: openssl-3.0.0-alpha3~20
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=329b2a2cde480fbfe1cf43bf8ecf1c75a16cf6bf;p=thirdparty%2Fopenssl.git

DOCS: add openssl-core_numbers.h(7)

Reviewed-by: Shane Lontis <shane.lontis@oracle.com>
(Merged from https://github.com/openssl/openssl/pull/11963)
---

diff --git a/doc/man7/openssl-core_numbers.h.pod b/doc/man7/openssl-core_numbers.h.pod
new file mode 100644
index 00000000000..d9bdcbc8105
--- /dev/null
+++ b/doc/man7/openssl-core_numbers.h.pod
@@ -0,0 +1,56 @@
+=pod
+
+=head1 NAME
+
+openssl/core_numbers.h
+- OpenSSL provider dispatch numbers and function types
+
+=head1 SYNOPSIS
+
+ #include <openssl/core_numbers.h>
+
+=head1 DESCRIPTION
+
+The F<< <openssl/core_numbers.h> >> header defines all the operation
+numbers, dispatch numbers and provider interface function types
+currently available.
+
+The operation and dispatch numbers are represented with macros, which
+are named as follows:
+
+=over 4
+
+=item operation numbers
+
+These macros have the form C<OSSL_OP_I<opname>>.
+
+=item dipatch numbers
+
+These macros have the form C<OSSL_FUNC_I<opname>_I<funcname>>, where
+C<I<opname>> is the same as in the macro for the operation this
+function belongs to.
+
+=back
+
+With every dispatch number, there is an associated function type.
+
+For further information, please see the L<provider(7)>
+
+=head1 SEE ALSO
+
+L<provider(7)>
+
+=head1 HISTORY
+
+The types and macros described here were added in OpenSSL 3.0.
+
+=head1 COPYRIGHT
+
+Copyright 2020 The OpenSSL Project Authors. All Rights Reserved.
+
+Licensed under the Apache License 2.0 (the "License").  You may not use
+this file except in compliance with the License.  You can obtain a copy
+in the file LICENSE in the source distribution or at
+L<https://www.openssl.org/source/license.html>.
+
+=cut
diff --git a/util/missingcrypto.txt b/util/missingcrypto.txt
index 6fba94701ad..bc276a8c4ab 100644
--- a/util/missingcrypto.txt
+++ b/util/missingcrypto.txt
@@ -1570,7 +1570,6 @@ i2v_ASN1_BIT_STRING(3)
 i2v_GENERAL_NAME(3)
 i2v_GENERAL_NAMES(3)
 o2i_ECPublicKey(3)
-openssl-core_numbers.h(7)
 provider-kdf(7)
 v2i_ASN1_BIT_STRING(3)
 v2i_GENERAL_NAME(3)