]> git.ipfire.org Git - thirdparty/openssl.git/blame - doc/man3/PEM_X509_INFO_read_bio_ex.pod
Rename OPENSSL_CTX prefix to OSSL_LIB_CTX
[thirdparty/openssl.git] / doc / man3 / PEM_X509_INFO_read_bio_ex.pod
CommitLineData
6725682d
SL
1=pod
2
3=head1 NAME
4
d8652be0 5PEM_X509_INFO_read_bio_ex, PEM_X509_INFO_read_ex
6725682d
SL
6- read a PEM-encoded data structure from a bio into one or more B<X509_INFO>
7object's
8
9=head1 SYNOPSIS
10
11 #include <openssl/pem.h>
12
d8652be0
MC
13 STACK_OF(X509_INFO) *PEM_X509_INFO_read_ex(FILE *fp, STACK_OF(X509_INFO) *sk,
14 pem_password_cb *cb, void *u,
b4250010 15 OSSL_LIB_CTX *libctx,
d8652be0 16 const char *propq);
6725682d 17
d8652be0
MC
18 STACK_OF(X509_INFO) *PEM_X509_INFO_read_bio_ex(BIO *bio,
19 STACK_OF(X509_INFO) *sk,
20 pem_password_cb *cb, void *u,
b4250010 21 OSSL_LIB_CTX *libctx,
d8652be0 22 const char *propq);
6725682d
SL
23
24=head1 DESCRIPTION
25
26The loaded B<X509_INFO> object's can contain a CRL, a certificate and a
27corresponding private key.
28
d8652be0 29PEM_X509_INFO_read_ex() loads the B<X509_INFO> objects from a file I<fp>.
6725682d
SL
30The library context I<libctx> and property query <propq> are used for fetching
31algorithms from providers.
32
d8652be0 33PEM_X509_INFO_read_bio_ex loads the B<X509_INFO> objects using a bio
6725682d
SL
34I<bp>. The library context I<libctx> and property query <propq> are used for
35fetching algorithms from providers.
36
37
38=head1 RETURN VALUES
39
746f3674 40PEM_X509_INFO_read_ex() and PEM_X509_INFO_read_bio_ex() return
6725682d
SL
41a stack of B<X509_INFO> objects or NULL on failure.
42
43=head1 SEE ALSO
44
45L<PEM_read_bio_ex(3)>,
46L<passphrase-encoding(7)>
47
48=head1 HISTORY
49
d8652be0
MC
50The functions PEM_X509_INFO_read_ex() and
51PEM_X509_INFO_read_bio_ex() were added in OpenSSL 3.0.
6725682d
SL
52
53=head1 COPYRIGHT
54
55Copyright 2020 The OpenSSL Project Authors. All Rights Reserved.
56
57Licensed under the Apache License 2.0 (the "License"). You may not use
58this file except in compliance with the License. You can obtain a copy
59in the file LICENSE in the source distribution or at
60L<https://www.openssl.org/source/license.html>.
61
62=cut