xref: /dragonfly/crypto/libressl/include/openssl/pem.h (revision 961e30ea7dc61d1112b778ea4981eac68129fb86)
1 /* $OpenBSD: pem.h,v 1.24 2022/07/12 14:42:50 kn Exp $ */
2 /* Copyright (C) 1995-1997 Eric Young (eay@cryptsoft.com)
3  * All rights reserved.
4  *
5  * This package is an SSL implementation written
6  * by Eric Young (eay@cryptsoft.com).
7  * The implementation was written so as to conform with Netscapes SSL.
8  *
9  * This library is free for commercial and non-commercial use as long as
10  * the following conditions are aheared to.  The following conditions
11  * apply to all code found in this distribution, be it the RC4, RSA,
12  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
13  * included with this distribution is covered by the same copyright terms
14  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
15  *
16  * Copyright remains Eric Young's, and as such any Copyright notices in
17  * the code are not to be removed.
18  * If this package is used in a product, Eric Young should be given attribution
19  * as the author of the parts of the library used.
20  * This can be in the form of a textual message at program startup or
21  * in documentation (online or textual) provided with the package.
22  *
23  * Redistribution and use in source and binary forms, with or without
24  * modification, are permitted provided that the following conditions
25  * are met:
26  * 1. Redistributions of source code must retain the copyright
27  *    notice, this list of conditions and the following disclaimer.
28  * 2. Redistributions in binary form must reproduce the above copyright
29  *    notice, this list of conditions and the following disclaimer in the
30  *    documentation and/or other materials provided with the distribution.
31  * 3. All advertising materials mentioning features or use of this software
32  *    must display the following acknowledgement:
33  *    "This product includes cryptographic software written by
34  *     Eric Young (eay@cryptsoft.com)"
35  *    The word 'cryptographic' can be left out if the rouines from the library
36  *    being used are not cryptographic related :-).
37  * 4. If you include any Windows specific code (or a derivative thereof) from
38  *    the apps directory (application code) you must include an acknowledgement:
39  *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
40  *
41  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
42  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
45  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
47  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
48  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
49  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
50  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
51  * SUCH DAMAGE.
52  *
53  * The licence and distribution terms for any publically available version or
54  * derivative of this code cannot be changed.  i.e. this code cannot simply be
55  * copied and put under another distribution licence
56  * [including the GNU Public Licence.]
57  */
58 
59 #ifndef HEADER_PEM_H
60 #define HEADER_PEM_H
61 
62 #include <openssl/opensslconf.h>
63 
64 #ifndef OPENSSL_NO_BIO
65 #include <openssl/bio.h>
66 #endif
67 #ifndef OPENSSL_NO_STACK
68 #include <openssl/stack.h>
69 #endif
70 #include <openssl/evp.h>
71 #include <openssl/x509.h>
72 #include <openssl/pem2.h>
73 
74 #ifdef  __cplusplus
75 extern "C" {
76 #endif
77 
78 #define PEM_BUFSIZE           1024
79 
80 #define PEM_OBJ_UNDEF                   0
81 #define PEM_OBJ_X509                    1
82 #define PEM_OBJ_X509_REQ      2
83 #define PEM_OBJ_CRL           3
84 #define PEM_OBJ_SSL_SESSION   4
85 #define PEM_OBJ_PRIV_KEY      10
86 #define PEM_OBJ_PRIV_RSA      11
87 #define PEM_OBJ_PRIV_DSA      12
88 #define PEM_OBJ_PRIV_DH                 13
89 #define PEM_OBJ_PUB_RSA                 14
90 #define PEM_OBJ_PUB_DSA                 15
91 #define PEM_OBJ_PUB_DH                  16
92 #define PEM_OBJ_DHPARAMS      17
93 #define PEM_OBJ_DSAPARAMS     18
94 #define PEM_OBJ_PRIV_RSA_PUBLIC         19
95 #define PEM_OBJ_PRIV_ECDSA    20
96 #define PEM_OBJ_PUB_ECDSA     21
97 #define PEM_OBJ_ECPARAMETERS  22
98 
99 #define PEM_ERROR             30
100 #define PEM_DEK_DES_CBC         40
101 #define PEM_DEK_IDEA_CBC        45
102 #define PEM_DEK_DES_EDE         50
103 #define PEM_DEK_DES_ECB         60
104 #define PEM_DEK_RSA             70
105 #define PEM_DEK_RSA_MD2         80
106 #define PEM_DEK_RSA_MD5         90
107 
108 #define PEM_MD_MD2            NID_md2
109 #define PEM_MD_MD5            NID_md5
110 #define PEM_MD_SHA            NID_sha
111 #define PEM_MD_MD2_RSA                  NID_md2WithRSAEncryption
112 #define PEM_MD_MD5_RSA                  NID_md5WithRSAEncryption
113 #define PEM_MD_SHA_RSA                  NID_sha1WithRSAEncryption
114 
115 #define PEM_STRING_X509_OLD   "X509 CERTIFICATE"
116 #define PEM_STRING_X509                 "CERTIFICATE"
117 #define PEM_STRING_X509_TRUSTED         "TRUSTED CERTIFICATE"
118 #define PEM_STRING_X509_REQ_OLD         "NEW CERTIFICATE REQUEST"
119 #define PEM_STRING_X509_REQ   "CERTIFICATE REQUEST"
120 #define PEM_STRING_X509_CRL   "X509 CRL"
121 #define PEM_STRING_EVP_PKEY   "ANY PRIVATE KEY"
122 #define PEM_STRING_PUBLIC     "PUBLIC KEY"
123 #define PEM_STRING_RSA                  "RSA PRIVATE KEY"
124 #define PEM_STRING_RSA_PUBLIC "RSA PUBLIC KEY"
125 #define PEM_STRING_DSA                  "DSA PRIVATE KEY"
126 #define PEM_STRING_DSA_PUBLIC "DSA PUBLIC KEY"
127 #define PEM_STRING_PKCS7      "PKCS7"
128 #define PEM_STRING_PKCS7_SIGNED         "PKCS #7 SIGNED DATA"
129 #define PEM_STRING_PKCS8      "ENCRYPTED PRIVATE KEY"
130 #define PEM_STRING_PKCS8INF   "PRIVATE KEY"
131 #define PEM_STRING_DHPARAMS   "DH PARAMETERS"
132 #define PEM_STRING_SSL_SESSION          "SSL SESSION PARAMETERS"
133 #define PEM_STRING_DSAPARAMS  "DSA PARAMETERS"
134 #define PEM_STRING_ECDSA_PUBLIC "ECDSA PUBLIC KEY"
135 #define PEM_STRING_ECPARAMETERS "EC PARAMETERS"
136 #define PEM_STRING_ECPRIVATEKEY         "EC PRIVATE KEY"
137 #define PEM_STRING_PARAMETERS "PARAMETERS"
138 #define PEM_STRING_CMS                  "CMS"
139 
140 /* enc_type is one off */
141 #define PEM_TYPE_ENCRYPTED      10
142 #define PEM_TYPE_MIC_ONLY       20
143 #define PEM_TYPE_MIC_CLEAR      30
144 #define PEM_TYPE_CLEAR                  40
145 
146 typedef struct pem_recip_st {
147           char *name;
148           X509_NAME *dn;
149 
150           int cipher;
151           int key_enc;
152           /*        char iv[8]; unused and wrong size */
153 } PEM_USER;
154 
155 typedef struct pem_ctx_st {
156           int type;           /* what type of object */
157 
158           struct    {
159                     int version;
160                     int mode;
161           } proc_type;
162 
163           char *domain;
164 
165           struct    {
166                     int cipher;
167           /* unused, and wrong size
168              unsigned char iv[8]; */
169           } DEK_info;
170 
171           PEM_USER *originator;
172 
173           int num_recipient;
174           PEM_USER **recipient;
175 
176           /* XXX(ben): don#t think this is used!
177                     STACK *x509_chain;  / * certificate chain */
178           EVP_MD *md;                   /* signature type */
179 
180           int md_enc;                   /* is the md encrypted or not? */
181           int md_len;                   /* length of md_data */
182           char *md_data;                /* message digest, could be pkey encrypted */
183 
184           EVP_CIPHER *dec;    /* date encryption cipher */
185           int key_len;                  /* key length */
186           unsigned char *key; /* key */
187           /* unused, and wrong size
188              unsigned char iv[8]; */
189 
190           int  data_enc;                /* is the data encrypted */
191           int data_len;
192           unsigned char *data;
193 } PEM_CTX;
194 
195 #ifndef LIBRESSL_INTERNAL
196 /* These macros make the PEM_read/PEM_write functions easier to maintain and
197  * write. Now they are all implemented with either:
198  * IMPLEMENT_PEM_rw(...) or IMPLEMENT_PEM_rw_cb(...)
199  */
200 
201 #define IMPLEMENT_PEM_read_fp(name, type, str, asn1) \
202 type *PEM_read_##name(FILE *fp, type **x, pem_password_cb *cb, void *u)\
203 { \
204 return PEM_ASN1_read((d2i_of_void *)d2i_##asn1, str,fp,(void **)x,cb,u); \
205 }
206 
207 #define IMPLEMENT_PEM_write_fp(name, type, str, asn1) \
208 int PEM_write_##name(FILE *fp, type *x) \
209 { \
210 return PEM_ASN1_write((i2d_of_void *)i2d_##asn1,str,fp,x,NULL,NULL,0,NULL,NULL); \
211 }
212 
213 #define IMPLEMENT_PEM_write_fp_const(name, type, str, asn1) \
214 int PEM_write_##name(FILE *fp, const type *x) \
215 { \
216 return PEM_ASN1_write((i2d_of_void *)i2d_##asn1,str,fp,(void *)x,NULL,NULL,0,NULL,NULL); \
217 }
218 
219 #define IMPLEMENT_PEM_write_cb_fp(name, type, str, asn1) \
220 int PEM_write_##name(FILE *fp, type *x, const EVP_CIPHER *enc, \
221                unsigned char *kstr, int klen, pem_password_cb *cb, \
222                       void *u) \
223           { \
224           return PEM_ASN1_write((i2d_of_void *)i2d_##asn1,str,fp,x,enc,kstr,klen,cb,u); \
225           }
226 
227 #define IMPLEMENT_PEM_write_cb_fp_const(name, type, str, asn1) \
228 int PEM_write_##name(FILE *fp, type *x, const EVP_CIPHER *enc, \
229                unsigned char *kstr, int klen, pem_password_cb *cb, \
230                       void *u) \
231           { \
232           return PEM_ASN1_write((i2d_of_void *)i2d_##asn1,str,fp,x,enc,kstr,klen,cb,u); \
233           }
234 
235 
236 #define IMPLEMENT_PEM_read_bio(name, type, str, asn1) \
237 type *PEM_read_bio_##name(BIO *bp, type **x, pem_password_cb *cb, void *u)\
238 { \
239 return PEM_ASN1_read_bio((d2i_of_void *)d2i_##asn1, str,bp,(void **)x,cb,u); \
240 }
241 
242 #define IMPLEMENT_PEM_write_bio(name, type, str, asn1) \
243 int PEM_write_bio_##name(BIO *bp, type *x) \
244 { \
245 return PEM_ASN1_write_bio((i2d_of_void *)i2d_##asn1,str,bp,x,NULL,NULL,0,NULL,NULL); \
246 }
247 
248 #define IMPLEMENT_PEM_write_bio_const(name, type, str, asn1) \
249 int PEM_write_bio_##name(BIO *bp, const type *x) \
250 { \
251 return PEM_ASN1_write_bio((i2d_of_void *)i2d_##asn1,str,bp,(void *)x,NULL,NULL,0,NULL,NULL); \
252 }
253 
254 #define IMPLEMENT_PEM_write_cb_bio(name, type, str, asn1) \
255 int PEM_write_bio_##name(BIO *bp, type *x, const EVP_CIPHER *enc, \
256                unsigned char *kstr, int klen, pem_password_cb *cb, void *u) \
257           { \
258           return PEM_ASN1_write_bio((i2d_of_void *)i2d_##asn1,str,bp,x,enc,kstr,klen,cb,u); \
259           }
260 
261 #define IMPLEMENT_PEM_write_cb_bio_const(name, type, str, asn1) \
262 int PEM_write_bio_##name(BIO *bp, type *x, const EVP_CIPHER *enc, \
263                unsigned char *kstr, int klen, pem_password_cb *cb, void *u) \
264           { \
265           return PEM_ASN1_write_bio((i2d_of_void *)i2d_##asn1,str,bp,(void *)x,enc,kstr,klen,cb,u); \
266           }
267 
268 #define IMPLEMENT_PEM_write(name, type, str, asn1) \
269           IMPLEMENT_PEM_write_bio(name, type, str, asn1) \
270           IMPLEMENT_PEM_write_fp(name, type, str, asn1)
271 
272 #define IMPLEMENT_PEM_write_const(name, type, str, asn1) \
273           IMPLEMENT_PEM_write_bio_const(name, type, str, asn1) \
274           IMPLEMENT_PEM_write_fp_const(name, type, str, asn1)
275 
276 #define IMPLEMENT_PEM_write_cb(name, type, str, asn1) \
277           IMPLEMENT_PEM_write_cb_bio(name, type, str, asn1) \
278           IMPLEMENT_PEM_write_cb_fp(name, type, str, asn1)
279 
280 #define IMPLEMENT_PEM_write_cb_const(name, type, str, asn1) \
281           IMPLEMENT_PEM_write_cb_bio_const(name, type, str, asn1) \
282           IMPLEMENT_PEM_write_cb_fp_const(name, type, str, asn1)
283 
284 #define IMPLEMENT_PEM_read(name, type, str, asn1) \
285           IMPLEMENT_PEM_read_bio(name, type, str, asn1) \
286           IMPLEMENT_PEM_read_fp(name, type, str, asn1)
287 
288 #define IMPLEMENT_PEM_rw(name, type, str, asn1) \
289           IMPLEMENT_PEM_read(name, type, str, asn1) \
290           IMPLEMENT_PEM_write(name, type, str, asn1)
291 
292 #define IMPLEMENT_PEM_rw_const(name, type, str, asn1) \
293           IMPLEMENT_PEM_read(name, type, str, asn1) \
294           IMPLEMENT_PEM_write_const(name, type, str, asn1)
295 
296 #define IMPLEMENT_PEM_rw_cb(name, type, str, asn1) \
297           IMPLEMENT_PEM_read(name, type, str, asn1) \
298           IMPLEMENT_PEM_write_cb(name, type, str, asn1)
299 
300 #endif
301 
302 /* These are the same except they are for the declarations */
303 
304 
305 #define DECLARE_PEM_read_fp(name, type) \
306           type *PEM_read_##name(FILE *fp, type **x, pem_password_cb *cb, void *u);
307 
308 #define DECLARE_PEM_write_fp(name, type) \
309           int PEM_write_##name(FILE *fp, type *x);
310 
311 #define DECLARE_PEM_write_fp_const(name, type) \
312           int PEM_write_##name(FILE *fp, const type *x);
313 
314 #define DECLARE_PEM_write_cb_fp(name, type) \
315           int PEM_write_##name(FILE *fp, type *x, const EVP_CIPHER *enc, \
316                unsigned char *kstr, int klen, pem_password_cb *cb, void *u);
317 
318 
319 #ifndef OPENSSL_NO_BIO
320 #define DECLARE_PEM_read_bio(name, type) \
321           type *PEM_read_bio_##name(BIO *bp, type **x, pem_password_cb *cb, void *u);
322 
323 #define DECLARE_PEM_write_bio(name, type) \
324           int PEM_write_bio_##name(BIO *bp, type *x);
325 
326 #define DECLARE_PEM_write_bio_const(name, type) \
327           int PEM_write_bio_##name(BIO *bp, const type *x);
328 
329 #define DECLARE_PEM_write_cb_bio(name, type) \
330           int PEM_write_bio_##name(BIO *bp, type *x, const EVP_CIPHER *enc, \
331                unsigned char *kstr, int klen, pem_password_cb *cb, void *u);
332 
333 #else
334 
335 #define DECLARE_PEM_read_bio(name, type) /**/
336 #define DECLARE_PEM_write_bio(name, type) /**/
337 #define DECLARE_PEM_write_bio_const(name, type) /**/
338 #define DECLARE_PEM_write_cb_bio(name, type) /**/
339 
340 #endif
341 
342 #define DECLARE_PEM_write(name, type) \
343           DECLARE_PEM_write_bio(name, type) \
344           DECLARE_PEM_write_fp(name, type)
345 
346 #define DECLARE_PEM_write_const(name, type) \
347           DECLARE_PEM_write_bio_const(name, type) \
348           DECLARE_PEM_write_fp_const(name, type)
349 
350 #define DECLARE_PEM_write_cb(name, type) \
351           DECLARE_PEM_write_cb_bio(name, type) \
352           DECLARE_PEM_write_cb_fp(name, type)
353 
354 #define DECLARE_PEM_read(name, type) \
355           DECLARE_PEM_read_bio(name, type) \
356           DECLARE_PEM_read_fp(name, type)
357 
358 #define DECLARE_PEM_rw(name, type) \
359           DECLARE_PEM_read(name, type) \
360           DECLARE_PEM_write(name, type)
361 
362 #define DECLARE_PEM_rw_const(name, type) \
363           DECLARE_PEM_read(name, type) \
364           DECLARE_PEM_write_const(name, type)
365 
366 #define DECLARE_PEM_rw_cb(name, type) \
367           DECLARE_PEM_read(name, type) \
368           DECLARE_PEM_write_cb(name, type)
369 
370 typedef int pem_password_cb(char *buf, int size, int rwflag, void *userdata);
371 
372 int       PEM_get_EVP_CIPHER_INFO(char *header, EVP_CIPHER_INFO *cipher);
373 int       PEM_do_header (EVP_CIPHER_INFO *cipher, unsigned char *data, long *len,
374               pem_password_cb *callback, void *u);
375 
376 #ifndef OPENSSL_NO_BIO
377 int       PEM_read_bio(BIO *bp, char **name, char **header,
378               unsigned char **data, long *len);
379 int       PEM_write_bio(BIO *bp, const char *name, const char *hdr,
380               const unsigned char *data, long len);
381 int       PEM_bytes_read_bio(unsigned char **pdata, long *plen, char **pnm,
382               const char *name, BIO *bp, pem_password_cb *cb, void *u);
383 void *    PEM_ASN1_read_bio(d2i_of_void *d2i, const char *name, BIO *bp,
384               void **x, pem_password_cb *cb, void *u);
385 int       PEM_ASN1_write_bio(i2d_of_void *i2d, const char *name, BIO *bp, void *x,
386               const EVP_CIPHER *enc, unsigned char *kstr, int klen,
387               pem_password_cb *cb, void *u);
388 
389 STACK_OF(X509_INFO) *         PEM_X509_INFO_read_bio(BIO *bp,
390               STACK_OF(X509_INFO) *sk, pem_password_cb *cb, void *u);
391 int       PEM_X509_INFO_write_bio(BIO *bp, X509_INFO *xi, EVP_CIPHER *enc,
392               unsigned char *kstr, int klen, pem_password_cb *cd, void *u);
393 #endif
394 
395 int       PEM_read(FILE *fp, char **name, char **header,
396               unsigned char **data, long *len);
397 int       PEM_write(FILE *fp, const char *name, const char *hdr,
398               const unsigned char *data, long len);
399 void *  PEM_ASN1_read(d2i_of_void *d2i, const char *name, FILE *fp, void **x,
400               pem_password_cb *cb, void *u);
401 int       PEM_ASN1_write(i2d_of_void *i2d, const char *name, FILE *fp,
402               void *x, const EVP_CIPHER *enc, unsigned char *kstr,
403               int klen, pem_password_cb *callback, void *u);
404 STACK_OF(X509_INFO) *         PEM_X509_INFO_read(FILE *fp, STACK_OF(X509_INFO) *sk,
405               pem_password_cb *cb, void *u);
406 
407 int    PEM_SignInit(EVP_MD_CTX *ctx, EVP_MD *type);
408 int    PEM_SignUpdate(EVP_MD_CTX *ctx, unsigned char *d, unsigned int cnt);
409 int       PEM_SignFinal(EVP_MD_CTX *ctx, unsigned char *sigret,
410               unsigned int *siglen, EVP_PKEY *pkey);
411 
412 int       PEM_def_callback(char *buf, int num, int w, void *key);
413 void      PEM_proc_type(char *buf, int type);
414 void      PEM_dek_info(char *buf, const char *type, int len, char *str);
415 
416 
417 DECLARE_PEM_rw(X509, X509)
418 
419 DECLARE_PEM_rw(X509_AUX, X509)
420 
421 DECLARE_PEM_rw(X509_REQ, X509_REQ)
422 DECLARE_PEM_write(X509_REQ_NEW, X509_REQ)
423 
424 DECLARE_PEM_rw(X509_CRL, X509_CRL)
425 
426 DECLARE_PEM_rw(PKCS7, PKCS7)
427 
428 DECLARE_PEM_rw(NETSCAPE_CERT_SEQUENCE, NETSCAPE_CERT_SEQUENCE)
429 
430 DECLARE_PEM_rw(PKCS8, X509_SIG)
431 
432 DECLARE_PEM_rw(PKCS8_PRIV_KEY_INFO, PKCS8_PRIV_KEY_INFO)
433 
434 #ifndef OPENSSL_NO_RSA
435 
436 DECLARE_PEM_rw_cb(RSAPrivateKey, RSA)
437 
438 DECLARE_PEM_rw_const(RSAPublicKey, RSA)
439 DECLARE_PEM_rw(RSA_PUBKEY, RSA)
440 
441 #endif
442 
443 #ifndef OPENSSL_NO_DSA
444 
445 DECLARE_PEM_rw_cb(DSAPrivateKey, DSA)
446 
447 DECLARE_PEM_rw(DSA_PUBKEY, DSA)
448 
449 DECLARE_PEM_rw_const(DSAparams, DSA)
450 
451 #endif
452 
453 #ifndef OPENSSL_NO_EC
454 DECLARE_PEM_rw_const(ECPKParameters, EC_GROUP)
455 DECLARE_PEM_rw_cb(ECPrivateKey, EC_KEY)
456 DECLARE_PEM_rw(EC_PUBKEY, EC_KEY)
457 #endif
458 
459 #ifndef OPENSSL_NO_DH
460 
461 DECLARE_PEM_rw_const(DHparams, DH)
462 
463 #endif
464 
465 DECLARE_PEM_rw_cb(PrivateKey, EVP_PKEY)
466 
467 DECLARE_PEM_rw(PUBKEY, EVP_PKEY)
468 
469 int PEM_write_bio_PrivateKey_traditional(BIO *bp, EVP_PKEY *x,
470     const EVP_CIPHER *enc, unsigned char *kstr, int klen, pem_password_cb *cb,
471     void *u);
472 int PEM_write_bio_PKCS8PrivateKey_nid(BIO *bp, EVP_PKEY *x, int nid,
473     char *kstr, int klen,
474     pem_password_cb *cb, void *u);
475 int PEM_write_bio_PKCS8PrivateKey(BIO *, EVP_PKEY *, const EVP_CIPHER *,
476     char *, int, pem_password_cb *, void *);
477 int i2d_PKCS8PrivateKey_bio(BIO *bp, EVP_PKEY *x, const EVP_CIPHER *enc,
478     char *kstr, int klen,
479     pem_password_cb *cb, void *u);
480 int i2d_PKCS8PrivateKey_nid_bio(BIO *bp, EVP_PKEY *x, int nid,
481     char *kstr, int klen,
482     pem_password_cb *cb, void *u);
483 EVP_PKEY *d2i_PKCS8PrivateKey_bio(BIO *bp, EVP_PKEY **x, pem_password_cb *cb,
484     void *u);
485 
486 int i2d_PKCS8PrivateKey_fp(FILE *fp, EVP_PKEY *x, const EVP_CIPHER *enc,
487     char *kstr, int klen,
488     pem_password_cb *cb, void *u);
489 int i2d_PKCS8PrivateKey_nid_fp(FILE *fp, EVP_PKEY *x, int nid,
490     char *kstr, int klen,
491     pem_password_cb *cb, void *u);
492 int PEM_write_PKCS8PrivateKey_nid(FILE *fp, EVP_PKEY *x, int nid,
493     char *kstr, int klen,
494     pem_password_cb *cb, void *u);
495 
496 EVP_PKEY *d2i_PKCS8PrivateKey_fp(FILE *fp, EVP_PKEY **x, pem_password_cb *cb,
497     void *u);
498 
499 int PEM_write_PKCS8PrivateKey(FILE *fp, EVP_PKEY *x, const EVP_CIPHER *enc,
500     char *kstr, int klen, pem_password_cb *cd, void *u);
501 
502 EVP_PKEY *PEM_read_bio_Parameters(BIO *bp, EVP_PKEY **x);
503 int PEM_write_bio_Parameters(BIO *bp, EVP_PKEY *x);
504 
505 
506 EVP_PKEY *b2i_PrivateKey(const unsigned char **in, long length);
507 EVP_PKEY *b2i_PublicKey(const unsigned char **in, long length);
508 EVP_PKEY *b2i_PrivateKey_bio(BIO *in);
509 EVP_PKEY *b2i_PublicKey_bio(BIO *in);
510 int i2b_PrivateKey_bio(BIO *out, EVP_PKEY *pk);
511 int i2b_PublicKey_bio(BIO *out, EVP_PKEY *pk);
512 #ifndef OPENSSL_NO_RC4
513 EVP_PKEY *b2i_PVK_bio(BIO *in, pem_password_cb *cb, void *u);
514 int i2b_PVK_bio(BIO *out, EVP_PKEY *pk, int enclevel, pem_password_cb *cb,
515     void *u);
516 #endif
517 
518 
519 void ERR_load_PEM_strings(void);
520 
521 /* Error codes for the PEM functions. */
522 
523 /* Function codes. */
524 #define PEM_F_B2I_DSS                                                  127
525 #define PEM_F_B2I_PVK_BIO                                    128
526 #define PEM_F_B2I_RSA                                                  129
527 #define PEM_F_CHECK_BITLEN_DSA                                         130
528 #define PEM_F_CHECK_BITLEN_RSA                                         131
529 #define PEM_F_D2I_PKCS8PRIVATEKEY_BIO                        120
530 #define PEM_F_D2I_PKCS8PRIVATEKEY_FP                         121
531 #define PEM_F_DO_B2I                                                   132
532 #define PEM_F_DO_B2I_BIO                                     133
533 #define PEM_F_DO_BLOB_HEADER                                 134
534 #define PEM_F_DO_PK8PKEY                                     126
535 #define PEM_F_DO_PK8PKEY_FP                                  125
536 #define PEM_F_DO_PVK_BODY                                    135
537 #define PEM_F_DO_PVK_HEADER                                  136
538 #define PEM_F_I2B_PVK                                                  137
539 #define PEM_F_I2B_PVK_BIO                                    138
540 #define PEM_F_LOAD_IV                                                  101
541 #define PEM_F_PEM_ASN1_READ                                  102
542 #define PEM_F_PEM_ASN1_READ_BIO                                        103
543 #define PEM_F_PEM_ASN1_WRITE                                 104
544 #define PEM_F_PEM_ASN1_WRITE_BIO                             105
545 #define PEM_F_PEM_DEF_CALLBACK                                         100
546 #define PEM_F_PEM_DO_HEADER                                  106
547 #define PEM_F_PEM_F_PEM_WRITE_PKCS8PRIVATEKEY                118
548 #define PEM_F_PEM_GET_EVP_CIPHER_INFO                        107
549 #define PEM_F_PEM_PK8PKEY                                    119
550 #define PEM_F_PEM_READ                                                 108
551 #define PEM_F_PEM_READ_BIO                                   109
552 #define PEM_F_PEM_READ_BIO_PARAMETERS                        140
553 #define PEM_F_PEM_READ_BIO_PRIVATEKEY                        123
554 #define PEM_F_PEM_READ_PRIVATEKEY                            124
555 #define PEM_F_PEM_SEALFINAL                                  110
556 #define PEM_F_PEM_SEALINIT                                   111
557 #define PEM_F_PEM_SIGNFINAL                                  112
558 #define PEM_F_PEM_WRITE                                                113
559 #define PEM_F_PEM_WRITE_BIO                                  114
560 #define PEM_F_PEM_WRITE_PRIVATEKEY                           139
561 #define PEM_F_PEM_X509_INFO_READ                             115
562 #define PEM_F_PEM_X509_INFO_READ_BIO                         116
563 #define PEM_F_PEM_X509_INFO_WRITE_BIO                        117
564 
565 /* Reason codes. */
566 #define PEM_R_BAD_BASE64_DECODE                                        100
567 #define PEM_R_BAD_DECRYPT                                    101
568 #define PEM_R_BAD_END_LINE                                   102
569 #define PEM_R_BAD_IV_CHARS                                   103
570 #define PEM_R_BAD_MAGIC_NUMBER                                         116
571 #define PEM_R_BAD_PASSWORD_READ                                        104
572 #define PEM_R_BAD_VERSION_NUMBER                             117
573 #define PEM_R_BIO_WRITE_FAILURE                                        118
574 #define PEM_R_CIPHER_IS_NULL                                 127
575 #define PEM_R_ERROR_CONVERTING_PRIVATE_KEY                   115
576 #define PEM_R_EXPECTING_PRIVATE_KEY_BLOB                     119
577 #define PEM_R_EXPECTING_PUBLIC_KEY_BLOB                      120
578 #define PEM_R_INCONSISTENT_HEADER                            121
579 #define PEM_R_KEYBLOB_HEADER_PARSE_ERROR                     122
580 #define PEM_R_KEYBLOB_TOO_SHORT                                        123
581 #define PEM_R_NOT_DEK_INFO                                   105
582 #define PEM_R_NOT_ENCRYPTED                                  106
583 #define PEM_R_NOT_PROC_TYPE                                  107
584 #define PEM_R_NO_START_LINE                                  108
585 #define PEM_R_PROBLEMS_GETTING_PASSWORD                      109
586 #define PEM_R_PUBLIC_KEY_NO_RSA                                        110
587 #define PEM_R_PVK_DATA_TOO_SHORT                             124
588 #define PEM_R_PVK_TOO_SHORT                                  125
589 #define PEM_R_READ_KEY                                                 111
590 #define PEM_R_SHORT_HEADER                                   112
591 #define PEM_R_UNSUPPORTED_CIPHER                             113
592 #define PEM_R_UNSUPPORTED_ENCRYPTION                         114
593 #define PEM_R_UNSUPPORTED_KEY_COMPONENTS                     126
594 
595 #ifdef  __cplusplus
596 }
597 #endif
598 #endif
599