7e952921c8d6351c0d4ee4bb1f847aa23612d30e
[openssl.git] / providers / default / defltprov.c
1 /*
2  * Copyright 2019 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
10 #include <string.h>
11 #include <stdio.h>
12 #include <openssl/opensslconf.h>
13 #include <openssl/core.h>
14 #include <openssl/core_numbers.h>
15 #include <openssl/core_names.h>
16 #include <openssl/params.h>
17 #include "internal/provider_algs.h"
18
19 /* Functions provided by the core */
20 static OSSL_core_gettable_params_fn *c_gettable_params = NULL;
21 static OSSL_core_get_params_fn *c_get_params = NULL;
22
23 /* Parameters we provide to the core */
24 static const OSSL_PARAM deflt_param_types[] = {
25     OSSL_PARAM_DEFN(OSSL_PROV_PARAM_NAME, OSSL_PARAM_UTF8_PTR, NULL, 0),
26     OSSL_PARAM_DEFN(OSSL_PROV_PARAM_VERSION, OSSL_PARAM_UTF8_PTR, NULL, 0),
27     OSSL_PARAM_DEFN(OSSL_PROV_PARAM_BUILDINFO, OSSL_PARAM_UTF8_PTR, NULL, 0),
28     OSSL_PARAM_END
29 };
30
31 static const OSSL_PARAM *deflt_gettable_params(const OSSL_PROVIDER *prov)
32 {
33     return deflt_param_types;
34 }
35
36 static int deflt_get_params(const OSSL_PROVIDER *prov, OSSL_PARAM params[])
37 {
38     OSSL_PARAM *p;
39
40     p = OSSL_PARAM_locate(params, OSSL_PROV_PARAM_NAME);
41     if (p != NULL && !OSSL_PARAM_set_utf8_ptr(p, "OpenSSL Default Provider"))
42         return 0;
43     p = OSSL_PARAM_locate(params, OSSL_PROV_PARAM_VERSION);
44     if (p != NULL && !OSSL_PARAM_set_utf8_ptr(p, OPENSSL_VERSION_STR))
45         return 0;
46     p = OSSL_PARAM_locate(params, OSSL_PROV_PARAM_BUILDINFO);
47     if (p != NULL && !OSSL_PARAM_set_utf8_ptr(p, OPENSSL_FULL_VERSION_STR))
48         return 0;
49
50     return 1;
51 }
52
53 /*
54  * For the algorithm names, we use the following formula for our primary
55  * names:
56  *
57  *     ALGNAME[VERSION?][-SUBNAME[VERSION?]?][-SIZE?][-MODE?]
58  *
59  *     VERSION is only present if there are multiple versions of
60  *     an alg (MD2, MD4, MD5).  It may be omitted if there is only
61  *     one version (if a subsequent version is released in the future,
62  *     we can always change the canonical name, and add the old name
63  *     as an alias).
64  *
65  *     SUBNAME may be present where we are combining multiple
66  *     algorithms together, e.g. MD5-SHA1.
67  *
68  *     SIZE is only present if multiple versions of an algorithm exist
69  *     with different sizes (e.g. AES-128-CBC, AES-256-CBC)
70  *
71  *     MODE is only present where applicable.
72  *
73  * We add diverse other names where applicable, such as the names that
74  * NIST uses, or that are used for ASN.1 OBJECT IDENTIFIERs, or names
75  * we have used historically.
76  */
77 static const OSSL_ALGORITHM deflt_digests[] = {
78     /* Our primary name:NIST name[:our older names] */
79     { "SHA1:SHA-1", "default=yes", sha1_functions },
80     { "SHA2-224:SHA-224:SHA224", "default=yes", sha224_functions },
81     { "SHA2-256:SHA-256:SHA256", "default=yes", sha256_functions },
82     { "SHA2-384:SHA-384:SHA384", "default=yes", sha384_functions },
83     { "SHA2-512:SHA-512:SHA512", "default=yes", sha512_functions },
84     { "SHA2-512/224:SHA-512/224:SHA512-224", "default=yes",
85       sha512_224_functions },
86     { "SHA2-512/256:SHA-512/256:SHA512-256", "default=yes",
87       sha512_256_functions },
88
89     /* We agree with NIST here, so one name only */
90     { "SHA3-224", "default=yes", sha3_224_functions },
91     { "SHA3-256", "default=yes", sha3_256_functions },
92     { "SHA3-384", "default=yes", sha3_384_functions },
93     { "SHA3-512", "default=yes", sha3_512_functions },
94
95     /*
96      * KECCAK_KMAC128 and KECCAK_KMAC256 as hashes are mostly useful for
97      * the KMAC128 and KMAC256.
98      */
99     { "KECCAK_KMAC128", "default=yes", keccak_kmac_128_functions },
100     { "KECCAK_KMAC256", "default=yes", keccak_kmac_256_functions },
101
102     /* Our primary name:NIST name */
103     { "SHAKE-128:SHAKE128", "default=yes", shake_128_functions },
104     { "SHAKE-256:SHAKE256", "default=yes", shake_256_functions },
105
106 #ifndef OPENSSL_NO_BLAKE2
107     /*
108      * https://blake2.net/ doesn't specify size variants,
109      * but mentions that Bouncy Castle uses the names
110      * BLAKE2b-160, BLAKE2b-256, BLAKE2b-384, and BLAKE2b-512
111      * If we assume that "2b" and "2s" are versions, that pattern
112      * fits with ours.  We also add our historical names.
113      */
114     { "BLAKE2s-256:BLAKE2s256", "default=yes", blake2s256_functions },
115     { "BLAKE2b-512:BLAKE2b512", "default=yes", blake2b512_functions },
116 #endif /* OPENSSL_NO_BLAKE2 */
117
118 #ifndef OPENSSL_NO_SM3
119     { "SM3", "default=yes", sm3_functions },
120 #endif /* OPENSSL_NO_SM3 */
121
122 #ifndef OPENSSL_NO_MD5
123     { "MD5", "default=yes", md5_functions },
124     { "MD5-SHA1", "default=yes", md5_sha1_functions },
125 #endif /* OPENSSL_NO_MD5 */
126
127     { NULL, NULL, NULL }
128 };
129
130 static const OSSL_ALGORITHM deflt_ciphers[] = {
131     { "AES-256-ECB", "default=yes", aes256ecb_functions },
132     { "AES-192-ECB", "default=yes", aes192ecb_functions },
133     { "AES-128-ECB", "default=yes", aes128ecb_functions },
134     { "AES-256-CBC", "default=yes", aes256cbc_functions },
135     { "AES-192-CBC", "default=yes", aes192cbc_functions },
136     { "AES-128-CBC", "default=yes", aes128cbc_functions },
137     { "AES-256-OFB", "default=yes", aes256ofb_functions },
138     { "AES-192-OFB", "default=yes", aes192ofb_functions },
139     { "AES-128-OFB", "default=yes", aes128ofb_functions },
140     { "AES-256-CFB", "default=yes", aes256cfb_functions },
141     { "AES-192-CFB", "default=yes", aes192cfb_functions },
142     { "AES-128-CFB", "default=yes", aes128cfb_functions },
143     { "AES-256-CFB1", "default=yes", aes256cfb1_functions },
144     { "AES-192-CFB1", "default=yes", aes192cfb1_functions },
145     { "AES-128-CFB1", "default=yes", aes128cfb1_functions },
146     { "AES-256-CFB8", "default=yes", aes256cfb8_functions },
147     { "AES-192-CFB8", "default=yes", aes192cfb8_functions },
148     { "AES-128-CFB8", "default=yes", aes128cfb8_functions },
149     { "AES-256-CTR", "default=yes", aes256ctr_functions },
150     { "AES-192-CTR", "default=yes", aes192ctr_functions },
151     { "AES-128-CTR", "default=yes", aes128ctr_functions },
152     { "AES-256-XTS", "default=yes", aes256xts_functions },
153     { "AES-128-XTS", "default=yes", aes128xts_functions },
154 #ifndef OPENSSL_NO_OCB
155     { "AES-256-OCB", "default=yes", aes256ocb_functions },
156     { "AES-192-OCB", "default=yes", aes192ocb_functions },
157     { "AES-128-OCB", "default=yes", aes128ocb_functions },
158 #endif /* OPENSSL_NO_OCB */
159     { "AES-256-GCM:id-aes256-GCM", "default=yes", aes256gcm_functions },
160     { "AES-192-GCM:id-aes192-GCM", "default=yes", aes192gcm_functions },
161     { "AES-128-GCM:id-aes128-GCM", "default=yes", aes128gcm_functions },
162     { "AES-256-CCM:id-aes256-CCM", "default=yes", aes256ccm_functions },
163     { "AES-192-CCM:id-aes192-CCM", "default=yes", aes192ccm_functions },
164     { "AES-128-CCM:id-aes128-CCM", "default=yes", aes128ccm_functions },
165     { "AES-256-WRAP:id-aes256-wrap:AES256-WRAP", "default=yes",
166       aes256wrap_functions },
167     { "AES-192-WRAP:id-aes192-wrap:AES192-WRAP", "default=yes",
168       aes192wrap_functions },
169     { "AES-128-WRAP:id-aes128-wrap:AES128-WRAP", "default=yes",
170       aes128wrap_functions },
171     { "AES-256-WRAP-PAD:id-aes256-wrap-pad:AES256-WRAP-PAD", "default=yes",
172       aes256wrappad_functions },
173     { "AES-192-WRAP-PAD:id-aes192-wrap-pad:AES192-WRAP-PAD", "default=yes",
174       aes192wrappad_functions },
175     { "AES-128-WRAP-PAD:id-aes128-wrap-pad:AES128-WRAP-PAD", "default=yes",
176       aes128wrappad_functions },
177 #ifndef OPENSSL_NO_ARIA
178     { "ARIA-256-GCM", "default=yes", aria256gcm_functions },
179     { "ARIA-192-GCM", "default=yes", aria192gcm_functions },
180     { "ARIA-128-GCM", "default=yes", aria128gcm_functions },
181     { "ARIA-256-CCM", "default=yes", aria256ccm_functions },
182     { "ARIA-192-CCM", "default=yes", aria192ccm_functions },
183     { "ARIA-128-CCM", "default=yes", aria128ccm_functions },
184     { "ARIA-256-ECB", "default=yes", aria256ecb_functions },
185     { "ARIA-192-ECB", "default=yes", aria192ecb_functions },
186     { "ARIA-128-ECB", "default=yes", aria128ecb_functions },
187     { "ARIA-256-CBC:ARIA256", "default=yes", aria256cbc_functions },
188     { "ARIA-192-CBC:ARIA192", "default=yes", aria192cbc_functions },
189     { "ARIA-128-CBC:ARIA128", "default=yes", aria128cbc_functions },
190     { "ARIA-256-OFB", "default=yes", aria256ofb_functions },
191     { "ARIA-192-OFB", "default=yes", aria192ofb_functions },
192     { "ARIA-128-OFB", "default=yes", aria128ofb_functions },
193     { "ARIA-256-CFB", "default=yes", aria256cfb_functions },
194     { "ARIA-192-CFB", "default=yes", aria192cfb_functions },
195     { "ARIA-128-CFB", "default=yes", aria128cfb_functions },
196     { "ARIA-256-CFB1", "default=yes", aria256cfb1_functions },
197     { "ARIA-192-CFB1", "default=yes", aria192cfb1_functions },
198     { "ARIA-128-CFB1", "default=yes", aria128cfb1_functions },
199     { "ARIA-256-CFB8", "default=yes", aria256cfb8_functions },
200     { "ARIA-192-CFB8", "default=yes", aria192cfb8_functions },
201     { "ARIA-128-CFB8", "default=yes", aria128cfb8_functions },
202     { "ARIA-256-CTR", "default=yes", aria256ctr_functions },
203     { "ARIA-192-CTR", "default=yes", aria192ctr_functions },
204     { "ARIA-128-CTR", "default=yes", aria128ctr_functions },
205 #endif /* OPENSSL_NO_ARIA */
206 #ifndef OPENSSL_NO_CAMELLIA
207     { "CAMELLIA-256-ECB", "default=yes", camellia256ecb_functions },
208     { "CAMELLIA-192-ECB", "default=yes", camellia192ecb_functions },
209     { "CAMELLIA-128-ECB", "default=yes", camellia128ecb_functions },
210     { "CAMELLIA-256-CBC:CAMELLIA256", "default=yes", camellia256cbc_functions },
211     { "CAMELLIA-192-CBC:CAMELLIA192", "default=yes", camellia192cbc_functions },
212     { "CAMELLIA-128-CBC:CAMELLIA128", "default=yes", camellia128cbc_functions },
213     { "CAMELLIA-256-OFB", "default=yes", camellia256ofb_functions },
214     { "CAMELLIA-192-OFB", "default=yes", camellia192ofb_functions },
215     { "CAMELLIA-128-OFB", "default=yes", camellia128ofb_functions },
216     { "CAMELLIA-256-CFB", "default=yes", camellia256cfb_functions },
217     { "CAMELLIA-192-CFB", "default=yes", camellia192cfb_functions },
218     { "CAMELLIA-128-CFB", "default=yes", camellia128cfb_functions },
219     { "CAMELLIA-256-CFB1", "default=yes", camellia256cfb1_functions },
220     { "CAMELLIA-192-CFB1", "default=yes", camellia192cfb1_functions },
221     { "CAMELLIA-128-CFB1", "default=yes", camellia128cfb1_functions },
222     { "CAMELLIA-256-CFB8", "default=yes", camellia256cfb8_functions },
223     { "CAMELLIA-192-CFB8", "default=yes", camellia192cfb8_functions },
224     { "CAMELLIA-128-CFB8", "default=yes", camellia128cfb8_functions },
225     { "CAMELLIA-256-CTR", "default=yes", camellia256ctr_functions },
226     { "CAMELLIA-192-CTR", "default=yes", camellia192ctr_functions },
227     { "CAMELLIA-128-CTR", "default=yes", camellia128ctr_functions },
228 #endif /* OPENSSL_NO_CAMELLIA */
229 #ifndef OPENSSL_NO_DES
230     { "DES-EDE3-ECB:DES-EDE3", "default=yes", tdes_ede3_ecb_functions },
231     { "DES-EDE3-CBC:DES3", "default=yes", tdes_ede3_cbc_functions },
232     { "DES-EDE3-OFB", "default=yes", tdes_ede3_ofb_functions },
233     { "DES-EDE3-CFB", "default=yes", tdes_ede3_cfb_functions },
234     { "DES-EDE3-CFB8", "default=yes", tdes_ede3_cfb8_functions },
235     { "DES-EDE3-CFB1", "default=yes", tdes_ede3_cfb1_functions },
236     { "DES-EDE-ECB:DES-EDE", "default=yes", tdes_ede2_ecb_functions },
237     { "DES-EDE-CBC", "default=yes", tdes_ede2_cbc_functions },
238     { "DES-EDE-OFB", "default=yes", tdes_ede2_ofb_functions },
239     { "DES-EDE-CFB", "default=yes", tdes_ede2_cfb_functions },
240     { "DESX-CBC:DESX", "default=yes", tdes_desx_cbc_functions },
241     { "DES3-WRAP:id-smime-alg-CMS3DESwrap", "default=yes", tdes_wrap_cbc_functions },
242     { "DES-ECB", "default=yes", des_ecb_functions },
243     { "DES-CBC:DES", "default=yes", des_cbc_functions },
244     { "DES-OFB", "default=yes", des_ofb64_functions },
245     { "DES-CFB", "default=yes", des_cfb64_functions },
246     { "DES-CFB1", "default=yes", des_cfb1_functions },
247     { "DES-CFB8", "default=yes", des_cfb8_functions },
248 #endif /* OPENSSL_NO_DES */
249 #ifndef OPENSSL_NO_BF
250     { "BF-ECB", "default=yes", blowfish128ecb_functions },
251     { "BF-CBC:BF:BLOWFISH", "default=yes", blowfish128cbc_functions },
252     { "BF-OFB", "default=yes", blowfish64ofb64_functions },
253     { "BF-CFB", "default=yes", blowfish64cfb64_functions },
254 #endif /* OPENSSL_NO_BF */
255 #ifndef OPENSSL_NO_IDEA
256     { "IDEA-ECB", "default=yes", idea128ecb_functions },
257     { "IDEA-CBC:IDEA", "default=yes", idea128cbc_functions },
258     { "IDEA-OFB:IDEA-OFB64", "default=yes", idea128ofb64_functions },
259     { "IDEA-CFB:IDEA-CFB64", "default=yes", idea128cfb64_functions },
260 #endif /* OPENSSL_NO_IDEA */
261 #ifndef OPENSSL_NO_CAST
262     { "CAST5-ECB", "default=yes", cast5128ecb_functions },
263     { "CAST5-CBC:CAST-CBC:CAST", "default=yes", cast5128cbc_functions },
264     { "CAST5-OFB", "default=yes", cast564ofb64_functions },
265     { "CAST5-CFB", "default=yes", cast564cfb64_functions },
266 #endif /* OPENSSL_NO_CAST */
267 #ifndef OPENSSL_NO_SEED
268     { "SEED-ECB", "default=yes", seed128ecb_functions },
269     { "SEED-CBC:SEED", "default=yes", seed128cbc_functions },
270     { "SEED-OFB:SEED-OFB128", "default=yes", seed128ofb128_functions },
271     { "SEED-CFB:SEED-CFB128", "default=yes", seed128cfb128_functions },
272 #endif /* OPENSSL_NO_SEED */
273 #ifndef OPENSSL_NO_SM4
274     { "SM4-ECB", "default=yes", sm4128ecb_functions },
275     { "SM4-CBC:SM4", "default=yes", sm4128cbc_functions },
276     { "SM4-CTR", "default=yes", sm4128ctr_functions },
277     { "SM4-OFB:SM4-OFB128", "default=yes", sm4128ofb128_functions },
278     { "SM4-CFB:SM4-CFB128", "default=yes", sm4128cfb128_functions },
279 #endif /* OPENSSL_NO_SM4 */
280 #ifndef OPENSSL_NO_RC4
281     { "RC4", "default=yes", rc4128_functions },
282     { "RC4-40", "default=yes", rc440_functions },
283 #endif /* OPENSSL_NO_RC4 */
284 #ifndef OPENSSL_NO_RC5
285     { "RC5-ECB", "default=yes", rc5128ecb_functions },
286     { "RC5-CBC", "default=yes", rc5128cbc_functions },
287     { "RC5-OFB", "default=yes", rc5128ofb64_functions },
288     { "RC5-CFB", "default=yes", rc5128cfb64_functions },
289 #endif /* OPENSSL_NO_RC5 */
290 #ifndef OPENSSL_NO_RC2
291     { "RC2-ECB", "default=yes", rc2128ecb_functions },
292     { "RC2-CBC", "default=yes", rc2128cbc_functions },
293     { "RC2-40-CBC", "default=yes", rc240cbc_functions },
294     { "RC2-64-CBC", "default=yes", rc264cbc_functions },
295     { "RC2-CFB", "default=yes", rc2128cfb128_functions },
296     { "RC2-OFB", "default=yes", rc2128ofb128_functions },
297 #endif /* OPENSSL_NO_RC2 */
298     { NULL, NULL, NULL }
299 };
300
301 static const OSSL_ALGORITHM deflt_macs[] = {
302 #ifndef OPENSSL_NO_BLAKE2
303     { "BLAKE2bMAC", "default=yes", blake2bmac_functions },
304     { "BLAKE2sMAC", "default=yes", blake2smac_functions },
305 #endif
306 #ifndef OPENSSL_NO_CMAC
307     { "CMAC", "default=yes", cmac_functions },
308 #endif
309     { "GMAC", "default=yes", gmac_functions },
310     { "HMAC", "default=yes", hmac_functions },
311     { "KMAC128", "default=yes", kmac128_functions },
312     { "KMAC256", "default=yes", kmac256_functions },
313 #ifndef OPENSSL_NO_SIPHASH
314     { "SipHash", "default=yes", siphash_functions },
315 #endif
316 #ifndef OPENSSL_NO_POLY1305
317     { "Poly1305", "default=yes", poly1305_functions },
318 #endif
319     { NULL, NULL, NULL }
320 };
321
322 static const OSSL_ALGORITHM deflt_kdfs[] = {
323     { OSSL_KDF_NAME_HKDF, "default=yes", kdf_hkdf_functions },
324     { OSSL_KDF_NAME_SSKDF, "default=yes", kdf_sskdf_functions },
325     { OSSL_KDF_NAME_PBKDF2, "default=yes", kdf_pbkdf2_functions },
326     { OSSL_KDF_NAME_SSHKDF, "default=yes", kdf_sshkdf_functions },
327     { OSSL_KDF_NAME_X963KDF, "default=yes", kdf_x963_kdf_functions },
328     { OSSL_KDF_NAME_TLS1_PRF, "default=yes", kdf_tls1_prf_functions },
329     { OSSL_KDF_NAME_KBKDF, "default=yes", kdf_kbkdf_functions },
330 #ifndef OPENSSL_NO_CMS
331     { OSSL_KDF_NAME_X942KDF, "default=yes", kdf_x942_kdf_functions },
332 #endif
333 #ifndef OPENSSL_NO_SCRYPT
334     { "SCRYPT:id-scrypt", "default=yes", kdf_scrypt_functions },
335 #endif
336    { NULL, NULL, NULL }
337 };
338
339 static const OSSL_ALGORITHM deflt_keyexch[] = {
340 #ifndef OPENSSL_NO_DH
341     { "DH:dhKeyAgreement", "default=yes", dh_keyexch_functions },
342 #endif
343     { NULL, NULL, NULL }
344 };
345
346 static const OSSL_ALGORITHM deflt_signature[] = {
347 #ifndef OPENSSL_NO_DSA
348     { "DSA:dsaEncryption", "default=yes", dsa_signature_functions },
349 #endif
350     { NULL, NULL, NULL }
351 };
352
353
354 static const OSSL_ALGORITHM deflt_keymgmt[] = {
355 #ifndef OPENSSL_NO_DH
356     { "DH", "default=yes", dh_keymgmt_functions },
357 #endif
358 #ifndef OPENSSL_NO_DSA
359     { "DSA", "default=yes", dsa_keymgmt_functions },
360 #endif
361     { NULL, NULL, NULL }
362 };
363
364 static const OSSL_ALGORITHM *deflt_query(OSSL_PROVIDER *prov,
365                                          int operation_id,
366                                          int *no_cache)
367 {
368     *no_cache = 0;
369     switch (operation_id) {
370     case OSSL_OP_DIGEST:
371         return deflt_digests;
372     case OSSL_OP_CIPHER:
373         return deflt_ciphers;
374     case OSSL_OP_MAC:
375         return deflt_macs;
376     case OSSL_OP_KDF:
377         return deflt_kdfs;
378     case OSSL_OP_KEYMGMT:
379         return deflt_keymgmt;
380     case OSSL_OP_KEYEXCH:
381         return deflt_keyexch;
382     case OSSL_OP_SIGNATURE:
383         return deflt_signature;
384     }
385     return NULL;
386 }
387
388 /* Functions we provide to the core */
389 static const OSSL_DISPATCH deflt_dispatch_table[] = {
390     { OSSL_FUNC_PROVIDER_GETTABLE_PARAMS, (void (*)(void))deflt_gettable_params },
391     { OSSL_FUNC_PROVIDER_GET_PARAMS, (void (*)(void))deflt_get_params },
392     { OSSL_FUNC_PROVIDER_QUERY_OPERATION, (void (*)(void))deflt_query },
393     { 0, NULL }
394 };
395
396 OSSL_provider_init_fn ossl_default_provider_init;
397
398 int ossl_default_provider_init(const OSSL_PROVIDER *provider,
399                                const OSSL_DISPATCH *in,
400                                const OSSL_DISPATCH **out,
401                                void **provctx)
402 {
403     OSSL_core_get_library_context_fn *c_get_libctx = NULL;
404
405     for (; in->function_id != 0; in++) {
406         switch (in->function_id) {
407         case OSSL_FUNC_CORE_GETTABLE_PARAMS:
408             c_gettable_params = OSSL_get_core_gettable_params(in);
409             break;
410         case OSSL_FUNC_CORE_GET_PARAMS:
411             c_get_params = OSSL_get_core_get_params(in);
412             break;
413         case OSSL_FUNC_CORE_GET_LIBRARY_CONTEXT:
414             c_get_libctx = OSSL_get_core_get_library_context(in);
415             break;
416         default:
417             /* Just ignore anything we don't understand */
418             break;
419         }
420     }
421
422     if (c_get_libctx == NULL)
423         return 0;
424
425     *out = deflt_dispatch_table;
426
427     /*
428      * We want to make sure that all calls from this provider that requires
429      * a library context use the same context as the one used to call our
430      * functions.  We do that by passing it along as the provider context.
431      */
432     *provctx = c_get_libctx(provider);
433     return 1;
434 }