2 * Copyright 1995-2021 The OpenSSL Project Authors. All Rights Reserved.
4 * Licensed under the Apache License 2.0 (the "License"). You may not use
5 * this file except in compliance with the License. You can obtain a copy
6 * in the file LICENSE in the source distribution or at
7 * https://www.openssl.org/source/license.html
10 /* We need to use some engine deprecated APIs */
11 #define OPENSSL_SUPPRESS_DEPRECATED
14 #include <openssl/objects.h>
15 #include <openssl/evp.h>
16 #include <openssl/ec.h>
17 #include <openssl/engine.h>
18 #include <openssl/params.h>
19 #include <openssl/core_names.h>
20 #include "internal/cryptlib.h"
21 #include "crypto/evp.h"
22 #include "internal/provider.h"
23 #include "evp_local.h"
26 void evp_md_ctx_clear_digest(EVP_MD_CTX *ctx, int force)
28 if (ctx->provctx != NULL) {
29 if (ctx->digest != NULL && ctx->digest->freectx != NULL)
30 ctx->digest->freectx(ctx->provctx);
32 EVP_MD_CTX_set_flags(ctx, EVP_MD_CTX_FLAG_CLEANED);
35 /* TODO(3.0): Remove legacy code below */
38 * Don't assume ctx->md_data was cleaned in EVP_Digest_Final, because
39 * sometimes only copies of the context are ever finalised.
41 if (ctx->digest && ctx->digest->cleanup
42 && !EVP_MD_CTX_test_flags(ctx, EVP_MD_CTX_FLAG_CLEANED))
43 ctx->digest->cleanup(ctx);
44 if (ctx->digest && ctx->digest->ctx_size && ctx->md_data
45 && (!EVP_MD_CTX_test_flags(ctx, EVP_MD_CTX_FLAG_REUSE) || force))
46 OPENSSL_clear_free(ctx->md_data, ctx->digest->ctx_size);
50 #if !defined(FIPS_MODULE) && !defined(OPENSSL_NO_ENGINE)
51 ENGINE_finish(ctx->engine);
55 /* Non legacy code, this has to be later than the ctx->digest cleaning */
56 EVP_MD_free(ctx->fetched_digest);
57 ctx->fetched_digest = NULL;
58 ctx->reqdigest = NULL;
61 /* This call frees resources associated with the context */
62 int EVP_MD_CTX_reset(EVP_MD_CTX *ctx)
68 /* TODO(3.0): Temporarily no support for EVP_DigestSign* in FIPS module */
70 * pctx should be freed by the user of EVP_MD_CTX
71 * if EVP_MD_CTX_FLAG_KEEP_PKEY_CTX is set
73 if (!EVP_MD_CTX_test_flags(ctx, EVP_MD_CTX_FLAG_KEEP_PKEY_CTX)) {
74 EVP_PKEY_CTX_free(ctx->pctx);
79 evp_md_ctx_clear_digest(ctx, 0);
80 OPENSSL_cleanse(ctx, sizeof(*ctx));
86 EVP_MD_CTX *evp_md_ctx_new_ex(EVP_PKEY *pkey, const ASN1_OCTET_STRING *id,
87 OSSL_LIB_CTX *libctx, const char *propq)
90 EVP_PKEY_CTX *pctx = NULL;
92 if ((ctx = EVP_MD_CTX_new()) == NULL
93 || (pctx = EVP_PKEY_CTX_new_from_pkey(libctx, pkey, propq)) == NULL) {
94 ERR_raise(ERR_LIB_ASN1, ERR_R_MALLOC_FAILURE);
98 if (id != NULL && EVP_PKEY_CTX_set1_id(pctx, id->data, id->length) <= 0)
101 EVP_MD_CTX_set_pkey_ctx(ctx, pctx);
105 EVP_PKEY_CTX_free(pctx);
106 EVP_MD_CTX_free(ctx);
111 EVP_MD_CTX *EVP_MD_CTX_new(void)
113 return OPENSSL_zalloc(sizeof(EVP_MD_CTX));
116 void EVP_MD_CTX_free(EVP_MD_CTX *ctx)
121 EVP_MD_CTX_reset(ctx);
127 int EVP_DigestInit(EVP_MD_CTX *ctx, const EVP_MD *type)
129 EVP_MD_CTX_reset(ctx);
130 return EVP_DigestInit_ex(ctx, type, NULL);
133 int EVP_DigestInit_ex(EVP_MD_CTX *ctx, const EVP_MD *type, ENGINE *impl)
135 #if !defined(OPENSSL_NO_ENGINE) && !defined(FIPS_MODULE)
136 ENGINE *tmpimpl = NULL;
139 #if !defined(FIPS_MODULE)
140 if (ctx->pctx != NULL
141 && EVP_PKEY_CTX_IS_SIGNATURE_OP(ctx->pctx)
142 && ctx->pctx->op.sig.sigprovctx != NULL) {
144 * Prior to OpenSSL 3.0 calling EVP_DigestInit_ex() on an mdctx
145 * previously initialised with EVP_DigestSignInit() would retain
146 * information about the key, and re-initialise for another sign
147 * operation. So in that case we redirect to EVP_DigestSignInit()
149 if (ctx->pctx->operation == EVP_PKEY_OP_SIGNCTX)
150 return EVP_DigestSignInit(ctx, NULL, type, impl, NULL);
151 if (ctx->pctx->operation == EVP_PKEY_OP_VERIFYCTX)
152 return EVP_DigestVerifyInit(ctx, NULL, type, impl, NULL);
153 ERR_raise(ERR_LIB_EVP, EVP_R_UPDATE_ERROR);
158 EVP_MD_CTX_clear_flags(ctx, EVP_MD_CTX_FLAG_CLEANED);
160 if (ctx->provctx != NULL) {
161 if (!ossl_assert(ctx->digest != NULL)) {
162 ERR_raise(ERR_LIB_EVP, EVP_R_INITIALIZATION_ERROR);
165 if (ctx->digest->freectx != NULL)
166 ctx->digest->freectx(ctx->provctx);
171 ctx->reqdigest = type;
173 if (ctx->digest == NULL) {
174 ERR_raise(ERR_LIB_EVP, EVP_R_NO_DIGEST_SET);
180 /* TODO(3.0): Legacy work around code below. Remove this */
181 #if !defined(OPENSSL_NO_ENGINE) && !defined(FIPS_MODULE)
183 * Whether it's nice or not, "Inits" can be used on "Final"'d contexts so
184 * this context may already have an ENGINE! Try to avoid releasing the
185 * previous handle, re-querying for an ENGINE, and having a
186 * reinitialisation, when it may all be unnecessary.
188 if (ctx->engine && ctx->digest &&
189 (type == NULL || (type->type == ctx->digest->type)))
194 * Ensure an ENGINE left lying around from last time is cleared (the
195 * previous check attempted to avoid this if the same ENGINE and
196 * EVP_MD could be used).
198 ENGINE_finish(ctx->engine);
202 if (type != NULL && impl == NULL)
203 tmpimpl = ENGINE_get_digest_engine(type->type);
207 * If there are engines involved or EVP_MD_CTX_FLAG_NO_INIT is set then we
208 * should use legacy handling for now.
210 if (ctx->engine != NULL
212 #if !defined(OPENSSL_NO_ENGINE) && !defined(FIPS_MODULE)
215 || (ctx->flags & EVP_MD_CTX_FLAG_NO_INIT) != 0) {
216 if (ctx->digest == ctx->fetched_digest)
218 EVP_MD_free(ctx->fetched_digest);
219 ctx->fetched_digest = NULL;
223 if (ctx->digest != NULL && ctx->digest->ctx_size > 0) {
224 OPENSSL_clear_free(ctx->md_data, ctx->digest->ctx_size);
228 /* TODO(3.0): Start of non-legacy code below */
230 if (type->prov == NULL) {
232 /* We only do explicit fetches inside the FIPS module */
233 ERR_raise(ERR_LIB_EVP, EVP_R_INITIALIZATION_ERROR);
236 EVP_MD *provmd = EVP_MD_fetch(NULL, OBJ_nid2sn(type->type), "");
238 if (provmd == NULL) {
239 ERR_raise(ERR_LIB_EVP, EVP_R_INITIALIZATION_ERROR);
243 EVP_MD_free(ctx->fetched_digest);
244 ctx->fetched_digest = provmd;
248 if (ctx->provctx != NULL && ctx->digest != NULL && ctx->digest != type) {
249 if (ctx->digest->freectx != NULL)
250 ctx->digest->freectx(ctx->provctx);
253 if (type->prov != NULL && ctx->fetched_digest != type) {
254 if (!EVP_MD_up_ref((EVP_MD *)type)) {
255 ERR_raise(ERR_LIB_EVP, EVP_R_INITIALIZATION_ERROR);
258 EVP_MD_free(ctx->fetched_digest);
259 ctx->fetched_digest = (EVP_MD *)type;
262 if (ctx->provctx == NULL) {
263 ctx->provctx = ctx->digest->newctx(ossl_provider_ctx(type->prov));
264 if (ctx->provctx == NULL) {
265 ERR_raise(ERR_LIB_EVP, EVP_R_INITIALIZATION_ERROR);
270 if (ctx->digest->dinit == NULL) {
271 ERR_raise(ERR_LIB_EVP, EVP_R_INITIALIZATION_ERROR);
275 return ctx->digest->dinit(ctx->provctx);
277 /* TODO(3.0): Remove legacy code below */
280 #if !defined(OPENSSL_NO_ENGINE) && !defined(FIPS_MODULE)
283 if (!ENGINE_init(impl)) {
284 ERR_raise(ERR_LIB_EVP, EVP_R_INITIALIZATION_ERROR);
288 /* Ask if an ENGINE is reserved for this job */
292 /* There's an ENGINE for this job ... (apparently) */
293 const EVP_MD *d = ENGINE_get_digest(impl, type->type);
296 ERR_raise(ERR_LIB_EVP, EVP_R_INITIALIZATION_ERROR);
300 /* We'll use the ENGINE's private digest definition */
303 * Store the ENGINE functional reference so we know 'type' came
304 * from an ENGINE and we need to release it when done.
311 if (ctx->digest != type) {
312 if (ctx->digest && ctx->digest->ctx_size) {
313 OPENSSL_clear_free(ctx->md_data, ctx->digest->ctx_size);
317 if (!(ctx->flags & EVP_MD_CTX_FLAG_NO_INIT) && type->ctx_size) {
318 ctx->update = type->update;
319 ctx->md_data = OPENSSL_zalloc(type->ctx_size);
320 if (ctx->md_data == NULL) {
321 ERR_raise(ERR_LIB_EVP, ERR_R_MALLOC_FAILURE);
326 #if !defined(OPENSSL_NO_ENGINE) && !defined(FIPS_MODULE)
331 * TODO(3.0): Temporarily no support for EVP_DigestSign* inside FIPS module
332 * or when using providers.
334 if (ctx->pctx != NULL
335 && (!EVP_PKEY_CTX_IS_SIGNATURE_OP(ctx->pctx)
336 || ctx->pctx->op.sig.signature == NULL)) {
338 r = EVP_PKEY_CTX_ctrl(ctx->pctx, -1, EVP_PKEY_OP_TYPE_SIG,
339 EVP_PKEY_CTRL_DIGESTINIT, 0, ctx);
340 if (r <= 0 && (r != -2))
344 if (ctx->flags & EVP_MD_CTX_FLAG_NO_INIT)
346 return ctx->digest->init(ctx);
349 int EVP_DigestUpdate(EVP_MD_CTX *ctx, const void *data, size_t count)
354 if (ctx->pctx != NULL
355 && EVP_PKEY_CTX_IS_SIGNATURE_OP(ctx->pctx)
356 && ctx->pctx->op.sig.sigprovctx != NULL) {
358 * Prior to OpenSSL 3.0 EVP_DigestSignUpdate() and
359 * EVP_DigestVerifyUpdate() were just macros for EVP_DigestUpdate().
360 * Some code calls EVP_DigestUpdate() directly even when initialised
361 * with EVP_DigestSignInit_ex() or
362 * EVP_DigestVerifyInit_ex(), so we detect that and redirect to
363 * the correct EVP_Digest*Update() function
365 if (ctx->pctx->operation == EVP_PKEY_OP_SIGNCTX)
366 return EVP_DigestSignUpdate(ctx, data, count);
367 if (ctx->pctx->operation == EVP_PKEY_OP_VERIFYCTX)
368 return EVP_DigestVerifyUpdate(ctx, data, count);
369 ERR_raise(ERR_LIB_EVP, EVP_R_UPDATE_ERROR);
373 if (ctx->digest == NULL
374 || ctx->digest->prov == NULL
375 || (ctx->flags & EVP_MD_CTX_FLAG_NO_INIT) != 0)
378 if (ctx->digest->dupdate == NULL) {
379 ERR_raise(ERR_LIB_EVP, EVP_R_UPDATE_ERROR);
382 return ctx->digest->dupdate(ctx->provctx, data, count);
384 /* TODO(3.0): Remove legacy code below */
386 return ctx->update(ctx, data, count);
389 /* The caller can assume that this removes any secret data from the context */
390 int EVP_DigestFinal(EVP_MD_CTX *ctx, unsigned char *md, unsigned int *size)
393 ret = EVP_DigestFinal_ex(ctx, md, size);
394 EVP_MD_CTX_reset(ctx);
398 /* The caller can assume that this removes any secret data from the context */
399 int EVP_DigestFinal_ex(EVP_MD_CTX *ctx, unsigned char *md, unsigned int *isize)
405 if (ctx->digest == NULL)
408 sz = EVP_MD_size(ctx->digest);
412 if (ctx->digest->prov == NULL)
415 if (ctx->digest->dfinal == NULL) {
416 ERR_raise(ERR_LIB_EVP, EVP_R_FINAL_ERROR);
420 ret = ctx->digest->dfinal(ctx->provctx, md, &size, mdsize);
423 if (size <= UINT_MAX) {
426 ERR_raise(ERR_LIB_EVP, EVP_R_FINAL_ERROR);
433 /* TODO(3.0): Remove legacy code below */
435 OPENSSL_assert(mdsize <= EVP_MAX_MD_SIZE);
436 ret = ctx->digest->final(ctx, md);
439 if (ctx->digest->cleanup) {
440 ctx->digest->cleanup(ctx);
441 EVP_MD_CTX_set_flags(ctx, EVP_MD_CTX_FLAG_CLEANED);
443 OPENSSL_cleanse(ctx->md_data, ctx->digest->ctx_size);
447 int EVP_DigestFinalXOF(EVP_MD_CTX *ctx, unsigned char *md, size_t size)
450 OSSL_PARAM params[2];
453 if (ctx->digest == NULL || ctx->digest->prov == NULL)
456 if (ctx->digest->dfinal == NULL) {
457 ERR_raise(ERR_LIB_EVP, EVP_R_FINAL_ERROR);
461 params[i++] = OSSL_PARAM_construct_size_t(OSSL_DIGEST_PARAM_XOFLEN, &size);
462 params[i++] = OSSL_PARAM_construct_end();
464 if (EVP_MD_CTX_set_params(ctx, params) > 0)
465 ret = ctx->digest->dfinal(ctx->provctx, md, &size, size);
470 if (ctx->digest->flags & EVP_MD_FLAG_XOF
472 && ctx->digest->md_ctrl(ctx, EVP_MD_CTRL_XOF_LEN, (int)size, NULL)) {
473 ret = ctx->digest->final(ctx, md);
474 if (ctx->digest->cleanup != NULL) {
475 ctx->digest->cleanup(ctx);
476 EVP_MD_CTX_set_flags(ctx, EVP_MD_CTX_FLAG_CLEANED);
478 OPENSSL_cleanse(ctx->md_data, ctx->digest->ctx_size);
480 ERR_raise(ERR_LIB_EVP, EVP_R_NOT_XOF_OR_INVALID_LENGTH);
486 int EVP_MD_CTX_copy(EVP_MD_CTX *out, const EVP_MD_CTX *in)
488 EVP_MD_CTX_reset(out);
489 return EVP_MD_CTX_copy_ex(out, in);
492 int EVP_MD_CTX_copy_ex(EVP_MD_CTX *out, const EVP_MD_CTX *in)
494 unsigned char *tmp_buf;
496 if (in == NULL || in->digest == NULL) {
497 ERR_raise(ERR_LIB_EVP, EVP_R_INPUT_NOT_INITIALIZED);
501 if (in->digest->prov == NULL
502 || (in->flags & EVP_MD_CTX_FLAG_NO_INIT) != 0)
505 if (in->digest->dupctx == NULL) {
506 ERR_raise(ERR_LIB_EVP, EVP_R_NOT_ABLE_TO_COPY_CTX);
510 EVP_MD_CTX_reset(out);
511 if (out->fetched_digest != NULL)
512 EVP_MD_free(out->fetched_digest);
514 /* NULL out pointers in case of error */
518 if (in->fetched_digest != NULL)
519 EVP_MD_up_ref(in->fetched_digest);
521 if (in->provctx != NULL) {
522 out->provctx = in->digest->dupctx(in->provctx);
523 if (out->provctx == NULL) {
524 ERR_raise(ERR_LIB_EVP, EVP_R_NOT_ABLE_TO_COPY_CTX);
529 /* copied EVP_MD_CTX should free the copied EVP_PKEY_CTX */
530 EVP_MD_CTX_clear_flags(out, EVP_MD_CTX_FLAG_KEEP_PKEY_CTX);
532 /* TODO(3.0): Temporarily no support for EVP_DigestSign* in FIPS module */
533 if (in->pctx != NULL) {
534 out->pctx = EVP_PKEY_CTX_dup(in->pctx);
535 if (out->pctx == NULL) {
536 ERR_raise(ERR_LIB_EVP, EVP_R_NOT_ABLE_TO_COPY_CTX);
537 EVP_MD_CTX_reset(out);
545 /* TODO(3.0): Remove legacy code below */
547 #if !defined(OPENSSL_NO_ENGINE) && !defined(FIPS_MODULE)
548 /* Make sure it's safe to copy a digest context using an ENGINE */
549 if (in->engine && !ENGINE_init(in->engine)) {
550 ERR_raise(ERR_LIB_EVP, ERR_R_ENGINE_LIB);
555 if (out->digest == in->digest) {
556 tmp_buf = out->md_data;
557 EVP_MD_CTX_set_flags(out, EVP_MD_CTX_FLAG_REUSE);
560 EVP_MD_CTX_reset(out);
561 memcpy(out, in, sizeof(*out));
563 /* copied EVP_MD_CTX should free the copied EVP_PKEY_CTX */
564 EVP_MD_CTX_clear_flags(out, EVP_MD_CTX_FLAG_KEEP_PKEY_CTX);
566 /* Null these variables, since they are getting fixed up
567 * properly below. Anything else may cause a memleak and/or
568 * double free if any of the memory allocations below fail
573 if (in->md_data && out->digest->ctx_size) {
575 out->md_data = tmp_buf;
577 out->md_data = OPENSSL_malloc(out->digest->ctx_size);
578 if (out->md_data == NULL) {
579 ERR_raise(ERR_LIB_EVP, ERR_R_MALLOC_FAILURE);
583 memcpy(out->md_data, in->md_data, out->digest->ctx_size);
586 out->update = in->update;
589 /* TODO(3.0): Temporarily no support for EVP_DigestSign* in FIPS module */
591 out->pctx = EVP_PKEY_CTX_dup(in->pctx);
593 EVP_MD_CTX_reset(out);
599 if (out->digest->copy)
600 return out->digest->copy(out, in);
605 int EVP_Digest(const void *data, size_t count,
606 unsigned char *md, unsigned int *size, const EVP_MD *type,
609 EVP_MD_CTX *ctx = EVP_MD_CTX_new();
614 EVP_MD_CTX_set_flags(ctx, EVP_MD_CTX_FLAG_ONESHOT);
615 ret = EVP_DigestInit_ex(ctx, type, impl)
616 && EVP_DigestUpdate(ctx, data, count)
617 && EVP_DigestFinal_ex(ctx, md, size);
618 EVP_MD_CTX_free(ctx);
623 int EVP_MD_get_params(const EVP_MD *digest, OSSL_PARAM params[])
625 if (digest != NULL && digest->get_params != NULL)
626 return digest->get_params(params);
630 const OSSL_PARAM *EVP_MD_gettable_params(const EVP_MD *digest)
632 if (digest != NULL && digest->gettable_params != NULL)
633 return digest->gettable_params(
634 ossl_provider_ctx(EVP_MD_provider(digest)));
638 int EVP_MD_CTX_set_params(EVP_MD_CTX *ctx, const OSSL_PARAM params[])
640 EVP_PKEY_CTX *pctx = ctx->pctx;
642 /* If we have a pctx then we should try that first */
644 && (pctx->operation == EVP_PKEY_OP_VERIFYCTX
645 || pctx->operation == EVP_PKEY_OP_SIGNCTX)
646 && pctx->op.sig.sigprovctx != NULL
647 && pctx->op.sig.signature->set_ctx_md_params != NULL)
648 return pctx->op.sig.signature->set_ctx_md_params(pctx->op.sig.sigprovctx,
651 if (ctx->digest != NULL && ctx->digest->set_ctx_params != NULL)
652 return ctx->digest->set_ctx_params(ctx->provctx, params);
657 const OSSL_PARAM *EVP_MD_settable_ctx_params(const EVP_MD *md)
661 if (md != NULL && md->settable_ctx_params != NULL) {
662 alg = ossl_provider_ctx(EVP_MD_provider(md));
663 return md->settable_ctx_params(NULL, alg);
668 const OSSL_PARAM *EVP_MD_CTX_settable_params(EVP_MD_CTX *ctx)
676 /* If we have a pctx then we should try that first */
679 && (pctx->operation == EVP_PKEY_OP_VERIFYCTX
680 || pctx->operation == EVP_PKEY_OP_SIGNCTX)
681 && pctx->op.sig.sigprovctx != NULL
682 && pctx->op.sig.signature->settable_ctx_md_params != NULL)
683 return pctx->op.sig.signature->settable_ctx_md_params(
684 pctx->op.sig.sigprovctx);
686 if (ctx->digest != NULL && ctx->digest->settable_ctx_params != NULL) {
687 alg = ossl_provider_ctx(EVP_MD_provider(ctx->digest));
688 return ctx->digest->settable_ctx_params(ctx->provctx, alg);
694 int EVP_MD_CTX_get_params(EVP_MD_CTX *ctx, OSSL_PARAM params[])
696 EVP_PKEY_CTX *pctx = ctx->pctx;
698 /* If we have a pctx then we should try that first */
700 && (pctx->operation == EVP_PKEY_OP_VERIFYCTX
701 || pctx->operation == EVP_PKEY_OP_SIGNCTX)
702 && pctx->op.sig.sigprovctx != NULL
703 && pctx->op.sig.signature->get_ctx_md_params != NULL)
704 return pctx->op.sig.signature->get_ctx_md_params(pctx->op.sig.sigprovctx,
707 if (ctx->digest != NULL && ctx->digest->get_params != NULL)
708 return ctx->digest->get_ctx_params(ctx->provctx, params);
713 const OSSL_PARAM *EVP_MD_gettable_ctx_params(const EVP_MD *md)
717 if (md != NULL && md->gettable_ctx_params != NULL) {
718 alg = ossl_provider_ctx(EVP_MD_provider(md));
719 return md->gettable_ctx_params(NULL, alg);
724 const OSSL_PARAM *EVP_MD_CTX_gettable_params(EVP_MD_CTX *ctx)
732 /* If we have a pctx then we should try that first */
735 && (pctx->operation == EVP_PKEY_OP_VERIFYCTX
736 || pctx->operation == EVP_PKEY_OP_SIGNCTX)
737 && pctx->op.sig.sigprovctx != NULL
738 && pctx->op.sig.signature->gettable_ctx_md_params != NULL)
739 return pctx->op.sig.signature->gettable_ctx_md_params(
740 pctx->op.sig.sigprovctx);
742 if (ctx->digest != NULL && ctx->digest->gettable_ctx_params != NULL) {
743 alg = ossl_provider_ctx(EVP_MD_provider(ctx->digest));
744 return ctx->digest->gettable_ctx_params(ctx->provctx, alg);
749 /* TODO(3.0): Remove legacy code below - only used by engines & DigestSign */
750 int EVP_MD_CTX_ctrl(EVP_MD_CTX *ctx, int cmd, int p1, void *p2)
752 int ret = EVP_CTRL_RET_UNSUPPORTED;
755 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
758 ERR_raise(ERR_LIB_EVP, ERR_R_PASSED_NULL_PARAMETER);
762 if (ctx->digest != NULL && ctx->digest->prov == NULL)
766 case EVP_MD_CTRL_XOF_LEN:
768 params[0] = OSSL_PARAM_construct_size_t(OSSL_DIGEST_PARAM_XOFLEN, &sz);
770 case EVP_MD_CTRL_MICALG:
772 params[0] = OSSL_PARAM_construct_utf8_string(OSSL_DIGEST_PARAM_MICALG,
775 case EVP_CTRL_SSL3_MASTER_SECRET:
776 params[0] = OSSL_PARAM_construct_octet_string(OSSL_DIGEST_PARAM_SSL3_MS,
784 ret = EVP_MD_CTX_set_params(ctx, params);
786 ret = EVP_MD_CTX_get_params(ctx, params);
790 /* TODO(3.0): Remove legacy code below */
792 if (ctx->digest->md_ctrl == NULL) {
793 ERR_raise(ERR_LIB_EVP, EVP_R_CTRL_NOT_IMPLEMENTED);
797 ret = ctx->digest->md_ctrl(ctx, cmd, p1, p2);
804 EVP_MD *evp_md_new(void)
806 EVP_MD *md = OPENSSL_zalloc(sizeof(*md));
809 md->lock = CRYPTO_THREAD_lock_new();
810 if (md->lock == NULL) {
820 * FIPS module note: since internal fetches will be entirely
821 * provider based, we know that none of its code depends on legacy
822 * NIDs or any functionality that use them.
825 /* TODO(3.x) get rid of the need for legacy NIDs */
826 static void set_legacy_nid(const char *name, void *vlegacy_nid)
829 int *legacy_nid = vlegacy_nid;
831 * We use lowest level function to get the associated method, because
832 * higher level functions such as EVP_get_digestbyname() have changed
833 * to look at providers too.
835 const void *legacy_method = OBJ_NAME_get(name, OBJ_NAME_TYPE_MD_METH);
837 if (*legacy_nid == -1) /* We found a clash already */
840 if (legacy_method == NULL)
842 nid = EVP_MD_nid(legacy_method);
843 if (*legacy_nid != NID_undef && *legacy_nid != nid) {
851 static int evp_md_cache_constants(EVP_MD *md)
853 int ok, xof = 0, algid_absent = 0;
856 OSSL_PARAM params[5];
858 params[0] = OSSL_PARAM_construct_size_t(OSSL_DIGEST_PARAM_BLOCK_SIZE, &blksz);
859 params[1] = OSSL_PARAM_construct_size_t(OSSL_DIGEST_PARAM_SIZE, &mdsize);
860 params[2] = OSSL_PARAM_construct_int(OSSL_DIGEST_PARAM_XOF, &xof);
861 params[3] = OSSL_PARAM_construct_int(OSSL_DIGEST_PARAM_ALGID_ABSENT,
863 params[4] = OSSL_PARAM_construct_end();
864 ok = evp_do_md_getparams(md, params);
865 if (mdsize > INT_MAX || blksz > INT_MAX)
868 md->block_size = (int)blksz;
869 md->md_size = (int)mdsize;
871 md->flags |= EVP_MD_FLAG_XOF;
873 md->flags |= EVP_MD_FLAG_DIGALGID_ABSENT;
878 static void *evp_md_from_dispatch(int name_id,
879 const OSSL_DISPATCH *fns,
885 /* EVP_MD_fetch() will set the legacy NID if available */
886 if ((md = evp_md_new()) == NULL) {
887 ERR_raise(ERR_LIB_EVP, ERR_R_MALLOC_FAILURE);
892 /* TODO(3.x) get rid of the need for legacy NIDs */
893 md->type = NID_undef;
894 if (!evp_names_do_all(prov, name_id, set_legacy_nid, &md->type)
896 ERR_raise(ERR_LIB_EVP, ERR_R_INTERNAL_ERROR);
902 md->name_id = name_id;
904 for (; fns->function_id != 0; fns++) {
905 switch (fns->function_id) {
906 case OSSL_FUNC_DIGEST_NEWCTX:
907 if (md->newctx == NULL) {
908 md->newctx = OSSL_FUNC_digest_newctx(fns);
912 case OSSL_FUNC_DIGEST_INIT:
913 if (md->dinit == NULL) {
914 md->dinit = OSSL_FUNC_digest_init(fns);
918 case OSSL_FUNC_DIGEST_UPDATE:
919 if (md->dupdate == NULL) {
920 md->dupdate = OSSL_FUNC_digest_update(fns);
924 case OSSL_FUNC_DIGEST_FINAL:
925 if (md->dfinal == NULL) {
926 md->dfinal = OSSL_FUNC_digest_final(fns);
930 case OSSL_FUNC_DIGEST_DIGEST:
931 if (md->digest == NULL)
932 md->digest = OSSL_FUNC_digest_digest(fns);
933 /* We don't increment fnct for this as it is stand alone */
935 case OSSL_FUNC_DIGEST_FREECTX:
936 if (md->freectx == NULL) {
937 md->freectx = OSSL_FUNC_digest_freectx(fns);
941 case OSSL_FUNC_DIGEST_DUPCTX:
942 if (md->dupctx == NULL)
943 md->dupctx = OSSL_FUNC_digest_dupctx(fns);
945 case OSSL_FUNC_DIGEST_GET_PARAMS:
946 if (md->get_params == NULL)
947 md->get_params = OSSL_FUNC_digest_get_params(fns);
949 case OSSL_FUNC_DIGEST_SET_CTX_PARAMS:
950 if (md->set_ctx_params == NULL)
951 md->set_ctx_params = OSSL_FUNC_digest_set_ctx_params(fns);
953 case OSSL_FUNC_DIGEST_GET_CTX_PARAMS:
954 if (md->get_ctx_params == NULL)
955 md->get_ctx_params = OSSL_FUNC_digest_get_ctx_params(fns);
957 case OSSL_FUNC_DIGEST_GETTABLE_PARAMS:
958 if (md->gettable_params == NULL)
959 md->gettable_params = OSSL_FUNC_digest_gettable_params(fns);
961 case OSSL_FUNC_DIGEST_SETTABLE_CTX_PARAMS:
962 if (md->settable_ctx_params == NULL)
963 md->settable_ctx_params =
964 OSSL_FUNC_digest_settable_ctx_params(fns);
966 case OSSL_FUNC_DIGEST_GETTABLE_CTX_PARAMS:
967 if (md->gettable_ctx_params == NULL)
968 md->gettable_ctx_params =
969 OSSL_FUNC_digest_gettable_ctx_params(fns);
973 if ((fncnt != 0 && fncnt != 5)
974 || (fncnt == 0 && md->digest == NULL)) {
976 * In order to be a consistent set of functions we either need the
977 * whole set of init/update/final etc functions or none of them.
978 * The "digest" function can standalone. We at least need one way to
982 ERR_raise(ERR_LIB_EVP, EVP_R_INVALID_PROVIDER_FUNCTIONS);
987 ossl_provider_up_ref(prov);
989 if (!evp_md_cache_constants(md)) {
991 ERR_raise(ERR_LIB_EVP, EVP_R_CACHE_CONSTANTS_FAILED);
998 static int evp_md_up_ref(void *md)
1000 return EVP_MD_up_ref(md);
1003 static void evp_md_free(void *md)
1008 EVP_MD *EVP_MD_fetch(OSSL_LIB_CTX *ctx, const char *algorithm,
1009 const char *properties)
1012 evp_generic_fetch(ctx, OSSL_OP_DIGEST, algorithm, properties,
1013 evp_md_from_dispatch, evp_md_up_ref, evp_md_free);
1018 int EVP_MD_up_ref(EVP_MD *md)
1022 CRYPTO_UP_REF(&md->refcnt, &ref, md->lock);
1026 void EVP_MD_free(EVP_MD *md)
1033 CRYPTO_DOWN_REF(&md->refcnt, &i, md->lock);
1036 ossl_provider_free(md->prov);
1037 CRYPTO_THREAD_lock_free(md->lock);
1041 void EVP_MD_do_all_provided(OSSL_LIB_CTX *libctx,
1042 void (*fn)(EVP_MD *mac, void *arg),
1045 evp_generic_do_all(libctx, OSSL_OP_DIGEST,
1046 (void (*)(void *, void *))fn, arg,
1047 evp_md_from_dispatch, evp_md_free);