1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
|
/*
* Copyright (C) 2002 Fabio Fiorina
*
* This file is part of LIBTASN1.
*
* The LIBTASN1 library 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.
*
* This library 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 this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
*/
#ifndef LIBASN1_H
# define LIBASN1_H
#include <stdio.h> /* for FILE* */
#ifdef __cplusplus
extern "C" {
#endif
#define LIBTASN1_VERSION "0.2.3"
#include <sys/types.h>
#include <time.h>
#define MAX_NAME_SIZE 128 /* maximum number of characters of a name */
/* inside a file with ASN1 definitons */
#define MAX_ERROR_DESCRIPTION_SIZE 128 /* maximum number of characters */
/* of a description message */
/* (null character included) */
typedef int asn1_retCode; /* type returned by libasn1 functions */
/*****************************************/
/* Errors returned by libasn1 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 1
#define ASN1_CLASS_APPLICATION 2
#define ASN1_CLASS_CONTEXT_SPECIFIC 3
#define ASN1_CLASS_PRIVATE 4
/*****************************************/
/* 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
/******************************************************/
/* Structure definition used for the node of the tree */
/* that rappresent an ASN.1 DEFINITION. */
/******************************************************/
typedef struct node_asn_struct{
char *name; /* Node name */
unsigned int type; /* Node type */
unsigned char *value; /* Node value */
struct node_asn_struct *down; /* Pointer to the son node */
struct node_asn_struct *right; /* Pointer to the brother node */
struct node_asn_struct *left; /* Pointer to the next list element */
} node_asn;
typedef node_asn* ASN1_TYPE;
#define ASN1_TYPE_EMPTY NULL
struct static_struct_asn{
char *name; /* Node name */
unsigned int type; /* Node type */
unsigned char *value; /* Node value */
};
typedef struct static_struct_asn ASN1_ARRAY_TYPE;
/***********************************/
/* Functions definitions */
/***********************************/
asn1_retCode asn1_parser2tree(const char *file_name,ASN1_TYPE *definitions,
char *errorDescription);
asn1_retCode asn1_parser2array(const char *inputFileName,const char *outputFileName,
const char *vectorName,char *errorDescription);
asn1_retCode asn1_array2tree(const ASN1_ARRAY_TYPE *array,
ASN1_TYPE *definitions,char *errorDescription);
void asn1_print_structure(FILE *out,ASN1_TYPE structure,const char *name,int mode);
asn1_retCode asn1_create_element(ASN1_TYPE definitions,const char *source_name,
ASN1_TYPE *element);
asn1_retCode asn1_delete_structure(ASN1_TYPE *structure);
asn1_retCode asn1_write_value(ASN1_TYPE element,const char *name,
const unsigned char *value,int len);
asn1_retCode asn1_read_value(ASN1_TYPE element,const char *name,unsigned char *value,
int *len);
asn1_retCode asn1_number_of_elements(ASN1_TYPE element,const char *name,int *num);
asn1_retCode asn1_der_coding(ASN1_TYPE element,const char *name,
unsigned char *der,int *len,char *ErrorDescription);
asn1_retCode asn1_der_decoding(ASN1_TYPE *element,const unsigned char *der,int len,
char *errorDescription);
asn1_retCode asn1_der_decoding_element(ASN1_TYPE *structure,const char *elementName,
const unsigned char *der,int len,char *errorDescription);
asn1_retCode asn1_der_decoding_startEnd(ASN1_TYPE element,const unsigned char *der,
int len,const char *name,int *start, int *end);
asn1_retCode asn1_expand_any_defined_by(ASN1_TYPE definitions,
ASN1_TYPE *element);
asn1_retCode asn1_expand_octet_string(ASN1_TYPE definitions,ASN1_TYPE *element,
const char *octetName,const char *objectName);
asn1_retCode asn1_read_tag(node_asn *root,const char *name,int *tagValue,
int *classValue);
const char* asn1_find_structure_from_oid(ASN1_TYPE definitions,
const char *oidValue);
const char *asn1_check_version( const char *req_version );
const char* libtasn1_strerror(asn1_retCode error);
void libtasn1_perror(asn1_retCode error);
#ifdef __cplusplus
}
#endif
#endif /* LIBASN1_H */
|