1 /* crypto/asn1/asn1.h */
2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
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.
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).
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.
23 * Redistribution and use in source and binary forms, with or without
24 * modification, are permitted provided that the following conditions
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)"
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
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.]
63 #include <openssl/e_os2.h>
64 #ifndef OPENSSL_NO_BIO
65 #include <openssl/bio.h>
67 #include <openssl/stack.h>
68 #include <openssl/safestack.h>
70 #include <openssl/symhacks.h>
72 #include <openssl/ossl_typ.h>
73 #ifndef OPENSSL_NO_DEPRECATED
74 #include <openssl/bn.h>
77 #ifdef OPENSSL_BUILD_SHLIBCRYPTO
78 # undef OPENSSL_EXTERN
79 # define OPENSSL_EXTERN OPENSSL_EXPORT
86 #define V_ASN1_UNIVERSAL 0x00
87 #define V_ASN1_APPLICATION 0x40
88 #define V_ASN1_CONTEXT_SPECIFIC 0x80
89 #define V_ASN1_PRIVATE 0xc0
91 #define V_ASN1_CONSTRUCTED 0x20
92 #define V_ASN1_PRIMITIVE_TAG 0x1f
93 #define V_ASN1_PRIMATIVE_TAG 0x1f
95 #define V_ASN1_APP_CHOOSE -2 /* let the recipient choose */
96 #define V_ASN1_OTHER -3 /* used in ASN1_TYPE */
97 #define V_ASN1_ANY -4 /* used in ASN1 template code */
99 #define V_ASN1_NEG 0x100 /* negative flag */
101 #define V_ASN1_UNDEF -1
103 #define V_ASN1_BOOLEAN 1 /**/
104 #define V_ASN1_INTEGER 2
105 #define V_ASN1_NEG_INTEGER (2 | V_ASN1_NEG)
106 #define V_ASN1_BIT_STRING 3
107 #define V_ASN1_OCTET_STRING 4
108 #define V_ASN1_NULL 5
109 #define V_ASN1_OBJECT 6
110 #define V_ASN1_OBJECT_DESCRIPTOR 7
111 #define V_ASN1_EXTERNAL 8
112 #define V_ASN1_REAL 9
113 #define V_ASN1_ENUMERATED 10
114 #define V_ASN1_NEG_ENUMERATED (10 | V_ASN1_NEG)
115 #define V_ASN1_UTF8STRING 12
116 #define V_ASN1_SEQUENCE 16
117 #define V_ASN1_SET 17
118 #define V_ASN1_NUMERICSTRING 18 /**/
119 #define V_ASN1_PRINTABLESTRING 19
120 #define V_ASN1_T61STRING 20
121 #define V_ASN1_TELETEXSTRING 20 /* alias */
122 #define V_ASN1_VIDEOTEXSTRING 21 /**/
123 #define V_ASN1_IA5STRING 22
124 #define V_ASN1_UTCTIME 23
125 #define V_ASN1_GENERALIZEDTIME 24 /**/
126 #define V_ASN1_GRAPHICSTRING 25 /**/
127 #define V_ASN1_ISO64STRING 26 /**/
128 #define V_ASN1_VISIBLESTRING 26 /* alias */
129 #define V_ASN1_GENERALSTRING 27 /**/
130 #define V_ASN1_UNIVERSALSTRING 28 /**/
131 #define V_ASN1_BMPSTRING 30
133 /* For use with d2i_ASN1_type_bytes() */
134 #define B_ASN1_NUMERICSTRING 0x0001
135 #define B_ASN1_PRINTABLESTRING 0x0002
136 #define B_ASN1_T61STRING 0x0004
137 #define B_ASN1_TELETEXSTRING 0x0004
138 #define B_ASN1_VIDEOTEXSTRING 0x0008
139 #define B_ASN1_IA5STRING 0x0010
140 #define B_ASN1_GRAPHICSTRING 0x0020
141 #define B_ASN1_ISO64STRING 0x0040
142 #define B_ASN1_VISIBLESTRING 0x0040
143 #define B_ASN1_GENERALSTRING 0x0080
144 #define B_ASN1_UNIVERSALSTRING 0x0100
145 #define B_ASN1_OCTET_STRING 0x0200
146 #define B_ASN1_BIT_STRING 0x0400
147 #define B_ASN1_BMPSTRING 0x0800
148 #define B_ASN1_UNKNOWN 0x1000
149 #define B_ASN1_UTF8STRING 0x2000
150 #define B_ASN1_UTCTIME 0x4000
151 #define B_ASN1_GENERALIZEDTIME 0x8000
152 #define B_ASN1_SEQUENCE 0x10000
154 /* For use with ASN1_mbstring_copy() */
155 #define MBSTRING_FLAG 0x1000
156 #define MBSTRING_UTF8 (MBSTRING_FLAG)
157 #define MBSTRING_ASC (MBSTRING_FLAG|1)
158 #define MBSTRING_BMP (MBSTRING_FLAG|2)
159 #define MBSTRING_UNIV (MBSTRING_FLAG|4)
161 struct X509_algor_st;
163 #define DECLARE_ASN1_SET_OF(type) /* filled in by mkstack.pl */
164 #define IMPLEMENT_ASN1_SET_OF(type) /* nothing, no longer needed */
166 /* We MUST make sure that, except for constness, asn1_ctx_st and
167 asn1_const_ctx are exactly the same. Fortunately, as soon as
168 the old ASN1 parsing macros are gone, we can throw this away
170 typedef struct asn1_ctx_st
172 unsigned char *p;/* work char pointer */
173 int eos; /* end of sequence read for indefinite encoding */
174 int error; /* error code to use when returning an error */
175 int inf; /* constructed if 0x20, indefinite is 0x21 */
176 int tag; /* tag from last 'get object' */
177 int xclass; /* class from last 'get object' */
178 long slen; /* length of last 'get object' */
179 unsigned char *max; /* largest value of p allowed */
180 unsigned char *q;/* temporary variable */
181 unsigned char **pp;/* variable */
182 int line; /* used in error processing */
185 typedef struct asn1_const_ctx_st
187 const unsigned char *p;/* work char pointer */
188 int eos; /* end of sequence read for indefinite encoding */
189 int error; /* error code to use when returning an error */
190 int inf; /* constructed if 0x20, indefinite is 0x21 */
191 int tag; /* tag from last 'get object' */
192 int xclass; /* class from last 'get object' */
193 long slen; /* length of last 'get object' */
194 const unsigned char *max; /* largest value of p allowed */
195 const unsigned char *q;/* temporary variable */
196 const unsigned char **pp;/* variable */
197 int line; /* used in error processing */
200 /* These are used internally in the ASN1_OBJECT to keep track of
201 * whether the names and data need to be free()ed */
202 #define ASN1_OBJECT_FLAG_DYNAMIC 0x01 /* internal use */
203 #define ASN1_OBJECT_FLAG_CRITICAL 0x02 /* critical x509v3 object id */
204 #define ASN1_OBJECT_FLAG_DYNAMIC_STRINGS 0x04 /* internal use */
205 #define ASN1_OBJECT_FLAG_DYNAMIC_DATA 0x08 /* internal use */
206 typedef struct asn1_object_st
212 int flags; /* Should we free this one */
215 #define ASN1_STRING_FLAG_BITS_LEFT 0x08 /* Set if 0x07 has bits left value */
216 /* This indicates that the ASN1_STRING is not a real value but just a place
217 * holder for the location where indefinite length constructed data should
218 * be inserted in the memory buffer
220 #define ASN1_STRING_FLAG_NDEF 0x010
221 /* This is the base type that holds just about everything :-) */
222 typedef struct asn1_string_st
227 /* The value of the following field depends on the type being
228 * held. It is mostly being used for BIT_STRING so if the
229 * input data has a non-zero 'unused bits' value, it will be
230 * handled correctly */
234 /* ASN1_ENCODING structure: this is used to save the received
235 * encoding of an ASN1 type. This is useful to get round
236 * problems with invalid encodings which can break signatures.
239 typedef struct ASN1_ENCODING_st
241 unsigned char *enc; /* DER encoding */
242 long len; /* Length of encoding */
243 int modified; /* set to 1 if 'enc' is invalid */
246 /* Used with ASN1 LONG type: if a long is set to this it is omitted */
247 #define ASN1_LONG_UNDEF 0x7fffffffL
249 #define STABLE_FLAGS_MALLOC 0x01
250 #define STABLE_NO_MASK 0x02
251 #define DIRSTRING_TYPE \
252 (B_ASN1_PRINTABLESTRING|B_ASN1_T61STRING|B_ASN1_BMPSTRING|B_ASN1_UTF8STRING)
253 #define PKCS9STRING_TYPE (DIRSTRING_TYPE|B_ASN1_IA5STRING)
255 typedef struct asn1_string_table_st {
263 DECLARE_STACK_OF(ASN1_STRING_TABLE)
265 /* size limits: this stuff is taken straight from RFC2459 */
267 #define ub_name 32768
268 #define ub_common_name 64
269 #define ub_locality_name 128
270 #define ub_state_name 128
271 #define ub_organization_name 64
272 #define ub_organization_unit_name 64
274 #define ub_email_address 128
276 /* Declarations for template structures: for full definitions
279 typedef struct ASN1_TEMPLATE_st ASN1_TEMPLATE;
280 typedef struct ASN1_ITEM_st ASN1_ITEM;
281 typedef struct ASN1_TLC_st ASN1_TLC;
282 /* This is just an opaque pointer */
283 typedef struct ASN1_VALUE_st ASN1_VALUE;
285 /* Declare ASN1 functions: the implement macro in in asn1t.h */
287 #define DECLARE_ASN1_FUNCTIONS(type) DECLARE_ASN1_FUNCTIONS_name(type, type)
289 #define DECLARE_ASN1_ALLOC_FUNCTIONS(type) \
290 DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, type)
292 #define DECLARE_ASN1_FUNCTIONS_name(type, name) \
293 DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \
294 DECLARE_ASN1_ENCODE_FUNCTIONS(type, name, name)
296 #define DECLARE_ASN1_FUNCTIONS_fname(type, itname, name) \
297 DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \
298 DECLARE_ASN1_ENCODE_FUNCTIONS(type, itname, name)
300 #define DECLARE_ASN1_ENCODE_FUNCTIONS(type, itname, name) \
301 type *d2i_##name(type **a, const unsigned char **in, long len); \
302 int i2d_##name(type *a, unsigned char **out); \
303 DECLARE_ASN1_ITEM(itname)
305 #define DECLARE_ASN1_ENCODE_FUNCTIONS_const(type, name) \
306 type *d2i_##name(type **a, const unsigned char **in, long len); \
307 int i2d_##name(const type *a, unsigned char **out); \
308 DECLARE_ASN1_ITEM(name)
310 #define DECLARE_ASN1_NDEF_FUNCTION(name) \
311 int i2d_##name##_NDEF(name *a, unsigned char **out);
313 #define DECLARE_ASN1_FUNCTIONS_const(name) \
314 name *name##_new(void); \
315 void name##_free(name *a);
317 #define DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \
318 type *name##_new(void); \
319 void name##_free(type *a);
321 #define DECLARE_ASN1_PRINT_FUNCTION(stname) \
322 DECLARE_ASN1_PRINT_FUNCTION_fname(stname, stname)
324 #define DECLARE_ASN1_PRINT_FUNCTION_fname(stname, fname) \
325 int fname##_print_ctx(BIO *out, stname *x, int indent, \
326 const ASN1_PCTX *pctx);
328 #define D2I_OF(type) type *(*)(type **,const unsigned char **,long)
329 #define I2D_OF(type) int (*)(type *,unsigned char **)
330 #define I2D_OF_const(type) int (*)(const type *,unsigned char **)
332 #define CHECKED_D2I_OF(type, d2i) \
333 ((d2i_of_void*) (1 ? d2i : ((D2I_OF(type))0)))
334 #define CHECKED_I2D_OF(type, i2d) \
335 ((i2d_of_void*) (1 ? i2d : ((I2D_OF(type))0)))
336 #define CHECKED_NEW_OF(type, xnew) \
337 ((void *(*)(void)) (1 ? xnew : ((type *(*)(void))0)))
338 #define CHECKED_PTR_OF(type, p) \
339 ((void*) (1 ? p : (type*)0))
340 #define CHECKED_PPTR_OF(type, p) \
341 ((void**) (1 ? p : (type**)0))
343 #define TYPEDEF_D2I_OF(type) typedef type *d2i_of_##type(type **,const unsigned char **,long)
344 #define TYPEDEF_I2D_OF(type) typedef int i2d_of_##type(type *,unsigned char **)
345 #define TYPEDEF_D2I2D_OF(type) TYPEDEF_D2I_OF(type); TYPEDEF_I2D_OF(type)
347 TYPEDEF_D2I2D_OF(void);
349 /* The following macros and typedefs allow an ASN1_ITEM
350 * to be embedded in a structure and referenced. Since
351 * the ASN1_ITEM pointers need to be globally accessible
352 * (possibly from shared libraries) they may exist in
353 * different forms. On platforms that support it the
354 * ASN1_ITEM structure itself will be globally exported.
355 * Other platforms will export a function that returns
356 * an ASN1_ITEM pointer.
358 * To handle both cases transparently the macros below
359 * should be used instead of hard coding an ASN1_ITEM
360 * pointer in a structure.
362 * The structure will look like this:
364 * typedef struct SOMETHING_st {
366 * ASN1_ITEM_EXP *iptr;
370 * It would be initialised as e.g.:
372 * SOMETHING somevar = {...,ASN1_ITEM_ref(X509),...};
374 * and the actual pointer extracted with:
376 * const ASN1_ITEM *it = ASN1_ITEM_ptr(somevar.iptr);
378 * Finally an ASN1_ITEM pointer can be extracted from an
379 * appropriate reference with: ASN1_ITEM_rptr(X509). This
380 * would be used when a function takes an ASN1_ITEM * argument.
384 #ifndef OPENSSL_EXPORT_VAR_AS_FUNCTION
386 /* ASN1_ITEM pointer exported type */
387 typedef const ASN1_ITEM ASN1_ITEM_EXP;
389 /* Macro to obtain ASN1_ITEM pointer from exported type */
390 #define ASN1_ITEM_ptr(iptr) (iptr)
392 /* Macro to include ASN1_ITEM pointer from base type */
393 #define ASN1_ITEM_ref(iptr) (&(iptr##_it))
395 #define ASN1_ITEM_rptr(ref) (&(ref##_it))
397 #define DECLARE_ASN1_ITEM(name) \
398 OPENSSL_EXTERN const ASN1_ITEM name##_it;
402 /* Platforms that can't easily handle shared global variables are declared
403 * as functions returning ASN1_ITEM pointers.
406 /* ASN1_ITEM pointer exported type */
407 typedef const ASN1_ITEM * ASN1_ITEM_EXP(void);
409 /* Macro to obtain ASN1_ITEM pointer from exported type */
410 #define ASN1_ITEM_ptr(iptr) (iptr())
412 /* Macro to include ASN1_ITEM pointer from base type */
413 #define ASN1_ITEM_ref(iptr) (iptr##_it)
415 #define ASN1_ITEM_rptr(ref) (ref##_it())
417 #define DECLARE_ASN1_ITEM(name) \
418 const ASN1_ITEM * name##_it(void);
422 /* Parameters used by ASN1_STRING_print_ex() */
424 /* These determine which characters to escape:
425 * RFC2253 special characters, control characters and
429 #define ASN1_STRFLGS_ESC_2253 1
430 #define ASN1_STRFLGS_ESC_CTRL 2
431 #define ASN1_STRFLGS_ESC_MSB 4
434 /* This flag determines how we do escaping: normally
435 * RC2253 backslash only, set this to use backslash and
439 #define ASN1_STRFLGS_ESC_QUOTE 8
442 /* These three flags are internal use only. */
444 /* Character is a valid PrintableString character */
445 #define CHARTYPE_PRINTABLESTRING 0x10
446 /* Character needs escaping if it is the first character */
447 #define CHARTYPE_FIRST_ESC_2253 0x20
448 /* Character needs escaping if it is the last character */
449 #define CHARTYPE_LAST_ESC_2253 0x40
451 /* NB the internal flags are safely reused below by flags
452 * handled at the top level.
455 /* If this is set we convert all character strings
459 #define ASN1_STRFLGS_UTF8_CONVERT 0x10
461 /* If this is set we don't attempt to interpret content:
462 * just assume all strings are 1 byte per character. This
463 * will produce some pretty odd looking output!
466 #define ASN1_STRFLGS_IGNORE_TYPE 0x20
468 /* If this is set we include the string type in the output */
469 #define ASN1_STRFLGS_SHOW_TYPE 0x40
471 /* This determines which strings to display and which to
472 * 'dump' (hex dump of content octets or DER encoding). We can
473 * only dump non character strings or everything. If we
474 * don't dump 'unknown' they are interpreted as character
475 * strings with 1 octet per character and are subject to
476 * the usual escaping options.
479 #define ASN1_STRFLGS_DUMP_ALL 0x80
480 #define ASN1_STRFLGS_DUMP_UNKNOWN 0x100
482 /* These determine what 'dumping' does, we can dump the
483 * content octets or the DER encoding: both use the
484 * RFC2253 #XXXXX notation.
487 #define ASN1_STRFLGS_DUMP_DER 0x200
489 /* All the string flags consistent with RFC2253,
490 * escaping control characters isn't essential in
491 * RFC2253 but it is advisable anyway.
494 #define ASN1_STRFLGS_RFC2253 (ASN1_STRFLGS_ESC_2253 | \
495 ASN1_STRFLGS_ESC_CTRL | \
496 ASN1_STRFLGS_ESC_MSB | \
497 ASN1_STRFLGS_UTF8_CONVERT | \
498 ASN1_STRFLGS_DUMP_UNKNOWN | \
499 ASN1_STRFLGS_DUMP_DER)
501 DECLARE_STACK_OF(ASN1_INTEGER)
502 DECLARE_ASN1_SET_OF(ASN1_INTEGER)
504 DECLARE_STACK_OF(ASN1_GENERALSTRING)
506 typedef struct asn1_type_st
511 ASN1_BOOLEAN boolean;
512 ASN1_STRING * asn1_string;
513 ASN1_OBJECT * object;
514 ASN1_INTEGER * integer;
515 ASN1_ENUMERATED * enumerated;
516 ASN1_BIT_STRING * bit_string;
517 ASN1_OCTET_STRING * octet_string;
518 ASN1_PRINTABLESTRING * printablestring;
519 ASN1_T61STRING * t61string;
520 ASN1_IA5STRING * ia5string;
521 ASN1_GENERALSTRING * generalstring;
522 ASN1_BMPSTRING * bmpstring;
523 ASN1_UNIVERSALSTRING * universalstring;
524 ASN1_UTCTIME * utctime;
525 ASN1_GENERALIZEDTIME * generalizedtime;
526 ASN1_VISIBLESTRING * visiblestring;
527 ASN1_UTF8STRING * utf8string;
528 /* set and sequence are left complete and still
529 * contain the set or sequence bytes */
531 ASN1_STRING * sequence;
532 ASN1_VALUE * asn1_value;
536 DECLARE_STACK_OF(ASN1_TYPE)
537 DECLARE_ASN1_SET_OF(ASN1_TYPE)
539 typedef STACK_OF(ASN1_TYPE) ASN1_SEQUENCE_ANY;
541 DECLARE_ASN1_ENCODE_FUNCTIONS_const(ASN1_SEQUENCE_ANY, ASN1_SEQUENCE_ANY)
542 DECLARE_ASN1_ENCODE_FUNCTIONS_const(ASN1_SEQUENCE_ANY, ASN1_SET_ANY)
544 typedef struct NETSCAPE_X509_st
546 ASN1_OCTET_STRING *header;
550 /* This is used to contain a list of bit names */
551 typedef struct BIT_STRING_BITNAME_st {
555 } BIT_STRING_BITNAME;
558 #define M_ASN1_STRING_length(x) ((x)->length)
559 #define M_ASN1_STRING_length_set(x, n) ((x)->length = (n))
560 #define M_ASN1_STRING_type(x) ((x)->type)
561 #define M_ASN1_STRING_data(x) ((x)->data)
563 /* Macros for string operations */
564 #define M_ASN1_BIT_STRING_new() (ASN1_BIT_STRING *)\
565 ASN1_STRING_type_new(V_ASN1_BIT_STRING)
566 #define M_ASN1_BIT_STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
567 #define M_ASN1_BIT_STRING_dup(a) (ASN1_BIT_STRING *)\
568 ASN1_STRING_dup((const ASN1_STRING *)a)
569 #define M_ASN1_BIT_STRING_cmp(a,b) ASN1_STRING_cmp(\
570 (const ASN1_STRING *)a,(const ASN1_STRING *)b)
571 #define M_ASN1_BIT_STRING_set(a,b,c) ASN1_STRING_set((ASN1_STRING *)a,b,c)
573 #define M_ASN1_INTEGER_new() (ASN1_INTEGER *)\
574 ASN1_STRING_type_new(V_ASN1_INTEGER)
575 #define M_ASN1_INTEGER_free(a) ASN1_STRING_free((ASN1_STRING *)a)
576 #define M_ASN1_INTEGER_dup(a) (ASN1_INTEGER *)\
577 ASN1_STRING_dup((const ASN1_STRING *)a)
578 #define M_ASN1_INTEGER_cmp(a,b) ASN1_STRING_cmp(\
579 (const ASN1_STRING *)a,(const ASN1_STRING *)b)
581 #define M_ASN1_ENUMERATED_new() (ASN1_ENUMERATED *)\
582 ASN1_STRING_type_new(V_ASN1_ENUMERATED)
583 #define M_ASN1_ENUMERATED_free(a) ASN1_STRING_free((ASN1_STRING *)a)
584 #define M_ASN1_ENUMERATED_dup(a) (ASN1_ENUMERATED *)\
585 ASN1_STRING_dup((const ASN1_STRING *)a)
586 #define M_ASN1_ENUMERATED_cmp(a,b) ASN1_STRING_cmp(\
587 (const ASN1_STRING *)a,(const ASN1_STRING *)b)
589 #define M_ASN1_OCTET_STRING_new() (ASN1_OCTET_STRING *)\
590 ASN1_STRING_type_new(V_ASN1_OCTET_STRING)
591 #define M_ASN1_OCTET_STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
592 #define M_ASN1_OCTET_STRING_dup(a) (ASN1_OCTET_STRING *)\
593 ASN1_STRING_dup((const ASN1_STRING *)a)
594 #define M_ASN1_OCTET_STRING_cmp(a,b) ASN1_STRING_cmp(\
595 (const ASN1_STRING *)a,(const ASN1_STRING *)b)
596 #define M_ASN1_OCTET_STRING_set(a,b,c) ASN1_STRING_set((ASN1_STRING *)a,b,c)
597 #define M_ASN1_OCTET_STRING_print(a,b) ASN1_STRING_print(a,(ASN1_STRING *)b)
598 #define M_i2d_ASN1_OCTET_STRING(a,pp) \
599 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_OCTET_STRING,\
602 #define B_ASN1_TIME \
604 B_ASN1_GENERALIZEDTIME
606 #define B_ASN1_PRINTABLE \
607 B_ASN1_PRINTABLESTRING| \
611 B_ASN1_UNIVERSALSTRING|\
617 #define B_ASN1_DIRECTORYSTRING \
618 B_ASN1_PRINTABLESTRING| \
619 B_ASN1_TELETEXSTRING|\
621 B_ASN1_UNIVERSALSTRING|\
624 #define B_ASN1_DISPLAYTEXT \
626 B_ASN1_VISIBLESTRING| \
630 #define M_ASN1_PRINTABLE_new() ASN1_STRING_type_new(V_ASN1_T61STRING)
631 #define M_ASN1_PRINTABLE_free(a) ASN1_STRING_free((ASN1_STRING *)a)
632 #define M_i2d_ASN1_PRINTABLE(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\
633 pp,a->type,V_ASN1_UNIVERSAL)
634 #define M_d2i_ASN1_PRINTABLE(a,pp,l) \
635 d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \
638 #define M_DIRECTORYSTRING_new() ASN1_STRING_type_new(V_ASN1_PRINTABLESTRING)
639 #define M_DIRECTORYSTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
640 #define M_i2d_DIRECTORYSTRING(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\
641 pp,a->type,V_ASN1_UNIVERSAL)
642 #define M_d2i_DIRECTORYSTRING(a,pp,l) \
643 d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \
644 B_ASN1_DIRECTORYSTRING)
646 #define M_DISPLAYTEXT_new() ASN1_STRING_type_new(V_ASN1_VISIBLESTRING)
647 #define M_DISPLAYTEXT_free(a) ASN1_STRING_free((ASN1_STRING *)a)
648 #define M_i2d_DISPLAYTEXT(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\
649 pp,a->type,V_ASN1_UNIVERSAL)
650 #define M_d2i_DISPLAYTEXT(a,pp,l) \
651 d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \
654 #define M_ASN1_PRINTABLESTRING_new() (ASN1_PRINTABLESTRING *)\
655 ASN1_STRING_type_new(V_ASN1_PRINTABLESTRING)
656 #define M_ASN1_PRINTABLESTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
657 #define M_i2d_ASN1_PRINTABLESTRING(a,pp) \
658 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_PRINTABLESTRING,\
660 #define M_d2i_ASN1_PRINTABLESTRING(a,pp,l) \
661 (ASN1_PRINTABLESTRING *)d2i_ASN1_type_bytes\
662 ((ASN1_STRING **)a,pp,l,B_ASN1_PRINTABLESTRING)
664 #define M_ASN1_T61STRING_new() (ASN1_T61STRING *)\
665 ASN1_STRING_type_new(V_ASN1_T61STRING)
666 #define M_ASN1_T61STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
667 #define M_i2d_ASN1_T61STRING(a,pp) \
668 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_T61STRING,\
670 #define M_d2i_ASN1_T61STRING(a,pp,l) \
671 (ASN1_T61STRING *)d2i_ASN1_type_bytes\
672 ((ASN1_STRING **)a,pp,l,B_ASN1_T61STRING)
674 #define M_ASN1_IA5STRING_new() (ASN1_IA5STRING *)\
675 ASN1_STRING_type_new(V_ASN1_IA5STRING)
676 #define M_ASN1_IA5STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
677 #define M_ASN1_IA5STRING_dup(a) \
678 (ASN1_IA5STRING *)ASN1_STRING_dup((const ASN1_STRING *)a)
679 #define M_i2d_ASN1_IA5STRING(a,pp) \
680 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_IA5STRING,\
682 #define M_d2i_ASN1_IA5STRING(a,pp,l) \
683 (ASN1_IA5STRING *)d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l,\
686 #define M_ASN1_UTCTIME_new() (ASN1_UTCTIME *)\
687 ASN1_STRING_type_new(V_ASN1_UTCTIME)
688 #define M_ASN1_UTCTIME_free(a) ASN1_STRING_free((ASN1_STRING *)a)
689 #define M_ASN1_UTCTIME_dup(a) (ASN1_UTCTIME *)\
690 ASN1_STRING_dup((const ASN1_STRING *)a)
692 #define M_ASN1_GENERALIZEDTIME_new() (ASN1_GENERALIZEDTIME *)\
693 ASN1_STRING_type_new(V_ASN1_GENERALIZEDTIME)
694 #define M_ASN1_GENERALIZEDTIME_free(a) ASN1_STRING_free((ASN1_STRING *)a)
695 #define M_ASN1_GENERALIZEDTIME_dup(a) (ASN1_GENERALIZEDTIME *)ASN1_STRING_dup(\
696 (const ASN1_STRING *)a)
698 #define M_ASN1_TIME_new() (ASN1_TIME *)\
699 ASN1_STRING_type_new(V_ASN1_UTCTIME)
700 #define M_ASN1_TIME_free(a) ASN1_STRING_free((ASN1_STRING *)a)
701 #define M_ASN1_TIME_dup(a) (ASN1_TIME *)\
702 ASN1_STRING_dup((const ASN1_STRING *)a)
704 #define M_ASN1_GENERALSTRING_new() (ASN1_GENERALSTRING *)\
705 ASN1_STRING_type_new(V_ASN1_GENERALSTRING)
706 #define M_ASN1_GENERALSTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
707 #define M_i2d_ASN1_GENERALSTRING(a,pp) \
708 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_GENERALSTRING,\
710 #define M_d2i_ASN1_GENERALSTRING(a,pp,l) \
711 (ASN1_GENERALSTRING *)d2i_ASN1_type_bytes\
712 ((ASN1_STRING **)a,pp,l,B_ASN1_GENERALSTRING)
714 #define M_ASN1_UNIVERSALSTRING_new() (ASN1_UNIVERSALSTRING *)\
715 ASN1_STRING_type_new(V_ASN1_UNIVERSALSTRING)
716 #define M_ASN1_UNIVERSALSTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
717 #define M_i2d_ASN1_UNIVERSALSTRING(a,pp) \
718 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_UNIVERSALSTRING,\
720 #define M_d2i_ASN1_UNIVERSALSTRING(a,pp,l) \
721 (ASN1_UNIVERSALSTRING *)d2i_ASN1_type_bytes\
722 ((ASN1_STRING **)a,pp,l,B_ASN1_UNIVERSALSTRING)
724 #define M_ASN1_BMPSTRING_new() (ASN1_BMPSTRING *)\
725 ASN1_STRING_type_new(V_ASN1_BMPSTRING)
726 #define M_ASN1_BMPSTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
727 #define M_i2d_ASN1_BMPSTRING(a,pp) \
728 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_BMPSTRING,\
730 #define M_d2i_ASN1_BMPSTRING(a,pp,l) \
731 (ASN1_BMPSTRING *)d2i_ASN1_type_bytes\
732 ((ASN1_STRING **)a,pp,l,B_ASN1_BMPSTRING)
734 #define M_ASN1_VISIBLESTRING_new() (ASN1_VISIBLESTRING *)\
735 ASN1_STRING_type_new(V_ASN1_VISIBLESTRING)
736 #define M_ASN1_VISIBLESTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
737 #define M_i2d_ASN1_VISIBLESTRING(a,pp) \
738 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_VISIBLESTRING,\
740 #define M_d2i_ASN1_VISIBLESTRING(a,pp,l) \
741 (ASN1_VISIBLESTRING *)d2i_ASN1_type_bytes\
742 ((ASN1_STRING **)a,pp,l,B_ASN1_VISIBLESTRING)
744 #define M_ASN1_UTF8STRING_new() (ASN1_UTF8STRING *)\
745 ASN1_STRING_type_new(V_ASN1_UTF8STRING)
746 #define M_ASN1_UTF8STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
747 #define M_i2d_ASN1_UTF8STRING(a,pp) \
748 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_UTF8STRING,\
750 #define M_d2i_ASN1_UTF8STRING(a,pp,l) \
751 (ASN1_UTF8STRING *)d2i_ASN1_type_bytes\
752 ((ASN1_STRING **)a,pp,l,B_ASN1_UTF8STRING)
754 /* for the is_set parameter to i2d_ASN1_SET */
755 #define IS_SEQUENCE 0
758 DECLARE_ASN1_FUNCTIONS_fname(ASN1_TYPE, ASN1_ANY, ASN1_TYPE)
760 int ASN1_TYPE_get(ASN1_TYPE *a);
761 void ASN1_TYPE_set(ASN1_TYPE *a, int type, void *value);
762 int ASN1_TYPE_cmp(ASN1_TYPE *a, ASN1_TYPE *b);
764 ASN1_OBJECT * ASN1_OBJECT_new(void );
765 void ASN1_OBJECT_free(ASN1_OBJECT *a);
766 int i2d_ASN1_OBJECT(ASN1_OBJECT *a,unsigned char **pp);
767 ASN1_OBJECT * c2i_ASN1_OBJECT(ASN1_OBJECT **a,const unsigned char **pp,
769 ASN1_OBJECT * d2i_ASN1_OBJECT(ASN1_OBJECT **a,const unsigned char **pp,
772 DECLARE_ASN1_ITEM(ASN1_OBJECT)
774 DECLARE_STACK_OF(ASN1_OBJECT)
775 DECLARE_ASN1_SET_OF(ASN1_OBJECT)
777 ASN1_STRING * ASN1_STRING_new(void);
778 void ASN1_STRING_free(ASN1_STRING *a);
779 int ASN1_STRING_copy(ASN1_STRING *dst, const ASN1_STRING *str);
780 ASN1_STRING * ASN1_STRING_dup(const ASN1_STRING *a);
781 ASN1_STRING * ASN1_STRING_type_new(int type );
782 int ASN1_STRING_cmp(const ASN1_STRING *a, const ASN1_STRING *b);
783 /* Since this is used to store all sorts of things, via macros, for now, make
785 int ASN1_STRING_set(ASN1_STRING *str, const void *data, int len);
786 void ASN1_STRING_set0(ASN1_STRING *str, void *data, int len);
787 int ASN1_STRING_length(const ASN1_STRING *x);
788 void ASN1_STRING_length_set(ASN1_STRING *x, int n);
789 int ASN1_STRING_type(ASN1_STRING *x);
790 unsigned char * ASN1_STRING_data(ASN1_STRING *x);
792 DECLARE_ASN1_FUNCTIONS(ASN1_BIT_STRING)
793 int i2c_ASN1_BIT_STRING(ASN1_BIT_STRING *a,unsigned char **pp);
794 ASN1_BIT_STRING *c2i_ASN1_BIT_STRING(ASN1_BIT_STRING **a,const unsigned char **pp,
796 int ASN1_BIT_STRING_set(ASN1_BIT_STRING *a, unsigned char *d,
798 int ASN1_BIT_STRING_set_bit(ASN1_BIT_STRING *a, int n, int value);
799 int ASN1_BIT_STRING_get_bit(ASN1_BIT_STRING *a, int n);
800 int ASN1_BIT_STRING_check(ASN1_BIT_STRING *a,
801 unsigned char *flags, int flags_len);
803 #ifndef OPENSSL_NO_BIO
804 int ASN1_BIT_STRING_name_print(BIO *out, ASN1_BIT_STRING *bs,
805 BIT_STRING_BITNAME *tbl, int indent);
807 int ASN1_BIT_STRING_num_asc(char *name, BIT_STRING_BITNAME *tbl);
808 int ASN1_BIT_STRING_set_asc(ASN1_BIT_STRING *bs, char *name, int value,
809 BIT_STRING_BITNAME *tbl);
811 int i2d_ASN1_BOOLEAN(int a,unsigned char **pp);
812 int d2i_ASN1_BOOLEAN(int *a,const unsigned char **pp,long length);
814 DECLARE_ASN1_FUNCTIONS(ASN1_INTEGER)
815 int i2c_ASN1_INTEGER(ASN1_INTEGER *a,unsigned char **pp);
816 ASN1_INTEGER *c2i_ASN1_INTEGER(ASN1_INTEGER **a,const unsigned char **pp,
818 ASN1_INTEGER *d2i_ASN1_UINTEGER(ASN1_INTEGER **a,const unsigned char **pp,
820 ASN1_INTEGER * ASN1_INTEGER_dup(const ASN1_INTEGER *x);
821 int ASN1_INTEGER_cmp(const ASN1_INTEGER *x, const ASN1_INTEGER *y);
823 DECLARE_ASN1_FUNCTIONS(ASN1_ENUMERATED)
825 int ASN1_UTCTIME_check(ASN1_UTCTIME *a);
826 ASN1_UTCTIME *ASN1_UTCTIME_set(ASN1_UTCTIME *s,time_t t);
827 int ASN1_UTCTIME_set_string(ASN1_UTCTIME *s, const char *str);
828 int ASN1_UTCTIME_cmp_time_t(const ASN1_UTCTIME *s, time_t t);
830 time_t ASN1_UTCTIME_get(const ASN1_UTCTIME *s);
833 int ASN1_GENERALIZEDTIME_check(ASN1_GENERALIZEDTIME *a);
834 ASN1_GENERALIZEDTIME *ASN1_GENERALIZEDTIME_set(ASN1_GENERALIZEDTIME *s,time_t t);
835 int ASN1_GENERALIZEDTIME_set_string(ASN1_GENERALIZEDTIME *s, const char *str);
837 DECLARE_ASN1_FUNCTIONS(ASN1_OCTET_STRING)
838 ASN1_OCTET_STRING * ASN1_OCTET_STRING_dup(const ASN1_OCTET_STRING *a);
839 int ASN1_OCTET_STRING_cmp(const ASN1_OCTET_STRING *a, const ASN1_OCTET_STRING *b);
840 int ASN1_OCTET_STRING_set(ASN1_OCTET_STRING *str, const unsigned char *data, int len);
842 DECLARE_ASN1_FUNCTIONS(ASN1_VISIBLESTRING)
843 DECLARE_ASN1_FUNCTIONS(ASN1_UNIVERSALSTRING)
844 DECLARE_ASN1_FUNCTIONS(ASN1_UTF8STRING)
845 DECLARE_ASN1_FUNCTIONS(ASN1_NULL)
846 DECLARE_ASN1_FUNCTIONS(ASN1_BMPSTRING)
848 int UTF8_getc(const unsigned char *str, int len, unsigned long *val);
849 int UTF8_putc(unsigned char *str, int len, unsigned long value);
851 DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, ASN1_PRINTABLE)
853 DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, DIRECTORYSTRING)
854 DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, DISPLAYTEXT)
855 DECLARE_ASN1_FUNCTIONS(ASN1_PRINTABLESTRING)
856 DECLARE_ASN1_FUNCTIONS(ASN1_T61STRING)
857 DECLARE_ASN1_FUNCTIONS(ASN1_IA5STRING)
858 DECLARE_ASN1_FUNCTIONS(ASN1_GENERALSTRING)
859 DECLARE_ASN1_FUNCTIONS(ASN1_UTCTIME)
860 DECLARE_ASN1_FUNCTIONS(ASN1_GENERALIZEDTIME)
861 DECLARE_ASN1_FUNCTIONS(ASN1_TIME)
863 DECLARE_ASN1_ITEM(ASN1_OCTET_STRING_NDEF)
865 ASN1_TIME *ASN1_TIME_set(ASN1_TIME *s,time_t t);
866 int ASN1_TIME_check(ASN1_TIME *t);
867 ASN1_GENERALIZEDTIME *ASN1_TIME_to_generalizedtime(ASN1_TIME *t, ASN1_GENERALIZEDTIME **out);
869 int i2d_ASN1_SET(STACK *a, unsigned char **pp,
870 i2d_of_void *i2d, int ex_tag, int ex_class, int is_set);
871 STACK * d2i_ASN1_SET(STACK **a, const unsigned char **pp, long length,
872 d2i_of_void *d2i, void (*free_func)(void *),
873 int ex_tag, int ex_class);
875 #ifndef OPENSSL_NO_BIO
876 int i2a_ASN1_INTEGER(BIO *bp, ASN1_INTEGER *a);
877 int a2i_ASN1_INTEGER(BIO *bp,ASN1_INTEGER *bs,char *buf,int size);
878 int i2a_ASN1_ENUMERATED(BIO *bp, ASN1_ENUMERATED *a);
879 int a2i_ASN1_ENUMERATED(BIO *bp,ASN1_ENUMERATED *bs,char *buf,int size);
880 int i2a_ASN1_OBJECT(BIO *bp,ASN1_OBJECT *a);
881 int a2i_ASN1_STRING(BIO *bp,ASN1_STRING *bs,char *buf,int size);
882 int i2a_ASN1_STRING(BIO *bp, ASN1_STRING *a, int type);
884 int i2t_ASN1_OBJECT(char *buf,int buf_len,ASN1_OBJECT *a);
886 int a2d_ASN1_OBJECT(unsigned char *out,int olen, const char *buf, int num);
887 ASN1_OBJECT *ASN1_OBJECT_create(int nid, unsigned char *data,int len,
888 const char *sn, const char *ln);
890 int ASN1_INTEGER_set(ASN1_INTEGER *a, long v);
891 long ASN1_INTEGER_get(const ASN1_INTEGER *a);
892 ASN1_INTEGER *BN_to_ASN1_INTEGER(const BIGNUM *bn, ASN1_INTEGER *ai);
893 BIGNUM *ASN1_INTEGER_to_BN(const ASN1_INTEGER *ai,BIGNUM *bn);
895 int ASN1_ENUMERATED_set(ASN1_ENUMERATED *a, long v);
896 long ASN1_ENUMERATED_get(ASN1_ENUMERATED *a);
897 ASN1_ENUMERATED *BN_to_ASN1_ENUMERATED(BIGNUM *bn, ASN1_ENUMERATED *ai);
898 BIGNUM *ASN1_ENUMERATED_to_BN(ASN1_ENUMERATED *ai,BIGNUM *bn);
901 /* given a string, return the correct type, max is the maximum length */
902 int ASN1_PRINTABLE_type(const unsigned char *s, int max);
904 int i2d_ASN1_bytes(ASN1_STRING *a, unsigned char **pp, int tag, int xclass);
905 ASN1_STRING *d2i_ASN1_bytes(ASN1_STRING **a, const unsigned char **pp,
906 long length, int Ptag, int Pclass);
907 unsigned long ASN1_tag2bit(int tag);
908 /* type is one or more of the B_ASN1_ values. */
909 ASN1_STRING *d2i_ASN1_type_bytes(ASN1_STRING **a,const unsigned char **pp,
910 long length,int type);
913 int asn1_Finish(ASN1_CTX *c);
914 int asn1_const_Finish(ASN1_const_CTX *c);
917 int ASN1_get_object(const unsigned char **pp, long *plength, int *ptag,
918 int *pclass, long omax);
919 int ASN1_check_infinite_end(unsigned char **p,long len);
920 int ASN1_const_check_infinite_end(const unsigned char **p,long len);
921 void ASN1_put_object(unsigned char **pp, int constructed, int length,
922 int tag, int xclass);
923 int ASN1_put_eoc(unsigned char **pp);
924 int ASN1_object_size(int constructed, int length, int tag);
926 /* Used to implement other functions */
927 void *ASN1_dup(i2d_of_void *i2d, d2i_of_void *d2i, char *x);
929 #define ASN1_dup_of(type,i2d,d2i,x) \
930 ((type*)ASN1_dup(CHECKED_I2D_OF(type, i2d), \
931 CHECKED_D2I_OF(type, d2i), \
932 CHECKED_PTR_OF(type, x)))
934 #define ASN1_dup_of_const(type,i2d,d2i,x) \
935 ((type*)ASN1_dup(CHECKED_I2D_OF(const type, i2d), \
936 CHECKED_D2I_OF(type, d2i), \
937 CHECKED_PTR_OF(const type, x)))
939 void *ASN1_item_dup(const ASN1_ITEM *it, void *x);
941 #ifndef OPENSSL_NO_FP_API
942 void *ASN1_d2i_fp(void *(*xnew)(void), d2i_of_void *d2i, FILE *in, void **x);
944 #define ASN1_d2i_fp_of(type,xnew,d2i,in,x) \
945 ((type*)ASN1_d2i_fp(CHECKED_NEW_OF(type, xnew), \
946 CHECKED_D2I_OF(type, d2i), \
948 CHECKED_PPTR_OF(type, x)))
950 void *ASN1_item_d2i_fp(const ASN1_ITEM *it, FILE *in, void *x);
951 int ASN1_i2d_fp(i2d_of_void *i2d,FILE *out,void *x);
953 #define ASN1_i2d_fp_of(type,i2d,out,x) \
954 (ASN1_i2d_fp(CHECKED_I2D_OF(type, i2d), \
956 CHECKED_PTR_OF(type, x)))
958 #define ASN1_i2d_fp_of_const(type,i2d,out,x) \
959 (ASN1_i2d_fp(CHECKED_I2D_OF(const type, i2d), \
961 CHECKED_PTR_OF(const type, x)))
963 int ASN1_item_i2d_fp(const ASN1_ITEM *it, FILE *out, void *x);
964 int ASN1_STRING_print_ex_fp(FILE *fp, ASN1_STRING *str, unsigned long flags);
967 int ASN1_STRING_to_UTF8(unsigned char **out, ASN1_STRING *in);
969 #ifndef OPENSSL_NO_BIO
970 void *ASN1_d2i_bio(void *(*xnew)(void), d2i_of_void *d2i, BIO *in, void **x);
972 #define ASN1_d2i_bio_of(type,xnew,d2i,in,x) \
973 ((type*)ASN1_d2i_bio( CHECKED_NEW_OF(type, xnew), \
974 CHECKED_D2I_OF(type, d2i), \
976 CHECKED_PPTR_OF(type, x)))
978 void *ASN1_item_d2i_bio(const ASN1_ITEM *it, BIO *in, void *x);
979 int ASN1_i2d_bio(i2d_of_void *i2d,BIO *out, unsigned char *x);
981 #define ASN1_i2d_bio_of(type,i2d,out,x) \
982 (ASN1_i2d_bio(CHECKED_I2D_OF(type, i2d), \
984 CHECKED_PTR_OF(type, x)))
986 #define ASN1_i2d_bio_of_const(type,i2d,out,x) \
987 (ASN1_i2d_bio(CHECKED_I2D_OF(const type, i2d), \
989 CHECKED_PTR_OF(const type, x)))
991 int ASN1_item_i2d_bio(const ASN1_ITEM *it, BIO *out, void *x);
992 int ASN1_UTCTIME_print(BIO *fp, const ASN1_UTCTIME *a);
993 int ASN1_GENERALIZEDTIME_print(BIO *fp, const ASN1_GENERALIZEDTIME *a);
994 int ASN1_TIME_print(BIO *fp, const ASN1_TIME *a);
995 int ASN1_STRING_print(BIO *bp, const ASN1_STRING *v);
996 int ASN1_STRING_print_ex(BIO *out, ASN1_STRING *str, unsigned long flags);
997 int ASN1_bn_print(BIO *bp, const char *number, const BIGNUM *num,
998 unsigned char *buf, int off);
999 int ASN1_parse(BIO *bp,const unsigned char *pp,long len,int indent);
1000 int ASN1_parse_dump(BIO *bp,const unsigned char *pp,long len,int indent,int dump);
1002 const char *ASN1_tag2str(int tag);
1004 /* Used to load and write netscape format cert */
1006 DECLARE_ASN1_FUNCTIONS(NETSCAPE_X509)
1008 int ASN1_UNIVERSALSTRING_to_string(ASN1_UNIVERSALSTRING *s);
1010 int ASN1_TYPE_set_octetstring(ASN1_TYPE *a,
1011 unsigned char *data, int len);
1012 int ASN1_TYPE_get_octetstring(ASN1_TYPE *a,
1013 unsigned char *data, int max_len);
1014 int ASN1_TYPE_set_int_octetstring(ASN1_TYPE *a, long num,
1015 unsigned char *data, int len);
1016 int ASN1_TYPE_get_int_octetstring(ASN1_TYPE *a,long *num,
1017 unsigned char *data, int max_len);
1019 STACK *ASN1_seq_unpack(const unsigned char *buf, int len,
1020 d2i_of_void *d2i, void (*free_func)(void *));
1021 unsigned char *ASN1_seq_pack(STACK *safes, i2d_of_void *i2d,
1022 unsigned char **buf, int *len );
1023 void *ASN1_unpack_string(ASN1_STRING *oct, d2i_of_void *d2i);
1024 void *ASN1_item_unpack(ASN1_STRING *oct, const ASN1_ITEM *it);
1025 ASN1_STRING *ASN1_pack_string(void *obj, i2d_of_void *i2d,
1026 ASN1_OCTET_STRING **oct);
1028 #define ASN1_pack_string_of(type,obj,i2d,oct) \
1029 (ASN1_pack_string(CHECKED_PTR_OF(type, obj), \
1030 CHECKED_I2D_OF(type, i2d), \
1033 ASN1_STRING *ASN1_item_pack(void *obj, const ASN1_ITEM *it, ASN1_OCTET_STRING **oct);
1035 void ASN1_STRING_set_default_mask(unsigned long mask);
1036 int ASN1_STRING_set_default_mask_asc(char *p);
1037 unsigned long ASN1_STRING_get_default_mask(void);
1038 int ASN1_mbstring_copy(ASN1_STRING **out, const unsigned char *in, int len,
1039 int inform, unsigned long mask);
1040 int ASN1_mbstring_ncopy(ASN1_STRING **out, const unsigned char *in, int len,
1041 int inform, unsigned long mask,
1042 long minsize, long maxsize);
1044 ASN1_STRING *ASN1_STRING_set_by_NID(ASN1_STRING **out,
1045 const unsigned char *in, int inlen, int inform, int nid);
1046 ASN1_STRING_TABLE *ASN1_STRING_TABLE_get(int nid);
1047 int ASN1_STRING_TABLE_add(int, long, long, unsigned long, unsigned long);
1048 void ASN1_STRING_TABLE_cleanup(void);
1050 /* ASN1 template functions */
1052 /* Old API compatible functions */
1053 ASN1_VALUE *ASN1_item_new(const ASN1_ITEM *it);
1054 void ASN1_item_free(ASN1_VALUE *val, const ASN1_ITEM *it);
1055 ASN1_VALUE * ASN1_item_d2i(ASN1_VALUE **val, const unsigned char **in, long len, const ASN1_ITEM *it);
1056 int ASN1_item_i2d(ASN1_VALUE *val, unsigned char **out, const ASN1_ITEM *it);
1057 int ASN1_item_ndef_i2d(ASN1_VALUE *val, unsigned char **out, const ASN1_ITEM *it);
1059 void ASN1_add_oid_module(void);
1061 ASN1_TYPE *ASN1_generate_nconf(char *str, CONF *nconf);
1062 ASN1_TYPE *ASN1_generate_v3(char *str, X509V3_CTX *cnf);
1064 /* ASN1 Print flags */
1066 /* Indicate missing OPTIONAL fields */
1067 #define ASN1_PCTX_FLAGS_SHOW_ABSENT 0x001
1068 /* Mark start and end of SEQUENCE */
1069 #define ASN1_PCTX_FLAGS_SHOW_SEQUENCE 0x002
1070 /* Mark start and end of SEQUENCE/SET OF */
1071 #define ASN1_PCTX_FLAGS_SHOW_SSOF 0x004
1072 /* Show the ASN1 type of primitives */
1073 #define ASN1_PCTX_FLAGS_SHOW_TYPE 0x008
1074 /* Don't show ASN1 type of ANY */
1075 #define ASN1_PCTX_FLAGS_NO_ANY_TYPE 0x010
1076 /* Don't show ASN1 type of MSTRINGs */
1077 #define ASN1_PCTX_FLAGS_NO_MSTRING_TYPE 0x020
1078 /* Don't show field names in SEQUENCE */
1079 #define ASN1_PCTX_FLAGS_NO_FIELD_NAME 0x040
1080 /* Show structure names of each SEQUENCE field */
1081 #define ASN1_PCTX_FLAGS_SHOW_FIELD_STRUCT_NAME 0x080
1082 /* Don't show structure name even at top level */
1083 #define ASN1_PCTX_FLAGS_NO_STRUCT_NAME 0x100
1085 int ASN1_item_print(BIO *out, ASN1_VALUE *ifld, int indent,
1086 const ASN1_ITEM *it, const ASN1_PCTX *pctx);
1087 ASN1_PCTX *ASN1_PCTX_new(void);
1088 void ASN1_PCTX_free(ASN1_PCTX *p);
1089 unsigned long ASN1_PCTX_get_flags(ASN1_PCTX *p);
1090 void ASN1_PCTX_set_flags(ASN1_PCTX *p, unsigned long flags);
1091 unsigned long ASN1_PCTX_get_nm_flags(ASN1_PCTX *p);
1092 void ASN1_PCTX_set_nm_flags(ASN1_PCTX *p, unsigned long flags);
1093 unsigned long ASN1_PCTX_get_cert_flags(ASN1_PCTX *p);
1094 void ASN1_PCTX_set_cert_flags(ASN1_PCTX *p, unsigned long flags);
1095 unsigned long ASN1_PCTX_get_oid_flags(ASN1_PCTX *p);
1096 void ASN1_PCTX_set_oid_flags(ASN1_PCTX *p, unsigned long flags);
1097 unsigned long ASN1_PCTX_get_str_flags(ASN1_PCTX *p);
1098 void ASN1_PCTX_set_str_flags(ASN1_PCTX *p, unsigned long flags);
1100 BIO_METHOD *BIO_f_asn1(void);
1102 /* BEGIN ERROR CODES */
1103 /* The following lines are auto generated by the script mkerr.pl. Any changes
1104 * made after this point may be overwritten when the script is next run.
1106 void ERR_load_ASN1_strings(void);
1108 /* Error codes for the ASN1 functions. */
1110 /* Function codes. */
1111 #define ASN1_F_A2D_ASN1_OBJECT 100
1112 #define ASN1_F_A2I_ASN1_ENUMERATED 101
1113 #define ASN1_F_A2I_ASN1_INTEGER 102
1114 #define ASN1_F_A2I_ASN1_STRING 103
1115 #define ASN1_F_APPEND_EXP 176
1116 #define ASN1_F_ASN1_BIT_STRING_SET_BIT 183
1117 #define ASN1_F_ASN1_CB 177
1118 #define ASN1_F_ASN1_CHECK_TLEN 104
1119 #define ASN1_F_ASN1_COLLATE_PRIMITIVE 105
1120 #define ASN1_F_ASN1_COLLECT 106
1121 #define ASN1_F_ASN1_D2I_EX_PRIMITIVE 108
1122 #define ASN1_F_ASN1_D2I_FP 109
1123 #define ASN1_F_ASN1_D2I_READ_BIO 107
1124 #define ASN1_F_ASN1_DIGEST 184
1125 #define ASN1_F_ASN1_DO_ADB 110
1126 #define ASN1_F_ASN1_DUP 111
1127 #define ASN1_F_ASN1_ENUMERATED_SET 112
1128 #define ASN1_F_ASN1_ENUMERATED_TO_BN 113
1129 #define ASN1_F_ASN1_EX_C2I 204
1130 #define ASN1_F_ASN1_FIND_END 190
1131 #define ASN1_F_ASN1_GENERALIZEDTIME_SET 185
1132 #define ASN1_F_ASN1_GENERATE_V3 178
1133 #define ASN1_F_ASN1_GET_OBJECT 114
1134 #define ASN1_F_ASN1_HEADER_NEW 115
1135 #define ASN1_F_ASN1_I2D_BIO 116
1136 #define ASN1_F_ASN1_I2D_FP 117
1137 #define ASN1_F_ASN1_INTEGER_SET 118
1138 #define ASN1_F_ASN1_INTEGER_TO_BN 119
1139 #define ASN1_F_ASN1_ITEM_D2I_FP 206
1140 #define ASN1_F_ASN1_ITEM_DUP 191
1141 #define ASN1_F_ASN1_ITEM_EX_COMBINE_NEW 121
1142 #define ASN1_F_ASN1_ITEM_EX_D2I 120
1143 #define ASN1_F_ASN1_ITEM_I2D_BIO 192
1144 #define ASN1_F_ASN1_ITEM_I2D_FP 193
1145 #define ASN1_F_ASN1_ITEM_PACK 198
1146 #define ASN1_F_ASN1_ITEM_SIGN 195
1147 #define ASN1_F_ASN1_ITEM_UNPACK 199
1148 #define ASN1_F_ASN1_ITEM_VERIFY 197
1149 #define ASN1_F_ASN1_MBSTRING_NCOPY 122
1150 #define ASN1_F_ASN1_OBJECT_NEW 123
1151 #define ASN1_F_ASN1_PACK_STRING 124
1152 #define ASN1_F_ASN1_PCTX_NEW 205
1153 #define ASN1_F_ASN1_PKCS5_PBE_SET 125
1154 #define ASN1_F_ASN1_SEQ_PACK 126
1155 #define ASN1_F_ASN1_SEQ_UNPACK 127
1156 #define ASN1_F_ASN1_SIGN 128
1157 #define ASN1_F_ASN1_STR2TYPE 179
1158 #define ASN1_F_ASN1_STRING_SET 186
1159 #define ASN1_F_ASN1_STRING_TABLE_ADD 129
1160 #define ASN1_F_ASN1_STRING_TYPE_NEW 130
1161 #define ASN1_F_ASN1_TEMPLATE_EX_D2I 132
1162 #define ASN1_F_ASN1_TEMPLATE_NEW 133
1163 #define ASN1_F_ASN1_TEMPLATE_NOEXP_D2I 131
1164 #define ASN1_F_ASN1_TIME_SET 175
1165 #define ASN1_F_ASN1_TYPE_GET_INT_OCTETSTRING 134
1166 #define ASN1_F_ASN1_TYPE_GET_OCTETSTRING 135
1167 #define ASN1_F_ASN1_UNPACK_STRING 136
1168 #define ASN1_F_ASN1_UTCTIME_SET 187
1169 #define ASN1_F_ASN1_VERIFY 137
1170 #define ASN1_F_BITSTR_CB 180
1171 #define ASN1_F_BN_TO_ASN1_ENUMERATED 138
1172 #define ASN1_F_BN_TO_ASN1_INTEGER 139
1173 #define ASN1_F_C2I_ASN1_BIT_STRING 189
1174 #define ASN1_F_C2I_ASN1_INTEGER 194
1175 #define ASN1_F_C2I_ASN1_OBJECT 196
1176 #define ASN1_F_COLLECT_DATA 140
1177 #define ASN1_F_D2I_ASN1_BIT_STRING 141
1178 #define ASN1_F_D2I_ASN1_BOOLEAN 142
1179 #define ASN1_F_D2I_ASN1_BYTES 143
1180 #define ASN1_F_D2I_ASN1_GENERALIZEDTIME 144
1181 #define ASN1_F_D2I_ASN1_HEADER 145
1182 #define ASN1_F_D2I_ASN1_INTEGER 146
1183 #define ASN1_F_D2I_ASN1_OBJECT 147
1184 #define ASN1_F_D2I_ASN1_SET 148
1185 #define ASN1_F_D2I_ASN1_TYPE_BYTES 149
1186 #define ASN1_F_D2I_ASN1_UINTEGER 150
1187 #define ASN1_F_D2I_ASN1_UTCTIME 151
1188 #define ASN1_F_D2I_NETSCAPE_RSA 152
1189 #define ASN1_F_D2I_NETSCAPE_RSA_2 153
1190 #define ASN1_F_D2I_PRIVATEKEY 154
1191 #define ASN1_F_D2I_PUBLICKEY 155
1192 #define ASN1_F_D2I_RSA_NET 200
1193 #define ASN1_F_D2I_RSA_NET_2 201
1194 #define ASN1_F_D2I_X509 156
1195 #define ASN1_F_D2I_X509_CINF 157
1196 #define ASN1_F_D2I_X509_PKEY 159
1197 #define ASN1_F_I2D_ASN1_SET 188
1198 #define ASN1_F_I2D_ASN1_TIME 160
1199 #define ASN1_F_I2D_DSA_PUBKEY 161
1200 #define ASN1_F_I2D_EC_PUBKEY 181
1201 #define ASN1_F_I2D_PRIVATEKEY 163
1202 #define ASN1_F_I2D_PUBLICKEY 164
1203 #define ASN1_F_I2D_RSA_NET 162
1204 #define ASN1_F_I2D_RSA_PUBKEY 165
1205 #define ASN1_F_LONG_C2I 166
1206 #define ASN1_F_OID_MODULE_INIT 174
1207 #define ASN1_F_PARSE_TAGGING 182
1208 #define ASN1_F_PKCS5_PBE2_SET_IV 167
1209 #define ASN1_F_PKCS5_PBE_SET 202
1210 #define ASN1_F_X509_CINF_NEW 168
1211 #define ASN1_F_X509_CRL_ADD0_REVOKED 169
1212 #define ASN1_F_X509_INFO_NEW 170
1213 #define ASN1_F_X509_NAME_ENCODE 203
1214 #define ASN1_F_X509_NAME_EX_D2I 158
1215 #define ASN1_F_X509_NAME_EX_NEW 171
1216 #define ASN1_F_X509_NEW 172
1217 #define ASN1_F_X509_PKEY_NEW 173
1220 #define ASN1_R_ADDING_OBJECT 171
1221 #define ASN1_R_AUX_ERROR 100
1222 #define ASN1_R_BAD_CLASS 101
1223 #define ASN1_R_BAD_OBJECT_HEADER 102
1224 #define ASN1_R_BAD_PASSWORD_READ 103
1225 #define ASN1_R_BAD_TAG 104
1226 #define ASN1_R_BN_LIB 105
1227 #define ASN1_R_BOOLEAN_IS_WRONG_LENGTH 106
1228 #define ASN1_R_BUFFER_TOO_SMALL 107
1229 #define ASN1_R_CIPHER_HAS_NO_OBJECT_IDENTIFIER 108
1230 #define ASN1_R_DATA_IS_WRONG 109
1231 #define ASN1_R_DECODE_ERROR 110
1232 #define ASN1_R_DECODING_ERROR 111
1233 #define ASN1_R_DEPTH_EXCEEDED 174
1234 #define ASN1_R_DIGEST_AND_KEY_TYPE_NOT_SUPPORTED 198
1235 #define ASN1_R_ENCODE_ERROR 112
1236 #define ASN1_R_ERROR_GETTING_TIME 173
1237 #define ASN1_R_ERROR_LOADING_SECTION 172
1238 #define ASN1_R_ERROR_PARSING_SET_ELEMENT 113
1239 #define ASN1_R_ERROR_SETTING_CIPHER_PARAMS 114
1240 #define ASN1_R_EXPECTING_AN_INTEGER 115
1241 #define ASN1_R_EXPECTING_AN_OBJECT 116
1242 #define ASN1_R_EXPECTING_A_BOOLEAN 117
1243 #define ASN1_R_EXPECTING_A_TIME 118
1244 #define ASN1_R_EXPLICIT_LENGTH_MISMATCH 119
1245 #define ASN1_R_EXPLICIT_TAG_NOT_CONSTRUCTED 120
1246 #define ASN1_R_FIELD_MISSING 121
1247 #define ASN1_R_FIRST_NUM_TOO_LARGE 122
1248 #define ASN1_R_HEADER_TOO_LONG 123
1249 #define ASN1_R_ILLEGAL_BITSTRING_FORMAT 175
1250 #define ASN1_R_ILLEGAL_BOOLEAN 176
1251 #define ASN1_R_ILLEGAL_CHARACTERS 124
1252 #define ASN1_R_ILLEGAL_FORMAT 177
1253 #define ASN1_R_ILLEGAL_HEX 178
1254 #define ASN1_R_ILLEGAL_IMPLICIT_TAG 179
1255 #define ASN1_R_ILLEGAL_INTEGER 180
1256 #define ASN1_R_ILLEGAL_NESTED_TAGGING 181
1257 #define ASN1_R_ILLEGAL_NULL 125
1258 #define ASN1_R_ILLEGAL_NULL_VALUE 182
1259 #define ASN1_R_ILLEGAL_OBJECT 183
1260 #define ASN1_R_ILLEGAL_OPTIONAL_ANY 126
1261 #define ASN1_R_ILLEGAL_OPTIONS_ON_ITEM_TEMPLATE 170
1262 #define ASN1_R_ILLEGAL_TAGGED_ANY 127
1263 #define ASN1_R_ILLEGAL_TIME_VALUE 184
1264 #define ASN1_R_INTEGER_NOT_ASCII_FORMAT 185
1265 #define ASN1_R_INTEGER_TOO_LARGE_FOR_LONG 128
1266 #define ASN1_R_INVALID_BMPSTRING_LENGTH 129
1267 #define ASN1_R_INVALID_DIGIT 130
1268 #define ASN1_R_INVALID_MODIFIER 186
1269 #define ASN1_R_INVALID_NUMBER 187
1270 #define ASN1_R_INVALID_SEPARATOR 131
1271 #define ASN1_R_INVALID_TIME_FORMAT 132
1272 #define ASN1_R_INVALID_UNIVERSALSTRING_LENGTH 133
1273 #define ASN1_R_INVALID_UTF8STRING 134
1274 #define ASN1_R_IV_TOO_LARGE 135
1275 #define ASN1_R_LENGTH_ERROR 136
1276 #define ASN1_R_LIST_ERROR 188
1277 #define ASN1_R_MISSING_EOC 137
1278 #define ASN1_R_MISSING_SECOND_NUMBER 138
1279 #define ASN1_R_MISSING_VALUE 189
1280 #define ASN1_R_MSTRING_NOT_UNIVERSAL 139
1281 #define ASN1_R_MSTRING_WRONG_TAG 140
1282 #define ASN1_R_NESTED_ASN1_STRING 197
1283 #define ASN1_R_NON_HEX_CHARACTERS 141
1284 #define ASN1_R_NOT_ASCII_FORMAT 190
1285 #define ASN1_R_NOT_ENOUGH_DATA 142
1286 #define ASN1_R_NO_DEFAULT_DIGEST 201
1287 #define ASN1_R_NO_MATCHING_CHOICE_TYPE 143
1288 #define ASN1_R_NULL_IS_WRONG_LENGTH 144
1289 #define ASN1_R_OBJECT_NOT_ASCII_FORMAT 191
1290 #define ASN1_R_ODD_NUMBER_OF_CHARS 145
1291 #define ASN1_R_PRIVATE_KEY_HEADER_MISSING 146
1292 #define ASN1_R_SECOND_NUMBER_TOO_LARGE 147
1293 #define ASN1_R_SEQUENCE_LENGTH_MISMATCH 148
1294 #define ASN1_R_SEQUENCE_NOT_CONSTRUCTED 149
1295 #define ASN1_R_SEQUENCE_OR_SET_NEEDS_CONFIG 192
1296 #define ASN1_R_SHORT_LINE 150
1297 #define ASN1_R_STRING_TOO_LONG 151
1298 #define ASN1_R_STRING_TOO_SHORT 152
1299 #define ASN1_R_TAG_VALUE_TOO_HIGH 153
1300 #define ASN1_R_THE_ASN1_OBJECT_IDENTIFIER_IS_NOT_KNOWN_FOR_THIS_MD 154
1301 #define ASN1_R_TIME_NOT_ASCII_FORMAT 193
1302 #define ASN1_R_TOO_LONG 155
1303 #define ASN1_R_TYPE_NOT_CONSTRUCTED 156
1304 #define ASN1_R_UNABLE_TO_DECODE_RSA_KEY 157
1305 #define ASN1_R_UNABLE_TO_DECODE_RSA_PRIVATE_KEY 158
1306 #define ASN1_R_UNEXPECTED_EOC 159
1307 #define ASN1_R_UNKNOWN_FORMAT 160
1308 #define ASN1_R_UNKNOWN_MESSAGE_DIGEST_ALGORITHM 161
1309 #define ASN1_R_UNKNOWN_OBJECT_TYPE 162
1310 #define ASN1_R_UNKNOWN_PUBLIC_KEY_TYPE 163
1311 #define ASN1_R_UNKNOWN_SIGNATURE_ALGORITHM 199
1312 #define ASN1_R_UNKNOWN_TAG 194
1313 #define ASN1_R_UNKOWN_FORMAT 195
1314 #define ASN1_R_UNSUPPORTED_ANY_DEFINED_BY_TYPE 164
1315 #define ASN1_R_UNSUPPORTED_CIPHER 165
1316 #define ASN1_R_UNSUPPORTED_ENCRYPTION_ALGORITHM 166
1317 #define ASN1_R_UNSUPPORTED_PUBLIC_KEY_TYPE 167
1318 #define ASN1_R_UNSUPPORTED_TYPE 196
1319 #define ASN1_R_WRONG_PUBLIC_KEY_TYPE 200
1320 #define ASN1_R_WRONG_TAG 168
1321 #define ASN1_R_WRONG_TYPE 169