| /* |
| * Copyright (C) 2002-2013 Free Software Foundation, Inc. |
| * |
| * This file is part of LIBTASN1. |
| * |
| * LIBTASN1 is free software; you can redistribute it and/or modify it |
| * under the terms of the GNU Lesser General Public License as |
| * published by the Free Software Foundation; either version 2.1 of |
| * the License, or (at your option) any later version. |
| * |
| * LIBTASN1 is distributed in the hope that it will be useful, but |
| * WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| * Lesser General Public License for more details. |
| * |
| * You should have received a copy of the GNU Lesser General Public |
| * License along with LIBTASN1; if not, write to the Free Software |
| * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA |
| * 02110-1301, USA |
| * |
| */ |
| |
| #ifndef LIBTASN1_H |
| #define LIBTASN1_H |
| |
| #ifndef ASN1_API |
| #if defined ASN1_BUILDING && defined HAVE_VISIBILITY && HAVE_VISIBILITY |
| #define ASN1_API __attribute__((__visibility__("default"))) |
| #elif defined ASN1_BUILDING && defined _MSC_VER && ! defined ASN1_STATIC |
| #define ASN1_API __declspec(dllexport) |
| #elif defined _MSC_VER && ! defined ASN1_STATIC |
| #define ASN1_API __declspec(dllimport) |
| #else |
| #define ASN1_API |
| #endif |
| #endif |
| |
| #include <sys/types.h> |
| #include <time.h> |
| #include <stdio.h> /* for FILE* */ |
| |
| #ifdef __cplusplus |
| extern "C" |
| { |
| #endif |
| |
| #define ASN1_VERSION "3.2" |
| |
| /*****************************************/ |
| /* Errors returned by libtasn1 functions */ |
| /*****************************************/ |
| #define ASN1_SUCCESS 0 |
| #define ASN1_FILE_NOT_FOUND 1 |
| #define ASN1_ELEMENT_NOT_FOUND 2 |
| #define ASN1_IDENTIFIER_NOT_FOUND 3 |
| #define ASN1_DER_ERROR 4 |
| #define ASN1_VALUE_NOT_FOUND 5 |
| #define ASN1_GENERIC_ERROR 6 |
| #define ASN1_VALUE_NOT_VALID 7 |
| #define ASN1_TAG_ERROR 8 |
| #define ASN1_TAG_IMPLICIT 9 |
| #define ASN1_ERROR_TYPE_ANY 10 |
| #define ASN1_SYNTAX_ERROR 11 |
| #define ASN1_MEM_ERROR 12 |
| #define ASN1_MEM_ALLOC_ERROR 13 |
| #define ASN1_DER_OVERFLOW 14 |
| #define ASN1_NAME_TOO_LONG 15 |
| #define ASN1_ARRAY_ERROR 16 |
| #define ASN1_ELEMENT_NOT_EMPTY 17 |
| |
| /*************************************/ |
| /* Constants used in asn1_visit_tree */ |
| /*************************************/ |
| #define ASN1_PRINT_NAME 1 |
| #define ASN1_PRINT_NAME_TYPE 2 |
| #define ASN1_PRINT_NAME_TYPE_VALUE 3 |
| #define ASN1_PRINT_ALL 4 |
| |
| /*****************************************/ |
| /* Constants returned by asn1_read_tag */ |
| /*****************************************/ |
| #define ASN1_CLASS_UNIVERSAL 0x00 /* old: 1 */ |
| #define ASN1_CLASS_APPLICATION 0x40 /* old: 2 */ |
| #define ASN1_CLASS_CONTEXT_SPECIFIC 0x80 /* old: 3 */ |
| #define ASN1_CLASS_PRIVATE 0xC0 /* old: 4 */ |
| #define ASN1_CLASS_STRUCTURED 0x20 |
| |
| /*****************************************/ |
| /* Constants returned by asn1_read_tag */ |
| /*****************************************/ |
| #define ASN1_TAG_BOOLEAN 0x01 |
| #define ASN1_TAG_INTEGER 0x02 |
| #define ASN1_TAG_SEQUENCE 0x10 |
| #define ASN1_TAG_SET 0x11 |
| #define ASN1_TAG_OCTET_STRING 0x04 |
| #define ASN1_TAG_BIT_STRING 0x03 |
| #define ASN1_TAG_UTCTime 0x17 |
| #define ASN1_TAG_GENERALIZEDTime 0x18 |
| #define ASN1_TAG_OBJECT_ID 0x06 |
| #define ASN1_TAG_ENUMERATED 0x0A |
| #define ASN1_TAG_NULL 0x05 |
| #define ASN1_TAG_GENERALSTRING 0x1B |
| #define ASN1_TAG_NUMERIC_STRING 0x12 |
| #define ASN1_TAG_IA5_STRING 0x16 |
| #define ASN1_TAG_TELETEX_STRING 0x14 |
| #define ASN1_TAG_PRINTABLE_STRING 0x13 |
| #define ASN1_TAG_UNIVERSAL_STRING 0x1C |
| #define ASN1_TAG_BMP_STRING 0x1E |
| #define ASN1_TAG_UTF8_STRING 0x0C |
| #define ASN1_TAG_VISIBLE_STRING 0x1A |
| |
| /******************************************************/ |
| /* Structure definition used for the node of the tree */ |
| /* that represent an ASN.1 DEFINITION. */ |
| /******************************************************/ |
| |
| typedef struct asn1_node_st asn1_node_st; |
| |
| typedef asn1_node_st *asn1_node; |
| |
| /* maximum number of characters of a name */ |
| /* inside a file with ASN1 definitons */ |
| #define ASN1_MAX_NAME_SIZE 64 |
| |
| |
| /*****************************************/ |
| /* For the on-disk format of ASN.1 trees */ |
| /*****************************************/ |
| struct asn1_static_node_st |
| { |
| const char *name; /* Node name */ |
| unsigned int type; /* Node type */ |
| const void *value; /* Node value */ |
| }; |
| typedef struct asn1_static_node_st asn1_static_node; |
| |
| /* List of constants for field type of node_asn */ |
| #define ASN1_ETYPE_INVALID 0 |
| #define ASN1_ETYPE_CONSTANT 1 |
| #define ASN1_ETYPE_IDENTIFIER 2 |
| #define ASN1_ETYPE_INTEGER 3 |
| #define ASN1_ETYPE_BOOLEAN 4 |
| #define ASN1_ETYPE_SEQUENCE 5 |
| #define ASN1_ETYPE_BIT_STRING 6 |
| #define ASN1_ETYPE_OCTET_STRING 7 |
| #define ASN1_ETYPE_TAG 8 |
| #define ASN1_ETYPE_DEFAULT 9 |
| #define ASN1_ETYPE_SIZE 10 |
| #define ASN1_ETYPE_SEQUENCE_OF 11 |
| #define ASN1_ETYPE_OBJECT_ID 12 |
| #define ASN1_ETYPE_ANY 13 |
| #define ASN1_ETYPE_SET 14 |
| #define ASN1_ETYPE_SET_OF 15 |
| #define ASN1_ETYPE_DEFINITIONS 16 |
| #define ASN1_ETYPE_CHOICE 18 |
| #define ASN1_ETYPE_IMPORTS 19 |
| #define ASN1_ETYPE_NULL 20 |
| #define ASN1_ETYPE_ENUMERATED 21 |
| #define ASN1_ETYPE_GENERALSTRING 27 |
| #define ASN1_ETYPE_NUMERIC_STRING 28 |
| #define ASN1_ETYPE_IA5_STRING 29 |
| #define ASN1_ETYPE_TELETEX_STRING 30 |
| #define ASN1_ETYPE_PRINTABLE_STRING 31 |
| #define ASN1_ETYPE_UNIVERSAL_STRING 32 |
| #define ASN1_ETYPE_BMP_STRING 33 |
| #define ASN1_ETYPE_UTF8_STRING 34 |
| #define ASN1_ETYPE_VISIBLE_STRING 35 |
| #define ASN1_ETYPE_UTC_TIME 36 |
| #define ASN1_ETYPE_GENERALIZED_TIME 37 |
| |
| struct asn1_data_node_st |
| { |
| const char *name; /* Node name */ |
| const void *value; /* Node value */ |
| unsigned int value_len; /* Node value size */ |
| unsigned int type; /* Node value type (ASN1_ETYPE_*) */ |
| }; |
| typedef struct asn1_data_node_st asn1_data_node_st; |
| |
| /***********************************/ |
| /* Fixed constants */ |
| /***********************************/ |
| |
| |
| /* maximum number of characters */ |
| /* of a description message */ |
| /* (null character included) */ |
| #define ASN1_MAX_ERROR_DESCRIPTION_SIZE 128 |
| |
| /***********************************/ |
| /* Functions definitions */ |
| /***********************************/ |
| |
| extern ASN1_API int |
| asn1_parser2tree (const char *file, |
| asn1_node * definitions, char *error_desc); |
| |
| extern ASN1_API int |
| asn1_parser2array (const char *inputFileName, |
| const char *outputFileName, |
| const char *vectorName, char *error_desc); |
| |
| extern ASN1_API int |
| asn1_array2tree (const asn1_static_node * array, |
| asn1_node * definitions, char *errorDescription); |
| |
| extern ASN1_API void |
| asn1_print_structure (FILE * out, asn1_node structure, |
| const char *name, int mode); |
| |
| extern ASN1_API int |
| asn1_create_element (asn1_node definitions, |
| const char *source_name, asn1_node * element); |
| |
| extern ASN1_API int asn1_delete_structure (asn1_node * structure); |
| |
| extern ASN1_API int |
| asn1_delete_element (asn1_node structure, const char *element_name); |
| |
| extern ASN1_API int |
| asn1_write_value (asn1_node node_root, const char *name, |
| const void *ivalue, int len); |
| |
| extern ASN1_API int |
| asn1_read_value (asn1_node root, const char *name, |
| void *ivalue, int *len); |
| |
| extern ASN1_API int |
| asn1_read_value_type (asn1_node root, const char *name, |
| void *ivalue, int *len, unsigned int *etype); |
| |
| extern ASN1_API int |
| asn1_read_node_value (asn1_node node, asn1_data_node_st * data); |
| |
| extern ASN1_API int |
| asn1_number_of_elements (asn1_node element, const char *name, int *num); |
| |
| extern ASN1_API int |
| asn1_der_coding (asn1_node element, const char *name, |
| void *ider, int *len, char *ErrorDescription); |
| |
| extern ASN1_API int |
| asn1_der_decoding (asn1_node * element, const void *ider, |
| int len, char *errorDescription); |
| |
| extern ASN1_API int |
| asn1_der_decoding_element (asn1_node * structure, |
| const char *elementName, |
| const void *ider, int len, |
| char *errorDescription); |
| |
| extern ASN1_API int |
| asn1_der_decoding_startEnd (asn1_node element, |
| const void *ider, int len, |
| const char *name_element, |
| int *start, int *end); |
| |
| extern ASN1_API int |
| asn1_expand_any_defined_by (asn1_node definitions, asn1_node * element); |
| |
| extern ASN1_API int |
| asn1_expand_octet_string (asn1_node definitions, |
| asn1_node * element, |
| const char *octetName, const char *objectName); |
| |
| extern ASN1_API int |
| asn1_read_tag (asn1_node root, const char *name, |
| int *tagValue, int *classValue); |
| |
| extern ASN1_API const char *asn1_find_structure_from_oid (asn1_node |
| definitions, |
| const char |
| *oidValue); |
| |
| extern ASN1_API const char *asn1_check_version (const char *req_version); |
| |
| extern ASN1_API const char *asn1_strerror (int error); |
| |
| extern ASN1_API void asn1_perror (int error); |
| |
| #define ASN1_MAX_TAG_SIZE 4 |
| #define ASN1_MAX_LENGTH_SIZE 9 |
| #define ASN1_MAX_TL_SIZE (ASN1_MAX_TAG_SIZE+ASN1_MAX_LENGTH_SIZE) |
| extern ASN1_API long |
| asn1_get_length_der (const unsigned char *der, int der_len, int *len); |
| |
| extern ASN1_API long |
| asn1_get_length_ber (const unsigned char *ber, int ber_len, int *len); |
| |
| extern ASN1_API void |
| asn1_length_der (unsigned long int len, unsigned char *der, int *der_len); |
| |
| /* Other utility functions. */ |
| |
| extern ASN1_API |
| int asn1_decode_simple_der (unsigned int etype, const unsigned char *der, |
| unsigned int der_len, |
| const unsigned char **str, |
| unsigned int *str_len); |
| |
| extern ASN1_API int |
| asn1_encode_simple_der (unsigned int etype, const unsigned char *str, |
| unsigned int str_len, unsigned char *tl, |
| unsigned int *tl_len); |
| |
| extern ASN1_API asn1_node |
| asn1_find_node (asn1_node pointer, const char *name); |
| |
| extern ASN1_API int |
| asn1_copy_node (asn1_node dst, const char *dst_name, |
| asn1_node src, const char *src_name); |
| |
| /* Internal and low-level DER utility functions. */ |
| |
| extern ASN1_API int |
| asn1_get_tag_der (const unsigned char *der, int der_len, |
| unsigned char *cls, int *len, unsigned long *tag); |
| |
| extern ASN1_API void |
| asn1_octet_der (const unsigned char *str, int str_len, |
| unsigned char *der, int *der_len); |
| |
| extern ASN1_API int |
| asn1_get_octet_der (const unsigned char *der, int der_len, |
| int *ret_len, unsigned char *str, |
| int str_size, int *str_len); |
| |
| extern ASN1_API void asn1_bit_der (const unsigned char *str, int bit_len, |
| unsigned char *der, int *der_len); |
| |
| extern ASN1_API int |
| asn1_get_bit_der (const unsigned char *der, int der_len, |
| int *ret_len, unsigned char *str, |
| int str_size, int *bit_len); |
| |
| /* Compatibility types */ |
| |
| typedef int asn1_retCode; /* type returned by libtasn1 functions */ |
| |
| #define node_asn_struct asn1_node_st |
| #define node_asn asn1_node_st |
| #define ASN1_TYPE asn1_node |
| #define ASN1_TYPE_EMPTY NULL |
| |
| #define static_struct_asn asn1_static_node_st |
| #define ASN1_ARRAY_TYPE asn1_static_node |
| #define asn1_static_node_t asn1_static_node |
| |
| #define node_data_struct asn1_data_node_st |
| #define ASN1_DATA_NODE asn1_data_node_st |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif /* LIBTASN1_H */ |
