1 // Copyright 2014 The BoringSSL Authors
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 //     https://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14 
15 #include <openssl/engine.h>
16 
17 #include <assert.h>
18 #include <string.h>
19 
20 #include <openssl/ec_key.h>
21 #include <openssl/err.h>
22 #include <openssl/mem.h>
23 #include <openssl/rsa.h>
24 
25 #include "../internal.h"
26 
27 
28 struct engine_st {
29   RSA_METHOD *rsa_method;
30   ECDSA_METHOD *ecdsa_method;
31 };
32 
ENGINE_new(void)33 ENGINE *ENGINE_new(void) {
34   return reinterpret_cast<ENGINE *>(OPENSSL_zalloc(sizeof(ENGINE)));
35 }
36 
ENGINE_free(ENGINE * engine)37 int ENGINE_free(ENGINE *engine) {
38   // Methods are currently required to be static so are not unref'ed.
39   OPENSSL_free(engine);
40   return 1;
41 }
42 
43 // set_method takes a pointer to a method and its given size and sets
44 // |*out_member| to point to it. This function might want to be extended in the
45 // future to support making a copy of the method so that a stable ABI for
46 // ENGINEs can be supported. But, for the moment, all *_METHODS must be
47 // static.
set_method(void ** out_member,const void * method,size_t method_size,size_t compiled_size)48 static int set_method(void **out_member, const void *method, size_t method_size,
49                       size_t compiled_size) {
50   const struct openssl_method_common_st *common =
51       reinterpret_cast<const openssl_method_common_st *>(method);
52   if (method_size != compiled_size || !common->is_static) {
53     return 0;
54   }
55 
56   *out_member = (void *)method;
57   return 1;
58 }
59 
ENGINE_set_RSA_method(ENGINE * engine,const RSA_METHOD * method,size_t method_size)60 int ENGINE_set_RSA_method(ENGINE *engine, const RSA_METHOD *method,
61                           size_t method_size) {
62   return set_method((void **)&engine->rsa_method, method, method_size,
63                     sizeof(RSA_METHOD));
64 }
65 
ENGINE_get_RSA_method(const ENGINE * engine)66 RSA_METHOD *ENGINE_get_RSA_method(const ENGINE *engine) {
67   return engine->rsa_method;
68 }
69 
ENGINE_set_ECDSA_method(ENGINE * engine,const ECDSA_METHOD * method,size_t method_size)70 int ENGINE_set_ECDSA_method(ENGINE *engine, const ECDSA_METHOD *method,
71                             size_t method_size) {
72   return set_method((void **)&engine->ecdsa_method, method, method_size,
73                     sizeof(ECDSA_METHOD));
74 }
75 
ENGINE_get_ECDSA_method(const ENGINE * engine)76 ECDSA_METHOD *ENGINE_get_ECDSA_method(const ENGINE *engine) {
77   return engine->ecdsa_method;
78 }
79 
METHOD_ref(void * method_in)80 void METHOD_ref(void *method_in) {
81   assert(((struct openssl_method_common_st *)method_in)->is_static);
82 }
83 
METHOD_unref(void * method_in)84 void METHOD_unref(void *method_in) {
85   struct openssl_method_common_st *method =
86       reinterpret_cast<openssl_method_common_st *>(method_in);
87 
88   if (method == NULL) {
89     return;
90   }
91   assert(method->is_static);
92 }
93 
94 OPENSSL_DECLARE_ERROR_REASON(ENGINE, OPERATION_NOT_SUPPORTED)
95