aboutsummaryrefslogtreecommitdiff
path: root/secure/lib/libcrypto/man/man3/OSSL_STORE_LOADER.3
diff options
context:
space:
mode:
Diffstat (limited to 'secure/lib/libcrypto/man/man3/OSSL_STORE_LOADER.3')
-rw-r--r--secure/lib/libcrypto/man/man3/OSSL_STORE_LOADER.3282
1 files changed, 210 insertions, 72 deletions
diff --git a/secure/lib/libcrypto/man/man3/OSSL_STORE_LOADER.3 b/secure/lib/libcrypto/man/man3/OSSL_STORE_LOADER.3
index a2d1eae202c3..ee48211472ea 100644
--- a/secure/lib/libcrypto/man/man3/OSSL_STORE_LOADER.3
+++ b/secure/lib/libcrypto/man/man3/OSSL_STORE_LOADER.3
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
+.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -68,8 +68,6 @@
. \}
.\}
.rr rF
-.\"
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
. \" fudge factors for nroff and troff
.if n \{\
@@ -132,14 +130,37 @@
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
-.IX Title "OSSL_STORE_LOADER 3"
-.TH OSSL_STORE_LOADER 3 "2022-05-03" "1.1.1o" "OpenSSL"
+.IX Title "OSSL_STORE_LOADER 3ossl"
+.TH OSSL_STORE_LOADER 3ossl "2023-09-19" "3.0.11" "OpenSSL"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
-OSSL_STORE_LOADER, OSSL_STORE_LOADER_CTX, OSSL_STORE_LOADER_new, OSSL_STORE_LOADER_get0_engine, OSSL_STORE_LOADER_get0_scheme, OSSL_STORE_LOADER_set_open, OSSL_STORE_LOADER_set_ctrl, OSSL_STORE_LOADER_set_expect, OSSL_STORE_LOADER_set_find, OSSL_STORE_LOADER_set_load, OSSL_STORE_LOADER_set_eof, OSSL_STORE_LOADER_set_error, OSSL_STORE_LOADER_set_close, OSSL_STORE_LOADER_free, OSSL_STORE_register_loader, OSSL_STORE_unregister_loader, OSSL_STORE_open_fn, OSSL_STORE_ctrl_fn, OSSL_STORE_expect_fn, OSSL_STORE_find_fn, OSSL_STORE_load_fn, OSSL_STORE_eof_fn, OSSL_STORE_error_fn, OSSL_STORE_close_fn \- Types and functions to manipulate, register and unregister STORE loaders for different URI schemes
+OSSL_STORE_LOADER,
+OSSL_STORE_LOADER_fetch,
+OSSL_STORE_LOADER_up_ref,
+OSSL_STORE_LOADER_free,
+OSSL_STORE_LOADER_get0_provider,
+OSSL_STORE_LOADER_get0_properties,
+OSSL_STORE_LOADER_is_a,
+OSSL_STORE_LOADER_get0_description,
+OSSL_STORE_LOADER_do_all_provided,
+OSSL_STORE_LOADER_names_do_all,
+OSSL_STORE_LOADER_CTX, OSSL_STORE_LOADER_new,
+OSSL_STORE_LOADER_get0_engine, OSSL_STORE_LOADER_get0_scheme,
+OSSL_STORE_LOADER_set_open, OSSL_STORE_LOADER_set_open_ex,
+OSSL_STORE_LOADER_set_attach, OSSL_STORE_LOADER_set_ctrl,
+OSSL_STORE_LOADER_set_expect, OSSL_STORE_LOADER_set_find,
+OSSL_STORE_LOADER_set_load, OSSL_STORE_LOADER_set_eof,
+OSSL_STORE_LOADER_set_error, OSSL_STORE_LOADER_set_close,
+OSSL_STORE_register_loader, OSSL_STORE_unregister_loader,
+OSSL_STORE_open_fn, OSSL_STORE_open_ex_fn,
+OSSL_STORE_attach_fn, OSSL_STORE_ctrl_fn,
+OSSL_STORE_expect_fn, OSSL_STORE_find_fn,
+OSSL_STORE_load_fn, OSSL_STORE_eof_fn, OSSL_STORE_error_fn,
+OSSL_STORE_close_fn \- Types and functions to manipulate, register and
+unregister STORE loaders for different URI schemes
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
@@ -147,6 +168,31 @@ OSSL_STORE_LOADER, OSSL_STORE_LOADER_CTX, OSSL_STORE_LOADER_new, OSSL_STORE_LOAD
\&
\& typedef struct ossl_store_loader_st OSSL_STORE_LOADER;
\&
+\& OSSL_STORE_LOADER *OSSL_STORE_LOADER_fetch(OSSL_LIB_CTX *libctx,
+\& const char *scheme,
+\& const char *properties);
+\& int OSSL_STORE_LOADER_up_ref(OSSL_STORE_LOADER *loader);
+\& void OSSL_STORE_LOADER_free(OSSL_STORE_LOADER *loader);
+\& const OSSL_PROVIDER *OSSL_STORE_LOADER_get0_provider(const OSSL_STORE_LOADER *
+\& loader);
+\& const char *OSSL_STORE_LOADER_get0_properties(const OSSL_STORE_LOADER *loader);
+\& const char *OSSL_STORE_LOADER_get0_description(const OSSL_STORE_LOADER *loader);
+\& int OSSL_STORE_LOADER_is_a(const OSSL_STORE_LOADER *loader,
+\& const char *scheme);
+\& void OSSL_STORE_LOADER_do_all_provided(OSSL_LIB_CTX *libctx,
+\& void (*user_fn)(OSSL_STORE_LOADER *loader,
+\& void *arg),
+\& void *user_arg);
+\& int OSSL_STORE_LOADER_names_do_all(const OSSL_STORE_LOADER *loader,
+\& void (*fn)(const char *name, void *data),
+\& void *data);
+.Ve
+.PP
+The following functions have been deprecated since OpenSSL 3.0, and can be
+hidden entirely by defining \fB\s-1OPENSSL_API_COMPAT\s0\fR with a suitable version value,
+see \fBopenssl_user_macros\fR\|(7):
+.PP
+.Vb 5
\& OSSL_STORE_LOADER *OSSL_STORE_LOADER_new(ENGINE *e, const char *scheme);
\& const ENGINE *OSSL_STORE_LOADER_get0_engine(const OSSL_STORE_LOADER
\& *store_loader);
@@ -156,11 +202,21 @@ OSSL_STORE_LOADER, OSSL_STORE_LOADER_CTX, OSSL_STORE_LOADER_new, OSSL_STORE_LOAD
\& /* struct ossl_store_loader_ctx_st is defined differently by each loader */
\& typedef struct ossl_store_loader_ctx_st OSSL_STORE_LOADER_CTX;
\&
-\& typedef OSSL_STORE_LOADER_CTX *(*OSSL_STORE_open_fn)(const char *uri,
-\& const UI_METHOD *ui_method,
-\& void *ui_data);
+\& typedef OSSL_STORE_LOADER_CTX *(*OSSL_STORE_open_fn)(
+\& const char *uri, const UI_METHOD *ui_method, void *ui_data);
\& int OSSL_STORE_LOADER_set_open(OSSL_STORE_LOADER *store_loader,
\& OSSL_STORE_open_fn store_open_function);
+\& typedef OSSL_STORE_LOADER_CTX *(*OSSL_STORE_open_ex_fn)(
+\& const char *uri, const UI_METHOD *ui_method, void *ui_data);
+\& int OSSL_STORE_LOADER_set_open_ex
+\& (OSSL_STORE_LOADER *store_loader,
+\& OSSL_STORE_open_ex_fn store_open_ex_function);
+\& typedef OSSL_STORE_LOADER_CTX *(*OSSL_STORE_attach_fn)
+\& (const OSSL_STORE_LOADER *loader, BIO *bio,
+\& OSSL_LIB_CTX *libctx, const char *propq,
+\& const UI_METHOD *ui_method, void *ui_data);
+\& int OSSL_STORE_LOADER_set_attach(OSSL_STORE_LOADER *loader,
+\& OSSL_STORE_attach_fn attach_function);
\& typedef int (*OSSL_STORE_ctrl_fn)(OSSL_STORE_LOADER_CTX *ctx, int cmd,
\& va_list args);
\& int OSSL_STORE_LOADER_set_ctrl(OSSL_STORE_LOADER *store_loader,
@@ -193,37 +249,79 @@ OSSL_STORE_LOADER, OSSL_STORE_LOADER_CTX, OSSL_STORE_LOADER_new, OSSL_STORE_LOAD
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
+\&\fB\s-1OSSL_STORE_LOADER\s0\fR is a method for \s-1OSSL_STORE\s0 loaders, which implement
+\&\fBOSSL_STORE_open()\fR, \fBOSSL_STORE_open_ex()\fR, \fBOSSL_STORE_load()\fR,
+\&\fBOSSL_STORE_eof()\fR, \fBOSSL_STORE_error()\fR and \fBOSSL_STORE_close()\fR for specific
+storage schemes.
+.PP
+\&\fBOSSL_STORE_LOADER_fetch()\fR looks for an implementation for a storage
+\&\fIscheme\fR within the providers that has been loaded into the \fB\s-1OSSL_LIB_CTX\s0\fR
+given by \fIlibctx\fR, and with the properties given by \fIproperties\fR.
+.PP
+\&\fBOSSL_STORE_LOADER_up_ref()\fR increments the reference count for the given
+\&\fIloader\fR.
+.PP
+\&\fBOSSL_STORE_LOADER_free()\fR decrements the reference count for the given
+\&\fIloader\fR, and when the count reaches zero, frees it.
+.PP
+\&\fBOSSL_STORE_LOADER_get0_provider()\fR returns the provider of the given
+\&\fIloader\fR.
+.PP
+\&\fBOSSL_STORE_LOADER_get0_properties()\fR returns the property definition associated
+with the given \fIloader\fR.
+.PP
+\&\fBOSSL_STORE_LOADER_is_a()\fR checks if \fIloader\fR is an implementation
+of an algorithm that's identifiable with \fIscheme\fR.
+.PP
+\&\fBOSSL_STORE_LOADER_get0_description()\fR returns a description of the \fIloader\fR, meant
+for display and human consumption. The description is at the discretion of the
+\&\fIloader\fR implementation.
+.PP
+\&\fBOSSL_STORE_LOADER_do_all_provided()\fR traverses all store implementations
+by all activated providers in the library context \fIlibctx\fR, and for each
+of the implementations, calls \fIuser_fn\fR with the implementation method and
+\&\fIuser_arg\fR as arguments.
+.PP
+\&\fBOSSL_STORE_LOADER_names_do_all()\fR traverses all names for the given
+\&\fIloader\fR, and calls \fIfn\fR with each name and \fIdata\fR.
+.SS "Legacy Types and Functions (deprecated)"
+.IX Subsection "Legacy Types and Functions (deprecated)"
These functions help applications and engines to create loaders for
-schemes they support.
-.SS "Types"
-.IX Subsection "Types"
-\&\fB\s-1OSSL_STORE_LOADER\s0\fR is the type to hold a loader.
-It contains a scheme and the functions needed to implement
-\&\fBOSSL_STORE_open()\fR, \fBOSSL_STORE_load()\fR, \fBOSSL_STORE_eof()\fR, \fBOSSL_STORE_error()\fR and
-\&\fBOSSL_STORE_close()\fR for this scheme.
+schemes they support. These are all deprecated and discouraged in favour of
+provider implementations, see \fBprovider\-storemgmt\fR\|(7).
.PP
\&\fB\s-1OSSL_STORE_LOADER_CTX\s0\fR is a type template, to be defined by each loader
-using \fBstruct ossl_store_loader_ctx_st { ... }\fR.
+using \f(CW\*(C`struct ossl_store_loader_ctx_st { ... }\*(C'\fR.
.PP
-\&\fBOSSL_STORE_open_fn\fR, \fBOSSL_STORE_ctrl_fn\fR, \fBOSSL_STORE_expect_fn\fR,
-\&\fBOSSL_STORE_find_fn\fR, \fBOSSL_STORE_load_fn\fR, \fBOSSL_STORE_eof_fn\fR,
-and \fBOSSL_STORE_close_fn\fR
+\&\fBOSSL_STORE_open_fn\fR, \fBOSSL_STORE_open_ex_fn\fR,
+\&\fBOSSL_STORE_ctrl_fn\fR, \fBOSSL_STORE_expect_fn\fR, \fBOSSL_STORE_find_fn\fR,
+\&\fBOSSL_STORE_load_fn\fR, \fBOSSL_STORE_eof_fn\fR, and \fBOSSL_STORE_close_fn\fR
are the function pointer types used within a \s-1STORE\s0 loader.
The functions pointed at define the functionality of the given loader.
-.IP "\fBOSSL_STORE_open_fn\fR" 4
-.IX Item "OSSL_STORE_open_fn"
-This function takes a \s-1URI\s0 and is expected to interpret it in the best
-manner possible according to the scheme the loader implements, it also
-takes a \fB\s-1UI_METHOD\s0\fR and associated data, to be used any time
-something needs to be prompted for.
+.IP "\fBOSSL_STORE_open_fn\fR and \fBOSSL_STORE_open_ex_fn\fR" 4
+.IX Item "OSSL_STORE_open_fn and OSSL_STORE_open_ex_fn"
+\&\fBOSSL_STORE_open_ex_fn\fR takes a \s-1URI\s0 and is expected to
+interpret it in the best manner possible according to the scheme the
+loader implements. It also takes a \fB\s-1UI_METHOD\s0\fR and associated data,
+to be used any time something needs to be prompted for, as well as a
+library context \fIlibctx\fR with an associated property query \fIpropq\fR,
+to be used when fetching necessary algorithms to perform the loads.
Furthermore, this function is expected to initialize what needs to be
-initialized, to create a private data store (\fB\s-1OSSL_STORE_LOADER_CTX\s0\fR, see
-above), and to return it.
+initialized, to create a private data store (\fB\s-1OSSL_STORE_LOADER_CTX\s0\fR,
+see above), and to return it.
If something goes wrong, this function is expected to return \s-1NULL.\s0
+.Sp
+\&\fBOSSL_STORE_open_fn\fR does the same thing as
+\&\fBOSSL_STORE_open_ex_fn\fR but uses \s-1NULL\s0 for the library
+context \fIlibctx\fR and property query \fIpropq\fR.
+.IP "\fBOSSL_STORE_attach_fn\fR" 4
+.IX Item "OSSL_STORE_attach_fn"
+This function takes a \fB\s-1BIO\s0\fR, otherwise works like
+\&\fBOSSL_STORE_open_ex_fn\fR.
.IP "\fBOSSL_STORE_ctrl_fn\fR" 4
.IX Item "OSSL_STORE_ctrl_fn"
This function takes a \fB\s-1OSSL_STORE_LOADER_CTX\s0\fR pointer, a command number
-\&\fBcmd\fR and a \fBva_list\fR \fBargs\fR and is used to manipulate loader
+\&\fIcmd\fR and a \fBva_list\fR \fIargs\fR and is used to manipulate loader
specific parameters.
.Sp
Loader specific command numbers must begin at \fB\s-1OSSL_STORE_C_CUSTOM_START\s0\fR.
@@ -234,9 +332,9 @@ This function is expected to return 1 on success, 0 on error.
.IP "\fBOSSL_STORE_expect_fn\fR" 4
.IX Item "OSSL_STORE_expect_fn"
This function takes a \fB\s-1OSSL_STORE_LOADER_CTX\s0\fR pointer and a \fB\s-1OSSL_STORE_INFO\s0\fR
-identity \fBexpected\fR, and is used to tell the loader what object type is
+identity \fIexpected\fR, and is used to tell the loader what object type is
expected.
-\&\fBexpected\fR may be zero to signify that no specific object type is expected.
+\&\fIexpected\fR may be zero to signify that no specific object type is expected.
.Sp
This function is expected to return 1 on success, 0 on error.
.IP "\fBOSSL_STORE_find_fn\fR" 4
@@ -245,10 +343,10 @@ This function takes a \fB\s-1OSSL_STORE_LOADER_CTX\s0\fR pointer and a
\&\fB\s-1OSSL_STORE_SEARCH\s0\fR search criterion, and is used to tell the loader what
to search for.
.Sp
-When called with the loader context being \fB\s-1NULL\s0\fR, this function is expected
+When called with the loader context being \s-1NULL,\s0 this function is expected
to return 1 if the loader supports the criterion, otherwise 0.
.Sp
-When called with the loader context being something other than \fB\s-1NULL\s0\fR, this
+When called with the loader context being something other than \s-1NULL,\s0 this
function is expected to return 1 on success, 0 on error.
.IP "\fBOSSL_STORE_load_fn\fR" 4
.IX Item "OSSL_STORE_load_fn"
@@ -280,83 +378,123 @@ This function takes a \fB\s-1OSSL_STORE_LOADER_CTX\s0\fR pointer and is expected
close or shut down what needs to be closed, and finally free the
contents of the \fB\s-1OSSL_STORE_LOADER_CTX\s0\fR pointer.
It returns 1 on success and 0 on error.
-.SS "Functions"
-.IX Subsection "Functions"
+.PP
\&\fBOSSL_STORE_LOADER_new()\fR creates a new \fB\s-1OSSL_STORE_LOADER\s0\fR.
-It takes an \fB\s-1ENGINE\s0\fR \fBe\fR and a string \fBscheme\fR.
-\&\fBscheme\fR must \fIalways\fR be set.
-Both \fBe\fR and \fBscheme\fR are used as is and must therefore be alive as
+It takes an \fB\s-1ENGINE\s0\fR \fIe\fR and a string \fIscheme\fR.
+\&\fIscheme\fR must \fIalways\fR be set.
+Both \fIe\fR and \fIscheme\fR are used as is and must therefore be alive as
long as the created loader is.
.PP
-\&\fBOSSL_STORE_LOADER_get0_engine()\fR returns the engine of the \fBstore_loader\fR.
-\&\fBOSSL_STORE_LOADER_get0_scheme()\fR returns the scheme of the \fBstore_loader\fR.
+\&\fBOSSL_STORE_LOADER_get0_engine()\fR returns the engine of the \fIstore_loader\fR.
+\&\fBOSSL_STORE_LOADER_get0_scheme()\fR returns the scheme of the \fIstore_loader\fR.
.PP
\&\fBOSSL_STORE_LOADER_set_open()\fR sets the opener function for the
-\&\fBstore_loader\fR.
+\&\fIstore_loader\fR.
+.PP
+\&\fBOSSL_STORE_LOADER_set_open_ex()\fR sets the opener with library context
+function for the \fIstore_loader\fR.
+.PP
+\&\fBOSSL_STORE_LOADER_set_attach()\fR sets the attacher function for the
+\&\fIstore_loader\fR.
.PP
\&\fBOSSL_STORE_LOADER_set_ctrl()\fR sets the control function for the
-\&\fBstore_loader\fR.
+\&\fIstore_loader\fR.
.PP
\&\fBOSSL_STORE_LOADER_set_expect()\fR sets the expect function for the
-\&\fBstore_loader\fR.
+\&\fIstore_loader\fR.
.PP
\&\fBOSSL_STORE_LOADER_set_load()\fR sets the loader function for the
-\&\fBstore_loader\fR.
+\&\fIstore_loader\fR.
.PP
\&\fBOSSL_STORE_LOADER_set_eof()\fR sets the end of file checker function for the
-\&\fBstore_loader\fR.
+\&\fIstore_loader\fR.
.PP
\&\fBOSSL_STORE_LOADER_set_close()\fR sets the closing function for the
-\&\fBstore_loader\fR.
+\&\fIstore_loader\fR.
.PP
-\&\fBOSSL_STORE_LOADER_free()\fR frees the given \fBstore_loader\fR.
+\&\fBOSSL_STORE_LOADER_free()\fR frees the given \fIstore_loader\fR.
.PP
-\&\fBOSSL_STORE_register_loader()\fR register the given \fBstore_loader\fR and thereby
-makes it available for use with \fBOSSL_STORE_open()\fR, \fBOSSL_STORE_load()\fR,
-\&\fBOSSL_STORE_eof()\fR and \fBOSSL_STORE_close()\fR.
+\&\fBOSSL_STORE_register_loader()\fR register the given \fIstore_loader\fR and
+thereby makes it available for use with \fBOSSL_STORE_open()\fR,
+\&\fBOSSL_STORE_open_ex()\fR, \fBOSSL_STORE_load()\fR, \fBOSSL_STORE_eof()\fR
+and \fBOSSL_STORE_close()\fR.
.PP
\&\fBOSSL_STORE_unregister_loader()\fR unregister the store loader for the given
-\&\fBscheme\fR.
-.SH "NOTES"
-.IX Header "NOTES"
-The \fBfile:\fR scheme has built in support.
+\&\fIscheme\fR.
.SH "RETURN VALUES"
.IX Header "RETURN VALUES"
-The functions with the types \fBOSSL_STORE_open_fn\fR, \fBOSSL_STORE_ctrl_fn\fR,
-\&\fBOSSL_STORE_expect_fn\fR,
-\&\fBOSSL_STORE_load_fn\fR, \fBOSSL_STORE_eof_fn\fR and \fBOSSL_STORE_close_fn\fR have the
-same return values as \fBOSSL_STORE_open()\fR, \fBOSSL_STORE_ctrl()\fR, \fBOSSL_STORE_expect()\fR,
+\&\fBOSSL_STORE_LOADER_fetch()\fR returns a pointer to an \s-1OSSL_STORE_LOADER\s0 object,
+or \s-1NULL\s0 on error.
+.PP
+\&\fBOSSL_STORE_LOADER_up_ref()\fR returns 1 on success, or 0 on error.
+.PP
+\&\fBOSSL_STORE_LOADER_names_do_all()\fR returns 1 if the callback was called for all
+names. A return value of 0 means that the callback was not called for any names.
+.PP
+\&\fBOSSL_STORE_LOADER_free()\fR doesn't return any value.
+.PP
+\&\fBOSSL_STORE_LOADER_get0_provider()\fR returns a pointer to a provider object, or
+\&\s-1NULL\s0 on error.
+.PP
+\&\fBOSSL_STORE_LOADER_get0_properties()\fR returns a pointer to a property
+definition string, or \s-1NULL\s0 on error.
+.PP
+\&\fBOSSL_STORE_LOADER_is_a()\fR returns 1 if \fIloader\fR was identifiable,
+otherwise 0.
+.PP
+\&\fBOSSL_STORE_LOADER_get0_description()\fR returns a pointer to a description, or \s-1NULL\s0 if
+there isn't one.
+.PP
+The functions with the types \fBOSSL_STORE_open_fn\fR,
+\&\fBOSSL_STORE_open_ex_fn\fR, \fBOSSL_STORE_ctrl_fn\fR,
+\&\fBOSSL_STORE_expect_fn\fR, \fBOSSL_STORE_load_fn\fR, \fBOSSL_STORE_eof_fn\fR
+and \fBOSSL_STORE_close_fn\fR have the same return values as \fBOSSL_STORE_open()\fR,
+\&\fBOSSL_STORE_open_ex()\fR, \fBOSSL_STORE_ctrl()\fR, \fBOSSL_STORE_expect()\fR,
\&\fBOSSL_STORE_load()\fR, \fBOSSL_STORE_eof()\fR and \fBOSSL_STORE_close()\fR, respectively.
.PP
\&\fBOSSL_STORE_LOADER_new()\fR returns a pointer to a \fB\s-1OSSL_STORE_LOADER\s0\fR on success,
-or \fB\s-1NULL\s0\fR on failure.
+or \s-1NULL\s0 on failure.
.PP
-\&\fBOSSL_STORE_LOADER_set_open()\fR, \fBOSSL_STORE_LOADER_set_ctrl()\fR,
-\&\fBOSSL_STORE_LOADER_set_load()\fR, \fBOSSL_STORE_LOADER_set_eof()\fR and
-\&\fBOSSL_STORE_LOADER_set_close()\fR return 1 on success, or 0 on failure.
+\&\fBOSSL_STORE_LOADER_set_open()\fR, \fBOSSL_STORE_LOADER_set_open_ex()\fR,
+\&\fBOSSL_STORE_LOADER_set_ctrl()\fR, \fBOSSL_STORE_LOADER_set_load()\fR,
+\&\fBOSSL_STORE_LOADER_set_eof()\fR and \fBOSSL_STORE_LOADER_set_close()\fR return 1
+on success, or 0 on failure.
.PP
\&\fBOSSL_STORE_register_loader()\fR returns 1 on success, or 0 on failure.
.PP
\&\fBOSSL_STORE_unregister_loader()\fR returns the unregistered loader on success,
-or \fB\s-1NULL\s0\fR on failure.
+or \s-1NULL\s0 on failure.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
-\&\fBossl_store\fR\|(7), \fBOSSL_STORE_open\fR\|(3)
+\&\fBossl_store\fR\|(7), \fBOSSL_STORE_open\fR\|(3), \s-1\fBOSSL_LIB_CTX\s0\fR\|(3),
+\&\fBprovider\-storemgmt\fR\|(7)
.SH "HISTORY"
.IX Header "HISTORY"
-\&\s-1\fBOSSL_STORE_LOADER\s0()\fR, \s-1\fBOSSL_STORE_LOADER_CTX\s0()\fR, \fBOSSL_STORE_LOADER_new()\fR,
-\&\fBOSSL_STORE_LOADER_set0_scheme()\fR, \fBOSSL_STORE_LOADER_set_open()\fR,
-\&\fBOSSL_STORE_LOADER_set_ctrl()\fR, \fBOSSL_STORE_LOADER_set_load()\fR,
-\&\fBOSSL_STORE_LOADER_set_eof()\fR, \fBOSSL_STORE_LOADER_set_close()\fR,
-\&\fBOSSL_STORE_LOADER_free()\fR, \fBOSSL_STORE_register_loader()\fR,
+\&\fBOSSL_STORE_LOADER_fetch()\fR, \fBOSSL_STORE_LOADER_up_ref()\fR,
+\&\fBOSSL_STORE_LOADER_free()\fR, \fBOSSL_STORE_LOADER_get0_provider()\fR,
+\&\fBOSSL_STORE_LOADER_get0_properties()\fR, \fBOSSL_STORE_LOADER_is_a()\fR,
+\&\fBOSSL_STORE_LOADER_do_all_provided()\fR and
+\&\fBOSSL_STORE_LOADER_names_do_all()\fR were added in OpenSSL 3.0.
+.PP
+\&\fBOSSL_STORE_open_ex_fn()\fR was added in OpenSSL 3.0.
+.PP
+\&\fB\s-1OSSL_STORE_LOADER\s0\fR, \fB\s-1OSSL_STORE_LOADER_CTX\s0\fR, \fBOSSL_STORE_LOADER_new()\fR,
+\&\fBOSSL_STORE_LOADER_set0_scheme()\fR, \fBOSSL_STORE_LOADER_get0_scheme()\fR,
+\&\fBOSSL_STORE_LOADER_get0_engine()\fR, \fBOSSL_STORE_LOADER_set_expect()\fR,
+\&\fBOSSL_STORE_LOADER_set_find()\fR, \fBOSSL_STORE_LOADER_set_attach()\fR,
+\&\fBOSSL_STORE_LOADER_set_open_ex()\fR, \fBOSSL_STORE_LOADER_set_open()\fR,
+\&\fBOSSL_STORE_LOADER_set_ctrl()\fR,
+\&\fBOSSL_STORE_LOADER_set_load()\fR, \fBOSSL_STORE_LOADER_set_eof()\fR,
+\&\fBOSSL_STORE_LOADER_set_close()\fR, \fBOSSL_STORE_LOADER_free()\fR,
+\&\fBOSSL_STORE_register_loader()\fR, \fBOSSL_STORE_LOADER_set_error()\fR,
\&\fBOSSL_STORE_unregister_loader()\fR, \fBOSSL_STORE_open_fn()\fR, \fBOSSL_STORE_ctrl_fn()\fR,
\&\fBOSSL_STORE_load_fn()\fR, \fBOSSL_STORE_eof_fn()\fR and \fBOSSL_STORE_close_fn()\fR
-were added in OpenSSL 1.1.1.
+were added in OpenSSL 1.1.1, and became deprecated in OpenSSL 3.0.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright 2016\-2019 The OpenSSL Project Authors. All Rights Reserved.
+Copyright 2016\-2023 The OpenSSL Project Authors. All Rights Reserved.
.PP
-Licensed under the OpenSSL license (the \*(L"License\*(R"). You may not use
+Licensed under the Apache License 2.0 (the \*(L"License\*(R"). You may not use
this file except in compliance with the License. You can obtain a copy
in the file \s-1LICENSE\s0 in the source distribution or at
<https://www.openssl.org/source/license.html>.