mark all block comments that need format preserving so that
[openssl.git] / crypto / pem / pem.h
1 /* crypto/pem/pem.h */
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/e_os2.h>
63 #ifndef OPENSSL_NO_BIO
64 #include <openssl/bio.h>
65 #endif
66 #ifndef OPENSSL_NO_STACK
67 #include <openssl/stack.h>
68 #endif
69 #include <openssl/evp.h>
70 #include <openssl/x509.h>
71 #include <openssl/pem2.h>
72
73 #ifdef  __cplusplus
74 extern "C" {
75 #endif
76
77 #define PEM_BUFSIZE             1024
78
79 #define PEM_OBJ_UNDEF           0
80 #define PEM_OBJ_X509            1
81 #define PEM_OBJ_X509_REQ        2
82 #define PEM_OBJ_CRL             3
83 #define PEM_OBJ_SSL_SESSION     4
84 #define PEM_OBJ_PRIV_KEY        10
85 #define PEM_OBJ_PRIV_RSA        11
86 #define PEM_OBJ_PRIV_DSA        12
87 #define PEM_OBJ_PRIV_DH         13
88 #define PEM_OBJ_PUB_RSA         14
89 #define PEM_OBJ_PUB_DSA         15
90 #define PEM_OBJ_PUB_DH          16
91 #define PEM_OBJ_DHPARAMS        17
92 #define PEM_OBJ_DSAPARAMS       18
93 #define PEM_OBJ_PRIV_RSA_PUBLIC 19
94 #define PEM_OBJ_PRIV_ECDSA      20
95 #define PEM_OBJ_PUB_ECDSA       21
96 #define PEM_OBJ_ECPARAMETERS    22
97
98 #define PEM_ERROR               30
99 #define PEM_DEK_DES_CBC         40
100 #define PEM_DEK_IDEA_CBC        45
101 #define PEM_DEK_DES_EDE         50
102 #define PEM_DEK_DES_ECB         60
103 #define PEM_DEK_RSA             70
104 #define PEM_DEK_RSA_MD2         80
105 #define PEM_DEK_RSA_MD5         90
106
107 #define PEM_MD_MD2              NID_md2
108 #define PEM_MD_MD5              NID_md5
109 #define PEM_MD_SHA              NID_sha
110 #define PEM_MD_MD2_RSA          NID_md2WithRSAEncryption
111 #define PEM_MD_MD5_RSA          NID_md5WithRSAEncryption
112 #define PEM_MD_SHA_RSA          NID_sha1WithRSAEncryption
113
114 #define PEM_STRING_X509_OLD     "X509 CERTIFICATE"
115 #define PEM_STRING_X509         "CERTIFICATE"
116 #define PEM_STRING_X509_PAIR    "CERTIFICATE PAIR"
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   /* Note that this structure is initialised by PEM_SealInit and cleaned up
141      by PEM_SealFinal (at least for now) */
142 typedef struct PEM_Encode_Seal_st
143         {
144         EVP_ENCODE_CTX encode;
145         EVP_MD_CTX md;
146         EVP_CIPHER_CTX cipher;
147         } PEM_ENCODE_SEAL_CTX;
148
149 /* enc_type is one off */
150 #define PEM_TYPE_ENCRYPTED      10
151 #define PEM_TYPE_MIC_ONLY       20
152 #define PEM_TYPE_MIC_CLEAR      30
153 #define PEM_TYPE_CLEAR          40
154
155 typedef struct pem_recip_st
156         {
157         char *name;
158         X509_NAME *dn;
159
160         int cipher;
161         int key_enc;
162         /*      char iv[8]; unused and wrong size */
163         } PEM_USER;
164
165 typedef struct pem_ctx_st
166         {
167         int type;               /* what type of object */
168
169         struct  {
170                 int version;    
171                 int mode;               
172                 } proc_type;
173
174         char *domain;
175
176         struct  {
177                 int cipher;
178         /*-
179            unused, and wrong size
180            unsigned char iv[8]; */
181                 } DEK_info;
182                 
183         PEM_USER *originator;
184
185         int num_recipient;
186         PEM_USER **recipient;
187
188         /*-
189             XXX(ben): don#t think this is used! 
190                 STACK *x509_chain;      / * certificate chain */
191         EVP_MD *md;             /* signature type */
192
193         int md_enc;             /* is the md encrypted or not? */
194         int md_len;             /* length of md_data */
195         char *md_data;          /* message digest, could be pkey encrypted */
196
197         EVP_CIPHER *dec;        /* date encryption cipher */
198         int key_len;            /* key length */
199         unsigned char *key;     /* key */
200         /*-
201             unused, and wrong size
202            unsigned char iv[8]; */
203
204         
205         int  data_enc;          /* is the data encrypted */
206         int data_len;
207         unsigned char *data;
208         } PEM_CTX;
209
210 /* These macros make the PEM_read/PEM_write functions easier to maintain and
211  * write. Now they are all implemented with either:
212  * IMPLEMENT_PEM_rw(...) or IMPLEMENT_PEM_rw_cb(...)
213  */
214
215 #ifdef OPENSSL_NO_FP_API
216
217 #define IMPLEMENT_PEM_read_fp(name, type, str, asn1) /**/
218 #define IMPLEMENT_PEM_write_fp(name, type, str, asn1) /**/
219 #define IMPLEMENT_PEM_write_fp_const(name, type, str, asn1) /**/
220 #define IMPLEMENT_PEM_write_cb_fp(name, type, str, asn1) /**/
221 #define IMPLEMENT_PEM_write_cb_fp_const(name, type, str, asn1) /**/
222
223 #else
224
225 #define IMPLEMENT_PEM_read_fp(name, type, str, asn1) \
226 type *PEM_read_##name(FILE *fp, type **x, pem_password_cb *cb, void *u)\
227 { \
228 return PEM_ASN1_read((d2i_of_void *)d2i_##asn1, str,fp,(void **)x,cb,u); \
229
230
231 #define IMPLEMENT_PEM_write_fp(name, type, str, asn1) \
232 int PEM_write_##name(FILE *fp, type *x) \
233 { \
234 return PEM_ASN1_write((i2d_of_void *)i2d_##asn1,str,fp,x,NULL,NULL,0,NULL,NULL); \
235 }
236
237 #define IMPLEMENT_PEM_write_fp_const(name, type, str, asn1) \
238 int PEM_write_##name(FILE *fp, const type *x) \
239 { \
240 return PEM_ASN1_write((i2d_of_void *)i2d_##asn1,str,fp,(void *)x,NULL,NULL,0,NULL,NULL); \
241 }
242
243 #define IMPLEMENT_PEM_write_cb_fp(name, type, str, asn1) \
244 int PEM_write_##name(FILE *fp, type *x, const EVP_CIPHER *enc, \
245              unsigned char *kstr, int klen, pem_password_cb *cb, \
246                   void *u) \
247         { \
248         return PEM_ASN1_write((i2d_of_void *)i2d_##asn1,str,fp,x,enc,kstr,klen,cb,u); \
249         }
250
251 #define IMPLEMENT_PEM_write_cb_fp_const(name, type, str, asn1) \
252 int PEM_write_##name(FILE *fp, type *x, const EVP_CIPHER *enc, \
253              unsigned char *kstr, int klen, pem_password_cb *cb, \
254                   void *u) \
255         { \
256         return PEM_ASN1_write((i2d_of_void *)i2d_##asn1,str,fp,x,enc,kstr,klen,cb,u); \
257         }
258
259 #endif
260
261 #define IMPLEMENT_PEM_read_bio(name, type, str, asn1) \
262 type *PEM_read_bio_##name(BIO *bp, type **x, pem_password_cb *cb, void *u)\
263 { \
264 return PEM_ASN1_read_bio((d2i_of_void *)d2i_##asn1, str,bp,(void **)x,cb,u); \
265 }
266
267 #define IMPLEMENT_PEM_write_bio(name, type, str, asn1) \
268 int PEM_write_bio_##name(BIO *bp, type *x) \
269 { \
270 return PEM_ASN1_write_bio((i2d_of_void *)i2d_##asn1,str,bp,x,NULL,NULL,0,NULL,NULL); \
271 }
272
273 #define IMPLEMENT_PEM_write_bio_const(name, type, str, asn1) \
274 int PEM_write_bio_##name(BIO *bp, const type *x) \
275 { \
276 return PEM_ASN1_write_bio((i2d_of_void *)i2d_##asn1,str,bp,(void *)x,NULL,NULL,0,NULL,NULL); \
277 }
278
279 #define IMPLEMENT_PEM_write_cb_bio(name, type, str, asn1) \
280 int PEM_write_bio_##name(BIO *bp, type *x, const EVP_CIPHER *enc, \
281              unsigned char *kstr, int klen, pem_password_cb *cb, void *u) \
282         { \
283         return PEM_ASN1_write_bio((i2d_of_void *)i2d_##asn1,str,bp,x,enc,kstr,klen,cb,u); \
284         }
285
286 #define IMPLEMENT_PEM_write_cb_bio_const(name, type, str, asn1) \
287 int PEM_write_bio_##name(BIO *bp, type *x, const EVP_CIPHER *enc, \
288              unsigned char *kstr, int klen, pem_password_cb *cb, void *u) \
289         { \
290         return PEM_ASN1_write_bio((i2d_of_void *)i2d_##asn1,str,bp,(void *)x,enc,kstr,klen,cb,u); \
291         }
292
293 #define IMPLEMENT_PEM_write(name, type, str, asn1) \
294         IMPLEMENT_PEM_write_bio(name, type, str, asn1) \
295         IMPLEMENT_PEM_write_fp(name, type, str, asn1) 
296
297 #define IMPLEMENT_PEM_write_const(name, type, str, asn1) \
298         IMPLEMENT_PEM_write_bio_const(name, type, str, asn1) \
299         IMPLEMENT_PEM_write_fp_const(name, type, str, asn1) 
300
301 #define IMPLEMENT_PEM_write_cb(name, type, str, asn1) \
302         IMPLEMENT_PEM_write_cb_bio(name, type, str, asn1) \
303         IMPLEMENT_PEM_write_cb_fp(name, type, str, asn1) 
304
305 #define IMPLEMENT_PEM_write_cb_const(name, type, str, asn1) \
306         IMPLEMENT_PEM_write_cb_bio_const(name, type, str, asn1) \
307         IMPLEMENT_PEM_write_cb_fp_const(name, type, str, asn1) 
308
309 #define IMPLEMENT_PEM_read(name, type, str, asn1) \
310         IMPLEMENT_PEM_read_bio(name, type, str, asn1) \
311         IMPLEMENT_PEM_read_fp(name, type, str, asn1) 
312
313 #define IMPLEMENT_PEM_rw(name, type, str, asn1) \
314         IMPLEMENT_PEM_read(name, type, str, asn1) \
315         IMPLEMENT_PEM_write(name, type, str, asn1)
316
317 #define IMPLEMENT_PEM_rw_const(name, type, str, asn1) \
318         IMPLEMENT_PEM_read(name, type, str, asn1) \
319         IMPLEMENT_PEM_write_const(name, type, str, asn1)
320
321 #define IMPLEMENT_PEM_rw_cb(name, type, str, asn1) \
322         IMPLEMENT_PEM_read(name, type, str, asn1) \
323         IMPLEMENT_PEM_write_cb(name, type, str, asn1)
324
325 /* These are the same except they are for the declarations */
326
327 #if defined(OPENSSL_NO_FP_API)
328
329 #define DECLARE_PEM_read_fp(name, type) /**/
330 #define DECLARE_PEM_write_fp(name, type) /**/
331 #define DECLARE_PEM_write_cb_fp(name, type) /**/
332
333 #else
334
335 #define DECLARE_PEM_read_fp(name, type) \
336         type *PEM_read_##name(FILE *fp, type **x, pem_password_cb *cb, void *u);
337
338 #define DECLARE_PEM_write_fp(name, type) \
339         int PEM_write_##name(FILE *fp, type *x);
340
341 #define DECLARE_PEM_write_fp_const(name, type) \
342         int PEM_write_##name(FILE *fp, const type *x);
343
344 #define DECLARE_PEM_write_cb_fp(name, type) \
345         int PEM_write_##name(FILE *fp, type *x, const EVP_CIPHER *enc, \
346              unsigned char *kstr, int klen, pem_password_cb *cb, void *u);
347
348 #endif
349
350 #ifndef OPENSSL_NO_BIO
351 #define DECLARE_PEM_read_bio(name, type) \
352         type *PEM_read_bio_##name(BIO *bp, type **x, pem_password_cb *cb, void *u);
353
354 #define DECLARE_PEM_write_bio(name, type) \
355         int PEM_write_bio_##name(BIO *bp, type *x);
356
357 #define DECLARE_PEM_write_bio_const(name, type) \
358         int PEM_write_bio_##name(BIO *bp, const type *x);
359
360 #define DECLARE_PEM_write_cb_bio(name, type) \
361         int PEM_write_bio_##name(BIO *bp, type *x, const EVP_CIPHER *enc, \
362              unsigned char *kstr, int klen, pem_password_cb *cb, void *u);
363
364 #else
365
366 #define DECLARE_PEM_read_bio(name, type) /**/
367 #define DECLARE_PEM_write_bio(name, type) /**/
368 #define DECLARE_PEM_write_bio_const(name, type) /**/
369 #define DECLARE_PEM_write_cb_bio(name, type) /**/
370
371 #endif
372
373 #define DECLARE_PEM_write(name, type) \
374         DECLARE_PEM_write_bio(name, type) \
375         DECLARE_PEM_write_fp(name, type) 
376
377 #define DECLARE_PEM_write_const(name, type) \
378         DECLARE_PEM_write_bio_const(name, type) \
379         DECLARE_PEM_write_fp_const(name, type)
380
381 #define DECLARE_PEM_write_cb(name, type) \
382         DECLARE_PEM_write_cb_bio(name, type) \
383         DECLARE_PEM_write_cb_fp(name, type) 
384
385 #define DECLARE_PEM_read(name, type) \
386         DECLARE_PEM_read_bio(name, type) \
387         DECLARE_PEM_read_fp(name, type)
388
389 #define DECLARE_PEM_rw(name, type) \
390         DECLARE_PEM_read(name, type) \
391         DECLARE_PEM_write(name, type)
392
393 #define DECLARE_PEM_rw_const(name, type) \
394         DECLARE_PEM_read(name, type) \
395         DECLARE_PEM_write_const(name, type)
396
397 #define DECLARE_PEM_rw_cb(name, type) \
398         DECLARE_PEM_read(name, type) \
399         DECLARE_PEM_write_cb(name, type)
400
401 #if 1
402 /* "userdata": new with OpenSSL 0.9.4 */
403 typedef int pem_password_cb(char *buf, int size, int rwflag, void *userdata);
404 #else
405 /* OpenSSL 0.9.3, 0.9.3a */
406 typedef int pem_password_cb(char *buf, int size, int rwflag);
407 #endif
408
409 int     PEM_get_EVP_CIPHER_INFO(char *header, EVP_CIPHER_INFO *cipher);
410 int     PEM_do_header (EVP_CIPHER_INFO *cipher, unsigned char *data,long *len,
411         pem_password_cb *callback,void *u);
412
413 #ifndef OPENSSL_NO_BIO
414 int     PEM_read_bio(BIO *bp, char **name, char **header,
415                 unsigned char **data,long *len);
416 int     PEM_write_bio(BIO *bp,const char *name,char *hdr,unsigned char *data,
417                 long len);
418 int PEM_bytes_read_bio(unsigned char **pdata, long *plen, char **pnm, const char *name, BIO *bp,
419              pem_password_cb *cb, void *u);
420 void *  PEM_ASN1_read_bio(d2i_of_void *d2i, const char *name, BIO *bp,
421                           void **x, pem_password_cb *cb, void *u);
422 int     PEM_ASN1_write_bio(i2d_of_void *i2d,const char *name,BIO *bp, void *x,
423                            const EVP_CIPHER *enc,unsigned char *kstr,int klen,
424                            pem_password_cb *cb, void *u);
425
426 STACK_OF(X509_INFO) *   PEM_X509_INFO_read_bio(BIO *bp, STACK_OF(X509_INFO) *sk, pem_password_cb *cb, void *u);
427 int     PEM_X509_INFO_write_bio(BIO *bp,X509_INFO *xi, EVP_CIPHER *enc,
428                 unsigned char *kstr, int klen, pem_password_cb *cd, void *u);
429 #endif
430
431 int     PEM_read(FILE *fp, char **name, char **header,
432                 unsigned char **data,long *len);
433 int     PEM_write(FILE *fp,char *name,char *hdr,unsigned char *data,long len);
434 void *  PEM_ASN1_read(d2i_of_void *d2i, const char *name, FILE *fp, void **x,
435                       pem_password_cb *cb, void *u);
436 int     PEM_ASN1_write(i2d_of_void *i2d,const char *name,FILE *fp,
437                        void *x,const EVP_CIPHER *enc,unsigned char *kstr,
438                        int klen,pem_password_cb *callback, void *u);
439 STACK_OF(X509_INFO) *   PEM_X509_INFO_read(FILE *fp, STACK_OF(X509_INFO) *sk,
440         pem_password_cb *cb, void *u);
441
442 int     PEM_SealInit(PEM_ENCODE_SEAL_CTX *ctx, EVP_CIPHER *type,
443                 EVP_MD *md_type, unsigned char **ek, int *ekl,
444                 unsigned char *iv, EVP_PKEY **pubk, int npubk);
445 void    PEM_SealUpdate(PEM_ENCODE_SEAL_CTX *ctx, unsigned char *out, int *outl,
446                 unsigned char *in, int inl);
447 int     PEM_SealFinal(PEM_ENCODE_SEAL_CTX *ctx, unsigned char *sig,int *sigl,
448                 unsigned char *out, int *outl, EVP_PKEY *priv);
449
450 void    PEM_SignInit(EVP_MD_CTX *ctx, EVP_MD *type);
451 void    PEM_SignUpdate(EVP_MD_CTX *ctx,unsigned char *d,unsigned int cnt);
452 int     PEM_SignFinal(EVP_MD_CTX *ctx, unsigned char *sigret,
453                 unsigned int *siglen, EVP_PKEY *pkey);
454
455 int     PEM_def_callback(char *buf, int num, int w, void *key);
456 void    PEM_proc_type(char *buf, int type);
457 void    PEM_dek_info(char *buf, const char *type, int len, char *str);
458
459
460 #include <openssl/symhacks.h>
461
462 DECLARE_PEM_rw(X509, X509)
463
464 DECLARE_PEM_rw(X509_AUX, X509)
465
466 DECLARE_PEM_rw(X509_CERT_PAIR, X509_CERT_PAIR)
467
468 DECLARE_PEM_rw(X509_REQ, X509_REQ)
469 DECLARE_PEM_write(X509_REQ_NEW, X509_REQ)
470
471 DECLARE_PEM_rw(X509_CRL, X509_CRL)
472
473 DECLARE_PEM_rw(PKCS7, PKCS7)
474
475 DECLARE_PEM_rw(NETSCAPE_CERT_SEQUENCE, NETSCAPE_CERT_SEQUENCE)
476
477 DECLARE_PEM_rw(PKCS8, X509_SIG)
478
479 DECLARE_PEM_rw(PKCS8_PRIV_KEY_INFO, PKCS8_PRIV_KEY_INFO)
480
481 #ifndef OPENSSL_NO_RSA
482
483 DECLARE_PEM_rw_cb(RSAPrivateKey, RSA)
484
485 DECLARE_PEM_rw_const(RSAPublicKey, RSA)
486 DECLARE_PEM_rw(RSA_PUBKEY, RSA)
487
488 #endif
489
490 #ifndef OPENSSL_NO_DSA
491
492 DECLARE_PEM_rw_cb(DSAPrivateKey, DSA)
493
494 DECLARE_PEM_rw(DSA_PUBKEY, DSA)
495
496 DECLARE_PEM_rw_const(DSAparams, DSA)
497
498 #endif
499
500 #ifndef OPENSSL_NO_EC
501 DECLARE_PEM_rw_const(ECPKParameters, EC_GROUP)
502 DECLARE_PEM_rw_cb(ECPrivateKey, EC_KEY)
503 DECLARE_PEM_rw(EC_PUBKEY, EC_KEY)
504 #endif
505
506 #ifndef OPENSSL_NO_DH
507
508 DECLARE_PEM_rw_const(DHparams, DH)
509
510 #endif
511
512 DECLARE_PEM_rw_cb(PrivateKey, EVP_PKEY)
513
514 DECLARE_PEM_rw(PUBKEY, EVP_PKEY)
515
516 int PEM_write_bio_PKCS8PrivateKey_nid(BIO *bp, EVP_PKEY *x, int nid,
517                                   char *kstr, int klen,
518                                   pem_password_cb *cb, void *u);
519 int PEM_write_bio_PKCS8PrivateKey(BIO *, EVP_PKEY *, const EVP_CIPHER *,
520                                   char *, int, pem_password_cb *, void *);
521 int i2d_PKCS8PrivateKey_bio(BIO *bp, EVP_PKEY *x, const EVP_CIPHER *enc,
522                                   char *kstr, int klen,
523                                   pem_password_cb *cb, void *u);
524 int i2d_PKCS8PrivateKey_nid_bio(BIO *bp, EVP_PKEY *x, int nid,
525                                   char *kstr, int klen,
526                                   pem_password_cb *cb, void *u);
527 EVP_PKEY *d2i_PKCS8PrivateKey_bio(BIO *bp, EVP_PKEY **x, pem_password_cb *cb, void *u);
528
529 int i2d_PKCS8PrivateKey_fp(FILE *fp, EVP_PKEY *x, const EVP_CIPHER *enc,
530                                   char *kstr, int klen,
531                                   pem_password_cb *cb, void *u);
532 int i2d_PKCS8PrivateKey_nid_fp(FILE *fp, EVP_PKEY *x, int nid,
533                                   char *kstr, int klen,
534                                   pem_password_cb *cb, void *u);
535 int PEM_write_PKCS8PrivateKey_nid(FILE *fp, EVP_PKEY *x, int nid,
536                                   char *kstr, int klen,
537                                   pem_password_cb *cb, void *u);
538
539 EVP_PKEY *d2i_PKCS8PrivateKey_fp(FILE *fp, EVP_PKEY **x, pem_password_cb *cb, void *u);
540
541 int PEM_write_PKCS8PrivateKey(FILE *fp,EVP_PKEY *x,const EVP_CIPHER *enc,
542                               char *kstr,int klen, pem_password_cb *cd, void *u);
543
544 EVP_PKEY *PEM_read_bio_Parameters(BIO *bp, EVP_PKEY **x);
545 int PEM_write_bio_Parameters(BIO *bp, EVP_PKEY *x);
546
547
548 EVP_PKEY *b2i_PrivateKey(const unsigned char **in, long length);
549 EVP_PKEY *b2i_PublicKey(const unsigned char **in, long length);
550 EVP_PKEY *b2i_PrivateKey_bio(BIO *in);
551 EVP_PKEY *b2i_PublicKey_bio(BIO *in);
552 int i2b_PrivateKey_bio(BIO *out, EVP_PKEY *pk);
553 int i2b_PublicKey_bio(BIO *out, EVP_PKEY *pk);
554 #ifndef OPENSSL_NO_RC4
555 EVP_PKEY *b2i_PVK_bio(BIO *in, pem_password_cb *cb, void *u);
556 int i2b_PVK_bio(BIO *out, EVP_PKEY *pk, int enclevel,
557                 pem_password_cb *cb, void *u);
558 #endif
559
560
561 /* BEGIN ERROR CODES */
562 /* The following lines are auto generated by the script mkerr.pl. Any changes
563  * made after this point may be overwritten when the script is next run.
564  */
565 void ERR_load_PEM_strings(void);
566
567 /* Error codes for the PEM functions. */
568
569 /* Function codes. */
570 #define PEM_F_B2I_DSS                                    127
571 #define PEM_F_B2I_PVK_BIO                                128
572 #define PEM_F_B2I_RSA                                    129
573 #define PEM_F_CHECK_BITLEN_DSA                           130
574 #define PEM_F_CHECK_BITLEN_RSA                           131
575 #define PEM_F_D2I_PKCS8PRIVATEKEY_BIO                    120
576 #define PEM_F_D2I_PKCS8PRIVATEKEY_FP                     121
577 #define PEM_F_DO_B2I                                     132
578 #define PEM_F_DO_B2I_BIO                                 133
579 #define PEM_F_DO_BLOB_HEADER                             134
580 #define PEM_F_DO_PK8PKEY                                 126
581 #define PEM_F_DO_PK8PKEY_FP                              125
582 #define PEM_F_DO_PVK_BODY                                135
583 #define PEM_F_DO_PVK_HEADER                              136
584 #define PEM_F_I2B_PVK                                    137
585 #define PEM_F_I2B_PVK_BIO                                138
586 #define PEM_F_LOAD_IV                                    101
587 #define PEM_F_PEM_ASN1_READ                              102
588 #define PEM_F_PEM_ASN1_READ_BIO                          103
589 #define PEM_F_PEM_ASN1_WRITE                             104
590 #define PEM_F_PEM_ASN1_WRITE_BIO                         105
591 #define PEM_F_PEM_DEF_CALLBACK                           100
592 #define PEM_F_PEM_DO_HEADER                              106
593 #define PEM_F_PEM_F_PEM_WRITE_PKCS8PRIVATEKEY            118
594 #define PEM_F_PEM_GET_EVP_CIPHER_INFO                    107
595 #define PEM_F_PEM_PK8PKEY                                119
596 #define PEM_F_PEM_READ                                   108
597 #define PEM_F_PEM_READ_BIO                               109
598 #define PEM_F_PEM_READ_BIO_PARAMETERS                    140
599 #define PEM_F_PEM_READ_BIO_PRIVATEKEY                    123
600 #define PEM_F_PEM_READ_PRIVATEKEY                        124
601 #define PEM_F_PEM_SEALFINAL                              110
602 #define PEM_F_PEM_SEALINIT                               111
603 #define PEM_F_PEM_SIGNFINAL                              112
604 #define PEM_F_PEM_WRITE                                  113
605 #define PEM_F_PEM_WRITE_BIO                              114
606 #define PEM_F_PEM_WRITE_PRIVATEKEY                       139
607 #define PEM_F_PEM_X509_INFO_READ                         115
608 #define PEM_F_PEM_X509_INFO_READ_BIO                     116
609 #define PEM_F_PEM_X509_INFO_WRITE_BIO                    117
610
611 /* Reason codes. */
612 #define PEM_R_BAD_BASE64_DECODE                          100
613 #define PEM_R_BAD_DECRYPT                                101
614 #define PEM_R_BAD_END_LINE                               102
615 #define PEM_R_BAD_IV_CHARS                               103
616 #define PEM_R_BAD_MAGIC_NUMBER                           116
617 #define PEM_R_BAD_PASSWORD_READ                          104
618 #define PEM_R_BAD_VERSION_NUMBER                         117
619 #define PEM_R_BIO_WRITE_FAILURE                          118
620 #define PEM_R_CIPHER_IS_NULL                             127
621 #define PEM_R_ERROR_CONVERTING_PRIVATE_KEY               115
622 #define PEM_R_EXPECTING_PRIVATE_KEY_BLOB                 119
623 #define PEM_R_EXPECTING_PUBLIC_KEY_BLOB                  120
624 #define PEM_R_INCONSISTENT_HEADER                        121
625 #define PEM_R_KEYBLOB_HEADER_PARSE_ERROR                 122
626 #define PEM_R_KEYBLOB_TOO_SHORT                          123
627 #define PEM_R_NOT_DEK_INFO                               105
628 #define PEM_R_NOT_ENCRYPTED                              106
629 #define PEM_R_NOT_PROC_TYPE                              107
630 #define PEM_R_NO_START_LINE                              108
631 #define PEM_R_PROBLEMS_GETTING_PASSWORD                  109
632 #define PEM_R_PUBLIC_KEY_NO_RSA                          110
633 #define PEM_R_PVK_DATA_TOO_SHORT                         124
634 #define PEM_R_PVK_TOO_SHORT                              125
635 #define PEM_R_READ_KEY                                   111
636 #define PEM_R_SHORT_HEADER                               112
637 #define PEM_R_UNSUPPORTED_CIPHER                         113
638 #define PEM_R_UNSUPPORTED_ENCRYPTION                     114
639 #define PEM_R_UNSUPPORTED_KEY_COMPONENTS                 126
640
641 #ifdef  __cplusplus
642 }
643 #endif
644 #endif