eng_init.c 5.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154
  1. /* crypto/engine/eng_init.c */
  2. /* ====================================================================
  3. * Copyright (c) 1999-2001 The OpenSSL Project. All rights reserved.
  4. *
  5. * Redistribution and use in source and binary forms, with or without
  6. * modification, are permitted provided that the following conditions
  7. * are met:
  8. *
  9. * 1. Redistributions of source code must retain the above copyright
  10. * notice, this list of conditions and the following disclaimer.
  11. *
  12. * 2. Redistributions in binary form must reproduce the above copyright
  13. * notice, this list of conditions and the following disclaimer in
  14. * the documentation and/or other materials provided with the
  15. * distribution.
  16. *
  17. * 3. All advertising materials mentioning features or use of this
  18. * software must display the following acknowledgment:
  19. * "This product includes software developed by the OpenSSL Project
  20. * for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
  21. *
  22. * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
  23. * endorse or promote products derived from this software without
  24. * prior written permission. For written permission, please contact
  25. * licensing@OpenSSL.org.
  26. *
  27. * 5. Products derived from this software may not be called "OpenSSL"
  28. * nor may "OpenSSL" appear in their names without prior written
  29. * permission of the OpenSSL Project.
  30. *
  31. * 6. Redistributions of any form whatsoever must retain the following
  32. * acknowledgment:
  33. * "This product includes software developed by the OpenSSL Project
  34. * for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
  35. *
  36. * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
  37. * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  38. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  39. * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
  40. * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  41. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  42. * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  43. * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  44. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  45. * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  46. * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  47. * OF THE POSSIBILITY OF SUCH DAMAGE.
  48. * ====================================================================
  49. *
  50. * This product includes cryptographic software written by Eric Young
  51. * (eay@cryptsoft.com). This product includes software written by Tim
  52. * Hudson (tjh@cryptsoft.com).
  53. *
  54. */
  55. #include "eng_int.h"
  56. /* Initialise a engine type for use (or up its functional reference count
  57. * if it's already in use). This version is only used internally. */
  58. int engine_unlocked_init(ENGINE *e)
  59. {
  60. int to_return = 1;
  61. if((e->funct_ref == 0) && e->init)
  62. /* This is the first functional reference and the engine
  63. * requires initialisation so we do it now. */
  64. to_return = e->init(e);
  65. if(to_return)
  66. {
  67. /* OK, we return a functional reference which is also a
  68. * structural reference. */
  69. e->struct_ref++;
  70. e->funct_ref++;
  71. engine_ref_debug(e, 0, 1)
  72. engine_ref_debug(e, 1, 1)
  73. }
  74. return to_return;
  75. }
  76. /* Free a functional reference to a engine type. This version is only used
  77. * internally. */
  78. int engine_unlocked_finish(ENGINE *e, int unlock_for_handlers)
  79. {
  80. int to_return = 1;
  81. /* Reduce the functional reference count here so if it's the terminating
  82. * case, we can release the lock safely and call the finish() handler
  83. * without risk of a race. We get a race if we leave the count until
  84. * after and something else is calling "finish" at the same time -
  85. * there's a chance that both threads will together take the count from
  86. * 2 to 0 without either calling finish(). */
  87. e->funct_ref--;
  88. engine_ref_debug(e, 1, -1);
  89. if((e->funct_ref == 0) && e->finish)
  90. {
  91. if(unlock_for_handlers)
  92. CRYPTO_w_unlock(CRYPTO_LOCK_ENGINE);
  93. to_return = e->finish(e);
  94. if(unlock_for_handlers)
  95. CRYPTO_w_lock(CRYPTO_LOCK_ENGINE);
  96. if(!to_return)
  97. return 0;
  98. }
  99. #ifdef REF_CHECK
  100. if(e->funct_ref < 0)
  101. {
  102. fprintf(stderr,"ENGINE_finish, bad functional reference count\n");
  103. abort();
  104. }
  105. #endif
  106. /* Release the structural reference too */
  107. if(!engine_free_util(e, 0))
  108. {
  109. ENGINEerr(ENGINE_F_ENGINE_FINISH,ENGINE_R_FINISH_FAILED);
  110. return 0;
  111. }
  112. return to_return;
  113. }
  114. /* The API (locked) version of "init" */
  115. int ENGINE_init(ENGINE *e)
  116. {
  117. int ret;
  118. if(e == NULL)
  119. {
  120. ENGINEerr(ENGINE_F_ENGINE_INIT,ERR_R_PASSED_NULL_PARAMETER);
  121. return 0;
  122. }
  123. CRYPTO_w_lock(CRYPTO_LOCK_ENGINE);
  124. ret = engine_unlocked_init(e);
  125. CRYPTO_w_unlock(CRYPTO_LOCK_ENGINE);
  126. return ret;
  127. }
  128. /* The API (locked) version of "finish" */
  129. int ENGINE_finish(ENGINE *e)
  130. {
  131. int to_return = 1;
  132. if(e == NULL)
  133. {
  134. ENGINEerr(ENGINE_F_ENGINE_FINISH,ERR_R_PASSED_NULL_PARAMETER);
  135. return 0;
  136. }
  137. CRYPTO_w_lock(CRYPTO_LOCK_ENGINE);
  138. to_return = engine_unlocked_finish(e, 1);
  139. CRYPTO_w_unlock(CRYPTO_LOCK_ENGINE);
  140. if(!to_return)
  141. {
  142. ENGINEerr(ENGINE_F_ENGINE_FINISH,ENGINE_R_FINISH_FAILED);
  143. return 0;
  144. }
  145. return to_return;
  146. }