crypto/provider.c

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