/* * Written by Dr Stephen N Henson (steve@openssl.org) for the OpenSSL project * 2006. */ /* ==================================================================== * Copyright (c) 2006 The OpenSSL Project. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * * 3. All advertising materials mentioning features or use of this * software must display the following acknowledgment: * "This product includes software developed by the OpenSSL Project * for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)" * * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to * endorse or promote products derived from this software without * prior written permission. For written permission, please contact * licensing@OpenSSL.org. * * 5. Products derived from this software may not be called "OpenSSL" * nor may "OpenSSL" appear in their names without prior written * permission of the OpenSSL Project. * * 6. Redistributions of any form whatsoever must retain the following * acknowledgment: * "This product includes software developed by the OpenSSL Project * for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)" * * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED * OF THE POSSIBILITY OF SUCH DAMAGE. * ==================================================================== * * This product includes cryptographic software written by Eric Young * (eay@cryptsoft.com). This product includes software written by Tim * Hudson (tjh@cryptsoft.com). * */ #ifndef OPENSSL_HEADER_ASN1_ASN1_LOCL_H #define OPENSSL_HEADER_ASN1_ASN1_LOCL_H #include <time.h> #include <openssl_grpc/asn1.h> #include <openssl_grpc/asn1t.h> #if defined(__cplusplus) extern "C" { #endif /* Wrapper functions for time functions. */ /* OPENSSL_gmtime wraps |gmtime_r|. See the manual page for that function. */ struct tm *OPENSSL_gmtime(const time_t *time, struct tm *result); /* OPENSSL_gmtime_adj updates |tm| by adding |offset_day| days and |offset_sec| * seconds. */ int OPENSSL_gmtime_adj(struct tm *tm, int offset_day, long offset_sec); /* OPENSSL_gmtime_diff calculates the difference between |from| and |to| and * outputs the difference as a number of days and seconds in |*out_days| and * |*out_secs|. */ int OPENSSL_gmtime_diff(int *out_days, int *out_secs, const struct tm *from, const struct tm *to); /* Internal ASN1 structures and functions: not for application use */ /* These are used internally in the ASN1_OBJECT to keep track of * whether the names and data need to be free()ed */ #define ASN1_OBJECT_FLAG_DYNAMIC 0x01 /* internal use */ #define ASN1_OBJECT_FLAG_DYNAMIC_STRINGS 0x04 /* internal use */ #define ASN1_OBJECT_FLAG_DYNAMIC_DATA 0x08 /* internal use */ /* An asn1_object_st (aka |ASN1_OBJECT|) represents an ASN.1 OBJECT IDENTIFIER. * Note: Mutating an |ASN1_OBJECT| is only permitted when initializing it. The * library maintains a table of static |ASN1_OBJECT|s, which may be referenced * by non-const |ASN1_OBJECT| pointers. Code which receives an |ASN1_OBJECT| * pointer externally must assume it is immutable, even if the pointer is not * const. */ struct asn1_object_st { const char *sn, *ln; int nid; int length; const unsigned char *data; /* data remains const after init */ int flags; /* Should we free this one */ }; ASN1_OBJECT *ASN1_OBJECT_new(void); // ASN1_ENCODING structure: this is used to save the received // encoding of an ASN1 type. This is useful to get round // problems with invalid encodings which can break signatures. typedef struct ASN1_ENCODING_st { unsigned char *enc; // DER encoding long len; // Length of encoding int modified; // set to 1 if 'enc' is invalid // alias_only is zero if |enc| owns the buffer that it points to // (although |enc| may still be NULL). If one, |enc| points into a // buffer that is owned elsewhere. unsigned alias_only : 1; // alias_only_on_next_parse is one iff the next parsing operation // should avoid taking a copy of the input and rather set // |alias_only|. unsigned alias_only_on_next_parse : 1; } ASN1_ENCODING; int asn1_utctime_to_tm(struct tm *tm, const ASN1_UTCTIME *d); int asn1_generalizedtime_to_tm(struct tm *tm, const ASN1_GENERALIZEDTIME *d); void asn1_item_combine_free(ASN1_VALUE **pval, const ASN1_ITEM *it, int combine); int UTF8_getc(const unsigned char *str, int len, uint32_t *val); int UTF8_putc(unsigned char *str, int len, uint32_t value); int ASN1_item_ex_new(ASN1_VALUE **pval, const ASN1_ITEM *it); void ASN1_item_ex_free(ASN1_VALUE **pval, const ASN1_ITEM *it); void ASN1_template_free(ASN1_VALUE **pval, const ASN1_TEMPLATE *tt); int ASN1_item_ex_d2i(ASN1_VALUE **pval, const unsigned char **in, long len, const ASN1_ITEM *it, int tag, int aclass, char opt, ASN1_TLC *ctx); /* ASN1_item_ex_i2d encodes |*pval| as a value of type |it| to |out| under the * i2d output convention. It returns a non-zero length on success and -1 on * error. If |tag| is -1. the tag and class come from |it|. Otherwise, the tag * number is |tag| and the class is |aclass|. This is used for implicit tagging. * This function treats a missing value as an error, not an optional field. */ int ASN1_item_ex_i2d(ASN1_VALUE **pval, unsigned char **out, const ASN1_ITEM *it, int tag, int aclass); void ASN1_primitive_free(ASN1_VALUE **pval, const ASN1_ITEM *it); /* asn1_get_choice_selector returns the CHOICE selector value for |*pval|, which * must of type |it|. */ int asn1_get_choice_selector(ASN1_VALUE **pval, const ASN1_ITEM *it); int asn1_set_choice_selector(ASN1_VALUE **pval, int value, const ASN1_ITEM *it); /* asn1_get_field_ptr returns a pointer to the field in |*pval| corresponding to * |tt|. */ ASN1_VALUE **asn1_get_field_ptr(ASN1_VALUE **pval, const ASN1_TEMPLATE *tt); /* asn1_do_adb returns the |ASN1_TEMPLATE| for the ANY DEFINED BY field |tt|, * based on the selector INTEGER or OID in |*pval|. If |tt| is not an ADB field, * it returns |tt|. If the selector does not match any value, it returns NULL. * If |nullerr| is non-zero, it will additionally push an error to the error * queue when there is no match. */ const ASN1_TEMPLATE *asn1_do_adb(ASN1_VALUE **pval, const ASN1_TEMPLATE *tt, int nullerr); void asn1_refcount_set_one(ASN1_VALUE **pval, const ASN1_ITEM *it); int asn1_refcount_dec_and_test_zero(ASN1_VALUE **pval, const ASN1_ITEM *it); void asn1_enc_init(ASN1_VALUE **pval, const ASN1_ITEM *it); void asn1_enc_free(ASN1_VALUE **pval, const ASN1_ITEM *it); /* asn1_enc_restore, if |*pval| has a saved encoding, writes it to |out| under * the i2d output convention, sets |*len| to the length, and returns one. If it * has no saved encoding, it returns zero. */ int asn1_enc_restore(int *len, unsigned char **out, ASN1_VALUE **pval, const ASN1_ITEM *it); int asn1_enc_save(ASN1_VALUE **pval, const unsigned char *in, int inlen, const ASN1_ITEM *it); /* asn1_type_value_as_pointer returns |a|'s value in pointer form. This is * usually the value object but, for BOOLEAN values, is 0 or 0xff cast to * a pointer. */ const void *asn1_type_value_as_pointer(const ASN1_TYPE *a); /* asn1_is_printable returns one if |value| is a valid Unicode codepoint for an * ASN.1 PrintableString, and zero otherwise. */ int asn1_is_printable(uint32_t value); /* asn1_bit_string_length returns the number of bytes in |str| and sets * |*out_padding_bits| to the number of padding bits. * * This function should be used instead of |ASN1_STRING_length| to correctly * handle the non-|ASN1_STRING_FLAG_BITS_LEFT| case. */ int asn1_bit_string_length(const ASN1_BIT_STRING *str, uint8_t *out_padding_bits); typedef struct { int nid; long minsize; long maxsize; unsigned long mask; unsigned long flags; } ASN1_STRING_TABLE; /* asn1_get_string_table_for_testing sets |*out_ptr| and |*out_len| to the table * of built-in |ASN1_STRING_TABLE| values. It is exported for testing. */ OPENSSL_EXPORT void asn1_get_string_table_for_testing( const ASN1_STRING_TABLE **out_ptr, size_t *out_len); #if defined(__cplusplus) } /* extern C */ #endif #endif /* OPENSSL_HEADER_ASN1_ASN1_LOCL_H */