lib/libtasn1.h

   1 /*
   2  *      Copyright (C) 2004, 2005, 2006 Free Software Foundation
   3  *      Copyright (C) 2002 Fabio Fiorina
   4  *
   5  * This file is part of LIBTASN1.
   6  *
   7  * LIBTASN1 is free software; you can redistribute it and/or modify it
   8  * under the terms of the GNU Lesser General Public License as
   9  * published by the Free Software Foundation; either version 2.1 of
  10  * the License, or (at your option) any later version.
  11  *
  12  * LIBTASN1 is distributed in the hope that it will be useful, but
  13  * WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Lesser General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Lesser General Public
  18  * License along with LIBTASN1; if not, write to the Free Software
  19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  20  * 02110-1301, USA
  21  *
  22  */
  23
  24 #ifndef LIBTASN1_H
  25 # define LIBTASN1_H
  26
  27 #include <stdio.h>              /* for FILE* */
  28
  29 #ifdef __cplusplus
  30 extern "C"
  31 {
  32 #endif
  33
  34 #define LIBTASN1_VERSION "0.3.1"
  35
  36 #include <sys/types.h>
  37 #include <time.h>
  38
  39 #define MAX_NAME_SIZE 128       /* maximum number of characters of a name */
  40   /* inside a file with ASN1 definitons     */
  41 #define MAX_ERROR_DESCRIPTION_SIZE 128  /* maximum number of characters */
  42   /* of a description message     */
  43   /* (null character included)    */
  44
  45
  46   typedef int asn1_retCode;     /* type returned by libtasn1 functions */
  47
  48   /*****************************************/
  49   /*  Errors returned by libtasn1 functions */
  50   /*****************************************/
  51 #define ASN1_SUCCESS               0
  52 #define ASN1_FILE_NOT_FOUND        1
  53 #define ASN1_ELEMENT_NOT_FOUND     2
  54 #define ASN1_IDENTIFIER_NOT_FOUND  3
  55 #define ASN1_DER_ERROR             4
  56 #define ASN1_VALUE_NOT_FOUND       5
  57 #define ASN1_GENERIC_ERROR         6
  58 #define ASN1_VALUE_NOT_VALID       7
  59 #define ASN1_TAG_ERROR             8
  60 #define ASN1_TAG_IMPLICIT          9
  61 #define ASN1_ERROR_TYPE_ANY        10
  62 #define ASN1_SYNTAX_ERROR          11
  63 #define ASN1_MEM_ERROR             12
  64 #define ASN1_MEM_ALLOC_ERROR       13
  65 #define ASN1_DER_OVERFLOW          14
  66 #define ASN1_NAME_TOO_LONG         15
  67 #define ASN1_ARRAY_ERROR           16
  68 #define ASN1_ELEMENT_NOT_EMPTY     17
  69
  70 /*************************************/
  71 /* Constants used in asn1_visit_tree */
  72 /*************************************/
  73 #define ASN1_PRINT_NAME             1
  74 #define ASN1_PRINT_NAME_TYPE        2
  75 #define ASN1_PRINT_NAME_TYPE_VALUE  3
  76 #define ASN1_PRINT_ALL              4
  77
  78 /*****************************************/
  79 /* Constants returned by asn1_read_tag   */
  80 /*****************************************/
  81 #define ASN1_CLASS_UNIVERSAL        0x00        /* old: 1 */
  82 #define ASN1_CLASS_APPLICATION      0x40        /* old: 2 */
  83 #define ASN1_CLASS_CONTEXT_SPECIFIC 0x80        /* old: 3 */
  84 #define ASN1_CLASS_PRIVATE          0xC0        /* old: 4 */
  85 #define ASN1_CLASS_STRUCTURED       0x20
  86
  87 /*****************************************/
  88 /* Constants returned by asn1_read_tag   */
  89 /*****************************************/
  90 #define ASN1_TAG_BOOLEAN          0x01
  91 #define ASN1_TAG_INTEGER          0x02
  92 #define ASN1_TAG_SEQUENCE         0x10
  93 #define ASN1_TAG_SET              0x11
  94 #define ASN1_TAG_OCTET_STRING     0x04
  95 #define ASN1_TAG_BIT_STRING       0x03
  96 #define ASN1_TAG_UTCTime          0x17
  97 #define ASN1_TAG_GENERALIZEDTime  0x18
  98 #define ASN1_TAG_OBJECT_ID        0x06
  99 #define ASN1_TAG_ENUMERATED       0x0A
 100 #define ASN1_TAG_NULL             0x05
 101 #define ASN1_TAG_GENERALSTRING    0x1B
 102
 103 /******************************************************/
 104 /* Structure definition used for the node of the tree */
 105 /* that represent an ASN.1 DEFINITION.                */
 106 /******************************************************/
 107   typedef struct node_asn_struct
 108   {
 109     char *name;                 /* Node name */
 110     unsigned int type;          /* Node type */
 111     unsigned char *value;       /* Node value */
 112     int value_len;
 113     struct node_asn_struct *down;       /* Pointer to the son node */
 114     struct node_asn_struct *right;      /* Pointer to the brother node */
 115     struct node_asn_struct *left;       /* Pointer to the next list element */
 116   } node_asn;
 117
 118   typedef node_asn *ASN1_TYPE;
 119
 120 #define ASN1_TYPE_EMPTY  NULL
 121
 122   struct static_struct_asn
 123   {
 124     char *name;                 /* Node name */
 125     unsigned int type;          /* Node type */
 126     unsigned char *value;       /* Node value */
 127   };
 128
 129   typedef struct static_struct_asn ASN1_ARRAY_TYPE;
 130
 131
 132
 133   /***********************************/
 134   /*  Functions definitions          */
 135   /***********************************/
 136
 137   asn1_retCode asn1_parser2tree (const char *file_name,
 138                                  ASN1_TYPE * definitions,
 139                                  char *errorDescription);
 140
 141   asn1_retCode asn1_parser2array (const char *inputFileName,
 142                                   const char *outputFileName,
 143                                   const char *vectorName,
 144                                   char *errorDescription);
 145
 146   asn1_retCode asn1_array2tree (const ASN1_ARRAY_TYPE * array,
 147                                 ASN1_TYPE * definitions,
 148                                 char *errorDescription);
 149
 150   void asn1_print_structure (FILE *out, ASN1_TYPE structure, const char *name,
 151                              int mode);
 152
 153   asn1_retCode asn1_create_element (ASN1_TYPE definitions,
 154                                     const char *source_name,
 155                                     ASN1_TYPE * element);
 156
 157   asn1_retCode asn1_delete_structure (ASN1_TYPE * structure);
 158
 159   asn1_retCode asn1_delete_element (ASN1_TYPE structure,
 160                                     const char *element_name);
 161
 162   asn1_retCode asn1_write_value (ASN1_TYPE node_root, const char *name,
 163                                  const void *ivalue, int len);
 164
 165   asn1_retCode asn1_read_value (ASN1_TYPE root, const char *name,
 166                                 void *ivalue, int *len);
 167
 168   asn1_retCode asn1_number_of_elements (ASN1_TYPE element, const char *name,
 169                                         int *num);
 170
 171   asn1_retCode asn1_der_coding (ASN1_TYPE element, const char *name,
 172                                 void *ider, int *len, char *ErrorDescription);
 173
 174   asn1_retCode asn1_der_decoding (ASN1_TYPE * element, const void *ider,
 175                                   int len, char *errorDescription);
 176
 177   asn1_retCode asn1_der_decoding_element (ASN1_TYPE * structure,
 178                                           const char *elementName,
 179                                           const void *ider, int len,
 180                                           char *errorDescription);
 181
 182   asn1_retCode asn1_der_decoding_startEnd (ASN1_TYPE element,
 183                                            const void *ider, int len,
 184                                            const char *name_element,
 185                                            int *start, int *end);
 186
 187   asn1_retCode asn1_expand_any_defined_by (ASN1_TYPE definitions,
 188                                            ASN1_TYPE * element);
 189
 190   asn1_retCode asn1_expand_octet_string (ASN1_TYPE definitions,
 191                                          ASN1_TYPE * element,
 192                                          const char *octetName,
 193                                          const char *objectName);
 194
 195   asn1_retCode asn1_read_tag (node_asn * root, const char *name,
 196                               int *tagValue, int *classValue);
 197
 198   const char *asn1_find_structure_from_oid (ASN1_TYPE definitions,
 199                                             const char *oidValue);
 200
 201   const char *asn1_check_version (const char *req_version);
 202
 203   const char *libtasn1_strerror (asn1_retCode error);
 204
 205   void libtasn1_perror (asn1_retCode error);
 206
 207   /* DER utility functions. */
 208
 209   int asn1_get_tag_der (const unsigned char *der, int der_len,
 210                         unsigned char *class, int *len, unsigned long *tag);
 211
 212   void asn1_octet_der (const unsigned char *str, int str_len,
 213                        unsigned char *der, int *der_len);
 214
 215   asn1_retCode asn1_get_octet_der (const unsigned char *der, int der_len,
 216                                    int *ret_len, unsigned char *str,
 217                                    int str_size, int *str_len);
 218
 219   void asn1_bit_der (const unsigned char *str, int bit_len,
 220                      unsigned char *der, int *der_len);
 221
 222   asn1_retCode asn1_get_bit_der (const unsigned char *der, int der_len,
 223                                  int *ret_len, unsigned char *str,
 224                                  int str_size, int *bit_len);
 225
 226   signed long asn1_get_length_der (const unsigned char *der, int der_len,
 227                                    int *len);
 228
 229   void asn1_length_der (unsigned long len, unsigned char *ans, int *ans_len);
 230
 231   /* Other utility functions. */
 232
 233   ASN1_TYPE asn1_find_node (ASN1_TYPE pointer, const char *name);
 234
 235 #ifdef __cplusplus
 236 }
 237 #endif
 238
 239 #endif                          /* LIBTASN1_H */