1 /* crypto/x509/x509.h */
2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
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.
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).
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.
23 * Redistribution and use in source and binary forms, with or without
24 * modification, are permitted provided that the following conditions
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)"
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
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.]
67 #undef X509_REVOKED_get_ext_by_critical
68 #define X509_REVOKED_get_ext_by_critical X509_REVOKED_get_ext_by_critic
71 #include <openssl/stack.h>
72 #include <openssl/asn1.h>
73 #include <openssl/safestack.h>
76 #include <openssl/rsa.h>
80 #include <openssl/dsa.h>
84 #include <openssl/dh.h>
87 #include <openssl/evp.h>
91 /* Under Win32 this is defined in wincrypt.h */
95 #define X509_FILETYPE_PEM 1
96 #define X509_FILETYPE_ASN1 2
97 #define X509_FILETYPE_DEFAULT 3
99 #define X509v3_KU_DIGITAL_SIGNATURE 0x0080
100 #define X509v3_KU_NON_REPUDIATION 0x0040
101 #define X509v3_KU_KEY_ENCIPHERMENT 0x0020
102 #define X509v3_KU_DATA_ENCIPHERMENT 0x0010
103 #define X509v3_KU_KEY_AGREEMENT 0x0008
104 #define X509v3_KU_KEY_CERT_SIGN 0x0004
105 #define X509v3_KU_CRL_SIGN 0x0002
106 #define X509v3_KU_ENCIPHER_ONLY 0x0001
107 #define X509v3_KU_DECIPHER_ONLY 0x8000
108 #define X509v3_KU_UNDEF 0xffff
110 typedef struct X509_objects_st
117 typedef struct X509_algor_st
119 ASN1_OBJECT *algorithm;
120 ASN1_TYPE *parameter;
123 DECLARE_STACK_OF(X509_ALGOR)
124 DECLARE_ASN1_SET_OF(X509_ALGOR)
126 typedef struct X509_val_st
128 ASN1_UTCTIME *notBefore;
129 ASN1_UTCTIME *notAfter;
132 typedef struct X509_pubkey_st
135 ASN1_BIT_STRING *public_key;
139 typedef struct X509_sig_st
142 ASN1_OCTET_STRING *digest;
145 typedef struct X509_name_entry_st
150 int size; /* temp variable */
153 DECLARE_STACK_OF(X509_NAME_ENTRY)
154 DECLARE_ASN1_SET_OF(X509_NAME_ENTRY)
156 /* we always keep X509_NAMEs in 2 forms. */
157 typedef struct X509_name_st
159 STACK_OF(X509_NAME_ENTRY) *entries;
160 int modified; /* true if 'bytes' needs to be built */
161 #ifdef HEADER_BUFFER_H
166 unsigned long hash; /* Keep the hash around for lookups */
169 DECLARE_STACK_OF(X509_NAME)
171 #define X509_EX_V_NETSCAPE_HACK 0x8000
172 #define X509_EX_V_INIT 0x0001
173 typedef struct X509_extension_st
178 ASN1_OCTET_STRING *value;
179 long argl; /* used when decoding */
180 char *argp; /* used when decoding */
181 void (*ex_free)(); /* clear argp stuff */
184 DECLARE_STACK_OF(X509_EXTENSION)
185 DECLARE_ASN1_SET_OF(X509_EXTENSION)
187 /* a sequence of these are used */
188 typedef struct x509_attributes_st
191 int set; /* 1 for a set, 0 for a single item (which is wrong) */
194 /* 1 */ STACK_OF(ASN1_TYPE) *set;
195 /* 0 */ ASN1_TYPE *single;
199 DECLARE_STACK_OF(X509_ATTRIBUTE)
200 DECLARE_ASN1_SET_OF(X509_ATTRIBUTE)
202 typedef struct X509_req_info_st
204 ASN1_INTEGER *version;
207 /* d=2 hl=2 l= 0 cons: cont: 00 */
208 STACK_OF(X509_ATTRIBUTE) *attributes; /* [ 0 ] */
212 typedef struct X509_req_st
214 X509_REQ_INFO *req_info;
216 ASN1_BIT_STRING *signature;
220 typedef struct x509_cinf_st
222 ASN1_INTEGER *version; /* [ 0 ] default of v1 */
223 ASN1_INTEGER *serialNumber;
224 X509_ALGOR *signature;
229 ASN1_BIT_STRING *issuerUID; /* [ 1 ] optional in v2 */
230 ASN1_BIT_STRING *subjectUID; /* [ 2 ] optional in v2 */
231 STACK_OF(X509_EXTENSION) *extensions; /* [ 3 ] optional in v3 */
234 typedef struct x509_st
236 X509_CINF *cert_info;
238 ASN1_BIT_STRING *signature;
244 DECLARE_STACK_OF(X509)
245 DECLARE_ASN1_SET_OF(X509)
247 typedef struct X509_revoked_st
249 ASN1_INTEGER *serialNumber;
250 ASN1_UTCTIME *revocationDate;
251 STACK_OF(X509_EXTENSION) /* optional */ *extensions;
252 int sequence; /* load sequence */
255 DECLARE_STACK_OF(X509_REVOKED)
256 DECLARE_ASN1_SET_OF(X509_REVOKED)
258 typedef struct X509_crl_info_st
260 ASN1_INTEGER *version;
263 ASN1_UTCTIME *lastUpdate;
264 ASN1_UTCTIME *nextUpdate;
265 STACK_OF(X509_REVOKED) *revoked;
266 STACK_OF(X509_EXTENSION) /* [0] */ *extensions;
269 typedef struct X509_crl_st
271 /* actual signature */
274 ASN1_BIT_STRING *signature;
278 typedef struct private_key_st
281 /* The PKCS#8 data types */
282 X509_ALGOR *enc_algor;
283 ASN1_OCTET_STRING *enc_pkey; /* encrypted pub key */
285 /* When decrypted, the following will not be NULL */
288 /* used to encrypt and decrypt */
291 int key_free; /* true if we should auto free key_data */
293 /* expanded version of 'enc_algor' */
294 EVP_CIPHER_INFO cipher;
299 #ifdef HEADER_ENVELOPE_H
300 typedef struct X509_info_st
306 EVP_CIPHER_INFO enc_cipher;
313 DECLARE_STACK_OF(X509_INFO)
316 /* The next 2 structures and their 8 routines were sent to me by
317 * Pat Richard <patr@x509.com> and are used to manipulate
318 * Netscapes spki strucutres - usefull if you are writing a CA web page
320 typedef struct Netscape_spkac_st
323 ASN1_IA5STRING *challenge; /* challenge sent in atlas >= PR2 */
326 typedef struct Netscape_spki_st
328 NETSCAPE_SPKAC *spkac; /* signed public key and challenge */
329 X509_ALGOR *sig_algor;
330 ASN1_BIT_STRING *signature;
333 /* Netscape certificate sequence structure */
334 typedef struct Netscape_certificate_sequence
337 STACK_OF(X509) *certs;
338 } NETSCAPE_CERT_SEQUENCE;
344 typedef struct CBCParameter_st
349 /* Password based encryption structure */
351 typedef struct PBEPARAM_st {
352 ASN1_OCTET_STRING *salt;
356 /* Password based encryption V2 structures */
358 typedef struct PBE2PARAM_st {
360 X509_ALGOR *encryption;
363 typedef struct PBKDF2PARAM_st {
364 ASN1_OCTET_STRING *salt;
366 ASN1_INTEGER *keylength;
371 /* PKCS#8 private key info structure */
373 typedef struct pkcs8_priv_key_info_st
375 int broken; /* Flag for various broken formats */
377 #define PKCS8_NO_OCTET 1
378 ASN1_INTEGER *version;
380 ASN1_TYPE *pkey; /* Should be OCTET STRING but some are broken */
381 STACK_OF(X509_ATTRIBUTE) *attributes;
382 } PKCS8_PRIV_KEY_INFO;
384 #include <openssl/x509_vfy.h>
385 #include <openssl/pkcs7.h>
388 #define X509_verify(a,r) ASN1_verify((int (*)())i2d_X509_CINF,a->sig_alg,\
389 a->signature,(char *)a->cert_info,r)
390 #define X509_REQ_verify(a,r) ASN1_verify((int (*)())i2d_X509_REQ_INFO, \
391 a->sig_alg,a->signature,(char *)a->req_info,r)
392 #define X509_CRL_verify(a,r) ASN1_verify((int (*)())i2d_X509_CRL_INFO, \
393 a->sig_alg, a->signature,(char *)a->crl,r)
395 #define X509_sign(x,pkey,md) \
396 ASN1_sign((int (*)())i2d_X509_CINF, x->cert_info->signature, \
397 x->sig_alg, x->signature, (char *)x->cert_info,pkey,md)
398 #define X509_REQ_sign(x,pkey,md) \
399 ASN1_sign((int (*)())i2d_X509_REQ_INFO,x->sig_alg, NULL, \
400 x->signature, (char *)x->req_info,pkey,md)
401 #define X509_CRL_sign(x,pkey,md) \
402 ASN1_sign((int (*)())i2d_X509_CRL_INFO,x->crl->sig_alg,x->sig_alg, \
403 x->signature, (char *)x->crl,pkey,md)
404 #define NETSCAPE_SPKI_sign(x,pkey,md) \
405 ASN1_sign((int (*)())i2d_NETSCAPE_SPKAC, x->sig_algor,NULL, \
406 x->signature, (char *)x->spkac,pkey,md)
408 #define X509_dup(x509) (X509 *)ASN1_dup((int (*)())i2d_X509, \
409 (char *(*)())d2i_X509,(char *)x509)
410 #define X509_ATTRIBUTE_dup(xa) (X509_ATTRIBUTE *)ASN1_dup(\
411 (int (*)())i2d_X509_ATTRIBUTE, \
412 (char *(*)())d2i_X509_ATTRIBUTE,(char *)xa)
413 #define X509_EXTENSION_dup(ex) (X509_EXTENSION *)ASN1_dup( \
414 (int (*)())i2d_X509_EXTENSION, \
415 (char *(*)())d2i_X509_EXTENSION,(char *)ex)
416 #define d2i_X509_fp(fp,x509) (X509 *)ASN1_d2i_fp((char *(*)())X509_new, \
417 (char *(*)())d2i_X509, (fp),(unsigned char **)(x509))
418 #define i2d_X509_fp(fp,x509) ASN1_i2d_fp(i2d_X509,fp,(unsigned char *)x509)
419 #define d2i_X509_bio(bp,x509) (X509 *)ASN1_d2i_bio((char *(*)())X509_new, \
420 (char *(*)())d2i_X509, (bp),(unsigned char **)(x509))
421 #define i2d_X509_bio(bp,x509) ASN1_i2d_bio(i2d_X509,bp,(unsigned char *)x509)
423 #define X509_CRL_dup(crl) (X509_CRL *)ASN1_dup((int (*)())i2d_X509_CRL, \
424 (char *(*)())d2i_X509_CRL,(char *)crl)
425 #define d2i_X509_CRL_fp(fp,crl) (X509_CRL *)ASN1_d2i_fp((char *(*)()) \
426 X509_CRL_new,(char *(*)())d2i_X509_CRL, (fp),\
427 (unsigned char **)(crl))
428 #define i2d_X509_CRL_fp(fp,crl) ASN1_i2d_fp(i2d_X509_CRL,fp,\
429 (unsigned char *)crl)
430 #define d2i_X509_CRL_bio(bp,crl) (X509_CRL *)ASN1_d2i_bio((char *(*)()) \
431 X509_CRL_new,(char *(*)())d2i_X509_CRL, (bp),\
432 (unsigned char **)(crl))
433 #define i2d_X509_CRL_bio(bp,crl) ASN1_i2d_bio(i2d_X509_CRL,bp,\
434 (unsigned char *)crl)
436 #define PKCS7_dup(p7) (PKCS7 *)ASN1_dup((int (*)())i2d_PKCS7, \
437 (char *(*)())d2i_PKCS7,(char *)p7)
438 #define d2i_PKCS7_fp(fp,p7) (PKCS7 *)ASN1_d2i_fp((char *(*)()) \
439 PKCS7_new,(char *(*)())d2i_PKCS7, (fp),\
440 (unsigned char **)(p7))
441 #define i2d_PKCS7_fp(fp,p7) ASN1_i2d_fp(i2d_PKCS7,fp,\
443 #define d2i_PKCS7_bio(bp,p7) (PKCS7 *)ASN1_d2i_bio((char *(*)()) \
444 PKCS7_new,(char *(*)())d2i_PKCS7, (bp),\
445 (unsigned char **)(p7))
446 #define i2d_PKCS7_bio(bp,p7) ASN1_i2d_bio(i2d_PKCS7,bp,\
449 #define X509_REQ_dup(req) (X509_REQ *)ASN1_dup((int (*)())i2d_X509_REQ, \
450 (char *(*)())d2i_X509_REQ,(char *)req)
451 #define d2i_X509_REQ_fp(fp,req) (X509_REQ *)ASN1_d2i_fp((char *(*)())\
452 X509_REQ_new, (char *(*)())d2i_X509_REQ, (fp),\
453 (unsigned char **)(req))
454 #define i2d_X509_REQ_fp(fp,req) ASN1_i2d_fp(i2d_X509_REQ,fp,\
455 (unsigned char *)req)
456 #define d2i_X509_REQ_bio(bp,req) (X509_REQ *)ASN1_d2i_bio((char *(*)())\
457 X509_REQ_new, (char *(*)())d2i_X509_REQ, (bp),\
458 (unsigned char **)(req))
459 #define i2d_X509_REQ_bio(bp,req) ASN1_i2d_bio(i2d_X509_REQ,bp,\
460 (unsigned char *)req)
462 #define RSAPublicKey_dup(rsa) (RSA *)ASN1_dup((int (*)())i2d_RSAPublicKey, \
463 (char *(*)())d2i_RSAPublicKey,(char *)rsa)
464 #define RSAPrivateKey_dup(rsa) (RSA *)ASN1_dup((int (*)())i2d_RSAPrivateKey, \
465 (char *(*)())d2i_RSAPrivateKey,(char *)rsa)
467 #define d2i_RSAPrivateKey_fp(fp,rsa) (RSA *)ASN1_d2i_fp((char *(*)())\
468 RSA_new,(char *(*)())d2i_RSAPrivateKey, (fp), \
469 (unsigned char **)(rsa))
470 #define i2d_RSAPrivateKey_fp(fp,rsa) ASN1_i2d_fp(i2d_RSAPrivateKey,fp, \
471 (unsigned char *)rsa)
472 #define d2i_RSAPrivateKey_bio(bp,rsa) (RSA *)ASN1_d2i_bio((char *(*)())\
473 RSA_new,(char *(*)())d2i_RSAPrivateKey, (bp), \
474 (unsigned char **)(rsa))
475 #define i2d_RSAPrivateKey_bio(bp,rsa) ASN1_i2d_bio(i2d_RSAPrivateKey,bp, \
476 (unsigned char *)rsa)
478 #define d2i_RSAPublicKey_fp(fp,rsa) (RSA *)ASN1_d2i_fp((char *(*)())\
479 RSA_new,(char *(*)())d2i_RSAPublicKey, (fp), \
480 (unsigned char **)(rsa))
481 #define i2d_RSAPublicKey_fp(fp,rsa) ASN1_i2d_fp(i2d_RSAPublicKey,fp, \
482 (unsigned char *)rsa)
483 #define d2i_RSAPublicKey_bio(bp,rsa) (RSA *)ASN1_d2i_bio((char *(*)())\
484 RSA_new,(char *(*)())d2i_RSAPublicKey, (bp), \
485 (unsigned char **)(rsa))
486 #define i2d_RSAPublicKey_bio(bp,rsa) ASN1_i2d_bio(i2d_RSAPublicKey,bp, \
487 (unsigned char *)rsa)
489 #define d2i_DSAPrivateKey_fp(fp,dsa) (DSA *)ASN1_d2i_fp((char *(*)())\
490 DSA_new,(char *(*)())d2i_DSAPrivateKey, (fp), \
491 (unsigned char **)(dsa))
492 #define i2d_DSAPrivateKey_fp(fp,dsa) ASN1_i2d_fp(i2d_DSAPrivateKey,fp, \
493 (unsigned char *)dsa)
494 #define d2i_DSAPrivateKey_bio(bp,dsa) (DSA *)ASN1_d2i_bio((char *(*)())\
495 DSA_new,(char *(*)())d2i_DSAPrivateKey, (bp), \
496 (unsigned char **)(dsa))
497 #define i2d_DSAPrivateKey_bio(bp,dsa) ASN1_i2d_bio(i2d_DSAPrivateKey,bp, \
498 (unsigned char *)dsa)
500 #define X509_ALGOR_dup(xn) (X509_ALGOR *)ASN1_dup((int (*)())i2d_X509_ALGOR,\
501 (char *(*)())d2i_X509_ALGOR,(char *)xn)
503 #define X509_NAME_dup(xn) (X509_NAME *)ASN1_dup((int (*)())i2d_X509_NAME, \
504 (char *(*)())d2i_X509_NAME,(char *)xn)
505 #define X509_NAME_ENTRY_dup(ne) (X509_NAME_ENTRY *)ASN1_dup( \
506 (int (*)())i2d_X509_NAME_ENTRY, \
507 (char *(*)())d2i_X509_NAME_ENTRY,\
510 #define X509_digest(data,type,md,len) \
511 ASN1_digest((int (*)())i2d_X509,type,(char *)data,md,len)
512 #define X509_NAME_digest(data,type,md,len) \
513 ASN1_digest((int (*)())i2d_X509_NAME,type,(char *)data,md,len)
514 #ifndef PKCS7_ISSUER_AND_SERIAL_digest
515 #define PKCS7_ISSUER_AND_SERIAL_digest(data,type,md,len) \
516 ASN1_digest((int (*)())i2d_PKCS7_ISSUER_AND_SERIAL,type,\
521 #define X509_EXT_PACK_UNKNOWN 1
522 #define X509_EXT_PACK_STRING 2
524 #define X509_get_version(x) ASN1_INTEGER_get((x)->cert_info->version)
525 /* #define X509_get_serialNumber(x) ((x)->cert_info->serialNumber) */
526 #define X509_get_notBefore(x) ((x)->cert_info->validity->notBefore)
527 #define X509_get_notAfter(x) ((x)->cert_info->validity->notAfter)
528 #define X509_extract_key(x) X509_get_pubkey(x) /*****/
529 #define X509_REQ_get_version(x) ASN1_INTEGER_get((x)->req_info->version)
530 #define X509_REQ_get_subject_name(x) ((x)->req_info->subject)
531 #define X509_REQ_extract_key(a) X509_REQ_get_pubkey(a)
532 #define X509_name_cmp(a,b) X509_NAME_cmp((a),(b))
533 #define X509_get_signature_type(x) EVP_PKEY_type(OBJ_obj2nid((x)->sig_alg->algorithm))
535 #define X509_CRL_get_version(x) ASN1_INTEGER_get((x)->crl->version)
536 #define X509_CRL_get_lastUpdate(x) ((x)->crl->lastUpdate)
537 #define X509_CRL_get_nextUpdate(x) ((x)->crl->nextUpdate)
538 #define X509_CRL_get_issuer(x) ((x)->crl->issuer)
539 #define X509_CRL_get_REVOKED(x) ((x)->crl->revoked)
541 /* This one is only used so that a binary form can output, as in
542 * i2d_X509_NAME(X509_get_X509_PUBKEY(x),&buf) */
543 #define X509_get_X509_PUBKEY(x) ((x)->cert_info->key)
546 #ifndef SSLEAY_MACROS
547 #ifdef HEADER_ENVELOPE_H
548 int X509_verify(X509 *a, EVP_PKEY *r);
549 const char *X509_verify_cert_error_string(long n);
551 int X509_REQ_verify(X509_REQ *a, EVP_PKEY *r);
552 int X509_CRL_verify(X509_CRL *a, EVP_PKEY *r);
553 int NETSCAPE_SPKI_verify(NETSCAPE_SPKI *a, EVP_PKEY *r);
555 int X509_sign(X509 *x, EVP_PKEY *pkey, const EVP_MD *md);
556 int X509_REQ_sign(X509_REQ *x, EVP_PKEY *pkey, const EVP_MD *md);
557 int X509_CRL_sign(X509_CRL *x, EVP_PKEY *pkey, const EVP_MD *md);
558 int NETSCAPE_SPKI_sign(NETSCAPE_SPKI *x, EVP_PKEY *pkey, const EVP_MD *md);
560 int X509_digest(X509 *data,EVP_MD *type,unsigned char *md,unsigned int *len);
561 int X509_NAME_digest(X509_NAME *data,EVP_MD *type,
562 unsigned char *md,unsigned int *len);
566 X509 *d2i_X509_fp(FILE *fp, X509 **x509);
567 int i2d_X509_fp(FILE *fp,X509 *x509);
568 X509_CRL *d2i_X509_CRL_fp(FILE *fp,X509_CRL **crl);
569 int i2d_X509_CRL_fp(FILE *fp,X509_CRL *crl);
570 X509_REQ *d2i_X509_REQ_fp(FILE *fp,X509_REQ **req);
571 int i2d_X509_REQ_fp(FILE *fp,X509_REQ *req);
573 RSA *d2i_RSAPrivateKey_fp(FILE *fp,RSA **rsa);
574 int i2d_RSAPrivateKey_fp(FILE *fp,RSA *rsa);
575 RSA *d2i_RSAPublicKey_fp(FILE *fp,RSA **rsa);
576 int i2d_RSAPublicKey_fp(FILE *fp,RSA *rsa);
579 DSA *d2i_DSAPrivateKey_fp(FILE *fp, DSA **dsa);
580 int i2d_DSAPrivateKey_fp(FILE *fp, DSA *dsa);
585 X509 *d2i_X509_bio(BIO *bp,X509 **x509);
586 int i2d_X509_bio(BIO *bp,X509 *x509);
587 X509_CRL *d2i_X509_CRL_bio(BIO *bp,X509_CRL **crl);
588 int i2d_X509_CRL_bio(BIO *bp,X509_CRL *crl);
589 X509_REQ *d2i_X509_REQ_bio(BIO *bp,X509_REQ **req);
590 int i2d_X509_REQ_bio(BIO *bp,X509_REQ *req);
592 RSA *d2i_RSAPrivateKey_bio(BIO *bp,RSA **rsa);
593 int i2d_RSAPrivateKey_bio(BIO *bp,RSA *rsa);
594 RSA *d2i_RSAPublicKey_bio(BIO *bp,RSA **rsa);
595 int i2d_RSAPublicKey_bio(BIO *bp,RSA *rsa);
598 DSA *d2i_DSAPrivateKey_bio(BIO *bp, DSA **dsa);
599 int i2d_DSAPrivateKey_bio(BIO *bp, DSA *dsa);
603 X509 *X509_dup(X509 *x509);
604 X509_ATTRIBUTE *X509_ATTRIBUTE_dup(X509_ATTRIBUTE *xa);
605 X509_EXTENSION *X509_EXTENSION_dup(X509_EXTENSION *ex);
606 X509_CRL *X509_CRL_dup(X509_CRL *crl);
607 X509_REQ *X509_REQ_dup(X509_REQ *req);
608 X509_ALGOR *X509_ALGOR_dup(X509_ALGOR *xn);
609 X509_NAME *X509_NAME_dup(X509_NAME *xn);
610 X509_NAME_ENTRY *X509_NAME_ENTRY_dup(X509_NAME_ENTRY *ne);
612 RSA *RSAPublicKey_dup(RSA *rsa);
613 RSA *RSAPrivateKey_dup(RSA *rsa);
616 #endif /* !SSLEAY_MACROS */
618 int X509_cmp_current_time(ASN1_UTCTIME *s);
619 ASN1_UTCTIME * X509_gmtime_adj(ASN1_UTCTIME *s, long adj);
621 const char * X509_get_default_cert_area(void );
622 const char * X509_get_default_cert_dir(void );
623 const char * X509_get_default_cert_file(void );
624 const char * X509_get_default_cert_dir_env(void );
625 const char * X509_get_default_cert_file_env(void );
626 const char * X509_get_default_private_dir(void );
628 X509_REQ * X509_to_X509_REQ(X509 *x, EVP_PKEY *pkey, EVP_MD *md);
629 X509 * X509_REQ_to_X509(X509_REQ *r, int days,EVP_PKEY *pkey);
630 void ERR_load_X509_strings(void );
632 X509_ALGOR * X509_ALGOR_new(void );
633 void X509_ALGOR_free(X509_ALGOR *a);
634 int i2d_X509_ALGOR(X509_ALGOR *a,unsigned char **pp);
635 X509_ALGOR * d2i_X509_ALGOR(X509_ALGOR **a,unsigned char **pp,
638 X509_VAL * X509_VAL_new(void );
639 void X509_VAL_free(X509_VAL *a);
640 int i2d_X509_VAL(X509_VAL *a,unsigned char **pp);
641 X509_VAL * d2i_X509_VAL(X509_VAL **a,unsigned char **pp,
644 X509_PUBKEY * X509_PUBKEY_new(void );
645 void X509_PUBKEY_free(X509_PUBKEY *a);
646 int i2d_X509_PUBKEY(X509_PUBKEY *a,unsigned char **pp);
647 X509_PUBKEY * d2i_X509_PUBKEY(X509_PUBKEY **a,unsigned char **pp,
649 int X509_PUBKEY_set(X509_PUBKEY **x, EVP_PKEY *pkey);
650 EVP_PKEY * X509_PUBKEY_get(X509_PUBKEY *key);
651 int X509_get_pubkey_parameters(EVP_PKEY *pkey,
652 STACK_OF(X509) *chain);
655 X509_SIG * X509_SIG_new(void );
656 void X509_SIG_free(X509_SIG *a);
657 int i2d_X509_SIG(X509_SIG *a,unsigned char **pp);
658 X509_SIG * d2i_X509_SIG(X509_SIG **a,unsigned char **pp,long length);
660 X509_REQ_INFO *X509_REQ_INFO_new(void);
661 void X509_REQ_INFO_free(X509_REQ_INFO *a);
662 int i2d_X509_REQ_INFO(X509_REQ_INFO *a,unsigned char **pp);
663 X509_REQ_INFO *d2i_X509_REQ_INFO(X509_REQ_INFO **a,unsigned char **pp,
666 X509_REQ * X509_REQ_new(void);
667 void X509_REQ_free(X509_REQ *a);
668 int i2d_X509_REQ(X509_REQ *a,unsigned char **pp);
669 X509_REQ * d2i_X509_REQ(X509_REQ **a,unsigned char **pp,long length);
671 X509_ATTRIBUTE *X509_ATTRIBUTE_new(void );
672 void X509_ATTRIBUTE_free(X509_ATTRIBUTE *a);
673 int i2d_X509_ATTRIBUTE(X509_ATTRIBUTE *a,unsigned char **pp);
674 X509_ATTRIBUTE *d2i_X509_ATTRIBUTE(X509_ATTRIBUTE **a,unsigned char **pp,
676 X509_ATTRIBUTE *X509_ATTRIBUTE_create(int nid, int atrtype, void *value);
679 X509_EXTENSION *X509_EXTENSION_new(void );
680 void X509_EXTENSION_free(X509_EXTENSION *a);
681 int i2d_X509_EXTENSION(X509_EXTENSION *a,unsigned char **pp);
682 X509_EXTENSION *d2i_X509_EXTENSION(X509_EXTENSION **a,unsigned char **pp,
685 X509_NAME_ENTRY *X509_NAME_ENTRY_new(void);
686 void X509_NAME_ENTRY_free(X509_NAME_ENTRY *a);
687 int i2d_X509_NAME_ENTRY(X509_NAME_ENTRY *a,unsigned char **pp);
688 X509_NAME_ENTRY *d2i_X509_NAME_ENTRY(X509_NAME_ENTRY **a,unsigned char **pp,
691 X509_NAME * X509_NAME_new(void);
692 void X509_NAME_free(X509_NAME *a);
693 int i2d_X509_NAME(X509_NAME *a,unsigned char **pp);
694 X509_NAME * d2i_X509_NAME(X509_NAME **a,unsigned char **pp,long length);
695 int X509_NAME_set(X509_NAME **xn, X509_NAME *name);
698 X509_CINF * X509_CINF_new(void);
699 void X509_CINF_free(X509_CINF *a);
700 int i2d_X509_CINF(X509_CINF *a,unsigned char **pp);
701 X509_CINF * d2i_X509_CINF(X509_CINF **a,unsigned char **pp,long length);
703 X509 * X509_new(void);
704 void X509_free(X509 *a);
705 int i2d_X509(X509 *a,unsigned char **pp);
706 X509 * d2i_X509(X509 **a,unsigned char **pp,long length);
708 X509_REVOKED * X509_REVOKED_new(void);
709 void X509_REVOKED_free(X509_REVOKED *a);
710 int i2d_X509_REVOKED(X509_REVOKED *a,unsigned char **pp);
711 X509_REVOKED * d2i_X509_REVOKED(X509_REVOKED **a,unsigned char **pp,long length);
713 X509_CRL_INFO *X509_CRL_INFO_new(void);
714 void X509_CRL_INFO_free(X509_CRL_INFO *a);
715 int i2d_X509_CRL_INFO(X509_CRL_INFO *a,unsigned char **pp);
716 X509_CRL_INFO *d2i_X509_CRL_INFO(X509_CRL_INFO **a,unsigned char **pp,
719 X509_CRL * X509_CRL_new(void);
720 void X509_CRL_free(X509_CRL *a);
721 int i2d_X509_CRL(X509_CRL *a,unsigned char **pp);
722 X509_CRL * d2i_X509_CRL(X509_CRL **a,unsigned char **pp,long length);
724 X509_PKEY * X509_PKEY_new(void );
725 void X509_PKEY_free(X509_PKEY *a);
726 int i2d_X509_PKEY(X509_PKEY *a,unsigned char **pp);
727 X509_PKEY * d2i_X509_PKEY(X509_PKEY **a,unsigned char **pp,long length);
729 NETSCAPE_SPKI * NETSCAPE_SPKI_new(void );
730 void NETSCAPE_SPKI_free(NETSCAPE_SPKI *a);
731 int i2d_NETSCAPE_SPKI(NETSCAPE_SPKI *a,unsigned char **pp);
732 NETSCAPE_SPKI * d2i_NETSCAPE_SPKI(NETSCAPE_SPKI **a,unsigned char **pp,
735 NETSCAPE_SPKAC *NETSCAPE_SPKAC_new(void );
736 void NETSCAPE_SPKAC_free(NETSCAPE_SPKAC *a);
737 int i2d_NETSCAPE_SPKAC(NETSCAPE_SPKAC *a,unsigned char **pp);
738 NETSCAPE_SPKAC *d2i_NETSCAPE_SPKAC(NETSCAPE_SPKAC **a,unsigned char **pp,
742 int i2d_NETSCAPE_CERT_SEQUENCE(NETSCAPE_CERT_SEQUENCE *a, unsigned char **pp);
743 NETSCAPE_CERT_SEQUENCE *NETSCAPE_CERT_SEQUENCE_new(void);
744 NETSCAPE_CERT_SEQUENCE *d2i_NETSCAPE_CERT_SEQUENCE(NETSCAPE_CERT_SEQUENCE **a, unsigned char **pp, long length);
745 void NETSCAPE_CERT_SEQUENCE_free(NETSCAPE_CERT_SEQUENCE *a);
747 #ifdef HEADER_ENVELOPE_H
748 X509_INFO * X509_INFO_new(void);
749 void X509_INFO_free(X509_INFO *a);
750 char * X509_NAME_oneline(X509_NAME *a,char *buf,int size);
752 int ASN1_verify(int (*i2d)(), X509_ALGOR *algor1,
753 ASN1_BIT_STRING *signature,char *data,EVP_PKEY *pkey);
755 int ASN1_digest(int (*i2d)(),EVP_MD *type,char *data,
756 unsigned char *md,unsigned int *len);
758 int ASN1_sign(int (*i2d)(), X509_ALGOR *algor1, X509_ALGOR *algor2,
759 ASN1_BIT_STRING *signature,
760 char *data,EVP_PKEY *pkey, const EVP_MD *type);
763 int X509_set_version(X509 *x,long version);
764 int X509_set_serialNumber(X509 *x, ASN1_INTEGER *serial);
765 ASN1_INTEGER * X509_get_serialNumber(X509 *x);
766 int X509_set_issuer_name(X509 *x, X509_NAME *name);
767 X509_NAME * X509_get_issuer_name(X509 *a);
768 int X509_set_subject_name(X509 *x, X509_NAME *name);
769 X509_NAME * X509_get_subject_name(X509 *a);
770 int X509_set_notBefore(X509 *x, ASN1_UTCTIME *tm);
771 int X509_set_notAfter(X509 *x, ASN1_UTCTIME *tm);
772 int X509_set_pubkey(X509 *x, EVP_PKEY *pkey);
773 EVP_PKEY * X509_get_pubkey(X509 *x);
774 int X509_certificate_type(X509 *x,EVP_PKEY *pubkey /* optional */);
776 int X509_REQ_set_version(X509_REQ *x,long version);
777 int X509_REQ_set_subject_name(X509_REQ *req,X509_NAME *name);
778 int X509_REQ_set_pubkey(X509_REQ *x, EVP_PKEY *pkey);
779 EVP_PKEY * X509_REQ_get_pubkey(X509_REQ *req);
781 int X509_check_private_key(X509 *x509,EVP_PKEY *pkey);
783 int X509_issuer_and_serial_cmp(X509 *a, X509 *b);
784 unsigned long X509_issuer_and_serial_hash(X509 *a);
786 int X509_issuer_name_cmp(X509 *a, X509 *b);
787 unsigned long X509_issuer_name_hash(X509 *a);
789 int X509_subject_name_cmp(X509 *a,X509 *b);
790 unsigned long X509_subject_name_hash(X509 *x);
792 int X509_NAME_cmp (X509_NAME *a, X509_NAME *b);
793 unsigned long X509_NAME_hash(X509_NAME *x);
795 int X509_CRL_cmp(X509_CRL *a,X509_CRL *b);
797 int X509_print_fp(FILE *bp,X509 *x);
798 int X509_CRL_print_fp(FILE *bp,X509_CRL *x);
799 int X509_REQ_print_fp(FILE *bp,X509_REQ *req);
803 int X509_NAME_print(BIO *bp, X509_NAME *name, int obase);
804 int X509_print(BIO *bp,X509 *x);
805 int X509_CRL_print(BIO *bp,X509_CRL *x);
806 int X509_REQ_print(BIO *bp,X509_REQ *req);
809 int X509_NAME_entry_count(X509_NAME *name);
810 int X509_NAME_get_text_by_NID(X509_NAME *name, int nid,
812 int X509_NAME_get_text_by_OBJ(X509_NAME *name, ASN1_OBJECT *obj,
815 /* NOTE: you should be passsing -1, not 0 as lastpos. The functions that use
816 * lastpos, seach after that position on. */
817 int X509_NAME_get_index_by_NID(X509_NAME *name,int nid,int lastpos);
818 int X509_NAME_get_index_by_OBJ(X509_NAME *name,ASN1_OBJECT *obj,
820 X509_NAME_ENTRY *X509_NAME_get_entry(X509_NAME *name, int loc);
821 X509_NAME_ENTRY *X509_NAME_delete_entry(X509_NAME *name, int loc);
822 int X509_NAME_add_entry(X509_NAME *name,X509_NAME_ENTRY *ne,
824 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_NID(X509_NAME_ENTRY **ne, int nid,
825 int type,unsigned char *bytes, int len);
826 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_OBJ(X509_NAME_ENTRY **ne,
827 ASN1_OBJECT *obj, int type,unsigned char *bytes,
829 int X509_NAME_ENTRY_set_object(X509_NAME_ENTRY *ne,
831 int X509_NAME_ENTRY_set_data(X509_NAME_ENTRY *ne, int type,
832 unsigned char *bytes, int len);
833 ASN1_OBJECT * X509_NAME_ENTRY_get_object(X509_NAME_ENTRY *ne);
834 ASN1_STRING * X509_NAME_ENTRY_get_data(X509_NAME_ENTRY *ne);
836 int X509v3_get_ext_count(const STACK_OF(X509_EXTENSION) *x);
837 int X509v3_get_ext_by_NID(const STACK_OF(X509_EXTENSION) *x,
838 int nid, int lastpos);
839 int X509v3_get_ext_by_OBJ(const STACK_OF(X509_EXTENSION) *x,
840 ASN1_OBJECT *obj,int lastpos);
841 int X509v3_get_ext_by_critical(const STACK_OF(X509_EXTENSION) *x,
842 int crit, int lastpos);
843 X509_EXTENSION *X509v3_get_ext(const STACK_OF(X509_EXTENSION) *x, int loc);
844 X509_EXTENSION *X509v3_delete_ext(STACK_OF(X509_EXTENSION) *x, int loc);
845 STACK_OF(X509_EXTENSION) *X509v3_add_ext(STACK_OF(X509_EXTENSION) **x,
846 X509_EXTENSION *ex, int loc);
848 int X509_get_ext_count(X509 *x);
849 int X509_get_ext_by_NID(X509 *x, int nid, int lastpos);
850 int X509_get_ext_by_OBJ(X509 *x,ASN1_OBJECT *obj,int lastpos);
851 int X509_get_ext_by_critical(X509 *x, int crit, int lastpos);
852 X509_EXTENSION *X509_get_ext(X509 *x, int loc);
853 X509_EXTENSION *X509_delete_ext(X509 *x, int loc);
854 int X509_add_ext(X509 *x, X509_EXTENSION *ex, int loc);
856 int X509_CRL_get_ext_count(X509_CRL *x);
857 int X509_CRL_get_ext_by_NID(X509_CRL *x, int nid, int lastpos);
858 int X509_CRL_get_ext_by_OBJ(X509_CRL *x,ASN1_OBJECT *obj,int lastpos);
859 int X509_CRL_get_ext_by_critical(X509_CRL *x, int crit, int lastpos);
860 X509_EXTENSION *X509_CRL_get_ext(X509_CRL *x, int loc);
861 X509_EXTENSION *X509_CRL_delete_ext(X509_CRL *x, int loc);
862 int X509_CRL_add_ext(X509_CRL *x, X509_EXTENSION *ex, int loc);
864 int X509_REVOKED_get_ext_count(X509_REVOKED *x);
865 int X509_REVOKED_get_ext_by_NID(X509_REVOKED *x, int nid, int lastpos);
866 int X509_REVOKED_get_ext_by_OBJ(X509_REVOKED *x,ASN1_OBJECT *obj,int lastpos);
867 int X509_REVOKED_get_ext_by_critical(X509_REVOKED *x, int crit, int lastpos);
868 X509_EXTENSION *X509_REVOKED_get_ext(X509_REVOKED *x, int loc);
869 X509_EXTENSION *X509_REVOKED_delete_ext(X509_REVOKED *x, int loc);
870 int X509_REVOKED_add_ext(X509_REVOKED *x, X509_EXTENSION *ex, int loc);
872 X509_EXTENSION *X509_EXTENSION_create_by_NID(X509_EXTENSION **ex,
873 int nid, int crit, ASN1_OCTET_STRING *data);
874 X509_EXTENSION *X509_EXTENSION_create_by_OBJ(X509_EXTENSION **ex,
875 ASN1_OBJECT *obj,int crit,ASN1_OCTET_STRING *data);
876 int X509_EXTENSION_set_object(X509_EXTENSION *ex,ASN1_OBJECT *obj);
877 int X509_EXTENSION_set_critical(X509_EXTENSION *ex, int crit);
878 int X509_EXTENSION_set_data(X509_EXTENSION *ex,
879 ASN1_OCTET_STRING *data);
880 ASN1_OBJECT * X509_EXTENSION_get_object(X509_EXTENSION *ex);
881 ASN1_OCTET_STRING *X509_EXTENSION_get_data(X509_EXTENSION *ne);
882 int X509_EXTENSION_get_critical(X509_EXTENSION *ex);
884 int X509_verify_cert(X509_STORE_CTX *ctx);
886 /* lookup a cert from a X509 STACK */
887 X509 *X509_find_by_issuer_and_serial(STACK_OF(X509) *sk,X509_NAME *name,
888 ASN1_INTEGER *serial);
889 X509 *X509_find_by_subject(STACK_OF(X509) *sk,X509_NAME *name);
891 int i2d_PBEPARAM(PBEPARAM *a, unsigned char **pp);
892 PBEPARAM *PBEPARAM_new(void);
893 PBEPARAM *d2i_PBEPARAM(PBEPARAM **a, unsigned char **pp, long length);
894 void PBEPARAM_free(PBEPARAM *a);
895 X509_ALGOR *PKCS5_pbe_set(int alg, int iter, unsigned char *salt, int saltlen);
897 int i2d_PBKDF2PARAM(PBKDF2PARAM *a, unsigned char **pp);
898 PBKDF2PARAM *PBKDF2PARAM_new(void);
899 PBKDF2PARAM *d2i_PBKDF2PARAM(PBKDF2PARAM **a, unsigned char **pp, long length);
900 void PBKDF2PARAM_free(PBKDF2PARAM *a);
902 int i2d_PBE2PARAM(PBE2PARAM *a, unsigned char **pp);
903 PBE2PARAM *PBE2PARAM_new(void);
904 PBE2PARAM *d2i_PBE2PARAM(PBE2PARAM **a, unsigned char **pp, long length);
905 void PBE2PARAM_free(PBE2PARAM *a);
907 /* PKCS#8 utilities */
909 int i2d_PKCS8_PRIV_KEY_INFO(PKCS8_PRIV_KEY_INFO *a, unsigned char **pp);
910 PKCS8_PRIV_KEY_INFO *PKCS8_PRIV_KEY_INFO_new(void);
911 PKCS8_PRIV_KEY_INFO *d2i_PKCS8_PRIV_KEY_INFO(PKCS8_PRIV_KEY_INFO **a,
912 unsigned char **pp, long length);
913 void PKCS8_PRIV_KEY_INFO_free(PKCS8_PRIV_KEY_INFO *a);
915 EVP_PKEY *EVP_PKCS82PKEY(PKCS8_PRIV_KEY_INFO *p8);
916 PKCS8_PRIV_KEY_INFO *EVP_PKEY2PKCS8(EVP_PKEY *pkey);
917 PKCS8_PRIV_KEY_INFO *PKCS8_set_broken(PKCS8_PRIV_KEY_INFO *p8, int broken);
919 /* Password based encryption routines */
921 int EVP_PBE_CipherInit (ASN1_OBJECT *pbe_obj, const char *pass, int passlen,
922 unsigned char *salt, int saltlen, int iter, EVP_CIPHER_CTX *ctx,
924 int EVP_PBE_ALGOR_CipherInit(X509_ALGOR *algor, const char *pass,
925 int passlen, EVP_CIPHER_CTX *ctx, int en_de);
926 int EVP_PBE_alg_add(int nid, EVP_CIPHER *cipher, EVP_MD *md,
927 EVP_PBE_KEYGEN *keygen);
928 void EVP_PBE_cleanup(void);
930 /* BEGIN ERROR CODES */
931 /* The following lines are auto generated by the script mkerr.pl. Any changes
932 * made after this point may be overwritten when the script is next run.
935 /* Error codes for the X509 functions. */
937 /* Function codes. */
938 #define X509_F_ADD_CERT_DIR 100
939 #define X509_F_BY_FILE_CTRL 101
940 #define X509_F_DIR_CTRL 102
941 #define X509_F_GET_CERT_BY_SUBJECT 103
942 #define X509_F_X509V3_ADD_EXT 104
943 #define X509_F_X509_CHECK_PRIVATE_KEY 128
944 #define X509_F_X509_EXTENSION_CREATE_BY_NID 108
945 #define X509_F_X509_EXTENSION_CREATE_BY_OBJ 109
946 #define X509_F_X509_GET_PUBKEY_PARAMETERS 110
947 #define X509_F_X509_LOAD_CERT_FILE 111
948 #define X509_F_X509_LOAD_CRL_FILE 112
949 #define X509_F_X509_NAME_ADD_ENTRY 113
950 #define X509_F_X509_NAME_ENTRY_CREATE_BY_NID 114
951 #define X509_F_X509_NAME_ENTRY_SET_OBJECT 115
952 #define X509_F_X509_NAME_ONELINE 116
953 #define X509_F_X509_NAME_PRINT 117
954 #define X509_F_X509_PRINT_FP 118
955 #define X509_F_X509_PUBKEY_GET 119
956 #define X509_F_X509_PUBKEY_SET 120
957 #define X509_F_X509_REQ_PRINT 121
958 #define X509_F_X509_REQ_PRINT_FP 122
959 #define X509_F_X509_REQ_TO_X509 123
960 #define X509_F_X509_STORE_ADD_CERT 124
961 #define X509_F_X509_STORE_ADD_CRL 125
962 #define X509_F_X509_TO_X509_REQ 126
963 #define X509_F_X509_VERIFY_CERT 127
966 #define X509_R_BAD_X509_FILETYPE 100
967 #define X509_R_CANT_CHECK_DH_KEY 114
968 #define X509_R_CERT_ALREADY_IN_HASH_TABLE 101
969 #define X509_R_ERR_ASN1_LIB 102
970 #define X509_R_INVALID_DIRECTORY 113
971 #define X509_R_KEY_TYPE_MISMATCH 115
972 #define X509_R_KEY_VALUES_MISMATCH 116
973 #define X509_R_LOADING_CERT_DIR 103
974 #define X509_R_LOADING_DEFAULTS 104
975 #define X509_R_NO_CERT_SET_FOR_US_TO_VERIFY 105
976 #define X509_R_SHOULD_RETRY 106
977 #define X509_R_UNABLE_TO_FIND_PARAMETERS_IN_CHAIN 107
978 #define X509_R_UNABLE_TO_GET_CERTS_PUBLIC_KEY 108
979 #define X509_R_UNKNOWN_KEY_TYPE 117
980 #define X509_R_UNKNOWN_NID 109
981 #define X509_R_UNSUPPORTED_ALGORITHM 111
982 #define X509_R_WRONG_LOOKUP_TYPE 112