eng_lib.c 6.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302
  1. /*
  2. * Copyright 2001-2021 The OpenSSL Project Authors. All Rights Reserved.
  3. *
  4. * Licensed under the OpenSSL license (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. #include "e_os.h"
  10. #include "eng_local.h"
  11. #include <openssl/rand.h>
  12. #include "internal/refcount.h"
  13. CRYPTO_RWLOCK *global_engine_lock;
  14. CRYPTO_ONCE engine_lock_init = CRYPTO_ONCE_STATIC_INIT;
  15. /* The "new"/"free" stuff first */
  16. DEFINE_RUN_ONCE(do_engine_lock_init)
  17. {
  18. if (!OPENSSL_init_crypto(0, NULL))
  19. return 0;
  20. global_engine_lock = CRYPTO_THREAD_lock_new();
  21. return global_engine_lock != NULL;
  22. }
  23. ENGINE *ENGINE_new(void)
  24. {
  25. ENGINE *ret;
  26. if (!RUN_ONCE(&engine_lock_init, do_engine_lock_init)
  27. || (ret = OPENSSL_zalloc(sizeof(*ret))) == NULL) {
  28. ENGINEerr(ENGINE_F_ENGINE_NEW, ERR_R_MALLOC_FAILURE);
  29. return NULL;
  30. }
  31. ret->struct_ref = 1;
  32. engine_ref_debug(ret, 0, 1);
  33. if (!CRYPTO_new_ex_data(CRYPTO_EX_INDEX_ENGINE, ret, &ret->ex_data)) {
  34. OPENSSL_free(ret);
  35. return NULL;
  36. }
  37. return ret;
  38. }
  39. /*
  40. * Placed here (close proximity to ENGINE_new) so that modifications to the
  41. * elements of the ENGINE structure are more likely to be caught and changed
  42. * here.
  43. */
  44. void engine_set_all_null(ENGINE *e)
  45. {
  46. e->id = NULL;
  47. e->name = NULL;
  48. e->rsa_meth = NULL;
  49. e->dsa_meth = NULL;
  50. e->dh_meth = NULL;
  51. e->rand_meth = NULL;
  52. e->ciphers = NULL;
  53. e->digests = NULL;
  54. e->destroy = NULL;
  55. e->init = NULL;
  56. e->finish = NULL;
  57. e->ctrl = NULL;
  58. e->load_privkey = NULL;
  59. e->load_pubkey = NULL;
  60. e->cmd_defns = NULL;
  61. e->flags = 0;
  62. e->dynamic_id = NULL;
  63. }
  64. int engine_free_util(ENGINE *e, int not_locked)
  65. {
  66. int i;
  67. if (e == NULL)
  68. return 1;
  69. if (not_locked)
  70. CRYPTO_DOWN_REF(&e->struct_ref, &i, global_engine_lock);
  71. else
  72. i = --e->struct_ref;
  73. engine_ref_debug(e, 0, -1);
  74. if (i > 0)
  75. return 1;
  76. REF_ASSERT_ISNT(i < 0);
  77. /* Free up any dynamically allocated public key methods */
  78. engine_pkey_meths_free(e);
  79. engine_pkey_asn1_meths_free(e);
  80. /*
  81. * Give the ENGINE a chance to do any structural cleanup corresponding to
  82. * allocation it did in its constructor (eg. unload error strings)
  83. */
  84. if (e->destroy)
  85. e->destroy(e);
  86. engine_remove_dynamic_id(e, not_locked);
  87. CRYPTO_free_ex_data(CRYPTO_EX_INDEX_ENGINE, e, &e->ex_data);
  88. OPENSSL_free(e);
  89. return 1;
  90. }
  91. int ENGINE_free(ENGINE *e)
  92. {
  93. return engine_free_util(e, 1);
  94. }
  95. /* Cleanup stuff */
  96. /*
  97. * engine_cleanup_int() is coded such that anything that does work that will
  98. * need cleanup can register a "cleanup" callback here. That way we don't get
  99. * linker bloat by referring to all *possible* cleanups, but any linker bloat
  100. * into code "X" will cause X's cleanup function to end up here.
  101. */
  102. static STACK_OF(ENGINE_CLEANUP_ITEM) *cleanup_stack = NULL;
  103. static int int_cleanup_check(int create)
  104. {
  105. if (cleanup_stack)
  106. return 1;
  107. if (!create)
  108. return 0;
  109. cleanup_stack = sk_ENGINE_CLEANUP_ITEM_new_null();
  110. return (cleanup_stack ? 1 : 0);
  111. }
  112. static ENGINE_CLEANUP_ITEM *int_cleanup_item(ENGINE_CLEANUP_CB *cb)
  113. {
  114. ENGINE_CLEANUP_ITEM *item;
  115. if ((item = OPENSSL_malloc(sizeof(*item))) == NULL) {
  116. ENGINEerr(ENGINE_F_INT_CLEANUP_ITEM, ERR_R_MALLOC_FAILURE);
  117. return NULL;
  118. }
  119. item->cb = cb;
  120. return item;
  121. }
  122. void engine_cleanup_add_first(ENGINE_CLEANUP_CB *cb)
  123. {
  124. ENGINE_CLEANUP_ITEM *item;
  125. if (!int_cleanup_check(1))
  126. return;
  127. item = int_cleanup_item(cb);
  128. if (item)
  129. sk_ENGINE_CLEANUP_ITEM_insert(cleanup_stack, item, 0);
  130. }
  131. void engine_cleanup_add_last(ENGINE_CLEANUP_CB *cb)
  132. {
  133. ENGINE_CLEANUP_ITEM *item;
  134. if (!int_cleanup_check(1))
  135. return;
  136. item = int_cleanup_item(cb);
  137. if (item != NULL) {
  138. if (sk_ENGINE_CLEANUP_ITEM_push(cleanup_stack, item) <= 0)
  139. OPENSSL_free(item);
  140. }
  141. }
  142. /* The API function that performs all cleanup */
  143. static void engine_cleanup_cb_free(ENGINE_CLEANUP_ITEM *item)
  144. {
  145. (*(item->cb)) ();
  146. OPENSSL_free(item);
  147. }
  148. void engine_cleanup_int(void)
  149. {
  150. if (int_cleanup_check(0)) {
  151. sk_ENGINE_CLEANUP_ITEM_pop_free(cleanup_stack,
  152. engine_cleanup_cb_free);
  153. cleanup_stack = NULL;
  154. }
  155. CRYPTO_THREAD_lock_free(global_engine_lock);
  156. global_engine_lock = NULL;
  157. }
  158. /* Now the "ex_data" support */
  159. int ENGINE_set_ex_data(ENGINE *e, int idx, void *arg)
  160. {
  161. return CRYPTO_set_ex_data(&e->ex_data, idx, arg);
  162. }
  163. void *ENGINE_get_ex_data(const ENGINE *e, int idx)
  164. {
  165. return CRYPTO_get_ex_data(&e->ex_data, idx);
  166. }
  167. /*
  168. * Functions to get/set an ENGINE's elements - mainly to avoid exposing the
  169. * ENGINE structure itself.
  170. */
  171. int ENGINE_set_id(ENGINE *e, const char *id)
  172. {
  173. if (id == NULL) {
  174. ENGINEerr(ENGINE_F_ENGINE_SET_ID, ERR_R_PASSED_NULL_PARAMETER);
  175. return 0;
  176. }
  177. e->id = id;
  178. return 1;
  179. }
  180. int ENGINE_set_name(ENGINE *e, const char *name)
  181. {
  182. if (name == NULL) {
  183. ENGINEerr(ENGINE_F_ENGINE_SET_NAME, ERR_R_PASSED_NULL_PARAMETER);
  184. return 0;
  185. }
  186. e->name = name;
  187. return 1;
  188. }
  189. int ENGINE_set_destroy_function(ENGINE *e, ENGINE_GEN_INT_FUNC_PTR destroy_f)
  190. {
  191. e->destroy = destroy_f;
  192. return 1;
  193. }
  194. int ENGINE_set_init_function(ENGINE *e, ENGINE_GEN_INT_FUNC_PTR init_f)
  195. {
  196. e->init = init_f;
  197. return 1;
  198. }
  199. int ENGINE_set_finish_function(ENGINE *e, ENGINE_GEN_INT_FUNC_PTR finish_f)
  200. {
  201. e->finish = finish_f;
  202. return 1;
  203. }
  204. int ENGINE_set_ctrl_function(ENGINE *e, ENGINE_CTRL_FUNC_PTR ctrl_f)
  205. {
  206. e->ctrl = ctrl_f;
  207. return 1;
  208. }
  209. int ENGINE_set_flags(ENGINE *e, int flags)
  210. {
  211. e->flags = flags;
  212. return 1;
  213. }
  214. int ENGINE_set_cmd_defns(ENGINE *e, const ENGINE_CMD_DEFN *defns)
  215. {
  216. e->cmd_defns = defns;
  217. return 1;
  218. }
  219. const char *ENGINE_get_id(const ENGINE *e)
  220. {
  221. return e->id;
  222. }
  223. const char *ENGINE_get_name(const ENGINE *e)
  224. {
  225. return e->name;
  226. }
  227. ENGINE_GEN_INT_FUNC_PTR ENGINE_get_destroy_function(const ENGINE *e)
  228. {
  229. return e->destroy;
  230. }
  231. ENGINE_GEN_INT_FUNC_PTR ENGINE_get_init_function(const ENGINE *e)
  232. {
  233. return e->init;
  234. }
  235. ENGINE_GEN_INT_FUNC_PTR ENGINE_get_finish_function(const ENGINE *e)
  236. {
  237. return e->finish;
  238. }
  239. ENGINE_CTRL_FUNC_PTR ENGINE_get_ctrl_function(const ENGINE *e)
  240. {
  241. return e->ctrl;
  242. }
  243. int ENGINE_get_flags(const ENGINE *e)
  244. {
  245. return e->flags;
  246. }
  247. const ENGINE_CMD_DEFN *ENGINE_get_cmd_defns(const ENGINE *e)
  248. {
  249. return e->cmd_defns;
  250. }
  251. /*
  252. * eng_lib.o is pretty much linked into anything that touches ENGINE already,
  253. * so put the "static_state" hack here.
  254. */
  255. static int internal_static_hack = 0;
  256. void *ENGINE_get_static_state(void)
  257. {
  258. return &internal_static_hack;
  259. }