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_PKCS8        "ENCRYPTED PRIVATE KEY"
 129 #define PEM_STRING_PKCS8INF     "PRIVATE KEY"
 130 #define PEM_STRING_DHPARAMS     "DH PARAMETERS"
 131 #define PEM_STRING_SSL_SESSION  "SSL SESSION PARAMETERS"
 132 #define PEM_STRING_DSAPARAMS    "DSA PARAMETERS"
 133 #define PEM_STRING_ECDSA_PUBLIC "ECDSA PUBLIC KEY"
 134 #define PEM_STRING_ECPARAMETERS "EC PARAMETERS"
 135 #define PEM_STRING_ECPRIVATEKEY "EC PRIVATE KEY"
 136 #define PEM_STRING_PARAMETERS   "PARAMETERS"
 137
 138   /* Note that this structure is initialised by PEM_SealInit and cleaned up
 139      by PEM_SealFinal (at least for now) */
 140 typedef struct PEM_Encode_Seal_st
 141         {
 142         EVP_ENCODE_CTX encode;
 143         EVP_MD_CTX md;
 144         EVP_CIPHER_CTX cipher;
 145         } PEM_ENCODE_SEAL_CTX;
 146
 147 /* enc_type is one off */
 148 #define PEM_TYPE_ENCRYPTED      10
 149 #define PEM_TYPE_MIC_ONLY       20
 150 #define PEM_TYPE_MIC_CLEAR      30
 151 #define PEM_TYPE_CLEAR          40
 152
 153 typedef struct pem_recip_st
 154         {
 155         char *name;
 156         X509_NAME *dn;
 157
 158         int cipher;
 159         int key_enc;
 160         /*      char iv[8]; unused and wrong size */
 161         } PEM_USER;
 162
 163 typedef struct pem_ctx_st
 164         {
 165         int type;               /* what type of object */
 166
 167         struct  {
 168                 int version;
 169                 int mode;
 170                 } proc_type;
 171
 172         char *domain;
 173
 174         struct  {
 175                 int cipher;
 176         /* unused, and wrong size
 177            unsigned char iv[8]; */
 178                 } DEK_info;
 179
 180         PEM_USER *originator;
 181
 182         int num_recipient;
 183         PEM_USER **recipient;
 184
 185 #ifndef OPENSSL_NO_STACK
 186         STACK *x509_chain;      /* certificate chain */
 187 #else
 188         char *x509_chain;       /* certificate chain */
 189 #endif
 190         EVP_MD *md;             /* signature type */
 191
 192         int md_enc;             /* is the md encrypted or not? */
 193         int md_len;             /* length of md_data */
 194         char *md_data;          /* message digest, could be pkey encrypted */
 195
 196         EVP_CIPHER *dec;        /* date encryption cipher */
 197         int key_len;            /* key length */
 198         unsigned char *key;     /* key */
 199         /* unused, and wrong size
 200            unsigned char iv[8]; */
 201
 202
 203         int  data_enc;          /* is the data encrypted */
 204         int data_len;
 205         unsigned char *data;
 206         } PEM_CTX;
 207
 208 /* These macros make the PEM_read/PEM_write functions easier to maintain and
 209  * write. Now they are all implemented with either:
 210  * IMPLEMENT_PEM_rw(...) or IMPLEMENT_PEM_rw_cb(...)
 211  */
 212
 213 #ifdef OPENSSL_NO_FP_API
 214
 215 #define IMPLEMENT_PEM_read_fp(name, type, str, asn1) /**/
 216 #define IMPLEMENT_PEM_write_fp(name, type, str, asn1) /**/
 217 #define IMPLEMENT_PEM_write_cb_fp(name, type, str, asn1) /**/
 218
 219 #else
 220
 221 #define IMPLEMENT_PEM_read_fp(name, type, str, asn1) \
 222 type *PEM_read_##name(FILE *fp, type **x, pem_password_cb *cb, void *u)\
 223 { \
 224 return(((type *(*)(D2I_OF(type),char *,FILE *,type **,pem_password_cb *,void *))openssl_fcast(PEM_ASN1_read))(d2i_##asn1, str,fp,x,cb,u)); \
 225 } \
 226
 227 #define IMPLEMENT_PEM_write_fp(name, type, str, asn1) \
 228 int PEM_write_##name(FILE *fp, type *x) \
 229 { \
 230 return(((int (*)(I2D_OF(type),const char *,FILE *,type *, const EVP_CIPHER *,unsigned char *,int, pem_password_cb *,void *))openssl_fcast(PEM_ASN1_write))(i2d_##asn1,str,fp,x,NULL,NULL,0,NULL,NULL)); \
 231 }
 232
 233 #define IMPLEMENT_PEM_write_fp_const(name, type, str, asn1) \
 234 int PEM_write_##name(FILE *fp, const type *x) \
 235 { \
 236 return(((int (*)(I2D_OF_const(type),const char *,FILE *, const type *, const EVP_CIPHER *,unsigned char *,int, pem_password_cb *,void *))openssl_fcast(PEM_ASN1_write))(i2d_##asn1,str,fp,x,NULL,NULL,0,NULL,NULL)); \
 237 }
 238
 239 #define IMPLEMENT_PEM_write_cb_fp(name, type, str, asn1) \
 240 int PEM_write_##name(FILE *fp, type *x, const EVP_CIPHER *enc, \
 241              unsigned char *kstr, int klen, pem_password_cb *cb, \
 242                   void *u) \
 243         { \
 244         return(((int (*)(I2D_OF(type),const char *,FILE *,type *, const EVP_CIPHER *,unsigned char *,int, pem_password_cb *,void *))openssl_fcast(PEM_ASN1_write))(i2d_##asn1,str,fp,x,enc,kstr,klen,cb,u)); \
 245         }
 246
 247 #define IMPLEMENT_PEM_write_cb_fp_const(name, type, str, asn1) \
 248 int PEM_write_##name(FILE *fp, type *x, const EVP_CIPHER *enc, \
 249              unsigned char *kstr, int klen, pem_password_cb *cb, \
 250                   void *u) \
 251         { \
 252         return(((int (*)(I2D_OF_const(type),const char *,FILE *,type *, const EVP_CIPHER *,unsigned char *,int, pem_password_cb *,void *))openssl_fcast(PEM_ASN1_write))(i2d_##asn1,str,fp,x,enc,kstr,klen,cb,u)); \
 253         }
 254
 255 #endif
 256
 257 #define IMPLEMENT_PEM_read_bio(name, type, str, asn1) \
 258 type *PEM_read_bio_##name(BIO *bp, type **x, pem_password_cb *cb, void *u)\
 259 { \
 260 return(((type *(*)(D2I_OF(type),const char *,BIO *,type **,pem_password_cb *,void *))openssl_fcast(PEM_ASN1_read_bio))(d2i_##asn1, str,bp,x,cb,u)); \
 261 }
 262
 263 #define IMPLEMENT_PEM_write_bio(name, type, str, asn1) \
 264 int PEM_write_bio_##name(BIO *bp, type *x) \
 265 { \
 266 return(((int (*)(I2D_OF(type),const char *,BIO *,type *, const EVP_CIPHER *,unsigned char *,int, pem_password_cb *,void *))openssl_fcast(PEM_ASN1_write_bio))(i2d_##asn1,str,bp,x,NULL,NULL,0,NULL,NULL)); \
 267 }
 268
 269 #define IMPLEMENT_PEM_write_bio_const(name, type, str, asn1) \
 270 int PEM_write_bio_##name(BIO *bp, const type *x) \
 271 { \
 272 return(((int (*)(I2D_OF_const(type),const char *,BIO *,const type *, const EVP_CIPHER *,unsigned char *,int, pem_password_cb *,void *))openssl_fcast(PEM_ASN1_write_bio))(i2d_##asn1,str,bp,x,NULL,NULL,0,NULL,NULL)); \
 273 }
 274
 275 #define IMPLEMENT_PEM_write_cb_bio(name, type, str, asn1) \
 276 int PEM_write_bio_##name(BIO *bp, type *x, const EVP_CIPHER *enc, \
 277              unsigned char *kstr, int klen, pem_password_cb *cb, void *u) \
 278         { \
 279         return(((int (*)(I2D_OF(type),const char *,BIO *,type *,const EVP_CIPHER *,unsigned char *,int,pem_password_cb *,void *))openssl_fcast(PEM_ASN1_write_bio))(i2d_##asn1,str,bp,x,enc,kstr,klen,cb,u)); \
 280         }
 281
 282 #define IMPLEMENT_PEM_write_cb_bio_const(name, type, str, asn1) \
 283 int PEM_write_bio_##name(BIO *bp, type *x, const EVP_CIPHER *enc, \
 284              unsigned char *kstr, int klen, pem_password_cb *cb, void *u) \
 285         { \
 286         return(((int (*)(I2D_OF_const(type),const char *,BIO *,type *,const EVP_CIPHER *,unsigned char *,int,pem_password_cb *,void *))openssl_fcast(PEM_ASN1_write_bio))(i2d_##asn1,str,bp,x,enc,kstr,klen,cb,u)); \
 287         }
 288
 289 #define IMPLEMENT_PEM_write(name, type, str, asn1) \
 290         IMPLEMENT_PEM_write_bio(name, type, str, asn1) \
 291         IMPLEMENT_PEM_write_fp(name, type, str, asn1)
 292
 293 #define IMPLEMENT_PEM_write_const(name, type, str, asn1) \
 294         IMPLEMENT_PEM_write_bio_const(name, type, str, asn1) \
 295         IMPLEMENT_PEM_write_fp_const(name, type, str, asn1)
 296
 297 #define IMPLEMENT_PEM_write_cb(name, type, str, asn1) \
 298         IMPLEMENT_PEM_write_cb_bio(name, type, str, asn1) \
 299         IMPLEMENT_PEM_write_cb_fp(name, type, str, asn1)
 300
 301 #define IMPLEMENT_PEM_write_cb_const(name, type, str, asn1) \
 302         IMPLEMENT_PEM_write_cb_bio_const(name, type, str, asn1) \
 303         IMPLEMENT_PEM_write_cb_fp_const(name, type, str, asn1)
 304
 305 #define IMPLEMENT_PEM_read(name, type, str, asn1) \
 306         IMPLEMENT_PEM_read_bio(name, type, str, asn1) \
 307         IMPLEMENT_PEM_read_fp(name, type, str, asn1)
 308
 309 #define IMPLEMENT_PEM_rw(name, type, str, asn1) \
 310         IMPLEMENT_PEM_read(name, type, str, asn1) \
 311         IMPLEMENT_PEM_write(name, type, str, asn1)
 312
 313 #define IMPLEMENT_PEM_rw_const(name, type, str, asn1) \
 314         IMPLEMENT_PEM_read(name, type, str, asn1) \
 315         IMPLEMENT_PEM_write_const(name, type, str, asn1)
 316
 317 #define IMPLEMENT_PEM_rw_cb(name, type, str, asn1) \
 318         IMPLEMENT_PEM_read(name, type, str, asn1) \
 319         IMPLEMENT_PEM_write_cb(name, type, str, asn1)
 320
 321 /* These are the same except they are for the declarations */
 322
 323 #if defined(OPENSSL_NO_FP_API)
 324
 325 #define DECLARE_PEM_read_fp(name, type) /**/
 326 #define DECLARE_PEM_write_fp(name, type) /**/
 327 #define DECLARE_PEM_write_cb_fp(name, type) /**/
 328
 329 #else
 330
 331 #define DECLARE_PEM_read_fp(name, type) \
 332         type *PEM_read_##name(FILE *fp, type **x, pem_password_cb *cb, void *u);
 333
 334 #define DECLARE_PEM_write_fp(name, type) \
 335         int PEM_write_##name(FILE *fp, type *x);
 336
 337 #define DECLARE_PEM_write_fp_const(name, type) \
 338         int PEM_write_##name(FILE *fp, const type *x);
 339
 340 #define DECLARE_PEM_write_cb_fp(name, type) \
 341         int PEM_write_##name(FILE *fp, type *x, const EVP_CIPHER *enc, \
 342              unsigned char *kstr, int klen, pem_password_cb *cb, void *u);
 343
 344 #endif
 345
 346 #ifndef OPENSSL_NO_BIO
 347 #define DECLARE_PEM_read_bio(name, type) \
 348         type *PEM_read_bio_##name(BIO *bp, type **x, pem_password_cb *cb, void *u);
 349
 350 #define DECLARE_PEM_write_bio(name, type) \
 351         int PEM_write_bio_##name(BIO *bp, type *x);
 352
 353 #define DECLARE_PEM_write_bio_const(name, type) \
 354         int PEM_write_bio_##name(BIO *bp, const type *x);
 355
 356 #define DECLARE_PEM_write_cb_bio(name, type) \
 357         int PEM_write_bio_##name(BIO *bp, type *x, const EVP_CIPHER *enc, \
 358              unsigned char *kstr, int klen, pem_password_cb *cb, void *u);
 359
 360 #else
 361
 362 #define DECLARE_PEM_read_bio(name, type) /**/
 363 #define DECLARE_PEM_write_bio(name, type) /**/
 364 #define DECLARE_PEM_write_cb_bio(name, type) /**/
 365
 366 #endif
 367
 368 #define DECLARE_PEM_write(name, type) \
 369         DECLARE_PEM_write_bio(name, type) \
 370         DECLARE_PEM_write_fp(name, type)
 371
 372 #define DECLARE_PEM_write_const(name, type) \
 373         DECLARE_PEM_write_bio_const(name, type) \
 374         DECLARE_PEM_write_fp_const(name, type)
 375
 376 #define DECLARE_PEM_write_cb(name, type) \
 377         DECLARE_PEM_write_cb_bio(name, type) \
 378         DECLARE_PEM_write_cb_fp(name, type)
 379
 380 #define DECLARE_PEM_read(name, type) \
 381         DECLARE_PEM_read_bio(name, type) \
 382         DECLARE_PEM_read_fp(name, type)
 383
 384 #define DECLARE_PEM_rw(name, type) \
 385         DECLARE_PEM_read(name, type) \
 386         DECLARE_PEM_write(name, type)
 387
 388 #define DECLARE_PEM_rw_const(name, type) \
 389         DECLARE_PEM_read(name, type) \
 390         DECLARE_PEM_write_const(name, type)
 391
 392 #define DECLARE_PEM_rw_cb(name, type) \
 393         DECLARE_PEM_read(name, type) \
 394         DECLARE_PEM_write_cb(name, type)
 395
 396 #ifdef SSLEAY_MACROS
 397
 398 #define PEM_write_SSL_SESSION(fp,x) \
 399                 PEM_ASN1_write((int (*)())i2d_SSL_SESSION, \
 400                         PEM_STRING_SSL_SESSION,fp, (char *)x, NULL,NULL,0,NULL,NULL)
 401 #define PEM_write_X509(fp,x) \
 402                 PEM_ASN1_write((int (*)())i2d_X509,PEM_STRING_X509,fp, \
 403                         (char *)x, NULL,NULL,0,NULL,NULL)
 404 #define PEM_write_X509_REQ(fp,x) PEM_ASN1_write( \
 405                 (int (*)())i2d_X509_REQ,PEM_STRING_X509_REQ,fp,(char *)x, \
 406                         NULL,NULL,0,NULL,NULL)
 407 #define PEM_write_X509_CRL(fp,x) \
 408                 PEM_ASN1_write((int (*)())i2d_X509_CRL,PEM_STRING_X509_CRL, \
 409                         fp,(char *)x, NULL,NULL,0,NULL,NULL)
 410 #define PEM_write_RSAPrivateKey(fp,x,enc,kstr,klen,cb,u) \
 411                 PEM_ASN1_write((int (*)())i2d_RSAPrivateKey,PEM_STRING_RSA,fp,\
 412                         (char *)x,enc,kstr,klen,cb,u)
 413 #define PEM_write_RSAPublicKey(fp,x) \
 414                 PEM_ASN1_write((int (*)())i2d_RSAPublicKey,\
 415                         PEM_STRING_RSA_PUBLIC,fp,(char *)x,NULL,NULL,0,NULL,NULL)
 416 #define PEM_write_DSAPrivateKey(fp,x,enc,kstr,klen,cb,u) \
 417                 PEM_ASN1_write((int (*)())i2d_DSAPrivateKey,PEM_STRING_DSA,fp,\
 418                         (char *)x,enc,kstr,klen,cb,u)
 419 #define PEM_write_PrivateKey(bp,x,enc,kstr,klen,cb,u) \
 420                 PEM_ASN1_write((int (*)())i2d_PrivateKey,\
 421                 (((x)->type == EVP_PKEY_DSA)?PEM_STRING_DSA:PEM_STRING_RSA),\
 422                         bp,(char *)x,enc,kstr,klen,cb,u)
 423 #define PEM_write_PKCS7(fp,x) \
 424                 PEM_ASN1_write((int (*)())i2d_PKCS7,PEM_STRING_PKCS7,fp, \
 425                         (char *)x, NULL,NULL,0,NULL,NULL)
 426 #define PEM_write_DHparams(fp,x) \
 427                 PEM_ASN1_write((int (*)())i2d_DHparams,PEM_STRING_DHPARAMS,fp,\
 428                         (char *)x,NULL,NULL,0,NULL,NULL)
 429
 430 #define PEM_write_NETSCAPE_CERT_SEQUENCE(fp,x) \
 431                 PEM_ASN1_write((int (*)())i2d_NETSCAPE_CERT_SEQUENCE, \
 432                         PEM_STRING_X509,fp, \
 433                         (char *)x, NULL,NULL,0,NULL,NULL)
 434
 435 #define PEM_read_SSL_SESSION(fp,x,cb,u) (SSL_SESSION *)PEM_ASN1_read( \
 436         (char *(*)())d2i_SSL_SESSION,PEM_STRING_SSL_SESSION,fp,(char **)x,cb,u)
 437 #define PEM_read_X509(fp,x,cb,u) (X509 *)PEM_ASN1_read( \
 438         (char *(*)())d2i_X509,PEM_STRING_X509,fp,(char **)x,cb,u)
 439 #define PEM_read_X509_REQ(fp,x,cb,u) (X509_REQ *)PEM_ASN1_read( \
 440         (char *(*)())d2i_X509_REQ,PEM_STRING_X509_REQ,fp,(char **)x,cb,u)
 441 #define PEM_read_X509_CRL(fp,x,cb,u) (X509_CRL *)PEM_ASN1_read( \
 442         (char *(*)())d2i_X509_CRL,PEM_STRING_X509_CRL,fp,(char **)x,cb,u)
 443 #define PEM_read_RSAPrivateKey(fp,x,cb,u) (RSA *)PEM_ASN1_read( \
 444         (char *(*)())d2i_RSAPrivateKey,PEM_STRING_RSA,fp,(char **)x,cb,u)
 445 #define PEM_read_RSAPublicKey(fp,x,cb,u) (RSA *)PEM_ASN1_read( \
 446         (char *(*)())d2i_RSAPublicKey,PEM_STRING_RSA_PUBLIC,fp,(char **)x,cb,u)
 447 #define PEM_read_DSAPrivateKey(fp,x,cb,u) (DSA *)PEM_ASN1_read( \
 448         (char *(*)())d2i_DSAPrivateKey,PEM_STRING_DSA,fp,(char **)x,cb,u)
 449 #define PEM_read_PrivateKey(fp,x,cb,u) (EVP_PKEY *)PEM_ASN1_read( \
 450         (char *(*)())d2i_PrivateKey,PEM_STRING_EVP_PKEY,fp,(char **)x,cb,u)
 451 #define PEM_read_PKCS7(fp,x,cb,u) (PKCS7 *)PEM_ASN1_read( \
 452         (char *(*)())d2i_PKCS7,PEM_STRING_PKCS7,fp,(char **)x,cb,u)
 453 #define PEM_read_DHparams(fp,x,cb,u) (DH *)PEM_ASN1_read( \
 454         (char *(*)())d2i_DHparams,PEM_STRING_DHPARAMS,fp,(char **)x,cb,u)
 455
 456 #define PEM_read_NETSCAPE_CERT_SEQUENCE(fp,x,cb,u) \
 457                 (NETSCAPE_CERT_SEQUENCE *)PEM_ASN1_read( \
 458         (char *(*)())d2i_NETSCAPE_CERT_SEQUENCE,PEM_STRING_X509,fp,\
 459                                                         (char **)x,cb,u)
 460
 461 #define PEM_write_bio_X509(bp,x) \
 462                 PEM_ASN1_write_bio((int (*)())i2d_X509,PEM_STRING_X509,bp, \
 463                         (char *)x, NULL,NULL,0,NULL,NULL)
 464 #define PEM_write_bio_X509_REQ(bp,x) PEM_ASN1_write_bio( \
 465                 (int (*)())i2d_X509_REQ,PEM_STRING_X509_REQ,bp,(char *)x, \
 466                         NULL,NULL,0,NULL,NULL)
 467 #define PEM_write_bio_X509_CRL(bp,x) \
 468                 PEM_ASN1_write_bio((int (*)())i2d_X509_CRL,PEM_STRING_X509_CRL,\
 469                         bp,(char *)x, NULL,NULL,0,NULL,NULL)
 470 #define PEM_write_bio_RSAPrivateKey(bp,x,enc,kstr,klen,cb,u) \
 471                 PEM_ASN1_write_bio((int (*)())i2d_RSAPrivateKey,PEM_STRING_RSA,\
 472                         bp,(char *)x,enc,kstr,klen,cb,u)
 473 #define PEM_write_bio_RSAPublicKey(bp,x) \
 474                 PEM_ASN1_write_bio((int (*)())i2d_RSAPublicKey, \
 475                         PEM_STRING_RSA_PUBLIC,\
 476                         bp,(char *)x,NULL,NULL,0,NULL,NULL)
 477 #define PEM_write_bio_DSAPrivateKey(bp,x,enc,kstr,klen,cb,u) \
 478                 PEM_ASN1_write_bio((int (*)())i2d_DSAPrivateKey,PEM_STRING_DSA,\
 479                         bp,(char *)x,enc,kstr,klen,cb,u)
 480 #define PEM_write_bio_PrivateKey(bp,x,enc,kstr,klen,cb,u) \
 481                 PEM_ASN1_write_bio((int (*)())i2d_PrivateKey,\
 482                 (((x)->type == EVP_PKEY_DSA)?PEM_STRING_DSA:PEM_STRING_RSA),\
 483                         bp,(char *)x,enc,kstr,klen,cb,u)
 484 #define PEM_write_bio_PKCS7(bp,x) \
 485                 PEM_ASN1_write_bio((int (*)())i2d_PKCS7,PEM_STRING_PKCS7,bp, \
 486                         (char *)x, NULL,NULL,0,NULL,NULL)
 487 #define PEM_write_bio_DHparams(bp,x) \
 488                 PEM_ASN1_write_bio((int (*)())i2d_DHparams,PEM_STRING_DHPARAMS,\
 489                         bp,(char *)x,NULL,NULL,0,NULL,NULL)
 490 #define PEM_write_bio_DSAparams(bp,x) \
 491                 PEM_ASN1_write_bio((int (*)())i2d_DSAparams, \
 492                         PEM_STRING_DSAPARAMS,bp,(char *)x,NULL,NULL,0,NULL,NULL)
 493
 494 #define PEM_write_bio_NETSCAPE_CERT_SEQUENCE(bp,x) \
 495                 PEM_ASN1_write_bio((int (*)())i2d_NETSCAPE_CERT_SEQUENCE, \
 496                         PEM_STRING_X509,bp, \
 497                         (char *)x, NULL,NULL,0,NULL,NULL)
 498
 499 #define PEM_read_bio_X509(bp,x,cb,u) (X509 *)PEM_ASN1_read_bio( \
 500         (char *(*)())d2i_X509,PEM_STRING_X509,bp,(char **)x,cb,u)
 501 #define PEM_read_bio_X509_REQ(bp,x,cb,u) (X509_REQ *)PEM_ASN1_read_bio( \
 502         (char *(*)())d2i_X509_REQ,PEM_STRING_X509_REQ,bp,(char **)x,cb,u)
 503 #define PEM_read_bio_X509_CRL(bp,x,cb,u) (X509_CRL *)PEM_ASN1_read_bio( \
 504         (char *(*)())d2i_X509_CRL,PEM_STRING_X509_CRL,bp,(char **)x,cb,u)
 505 #define PEM_read_bio_RSAPrivateKey(bp,x,cb,u) (RSA *)PEM_ASN1_read_bio( \
 506         (char *(*)())d2i_RSAPrivateKey,PEM_STRING_RSA,bp,(char **)x,cb,u)
 507 #define PEM_read_bio_RSAPublicKey(bp,x,cb,u) (RSA *)PEM_ASN1_read_bio( \
 508         (char *(*)())d2i_RSAPublicKey,PEM_STRING_RSA_PUBLIC,bp,(char **)x,cb,u)
 509 #define PEM_read_bio_DSAPrivateKey(bp,x,cb,u) (DSA *)PEM_ASN1_read_bio( \
 510         (char *(*)())d2i_DSAPrivateKey,PEM_STRING_DSA,bp,(char **)x,cb,u)
 511 #define PEM_read_bio_PrivateKey(bp,x,cb,u) (EVP_PKEY *)PEM_ASN1_read_bio( \
 512         (char *(*)())d2i_PrivateKey,PEM_STRING_EVP_PKEY,bp,(char **)x,cb,u)
 513
 514 #define PEM_read_bio_PKCS7(bp,x,cb,u) (PKCS7 *)PEM_ASN1_read_bio( \
 515         (char *(*)())d2i_PKCS7,PEM_STRING_PKCS7,bp,(char **)x,cb,u)
 516 #define PEM_read_bio_DHparams(bp,x,cb,u) (DH *)PEM_ASN1_read_bio( \
 517         (char *(*)())d2i_DHparams,PEM_STRING_DHPARAMS,bp,(char **)x,cb,u)
 518 #define PEM_read_bio_DSAparams(bp,x,cb,u) (DSA *)PEM_ASN1_read_bio( \
 519         (char *(*)())d2i_DSAparams,PEM_STRING_DSAPARAMS,bp,(char **)x,cb,u)
 520
 521 #define PEM_read_bio_NETSCAPE_CERT_SEQUENCE(bp,x,cb,u) \
 522                 (NETSCAPE_CERT_SEQUENCE *)PEM_ASN1_read_bio( \
 523         (char *(*)())d2i_NETSCAPE_CERT_SEQUENCE,PEM_STRING_X509,bp,\
 524                                                         (char **)x,cb,u)
 525
 526 #endif
 527
 528 #if 1
 529 /* "userdata": new with OpenSSL 0.9.4 */
 530 typedef int pem_password_cb(char *buf, int size, int rwflag, void *userdata);
 531 #else
 532 /* OpenSSL 0.9.3, 0.9.3a */
 533 typedef int pem_password_cb(char *buf, int size, int rwflag);
 534 #endif
 535
 536 int     PEM_get_EVP_CIPHER_INFO(char *header, EVP_CIPHER_INFO *cipher);
 537 int     PEM_do_header (EVP_CIPHER_INFO *cipher, unsigned char *data,long *len,
 538         pem_password_cb *callback,void *u);
 539
 540 #ifndef OPENSSL_NO_BIO
 541 int     PEM_read_bio(BIO *bp, char **name, char **header,
 542                 unsigned char **data,long *len);
 543 int     PEM_write_bio(BIO *bp,const char *name,char *hdr,unsigned char *data,
 544                 long len);
 545 int PEM_bytes_read_bio(unsigned char **pdata, long *plen, char **pnm, const char *name, BIO *bp,
 546              pem_password_cb *cb, void *u);
 547 void *  PEM_ASN1_read_bio(d2i_of_void *d2i, const char *name, BIO *bp,
 548                           void **x, pem_password_cb *cb, void *u);
 549 #define PEM_ASN1_read_bio_of(type,d2i,name,bp,x,cb,u) \
 550 ((type *(*)(D2I_OF(type),const char *,BIO *,type **,pem_password_cb *,void *))openssl_fcast(PEM_ASN1_read_bio))(d2i,name,bp,x,cb,u)
 551 int     PEM_ASN1_write_bio(i2d_of_void *i2d,const char *name,BIO *bp,char *x,
 552                            const EVP_CIPHER *enc,unsigned char *kstr,int klen,
 553                            pem_password_cb *cb, void *u);
 554 #define PEM_ASN1_write_bio_of(type,i2d,name,bp,x,enc,kstr,klen,cb,u) \
 555         ((int (*)(I2D_OF(type),const char *,BIO *,type *, const EVP_CIPHER *,unsigned char *,int, pem_password_cb *,void *))openssl_fcast(PEM_ASN1_write_bio))(i2d,name,bp,x,enc,kstr,klen,cb,u)
 556
 557 STACK_OF(X509_INFO) *   PEM_X509_INFO_read_bio(BIO *bp, STACK_OF(X509_INFO) *sk, pem_password_cb *cb, void *u);
 558 int     PEM_X509_INFO_write_bio(BIO *bp,X509_INFO *xi, EVP_CIPHER *enc,
 559                 unsigned char *kstr, int klen, pem_password_cb *cd, void *u);
 560 #endif
 561
 562 int     PEM_read(FILE *fp, char **name, char **header,
 563                 unsigned char **data,long *len);
 564 int     PEM_write(FILE *fp,char *name,char *hdr,unsigned char *data,long len);
 565 void *  PEM_ASN1_read(d2i_of_void *d2i, const char *name, FILE *fp, void **x,
 566                       pem_password_cb *cb, void *u);
 567 int     PEM_ASN1_write(i2d_of_void *i2d,const char *name,FILE *fp,
 568                        char *x,const EVP_CIPHER *enc,unsigned char *kstr,
 569                        int klen,pem_password_cb *callback, void *u);
 570 STACK_OF(X509_INFO) *   PEM_X509_INFO_read(FILE *fp, STACK_OF(X509_INFO) *sk,
 571         pem_password_cb *cb, void *u);
 572
 573 int     PEM_SealInit(PEM_ENCODE_SEAL_CTX *ctx, EVP_CIPHER *type,
 574                 EVP_MD *md_type, unsigned char **ek, int *ekl,
 575                 unsigned char *iv, EVP_PKEY **pubk, int npubk);
 576 void    PEM_SealUpdate(PEM_ENCODE_SEAL_CTX *ctx, unsigned char *out, int *outl,
 577                 unsigned char *in, int inl);
 578 int     PEM_SealFinal(PEM_ENCODE_SEAL_CTX *ctx, unsigned char *sig,int *sigl,
 579                 unsigned char *out, int *outl, EVP_PKEY *priv);
 580
 581 void    PEM_SignInit(EVP_MD_CTX *ctx, EVP_MD *type);
 582 void    PEM_SignUpdate(EVP_MD_CTX *ctx,unsigned char *d,unsigned int cnt);
 583 int     PEM_SignFinal(EVP_MD_CTX *ctx, unsigned char *sigret,
 584                 unsigned int *siglen, EVP_PKEY *pkey);
 585
 586 int     PEM_def_callback(char *buf, int num, int w, void *key);
 587 void    PEM_proc_type(char *buf, int type);
 588 void    PEM_dek_info(char *buf, const char *type, int len, char *str);
 589
 590 #ifndef SSLEAY_MACROS
 591
 592 #include <openssl/symhacks.h>
 593
 594 DECLARE_PEM_rw(X509, X509)
 595
 596 DECLARE_PEM_rw(X509_AUX, X509)
 597
 598 DECLARE_PEM_rw(X509_CERT_PAIR, X509_CERT_PAIR)
 599
 600 DECLARE_PEM_rw(X509_REQ, X509_REQ)
 601 DECLARE_PEM_write(X509_REQ_NEW, X509_REQ)
 602
 603 DECLARE_PEM_rw(X509_CRL, X509_CRL)
 604
 605 DECLARE_PEM_rw(PKCS7, PKCS7)
 606
 607 DECLARE_PEM_rw(NETSCAPE_CERT_SEQUENCE, NETSCAPE_CERT_SEQUENCE)
 608
 609 DECLARE_PEM_rw(PKCS8, X509_SIG)
 610
 611 DECLARE_PEM_rw(PKCS8_PRIV_KEY_INFO, PKCS8_PRIV_KEY_INFO)
 612
 613 #ifndef OPENSSL_NO_RSA
 614
 615 DECLARE_PEM_rw_cb(RSAPrivateKey, RSA)
 616
 617 DECLARE_PEM_rw_const(RSAPublicKey, RSA)
 618 DECLARE_PEM_rw(RSA_PUBKEY, RSA)
 619
 620 #endif
 621
 622 #ifndef OPENSSL_NO_DSA
 623
 624 DECLARE_PEM_rw_cb(DSAPrivateKey, DSA)
 625
 626 DECLARE_PEM_rw(DSA_PUBKEY, DSA)
 627
 628 DECLARE_PEM_rw_const(DSAparams, DSA)
 629
 630 #endif
 631
 632 #ifndef OPENSSL_NO_EC
 633 DECLARE_PEM_rw_const(ECPKParameters, EC_GROUP)
 634 DECLARE_PEM_rw_cb(ECPrivateKey, EC_KEY)
 635 DECLARE_PEM_rw(EC_PUBKEY, EC_KEY)
 636 #endif
 637
 638 #ifndef OPENSSL_NO_DH
 639
 640 DECLARE_PEM_rw_const(DHparams, DH)
 641
 642 #endif
 643
 644 DECLARE_PEM_rw_cb(PrivateKey, EVP_PKEY)
 645
 646 DECLARE_PEM_rw(PUBKEY, EVP_PKEY)
 647
 648 int PEM_write_bio_PKCS8PrivateKey_nid(BIO *bp, EVP_PKEY *x, int nid,
 649                                   char *kstr, int klen,
 650                                   pem_password_cb *cb, void *u);
 651 int PEM_write_bio_PKCS8PrivateKey(BIO *, EVP_PKEY *, const EVP_CIPHER *,
 652                                   char *, int, pem_password_cb *, void *);
 653 int i2d_PKCS8PrivateKey_bio(BIO *bp, EVP_PKEY *x, const EVP_CIPHER *enc,
 654                                   char *kstr, int klen,
 655                                   pem_password_cb *cb, void *u);
 656 int i2d_PKCS8PrivateKey_nid_bio(BIO *bp, EVP_PKEY *x, int nid,
 657                                   char *kstr, int klen,
 658                                   pem_password_cb *cb, void *u);
 659 EVP_PKEY *d2i_PKCS8PrivateKey_bio(BIO *bp, EVP_PKEY **x, pem_password_cb *cb, void *u);
 660
 661 int i2d_PKCS8PrivateKey_fp(FILE *fp, EVP_PKEY *x, const EVP_CIPHER *enc,
 662                                   char *kstr, int klen,
 663                                   pem_password_cb *cb, void *u);
 664 int i2d_PKCS8PrivateKey_nid_fp(FILE *fp, EVP_PKEY *x, int nid,
 665                                   char *kstr, int klen,
 666                                   pem_password_cb *cb, void *u);
 667 int PEM_write_PKCS8PrivateKey_nid(FILE *fp, EVP_PKEY *x, int nid,
 668                                   char *kstr, int klen,
 669                                   pem_password_cb *cb, void *u);
 670
 671 EVP_PKEY *d2i_PKCS8PrivateKey_fp(FILE *fp, EVP_PKEY **x, pem_password_cb *cb, void *u);
 672
 673 int PEM_write_PKCS8PrivateKey(FILE *fp,EVP_PKEY *x,const EVP_CIPHER *enc,
 674                               char *kstr,int klen, pem_password_cb *cd, void *u);
 675
 676 EVP_PKEY *PEM_read_bio_Parameters(BIO *bp, EVP_PKEY **x);
 677 int PEM_write_bio_Parameters(BIO *bp, EVP_PKEY *x);
 678
 679 #endif /* SSLEAY_MACROS */
 680
 681
 682 EVP_PKEY *b2i_PrivateKey(const unsigned char **in, long length);
 683 EVP_PKEY *b2i_PublicKey(const unsigned char **in, long length);
 684 EVP_PKEY *b2i_PrivateKey_bio(BIO *in);
 685 EVP_PKEY *b2i_PublicKey_bio(BIO *in);
 686 int i2b_PrivateKey_bio(BIO *out, EVP_PKEY *pk);
 687 int i2b_PublicKey_bio(BIO *out, EVP_PKEY *pk);
 688
 689 EVP_PKEY *b2i_PVK_bio(BIO *in, pem_password_cb *cb, void *u);
 690 int i2b_PVK_bio(BIO *out, EVP_PKEY *pk, int enclevel,
 691                 pem_password_cb *cb, void *u);
 692
 693
 694 /* BEGIN ERROR CODES */
 695 /* The following lines are auto generated by the script mkerr.pl. Any changes
 696  * made after this point may be overwritten when the script is next run.
 697  */
 698 void ERR_load_PEM_strings(void);
 699
 700 /* Error codes for the PEM functions. */
 701
 702 /* Function codes. */
 703 #define PEM_F_B2I_DSS                                    127
 704 #define PEM_F_B2I_PVK_BIO                                128
 705 #define PEM_F_B2I_RSA                                    129
 706 #define PEM_F_CHECK_BITLEN_DSA                           130
 707 #define PEM_F_CHECK_BITLEN_RSA                           131
 708 #define PEM_F_D2I_PKCS8PRIVATEKEY_BIO                    120
 709 #define PEM_F_D2I_PKCS8PRIVATEKEY_FP                     121
 710 #define PEM_F_DO_B2I                                     132
 711 #define PEM_F_DO_B2I_BIO                                 133
 712 #define PEM_F_DO_BLOB_HEADER                             134
 713 #define PEM_F_DO_PK8PKEY                                 126
 714 #define PEM_F_DO_PK8PKEY_FP                              125
 715 #define PEM_F_DO_PVK_BODY                                135
 716 #define PEM_F_DO_PVK_HEADER                              136
 717 #define PEM_F_I2B_PVK                                    137
 718 #define PEM_F_I2B_PVK_BIO                                138
 719 #define PEM_F_LOAD_IV                                    101
 720 #define PEM_F_PEM_ASN1_READ                              102
 721 #define PEM_F_PEM_ASN1_READ_BIO                          103
 722 #define PEM_F_PEM_ASN1_WRITE                             104
 723 #define PEM_F_PEM_ASN1_WRITE_BIO                         105
 724 #define PEM_F_PEM_DEF_CALLBACK                           100
 725 #define PEM_F_PEM_DO_HEADER                              106
 726 #define PEM_F_PEM_F_PEM_WRITE_PKCS8PRIVATEKEY            118
 727 #define PEM_F_PEM_GET_EVP_CIPHER_INFO                    107
 728 #define PEM_F_PEM_PK8PKEY                                119
 729 #define PEM_F_PEM_READ                                   108
 730 #define PEM_F_PEM_READ_BIO                               109
 731 #define PEM_F_PEM_READ_BIO_PARAMETERS                    140
 732 #define PEM_F_PEM_READ_BIO_PRIVATEKEY                    123
 733 #define PEM_F_PEM_READ_PRIVATEKEY                        124
 734 #define PEM_F_PEM_SEALFINAL                              110
 735 #define PEM_F_PEM_SEALINIT                               111
 736 #define PEM_F_PEM_SIGNFINAL                              112
 737 #define PEM_F_PEM_WRITE                                  113
 738 #define PEM_F_PEM_WRITE_BIO                              114
 739 #define PEM_F_PEM_WRITE_PRIVATEKEY                       139
 740 #define PEM_F_PEM_X509_INFO_READ                         115
 741 #define PEM_F_PEM_X509_INFO_READ_BIO                     116
 742 #define PEM_F_PEM_X509_INFO_WRITE_BIO                    117
 743
 744 /* Reason codes. */
 745 #define PEM_R_BAD_BASE64_DECODE                          100
 746 #define PEM_R_BAD_DECRYPT                                101
 747 #define PEM_R_BAD_END_LINE                               102
 748 #define PEM_R_BAD_IV_CHARS                               103
 749 #define PEM_R_BAD_MAGIC_NUMBER                           116
 750 #define PEM_R_BAD_PASSWORD_READ                          104
 751 #define PEM_R_BAD_VERSION_NUMBER                         117
 752 #define PEM_R_BIO_WRITE_FAILURE                          118
 753 #define PEM_R_ERROR_CONVERTING_PRIVATE_KEY               115
 754 #define PEM_R_EXPECTING_PRIVATE_KEY_BLOB                 119
 755 #define PEM_R_EXPECTING_PUBLIC_KEY_BLOB                  120
 756 #define PEM_R_INCONSISTENT_HEADER                        121
 757 #define PEM_R_KEYBLOB_HEADER_PARSE_ERROR                 122
 758 #define PEM_R_KEYBLOB_TOO_SHORT                          123
 759 #define PEM_R_NOT_DEK_INFO                               105
 760 #define PEM_R_NOT_ENCRYPTED                              106
 761 #define PEM_R_NOT_PROC_TYPE                              107
 762 #define PEM_R_NO_START_LINE                              108
 763 #define PEM_R_PROBLEMS_GETTING_PASSWORD                  109
 764 #define PEM_R_PUBLIC_KEY_NO_RSA                          110
 765 #define PEM_R_PVK_DATA_TOO_SHORT                         124
 766 #define PEM_R_PVK_TOO_SHORT                              125
 767 #define PEM_R_READ_KEY                                   111
 768 #define PEM_R_SHORT_HEADER                               112
 769 #define PEM_R_UNSUPPORTED_CIPHER                         113
 770 #define PEM_R_UNSUPPORTED_ENCRYPTION                     114
 771 #define PEM_R_UNSUPPORTED_KEY_COMPONENTS                 126
 772
 773 #ifdef  __cplusplus
 774 }
 775 #endif
 776 #endif