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