crypto/provider.c

   1 /*
   2  * Copyright 2019-2021 The OpenSSL Project Authors. All Rights Reserved.
   3  *
   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
   8  */
   9
  10 #include <openssl/err.h>
  11 #include <openssl/cryptoerr.h>
  12 #include <openssl/provider.h>
  13 #include <openssl/core_names.h>
  14 #include "internal/provider.h"
  15
  16 OSSL_PROVIDER *OSSL_PROVIDER_try_load(OSSL_LIB_CTX *libctx, const char *name,
  17                                       int retain_fallbacks)
  18 {
  19     OSSL_PROVIDER *prov = NULL;
  20
  21     /* Find it or create it */
  22     if ((prov = ossl_provider_find(libctx, name, 0)) == NULL
  23         && (prov = ossl_provider_new(libctx, name, NULL, 0)) == NULL)
  24         return NULL;
  25
  26     if (!ossl_provider_activate(prov, retain_fallbacks, 1)) {
  27         ossl_provider_free(prov);
  28         return NULL;
  29     }
  30
  31     return prov;
  32 }
  33
  34 OSSL_PROVIDER *OSSL_PROVIDER_load(OSSL_LIB_CTX *libctx, const char *name)
  35 {
  36     /* Any attempt to load a provider disables auto-loading of defaults */
  37     if (ossl_provider_disable_fallback_loading(libctx))
  38         return OSSL_PROVIDER_try_load(libctx, name, 0);
  39     return NULL;
  40 }
  41
  42 int OSSL_PROVIDER_unload(OSSL_PROVIDER *prov)
  43 {
  44     if (!ossl_provider_deactivate(prov))
  45         return 0;
  46     ossl_provider_free(prov);
  47     return 1;
  48 }
  49
  50 const OSSL_PARAM *OSSL_PROVIDER_gettable_params(const OSSL_PROVIDER *prov)
  51 {
  52     return ossl_provider_gettable_params(prov);
  53 }
  54
  55 int OSSL_PROVIDER_get_params(const OSSL_PROVIDER *prov, OSSL_PARAM params[])
  56 {
  57     return ossl_provider_get_params(prov, params);
  58 }
  59
  60 const OSSL_ALGORITHM *OSSL_PROVIDER_query_operation(const OSSL_PROVIDER *prov,
  61                                                     int operation_id,
  62                                                     int *no_cache)
  63 {
  64     return ossl_provider_query_operation(prov, operation_id, no_cache);
  65 }
  66
  67 void OSSL_PROVIDER_unquery_operation(const OSSL_PROVIDER *prov,
  68                                      int operation_id,
  69                                      const OSSL_ALGORITHM *algs)
  70 {
  71     ossl_provider_unquery_operation(prov, operation_id, algs);
  72 }
  73
  74 void *OSSL_PROVIDER_get0_provider_ctx(const OSSL_PROVIDER *prov)
  75 {
  76     return ossl_provider_prov_ctx(prov);
  77 }
  78
  79 const OSSL_DISPATCH *OSSL_PROVIDER_get0_dispatch(const OSSL_PROVIDER *prov)
  80 {
  81     return ossl_provider_get0_dispatch(prov);
  82 }
  83
  84 int OSSL_PROVIDER_self_test(const OSSL_PROVIDER *prov)
  85 {
  86     return ossl_provider_self_test(prov);
  87 }
  88
  89 int OSSL_PROVIDER_get_capabilities(const OSSL_PROVIDER *prov,
  90                                    const char *capability,
  91                                    OSSL_CALLBACK *cb,
  92                                    void *arg)
  93 {
  94     return ossl_provider_get_capabilities(prov, capability, cb, arg);
  95 }
  96
  97 int OSSL_PROVIDER_add_builtin(OSSL_LIB_CTX *libctx, const char *name,
  98                               OSSL_provider_init_fn *init_fn)
  99 {
 100     OSSL_PROVIDER *prov = NULL;
 101
 102     if (name == NULL || init_fn == NULL) {
 103         ERR_raise(ERR_LIB_CRYPTO, ERR_R_PASSED_NULL_PARAMETER);
 104         return 0;
 105     }
 106
 107     /* Create it */
 108     if ((prov = ossl_provider_new(libctx, name, init_fn, 0)) == NULL)
 109         return 0;
 110
 111     /*
 112      * It's safely stored in the internal store at this point,
 113      * free the returned extra reference
 114      */
 115     ossl_provider_free(prov);
 116
 117     return 1;
 118 }
 119
 120 const char *OSSL_PROVIDER_get0_name(const OSSL_PROVIDER *prov)
 121 {
 122     return ossl_provider_name(prov);
 123 }
 124
 125 int OSSL_PROVIDER_do_all(OSSL_LIB_CTX *ctx,
 126                          int (*cb)(OSSL_PROVIDER *provider,
 127                                    void *cbdata),
 128                          void *cbdata)
 129 {
 130     return ossl_provider_doall_activated(ctx, cb, cbdata);
 131 }