1e1051a39Sopenharmony_ci=pod
2e1051a39Sopenharmony_ci
3e1051a39Sopenharmony_ci=head1 NAME
4e1051a39Sopenharmony_ci
5e1051a39Sopenharmony_ciOSSL_STORE_attach - Functions to read objects from a BIO
6e1051a39Sopenharmony_ci
7e1051a39Sopenharmony_ci=head1 SYNOPSIS
8e1051a39Sopenharmony_ci
9e1051a39Sopenharmony_ci #include <openssl/store.h>
10e1051a39Sopenharmony_ci
11e1051a39Sopenharmony_ci OSSL_STORE_CTX *OSSL_STORE_attach(BIO *bio, const char *scheme,
12e1051a39Sopenharmony_ci                                   OSSL_LIB_CTX *libctx, const char *propq,
13e1051a39Sopenharmony_ci                                   const UI_METHOD *ui_method, void *ui_data,
14e1051a39Sopenharmony_ci                                   const OSSL_PARAM params[],
15e1051a39Sopenharmony_ci                                   OSSL_STORE_post_process_info_fn post_process,
16e1051a39Sopenharmony_ci                                   void *post_process_data);
17e1051a39Sopenharmony_ci
18e1051a39Sopenharmony_ci=head1 DESCRIPTION
19e1051a39Sopenharmony_ci
20e1051a39Sopenharmony_ciOSSL_STORE_attach() works like L<OSSL_STORE_open(3)>, except it takes a B<BIO>
21e1051a39Sopenharmony_ciI<bio> instead of a I<uri>, along with a I<scheme> to determine what loader
22e1051a39Sopenharmony_cishould be used to process the data. The reference count of the B<BIO> object
23e1051a39Sopenharmony_ciis increased by 1 if the call is successful.
24e1051a39Sopenharmony_ci
25e1051a39Sopenharmony_ci=head1 RETURN VALUES
26e1051a39Sopenharmony_ci
27e1051a39Sopenharmony_ciOSSL_STORE_attach() returns a pointer to a B<OSSL_STORE_CTX> on success, or
28e1051a39Sopenharmony_ciNULL on failure.
29e1051a39Sopenharmony_ci
30e1051a39Sopenharmony_ci=head1 SEE ALSO
31e1051a39Sopenharmony_ci
32e1051a39Sopenharmony_ciL<ossl_store(7)>, L<OSSL_STORE_open(3)>
33e1051a39Sopenharmony_ci
34e1051a39Sopenharmony_ci=head1 HISTORY
35e1051a39Sopenharmony_ci
36e1051a39Sopenharmony_ciOSSL_STORE_attach() was added in OpenSSL 3.0.
37e1051a39Sopenharmony_ci
38e1051a39Sopenharmony_ci=head1 COPYRIGHT
39e1051a39Sopenharmony_ci
40e1051a39Sopenharmony_ciCopyright 2020-2021 The OpenSSL Project Authors. All Rights Reserved.
41e1051a39Sopenharmony_ci
42e1051a39Sopenharmony_ciLicensed under the Apache License 2.0 (the "License").  You may not use
43e1051a39Sopenharmony_cithis file except in compliance with the License.  You can obtain a copy
44e1051a39Sopenharmony_ciin the file LICENSE in the source distribution or at
45e1051a39Sopenharmony_ciL<https://www.openssl.org/source/license.html>.
46e1051a39Sopenharmony_ci
47e1051a39Sopenharmony_ci=cut
48