mirror of
https://github.com/openssl/openssl.git
synced 2024-12-09 05:51:54 +08:00
05aa8790ac
The provider context structure is made to include the following information: - The core provider handle (first argument to the provider init function). This handle is meant to be used in all upcalls that need it. - A library context, used for any libcrypto calls that need it, done in the provider itself. Regarding the library context, that's generally only needed if the provider makes any libcrypto calls, i.e. is linked with libcrypto. That happens to be the case for all OpenSSL providers, but is applicable for other providers that use libcrypto internally as well. The normal thing to do for a provider init function is to create its own library context. For a provider that's meant to become a dynamically loadable module, this is what MUST be done. However, we do not do that in the default provider; it uses the library context associated with the core provider handle instead. This is permissible, although generally discouraged, as long as the provider in question is guaranteed to be built-in, into libcrypto or into the application that uses it. Reviewed-by: Matt Caswell <matt@openssl.org> (Merged from https://github.com/openssl/openssl/pull/11803)
31 lines
1.0 KiB
C
31 lines
1.0 KiB
C
/*
|
|
* Copyright 2019 The OpenSSL Project Authors. All Rights Reserved.
|
|
*
|
|
* Licensed under the Apache License 2.0 (the "License"). You may not use
|
|
* this file except in compliance with the License. You can obtain a copy
|
|
* in the file LICENSE in the source distribution or at
|
|
* https://www.openssl.org/source/license.html
|
|
*/
|
|
|
|
#include <openssl/types.h>
|
|
#include <openssl/crypto.h>
|
|
|
|
typedef struct prov_ctx_st {
|
|
const OSSL_PROVIDER *provider;
|
|
OPENSSL_CTX *libctx; /* For all provider modules */
|
|
} PROV_CTX;
|
|
|
|
/*
|
|
* To be used anywhere the library context needs to be passed, such as to
|
|
* fetching functions.
|
|
*/
|
|
#define PROV_LIBRARY_CONTEXT_OF(provctx) \
|
|
PROV_CTX_get0_library_context((provctx))
|
|
|
|
PROV_CTX *PROV_CTX_new(void);
|
|
void PROV_CTX_free(PROV_CTX *ctx);
|
|
void PROV_CTX_set0_library_context(PROV_CTX *ctx, OPENSSL_CTX *libctx);
|
|
void PROV_CTX_set0_provider(PROV_CTX *ctx, const OSSL_PROVIDER *libctx);
|
|
OPENSSL_CTX *PROV_CTX_get0_library_context(PROV_CTX *ctx);
|
|
const OSSL_PROVIDER *PROV_CTX_get0_provider(PROV_CTX *ctx);
|