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
)
659 if (md
!= NULL
&& md
->settable_ctx_params
!= NULL
)
660 return md
->settable_ctx_params(ossl_provider_ctx(EVP_MD_provider(md
)));
664 const OSSL_PARAM
*EVP_MD_CTX_settable_params(EVP_MD_CTX
*ctx
)
671 /* If we have a pctx then we should try that first */
674 && (pctx
->operation
== EVP_PKEY_OP_VERIFYCTX
675 || pctx
->operation
== EVP_PKEY_OP_SIGNCTX
)
676 && pctx
->op
.sig
.sigprovctx
!= NULL
677 && pctx
->op
.sig
.signature
->settable_ctx_md_params
!= NULL
)
678 return pctx
->op
.sig
.signature
->settable_ctx_md_params(
679 pctx
->op
.sig
.sigprovctx
);
681 if (ctx
->digest
!= NULL
&& ctx
->digest
->settable_ctx_params
!= NULL
)
682 return ctx
->digest
->settable_ctx_params(
683 ossl_provider_ctx(EVP_MD_provider(ctx
->digest
)));
688 int EVP_MD_CTX_get_params(EVP_MD_CTX
*ctx
, OSSL_PARAM params
[])
690 EVP_PKEY_CTX
*pctx
= ctx
->pctx
;
692 /* If we have a pctx then we should try that first */
694 && (pctx
->operation
== EVP_PKEY_OP_VERIFYCTX
695 || pctx
->operation
== EVP_PKEY_OP_SIGNCTX
)
696 && pctx
->op
.sig
.sigprovctx
!= NULL
697 && pctx
->op
.sig
.signature
->get_ctx_md_params
!= NULL
)
698 return pctx
->op
.sig
.signature
->get_ctx_md_params(pctx
->op
.sig
.sigprovctx
,
701 if (ctx
->digest
!= NULL
&& ctx
->digest
->get_params
!= NULL
)
702 return ctx
->digest
->get_ctx_params(ctx
->provctx
, params
);
707 const OSSL_PARAM
*EVP_MD_gettable_ctx_params(const EVP_MD
*md
)
709 if (md
!= NULL
&& md
->gettable_ctx_params
!= NULL
)
710 return md
->gettable_ctx_params(ossl_provider_ctx(EVP_MD_provider(md
)));
714 const OSSL_PARAM
*EVP_MD_CTX_gettable_params(EVP_MD_CTX
*ctx
)
721 /* If we have a pctx then we should try that first */
724 && (pctx
->operation
== EVP_PKEY_OP_VERIFYCTX
725 || pctx
->operation
== EVP_PKEY_OP_SIGNCTX
)
726 && pctx
->op
.sig
.sigprovctx
!= NULL
727 && pctx
->op
.sig
.signature
->gettable_ctx_md_params
!= NULL
)
728 return pctx
->op
.sig
.signature
->gettable_ctx_md_params(
729 pctx
->op
.sig
.sigprovctx
);
731 if (ctx
->digest
!= NULL
732 && ctx
->digest
->gettable_ctx_params
!= NULL
)
733 return ctx
->digest
->gettable_ctx_params(
734 ossl_provider_ctx(EVP_MD_provider(ctx
->digest
)));
739 /* TODO(3.0): Remove legacy code below - only used by engines & DigestSign */
740 int EVP_MD_CTX_ctrl(EVP_MD_CTX
*ctx
, int cmd
, int p1
, void *p2
)
742 int ret
= EVP_CTRL_RET_UNSUPPORTED
;
745 OSSL_PARAM params
[2] = { OSSL_PARAM_END
, OSSL_PARAM_END
};
748 ERR_raise(ERR_LIB_EVP
, ERR_R_PASSED_NULL_PARAMETER
);
752 if (ctx
->digest
!= NULL
&& ctx
->digest
->prov
== NULL
)
756 case EVP_MD_CTRL_XOF_LEN
:
758 params
[0] = OSSL_PARAM_construct_size_t(OSSL_DIGEST_PARAM_XOFLEN
, &sz
);
760 case EVP_MD_CTRL_MICALG
:
762 params
[0] = OSSL_PARAM_construct_utf8_string(OSSL_DIGEST_PARAM_MICALG
,
765 case EVP_CTRL_SSL3_MASTER_SECRET
:
766 params
[0] = OSSL_PARAM_construct_octet_string(OSSL_DIGEST_PARAM_SSL3_MS
,
774 ret
= EVP_MD_CTX_set_params(ctx
, params
);
776 ret
= EVP_MD_CTX_get_params(ctx
, params
);
780 /* TODO(3.0): Remove legacy code below */
782 if (ctx
->digest
->md_ctrl
== NULL
) {
783 ERR_raise(ERR_LIB_EVP
, EVP_R_CTRL_NOT_IMPLEMENTED
);
787 ret
= ctx
->digest
->md_ctrl(ctx
, cmd
, p1
, p2
);
794 EVP_MD
*evp_md_new(void)
796 EVP_MD
*md
= OPENSSL_zalloc(sizeof(*md
));
799 md
->lock
= CRYPTO_THREAD_lock_new();
800 if (md
->lock
== NULL
) {
810 * FIPS module note: since internal fetches will be entirely
811 * provider based, we know that none of its code depends on legacy
812 * NIDs or any functionality that use them.
815 /* TODO(3.x) get rid of the need for legacy NIDs */
816 static void set_legacy_nid(const char *name
, void *vlegacy_nid
)
819 int *legacy_nid
= vlegacy_nid
;
821 * We use lowest level function to get the associated method, because
822 * higher level functions such as EVP_get_digestbyname() have changed
823 * to look at providers too.
825 const void *legacy_method
= OBJ_NAME_get(name
, OBJ_NAME_TYPE_MD_METH
);
827 if (*legacy_nid
== -1) /* We found a clash already */
830 if (legacy_method
== NULL
)
832 nid
= EVP_MD_nid(legacy_method
);
833 if (*legacy_nid
!= NID_undef
&& *legacy_nid
!= nid
) {
841 static int evp_md_cache_constants(EVP_MD
*md
)
843 int ok
, xof
= 0, algid_absent
= 0;
846 OSSL_PARAM params
[5];
848 params
[0] = OSSL_PARAM_construct_size_t(OSSL_DIGEST_PARAM_BLOCK_SIZE
, &blksz
);
849 params
[1] = OSSL_PARAM_construct_size_t(OSSL_DIGEST_PARAM_SIZE
, &mdsize
);
850 params
[2] = OSSL_PARAM_construct_int(OSSL_DIGEST_PARAM_XOF
, &xof
);
851 params
[3] = OSSL_PARAM_construct_int(OSSL_DIGEST_PARAM_ALGID_ABSENT
,
853 params
[4] = OSSL_PARAM_construct_end();
854 ok
= evp_do_md_getparams(md
, params
);
855 if (mdsize
> INT_MAX
|| blksz
> INT_MAX
)
858 md
->block_size
= (int)blksz
;
859 md
->md_size
= (int)mdsize
;
861 md
->flags
|= EVP_MD_FLAG_XOF
;
863 md
->flags
|= EVP_MD_FLAG_DIGALGID_ABSENT
;
868 static void *evp_md_from_dispatch(int name_id
,
869 const OSSL_DISPATCH
*fns
,
875 /* EVP_MD_fetch() will set the legacy NID if available */
876 if ((md
= evp_md_new()) == NULL
) {
877 ERR_raise(ERR_LIB_EVP
, ERR_R_MALLOC_FAILURE
);
882 /* TODO(3.x) get rid of the need for legacy NIDs */
883 md
->type
= NID_undef
;
884 evp_names_do_all(prov
, name_id
, set_legacy_nid
, &md
->type
);
885 if (md
->type
== -1) {
886 ERR_raise(ERR_LIB_EVP
, ERR_R_INTERNAL_ERROR
);
892 md
->name_id
= name_id
;
894 for (; fns
->function_id
!= 0; fns
++) {
895 switch (fns
->function_id
) {
896 case OSSL_FUNC_DIGEST_NEWCTX
:
897 if (md
->newctx
== NULL
) {
898 md
->newctx
= OSSL_FUNC_digest_newctx(fns
);
902 case OSSL_FUNC_DIGEST_INIT
:
903 if (md
->dinit
== NULL
) {
904 md
->dinit
= OSSL_FUNC_digest_init(fns
);
908 case OSSL_FUNC_DIGEST_UPDATE
:
909 if (md
->dupdate
== NULL
) {
910 md
->dupdate
= OSSL_FUNC_digest_update(fns
);
914 case OSSL_FUNC_DIGEST_FINAL
:
915 if (md
->dfinal
== NULL
) {
916 md
->dfinal
= OSSL_FUNC_digest_final(fns
);
920 case OSSL_FUNC_DIGEST_DIGEST
:
921 if (md
->digest
== NULL
)
922 md
->digest
= OSSL_FUNC_digest_digest(fns
);
923 /* We don't increment fnct for this as it is stand alone */
925 case OSSL_FUNC_DIGEST_FREECTX
:
926 if (md
->freectx
== NULL
) {
927 md
->freectx
= OSSL_FUNC_digest_freectx(fns
);
931 case OSSL_FUNC_DIGEST_DUPCTX
:
932 if (md
->dupctx
== NULL
)
933 md
->dupctx
= OSSL_FUNC_digest_dupctx(fns
);
935 case OSSL_FUNC_DIGEST_GET_PARAMS
:
936 if (md
->get_params
== NULL
)
937 md
->get_params
= OSSL_FUNC_digest_get_params(fns
);
939 case OSSL_FUNC_DIGEST_SET_CTX_PARAMS
:
940 if (md
->set_ctx_params
== NULL
)
941 md
->set_ctx_params
= OSSL_FUNC_digest_set_ctx_params(fns
);
943 case OSSL_FUNC_DIGEST_GET_CTX_PARAMS
:
944 if (md
->get_ctx_params
== NULL
)
945 md
->get_ctx_params
= OSSL_FUNC_digest_get_ctx_params(fns
);
947 case OSSL_FUNC_DIGEST_GETTABLE_PARAMS
:
948 if (md
->gettable_params
== NULL
)
949 md
->gettable_params
= OSSL_FUNC_digest_gettable_params(fns
);
951 case OSSL_FUNC_DIGEST_SETTABLE_CTX_PARAMS
:
952 if (md
->settable_ctx_params
== NULL
)
953 md
->settable_ctx_params
=
954 OSSL_FUNC_digest_settable_ctx_params(fns
);
956 case OSSL_FUNC_DIGEST_GETTABLE_CTX_PARAMS
:
957 if (md
->gettable_ctx_params
== NULL
)
958 md
->gettable_ctx_params
=
959 OSSL_FUNC_digest_gettable_ctx_params(fns
);
963 if ((fncnt
!= 0 && fncnt
!= 5)
964 || (fncnt
== 0 && md
->digest
== NULL
)) {
966 * In order to be a consistent set of functions we either need the
967 * whole set of init/update/final etc functions or none of them.
968 * The "digest" function can standalone. We at least need one way to
972 ERR_raise(ERR_LIB_EVP
, EVP_R_INVALID_PROVIDER_FUNCTIONS
);
977 ossl_provider_up_ref(prov
);
979 if (!evp_md_cache_constants(md
)) {
981 ERR_raise(ERR_LIB_EVP
, EVP_R_CACHE_CONSTANTS_FAILED
);
988 static int evp_md_up_ref(void *md
)
990 return EVP_MD_up_ref(md
);
993 static void evp_md_free(void *md
)
998 EVP_MD
*EVP_MD_fetch(OSSL_LIB_CTX
*ctx
, const char *algorithm
,
999 const char *properties
)
1002 evp_generic_fetch(ctx
, OSSL_OP_DIGEST
, algorithm
, properties
,
1003 evp_md_from_dispatch
, evp_md_up_ref
, evp_md_free
);
1008 int EVP_MD_up_ref(EVP_MD
*md
)
1012 CRYPTO_UP_REF(&md
->refcnt
, &ref
, md
->lock
);
1016 void EVP_MD_free(EVP_MD
*md
)
1023 CRYPTO_DOWN_REF(&md
->refcnt
, &i
, md
->lock
);
1026 ossl_provider_free(md
->prov
);
1027 CRYPTO_THREAD_lock_free(md
->lock
);
1031 void EVP_MD_do_all_provided(OSSL_LIB_CTX
*libctx
,
1032 void (*fn
)(EVP_MD
*mac
, void *arg
),
1035 evp_generic_do_all(libctx
, OSSL_OP_DIGEST
,
1036 (void (*)(void *, void *))fn
, arg
,
1037 evp_md_from_dispatch
, evp_md_free
);