mirror of
https://github.com/openssl/openssl.git
synced 2024-12-15 06:01:37 +08:00
e1eafe8c87
Introducing the concept of reserving the store where a number of provided operation methods are to be stored. This avoids racing when constructing provided methods, which is especially pertinent when multiple threads are trying to fetch the same method, or even any implementation for the same given operation type. This introduces a |biglock| in OSSL_METHOD_STORE, which is separate from the |lock| which is used for more internal and finer grained locking. Fixes #18152 Reviewed-by: Hugo Landau <hlandau@openssl.org> Reviewed-by: Tomas Mraz <tomas@openssl.org> (Merged from https://github.com/openssl/openssl/pull/18153)
72 lines
3.0 KiB
C
72 lines
3.0 KiB
C
/*
|
|
* Copyright 2019-2022 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
|
|
*/
|
|
|
|
#ifndef OSSL_INTERNAL_CORE_H
|
|
# define OSSL_INTERNAL_CORE_H
|
|
# pragma once
|
|
|
|
/*
|
|
* namespaces:
|
|
*
|
|
* ossl_method_ Core Method API
|
|
*/
|
|
|
|
/*
|
|
* construct an arbitrary method from a dispatch table found by looking
|
|
* up a match for the < operation_id, name, property > combination.
|
|
* constructor and destructor are the constructor and destructor for that
|
|
* arbitrary object.
|
|
*
|
|
* These objects are normally cached, unless the provider says not to cache.
|
|
* However, force_cache can be used to force caching whatever the provider
|
|
* says (for example, because the application knows better).
|
|
*/
|
|
typedef struct ossl_method_construct_method_st {
|
|
/* Get a temporary store */
|
|
void *(*get_tmp_store)(void *data);
|
|
/* Reserve the appropriate method store */
|
|
int (*lock_store)(void *store, void *data);
|
|
/* Unreserve the appropriate method store */
|
|
int (*unlock_store)(void *store, void *data);
|
|
/* Get an already existing method from a store */
|
|
void *(*get)(void *store, const OSSL_PROVIDER **prov, void *data);
|
|
/* Store a method in a store */
|
|
int (*put)(void *store, void *method, const OSSL_PROVIDER *prov,
|
|
const char *name, const char *propdef, void *data);
|
|
/* Construct a new method */
|
|
void *(*construct)(const OSSL_ALGORITHM *algodef, OSSL_PROVIDER *prov,
|
|
void *data);
|
|
/* Destruct a method */
|
|
void (*destruct)(void *method, void *data);
|
|
} OSSL_METHOD_CONSTRUCT_METHOD;
|
|
|
|
void *ossl_method_construct(OSSL_LIB_CTX *ctx, int operation_id,
|
|
OSSL_PROVIDER **provider_rw, int force_cache,
|
|
OSSL_METHOD_CONSTRUCT_METHOD *mcm, void *mcm_data);
|
|
|
|
void ossl_algorithm_do_all(OSSL_LIB_CTX *libctx, int operation_id,
|
|
OSSL_PROVIDER *provider,
|
|
int (*pre)(OSSL_PROVIDER *, int operation_id,
|
|
int no_store, void *data, int *result),
|
|
int (*reserve_store)(int no_store, void *data),
|
|
void (*fn)(OSSL_PROVIDER *provider,
|
|
const OSSL_ALGORITHM *algo,
|
|
int no_store, void *data),
|
|
int (*unreserve_store)(void *data),
|
|
int (*post)(OSSL_PROVIDER *, int operation_id,
|
|
int no_store, void *data, int *result),
|
|
void *data);
|
|
char *ossl_algorithm_get1_first_name(const OSSL_ALGORITHM *algo);
|
|
|
|
__owur int ossl_lib_ctx_write_lock(OSSL_LIB_CTX *ctx);
|
|
__owur int ossl_lib_ctx_read_lock(OSSL_LIB_CTX *ctx);
|
|
int ossl_lib_ctx_unlock(OSSL_LIB_CTX *ctx);
|
|
int ossl_lib_ctx_is_child(OSSL_LIB_CTX *ctx);
|
|
#endif
|