File Explorer

1/*2 * Copyright 2019-2025 The OpenSSL Project Authors. All Rights Reserved.3 *4 * Licensed under the Apache License 2.0 (the "License").  You may not use5 * this file except in compliance with the License.  You can obtain a copy6 * in the file LICENSE in the source distribution or at7 * https://www.openssl.org/source/license.html8 */9 10#ifndef OPENSSL_CORE_NUMBERS_H11#define OPENSSL_CORE_NUMBERS_H12#pragma once13 14#include <stdarg.h>15#include <openssl/core.h>16#include <openssl/indicator.h>17 18#ifdef __cplusplus19extern "C" {20#endif21 22/*23 * Generic function pointer for provider method arrays, or other contexts where24 * functions of various signatures must occupy a common slot in an array of25 * structures.26 */27typedef void (*OSSL_FUNC)(void);28 29/*-30 * Identities31 * ----------32 *33 * All series start with 1, to allow 0 to be an array terminator.34 * For any FUNC identity, we also provide a function signature typedef35 * and a static inline function to extract a function pointer from a36 * OSSL_DISPATCH element in a type safe manner.37 *38 * Names:39 * for any function base name 'foo' (uppercase form 'FOO'), we will have40 * the following:41 * - a macro for the identity with the name OSSL_FUNC_'FOO' or derivatives42 *   thereof (to be specified further down)43 * - a function signature typedef with the name OSSL_FUNC_'foo'_fn44 * - a function pointer extractor function with the name OSSL_FUNC_'foo'45 */46 47/*48 * Helper macro to create the function signature typedef and the extractor49 * |type| is the return-type of the function, |name| is the name of the50 * function to fetch, and |args| is a parenthesized list of parameters51 * for the function (that is, it is |name|'s function signature).52 * Note: This is considered a "reserved" internal macro. Applications should53 * not use this or assume its existence.54 */55#define OSSL_CORE_MAKE_FUNC(type, name, args)          \56    typedef type(OSSL_FUNC_##name##_fn) args;          \57    static ossl_unused ossl_inline                     \58        OSSL_FUNC_##name##_fn *                        \59        OSSL_FUNC_##name(const OSSL_DISPATCH *opf)     \60    {                                                  \61        return (OSSL_FUNC_##name##_fn *)opf->function; \62    }63 64/*65 * Core function identities, for the two OSSL_DISPATCH tables being passed66 * in the OSSL_provider_init call.67 *68 * 0 serves as a marker for the end of the OSSL_DISPATCH array, and must69 * therefore NEVER be used as a function identity.70 */71/* Functions provided by the Core to the provider, reserved numbers 1-1023 */72#define OSSL_FUNC_CORE_GETTABLE_PARAMS 173OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *,74    core_gettable_params, (const OSSL_CORE_HANDLE *prov))75#define OSSL_FUNC_CORE_GET_PARAMS 276OSSL_CORE_MAKE_FUNC(int, core_get_params, (const OSSL_CORE_HANDLE *prov, OSSL_PARAM params[]))77#define OSSL_FUNC_CORE_THREAD_START 378OSSL_CORE_MAKE_FUNC(int, core_thread_start, (const OSSL_CORE_HANDLE *prov, OSSL_thread_stop_handler_fn handfn, void *arg))79#define OSSL_FUNC_CORE_GET_LIBCTX 480OSSL_CORE_MAKE_FUNC(OPENSSL_CORE_CTX *, core_get_libctx,81    (const OSSL_CORE_HANDLE *prov))82#define OSSL_FUNC_CORE_NEW_ERROR 583OSSL_CORE_MAKE_FUNC(void, core_new_error, (const OSSL_CORE_HANDLE *prov))84#define OSSL_FUNC_CORE_SET_ERROR_DEBUG 685OSSL_CORE_MAKE_FUNC(void, core_set_error_debug,86    (const OSSL_CORE_HANDLE *prov,87        const char *file, int line, const char *func))88#define OSSL_FUNC_CORE_VSET_ERROR 789OSSL_CORE_MAKE_FUNC(void, core_vset_error,90    (const OSSL_CORE_HANDLE *prov,91        uint32_t reason, const char *fmt, va_list args))92#define OSSL_FUNC_CORE_SET_ERROR_MARK 893OSSL_CORE_MAKE_FUNC(int, core_set_error_mark, (const OSSL_CORE_HANDLE *prov))94#define OSSL_FUNC_CORE_CLEAR_LAST_ERROR_MARK 995OSSL_CORE_MAKE_FUNC(int, core_clear_last_error_mark,96    (const OSSL_CORE_HANDLE *prov))97#define OSSL_FUNC_CORE_POP_ERROR_TO_MARK 1098OSSL_CORE_MAKE_FUNC(int, core_pop_error_to_mark, (const OSSL_CORE_HANDLE *prov))99 100/* Functions to access the OBJ database */101 102#define OSSL_FUNC_CORE_OBJ_ADD_SIGID 11103#define OSSL_FUNC_CORE_OBJ_CREATE 12104 105OSSL_CORE_MAKE_FUNC(int, core_obj_add_sigid,106    (const OSSL_CORE_HANDLE *prov, const char *sign_name,107        const char *digest_name, const char *pkey_name))108OSSL_CORE_MAKE_FUNC(int, core_obj_create,109    (const OSSL_CORE_HANDLE *prov, const char *oid,110        const char *sn, const char *ln))111 112/* Memory allocation, freeing, clearing. */113#define OSSL_FUNC_CRYPTO_MALLOC 20114OSSL_CORE_MAKE_FUNC(void *,115    CRYPTO_malloc, (size_t num, const char *file, int line))116#define OSSL_FUNC_CRYPTO_ZALLOC 21117OSSL_CORE_MAKE_FUNC(void *,118    CRYPTO_zalloc, (size_t num, const char *file, int line))119#define OSSL_FUNC_CRYPTO_FREE 22120OSSL_CORE_MAKE_FUNC(void,121    CRYPTO_free, (void *ptr, const char *file, int line))122#define OSSL_FUNC_CRYPTO_CLEAR_FREE 23123OSSL_CORE_MAKE_FUNC(void,124    CRYPTO_clear_free, (void *ptr, size_t num, const char *file, int line))125#define OSSL_FUNC_CRYPTO_REALLOC 24126OSSL_CORE_MAKE_FUNC(void *,127    CRYPTO_realloc, (void *addr, size_t num, const char *file, int line))128#define OSSL_FUNC_CRYPTO_CLEAR_REALLOC 25129OSSL_CORE_MAKE_FUNC(void *,130    CRYPTO_clear_realloc, (void *addr, size_t old_num, size_t num, const char *file, int line))131#define OSSL_FUNC_CRYPTO_SECURE_MALLOC 26132OSSL_CORE_MAKE_FUNC(void *,133    CRYPTO_secure_malloc, (size_t num, const char *file, int line))134#define OSSL_FUNC_CRYPTO_SECURE_ZALLOC 27135OSSL_CORE_MAKE_FUNC(void *,136    CRYPTO_secure_zalloc, (size_t num, const char *file, int line))137#define OSSL_FUNC_CRYPTO_SECURE_FREE 28138OSSL_CORE_MAKE_FUNC(void,139    CRYPTO_secure_free, (void *ptr, const char *file, int line))140#define OSSL_FUNC_CRYPTO_SECURE_CLEAR_FREE 29141OSSL_CORE_MAKE_FUNC(void,142    CRYPTO_secure_clear_free, (void *ptr, size_t num, const char *file, int line))143#define OSSL_FUNC_CRYPTO_SECURE_ALLOCATED 30144OSSL_CORE_MAKE_FUNC(int,145    CRYPTO_secure_allocated, (const void *ptr))146#define OSSL_FUNC_OPENSSL_CLEANSE 31147OSSL_CORE_MAKE_FUNC(void,148    OPENSSL_cleanse, (void *ptr, size_t len))149 150/* Bio functions provided by the core */151#define OSSL_FUNC_BIO_NEW_FILE 40152#define OSSL_FUNC_BIO_NEW_MEMBUF 41153#define OSSL_FUNC_BIO_READ_EX 42154#define OSSL_FUNC_BIO_WRITE_EX 43155#define OSSL_FUNC_BIO_UP_REF 44156#define OSSL_FUNC_BIO_FREE 45157#define OSSL_FUNC_BIO_VPRINTF 46158#define OSSL_FUNC_BIO_VSNPRINTF 47159#define OSSL_FUNC_BIO_PUTS 48160#define OSSL_FUNC_BIO_GETS 49161#define OSSL_FUNC_BIO_CTRL 50162 163OSSL_CORE_MAKE_FUNC(OSSL_CORE_BIO *, BIO_new_file, (const char *filename, const char *mode))164OSSL_CORE_MAKE_FUNC(OSSL_CORE_BIO *, BIO_new_membuf, (const void *buf, int len))165OSSL_CORE_MAKE_FUNC(int, BIO_read_ex, (OSSL_CORE_BIO * bio, void *data, size_t data_len, size_t *bytes_read))166OSSL_CORE_MAKE_FUNC(int, BIO_write_ex, (OSSL_CORE_BIO * bio, const void *data, size_t data_len, size_t *written))167OSSL_CORE_MAKE_FUNC(int, BIO_gets, (OSSL_CORE_BIO * bio, char *buf, int size))168OSSL_CORE_MAKE_FUNC(int, BIO_puts, (OSSL_CORE_BIO * bio, const char *str))169OSSL_CORE_MAKE_FUNC(int, BIO_up_ref, (OSSL_CORE_BIO * bio))170OSSL_CORE_MAKE_FUNC(int, BIO_free, (OSSL_CORE_BIO * bio))171OSSL_CORE_MAKE_FUNC(int, BIO_vprintf, (OSSL_CORE_BIO * bio, const char *format, va_list args))172OSSL_CORE_MAKE_FUNC(int, BIO_vsnprintf,173    (char *buf, size_t n, const char *fmt, va_list args))174OSSL_CORE_MAKE_FUNC(int, BIO_ctrl, (OSSL_CORE_BIO * bio, int cmd, long num, void *ptr))175 176/* New seeding functions prototypes with the 101-104 series */177#define OSSL_FUNC_CLEANUP_USER_ENTROPY 96178#define OSSL_FUNC_CLEANUP_USER_NONCE 97179#define OSSL_FUNC_GET_USER_ENTROPY 98180#define OSSL_FUNC_GET_USER_NONCE 99181 182#define OSSL_FUNC_INDICATOR_CB 95183OSSL_CORE_MAKE_FUNC(void, indicator_cb, (OPENSSL_CORE_CTX * ctx, OSSL_INDICATOR_CALLBACK **cb))184#define OSSL_FUNC_SELF_TEST_CB 100185OSSL_CORE_MAKE_FUNC(void, self_test_cb, (OPENSSL_CORE_CTX * ctx, OSSL_CALLBACK **cb, void **cbarg))186 187/* Functions to get seed material from the operating system */188#define OSSL_FUNC_GET_ENTROPY 101189#define OSSL_FUNC_CLEANUP_ENTROPY 102190#define OSSL_FUNC_GET_NONCE 103191#define OSSL_FUNC_CLEANUP_NONCE 104192OSSL_CORE_MAKE_FUNC(size_t, get_entropy, (const OSSL_CORE_HANDLE *handle, unsigned char **pout, int entropy, size_t min_len, size_t max_len))193OSSL_CORE_MAKE_FUNC(size_t, get_user_entropy, (const OSSL_CORE_HANDLE *handle, unsigned char **pout, int entropy, size_t min_len, size_t max_len))194OSSL_CORE_MAKE_FUNC(void, cleanup_entropy, (const OSSL_CORE_HANDLE *handle, unsigned char *buf, size_t len))195OSSL_CORE_MAKE_FUNC(void, cleanup_user_entropy, (const OSSL_CORE_HANDLE *handle, unsigned char *buf, size_t len))196OSSL_CORE_MAKE_FUNC(size_t, get_nonce, (const OSSL_CORE_HANDLE *handle, unsigned char **pout, size_t min_len, size_t max_len, const void *salt, size_t salt_len))197OSSL_CORE_MAKE_FUNC(size_t, get_user_nonce, (const OSSL_CORE_HANDLE *handle, unsigned char **pout, size_t min_len, size_t max_len, const void *salt, size_t salt_len))198OSSL_CORE_MAKE_FUNC(void, cleanup_nonce, (const OSSL_CORE_HANDLE *handle, unsigned char *buf, size_t len))199OSSL_CORE_MAKE_FUNC(void, cleanup_user_nonce, (const OSSL_CORE_HANDLE *handle, unsigned char *buf, size_t len))200 201/* Functions to access the core's providers */202#define OSSL_FUNC_PROVIDER_REGISTER_CHILD_CB 105203#define OSSL_FUNC_PROVIDER_DEREGISTER_CHILD_CB 106204#define OSSL_FUNC_PROVIDER_NAME 107205#define OSSL_FUNC_PROVIDER_GET0_PROVIDER_CTX 108206#define OSSL_FUNC_PROVIDER_GET0_DISPATCH 109207#define OSSL_FUNC_PROVIDER_UP_REF 110208#define OSSL_FUNC_PROVIDER_FREE 111209 210OSSL_CORE_MAKE_FUNC(int, provider_register_child_cb,211    (const OSSL_CORE_HANDLE *handle,212        int (*create_cb)(const OSSL_CORE_HANDLE *provider, void *cbdata),213        int (*remove_cb)(const OSSL_CORE_HANDLE *provider, void *cbdata),214        int (*global_props_cb)(const char *props, void *cbdata),215        void *cbdata))216OSSL_CORE_MAKE_FUNC(void, provider_deregister_child_cb,217    (const OSSL_CORE_HANDLE *handle))218OSSL_CORE_MAKE_FUNC(const char *, provider_name,219    (const OSSL_CORE_HANDLE *prov))220OSSL_CORE_MAKE_FUNC(void *, provider_get0_provider_ctx,221    (const OSSL_CORE_HANDLE *prov))222OSSL_CORE_MAKE_FUNC(const OSSL_DISPATCH *, provider_get0_dispatch,223    (const OSSL_CORE_HANDLE *prov))224OSSL_CORE_MAKE_FUNC(int, provider_up_ref,225    (const OSSL_CORE_HANDLE *prov, int activate))226OSSL_CORE_MAKE_FUNC(int, provider_free,227    (const OSSL_CORE_HANDLE *prov, int deactivate))228 229/* Additional error functions provided by the core */230#define OSSL_FUNC_CORE_COUNT_TO_MARK 120231OSSL_CORE_MAKE_FUNC(int, core_count_to_mark, (const OSSL_CORE_HANDLE *prov))232 233/* Functions provided by the provider to the Core, reserved numbers 1024-1535 */234#define OSSL_FUNC_PROVIDER_TEARDOWN 1024235OSSL_CORE_MAKE_FUNC(void, provider_teardown, (void *provctx))236#define OSSL_FUNC_PROVIDER_GETTABLE_PARAMS 1025237OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *,238    provider_gettable_params, (void *provctx))239#define OSSL_FUNC_PROVIDER_GET_PARAMS 1026240OSSL_CORE_MAKE_FUNC(int, provider_get_params, (void *provctx, OSSL_PARAM params[]))241#define OSSL_FUNC_PROVIDER_QUERY_OPERATION 1027242OSSL_CORE_MAKE_FUNC(const OSSL_ALGORITHM *, provider_query_operation,243    (void *provctx, int operation_id, int *no_store))244#define OSSL_FUNC_PROVIDER_UNQUERY_OPERATION 1028245OSSL_CORE_MAKE_FUNC(void, provider_unquery_operation,246    (void *provctx, int operation_id, const OSSL_ALGORITHM *))247#define OSSL_FUNC_PROVIDER_GET_REASON_STRINGS 1029248OSSL_CORE_MAKE_FUNC(const OSSL_ITEM *, provider_get_reason_strings,249    (void *provctx))250#define OSSL_FUNC_PROVIDER_GET_CAPABILITIES 1030251OSSL_CORE_MAKE_FUNC(int, provider_get_capabilities, (void *provctx, const char *capability, OSSL_CALLBACK *cb, void *arg))252#define OSSL_FUNC_PROVIDER_SELF_TEST 1031253OSSL_CORE_MAKE_FUNC(int, provider_self_test, (void *provctx))254#define OSSL_FUNC_PROVIDER_RANDOM_BYTES 1032255OSSL_CORE_MAKE_FUNC(int, provider_random_bytes, (void *provctx, int which, void *buf, size_t n, unsigned int strength))256 257/* Libssl related functions */258#define OSSL_FUNC_SSL_QUIC_TLS_CRYPTO_SEND 2001259OSSL_CORE_MAKE_FUNC(int, SSL_QUIC_TLS_crypto_send,260    (SSL * s, const unsigned char *buf, size_t buf_len,261        size_t *consumed, void *arg))262#define OSSL_FUNC_SSL_QUIC_TLS_CRYPTO_RECV_RCD 2002263OSSL_CORE_MAKE_FUNC(int, SSL_QUIC_TLS_crypto_recv_rcd,264    (SSL * s, const unsigned char **buf, size_t *bytes_read,265        void *arg))266#define OSSL_FUNC_SSL_QUIC_TLS_CRYPTO_RELEASE_RCD 2003267OSSL_CORE_MAKE_FUNC(int, SSL_QUIC_TLS_crypto_release_rcd,268    (SSL * s, size_t bytes_read, void *arg))269#define OSSL_FUNC_SSL_QUIC_TLS_YIELD_SECRET 2004270OSSL_CORE_MAKE_FUNC(int, SSL_QUIC_TLS_yield_secret,271    (SSL * s, uint32_t prot_level, int direction,272        const unsigned char *secret, size_t secret_len, void *arg))273#define OSSL_FUNC_SSL_QUIC_TLS_GOT_TRANSPORT_PARAMS 2005274OSSL_CORE_MAKE_FUNC(int, SSL_QUIC_TLS_got_transport_params,275    (SSL * s, const unsigned char *params, size_t params_len,276        void *arg))277#define OSSL_FUNC_SSL_QUIC_TLS_ALERT 2006278OSSL_CORE_MAKE_FUNC(int, SSL_QUIC_TLS_alert,279    (SSL * s, unsigned char alert_code, void *arg))280 281/* Operations */282 283#define OSSL_OP_DIGEST 1284#define OSSL_OP_CIPHER 2 /* Symmetric Ciphers */285#define OSSL_OP_MAC 3286#define OSSL_OP_KDF 4287#define OSSL_OP_RAND 5288#define OSSL_OP_KEYMGMT 10289#define OSSL_OP_KEYEXCH 11290#define OSSL_OP_SIGNATURE 12291#define OSSL_OP_ASYM_CIPHER 13292#define OSSL_OP_KEM 14293#define OSSL_OP_SKEYMGMT 15294/* New section for non-EVP operations */295#define OSSL_OP_ENCODER 20296#define OSSL_OP_DECODER 21297#define OSSL_OP_STORE 22298/* Highest known operation number */299#define OSSL_OP__HIGHEST 22300 301/* Digests */302 303#define OSSL_FUNC_DIGEST_NEWCTX 1304#define OSSL_FUNC_DIGEST_INIT 2305#define OSSL_FUNC_DIGEST_UPDATE 3306#define OSSL_FUNC_DIGEST_FINAL 4307#define OSSL_FUNC_DIGEST_DIGEST 5308#define OSSL_FUNC_DIGEST_FREECTX 6309#define OSSL_FUNC_DIGEST_DUPCTX 7310#define OSSL_FUNC_DIGEST_GET_PARAMS 8311#define OSSL_FUNC_DIGEST_SET_CTX_PARAMS 9312#define OSSL_FUNC_DIGEST_GET_CTX_PARAMS 10313#define OSSL_FUNC_DIGEST_GETTABLE_PARAMS 11314#define OSSL_FUNC_DIGEST_SETTABLE_CTX_PARAMS 12315#define OSSL_FUNC_DIGEST_GETTABLE_CTX_PARAMS 13316#define OSSL_FUNC_DIGEST_SQUEEZE 14317#define OSSL_FUNC_DIGEST_COPYCTX 15318 319OSSL_CORE_MAKE_FUNC(void *, digest_newctx, (void *provctx))320OSSL_CORE_MAKE_FUNC(int, digest_init, (void *dctx, const OSSL_PARAM params[]))321OSSL_CORE_MAKE_FUNC(int, digest_update,322    (void *dctx, const unsigned char *in, size_t inl))323OSSL_CORE_MAKE_FUNC(int, digest_final,324    (void *dctx,325        unsigned char *out, size_t *outl, size_t outsz))326OSSL_CORE_MAKE_FUNC(int, digest_squeeze,327    (void *dctx,328        unsigned char *out, size_t *outl, size_t outsz))329OSSL_CORE_MAKE_FUNC(int, digest_digest,330    (void *provctx, const unsigned char *in, size_t inl,331        unsigned char *out, size_t *outl, size_t outsz))332 333OSSL_CORE_MAKE_FUNC(void, digest_freectx, (void *dctx))334OSSL_CORE_MAKE_FUNC(void *, digest_dupctx, (void *dctx))335OSSL_CORE_MAKE_FUNC(void, digest_copyctx, (void *outctx, void *inctx))336 337OSSL_CORE_MAKE_FUNC(int, digest_get_params, (OSSL_PARAM params[]))338OSSL_CORE_MAKE_FUNC(int, digest_set_ctx_params,339    (void *vctx, const OSSL_PARAM params[]))340OSSL_CORE_MAKE_FUNC(int, digest_get_ctx_params,341    (void *vctx, OSSL_PARAM params[]))342OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, digest_gettable_params,343    (void *provctx))344OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, digest_settable_ctx_params,345    (void *dctx, void *provctx))346OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, digest_gettable_ctx_params,347    (void *dctx, void *provctx))348 349/* Symmetric Ciphers */350 351#define OSSL_FUNC_CIPHER_NEWCTX 1352#define OSSL_FUNC_CIPHER_ENCRYPT_INIT 2353#define OSSL_FUNC_CIPHER_DECRYPT_INIT 3354#define OSSL_FUNC_CIPHER_UPDATE 4355#define OSSL_FUNC_CIPHER_FINAL 5356#define OSSL_FUNC_CIPHER_CIPHER 6357#define OSSL_FUNC_CIPHER_FREECTX 7358#define OSSL_FUNC_CIPHER_DUPCTX 8359#define OSSL_FUNC_CIPHER_GET_PARAMS 9360#define OSSL_FUNC_CIPHER_GET_CTX_PARAMS 10361#define OSSL_FUNC_CIPHER_SET_CTX_PARAMS 11362#define OSSL_FUNC_CIPHER_GETTABLE_PARAMS 12363#define OSSL_FUNC_CIPHER_GETTABLE_CTX_PARAMS 13364#define OSSL_FUNC_CIPHER_SETTABLE_CTX_PARAMS 14365#define OSSL_FUNC_CIPHER_PIPELINE_ENCRYPT_INIT 15366#define OSSL_FUNC_CIPHER_PIPELINE_DECRYPT_INIT 16367#define OSSL_FUNC_CIPHER_PIPELINE_UPDATE 17368#define OSSL_FUNC_CIPHER_PIPELINE_FINAL 18369#define OSSL_FUNC_CIPHER_ENCRYPT_SKEY_INIT 19370#define OSSL_FUNC_CIPHER_DECRYPT_SKEY_INIT 20371 372OSSL_CORE_MAKE_FUNC(void *, cipher_newctx, (void *provctx))373OSSL_CORE_MAKE_FUNC(int, cipher_encrypt_init, (void *cctx, const unsigned char *key, size_t keylen, const unsigned char *iv, size_t ivlen, const OSSL_PARAM params[]))374OSSL_CORE_MAKE_FUNC(int, cipher_decrypt_init, (void *cctx, const unsigned char *key, size_t keylen, const unsigned char *iv, size_t ivlen, const OSSL_PARAM params[]))375OSSL_CORE_MAKE_FUNC(int, cipher_update,376    (void *cctx,377        unsigned char *out, size_t *outl, size_t outsize,378        const unsigned char *in, size_t inl))379OSSL_CORE_MAKE_FUNC(int, cipher_final,380    (void *cctx,381        unsigned char *out, size_t *outl, size_t outsize))382OSSL_CORE_MAKE_FUNC(int, cipher_cipher,383    (void *cctx,384        unsigned char *out, size_t *outl, size_t outsize,385        const unsigned char *in, size_t inl))386OSSL_CORE_MAKE_FUNC(int, cipher_pipeline_encrypt_init,387    (void *cctx,388        const unsigned char *key, size_t keylen,389        size_t numpipes, const unsigned char **iv, size_t ivlen,390        const OSSL_PARAM params[]))391OSSL_CORE_MAKE_FUNC(int, cipher_pipeline_decrypt_init,392    (void *cctx,393        const unsigned char *key, size_t keylen,394        size_t numpipes, const unsigned char **iv, size_t ivlen,395        const OSSL_PARAM params[]))396OSSL_CORE_MAKE_FUNC(int, cipher_pipeline_update,397    (void *cctx, size_t numpipes,398        unsigned char **out, size_t *outl, const size_t *outsize,399        const unsigned char **in, const size_t *inl))400OSSL_CORE_MAKE_FUNC(int, cipher_pipeline_final,401    (void *cctx, size_t numpipes,402        unsigned char **out, size_t *outl, const size_t *outsize))403OSSL_CORE_MAKE_FUNC(void, cipher_freectx, (void *cctx))404OSSL_CORE_MAKE_FUNC(void *, cipher_dupctx, (void *cctx))405OSSL_CORE_MAKE_FUNC(int, cipher_get_params, (OSSL_PARAM params[]))406OSSL_CORE_MAKE_FUNC(int, cipher_get_ctx_params, (void *cctx, OSSL_PARAM params[]))407OSSL_CORE_MAKE_FUNC(int, cipher_set_ctx_params, (void *cctx, const OSSL_PARAM params[]))408OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, cipher_gettable_params,409    (void *provctx))410OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, cipher_settable_ctx_params,411    (void *cctx, void *provctx))412OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, cipher_gettable_ctx_params,413    (void *cctx, void *provctx))414OSSL_CORE_MAKE_FUNC(int, cipher_encrypt_skey_init, (void *cctx, void *skeydata, const unsigned char *iv, size_t ivlen, const OSSL_PARAM params[]))415OSSL_CORE_MAKE_FUNC(int, cipher_decrypt_skey_init, (void *cctx, void *skeydata, const unsigned char *iv, size_t ivlen, const OSSL_PARAM params[]))416 417/* MACs */418 419#define OSSL_FUNC_MAC_NEWCTX 1420#define OSSL_FUNC_MAC_DUPCTX 2421#define OSSL_FUNC_MAC_FREECTX 3422#define OSSL_FUNC_MAC_INIT 4423#define OSSL_FUNC_MAC_UPDATE 5424#define OSSL_FUNC_MAC_FINAL 6425#define OSSL_FUNC_MAC_GET_PARAMS 7426#define OSSL_FUNC_MAC_GET_CTX_PARAMS 8427#define OSSL_FUNC_MAC_SET_CTX_PARAMS 9428#define OSSL_FUNC_MAC_GETTABLE_PARAMS 10429#define OSSL_FUNC_MAC_GETTABLE_CTX_PARAMS 11430#define OSSL_FUNC_MAC_SETTABLE_CTX_PARAMS 12431#define OSSL_FUNC_MAC_INIT_SKEY 13432 433OSSL_CORE_MAKE_FUNC(void *, mac_newctx, (void *provctx))434OSSL_CORE_MAKE_FUNC(void *, mac_dupctx, (void *src))435OSSL_CORE_MAKE_FUNC(void, mac_freectx, (void *mctx))436OSSL_CORE_MAKE_FUNC(int, mac_init, (void *mctx, const unsigned char *key, size_t keylen, const OSSL_PARAM params[]))437OSSL_CORE_MAKE_FUNC(int, mac_update,438    (void *mctx, const unsigned char *in, size_t inl))439OSSL_CORE_MAKE_FUNC(int, mac_final,440    (void *mctx,441        unsigned char *out, size_t *outl, size_t outsize))442OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, mac_gettable_params, (void *provctx))443OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, mac_gettable_ctx_params,444    (void *mctx, void *provctx))445OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, mac_settable_ctx_params,446    (void *mctx, void *provctx))447OSSL_CORE_MAKE_FUNC(int, mac_get_params, (OSSL_PARAM params[]))448OSSL_CORE_MAKE_FUNC(int, mac_get_ctx_params,449    (void *mctx, OSSL_PARAM params[]))450OSSL_CORE_MAKE_FUNC(int, mac_set_ctx_params,451    (void *mctx, const OSSL_PARAM params[]))452OSSL_CORE_MAKE_FUNC(int, mac_init_skey, (void *mctx, void *key, const OSSL_PARAM params[]))453 454/* KDFs and PRFs */455 456#define OSSL_FUNC_KDF_NEWCTX 1457#define OSSL_FUNC_KDF_DUPCTX 2458#define OSSL_FUNC_KDF_FREECTX 3459#define OSSL_FUNC_KDF_RESET 4460#define OSSL_FUNC_KDF_DERIVE 5461#define OSSL_FUNC_KDF_GETTABLE_PARAMS 6462#define OSSL_FUNC_KDF_GETTABLE_CTX_PARAMS 7463#define OSSL_FUNC_KDF_SETTABLE_CTX_PARAMS 8464#define OSSL_FUNC_KDF_GET_PARAMS 9465#define OSSL_FUNC_KDF_GET_CTX_PARAMS 10466#define OSSL_FUNC_KDF_SET_CTX_PARAMS 11467 468OSSL_CORE_MAKE_FUNC(void *, kdf_newctx, (void *provctx))469OSSL_CORE_MAKE_FUNC(void *, kdf_dupctx, (void *src))470OSSL_CORE_MAKE_FUNC(void, kdf_freectx, (void *kctx))471OSSL_CORE_MAKE_FUNC(void, kdf_reset, (void *kctx))472OSSL_CORE_MAKE_FUNC(int, kdf_derive, (void *kctx, unsigned char *key, size_t keylen, const OSSL_PARAM params[]))473OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, kdf_gettable_params, (void *provctx))474OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, kdf_gettable_ctx_params,475    (void *kctx, void *provctx))476OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, kdf_settable_ctx_params,477    (void *kctx, void *provctx))478OSSL_CORE_MAKE_FUNC(int, kdf_get_params, (OSSL_PARAM params[]))479OSSL_CORE_MAKE_FUNC(int, kdf_get_ctx_params,480    (void *kctx, OSSL_PARAM params[]))481OSSL_CORE_MAKE_FUNC(int, kdf_set_ctx_params,482    (void *kctx, const OSSL_PARAM params[]))483 484/* RAND */485 486#define OSSL_FUNC_RAND_NEWCTX 1487#define OSSL_FUNC_RAND_FREECTX 2488#define OSSL_FUNC_RAND_INSTANTIATE 3489#define OSSL_FUNC_RAND_UNINSTANTIATE 4490#define OSSL_FUNC_RAND_GENERATE 5491#define OSSL_FUNC_RAND_RESEED 6492#define OSSL_FUNC_RAND_NONCE 7493#define OSSL_FUNC_RAND_ENABLE_LOCKING 8494#define OSSL_FUNC_RAND_LOCK 9495#define OSSL_FUNC_RAND_UNLOCK 10496#define OSSL_FUNC_RAND_GETTABLE_PARAMS 11497#define OSSL_FUNC_RAND_GETTABLE_CTX_PARAMS 12498#define OSSL_FUNC_RAND_SETTABLE_CTX_PARAMS 13499#define OSSL_FUNC_RAND_GET_PARAMS 14500#define OSSL_FUNC_RAND_GET_CTX_PARAMS 15501#define OSSL_FUNC_RAND_SET_CTX_PARAMS 16502#define OSSL_FUNC_RAND_VERIFY_ZEROIZATION 17503#define OSSL_FUNC_RAND_GET_SEED 18504#define OSSL_FUNC_RAND_CLEAR_SEED 19505 506OSSL_CORE_MAKE_FUNC(void *, rand_newctx,507    (void *provctx, void *parent,508        const OSSL_DISPATCH *parent_calls))509OSSL_CORE_MAKE_FUNC(void, rand_freectx, (void *vctx))510OSSL_CORE_MAKE_FUNC(int, rand_instantiate,511    (void *vdrbg, unsigned int strength,512        int prediction_resistance,513        const unsigned char *pstr, size_t pstr_len,514        const OSSL_PARAM params[]))515OSSL_CORE_MAKE_FUNC(int, rand_uninstantiate, (void *vdrbg))516OSSL_CORE_MAKE_FUNC(int, rand_generate,517    (void *vctx, unsigned char *out, size_t outlen,518        unsigned int strength, int prediction_resistance,519        const unsigned char *addin, size_t addin_len))520OSSL_CORE_MAKE_FUNC(int, rand_reseed,521    (void *vctx, int prediction_resistance,522        const unsigned char *ent, size_t ent_len,523        const unsigned char *addin, size_t addin_len))524OSSL_CORE_MAKE_FUNC(size_t, rand_nonce,525    (void *vctx, unsigned char *out, unsigned int strength,526        size_t min_noncelen, size_t max_noncelen))527OSSL_CORE_MAKE_FUNC(int, rand_enable_locking, (void *vctx))528OSSL_CORE_MAKE_FUNC(int, rand_lock, (void *vctx))529OSSL_CORE_MAKE_FUNC(void, rand_unlock, (void *vctx))530OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, rand_gettable_params, (void *provctx))531OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, rand_gettable_ctx_params,532    (void *vctx, void *provctx))533OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, rand_settable_ctx_params,534    (void *vctx, void *provctx))535OSSL_CORE_MAKE_FUNC(int, rand_get_params, (OSSL_PARAM params[]))536OSSL_CORE_MAKE_FUNC(int, rand_get_ctx_params,537    (void *vctx, OSSL_PARAM params[]))538OSSL_CORE_MAKE_FUNC(int, rand_set_ctx_params,539    (void *vctx, const OSSL_PARAM params[]))540OSSL_CORE_MAKE_FUNC(void, rand_set_callbacks,541    (void *vctx, OSSL_INOUT_CALLBACK *get_entropy,542        OSSL_CALLBACK *cleanup_entropy,543        OSSL_INOUT_CALLBACK *get_nonce,544        OSSL_CALLBACK *cleanup_nonce, void *arg))545OSSL_CORE_MAKE_FUNC(int, rand_verify_zeroization,546    (void *vctx))547OSSL_CORE_MAKE_FUNC(size_t, rand_get_seed,548    (void *vctx, unsigned char **buffer,549        int entropy, size_t min_len, size_t max_len,550        int prediction_resistance,551        const unsigned char *adin, size_t adin_len))552OSSL_CORE_MAKE_FUNC(void, rand_clear_seed,553    (void *vctx, unsigned char *buffer, size_t b_len))554 555/*-556 * Key management557 *558 * The Key Management takes care of provider side key objects, and includes559 * all current functionality to create them, destroy them, set parameters560 * and key material, etc, essentially everything that manipulates the keys561 * themselves and their parameters.562 *563 * The key objects are commonly referred to as |keydata|, and it MUST be able564 * to contain parameters if the key has any, the public key and the private565 * key.  All parts are optional, but their presence determines what can be566 * done with the key object in terms of encryption, signature, and so on.567 * The assumption from libcrypto is that the key object contains any of the568 * following data combinations:569 *570 * - parameters only571 * - public key only572 * - public key + private key573 * - parameters + public key574 * - parameters + public key + private key575 *576 * What "parameters", "public key" and "private key" means in detail is left577 * to the implementation.  In the case of DH and DSA, they would typically578 * include domain parameters, while for certain variants of RSA, they would579 * typically include PSS or OAEP parameters.580 *581 * Key objects are created with OSSL_FUNC_keymgmt_new() and destroyed with582 * OSSL_FUNC_keymgmt_free().  Key objects can have data filled in with583 * OSSL_FUNC_keymgmt_import().584 *585 * Three functions are made available to check what selection of data is586 * present in a key object: OSSL_FUNC_keymgmt_has_parameters(),587 * OSSL_FUNC_keymgmt_has_public_key(), and OSSL_FUNC_keymgmt_has_private_key(),588 */589 590/* Key data subset selection - individual bits */591#define OSSL_KEYMGMT_SELECT_PRIVATE_KEY 0x01592#define OSSL_KEYMGMT_SELECT_PUBLIC_KEY 0x02593#define OSSL_KEYMGMT_SELECT_DOMAIN_PARAMETERS 0x04594#define OSSL_KEYMGMT_SELECT_OTHER_PARAMETERS 0x80595 596/* Key data subset selection - combinations */597#define OSSL_KEYMGMT_SELECT_ALL_PARAMETERS \598    (OSSL_KEYMGMT_SELECT_DOMAIN_PARAMETERS \599        | OSSL_KEYMGMT_SELECT_OTHER_PARAMETERS)600#define OSSL_KEYMGMT_SELECT_KEYPAIR \601    (OSSL_KEYMGMT_SELECT_PRIVATE_KEY | OSSL_KEYMGMT_SELECT_PUBLIC_KEY)602#define OSSL_KEYMGMT_SELECT_ALL \603    (OSSL_KEYMGMT_SELECT_KEYPAIR | OSSL_KEYMGMT_SELECT_ALL_PARAMETERS)604 605#define OSSL_KEYMGMT_VALIDATE_FULL_CHECK 0606#define OSSL_KEYMGMT_VALIDATE_QUICK_CHECK 1607 608/* Basic key object creation */609#define OSSL_FUNC_KEYMGMT_NEW 1610OSSL_CORE_MAKE_FUNC(void *, keymgmt_new, (void *provctx))611 612/* Generation, a more complex constructor */613#define OSSL_FUNC_KEYMGMT_GEN_INIT 2614#define OSSL_FUNC_KEYMGMT_GEN_SET_TEMPLATE 3615#define OSSL_FUNC_KEYMGMT_GEN_SET_PARAMS 4616#define OSSL_FUNC_KEYMGMT_GEN_SETTABLE_PARAMS 5617#define OSSL_FUNC_KEYMGMT_GEN 6618#define OSSL_FUNC_KEYMGMT_GEN_CLEANUP 7619#define OSSL_FUNC_KEYMGMT_GEN_GET_PARAMS 15620#define OSSL_FUNC_KEYMGMT_GEN_GETTABLE_PARAMS 16621 622OSSL_CORE_MAKE_FUNC(void *, keymgmt_gen_init,623    (void *provctx, int selection, const OSSL_PARAM params[]))624OSSL_CORE_MAKE_FUNC(int, keymgmt_gen_set_template,625    (void *genctx, void *templ))626OSSL_CORE_MAKE_FUNC(int, keymgmt_gen_set_params,627    (void *genctx, const OSSL_PARAM params[]))628OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *,629    keymgmt_gen_settable_params,630    (void *genctx, void *provctx))631OSSL_CORE_MAKE_FUNC(int, keymgmt_gen_get_params,632    (void *genctx, OSSL_PARAM params[]))633OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, keymgmt_gen_gettable_params,634    (void *genctx, void *provctx))635OSSL_CORE_MAKE_FUNC(void *, keymgmt_gen,636    (void *genctx, OSSL_CALLBACK *cb, void *cbarg))637OSSL_CORE_MAKE_FUNC(void, keymgmt_gen_cleanup, (void *genctx))638 639/* Key loading by object reference */640#define OSSL_FUNC_KEYMGMT_LOAD 8641OSSL_CORE_MAKE_FUNC(void *, keymgmt_load,642    (const void *reference, size_t reference_sz))643 644/* Basic key object destruction */645#define OSSL_FUNC_KEYMGMT_FREE 10646OSSL_CORE_MAKE_FUNC(void, keymgmt_free, (void *keydata))647 648/* Key object information, with discovery */649#define OSSL_FUNC_KEYMGMT_GET_PARAMS 11650#define OSSL_FUNC_KEYMGMT_GETTABLE_PARAMS 12651OSSL_CORE_MAKE_FUNC(int, keymgmt_get_params,652    (void *keydata, OSSL_PARAM params[]))653OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, keymgmt_gettable_params,654    (void *provctx))655 656#define OSSL_FUNC_KEYMGMT_SET_PARAMS 13657#define OSSL_FUNC_KEYMGMT_SETTABLE_PARAMS 14658OSSL_CORE_MAKE_FUNC(int, keymgmt_set_params,659    (void *keydata, const OSSL_PARAM params[]))660OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, keymgmt_settable_params,661    (void *provctx))662 663/* Key checks - discovery of supported operations */664#define OSSL_FUNC_KEYMGMT_QUERY_OPERATION_NAME 20665OSSL_CORE_MAKE_FUNC(const char *, keymgmt_query_operation_name,666    (int operation_id))667 668/* Key checks - key data content checks */669#define OSSL_FUNC_KEYMGMT_HAS 21670OSSL_CORE_MAKE_FUNC(int, keymgmt_has, (const void *keydata, int selection))671 672/* Key checks - validation */673#define OSSL_FUNC_KEYMGMT_VALIDATE 22674OSSL_CORE_MAKE_FUNC(int, keymgmt_validate, (const void *keydata, int selection, int checktype))675 676/* Key checks - matching */677#define OSSL_FUNC_KEYMGMT_MATCH 23678OSSL_CORE_MAKE_FUNC(int, keymgmt_match,679    (const void *keydata1, const void *keydata2,680        int selection))681 682/* Import and export functions, with discovery */683#define OSSL_FUNC_KEYMGMT_IMPORT 40684#define OSSL_FUNC_KEYMGMT_IMPORT_TYPES 41685#define OSSL_FUNC_KEYMGMT_EXPORT 42686#define OSSL_FUNC_KEYMGMT_EXPORT_TYPES 43687OSSL_CORE_MAKE_FUNC(int, keymgmt_import,688    (void *keydata, int selection, const OSSL_PARAM params[]))689OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, keymgmt_import_types,690    (int selection))691OSSL_CORE_MAKE_FUNC(int, keymgmt_export,692    (void *keydata, int selection,693        OSSL_CALLBACK *param_cb, void *cbarg))694OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, keymgmt_export_types,695    (int selection))696 697/* Dup function, constructor */698#define OSSL_FUNC_KEYMGMT_DUP 44699OSSL_CORE_MAKE_FUNC(void *, keymgmt_dup,700    (const void *keydata_from, int selection))701 702/* Extended import and export functions */703#define OSSL_FUNC_KEYMGMT_IMPORT_TYPES_EX 45704#define OSSL_FUNC_KEYMGMT_EXPORT_TYPES_EX 46705OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, keymgmt_import_types_ex,706    (void *provctx, int selection))707OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, keymgmt_export_types_ex,708    (void *provctx, int selection))709 710/* Key Exchange */711 712#define OSSL_FUNC_KEYEXCH_NEWCTX 1713#define OSSL_FUNC_KEYEXCH_INIT 2714#define OSSL_FUNC_KEYEXCH_DERIVE 3715#define OSSL_FUNC_KEYEXCH_SET_PEER 4716#define OSSL_FUNC_KEYEXCH_FREECTX 5717#define OSSL_FUNC_KEYEXCH_DUPCTX 6718#define OSSL_FUNC_KEYEXCH_SET_CTX_PARAMS 7719#define OSSL_FUNC_KEYEXCH_SETTABLE_CTX_PARAMS 8720#define OSSL_FUNC_KEYEXCH_GET_CTX_PARAMS 9721#define OSSL_FUNC_KEYEXCH_GETTABLE_CTX_PARAMS 10722 723OSSL_CORE_MAKE_FUNC(void *, keyexch_newctx, (void *provctx))724OSSL_CORE_MAKE_FUNC(int, keyexch_init, (void *ctx, void *provkey, const OSSL_PARAM params[]))725OSSL_CORE_MAKE_FUNC(int, keyexch_derive, (void *ctx, unsigned char *secret, size_t *secretlen, size_t outlen))726OSSL_CORE_MAKE_FUNC(int, keyexch_set_peer, (void *ctx, void *provkey))727OSSL_CORE_MAKE_FUNC(void, keyexch_freectx, (void *ctx))728OSSL_CORE_MAKE_FUNC(void *, keyexch_dupctx, (void *ctx))729OSSL_CORE_MAKE_FUNC(int, keyexch_set_ctx_params, (void *ctx, const OSSL_PARAM params[]))730OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, keyexch_settable_ctx_params,731    (void *ctx, void *provctx))732OSSL_CORE_MAKE_FUNC(int, keyexch_get_ctx_params, (void *ctx, OSSL_PARAM params[]))733OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, keyexch_gettable_ctx_params,734    (void *ctx, void *provctx))735 736/* Signature */737 738#define OSSL_FUNC_SIGNATURE_NEWCTX 1739#define OSSL_FUNC_SIGNATURE_SIGN_INIT 2740#define OSSL_FUNC_SIGNATURE_SIGN 3741#define OSSL_FUNC_SIGNATURE_VERIFY_INIT 4742#define OSSL_FUNC_SIGNATURE_VERIFY 5743#define OSSL_FUNC_SIGNATURE_VERIFY_RECOVER_INIT 6744#define OSSL_FUNC_SIGNATURE_VERIFY_RECOVER 7745#define OSSL_FUNC_SIGNATURE_DIGEST_SIGN_INIT 8746#define OSSL_FUNC_SIGNATURE_DIGEST_SIGN_UPDATE 9747#define OSSL_FUNC_SIGNATURE_DIGEST_SIGN_FINAL 10748#define OSSL_FUNC_SIGNATURE_DIGEST_SIGN 11749#define OSSL_FUNC_SIGNATURE_DIGEST_VERIFY_INIT 12750#define OSSL_FUNC_SIGNATURE_DIGEST_VERIFY_UPDATE 13751#define OSSL_FUNC_SIGNATURE_DIGEST_VERIFY_FINAL 14752#define OSSL_FUNC_SIGNATURE_DIGEST_VERIFY 15753#define OSSL_FUNC_SIGNATURE_FREECTX 16754#define OSSL_FUNC_SIGNATURE_DUPCTX 17755#define OSSL_FUNC_SIGNATURE_GET_CTX_PARAMS 18756#define OSSL_FUNC_SIGNATURE_GETTABLE_CTX_PARAMS 19757#define OSSL_FUNC_SIGNATURE_SET_CTX_PARAMS 20758#define OSSL_FUNC_SIGNATURE_SETTABLE_CTX_PARAMS 21759#define OSSL_FUNC_SIGNATURE_GET_CTX_MD_PARAMS 22760#define OSSL_FUNC_SIGNATURE_GETTABLE_CTX_MD_PARAMS 23761#define OSSL_FUNC_SIGNATURE_SET_CTX_MD_PARAMS 24762#define OSSL_FUNC_SIGNATURE_SETTABLE_CTX_MD_PARAMS 25763#define OSSL_FUNC_SIGNATURE_QUERY_KEY_TYPES 26764#define OSSL_FUNC_SIGNATURE_SIGN_MESSAGE_INIT 27765#define OSSL_FUNC_SIGNATURE_SIGN_MESSAGE_UPDATE 28766#define OSSL_FUNC_SIGNATURE_SIGN_MESSAGE_FINAL 29767#define OSSL_FUNC_SIGNATURE_VERIFY_MESSAGE_INIT 30768#define OSSL_FUNC_SIGNATURE_VERIFY_MESSAGE_UPDATE 31769#define OSSL_FUNC_SIGNATURE_VERIFY_MESSAGE_FINAL 32770 771OSSL_CORE_MAKE_FUNC(void *, signature_newctx, (void *provctx, const char *propq))772OSSL_CORE_MAKE_FUNC(int, signature_sign_init, (void *ctx, void *provkey, const OSSL_PARAM params[]))773OSSL_CORE_MAKE_FUNC(int, signature_sign, (void *ctx, unsigned char *sig, size_t *siglen, size_t sigsize, const unsigned char *tbs, size_t tbslen))774OSSL_CORE_MAKE_FUNC(int, signature_sign_message_init,775    (void *ctx, void *provkey, const OSSL_PARAM params[]))776OSSL_CORE_MAKE_FUNC(int, signature_sign_message_update,777    (void *ctx, const unsigned char *in, size_t inlen))778OSSL_CORE_MAKE_FUNC(int, signature_sign_message_final,779    (void *ctx, unsigned char *sig,780        size_t *siglen, size_t sigsize))781OSSL_CORE_MAKE_FUNC(int, signature_verify_init, (void *ctx, void *provkey, const OSSL_PARAM params[]))782OSSL_CORE_MAKE_FUNC(int, signature_verify, (void *ctx, const unsigned char *sig, size_t siglen, const unsigned char *tbs, size_t tbslen))783OSSL_CORE_MAKE_FUNC(int, signature_verify_message_init,784    (void *ctx, void *provkey, const OSSL_PARAM params[]))785OSSL_CORE_MAKE_FUNC(int, signature_verify_message_update,786    (void *ctx, const unsigned char *in, size_t inlen))787/*788 * signature_verify_final requires that the signature to be verified against789 * is specified via an OSSL_PARAM.790 */791OSSL_CORE_MAKE_FUNC(int, signature_verify_message_final, (void *ctx))792OSSL_CORE_MAKE_FUNC(int, signature_verify_recover_init,793    (void *ctx, void *provkey, const OSSL_PARAM params[]))794OSSL_CORE_MAKE_FUNC(int, signature_verify_recover,795    (void *ctx, unsigned char *rout, size_t *routlen,796        size_t routsize, const unsigned char *sig, size_t siglen))797OSSL_CORE_MAKE_FUNC(int, signature_digest_sign_init,798    (void *ctx, const char *mdname, void *provkey,799        const OSSL_PARAM params[]))800OSSL_CORE_MAKE_FUNC(int, signature_digest_sign_update,801    (void *ctx, const unsigned char *data, size_t datalen))802OSSL_CORE_MAKE_FUNC(int, signature_digest_sign_final,803    (void *ctx, unsigned char *sig, size_t *siglen,804        size_t sigsize))805OSSL_CORE_MAKE_FUNC(int, signature_digest_sign,806    (void *ctx, unsigned char *sigret, size_t *siglen,807        size_t sigsize, const unsigned char *tbs, size_t tbslen))808OSSL_CORE_MAKE_FUNC(int, signature_digest_verify_init,809    (void *ctx, const char *mdname, void *provkey,810        const OSSL_PARAM params[]))811OSSL_CORE_MAKE_FUNC(int, signature_digest_verify_update,812    (void *ctx, const unsigned char *data, size_t datalen))813OSSL_CORE_MAKE_FUNC(int, signature_digest_verify_final,814    (void *ctx, const unsigned char *sig, size_t siglen))815OSSL_CORE_MAKE_FUNC(int, signature_digest_verify,816    (void *ctx, const unsigned char *sig, size_t siglen,817        const unsigned char *tbs, size_t tbslen))818OSSL_CORE_MAKE_FUNC(void, signature_freectx, (void *ctx))819OSSL_CORE_MAKE_FUNC(void *, signature_dupctx, (void *ctx))820OSSL_CORE_MAKE_FUNC(int, signature_get_ctx_params,821    (void *ctx, OSSL_PARAM params[]))822OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, signature_gettable_ctx_params,823    (void *ctx, void *provctx))824OSSL_CORE_MAKE_FUNC(int, signature_set_ctx_params,825    (void *ctx, const OSSL_PARAM params[]))826OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, signature_settable_ctx_params,827    (void *ctx, void *provctx))828OSSL_CORE_MAKE_FUNC(int, signature_get_ctx_md_params,829    (void *ctx, OSSL_PARAM params[]))830OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, signature_gettable_ctx_md_params,831    (void *ctx))832OSSL_CORE_MAKE_FUNC(int, signature_set_ctx_md_params,833    (void *ctx, const OSSL_PARAM params[]))834OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, signature_settable_ctx_md_params,835    (void *ctx))836OSSL_CORE_MAKE_FUNC(const char **, signature_query_key_types, (void))837 838/*-839 * Symmetric key management840 *841 * The Key Management takes care of provider side of symmetric key objects, and842 * includes essentially everything that manipulates the keys  themselves and843 * their parameters.844 *845 * The key objects are commonly referred to as |keydata|, and it MUST be able846 * to contain parameters if the key has any, and the secret key.847 *848 * Key objects are created with OSSL_FUNC_skeymgmt_import() (there is no849 * dedicated memory allocation function), exported with850 * OSSL_FUNC_skeymgmt_export() and destroyed with OSSL_FUNC_keymgmt_free().851 *852 */853 854/* Key data subset selection - individual bits */855#define OSSL_SKEYMGMT_SELECT_PARAMETERS 0x01856#define OSSL_SKEYMGMT_SELECT_SECRET_KEY 0x02857 858/* Key data subset selection - combinations */859#define OSSL_SKEYMGMT_SELECT_ALL \860    (OSSL_SKEYMGMT_SELECT_PARAMETERS | OSSL_SKEYMGMT_SELECT_SECRET_KEY)861 862#define OSSL_FUNC_SKEYMGMT_FREE 1863#define OSSL_FUNC_SKEYMGMT_IMPORT 2864#define OSSL_FUNC_SKEYMGMT_EXPORT 3865#define OSSL_FUNC_SKEYMGMT_GENERATE 4866#define OSSL_FUNC_SKEYMGMT_GET_KEY_ID 5867#define OSSL_FUNC_SKEYMGMT_IMP_SETTABLE_PARAMS 6868#define OSSL_FUNC_SKEYMGMT_GEN_SETTABLE_PARAMS 7869 870OSSL_CORE_MAKE_FUNC(void, skeymgmt_free, (void *keydata))871OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *,872    skeymgmt_imp_settable_params, (void *provctx))873OSSL_CORE_MAKE_FUNC(void *, skeymgmt_import, (void *provctx, int selection, const OSSL_PARAM params[]))874OSSL_CORE_MAKE_FUNC(int, skeymgmt_export,875    (void *keydata, int selection,876        OSSL_CALLBACK *param_cb, void *cbarg))877OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *,878    skeymgmt_gen_settable_params, (void *provctx))879OSSL_CORE_MAKE_FUNC(void *, skeymgmt_generate, (void *provctx, const OSSL_PARAM params[]))880OSSL_CORE_MAKE_FUNC(const char *, skeymgmt_get_key_id, (void *keydata))881 882/* Asymmetric Ciphers */883 884#define OSSL_FUNC_ASYM_CIPHER_NEWCTX 1885#define OSSL_FUNC_ASYM_CIPHER_ENCRYPT_INIT 2886#define OSSL_FUNC_ASYM_CIPHER_ENCRYPT 3887#define OSSL_FUNC_ASYM_CIPHER_DECRYPT_INIT 4888#define OSSL_FUNC_ASYM_CIPHER_DECRYPT 5889#define OSSL_FUNC_ASYM_CIPHER_FREECTX 6890#define OSSL_FUNC_ASYM_CIPHER_DUPCTX 7891#define OSSL_FUNC_ASYM_CIPHER_GET_CTX_PARAMS 8892#define OSSL_FUNC_ASYM_CIPHER_GETTABLE_CTX_PARAMS 9893#define OSSL_FUNC_ASYM_CIPHER_SET_CTX_PARAMS 10894#define OSSL_FUNC_ASYM_CIPHER_SETTABLE_CTX_PARAMS 11895 896OSSL_CORE_MAKE_FUNC(void *, asym_cipher_newctx, (void *provctx))897OSSL_CORE_MAKE_FUNC(int, asym_cipher_encrypt_init, (void *ctx, void *provkey, const OSSL_PARAM params[]))898OSSL_CORE_MAKE_FUNC(int, asym_cipher_encrypt, (void *ctx, unsigned char *out, size_t *outlen, size_t outsize, const unsigned char *in, size_t inlen))899OSSL_CORE_MAKE_FUNC(int, asym_cipher_decrypt_init, (void *ctx, void *provkey, const OSSL_PARAM params[]))900OSSL_CORE_MAKE_FUNC(int, asym_cipher_decrypt, (void *ctx, unsigned char *out, size_t *outlen, size_t outsize, const unsigned char *in, size_t inlen))901OSSL_CORE_MAKE_FUNC(void, asym_cipher_freectx, (void *ctx))902OSSL_CORE_MAKE_FUNC(void *, asym_cipher_dupctx, (void *ctx))903OSSL_CORE_MAKE_FUNC(int, asym_cipher_get_ctx_params,904    (void *ctx, OSSL_PARAM params[]))905OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, asym_cipher_gettable_ctx_params,906    (void *ctx, void *provctx))907OSSL_CORE_MAKE_FUNC(int, asym_cipher_set_ctx_params,908    (void *ctx, const OSSL_PARAM params[]))909OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, asym_cipher_settable_ctx_params,910    (void *ctx, void *provctx))911 912/* Asymmetric Key encapsulation */913#define OSSL_FUNC_KEM_NEWCTX 1914#define OSSL_FUNC_KEM_ENCAPSULATE_INIT 2915#define OSSL_FUNC_KEM_ENCAPSULATE 3916#define OSSL_FUNC_KEM_DECAPSULATE_INIT 4917#define OSSL_FUNC_KEM_DECAPSULATE 5918#define OSSL_FUNC_KEM_FREECTX 6919#define OSSL_FUNC_KEM_DUPCTX 7920#define OSSL_FUNC_KEM_GET_CTX_PARAMS 8921#define OSSL_FUNC_KEM_GETTABLE_CTX_PARAMS 9922#define OSSL_FUNC_KEM_SET_CTX_PARAMS 10923#define OSSL_FUNC_KEM_SETTABLE_CTX_PARAMS 11924#define OSSL_FUNC_KEM_AUTH_ENCAPSULATE_INIT 12925#define OSSL_FUNC_KEM_AUTH_DECAPSULATE_INIT 13926 927OSSL_CORE_MAKE_FUNC(void *, kem_newctx, (void *provctx))928OSSL_CORE_MAKE_FUNC(int, kem_encapsulate_init, (void *ctx, void *provkey, const OSSL_PARAM params[]))929OSSL_CORE_MAKE_FUNC(int, kem_auth_encapsulate_init, (void *ctx, void *provkey, void *authprivkey, const OSSL_PARAM params[]))930OSSL_CORE_MAKE_FUNC(int, kem_encapsulate, (void *ctx, unsigned char *out, size_t *outlen, unsigned char *secret, size_t *secretlen))931OSSL_CORE_MAKE_FUNC(int, kem_decapsulate_init, (void *ctx, void *provkey, const OSSL_PARAM params[]))932OSSL_CORE_MAKE_FUNC(int, kem_auth_decapsulate_init, (void *ctx, void *provkey, void *authpubkey, const OSSL_PARAM params[]))933OSSL_CORE_MAKE_FUNC(int, kem_decapsulate, (void *ctx, unsigned char *out, size_t *outlen, const unsigned char *in, size_t inlen))934OSSL_CORE_MAKE_FUNC(void, kem_freectx, (void *ctx))935OSSL_CORE_MAKE_FUNC(void *, kem_dupctx, (void *ctx))936OSSL_CORE_MAKE_FUNC(int, kem_get_ctx_params, (void *ctx, OSSL_PARAM params[]))937OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, kem_gettable_ctx_params,938    (void *ctx, void *provctx))939OSSL_CORE_MAKE_FUNC(int, kem_set_ctx_params,940    (void *ctx, const OSSL_PARAM params[]))941OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, kem_settable_ctx_params,942    (void *ctx, void *provctx))943 944/* Encoders and decoders */945#define OSSL_FUNC_ENCODER_NEWCTX 1946#define OSSL_FUNC_ENCODER_FREECTX 2947#define OSSL_FUNC_ENCODER_GET_PARAMS 3948#define OSSL_FUNC_ENCODER_GETTABLE_PARAMS 4949#define OSSL_FUNC_ENCODER_SET_CTX_PARAMS 5950#define OSSL_FUNC_ENCODER_SETTABLE_CTX_PARAMS 6951#define OSSL_FUNC_ENCODER_DOES_SELECTION 10952#define OSSL_FUNC_ENCODER_ENCODE 11953#define OSSL_FUNC_ENCODER_IMPORT_OBJECT 20954#define OSSL_FUNC_ENCODER_FREE_OBJECT 21955OSSL_CORE_MAKE_FUNC(void *, encoder_newctx, (void *provctx))956OSSL_CORE_MAKE_FUNC(void, encoder_freectx, (void *ctx))957OSSL_CORE_MAKE_FUNC(int, encoder_get_params, (OSSL_PARAM params[]))958OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, encoder_gettable_params,959    (void *provctx))960OSSL_CORE_MAKE_FUNC(int, encoder_set_ctx_params,961    (void *ctx, const OSSL_PARAM params[]))962OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, encoder_settable_ctx_params,963    (void *provctx))964 965OSSL_CORE_MAKE_FUNC(int, encoder_does_selection,966    (void *provctx, int selection))967OSSL_CORE_MAKE_FUNC(int, encoder_encode,968    (void *ctx, OSSL_CORE_BIO *out,969        const void *obj_raw, const OSSL_PARAM obj_abstract[],970        int selection,971        OSSL_PASSPHRASE_CALLBACK *cb, void *cbarg))972 973OSSL_CORE_MAKE_FUNC(void *, encoder_import_object,974    (void *ctx, int selection, const OSSL_PARAM params[]))975OSSL_CORE_MAKE_FUNC(void, encoder_free_object, (void *obj))976 977#define OSSL_FUNC_DECODER_NEWCTX 1978#define OSSL_FUNC_DECODER_FREECTX 2979#define OSSL_FUNC_DECODER_GET_PARAMS 3980#define OSSL_FUNC_DECODER_GETTABLE_PARAMS 4981#define OSSL_FUNC_DECODER_SET_CTX_PARAMS 5982#define OSSL_FUNC_DECODER_SETTABLE_CTX_PARAMS 6983#define OSSL_FUNC_DECODER_DOES_SELECTION 10984#define OSSL_FUNC_DECODER_DECODE 11985#define OSSL_FUNC_DECODER_EXPORT_OBJECT 20986OSSL_CORE_MAKE_FUNC(void *, decoder_newctx, (void *provctx))987OSSL_CORE_MAKE_FUNC(void, decoder_freectx, (void *ctx))988OSSL_CORE_MAKE_FUNC(int, decoder_get_params, (OSSL_PARAM params[]))989OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, decoder_gettable_params,990    (void *provctx))991OSSL_CORE_MAKE_FUNC(int, decoder_set_ctx_params,992    (void *ctx, const OSSL_PARAM params[]))993OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, decoder_settable_ctx_params,994    (void *provctx))995 996OSSL_CORE_MAKE_FUNC(int, decoder_does_selection,997    (void *provctx, int selection))998OSSL_CORE_MAKE_FUNC(int, decoder_decode,999    (void *ctx, OSSL_CORE_BIO *in, int selection,1000        OSSL_CALLBACK *data_cb, void *data_cbarg,1001        OSSL_PASSPHRASE_CALLBACK *pw_cb, void *pw_cbarg))1002OSSL_CORE_MAKE_FUNC(int, decoder_export_object,1003    (void *ctx, const void *objref, size_t objref_sz,1004        OSSL_CALLBACK *export_cb, void *export_cbarg))1005 1006/*-1007 * Store1008 *1009 * Objects are scanned by using the 'open', 'load', 'eof' and 'close'1010 * functions, which implement an OSSL_STORE loader.1011 *1012 * store_load() works in a way that's very similar to the decoders, in1013 * that they pass an abstract object through a callback, either as a DER1014 * octet string or as an object reference, which libcrypto will have to1015 * deal with.1016 */1017 1018#define OSSL_FUNC_STORE_OPEN 11019#define OSSL_FUNC_STORE_ATTACH 21020#define OSSL_FUNC_STORE_SETTABLE_CTX_PARAMS 31021#define OSSL_FUNC_STORE_SET_CTX_PARAMS 41022#define OSSL_FUNC_STORE_LOAD 51023#define OSSL_FUNC_STORE_EOF 61024#define OSSL_FUNC_STORE_CLOSE 71025#define OSSL_FUNC_STORE_EXPORT_OBJECT 81026#define OSSL_FUNC_STORE_DELETE 91027#define OSSL_FUNC_STORE_OPEN_EX 101028OSSL_CORE_MAKE_FUNC(void *, store_open, (void *provctx, const char *uri))1029OSSL_CORE_MAKE_FUNC(void *, store_attach, (void *provctx, OSSL_CORE_BIO *in))1030OSSL_CORE_MAKE_FUNC(const OSSL_PARAM *, store_settable_ctx_params,1031    (void *provctx))1032OSSL_CORE_MAKE_FUNC(int, store_set_ctx_params,1033    (void *loaderctx, const OSSL_PARAM params[]))1034OSSL_CORE_MAKE_FUNC(int, store_load,1035    (void *loaderctx,1036        OSSL_CALLBACK *object_cb, void *object_cbarg,1037        OSSL_PASSPHRASE_CALLBACK *pw_cb, void *pw_cbarg))1038OSSL_CORE_MAKE_FUNC(int, store_eof, (void *loaderctx))1039OSSL_CORE_MAKE_FUNC(int, store_close, (void *loaderctx))1040OSSL_CORE_MAKE_FUNC(int, store_export_object,1041    (void *loaderctx, const void *objref, size_t objref_sz,1042        OSSL_CALLBACK *export_cb, void *export_cbarg))1043OSSL_CORE_MAKE_FUNC(int, store_delete,1044    (void *provctx, const char *uri, const OSSL_PARAM params[],1045        OSSL_PASSPHRASE_CALLBACK *pw_cb, void *pw_cbarg))1046OSSL_CORE_MAKE_FUNC(void *, store_open_ex,1047    (void *provctx, const char *uri, const OSSL_PARAM params[],1048        OSSL_PASSPHRASE_CALLBACK *pw_cb, void *pw_cbarg))1049 1050#ifdef __cplusplus1051}1052#endif1053 1054#endif1055