core.h 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869
  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. #ifndef OSSL_INTERNAL_CORE_H
  10. # define OSSL_INTERNAL_CORE_H
  11. # pragma once
  12. /*
  13. * namespaces:
  14. *
  15. * ossl_method_ Core Method API
  16. */
  17. /*
  18. * construct an arbitrary method from a dispatch table found by looking
  19. * up a match for the < operation_id, name, property > combination.
  20. * constructor and destructor are the constructor and destructor for that
  21. * arbitrary object.
  22. *
  23. * These objects are normally cached, unless the provider says not to cache.
  24. * However, force_cache can be used to force caching whatever the provider
  25. * says (for example, because the application knows better).
  26. */
  27. typedef struct ossl_method_construct_method_st {
  28. /* Create store */
  29. void *(*alloc_tmp_store)(OSSL_LIB_CTX *ctx);
  30. /* Remove a store */
  31. void (*dealloc_tmp_store)(void *store);
  32. /* Get an already existing method from a store */
  33. void *(*get)(OSSL_LIB_CTX *libctx, void *store, void *data);
  34. /* Store a method in a store */
  35. int (*put)(OSSL_LIB_CTX *libctx, void *store, void *method,
  36. const OSSL_PROVIDER *prov, int operation_id, const char *name,
  37. const char *propdef, void *data);
  38. /* Construct a new method */
  39. void *(*construct)(const OSSL_ALGORITHM *algodef, OSSL_PROVIDER *prov,
  40. void *data);
  41. /* Destruct a method */
  42. void (*destruct)(void *method, void *data);
  43. } OSSL_METHOD_CONSTRUCT_METHOD;
  44. void *ossl_method_construct(OSSL_LIB_CTX *ctx, int operation_id,
  45. int force_cache,
  46. OSSL_METHOD_CONSTRUCT_METHOD *mcm, void *mcm_data);
  47. void ossl_algorithm_do_all(OSSL_LIB_CTX *libctx, int operation_id,
  48. OSSL_PROVIDER *provider,
  49. int (*pre)(OSSL_PROVIDER *, int operation_id,
  50. void *data, int *result),
  51. void (*fn)(OSSL_PROVIDER *provider,
  52. const OSSL_ALGORITHM *algo,
  53. int no_store, void *data),
  54. int (*post)(OSSL_PROVIDER *, int operation_id,
  55. int no_store, void *data, int *result),
  56. void *data);
  57. char *ossl_algorithm_get1_first_name(const OSSL_ALGORITHM *algo);
  58. __owur int ossl_lib_ctx_write_lock(OSSL_LIB_CTX *ctx);
  59. __owur int ossl_lib_ctx_read_lock(OSSL_LIB_CTX *ctx);
  60. int ossl_lib_ctx_unlock(OSSL_LIB_CTX *ctx);
  61. int ossl_lib_ctx_is_child(OSSL_LIB_CTX *ctx);
  62. #endif