crypto/asn1/asn1_locl.h

   1 /* asn1t.h */
   2 /*
   3  * Written by Dr Stephen N Henson (steve@openssl.org) for the OpenSSL project
   4  * 2006.
   5  */
   6 /* ====================================================================
   7  * Copyright (c) 2006 The OpenSSL Project.  All rights reserved.
   8  *
   9  * Redistribution and use in source and binary forms, with or without
  10  * modification, are permitted provided that the following conditions
  11  * are met:
  12  *
  13  * 1. Redistributions of source code must retain the above copyright
  14  *    notice, this list of conditions and the following disclaimer.
  15  *
  16  * 2. Redistributions in binary form must reproduce the above copyright
  17  *    notice, this list of conditions and the following disclaimer in
  18  *    the documentation and/or other materials provided with the
  19  *    distribution.
  20  *
  21  * 3. All advertising materials mentioning features or use of this
  22  *    software must display the following acknowledgment:
  23  *    "This product includes software developed by the OpenSSL Project
  24  *    for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
  25  *
  26  * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
  27  *    endorse or promote products derived from this software without
  28  *    prior written permission. For written permission, please contact
  29  *    licensing@OpenSSL.org.
  30  *
  31  * 5. Products derived from this software may not be called "OpenSSL"
  32  *    nor may "OpenSSL" appear in their names without prior written
  33  *    permission of the OpenSSL Project.
  34  *
  35  * 6. Redistributions of any form whatsoever must retain the following
  36  *    acknowledgment:
  37  *    "This product includes software developed by the OpenSSL Project
  38  *    for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
  39  *
  40  * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
  41  * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  42  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  43  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
  44  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  45  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  46  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  47  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  48  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  49  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  50  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  51  * OF THE POSSIBILITY OF SUCH DAMAGE.
  52  * ====================================================================
  53  *
  54  * This product includes cryptographic software written by Eric Young
  55  * (eay@cryptsoft.com).  This product includes software written by Tim
  56  * Hudson (tjh@cryptsoft.com).
  57  *
  58  */
  59
  60 /* Internal ASN1 structures and functions: not for application use */
  61
  62 int asn1_utctime_to_tm(struct tm *tm, const ASN1_UTCTIME *d);
  63 int asn1_generalizedtime_to_tm(struct tm *tm, const ASN1_GENERALIZEDTIME *d);
  64
  65 /* ASN1 scan context structure */
  66
  67 struct asn1_sctx_st {
  68     /* The ASN1_ITEM associated with this field */
  69     const ASN1_ITEM *it;
  70     /* If ASN1_TEMPLATE associated with this field */
  71     const ASN1_TEMPLATE *tt;
  72     /* Various flags associated with field and context */
  73     unsigned long flags;
  74     /* If SEQUENCE OF or SET OF, field index */
  75     int skidx;
  76     /* ASN1 depth of field */
  77     int depth;
  78     /* Structure and field name */
  79     const char *sname, *fname;
  80     /* If a primitive type the type of underlying field */
  81     int prim_type;
  82     /* The field value itself */
  83     ASN1_VALUE **field;
  84     /* Callback to pass information to */
  85     int (*scan_cb) (ASN1_SCTX *ctx);
  86     /* Context specific application data */
  87     void *app_data;
  88 } /* ASN1_SCTX */ ;
  89
  90 /*
  91  * Method to handle CRL access. In general a CRL could be very large (several
  92  * Mb) and can consume large amounts of resources if stored in memory by
  93  * multiple processes. This method allows general CRL operations to be
  94  * redirected to more efficient callbacks: for example a CRL entry database.
  95  */
  96
  97 #define X509_CRL_METHOD_DYNAMIC         1
  98
  99 struct x509_crl_method_st {
 100     int flags;
 101     int (*crl_init) (X509_CRL *crl);
 102     int (*crl_free) (X509_CRL *crl);
 103     int (*crl_lookup) (X509_CRL *crl, X509_REVOKED **ret,
 104                        ASN1_INTEGER *ser, X509_NAME *issuer);
 105     int (*crl_verify) (X509_CRL *crl, EVP_PKEY *pk);
 106 };
 107
 108 int asn1_get_choice_selector(ASN1_VALUE **pval, const ASN1_ITEM *it);
 109 int asn1_set_choice_selector(ASN1_VALUE **pval, int value,
 110                              const ASN1_ITEM *it);
 111
 112 ASN1_VALUE **asn1_get_field_ptr(ASN1_VALUE **pval, const ASN1_TEMPLATE *tt);
 113
 114 const ASN1_TEMPLATE *asn1_do_adb(ASN1_VALUE **pval, const ASN1_TEMPLATE *tt,
 115                                  int nullerr);
 116
 117 int asn1_do_lock(ASN1_VALUE **pval, int op, const ASN1_ITEM *it);
 118
 119 void asn1_enc_init(ASN1_VALUE **pval, const ASN1_ITEM *it);
 120 void asn1_enc_free(ASN1_VALUE **pval, const ASN1_ITEM *it);
 121 int asn1_enc_restore(int *len, unsigned char **out, ASN1_VALUE **pval,
 122                      const ASN1_ITEM *it);
 123 int asn1_enc_save(ASN1_VALUE **pval, const unsigned char *in, int inlen,
 124                   const ASN1_ITEM *it);
 125
 126 void asn1_primitive_free(ASN1_VALUE **pval, const ASN1_ITEM *it);
 127 void asn1_template_free(ASN1_VALUE **pval, const ASN1_TEMPLATE *tt);
 128
 129 ASN1_OBJECT *c2i_ASN1_OBJECT(ASN1_OBJECT **a, const unsigned char **pp,
 130                              long length);
 131 int i2c_ASN1_BIT_STRING(ASN1_BIT_STRING *a, unsigned char **pp);
 132 ASN1_BIT_STRING *c2i_ASN1_BIT_STRING(ASN1_BIT_STRING **a,
 133                                      const unsigned char **pp, long length);
 134 int i2c_ASN1_INTEGER(ASN1_INTEGER *a, unsigned char **pp);
 135 ASN1_INTEGER *c2i_ASN1_INTEGER(ASN1_INTEGER **a, const unsigned char **pp,
 136                                long length);