provider.h 2.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566
  1. /*
  2. * Copyright 2019-2023 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. #ifndef OPENSSL_PROVIDER_H
  10. # define OPENSSL_PROVIDER_H
  11. # pragma once
  12. # include <openssl/core.h>
  13. # ifdef __cplusplus
  14. extern "C" {
  15. # endif
  16. /* Set and Get a library context search path */
  17. int OSSL_PROVIDER_set_default_search_path(OSSL_LIB_CTX *, const char *path);
  18. const char *OSSL_PROVIDER_get0_default_search_path(OSSL_LIB_CTX *libctx);
  19. /* Load and unload a provider */
  20. OSSL_PROVIDER *OSSL_PROVIDER_load(OSSL_LIB_CTX *, const char *name);
  21. OSSL_PROVIDER *OSSL_PROVIDER_load_ex(OSSL_LIB_CTX *, const char *name,
  22. OSSL_PARAM *params);
  23. OSSL_PROVIDER *OSSL_PROVIDER_try_load(OSSL_LIB_CTX *, const char *name,
  24. int retain_fallbacks);
  25. OSSL_PROVIDER *OSSL_PROVIDER_try_load_ex(OSSL_LIB_CTX *, const char *name,
  26. OSSL_PARAM *params,
  27. int retain_fallbacks);
  28. int OSSL_PROVIDER_unload(OSSL_PROVIDER *prov);
  29. int OSSL_PROVIDER_available(OSSL_LIB_CTX *, const char *name);
  30. int OSSL_PROVIDER_do_all(OSSL_LIB_CTX *ctx,
  31. int (*cb)(OSSL_PROVIDER *provider, void *cbdata),
  32. void *cbdata);
  33. const OSSL_PARAM *OSSL_PROVIDER_gettable_params(const OSSL_PROVIDER *prov);
  34. int OSSL_PROVIDER_get_params(const OSSL_PROVIDER *prov, OSSL_PARAM params[]);
  35. int OSSL_PROVIDER_self_test(const OSSL_PROVIDER *prov);
  36. int OSSL_PROVIDER_get_capabilities(const OSSL_PROVIDER *prov,
  37. const char *capability,
  38. OSSL_CALLBACK *cb,
  39. void *arg);
  40. const OSSL_ALGORITHM *OSSL_PROVIDER_query_operation(const OSSL_PROVIDER *prov,
  41. int operation_id,
  42. int *no_cache);
  43. void OSSL_PROVIDER_unquery_operation(const OSSL_PROVIDER *prov,
  44. int operation_id, const OSSL_ALGORITHM *algs);
  45. void *OSSL_PROVIDER_get0_provider_ctx(const OSSL_PROVIDER *prov);
  46. const OSSL_DISPATCH *OSSL_PROVIDER_get0_dispatch(const OSSL_PROVIDER *prov);
  47. /* Add a built in providers */
  48. int OSSL_PROVIDER_add_builtin(OSSL_LIB_CTX *, const char *name,
  49. OSSL_provider_init_fn *init_fn);
  50. /* Information */
  51. const char *OSSL_PROVIDER_get0_name(const OSSL_PROVIDER *prov);
  52. # ifdef __cplusplus
  53. }
  54. # endif
  55. #endif