11 PEM_write_bio_DHxparams,
12 PEM_read_ECPKParameters,
13 PEM_read_bio_ECPKParameters,
14 PEM_write_ECPKParameters,
15 PEM_write_bio_ECPKParameters,
16 PEM_read_ECPrivateKey,
17 PEM_write_ECPrivateKey,
18 PEM_write_bio_ECPrivateKey,
20 PEM_read_bio_EC_PUBKEY,
22 PEM_write_bio_EC_PUBKEY,
23 PEM_read_NETSCAPE_CERT_SEQUENCE,
24 PEM_read_bio_NETSCAPE_CERT_SEQUENCE,
25 PEM_write_NETSCAPE_CERT_SEQUENCE,
26 PEM_write_bio_NETSCAPE_CERT_SEQUENCE,
31 PEM_write_PKCS8_PRIV_KEY_INFO,
32 PEM_read_bio_PKCS8_PRIV_KEY_INFO,
33 PEM_read_PKCS8_PRIV_KEY_INFO,
34 PEM_write_bio_PKCS8_PRIV_KEY_INFO,
36 PEM_read_bio_SSL_SESSION,
37 PEM_write_SSL_SESSION,
38 PEM_write_bio_SSL_SESSION,
40 PEM_read_bio_X509_PUBKEY,
41 PEM_write_X509_PUBKEY,
42 PEM_write_bio_X509_PUBKEY
43 - PEM object encoding routines
49 #include <openssl/pem.h>
51 DECLARE_PEM_rw(name, TYPE)
53 TYPE *PEM_read_TYPE(FILE *fp, TYPE **a, pem_password_cb *cb, void *u);
54 TYPE *PEM_read_bio_TYPE(BIO *bp, TYPE **a, pem_password_cb *cb, void *u);
55 int PEM_write_TYPE(FILE *fp, const TYPE *a);
56 int PEM_write_bio_TYPE(BIO *bp, const TYPE *a);
58 Deprecated since OpenSSL 3.0, can be hidden entirely by defining
59 B<OPENSSL_API_COMPAT> with a suitable version value, see
60 L<openssl_user_macros(7)>:
62 #include <openssl/pem.h>
64 int PEM_write_DHxparams(FILE *out, const DH *dh);
65 int PEM_write_bio_DHxparams(BIO *out, const DH *dh);
66 EC_GROUP *PEM_read_ECPKParameters(FILE *fp, EC_GROUP **x, pem_password_cb *cb, void *u);
67 EC_GROUP *PEM_read_bio_ECPKParameters(BIO *bp, EC_GROUP **x, pem_password_cb *cb, void *u);
68 int PEM_write_ECPKParameters(FILE *out, const EC_GROUP *x);
69 int PEM_write_bio_ECPKParameters(BIO *out, const EC_GROUP *x),
71 EC_KEY *PEM_read_EC_PUBKEY(FILE *fp, EC_KEY **x, pem_password_cb *cb, void *u);
72 EC_KEY *PEM_read_bio_EC_PUBKEY(BIO *bp, EC_KEY **x, pem_password_cb *cb, void *u);
73 int PEM_write_EC_PUBKEY(FILE *out, const EC_KEY *x);
74 int PEM_write_bio_EC_PUBKEY(BIO *out, const EC_KEY *x);
76 EC_KEY *PEM_read_ECPrivateKey(FILE *out, EC_KEY **x, pem_password_cb *cb, void *u);
77 EC_KEY *PEM_read_bio_ECPrivateKey(BIO *out, EC_KEY **x, pem_password_cb *cb, void *u);
78 int PEM_write_ECPrivateKey(FILE *out, const EC_KEY *x, const EVP_CIPHER *enc,
79 const unsigned char *kstr, int klen,
80 pem_password_cb *cb, void *u);
81 int PEM_write_bio_ECPrivateKey(BIO *out, const EC_KEY *x, const EVP_CIPHER *enc,
82 const unsigned char *kstr, int klen,
83 pem_password_cb *cb, void *u);
87 All of the functions described on this page are deprecated.
88 Applications should use OSSL_ENCODER_to_bio() and OSSL_DECODER_from_bio()
91 In the description below, B<I<TYPE>> is used
92 as a placeholder for any of the OpenSSL datatypes, such as B<X509>.
93 The macro B<DECLARE_PEM_rw> expands to the set of declarations shown in
94 the next four lines of the synopsis.
96 These routines convert between local instances of ASN1 datatypes and
97 the PEM encoding. For more information on the templates, see
98 L<ASN1_ITEM(3)>. For more information on the lower-level routines used
99 by the functions here, see L<PEM_read(3)>.
101 B<PEM_read_I<TYPE>>() reads a PEM-encoded object of B<I<TYPE>> from the file
102 I<fp> and returns it. The I<cb> and I<u> parameters are as described in
103 L<pem_password_cb(3)>.
105 B<PEM_read_bio_I<TYPE>>() is similar to B<PEM_read_I<TYPE>>() but reads from
108 B<PEM_write_I<TYPE>>() writes the PEM encoding of the object I<a> to the file
111 B<PEM_write_bio_I<TYPE>>() similarly writes to the BIO I<bp>.
115 These functions make no assumption regarding the pass phrase received from the
117 It will simply be treated as a byte sequence.
121 B<PEM_read_I<TYPE>>() and B<PEM_read_bio_I<TYPE>>() return a pointer to an
122 allocated object, which should be released by calling B<I<TYPE>_free>(), or
125 B<PEM_write_I<TYPE>>() and B<PEM_write_bio_I<TYPE>>() return the number of bytes
126 written or zero on error.
131 L<passphrase-encoding(7)>
135 The functions PEM_write_DHxparams(), PEM_write_bio_DHxparams(),
136 PEM_read_ECPKParameters(), PEM_read_bio_ECPKParameters(),
137 PEM_write_ECPKParameters(), PEM_write_bio_ECPKParameters(),
138 PEM_read_EC_PUBKEY(), PEM_read_bio_EC_PUBKEY(),
139 PEM_write_EC_PUBKEY(), PEM_write_bio_EC_PUBKEY(),
140 PEM_read_ECPrivateKey(), PEM_read_bio_ECPrivateKey(),
141 PEM_write_ECPrivateKey() and PEM_write_bio_ECPrivateKey()
142 were deprecated in OpenSSL 3.0.
146 Copyright 1998-2021 The OpenSSL Project Authors. All Rights Reserved.
148 Licensed under the Apache License 2.0 (the "License"). You may not use
149 this file except in compliance with the License. You can obtain a copy
150 in the file LICENSE in the source distribution or at
151 L<https://www.openssl.org/source/license.html>.