2 * Copyright 2001-2016 The OpenSSL Project Authors. All Rights Reserved.
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
13 * Initialise a engine type for use (or up its functional reference count if
14 * it's already in use). This version is only used internally.
16 int engine_unlocked_init(ENGINE *e)
20 if ((e->funct_ref == 0) && e->init)
22 * This is the first functional reference and the engine requires
23 * initialisation so we do it now.
25 to_return = e->init(e);
28 * OK, we return a functional reference which is also a structural
33 engine_ref_debug(e, 0, 1);
34 engine_ref_debug(e, 1, 1);
40 * Free a functional reference to a engine type. This version is only used
43 int engine_unlocked_finish(ENGINE *e, int unlock_for_handlers)
48 * Reduce the functional reference count here so if it's the terminating
49 * case, we can release the lock safely and call the finish() handler
50 * without risk of a race. We get a race if we leave the count until
51 * after and something else is calling "finish" at the same time -
52 * there's a chance that both threads will together take the count from 2
53 * to 0 without either calling finish().
56 engine_ref_debug(e, 1, -1);
57 if ((e->funct_ref == 0) && e->finish) {
58 if (unlock_for_handlers)
59 CRYPTO_THREAD_unlock(global_engine_lock);
60 to_return = e->finish(e);
61 if (unlock_for_handlers)
62 CRYPTO_THREAD_write_lock(global_engine_lock);
66 REF_ASSERT_ISNT(e->funct_ref < 0);
67 /* Release the structural reference too */
68 if (!engine_free_util(e, 0)) {
69 ENGINEerr(ENGINE_F_ENGINE_UNLOCKED_FINISH, ENGINE_R_FINISH_FAILED);
75 /* The API (locked) version of "init" */
76 int ENGINE_init(ENGINE *e)
80 ENGINEerr(ENGINE_F_ENGINE_INIT, ERR_R_PASSED_NULL_PARAMETER);
83 if (!RUN_ONCE(&engine_lock_init, do_engine_lock_init)) {
84 ENGINEerr(ENGINE_F_ENGINE_INIT, ERR_R_MALLOC_FAILURE);
87 CRYPTO_THREAD_write_lock(global_engine_lock);
88 ret = engine_unlocked_init(e);
89 CRYPTO_THREAD_unlock(global_engine_lock);
93 /* The API (locked) version of "finish" */
94 int ENGINE_finish(ENGINE *e)
100 CRYPTO_THREAD_write_lock(global_engine_lock);
101 to_return = engine_unlocked_finish(e, 1);
102 CRYPTO_THREAD_unlock(global_engine_lock);
104 ENGINEerr(ENGINE_F_ENGINE_FINISH, ENGINE_R_FINISH_FAILED);