This commit was generated by cvs2svn to track changes on a CVS vendor
[openssl.git] / crypto / asn1 / asn1.h
1 /* crypto/asn1/asn1.h */
2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
3  * All rights reserved.
4  *
5  * This package is an SSL implementation written
6  * by Eric Young (eay@cryptsoft.com).
7  * The implementation was written so as to conform with Netscapes SSL.
8  * 
9  * This library is free for commercial and non-commercial use as long as
10  * the following conditions are aheared to.  The following conditions
11  * apply to all code found in this distribution, be it the RC4, RSA,
12  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
13  * included with this distribution is covered by the same copyright terms
14  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
15  * 
16  * Copyright remains Eric Young's, and as such any Copyright notices in
17  * the code are not to be removed.
18  * If this package is used in a product, Eric Young should be given attribution
19  * as the author of the parts of the library used.
20  * This can be in the form of a textual message at program startup or
21  * in documentation (online or textual) provided with the package.
22  * 
23  * Redistribution and use in source and binary forms, with or without
24  * modification, are permitted provided that the following conditions
25  * are met:
26  * 1. Redistributions of source code must retain the copyright
27  *    notice, this list of conditions and the following disclaimer.
28  * 2. Redistributions in binary form must reproduce the above copyright
29  *    notice, this list of conditions and the following disclaimer in the
30  *    documentation and/or other materials provided with the distribution.
31  * 3. All advertising materials mentioning features or use of this software
32  *    must display the following acknowledgement:
33  *    "This product includes cryptographic software written by
34  *     Eric Young (eay@cryptsoft.com)"
35  *    The word 'cryptographic' can be left out if the rouines from the library
36  *    being used are not cryptographic related :-).
37  * 4. If you include any Windows specific code (or a derivative thereof) from 
38  *    the apps directory (application code) you must include an acknowledgement:
39  *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
40  * 
41  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
42  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
45  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
47  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
48  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
49  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
50  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
51  * SUCH DAMAGE.
52  * 
53  * The licence and distribution terms for any publically available version or
54  * derivative of this code cannot be changed.  i.e. this code cannot simply be
55  * copied and put under another distribution licence
56  * [including the GNU Public Licence.]
57  */
58
59 #ifndef HEADER_ASN1_H
60 #define HEADER_ASN1_H
61
62 #ifdef  __cplusplus
63 extern "C" {
64 #endif
65
66 #include <time.h>
67 #include "bn.h"
68 #include "stack.h"
69
70 #define V_ASN1_UNIVERSAL                0x00
71 #define V_ASN1_APPLICATION              0x40
72 #define V_ASN1_CONTEXT_SPECIFIC         0x80
73 #define V_ASN1_PRIVATE                  0xc0
74
75 #define V_ASN1_CONSTRUCTED              0x20
76 #define V_ASN1_PRIMATIVE_TAG            0x1f
77
78 #define V_ASN1_APP_CHOOSE               -2      /* let the recipent choose */
79
80 #define V_ASN1_UNDEF                    -1
81 #define V_ASN1_EOC                      0
82 #define V_ASN1_BOOLEAN                  1       /**/
83 #define V_ASN1_INTEGER                  2
84 #define V_ASN1_NEG_INTEGER              (2+0x100)
85 #define V_ASN1_BIT_STRING               3
86 #define V_ASN1_OCTET_STRING             4
87 #define V_ASN1_NULL                     5
88 #define V_ASN1_OBJECT                   6
89 #define V_ASN1_OBJECT_DESCRIPTOR        7
90 #define V_ASN1_EXTERNAL                 8
91 #define V_ASN1_REAL                     9
92 #define V_ASN1_ENUMERATED               10      /* microsoft weirdness */
93 #define V_ASN1_SEQUENCE                 16
94 #define V_ASN1_SET                      17
95 #define V_ASN1_NUMERICSTRING            18      /**/
96 #define V_ASN1_PRINTABLESTRING          19
97 #define V_ASN1_T61STRING                20
98 #define V_ASN1_TELETEXSTRING            20      /* alias */
99 #define V_ASN1_VIDEOTEXSTRING           21      /**/
100 #define V_ASN1_IA5STRING                22
101 #define V_ASN1_UTCTIME                  23
102 #define V_ASN1_GENERALIZEDTIME          24      /**/
103 #define V_ASN1_GRAPHICSTRING            25      /**/
104 #define V_ASN1_ISO64STRING              26      /**/
105 #define V_ASN1_VISIBLESTRING            26      /* alias */
106 #define V_ASN1_GENERALSTRING            27      /**/
107 #define V_ASN1_UNIVERSALSTRING          28      /**/
108 #define V_ASN1_BMPSTRING                30
109
110 /* For use with d2i_ASN1_type_bytes() */
111 #define B_ASN1_NUMERICSTRING    0x0001
112 #define B_ASN1_PRINTABLESTRING  0x0002
113 #define B_ASN1_T61STRING        0x0004
114 #define B_ASN1_VIDEOTEXSTRING   0x0008
115 #define B_ASN1_IA5STRING        0x0010
116 #define B_ASN1_GRAPHICSTRING    0x0020
117 #define B_ASN1_ISO64STRING      0x0040
118 #define B_ASN1_GENERALSTRING    0x0080
119 #define B_ASN1_UNIVERSALSTRING  0x0100
120 #define B_ASN1_OCTET_STRING     0x0200
121 #define B_ASN1_BIT_STRING       0x0400
122 #define B_ASN1_BMPSTRING        0x0800
123 #define B_ASN1_UNKNOWN          0x1000
124
125 typedef struct asn1_ctx_st
126         {
127         unsigned char *p;/* work char pointer */
128         int eos;        /* end of sequence read for indefinite encoding */
129         int error;      /* error code to use when returning an error */
130         int inf;        /* constructed if 0x20, indefinite is 0x21 */
131         int tag;        /* tag from last 'get object' */
132         int xclass;     /* class from last 'get object' */
133         long slen;      /* length of last 'get object' */
134         unsigned char *max; /* largest value of p alowed */
135         unsigned char *q;/* temporary variable */
136         unsigned char **pp;/* variable */
137         int line;       /* used in error processing */
138         } ASN1_CTX;
139
140 /* These are used internally in the ASN1_OBJECT to keep track of
141  * whether the names and data need to be free()ed */
142 #define ASN1_OBJECT_FLAG_DYNAMIC         0x01   /* internal use */
143 #define ASN1_OBJECT_FLAG_CRITICAL        0x02   /* critical x509v3 object id */
144 #define ASN1_OBJECT_FLAG_DYNAMIC_STRINGS 0x04   /* internal use */
145 #define ASN1_OBJECT_FLAG_DYNAMIC_DATA    0x08   /* internal use */
146 typedef struct asn1_object_st
147         {
148         char *sn,*ln;
149         int nid;
150         int length;
151         unsigned char *data;
152         int flags;      /* Should we free this one */
153         } ASN1_OBJECT;
154
155 #define ASN1_STRING_FLAG_BITS_LEFT 0x08 /* Set if 0x07 has bits left value */
156 /* This is the base type that holds just about everything :-) */
157 typedef struct asn1_string_st
158         {
159         int length;
160         int type;
161         unsigned char *data;
162         /* The value of the following field depends on the type being
163          * held.  It is mostly being used for BIT_STRING so if the
164          * input data has a non-zero 'unused bits' value, it will be
165          * handled correctly */
166         long flags;
167         } ASN1_STRING;
168
169 #ifndef DEBUG
170 #define ASN1_INTEGER            ASN1_STRING
171 #define ASN1_BIT_STRING         ASN1_STRING
172 #define ASN1_OCTET_STRING       ASN1_STRING
173 #define ASN1_PRINTABLESTRING    ASN1_STRING
174 #define ASN1_T61STRING          ASN1_STRING
175 #define ASN1_IA5STRING          ASN1_STRING
176 #define ASN1_UTCTIME            ASN1_STRING
177 #define ASN1_GENERALIZEDTIME    ASN1_STRING
178 #define ASN1_GENERALSTRING      ASN1_STRING
179 #define ASN1_UNIVERSALSTRING    ASN1_STRING
180 #define ASN1_BMPSTRING          ASN1_STRING
181 #else
182 typedef struct asn1_string_st ASN1_INTEGER;
183 typedef struct asn1_string_st ASN1_BIT_STRING;
184 typedef struct asn1_string_st ASN1_OCTET_STRING;
185 typedef struct asn1_string_st ASN1_PRINTABLESTRING;
186 typedef struct asn1_string_st ASN1_T61STRING;
187 typedef struct asn1_string_st ASN1_IA5STRING;
188 typedef struct asn1_string_st ASN1_GENERALSTRING;
189 typedef struct asn1_string_st ASN1_UNIVERSALSTRING;
190 typedef struct asn1_string_st ASN1_BMPSTRING;
191 typedef struct asn1_string_st ASN1_UTCTIME;
192 typedef struct asn1_string_st ASN1_GENERALIZEDTIME;
193 #endif
194
195 typedef struct asn1_type_st
196         {
197         int type;
198         union   {
199                 char *ptr;
200                 ASN1_STRING *           asn1_string;
201                 ASN1_OBJECT *           object;
202                 ASN1_INTEGER *          integer;
203                 ASN1_BIT_STRING *       bit_string;
204                 ASN1_OCTET_STRING *     octet_string;
205                 ASN1_PRINTABLESTRING *  printablestring;
206                 ASN1_T61STRING *        t61string;
207                 ASN1_IA5STRING *        ia5string;
208                 ASN1_GENERALSTRING *    generalstring;
209                 ASN1_BMPSTRING *        bmpstring;
210                 ASN1_UNIVERSALSTRING *  universalstring;
211                 ASN1_UTCTIME *          utctime;
212                 ASN1_GENERALIZEDTIME *  generalizedtime;
213                 /* set and sequence are left complete and still
214                  * contain the set or sequence bytes */
215                 ASN1_STRING *           set;
216                 ASN1_STRING *           sequence;
217                 } value;
218         } ASN1_TYPE;
219
220 typedef struct asn1_method_st
221         {
222         int (*i2d)();
223         char *(*d2i)();
224         char *(*create)();
225         void (*destroy)();
226         } ASN1_METHOD;
227
228 /* This is used when parsing some Netscape objects */
229 typedef struct asn1_header_st
230         {
231         ASN1_OCTET_STRING *header;
232         char *data;
233         ASN1_METHOD *meth;
234         } ASN1_HEADER;
235
236 #define ASN1_STRING_length(x)   ((x)->length)
237 #define ASN1_STRING_type(x)     ((x)->type)
238 #define ASN1_STRING_data(x)     ((x)->data)
239
240 /* Macros for string operations */
241 #define ASN1_BIT_STRING_new()   (ASN1_BIT_STRING *)\
242                 ASN1_STRING_type_new(V_ASN1_BIT_STRING)
243 #define ASN1_BIT_STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
244 #define ASN1_BIT_STRING_dup(a) (ASN1_BIT_STRING *)\
245                 ASN1_STRING_dup((ASN1_STRING *)a)
246 #define ASN1_BIT_STRING_cmp(a,b) ASN1_STRING_cmp(\
247                 (ASN1_STRING *)a,(ASN1_STRING *)b)
248 #define ASN1_BIT_STRING_set(a,b,c) ASN1_STRING_set((ASN1_STRING *)a,b,c)
249 /* i2d_ASN1_BIT_STRING() is a function */
250 /* d2i_ASN1_BIT_STRING() is a function */
251
252 #define ASN1_INTEGER_new()      (ASN1_INTEGER *)\
253                 ASN1_STRING_type_new(V_ASN1_INTEGER)
254 #define ASN1_INTEGER_free(a)            ASN1_STRING_free((ASN1_STRING *)a)
255 #define ASN1_INTEGER_dup(a) (ASN1_INTEGER *)ASN1_STRING_dup((ASN1_STRING *)a)
256 #define ASN1_INTEGER_cmp(a,b)   ASN1_STRING_cmp(\
257                 (ASN1_STRING *)a,(ASN1_STRING *)b)
258 /* ASN1_INTEGER_set() is a function, also see BN_to_ASN1_INTEGER() */
259 /* ASN1_INTEGER_get() is a function, also see ASN1_INTEGER_to_BN() */
260 /* i2d_ASN1_INTEGER() is a function */
261 /* d2i_ASN1_INTEGER() is a function */
262
263 #define ASN1_OCTET_STRING_new() (ASN1_OCTET_STRING *)\
264                 ASN1_STRING_type_new(V_ASN1_OCTET_STRING)
265 #define ASN1_OCTET_STRING_free(a)       ASN1_STRING_free((ASN1_STRING *)a)
266 #define ASN1_OCTET_STRING_dup(a) (ASN1_OCTET_STRING *)\
267                 ASN1_STRING_dup((ASN1_STRING *)a)
268 #define ASN1_OCTET_STRING_cmp(a,b) ASN1_STRING_cmp(\
269                 (ASN1_STRING *)a,(ASN1_STRING *)b)
270 #define ASN1_OCTET_STRING_set(a,b,c)    ASN1_STRING_set((ASN1_STRING *)a,b,c)
271 #define ASN1_OCTET_STRING_print(a,b)    ASN1_STRING_print(a,(ASN1_STRING *)b)
272 #define M_i2d_ASN1_OCTET_STRING(a,pp) \
273                 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_OCTET_STRING,\
274                 V_ASN1_OCTET_STRING)
275 /* d2i_ASN1_OCTET_STRING() is a function */
276
277 #define ASN1_PRINTABLE_new()    ASN1_STRING_type_new(V_ASN1_T61STRING)
278 #define ASN1_PRINTABLE_free(a)  ASN1_STRING_free((ASN1_STRING *)a)
279 #define M_i2d_ASN1_PRINTABLE(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\
280                 pp,a->type,V_ASN1_UNIVERSAL)
281 #define M_d2i_ASN1_PRINTABLE(a,pp,l) \
282                 d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \
283                         B_ASN1_PRINTABLESTRING| \
284                         B_ASN1_T61STRING| \
285                         B_ASN1_IA5STRING| \
286                         B_ASN1_BIT_STRING| \
287                         B_ASN1_UNIVERSALSTRING|\
288                         B_ASN1_BMPSTRING|\
289                         B_ASN1_UNKNOWN)
290
291 #define ASN1_PRINTABLESTRING_new() (ASN1_PRINTABLESTRING_STRING *)\
292                 ASN1_STRING_type_new(V_ASN1_PRINTABLESTRING)
293 #define ASN1_PRINTABLESTRING_free(a)    ASN1_STRING_free((ASN1_STRING *)a)
294 #define M_i2d_ASN1_PRINTABLESTRING(a,pp) \
295                 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_PRINTABLESTRING,\
296                 V_ASN1_UNIVERSAL)
297 #define M_d2i_ASN1_PRINTABLESTRING(a,pp,l) \
298                 (ASN1_PRINTABLESTRING *)d2i_ASN1_type_bytes\
299                 ((ASN1_STRING **)a,pp,l,B_ASN1_PRINTABLESTRING)
300
301 #define ASN1_T61STRING_new()    (ASN1_T61STRING_STRING *)\
302                 ASN1_STRING_type_new(V_ASN1_T61STRING)
303 #define ASN1_T61STRING_free(a)  ASN1_STRING_free((ASN1_STRING *)a)
304 #define M_i2d_ASN1_T61STRING(a,pp) \
305                 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_T61STRING,\
306                 V_ASN1_UNIVERSAL)
307 #define M_d2i_ASN1_T61STRING(a,pp,l) \
308                 (ASN1_T61STRING *)d2i_ASN1_type_bytes\
309                 ((ASN1_STRING **)a,pp,l,B_ASN1_T61STRING)
310
311 #define ASN1_IA5STRING_new()    (ASN1_IA5STRING *)\
312                 ASN1_STRING_type_new(V_ASN1_IA5STRING)
313 #define ASN1_IA5STRING_free(a)  ASN1_STRING_free((ASN1_STRING *)a)
314 #define M_i2d_ASN1_IA5STRING(a,pp) \
315                 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_IA5STRING,\
316                         V_ASN1_UNIVERSAL)
317 #define M_d2i_ASN1_IA5STRING(a,pp,l) \
318                 (ASN1_IA5STRING *)d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l,\
319                         B_ASN1_IA5STRING)
320
321 #define ASN1_UTCTIME_new()      (ASN1_UTCTIME *)\
322                 ASN1_STRING_type_new(V_ASN1_UTCTIME)
323 #define ASN1_UTCTIME_free(a)    ASN1_STRING_free((ASN1_STRING *)a)
324 #define ASN1_UTCTIME_dup(a) (ASN1_UTCTIME *)ASN1_STRING_dup((ASN1_STRING *)a)
325 /* i2d_ASN1_UTCTIME() is a function */
326 /* d2i_ASN1_UTCTIME() is a function */
327 /* ASN1_UTCTIME_set() is a function */
328 /* ASN1_UTCTIME_check() is a function */
329
330 #define ASN1_GENERALIZEDTIME_new()      (ASN1_GENERALIZEDTIME *)\
331                 ASN1_STRING_type_new(V_ASN1_GENERALIZEDTIME)
332 #define ASN1_GENERALIZEDTIME_free(a)    ASN1_STRING_free((ASN1_STRING *)a)
333 #define ASN1_GENERALIZEDTIME_dup(a) (ASN1_UTCTIME *)ASN1_STRING_dup(\
334         (ASN1_STRING *)a)
335 /* DOES NOT EXIST YET i2d_ASN1_GENERALIZEDTIME() is a function */
336 /* DOES NOT EXIST YET d2i_ASN1_GENERALIZEDTIME() is a function */
337 /* DOES NOT EXIST YET ASN1_GENERALIZEDTIME_set() is a function */
338 /* DOES NOT EXIST YET ASN1_GENERALIZEDTIME_check() is a function */
339
340 #define ASN1_GENERALSTRING_new()        (ASN1_GENERALSTRING *)\
341                 ASN1_STRING_type_new(V_ASN1_GENERALSTRING)
342 #define ASN1_GENERALSTRING_free(a)      ASN1_STRING_free((ASN1_STRING *)a)
343 #define M_i2d_ASN1_GENERALSTRING(a,pp) \
344                 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_GENERALSTRING,\
345                         V_ASN1_UNIVERSAL)
346 #define M_d2i_ASN1_GENERALSTRING(a,pp,l) \
347                 (ASN1_GENERALSTRING *)d2i_ASN1_type_bytes\
348                 ((ASN1_STRING **)a,pp,l,B_ASN1_GENERALSTRING)
349
350 #define ASN1_UNIVERSALSTRING_new()      (ASN1_UNIVERSALSTRING *)\
351                 ASN1_STRING_type_new(V_ASN1_UNIVERSALSTRING)
352 #define ASN1_UNIVERSALSTRING_free(a)    ASN1_STRING_free((ASN1_STRING *)a)
353 #define M_i2d_ASN1_UNIVERSALSTRING(a,pp) \
354                 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_UNIVERSALSTRING,\
355                         V_ASN1_UNIVERSAL)
356 #define M_d2i_ASN1_UNIVERSALSTRING(a,pp,l) \
357                 (ASN1_UNIVERSALSTRING *)d2i_ASN1_type_bytes\
358                 ((ASN1_STRING **)a,pp,l,B_ASN1_UNIVERSALSTRING)
359
360 #define ASN1_BMPSTRING_new()    (ASN1_BMPSTRING *)\
361                 ASN1_STRING_type_new(V_ASN1_BMPSTRING)
362 #define ASN1_BMPSTRING_free(a)  ASN1_STRING_free((ASN1_STRING *)a)
363 #define M_i2d_ASN1_BMPSTRING(a,pp) \
364                 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_BMPSTRING,\
365                         V_ASN1_UNIVERSAL)
366 #define M_d2i_ASN1_BMPSTRING(a,pp,l) \
367                 (ASN1_BMPSTRING *)d2i_ASN1_type_bytes\
368                 ((ASN1_STRING **)a,pp,l,B_ASN1_BMPSTRING)
369
370 #ifndef NOPROTO
371 ASN1_TYPE *     ASN1_TYPE_new(void );
372 void            ASN1_TYPE_free(ASN1_TYPE *a);
373 int             i2d_ASN1_TYPE(ASN1_TYPE *a,unsigned char **pp);
374 ASN1_TYPE *     d2i_ASN1_TYPE(ASN1_TYPE **a,unsigned char **pp,long length);
375 int ASN1_TYPE_get(ASN1_TYPE *a);
376 void ASN1_TYPE_set(ASN1_TYPE *a, int type, char *value);
377
378 ASN1_OBJECT *   ASN1_OBJECT_new(void );
379 void            ASN1_OBJECT_free(ASN1_OBJECT *a);
380 int             i2d_ASN1_OBJECT(ASN1_OBJECT *a,unsigned char **pp);
381 ASN1_OBJECT *   d2i_ASN1_OBJECT(ASN1_OBJECT **a,unsigned char **pp,
382                         long length);
383
384 ASN1_STRING *   ASN1_STRING_new(void );
385 void            ASN1_STRING_free(ASN1_STRING *a);
386 ASN1_STRING *   ASN1_STRING_dup(ASN1_STRING *a);
387 ASN1_STRING *   ASN1_STRING_type_new(int type );
388 int             ASN1_STRING_cmp(ASN1_STRING *a, ASN1_STRING *b);
389 int             ASN1_STRING_set(ASN1_STRING *str,unsigned char *data, int len);
390
391 int             i2d_ASN1_BIT_STRING(ASN1_BIT_STRING *a,unsigned char **pp);
392 ASN1_BIT_STRING *d2i_ASN1_BIT_STRING(ASN1_BIT_STRING **a,unsigned char **pp,
393                         long length);
394 int             ASN1_BIT_STRING_set_bit(ASN1_BIT_STRING *a, int n, int value);
395 int             ASN1_BIT_STRING_get_bit(ASN1_BIT_STRING *a, int n);
396
397
398 int             i2d_ASN1_BOOLEAN(int a,unsigned char **pp);
399 int             d2i_ASN1_BOOLEAN(int *a,unsigned char **pp,long length);
400
401 int             i2d_ASN1_INTEGER(ASN1_INTEGER *a,unsigned char **pp);
402 ASN1_INTEGER *d2i_ASN1_INTEGER(ASN1_INTEGER **a,unsigned char **pp,
403                         long length);
404
405 int ASN1_UTCTIME_check(ASN1_UTCTIME *a);
406 ASN1_UTCTIME *ASN1_UTCTIME_set(ASN1_UTCTIME *s,time_t t);
407 int ASN1_UTCTIME_set_string(ASN1_UTCTIME *s, char *str); 
408
409 int             i2d_ASN1_OCTET_STRING(ASN1_OCTET_STRING *a,unsigned char **pp);
410 ASN1_OCTET_STRING *d2i_ASN1_OCTET_STRING(ASN1_OCTET_STRING **a,
411                         unsigned char **pp,long length);
412
413 int i2d_ASN1_BMPSTRING(ASN1_BMPSTRING *a, unsigned char **pp);
414 ASN1_BMPSTRING *d2i_ASN1_BMPSTRING(ASN1_BMPSTRING **a, unsigned char **pp,
415         long length);
416
417 int i2d_ASN1_PRINTABLE(ASN1_STRING *a,unsigned char **pp);
418 ASN1_STRING *d2i_ASN1_PRINTABLE(ASN1_STRING **a,
419         unsigned char **pp, long l);
420 ASN1_PRINTABLESTRING *d2i_ASN1_PRINTABLESTRING(ASN1_PRINTABLESTRING **a,
421         unsigned char **pp, long l);
422
423 ASN1_T61STRING *d2i_ASN1_T61STRING(ASN1_T61STRING **a,
424         unsigned char **pp, long l);
425 int i2d_ASN1_IA5STRING(ASN1_IA5STRING *a,unsigned char **pp);
426 ASN1_IA5STRING *d2i_ASN1_IA5STRING(ASN1_IA5STRING **a,
427         unsigned char **pp, long l);
428
429 int             i2d_ASN1_UTCTIME(ASN1_UTCTIME *a,unsigned char **pp);
430 ASN1_UTCTIME *  d2i_ASN1_UTCTIME(ASN1_UTCTIME **a,unsigned char **pp,
431                         long length);
432
433 int             i2d_ASN1_SET(STACK *a, unsigned char **pp,
434                         int (*func)(), int ex_tag, int ex_class);
435 STACK *         d2i_ASN1_SET(STACK **a, unsigned char **pp, long length,
436                         char *(*func)(), void (*free_func)(),
437                         int ex_tag, int ex_class);
438
439 #ifdef HEADER_BIO_H
440 int i2a_ASN1_INTEGER(BIO *bp, ASN1_INTEGER *a);
441 int a2i_ASN1_INTEGER(BIO *bp,ASN1_INTEGER *bs,char *buf,int size);
442 int i2a_ASN1_OBJECT(BIO *bp,ASN1_OBJECT *a);
443 int a2i_ASN1_STRING(BIO *bp,ASN1_STRING *bs,char *buf,int size);
444 int i2a_ASN1_STRING(BIO *bp, ASN1_STRING *a, int type);
445 #endif
446 int i2t_ASN1_OBJECT(char *buf,int buf_len,ASN1_OBJECT *a);
447
448 int a2d_ASN1_OBJECT(unsigned char *out,int olen, char *buf, int num);
449 ASN1_OBJECT *ASN1_OBJECT_create(int nid, unsigned char *data,int len,
450         char *sn, char *ln);
451
452 int ASN1_INTEGER_set(ASN1_INTEGER *a, long v);
453 long ASN1_INTEGER_get(ASN1_INTEGER *a);
454 ASN1_INTEGER *BN_to_ASN1_INTEGER(BIGNUM *bn, ASN1_INTEGER *ai);
455 BIGNUM *ASN1_INTEGER_to_BN(ASN1_INTEGER *ai,BIGNUM *bn);
456
457 /* General */
458 /* given a string, return the correct type, max is the maximum length */
459 int ASN1_PRINTABLE_type(unsigned char *s, int max);
460
461 int i2d_ASN1_bytes(ASN1_STRING *a, unsigned char **pp, int tag, int xclass);
462 ASN1_STRING *d2i_ASN1_bytes(ASN1_STRING **a, unsigned char **pp,
463         long length, int Ptag, int Pclass);
464 /* type is one or more of the B_ASN1_ values. */
465 ASN1_STRING *d2i_ASN1_type_bytes(ASN1_STRING **a,unsigned char **pp,
466                 long length,int type);
467
468 /* PARSING */
469 int asn1_Finish(ASN1_CTX *c);
470
471 /* SPECIALS */
472 int ASN1_get_object(unsigned char **pp, long *plength, int *ptag,
473         int *pclass, long omax);
474 int ASN1_check_infinite_end(unsigned char **p,long len);
475 void ASN1_put_object(unsigned char **pp, int constructed, int length,
476         int tag, int xclass);
477 int ASN1_object_size(int constructed, int length, int tag);
478
479 /* Used to implement other functions */
480 char *ASN1_dup(int (*i2d)(),char *(*d2i)(),char *x);
481
482 #ifndef NO_FP_API
483 char *ASN1_d2i_fp(char *(*xnew)(),char *(*d2i)(),FILE *fp,unsigned char **x);
484 int ASN1_i2d_fp(int (*i2d)(),FILE *out,unsigned char *x);
485 #endif
486
487 #ifdef HEADER_BIO_H
488 char *ASN1_d2i_bio(char *(*xnew)(),char *(*d2i)(),BIO *bp,unsigned char **x);
489 int ASN1_i2d_bio(int (*i2d)(),BIO *out,unsigned char *x);
490 int ASN1_UTCTIME_print(BIO *fp,ASN1_UTCTIME *a);
491 int ASN1_STRING_print(BIO *bp,ASN1_STRING *v);
492 int ASN1_parse(BIO *bp,unsigned char *pp,long len,int indent);
493 #endif
494
495 /* Used to load and write netscape format cert/key */
496 int i2d_ASN1_HEADER(ASN1_HEADER *a,unsigned char **pp);
497 ASN1_HEADER *d2i_ASN1_HEADER(ASN1_HEADER **a,unsigned char **pp, long length);
498 ASN1_HEADER *ASN1_HEADER_new(void );
499 void ASN1_HEADER_free(ASN1_HEADER *a);
500
501 int ASN1_UNIVERSALSTRING_to_string(ASN1_UNIVERSALSTRING *s);
502
503 void ERR_load_ASN1_strings(void);
504
505 /* Not used that much at this point, except for the first two */
506 ASN1_METHOD *X509_asn1_meth(void);
507 ASN1_METHOD *RSAPrivateKey_asn1_meth(void);
508 ASN1_METHOD *ASN1_IA5STRING_asn1_meth(void);
509 ASN1_METHOD *ASN1_BIT_STRING_asn1_meth(void);
510
511 int ASN1_TYPE_set_octetstring(ASN1_TYPE *a,
512         unsigned char *data, int len);
513 int ASN1_TYPE_get_octetstring(ASN1_TYPE *a,
514         unsigned char *data, int max_len);
515 int ASN1_TYPE_set_int_octetstring(ASN1_TYPE *a, long num,
516         unsigned char *data, int len);
517 int ASN1_TYPE_get_int_octetstring(ASN1_TYPE *a,long *num,
518         unsigned char *data, int max_len);
519
520 #else
521
522 ASN1_TYPE *     ASN1_TYPE_new();
523 void            ASN1_TYPE_free();
524 int             i2d_ASN1_TYPE();
525 ASN1_TYPE *     d2i_ASN1_TYPE();
526 int ASN1_TYPE_get();
527 void ASN1_TYPE_set();
528
529 ASN1_OBJECT *   ASN1_OBJECT_new();
530 void            ASN1_OBJECT_free();
531 int             i2d_ASN1_OBJECT();
532 ASN1_OBJECT *   d2i_ASN1_OBJECT();
533 ASN1_STRING *   ASN1_STRING_new();
534 void            ASN1_STRING_free();
535 ASN1_STRING *   ASN1_STRING_dup();
536 ASN1_STRING *   ASN1_STRING_type_new();
537 int             ASN1_STRING_cmp();
538 int             ASN1_STRING_set();
539 int             i2d_ASN1_BIT_STRING();
540 ASN1_BIT_STRING *d2i_ASN1_BIT_STRING();
541 int             ASN1_BIT_STRING_set_bit();
542 int             ASN1_BIT_STRING_get_bit();
543 int             i2d_ASN1_BOOLEAN();
544 int             d2i_ASN1_BOOLEAN();
545 int             i2d_ASN1_INTEGER();
546 ASN1_INTEGER *d2i_ASN1_INTEGER();
547 int ASN1_UTCTIME_check();
548 ASN1_UTCTIME *ASN1_UTCTIME_set();
549 int ASN1_UTCTIME_set_string();
550 int             i2d_ASN1_OCTET_STRING();
551 ASN1_OCTET_STRING *d2i_ASN1_OCTET_STRING();
552 int i2d_ASN1_PRINTABLE();
553 ASN1_STRING *d2i_ASN1_PRINTABLE();
554 ASN1_PRINTABLESTRING *d2i_ASN1_PRINTABLESTRING();
555 ASN1_T61STRING *d2i_ASN1_T61STRING();
556 int i2d_ASN1_IA5STRING();
557 ASN1_IA5STRING *d2i_ASN1_IA5STRING();
558 int             i2d_ASN1_UTCTIME();
559 ASN1_UTCTIME *  d2i_ASN1_UTCTIME();
560 int             i2d_ASN1_SET();
561 STACK *         d2i_ASN1_SET();
562 int a2d_ASN1_OBJECT();
563 ASN1_OBJECT *ASN1_OBJECT_create();
564 int ASN1_INTEGER_set();
565 long ASN1_INTEGER_get();
566 ASN1_INTEGER *BN_to_ASN1_INTEGER();
567 BIGNUM *ASN1_INTEGER_to_BN();
568 int ASN1_PRINTABLE_type();
569 int i2d_ASN1_bytes();
570 ASN1_STRING *d2i_ASN1_bytes();
571 ASN1_STRING *d2i_ASN1_type_bytes();
572 int asn1_Finish();
573 int ASN1_get_object();
574 int ASN1_check_infinite_end();
575 void ASN1_put_object();
576 int ASN1_object_size();
577 char *ASN1_dup();
578 #ifndef NO_FP_API
579 char *ASN1_d2i_fp();
580 int ASN1_i2d_fp();
581 #endif
582
583 char *ASN1_d2i_bio();
584 int ASN1_i2d_bio();
585 int ASN1_UTCTIME_print();
586 int ASN1_STRING_print();
587 int ASN1_parse();
588 int i2a_ASN1_INTEGER();
589 int a2i_ASN1_INTEGER();
590 int i2a_ASN1_OBJECT();
591 int i2t_ASN1_OBJECT();
592 int a2i_ASN1_STRING();
593 int i2a_ASN1_STRING();
594
595 int i2d_ASN1_HEADER();
596 ASN1_HEADER *d2i_ASN1_HEADER();
597 ASN1_HEADER *ASN1_HEADER_new();
598 void ASN1_HEADER_free();
599 void ERR_load_ASN1_strings();
600 ASN1_METHOD *X509_asn1_meth();
601 ASN1_METHOD *RSAPrivateKey_asn1_meth();
602 ASN1_METHOD *ASN1_IA5STRING_asn1_meth();
603 ASN1_METHOD *ASN1_BIT_STRING_asn1_meth();
604
605 int ASN1_UNIVERSALSTRING_to_string();
606
607 int ASN1_TYPE_set_octetstring();
608 int ASN1_TYPE_get_octetstring();
609 int ASN1_TYPE_set_int_octetstring();
610 int ASN1_TYPE_get_int_octetstring();
611
612 int i2d_ASN1_BMPSTRING();
613 ASN1_BMPSTRING *d2i_ASN1_BMPSTRING();
614
615 #endif
616
617 /* BEGIN ERROR CODES */
618 /* Error codes for the ASN1 functions. */
619
620 /* Function codes. */
621 #define ASN1_F_A2D_ASN1_OBJECT                           100
622 #define ASN1_F_A2I_ASN1_INTEGER                          101
623 #define ASN1_F_A2I_ASN1_STRING                           102
624 #define ASN1_F_ASN1_COLLATE_PRIMATIVE                    103
625 #define ASN1_F_ASN1_D2I_BIO                              104
626 #define ASN1_F_ASN1_D2I_FP                               105
627 #define ASN1_F_ASN1_DUP                                  106
628 #define ASN1_F_ASN1_GET_OBJECT                           107
629 #define ASN1_F_ASN1_HEADER_NEW                           108
630 #define ASN1_F_ASN1_I2D_BIO                              109
631 #define ASN1_F_ASN1_I2D_FP                               110
632 #define ASN1_F_ASN1_INTEGER_SET                          111
633 #define ASN1_F_ASN1_INTEGER_TO_BN                        112
634 #define ASN1_F_ASN1_OBJECT_NEW                           113
635 #define ASN1_F_ASN1_SIGN                                 114
636 #define ASN1_F_ASN1_STRING_NEW                           115
637 #define ASN1_F_ASN1_STRING_TYPE_NEW                      116
638 #define ASN1_F_ASN1_TYPE_GET_INT_OCTETSTRING             117
639 #define ASN1_F_ASN1_TYPE_GET_OCTETSTRING                 118
640 #define ASN1_F_ASN1_TYPE_NEW                             119
641 #define ASN1_F_ASN1_UTCTIME_NEW                          120
642 #define ASN1_F_ASN1_VERIFY                               121
643 #define ASN1_F_BN_TO_ASN1_INTEGER                        122
644 #define ASN1_F_D2I_ASN1_BIT_STRING                       123
645 #define ASN1_F_D2I_ASN1_BMPSTRING                        124
646 #define ASN1_F_D2I_ASN1_BOOLEAN                          125
647 #define ASN1_F_D2I_ASN1_BYTES                            126
648 #define ASN1_F_D2I_ASN1_HEADER                           127
649 #define ASN1_F_D2I_ASN1_INTEGER                          128
650 #define ASN1_F_D2I_ASN1_OBJECT                           129
651 #define ASN1_F_D2I_ASN1_OCTET_STRING                     130
652 #define ASN1_F_D2I_ASN1_PRINT_TYPE                       131
653 #define ASN1_F_D2I_ASN1_SET                              132
654 #define ASN1_F_D2I_ASN1_TYPE                             133
655 #define ASN1_F_D2I_ASN1_TYPE_BYTES                       134
656 #define ASN1_F_D2I_ASN1_UTCTIME                          135
657 #define ASN1_F_D2I_DHPARAMS                              136
658 #define ASN1_F_D2I_DSAPARAMS                             137
659 #define ASN1_F_D2I_DSAPRIVATEKEY                         138
660 #define ASN1_F_D2I_DSAPUBLICKEY                          139
661 #define ASN1_F_D2I_NETSCAPE_PKEY                         140
662 #define ASN1_F_D2I_NETSCAPE_RSA                          141
663 #define ASN1_F_D2I_NETSCAPE_RSA_2                        142
664 #define ASN1_F_D2I_NETSCAPE_SPKAC                        143
665 #define ASN1_F_D2I_NETSCAPE_SPKI                         144
666 #define ASN1_F_D2I_PKCS7                                 145
667 #define ASN1_F_D2I_PKCS7_DIGEST                          146
668 #define ASN1_F_D2I_PKCS7_ENCRYPT                         147
669 #define ASN1_F_D2I_PKCS7_ENC_CONTENT                     148
670 #define ASN1_F_D2I_PKCS7_ENVELOPE                        149
671 #define ASN1_F_D2I_PKCS7_ISSUER_AND_SERIAL               150
672 #define ASN1_F_D2I_PKCS7_RECIP_INFO                      151
673 #define ASN1_F_D2I_PKCS7_SIGNED                          152
674 #define ASN1_F_D2I_PKCS7_SIGNER_INFO                     153
675 #define ASN1_F_D2I_PKCS7_SIGN_ENVELOPE                   154
676 #define ASN1_F_D2I_PRIVATEKEY                            155
677 #define ASN1_F_D2I_PUBLICKEY                             156
678 #define ASN1_F_D2I_RSAPRIVATEKEY                         157
679 #define ASN1_F_D2I_RSAPUBLICKEY                          158
680 #define ASN1_F_D2I_X509                                  159
681 #define ASN1_F_D2I_X509_ALGOR                            160
682 #define ASN1_F_D2I_X509_ATTRIBUTE                        161
683 #define ASN1_F_D2I_X509_CINF                             162
684 #define ASN1_F_D2I_X509_CRL                              163
685 #define ASN1_F_D2I_X509_CRL_INFO                         164
686 #define ASN1_F_D2I_X509_EXTENSION                        165
687 #define ASN1_F_D2I_X509_KEY                              166
688 #define ASN1_F_D2I_X509_NAME                             167
689 #define ASN1_F_D2I_X509_NAME_ENTRY                       168
690 #define ASN1_F_D2I_X509_PKEY                             169
691 #define ASN1_F_D2I_X509_PUBKEY                           170
692 #define ASN1_F_D2I_X509_REQ                              171
693 #define ASN1_F_D2I_X509_REQ_INFO                         172
694 #define ASN1_F_D2I_X509_REVOKED                          173
695 #define ASN1_F_D2I_X509_SIG                              174
696 #define ASN1_F_D2I_X509_VAL                              175
697 #define ASN1_F_I2D_ASN1_HEADER                           176
698 #define ASN1_F_I2D_DHPARAMS                              177
699 #define ASN1_F_I2D_DSAPARAMS                             178
700 #define ASN1_F_I2D_DSAPRIVATEKEY                         179
701 #define ASN1_F_I2D_DSAPUBLICKEY                          180
702 #define ASN1_F_I2D_NETSCAPE_RSA                          181
703 #define ASN1_F_I2D_PKCS7                                 182
704 #define ASN1_F_I2D_PRIVATEKEY                            183
705 #define ASN1_F_I2D_PUBLICKEY                             184
706 #define ASN1_F_I2D_RSAPRIVATEKEY                         185
707 #define ASN1_F_I2D_RSAPUBLICKEY                          186
708 #define ASN1_F_I2D_X509_ATTRIBUTE                        187
709 #define ASN1_F_I2T_ASN1_OBJECT                           188
710 #define ASN1_F_NETSCAPE_PKEY_NEW                         189
711 #define ASN1_F_NETSCAPE_SPKAC_NEW                        190
712 #define ASN1_F_NETSCAPE_SPKI_NEW                         191
713 #define ASN1_F_PKCS7_DIGEST_NEW                          192
714 #define ASN1_F_PKCS7_ENCRYPT_NEW                         193
715 #define ASN1_F_PKCS7_ENC_CONTENT_NEW                     194
716 #define ASN1_F_PKCS7_ENVELOPE_NEW                        195
717 #define ASN1_F_PKCS7_ISSUER_AND_SERIAL_NEW               196
718 #define ASN1_F_PKCS7_NEW                                 197
719 #define ASN1_F_PKCS7_RECIP_INFO_NEW                      198
720 #define ASN1_F_PKCS7_SIGNED_NEW                          199
721 #define ASN1_F_PKCS7_SIGNER_INFO_NEW                     200
722 #define ASN1_F_PKCS7_SIGN_ENVELOPE_NEW                   201
723 #define ASN1_F_X509_ALGOR_NEW                            202
724 #define ASN1_F_X509_ATTRIBUTE_NEW                        203
725 #define ASN1_F_X509_CINF_NEW                             204
726 #define ASN1_F_X509_CRL_INFO_NEW                         205
727 #define ASN1_F_X509_CRL_NEW                              206
728 #define ASN1_F_X509_DHPARAMS_NEW                         207
729 #define ASN1_F_X509_EXTENSION_NEW                        208
730 #define ASN1_F_X509_INFO_NEW                             209
731 #define ASN1_F_X509_KEY_NEW                              210
732 #define ASN1_F_X509_NAME_ENTRY_NEW                       211
733 #define ASN1_F_X509_NAME_NEW                             212
734 #define ASN1_F_X509_NEW                                  213
735 #define ASN1_F_X509_PKEY_NEW                             214
736 #define ASN1_F_X509_PUBKEY_NEW                           215
737 #define ASN1_F_X509_REQ_INFO_NEW                         216
738 #define ASN1_F_X509_REQ_NEW                              217
739 #define ASN1_F_X509_REVOKED_NEW                          218
740 #define ASN1_F_X509_SIG_NEW                              219
741 #define ASN1_F_X509_VAL_FREE                             220
742 #define ASN1_F_X509_VAL_NEW                              221
743
744 /* Reason codes. */
745 #define ASN1_R_BAD_CLASS                                 100
746 #define ASN1_R_BAD_OBJECT_HEADER                         101
747 #define ASN1_R_BAD_PASSWORD_READ                         102
748 #define ASN1_R_BAD_PKCS7_CONTENT                         103
749 #define ASN1_R_BAD_PKCS7_TYPE                            104
750 #define ASN1_R_BAD_TAG                                   105
751 #define ASN1_R_BAD_TYPE                                  106
752 #define ASN1_R_BN_LIB                                    107
753 #define ASN1_R_BOOLEAN_IS_WRONG_LENGTH                   108
754 #define ASN1_R_BUFFER_TOO_SMALL                          109
755 #define ASN1_R_DATA_IS_WRONG                             110
756 #define ASN1_R_DECODING_ERROR                            111
757 #define ASN1_R_ERROR_PARSING_SET_ELEMENT                 112
758 #define ASN1_R_EXPECTING_AN_INTEGER                      113
759 #define ASN1_R_EXPECTING_AN_OBJECT                       114
760 #define ASN1_R_EXPECTING_AN_OCTET_STRING                 115
761 #define ASN1_R_EXPECTING_A_BIT_STRING                    116
762 #define ASN1_R_EXPECTING_A_BOOLEAN                       117
763 #define ASN1_R_EXPECTING_A_UTCTIME                       118
764 #define ASN1_R_FIRST_NUM_TOO_LARGE                       119
765 #define ASN1_R_HEADER_TOO_LONG                           120
766 #define ASN1_R_INVALID_DIGIT                             121
767 #define ASN1_R_INVALID_SEPARATOR                         122
768 #define ASN1_R_INVALID_TIME_FORMAT                       123
769 #define ASN1_R_IV_TOO_LARGE                              124
770 #define ASN1_R_LENGTH_ERROR                              125
771 #define ASN1_R_MISSING_SECOND_NUMBER                     126
772 #define ASN1_R_NON_HEX_CHARACTERS                        127
773 #define ASN1_R_NOT_ENOUGH_DATA                           128
774 #define ASN1_R_ODD_NUMBER_OF_CHARS                       129
775 #define ASN1_R_PARSING                                   130
776 #define ASN1_R_PRIVATE_KEY_HEADER_MISSING                131
777 #define ASN1_R_SECOND_NUMBER_TOO_LARGE                   132
778 #define ASN1_R_SHORT_LINE                                133
779 #define ASN1_R_STRING_TOO_SHORT                          134
780 #define ASN1_R_TAG_VALUE_TOO_HIGH                        135
781 #define ASN1_R_THE_ASN1_OBJECT_IDENTIFIER_IS_NOT_KNOWN_FOR_THIS_MD 136
782 #define ASN1_R_TOO_LONG                                  137
783 #define ASN1_R_UNABLE_TO_DECODE_RSA_KEY                  138
784 #define ASN1_R_UNABLE_TO_DECODE_RSA_PRIVATE_KEY          139
785 #define ASN1_R_UNKNOWN_ATTRIBUTE_TYPE                    140
786 #define ASN1_R_UNKNOWN_MESSAGE_DIGEST_ALGORITHM          141
787 #define ASN1_R_UNKNOWN_OBJECT_TYPE                       142
788 #define ASN1_R_UNKNOWN_PUBLIC_KEY_TYPE                   143
789 #define ASN1_R_UNSUPPORTED_CIPHER                        144
790 #define ASN1_R_UNSUPPORTED_ENCRYPTION_ALGORITHM          145
791 #define ASN1_R_UNSUPPORTED_PUBLIC_KEY_TYPE               146
792 #define ASN1_R_UTCTIME_TOO_LONG                          147
793 #define ASN1_R_WRONG_PRINTABLE_TYPE                      148
794 #define ASN1_R_WRONG_TAG                                 149
795 #define ASN1_R_WRONG_TYPE                                150
796  
797 #ifdef  __cplusplus
798 }
799 #endif
800 #endif
801