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 /* ASN1 public key method structure */
287 #define ASN1_PKEY_ALIAS 0x1
289 struct evp_pkey_asn1_method_st
293 unsigned long pkey_flags;
295 int (*pub_decode)(EVP_PKEY *pk, X509_PUBKEY *pub);
296 int (*pub_encode)(X509_PUBKEY *pub, const EVP_PKEY *pk);
297 int (*pub_cmp)(const EVP_PKEY *a, const EVP_PKEY *b);
298 int (*pub_print)(BIO *out, const EVP_PKEY *pkey, int indent,
301 int (*priv_decode)(EVP_PKEY *pk, PKCS8_PRIV_KEY_INFO *p8inf);
302 int (*priv_encode)(PKCS8_PRIV_KEY_INFO *p8, const EVP_PKEY *pk);
303 int (*priv_print)(BIO *out, const EVP_PKEY *pkey, int indent,
306 int (*pkey_size)(const EVP_PKEY *pk);
307 int (*pkey_bits)(const EVP_PKEY *pk);
309 int (*param_decode)(const EVP_PKEY *pk, X509_PUBKEY *pub);
310 int (*param_encode)(X509_PUBKEY *pub, const EVP_PKEY *pk);
311 int (*param_missing)(const EVP_PKEY *pk);
312 int (*param_copy)(EVP_PKEY *to, const EVP_PKEY *from);
313 int (*param_cmp)(const EVP_PKEY *a, const EVP_PKEY *b);
314 int (*param_print)(BIO *out, const EVP_PKEY *pkey, int indent,
317 void (*pkey_free)(EVP_PKEY *pkey);
318 void (*pkey_ctrl)(EVP_PKEY *pkey, int op, long arg1, void *arg2);
319 } /* EVP_PKEY_ASN1_METHOD */;
321 /* Declare ASN1 functions: the implement macro in in asn1t.h */
323 #define DECLARE_ASN1_FUNCTIONS(type) DECLARE_ASN1_FUNCTIONS_name(type, type)
325 #define DECLARE_ASN1_ALLOC_FUNCTIONS(type) \
326 DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, type)
328 #define DECLARE_ASN1_FUNCTIONS_name(type, name) \
329 DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \
330 DECLARE_ASN1_ENCODE_FUNCTIONS(type, name, name)
332 #define DECLARE_ASN1_FUNCTIONS_fname(type, itname, name) \
333 DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \
334 DECLARE_ASN1_ENCODE_FUNCTIONS(type, itname, name)
336 #define DECLARE_ASN1_ENCODE_FUNCTIONS(type, itname, name) \
337 type *d2i_##name(type **a, const unsigned char **in, long len); \
338 int i2d_##name(type *a, unsigned char **out); \
339 DECLARE_ASN1_ITEM(itname)
341 #define DECLARE_ASN1_ENCODE_FUNCTIONS_const(type, name) \
342 type *d2i_##name(type **a, const unsigned char **in, long len); \
343 int i2d_##name(const type *a, unsigned char **out); \
344 DECLARE_ASN1_ITEM(name)
346 #define DECLARE_ASN1_NDEF_FUNCTION(name) \
347 int i2d_##name##_NDEF(name *a, unsigned char **out);
349 #define DECLARE_ASN1_FUNCTIONS_const(name) \
350 name *name##_new(void); \
351 void name##_free(name *a);
353 #define DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \
354 type *name##_new(void); \
355 void name##_free(type *a);
357 #define DECLARE_ASN1_PRINT_FUNCTION(stname) \
358 DECLARE_ASN1_PRINT_FUNCTION_fname(stname, stname)
360 #define DECLARE_ASN1_PRINT_FUNCTION_fname(stname, fname) \
361 int fname##_print_ctx(BIO *out, stname *x, int indent, \
362 const ASN1_PCTX *pctx);
364 #define D2I_OF(type) type *(*)(type **,const unsigned char **,long)
365 #define I2D_OF(type) int (*)(type *,unsigned char **)
366 #define I2D_OF_const(type) int (*)(const type *,unsigned char **)
368 #define TYPEDEF_D2I_OF(type) typedef type *d2i_of_##type(type **,const unsigned char **,long)
369 #define TYPEDEF_I2D_OF(type) typedef int i2d_of_##type(type *,unsigned char **)
370 #define TYPEDEF_D2I2D_OF(type) TYPEDEF_D2I_OF(type); TYPEDEF_I2D_OF(type)
372 TYPEDEF_D2I2D_OF(void);
374 /* The following macros and typedefs allow an ASN1_ITEM
375 * to be embedded in a structure and referenced. Since
376 * the ASN1_ITEM pointers need to be globally accessible
377 * (possibly from shared libraries) they may exist in
378 * different forms. On platforms that support it the
379 * ASN1_ITEM structure itself will be globally exported.
380 * Other platforms will export a function that returns
381 * an ASN1_ITEM pointer.
383 * To handle both cases transparently the macros below
384 * should be used instead of hard coding an ASN1_ITEM
385 * pointer in a structure.
387 * The structure will look like this:
389 * typedef struct SOMETHING_st {
391 * ASN1_ITEM_EXP *iptr;
395 * It would be initialised as e.g.:
397 * SOMETHING somevar = {...,ASN1_ITEM_ref(X509),...};
399 * and the actual pointer extracted with:
401 * const ASN1_ITEM *it = ASN1_ITEM_ptr(somevar.iptr);
403 * Finally an ASN1_ITEM pointer can be extracted from an
404 * appropriate reference with: ASN1_ITEM_rptr(X509). This
405 * would be used when a function takes an ASN1_ITEM * argument.
409 #ifndef OPENSSL_EXPORT_VAR_AS_FUNCTION
411 /* ASN1_ITEM pointer exported type */
412 typedef const ASN1_ITEM ASN1_ITEM_EXP;
414 /* Macro to obtain ASN1_ITEM pointer from exported type */
415 #define ASN1_ITEM_ptr(iptr) (iptr)
417 /* Macro to include ASN1_ITEM pointer from base type */
418 #define ASN1_ITEM_ref(iptr) (&(iptr##_it))
420 #define ASN1_ITEM_rptr(ref) (&(ref##_it))
422 #define DECLARE_ASN1_ITEM(name) \
423 OPENSSL_EXTERN const ASN1_ITEM name##_it;
427 /* Platforms that can't easily handle shared global variables are declared
428 * as functions returning ASN1_ITEM pointers.
431 /* ASN1_ITEM pointer exported type */
432 typedef const ASN1_ITEM * ASN1_ITEM_EXP(void);
434 /* Macro to obtain ASN1_ITEM pointer from exported type */
435 #define ASN1_ITEM_ptr(iptr) (iptr())
437 /* Macro to include ASN1_ITEM pointer from base type */
438 #define ASN1_ITEM_ref(iptr) (iptr##_it)
440 #define ASN1_ITEM_rptr(ref) (ref##_it())
442 #define DECLARE_ASN1_ITEM(name) \
443 const ASN1_ITEM * name##_it(void);
447 /* Parameters used by ASN1_STRING_print_ex() */
449 /* These determine which characters to escape:
450 * RFC2253 special characters, control characters and
454 #define ASN1_STRFLGS_ESC_2253 1
455 #define ASN1_STRFLGS_ESC_CTRL 2
456 #define ASN1_STRFLGS_ESC_MSB 4
459 /* This flag determines how we do escaping: normally
460 * RC2253 backslash only, set this to use backslash and
464 #define ASN1_STRFLGS_ESC_QUOTE 8
467 /* These three flags are internal use only. */
469 /* Character is a valid PrintableString character */
470 #define CHARTYPE_PRINTABLESTRING 0x10
471 /* Character needs escaping if it is the first character */
472 #define CHARTYPE_FIRST_ESC_2253 0x20
473 /* Character needs escaping if it is the last character */
474 #define CHARTYPE_LAST_ESC_2253 0x40
476 /* NB the internal flags are safely reused below by flags
477 * handled at the top level.
480 /* If this is set we convert all character strings
484 #define ASN1_STRFLGS_UTF8_CONVERT 0x10
486 /* If this is set we don't attempt to interpret content:
487 * just assume all strings are 1 byte per character. This
488 * will produce some pretty odd looking output!
491 #define ASN1_STRFLGS_IGNORE_TYPE 0x20
493 /* If this is set we include the string type in the output */
494 #define ASN1_STRFLGS_SHOW_TYPE 0x40
496 /* This determines which strings to display and which to
497 * 'dump' (hex dump of content octets or DER encoding). We can
498 * only dump non character strings or everything. If we
499 * don't dump 'unknown' they are interpreted as character
500 * strings with 1 octet per character and are subject to
501 * the usual escaping options.
504 #define ASN1_STRFLGS_DUMP_ALL 0x80
505 #define ASN1_STRFLGS_DUMP_UNKNOWN 0x100
507 /* These determine what 'dumping' does, we can dump the
508 * content octets or the DER encoding: both use the
509 * RFC2253 #XXXXX notation.
512 #define ASN1_STRFLGS_DUMP_DER 0x200
514 /* All the string flags consistent with RFC2253,
515 * escaping control characters isn't essential in
516 * RFC2253 but it is advisable anyway.
519 #define ASN1_STRFLGS_RFC2253 (ASN1_STRFLGS_ESC_2253 | \
520 ASN1_STRFLGS_ESC_CTRL | \
521 ASN1_STRFLGS_ESC_MSB | \
522 ASN1_STRFLGS_UTF8_CONVERT | \
523 ASN1_STRFLGS_DUMP_UNKNOWN | \
524 ASN1_STRFLGS_DUMP_DER)
526 DECLARE_STACK_OF(ASN1_INTEGER)
527 DECLARE_ASN1_SET_OF(ASN1_INTEGER)
529 DECLARE_STACK_OF(ASN1_GENERALSTRING)
531 typedef struct asn1_type_st
536 ASN1_BOOLEAN boolean;
537 ASN1_STRING * asn1_string;
538 ASN1_OBJECT * object;
539 ASN1_INTEGER * integer;
540 ASN1_ENUMERATED * enumerated;
541 ASN1_BIT_STRING * bit_string;
542 ASN1_OCTET_STRING * octet_string;
543 ASN1_PRINTABLESTRING * printablestring;
544 ASN1_T61STRING * t61string;
545 ASN1_IA5STRING * ia5string;
546 ASN1_GENERALSTRING * generalstring;
547 ASN1_BMPSTRING * bmpstring;
548 ASN1_UNIVERSALSTRING * universalstring;
549 ASN1_UTCTIME * utctime;
550 ASN1_GENERALIZEDTIME * generalizedtime;
551 ASN1_VISIBLESTRING * visiblestring;
552 ASN1_UTF8STRING * utf8string;
553 /* set and sequence are left complete and still
554 * contain the set or sequence bytes */
556 ASN1_STRING * sequence;
560 DECLARE_STACK_OF(ASN1_TYPE)
561 DECLARE_ASN1_SET_OF(ASN1_TYPE)
563 typedef struct NETSCAPE_X509_st
565 ASN1_OCTET_STRING *header;
569 /* This is used to contain a list of bit names */
570 typedef struct BIT_STRING_BITNAME_st {
574 } BIT_STRING_BITNAME;
577 #define M_ASN1_STRING_length(x) ((x)->length)
578 #define M_ASN1_STRING_length_set(x, n) ((x)->length = (n))
579 #define M_ASN1_STRING_type(x) ((x)->type)
580 #define M_ASN1_STRING_data(x) ((x)->data)
582 /* Macros for string operations */
583 #define M_ASN1_BIT_STRING_new() (ASN1_BIT_STRING *)\
584 ASN1_STRING_type_new(V_ASN1_BIT_STRING)
585 #define M_ASN1_BIT_STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
586 #define M_ASN1_BIT_STRING_dup(a) (ASN1_BIT_STRING *)\
587 ASN1_STRING_dup((const ASN1_STRING *)a)
588 #define M_ASN1_BIT_STRING_cmp(a,b) ASN1_STRING_cmp(\
589 (const ASN1_STRING *)a,(const ASN1_STRING *)b)
590 #define M_ASN1_BIT_STRING_set(a,b,c) ASN1_STRING_set((ASN1_STRING *)a,b,c)
592 #define M_ASN1_INTEGER_new() (ASN1_INTEGER *)\
593 ASN1_STRING_type_new(V_ASN1_INTEGER)
594 #define M_ASN1_INTEGER_free(a) ASN1_STRING_free((ASN1_STRING *)a)
595 #define M_ASN1_INTEGER_dup(a) (ASN1_INTEGER *)\
596 ASN1_STRING_dup((const ASN1_STRING *)a)
597 #define M_ASN1_INTEGER_cmp(a,b) ASN1_STRING_cmp(\
598 (const ASN1_STRING *)a,(const ASN1_STRING *)b)
600 #define M_ASN1_ENUMERATED_new() (ASN1_ENUMERATED *)\
601 ASN1_STRING_type_new(V_ASN1_ENUMERATED)
602 #define M_ASN1_ENUMERATED_free(a) ASN1_STRING_free((ASN1_STRING *)a)
603 #define M_ASN1_ENUMERATED_dup(a) (ASN1_ENUMERATED *)\
604 ASN1_STRING_dup((const ASN1_STRING *)a)
605 #define M_ASN1_ENUMERATED_cmp(a,b) ASN1_STRING_cmp(\
606 (const ASN1_STRING *)a,(const ASN1_STRING *)b)
608 #define M_ASN1_OCTET_STRING_new() (ASN1_OCTET_STRING *)\
609 ASN1_STRING_type_new(V_ASN1_OCTET_STRING)
610 #define M_ASN1_OCTET_STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
611 #define M_ASN1_OCTET_STRING_dup(a) (ASN1_OCTET_STRING *)\
612 ASN1_STRING_dup((const ASN1_STRING *)a)
613 #define M_ASN1_OCTET_STRING_cmp(a,b) ASN1_STRING_cmp(\
614 (const ASN1_STRING *)a,(const ASN1_STRING *)b)
615 #define M_ASN1_OCTET_STRING_set(a,b,c) ASN1_STRING_set((ASN1_STRING *)a,b,c)
616 #define M_ASN1_OCTET_STRING_print(a,b) ASN1_STRING_print(a,(ASN1_STRING *)b)
617 #define M_i2d_ASN1_OCTET_STRING(a,pp) \
618 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_OCTET_STRING,\
621 #define B_ASN1_TIME \
623 B_ASN1_GENERALIZEDTIME
625 #define B_ASN1_PRINTABLE \
626 B_ASN1_PRINTABLESTRING| \
630 B_ASN1_UNIVERSALSTRING|\
636 #define B_ASN1_DIRECTORYSTRING \
637 B_ASN1_PRINTABLESTRING| \
638 B_ASN1_TELETEXSTRING|\
640 B_ASN1_UNIVERSALSTRING|\
643 #define B_ASN1_DISPLAYTEXT \
645 B_ASN1_VISIBLESTRING| \
649 #define M_ASN1_PRINTABLE_new() ASN1_STRING_type_new(V_ASN1_T61STRING)
650 #define M_ASN1_PRINTABLE_free(a) ASN1_STRING_free((ASN1_STRING *)a)
651 #define M_i2d_ASN1_PRINTABLE(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\
652 pp,a->type,V_ASN1_UNIVERSAL)
653 #define M_d2i_ASN1_PRINTABLE(a,pp,l) \
654 d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \
657 #define M_DIRECTORYSTRING_new() ASN1_STRING_type_new(V_ASN1_PRINTABLESTRING)
658 #define M_DIRECTORYSTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
659 #define M_i2d_DIRECTORYSTRING(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\
660 pp,a->type,V_ASN1_UNIVERSAL)
661 #define M_d2i_DIRECTORYSTRING(a,pp,l) \
662 d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \
663 B_ASN1_DIRECTORYSTRING)
665 #define M_DISPLAYTEXT_new() ASN1_STRING_type_new(V_ASN1_VISIBLESTRING)
666 #define M_DISPLAYTEXT_free(a) ASN1_STRING_free((ASN1_STRING *)a)
667 #define M_i2d_DISPLAYTEXT(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\
668 pp,a->type,V_ASN1_UNIVERSAL)
669 #define M_d2i_DISPLAYTEXT(a,pp,l) \
670 d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \
673 #define M_ASN1_PRINTABLESTRING_new() (ASN1_PRINTABLESTRING *)\
674 ASN1_STRING_type_new(V_ASN1_PRINTABLESTRING)
675 #define M_ASN1_PRINTABLESTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
676 #define M_i2d_ASN1_PRINTABLESTRING(a,pp) \
677 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_PRINTABLESTRING,\
679 #define M_d2i_ASN1_PRINTABLESTRING(a,pp,l) \
680 (ASN1_PRINTABLESTRING *)d2i_ASN1_type_bytes\
681 ((ASN1_STRING **)a,pp,l,B_ASN1_PRINTABLESTRING)
683 #define M_ASN1_T61STRING_new() (ASN1_T61STRING *)\
684 ASN1_STRING_type_new(V_ASN1_T61STRING)
685 #define M_ASN1_T61STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
686 #define M_i2d_ASN1_T61STRING(a,pp) \
687 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_T61STRING,\
689 #define M_d2i_ASN1_T61STRING(a,pp,l) \
690 (ASN1_T61STRING *)d2i_ASN1_type_bytes\
691 ((ASN1_STRING **)a,pp,l,B_ASN1_T61STRING)
693 #define M_ASN1_IA5STRING_new() (ASN1_IA5STRING *)\
694 ASN1_STRING_type_new(V_ASN1_IA5STRING)
695 #define M_ASN1_IA5STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
696 #define M_ASN1_IA5STRING_dup(a) \
697 (ASN1_IA5STRING *)ASN1_STRING_dup((const ASN1_STRING *)a)
698 #define M_i2d_ASN1_IA5STRING(a,pp) \
699 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_IA5STRING,\
701 #define M_d2i_ASN1_IA5STRING(a,pp,l) \
702 (ASN1_IA5STRING *)d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l,\
705 #define M_ASN1_UTCTIME_new() (ASN1_UTCTIME *)\
706 ASN1_STRING_type_new(V_ASN1_UTCTIME)
707 #define M_ASN1_UTCTIME_free(a) ASN1_STRING_free((ASN1_STRING *)a)
708 #define M_ASN1_UTCTIME_dup(a) (ASN1_UTCTIME *)\
709 ASN1_STRING_dup((const ASN1_STRING *)a)
711 #define M_ASN1_GENERALIZEDTIME_new() (ASN1_GENERALIZEDTIME *)\
712 ASN1_STRING_type_new(V_ASN1_GENERALIZEDTIME)
713 #define M_ASN1_GENERALIZEDTIME_free(a) ASN1_STRING_free((ASN1_STRING *)a)
714 #define M_ASN1_GENERALIZEDTIME_dup(a) (ASN1_GENERALIZEDTIME *)ASN1_STRING_dup(\
715 (const ASN1_STRING *)a)
717 #define M_ASN1_TIME_new() (ASN1_TIME *)\
718 ASN1_STRING_type_new(V_ASN1_UTCTIME)
719 #define M_ASN1_TIME_free(a) ASN1_STRING_free((ASN1_STRING *)a)
720 #define M_ASN1_TIME_dup(a) (ASN1_TIME *)\
721 ASN1_STRING_dup((const ASN1_STRING *)a)
723 #define M_ASN1_GENERALSTRING_new() (ASN1_GENERALSTRING *)\
724 ASN1_STRING_type_new(V_ASN1_GENERALSTRING)
725 #define M_ASN1_GENERALSTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
726 #define M_i2d_ASN1_GENERALSTRING(a,pp) \
727 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_GENERALSTRING,\
729 #define M_d2i_ASN1_GENERALSTRING(a,pp,l) \
730 (ASN1_GENERALSTRING *)d2i_ASN1_type_bytes\
731 ((ASN1_STRING **)a,pp,l,B_ASN1_GENERALSTRING)
733 #define M_ASN1_UNIVERSALSTRING_new() (ASN1_UNIVERSALSTRING *)\
734 ASN1_STRING_type_new(V_ASN1_UNIVERSALSTRING)
735 #define M_ASN1_UNIVERSALSTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
736 #define M_i2d_ASN1_UNIVERSALSTRING(a,pp) \
737 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_UNIVERSALSTRING,\
739 #define M_d2i_ASN1_UNIVERSALSTRING(a,pp,l) \
740 (ASN1_UNIVERSALSTRING *)d2i_ASN1_type_bytes\
741 ((ASN1_STRING **)a,pp,l,B_ASN1_UNIVERSALSTRING)
743 #define M_ASN1_BMPSTRING_new() (ASN1_BMPSTRING *)\
744 ASN1_STRING_type_new(V_ASN1_BMPSTRING)
745 #define M_ASN1_BMPSTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
746 #define M_i2d_ASN1_BMPSTRING(a,pp) \
747 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_BMPSTRING,\
749 #define M_d2i_ASN1_BMPSTRING(a,pp,l) \
750 (ASN1_BMPSTRING *)d2i_ASN1_type_bytes\
751 ((ASN1_STRING **)a,pp,l,B_ASN1_BMPSTRING)
753 #define M_ASN1_VISIBLESTRING_new() (ASN1_VISIBLESTRING *)\
754 ASN1_STRING_type_new(V_ASN1_VISIBLESTRING)
755 #define M_ASN1_VISIBLESTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
756 #define M_i2d_ASN1_VISIBLESTRING(a,pp) \
757 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_VISIBLESTRING,\
759 #define M_d2i_ASN1_VISIBLESTRING(a,pp,l) \
760 (ASN1_VISIBLESTRING *)d2i_ASN1_type_bytes\
761 ((ASN1_STRING **)a,pp,l,B_ASN1_VISIBLESTRING)
763 #define M_ASN1_UTF8STRING_new() (ASN1_UTF8STRING *)\
764 ASN1_STRING_type_new(V_ASN1_UTF8STRING)
765 #define M_ASN1_UTF8STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a)
766 #define M_i2d_ASN1_UTF8STRING(a,pp) \
767 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_UTF8STRING,\
769 #define M_d2i_ASN1_UTF8STRING(a,pp,l) \
770 (ASN1_UTF8STRING *)d2i_ASN1_type_bytes\
771 ((ASN1_STRING **)a,pp,l,B_ASN1_UTF8STRING)
773 /* for the is_set parameter to i2d_ASN1_SET */
774 #define IS_SEQUENCE 0
777 DECLARE_ASN1_FUNCTIONS_fname(ASN1_TYPE, ASN1_ANY, ASN1_TYPE)
779 int ASN1_TYPE_get(ASN1_TYPE *a);
780 void ASN1_TYPE_set(ASN1_TYPE *a, int type, void *value);
781 int ASN1_TYPE_cmp(ASN1_TYPE *a, ASN1_TYPE *b);
783 ASN1_OBJECT * ASN1_OBJECT_new(void );
784 void ASN1_OBJECT_free(ASN1_OBJECT *a);
785 int i2d_ASN1_OBJECT(ASN1_OBJECT *a,unsigned char **pp);
786 ASN1_OBJECT * c2i_ASN1_OBJECT(ASN1_OBJECT **a,const unsigned char **pp,
788 ASN1_OBJECT * d2i_ASN1_OBJECT(ASN1_OBJECT **a,const unsigned char **pp,
791 DECLARE_ASN1_ITEM(ASN1_OBJECT)
793 DECLARE_STACK_OF(ASN1_OBJECT)
794 DECLARE_ASN1_SET_OF(ASN1_OBJECT)
796 ASN1_STRING * ASN1_STRING_new(void);
797 void ASN1_STRING_free(ASN1_STRING *a);
798 ASN1_STRING * ASN1_STRING_dup(const ASN1_STRING *a);
799 ASN1_STRING * ASN1_STRING_type_new(int type );
800 int ASN1_STRING_cmp(const ASN1_STRING *a, const ASN1_STRING *b);
801 /* Since this is used to store all sorts of things, via macros, for now, make
803 int ASN1_STRING_set(ASN1_STRING *str, const void *data, int len);
804 int ASN1_STRING_length(const ASN1_STRING *x);
805 void ASN1_STRING_length_set(ASN1_STRING *x, int n);
806 int ASN1_STRING_type(ASN1_STRING *x);
807 unsigned char * ASN1_STRING_data(ASN1_STRING *x);
809 DECLARE_ASN1_FUNCTIONS(ASN1_BIT_STRING)
810 int i2c_ASN1_BIT_STRING(ASN1_BIT_STRING *a,unsigned char **pp);
811 ASN1_BIT_STRING *c2i_ASN1_BIT_STRING(ASN1_BIT_STRING **a,const unsigned char **pp,
813 int ASN1_BIT_STRING_set(ASN1_BIT_STRING *a, unsigned char *d,
815 int ASN1_BIT_STRING_set_bit(ASN1_BIT_STRING *a, int n, int value);
816 int ASN1_BIT_STRING_get_bit(ASN1_BIT_STRING *a, int n);
817 int ASN1_BIT_STRING_check(ASN1_BIT_STRING *a,
818 unsigned char *flags, int flags_len);
820 #ifndef OPENSSL_NO_BIO
821 int ASN1_BIT_STRING_name_print(BIO *out, ASN1_BIT_STRING *bs,
822 BIT_STRING_BITNAME *tbl, int indent);
824 int ASN1_BIT_STRING_num_asc(char *name, BIT_STRING_BITNAME *tbl);
825 int ASN1_BIT_STRING_set_asc(ASN1_BIT_STRING *bs, char *name, int value,
826 BIT_STRING_BITNAME *tbl);
828 int i2d_ASN1_BOOLEAN(int a,unsigned char **pp);
829 int d2i_ASN1_BOOLEAN(int *a,const unsigned char **pp,long length);
831 DECLARE_ASN1_FUNCTIONS(ASN1_INTEGER)
832 int i2c_ASN1_INTEGER(ASN1_INTEGER *a,unsigned char **pp);
833 ASN1_INTEGER *c2i_ASN1_INTEGER(ASN1_INTEGER **a,const unsigned char **pp,
835 ASN1_INTEGER *d2i_ASN1_UINTEGER(ASN1_INTEGER **a,const unsigned char **pp,
837 ASN1_INTEGER * ASN1_INTEGER_dup(const ASN1_INTEGER *x);
838 int ASN1_INTEGER_cmp(const ASN1_INTEGER *x, const ASN1_INTEGER *y);
840 DECLARE_ASN1_FUNCTIONS(ASN1_ENUMERATED)
842 int ASN1_UTCTIME_check(ASN1_UTCTIME *a);
843 ASN1_UTCTIME *ASN1_UTCTIME_set(ASN1_UTCTIME *s,time_t t);
844 int ASN1_UTCTIME_set_string(ASN1_UTCTIME *s, const char *str);
845 int ASN1_UTCTIME_cmp_time_t(const ASN1_UTCTIME *s, time_t t);
847 time_t ASN1_UTCTIME_get(const ASN1_UTCTIME *s);
850 int ASN1_GENERALIZEDTIME_check(ASN1_GENERALIZEDTIME *a);
851 ASN1_GENERALIZEDTIME *ASN1_GENERALIZEDTIME_set(ASN1_GENERALIZEDTIME *s,time_t t);
852 int ASN1_GENERALIZEDTIME_set_string(ASN1_GENERALIZEDTIME *s, const char *str);
854 DECLARE_ASN1_FUNCTIONS(ASN1_OCTET_STRING)
855 ASN1_OCTET_STRING * ASN1_OCTET_STRING_dup(const ASN1_OCTET_STRING *a);
856 int ASN1_OCTET_STRING_cmp(const ASN1_OCTET_STRING *a, const ASN1_OCTET_STRING *b);
857 int ASN1_OCTET_STRING_set(ASN1_OCTET_STRING *str, const unsigned char *data, int len);
859 DECLARE_ASN1_FUNCTIONS(ASN1_VISIBLESTRING)
860 DECLARE_ASN1_FUNCTIONS(ASN1_UNIVERSALSTRING)
861 DECLARE_ASN1_FUNCTIONS(ASN1_UTF8STRING)
862 DECLARE_ASN1_FUNCTIONS(ASN1_NULL)
863 DECLARE_ASN1_FUNCTIONS(ASN1_BMPSTRING)
865 int UTF8_getc(const unsigned char *str, int len, unsigned long *val);
866 int UTF8_putc(unsigned char *str, int len, unsigned long value);
868 DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, ASN1_PRINTABLE)
870 DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, DIRECTORYSTRING)
871 DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, DISPLAYTEXT)
872 DECLARE_ASN1_FUNCTIONS(ASN1_PRINTABLESTRING)
873 DECLARE_ASN1_FUNCTIONS(ASN1_T61STRING)
874 DECLARE_ASN1_FUNCTIONS(ASN1_IA5STRING)
875 DECLARE_ASN1_FUNCTIONS(ASN1_GENERALSTRING)
876 DECLARE_ASN1_FUNCTIONS(ASN1_UTCTIME)
877 DECLARE_ASN1_FUNCTIONS(ASN1_GENERALIZEDTIME)
878 DECLARE_ASN1_FUNCTIONS(ASN1_TIME)
880 DECLARE_ASN1_ITEM(ASN1_OCTET_STRING_NDEF)
882 ASN1_TIME *ASN1_TIME_set(ASN1_TIME *s,time_t t);
883 int ASN1_TIME_check(ASN1_TIME *t);
884 ASN1_GENERALIZEDTIME *ASN1_TIME_to_generalizedtime(ASN1_TIME *t, ASN1_GENERALIZEDTIME **out);
886 int i2d_ASN1_SET(STACK *a, unsigned char **pp,
887 i2d_of_void *i2d, int ex_tag, int ex_class, int is_set);
888 STACK * d2i_ASN1_SET(STACK **a, const unsigned char **pp, long length,
889 d2i_of_void *d2i, void (*free_func)(void *),
890 int ex_tag, int ex_class);
892 #ifndef OPENSSL_NO_BIO
893 int i2a_ASN1_INTEGER(BIO *bp, ASN1_INTEGER *a);
894 int a2i_ASN1_INTEGER(BIO *bp,ASN1_INTEGER *bs,char *buf,int size);
895 int i2a_ASN1_ENUMERATED(BIO *bp, ASN1_ENUMERATED *a);
896 int a2i_ASN1_ENUMERATED(BIO *bp,ASN1_ENUMERATED *bs,char *buf,int size);
897 int i2a_ASN1_OBJECT(BIO *bp,ASN1_OBJECT *a);
898 int a2i_ASN1_STRING(BIO *bp,ASN1_STRING *bs,char *buf,int size);
899 int i2a_ASN1_STRING(BIO *bp, ASN1_STRING *a, int type);
901 int i2t_ASN1_OBJECT(char *buf,int buf_len,ASN1_OBJECT *a);
903 int a2d_ASN1_OBJECT(unsigned char *out,int olen, const char *buf, int num);
904 ASN1_OBJECT *ASN1_OBJECT_create(int nid, unsigned char *data,int len,
905 const char *sn, const char *ln);
907 int ASN1_INTEGER_set(ASN1_INTEGER *a, long v);
908 long ASN1_INTEGER_get(const ASN1_INTEGER *a);
909 ASN1_INTEGER *BN_to_ASN1_INTEGER(const BIGNUM *bn, ASN1_INTEGER *ai);
910 BIGNUM *ASN1_INTEGER_to_BN(const ASN1_INTEGER *ai,BIGNUM *bn);
912 int ASN1_ENUMERATED_set(ASN1_ENUMERATED *a, long v);
913 long ASN1_ENUMERATED_get(ASN1_ENUMERATED *a);
914 ASN1_ENUMERATED *BN_to_ASN1_ENUMERATED(BIGNUM *bn, ASN1_ENUMERATED *ai);
915 BIGNUM *ASN1_ENUMERATED_to_BN(ASN1_ENUMERATED *ai,BIGNUM *bn);
918 /* given a string, return the correct type, max is the maximum length */
919 int ASN1_PRINTABLE_type(const unsigned char *s, int max);
921 int i2d_ASN1_bytes(ASN1_STRING *a, unsigned char **pp, int tag, int xclass);
922 ASN1_STRING *d2i_ASN1_bytes(ASN1_STRING **a, const unsigned char **pp,
923 long length, int Ptag, int Pclass);
924 unsigned long ASN1_tag2bit(int tag);
925 /* type is one or more of the B_ASN1_ values. */
926 ASN1_STRING *d2i_ASN1_type_bytes(ASN1_STRING **a,const unsigned char **pp,
927 long length,int type);
930 int asn1_Finish(ASN1_CTX *c);
931 int asn1_const_Finish(ASN1_const_CTX *c);
934 int ASN1_get_object(const unsigned char **pp, long *plength, int *ptag,
935 int *pclass, long omax);
936 int ASN1_check_infinite_end(unsigned char **p,long len);
937 int ASN1_const_check_infinite_end(const unsigned char **p,long len);
938 void ASN1_put_object(unsigned char **pp, int constructed, int length,
939 int tag, int xclass);
940 int ASN1_put_eoc(unsigned char **pp);
941 int ASN1_object_size(int constructed, int length, int tag);
943 /* Used to implement other functions */
944 void *ASN1_dup(i2d_of_void *i2d, d2i_of_void *d2i, char *x);
945 #define ASN1_dup_of(type,i2d,d2i,x) \
946 ((type *(*)(I2D_OF(type),D2I_OF(type),type *))openssl_fcast(ASN1_dup))(i2d,d2i,x)
947 #define ASN1_dup_of_const(type,i2d,d2i,x) \
948 ((type *(*)(I2D_OF_const(type),D2I_OF(type),type *))openssl_fcast(ASN1_dup))(i2d,d2i,x)
950 void *ASN1_item_dup(const ASN1_ITEM *it, void *x);
952 #ifndef OPENSSL_NO_FP_API
953 void *ASN1_d2i_fp(void *(*xnew)(void), d2i_of_void *d2i, FILE *in, void **x);
954 #define ASN1_d2i_fp_of(type,xnew,d2i,in,x) \
955 ((type *(*)(type *(*)(void),D2I_OF(type),FILE *,type **))openssl_fcast(ASN1_d2i_fp))(xnew,d2i,in,x)
956 void *ASN1_item_d2i_fp(const ASN1_ITEM *it, FILE *in, void *x);
957 int ASN1_i2d_fp(i2d_of_void *i2d,FILE *out,void *x);
958 #define ASN1_i2d_fp_of(type,i2d,out,x) \
959 ((int (*)(I2D_OF(type),FILE *,type *))openssl_fcast(ASN1_i2d_fp))(i2d,out,x)
960 #define ASN1_i2d_fp_of_const(type,i2d,out,x) \
961 ((int (*)(I2D_OF_const(type),FILE *,type *))openssl_fcast(ASN1_i2d_fp))(i2d,out,x)
962 int ASN1_item_i2d_fp(const ASN1_ITEM *it, FILE *out, void *x);
963 int ASN1_STRING_print_ex_fp(FILE *fp, ASN1_STRING *str, unsigned long flags);
966 int ASN1_STRING_to_UTF8(unsigned char **out, ASN1_STRING *in);
968 #ifndef OPENSSL_NO_BIO
969 void *ASN1_d2i_bio(void *(*xnew)(void), d2i_of_void *d2i, BIO *in, void **x);
970 #define ASN1_d2i_bio_of(type,xnew,d2i,in,x) \
971 ((type *(*)(type *(*)(void),D2I_OF(type),BIO *,type **))openssl_fcast(ASN1_d2i_bio))(xnew,d2i,in,x)
972 void *ASN1_item_d2i_bio(const ASN1_ITEM *it, BIO *in, void *x);
973 int ASN1_i2d_bio(i2d_of_void *i2d,BIO *out, unsigned char *x);
974 #define ASN1_i2d_bio_of(type,i2d,out,x) \
975 ((int (*)(I2D_OF(type),BIO *,type *))openssl_fcast(ASN1_i2d_bio))(i2d,out,x)
976 #define ASN1_i2d_bio_of_const(type,i2d,out,x) \
977 ((int (*)(I2D_OF_const(type),BIO *,const type *))openssl_fcast(ASN1_i2d_bio))(i2d,out,x)
978 int ASN1_item_i2d_bio(const ASN1_ITEM *it, BIO *out, void *x);
979 int ASN1_UTCTIME_print(BIO *fp, const ASN1_UTCTIME *a);
980 int ASN1_GENERALIZEDTIME_print(BIO *fp, const ASN1_GENERALIZEDTIME *a);
981 int ASN1_TIME_print(BIO *fp, const ASN1_TIME *a);
982 int ASN1_STRING_print(BIO *bp, const ASN1_STRING *v);
983 int ASN1_STRING_print_ex(BIO *out, ASN1_STRING *str, unsigned long flags);
984 int ASN1_bn_print(BIO *bp, const char *number, const BIGNUM *num,
985 unsigned char *buf, int off);
986 int ASN1_parse(BIO *bp,const unsigned char *pp,long len,int indent);
987 int ASN1_parse_dump(BIO *bp,const unsigned char *pp,long len,int indent,int dump);
989 const char *ASN1_tag2str(int tag);
991 /* Used to load and write netscape format cert */
993 DECLARE_ASN1_FUNCTIONS(NETSCAPE_X509)
995 int ASN1_UNIVERSALSTRING_to_string(ASN1_UNIVERSALSTRING *s);
997 int ASN1_TYPE_set_octetstring(ASN1_TYPE *a,
998 unsigned char *data, int len);
999 int ASN1_TYPE_get_octetstring(ASN1_TYPE *a,
1000 unsigned char *data, int max_len);
1001 int ASN1_TYPE_set_int_octetstring(ASN1_TYPE *a, long num,
1002 unsigned char *data, int len);
1003 int ASN1_TYPE_get_int_octetstring(ASN1_TYPE *a,long *num,
1004 unsigned char *data, int max_len);
1006 STACK *ASN1_seq_unpack(const unsigned char *buf, int len,
1007 d2i_of_void *d2i, void (*free_func)(void *));
1008 unsigned char *ASN1_seq_pack(STACK *safes, i2d_of_void *i2d,
1009 unsigned char **buf, int *len );
1010 void *ASN1_unpack_string(ASN1_STRING *oct, d2i_of_void *d2i);
1011 void *ASN1_item_unpack(ASN1_STRING *oct, const ASN1_ITEM *it);
1012 ASN1_STRING *ASN1_pack_string(void *obj, i2d_of_void *i2d,
1013 ASN1_OCTET_STRING **oct);
1014 #define ASN1_pack_string_of(type,obj,i2d,oct) \
1015 ((ASN1_STRING *(*)(type *,I2D_OF(type),ASN1_OCTET_STRING **))openssl_fcast(ASN1_pack_string))(obj,i2d,oct)
1016 ASN1_STRING *ASN1_item_pack(void *obj, const ASN1_ITEM *it, ASN1_OCTET_STRING **oct);
1018 void ASN1_STRING_set_default_mask(unsigned long mask);
1019 int ASN1_STRING_set_default_mask_asc(char *p);
1020 unsigned long ASN1_STRING_get_default_mask(void);
1021 int ASN1_mbstring_copy(ASN1_STRING **out, const unsigned char *in, int len,
1022 int inform, unsigned long mask);
1023 int ASN1_mbstring_ncopy(ASN1_STRING **out, const unsigned char *in, int len,
1024 int inform, unsigned long mask,
1025 long minsize, long maxsize);
1027 ASN1_STRING *ASN1_STRING_set_by_NID(ASN1_STRING **out,
1028 const unsigned char *in, int inlen, int inform, int nid);
1029 ASN1_STRING_TABLE *ASN1_STRING_TABLE_get(int nid);
1030 int ASN1_STRING_TABLE_add(int, long, long, unsigned long, unsigned long);
1031 void ASN1_STRING_TABLE_cleanup(void);
1033 /* ASN1 template functions */
1035 /* Old API compatible functions */
1036 ASN1_VALUE *ASN1_item_new(const ASN1_ITEM *it);
1037 void ASN1_item_free(ASN1_VALUE *val, const ASN1_ITEM *it);
1038 ASN1_VALUE * ASN1_item_d2i(ASN1_VALUE **val, const unsigned char **in, long len, const ASN1_ITEM *it);
1039 int ASN1_item_i2d(ASN1_VALUE *val, unsigned char **out, const ASN1_ITEM *it);
1040 int ASN1_item_ndef_i2d(ASN1_VALUE *val, unsigned char **out, const ASN1_ITEM *it);
1042 void ASN1_add_oid_module(void);
1044 ASN1_TYPE *ASN1_generate_nconf(char *str, CONF *nconf);
1045 ASN1_TYPE *ASN1_generate_v3(char *str, X509V3_CTX *cnf);
1047 /* ASN1 Print flags */
1049 /* Indicate missing OPTIONAL fields */
1050 #define ASN1_PCTX_FLAGS_SHOW_ABSENT 0x001
1051 /* Mark start and end of SEQUENCE */
1052 #define ASN1_PCTX_FLAGS_SHOW_SEQUENCE 0x002
1053 /* Mark start and end of SEQUENCE/SET OF */
1054 #define ASN1_PCTX_FLAGS_SHOW_SSOF 0x004
1055 /* Show the ASN1 type of primitives */
1056 #define ASN1_PCTX_FLAGS_SHOW_TYPE 0x008
1057 /* Don't show ASN1 type of ANY */
1058 #define ASN1_PCTX_FLAGS_NO_ANY_TYPE 0x010
1059 /* Don't show ASN1 type of MSTRINGs */
1060 #define ASN1_PCTX_FLAGS_NO_MSTRING_TYPE 0x020
1061 /* Don't show field names in SEQUENCE */
1062 #define ASN1_PCTX_FLAGS_NO_FIELD_NAME 0x040
1063 /* Show structure names of each SEQUENCE field */
1064 #define ASN1_PCTX_FLAGS_SHOW_FIELD_STRUCT_NAME 0x080
1065 /* Don't show structure name even at top level */
1066 #define ASN1_PCTX_FLAGS_NO_STRUCT_NAME 0x100
1068 int ASN1_item_print(BIO *out, ASN1_VALUE *ifld, int indent,
1069 const ASN1_ITEM *it, const ASN1_PCTX *pctx);
1070 ASN1_PCTX *ASN1_PCTX_new(void);
1071 void ASN1_PCTX_free(ASN1_PCTX *p);
1072 unsigned long ASN1_PCTX_get_flags(ASN1_PCTX *p);
1073 void ASN1_PCTX_set_flags(ASN1_PCTX *p, unsigned long flags);
1074 unsigned long ASN1_PCTX_get_nm_flags(ASN1_PCTX *p);
1075 void ASN1_PCTX_set_nm_flags(ASN1_PCTX *p, unsigned long flags);
1076 unsigned long ASN1_PCTX_get_cert_flags(ASN1_PCTX *p);
1077 void ASN1_PCTX_set_cert_flags(ASN1_PCTX *p, unsigned long flags);
1078 unsigned long ASN1_PCTX_get_oid_flags(ASN1_PCTX *p);
1079 void ASN1_PCTX_set_oid_flags(ASN1_PCTX *p, unsigned long flags);
1080 unsigned long ASN1_PCTX_get_str_flags(ASN1_PCTX *p);
1081 void ASN1_PCTX_set_str_flags(ASN1_PCTX *p, unsigned long flags);
1083 /* BEGIN ERROR CODES */
1084 /* The following lines are auto generated by the script mkerr.pl. Any changes
1085 * made after this point may be overwritten when the script is next run.
1087 void ERR_load_ASN1_strings(void);
1089 /* Error codes for the ASN1 functions. */
1091 /* Function codes. */
1092 #define ASN1_F_A2D_ASN1_OBJECT 100
1093 #define ASN1_F_A2I_ASN1_ENUMERATED 101
1094 #define ASN1_F_A2I_ASN1_INTEGER 102
1095 #define ASN1_F_A2I_ASN1_STRING 103
1096 #define ASN1_F_APPEND_EXP 176
1097 #define ASN1_F_ASN1_BIT_STRING_SET_BIT 183
1098 #define ASN1_F_ASN1_CB 177
1099 #define ASN1_F_ASN1_CHECK_TLEN 104
1100 #define ASN1_F_ASN1_COLLATE_PRIMITIVE 105
1101 #define ASN1_F_ASN1_COLLECT 106
1102 #define ASN1_F_ASN1_D2I_EX_PRIMITIVE 108
1103 #define ASN1_F_ASN1_D2I_FP 109
1104 #define ASN1_F_ASN1_D2I_READ_BIO 107
1105 #define ASN1_F_ASN1_DIGEST 184
1106 #define ASN1_F_ASN1_DO_ADB 110
1107 #define ASN1_F_ASN1_DUP 111
1108 #define ASN1_F_ASN1_ENUMERATED_SET 112
1109 #define ASN1_F_ASN1_ENUMERATED_TO_BN 113
1110 #define ASN1_F_ASN1_EX_C2I 204
1111 #define ASN1_F_ASN1_FIND_END 190
1112 #define ASN1_F_ASN1_GENERALIZEDTIME_SET 185
1113 #define ASN1_F_ASN1_GENERATE_V3 178
1114 #define ASN1_F_ASN1_GET_OBJECT 114
1115 #define ASN1_F_ASN1_HEADER_NEW 115
1116 #define ASN1_F_ASN1_I2D_BIO 116
1117 #define ASN1_F_ASN1_I2D_FP 117
1118 #define ASN1_F_ASN1_INTEGER_SET 118
1119 #define ASN1_F_ASN1_INTEGER_TO_BN 119
1120 #define ASN1_F_ASN1_ITEM_D2I_FP 206
1121 #define ASN1_F_ASN1_ITEM_DUP 191
1122 #define ASN1_F_ASN1_ITEM_EX_COMBINE_NEW 121
1123 #define ASN1_F_ASN1_ITEM_EX_D2I 120
1124 #define ASN1_F_ASN1_ITEM_I2D_BIO 192
1125 #define ASN1_F_ASN1_ITEM_I2D_FP 193
1126 #define ASN1_F_ASN1_ITEM_PACK 198
1127 #define ASN1_F_ASN1_ITEM_SIGN 195
1128 #define ASN1_F_ASN1_ITEM_UNPACK 199
1129 #define ASN1_F_ASN1_ITEM_VERIFY 197
1130 #define ASN1_F_ASN1_MBSTRING_NCOPY 122
1131 #define ASN1_F_ASN1_OBJECT_NEW 123
1132 #define ASN1_F_ASN1_PACK_STRING 124
1133 #define ASN1_F_ASN1_PCTX_NEW 205
1134 #define ASN1_F_ASN1_PKCS5_PBE_SET 125
1135 #define ASN1_F_ASN1_SEQ_PACK 126
1136 #define ASN1_F_ASN1_SEQ_UNPACK 127
1137 #define ASN1_F_ASN1_SIGN 128
1138 #define ASN1_F_ASN1_STR2TYPE 179
1139 #define ASN1_F_ASN1_STRING_SET 186
1140 #define ASN1_F_ASN1_STRING_TABLE_ADD 129
1141 #define ASN1_F_ASN1_STRING_TYPE_NEW 130
1142 #define ASN1_F_ASN1_TEMPLATE_EX_D2I 132
1143 #define ASN1_F_ASN1_TEMPLATE_NEW 133
1144 #define ASN1_F_ASN1_TEMPLATE_NOEXP_D2I 131
1145 #define ASN1_F_ASN1_TIME_SET 175
1146 #define ASN1_F_ASN1_TYPE_GET_INT_OCTETSTRING 134
1147 #define ASN1_F_ASN1_TYPE_GET_OCTETSTRING 135
1148 #define ASN1_F_ASN1_UNPACK_STRING 136
1149 #define ASN1_F_ASN1_UTCTIME_SET 187
1150 #define ASN1_F_ASN1_VERIFY 137
1151 #define ASN1_F_BITSTR_CB 180
1152 #define ASN1_F_BN_TO_ASN1_ENUMERATED 138
1153 #define ASN1_F_BN_TO_ASN1_INTEGER 139
1154 #define ASN1_F_C2I_ASN1_BIT_STRING 189
1155 #define ASN1_F_C2I_ASN1_INTEGER 194
1156 #define ASN1_F_C2I_ASN1_OBJECT 196
1157 #define ASN1_F_COLLECT_DATA 140
1158 #define ASN1_F_D2I_ASN1_BIT_STRING 141
1159 #define ASN1_F_D2I_ASN1_BOOLEAN 142
1160 #define ASN1_F_D2I_ASN1_BYTES 143
1161 #define ASN1_F_D2I_ASN1_GENERALIZEDTIME 144
1162 #define ASN1_F_D2I_ASN1_HEADER 145
1163 #define ASN1_F_D2I_ASN1_INTEGER 146
1164 #define ASN1_F_D2I_ASN1_OBJECT 147
1165 #define ASN1_F_D2I_ASN1_SET 148
1166 #define ASN1_F_D2I_ASN1_TYPE_BYTES 149
1167 #define ASN1_F_D2I_ASN1_UINTEGER 150
1168 #define ASN1_F_D2I_ASN1_UTCTIME 151
1169 #define ASN1_F_D2I_NETSCAPE_RSA 152
1170 #define ASN1_F_D2I_NETSCAPE_RSA_2 153
1171 #define ASN1_F_D2I_PRIVATEKEY 154
1172 #define ASN1_F_D2I_PUBLICKEY 155
1173 #define ASN1_F_D2I_RSA_NET 200
1174 #define ASN1_F_D2I_RSA_NET_2 201
1175 #define ASN1_F_D2I_X509 156
1176 #define ASN1_F_D2I_X509_CINF 157
1177 #define ASN1_F_D2I_X509_PKEY 159
1178 #define ASN1_F_I2D_ASN1_SET 188
1179 #define ASN1_F_I2D_ASN1_TIME 160
1180 #define ASN1_F_I2D_DSA_PUBKEY 161
1181 #define ASN1_F_I2D_EC_PUBKEY 181
1182 #define ASN1_F_I2D_PRIVATEKEY 163
1183 #define ASN1_F_I2D_PUBLICKEY 164
1184 #define ASN1_F_I2D_RSA_NET 162
1185 #define ASN1_F_I2D_RSA_PUBKEY 165
1186 #define ASN1_F_LONG_C2I 166
1187 #define ASN1_F_OID_MODULE_INIT 174
1188 #define ASN1_F_PARSE_TAGGING 182
1189 #define ASN1_F_PKCS5_PBE2_SET 167
1190 #define ASN1_F_PKCS5_PBE_SET 202
1191 #define ASN1_F_X509_CINF_NEW 168
1192 #define ASN1_F_X509_CRL_ADD0_REVOKED 169
1193 #define ASN1_F_X509_INFO_NEW 170
1194 #define ASN1_F_X509_NAME_ENCODE 203
1195 #define ASN1_F_X509_NAME_EX_D2I 158
1196 #define ASN1_F_X509_NAME_EX_NEW 171
1197 #define ASN1_F_X509_NEW 172
1198 #define ASN1_F_X509_PKEY_NEW 173
1201 #define ASN1_R_ADDING_OBJECT 171
1202 #define ASN1_R_AUX_ERROR 100
1203 #define ASN1_R_BAD_CLASS 101
1204 #define ASN1_R_BAD_OBJECT_HEADER 102
1205 #define ASN1_R_BAD_PASSWORD_READ 103
1206 #define ASN1_R_BAD_TAG 104
1207 #define ASN1_R_BN_LIB 105
1208 #define ASN1_R_BOOLEAN_IS_WRONG_LENGTH 106
1209 #define ASN1_R_BUFFER_TOO_SMALL 107
1210 #define ASN1_R_CIPHER_HAS_NO_OBJECT_IDENTIFIER 108
1211 #define ASN1_R_DATA_IS_WRONG 109
1212 #define ASN1_R_DECODE_ERROR 110
1213 #define ASN1_R_DECODING_ERROR 111
1214 #define ASN1_R_DEPTH_EXCEEDED 174
1215 #define ASN1_R_ENCODE_ERROR 112
1216 #define ASN1_R_ERROR_GETTING_TIME 173
1217 #define ASN1_R_ERROR_LOADING_SECTION 172
1218 #define ASN1_R_ERROR_PARSING_SET_ELEMENT 113
1219 #define ASN1_R_ERROR_SETTING_CIPHER_PARAMS 114
1220 #define ASN1_R_EXPECTING_AN_INTEGER 115
1221 #define ASN1_R_EXPECTING_AN_OBJECT 116
1222 #define ASN1_R_EXPECTING_A_BOOLEAN 117
1223 #define ASN1_R_EXPECTING_A_TIME 118
1224 #define ASN1_R_EXPLICIT_LENGTH_MISMATCH 119
1225 #define ASN1_R_EXPLICIT_TAG_NOT_CONSTRUCTED 120
1226 #define ASN1_R_FIELD_MISSING 121
1227 #define ASN1_R_FIRST_NUM_TOO_LARGE 122
1228 #define ASN1_R_HEADER_TOO_LONG 123
1229 #define ASN1_R_ILLEGAL_BITSTRING_FORMAT 175
1230 #define ASN1_R_ILLEGAL_BOOLEAN 176
1231 #define ASN1_R_ILLEGAL_CHARACTERS 124
1232 #define ASN1_R_ILLEGAL_FORMAT 177
1233 #define ASN1_R_ILLEGAL_HEX 178
1234 #define ASN1_R_ILLEGAL_IMPLICIT_TAG 179
1235 #define ASN1_R_ILLEGAL_INTEGER 180
1236 #define ASN1_R_ILLEGAL_NESTED_TAGGING 181
1237 #define ASN1_R_ILLEGAL_NULL 125
1238 #define ASN1_R_ILLEGAL_NULL_VALUE 182
1239 #define ASN1_R_ILLEGAL_OBJECT 183
1240 #define ASN1_R_ILLEGAL_OPTIONAL_ANY 126
1241 #define ASN1_R_ILLEGAL_OPTIONS_ON_ITEM_TEMPLATE 170
1242 #define ASN1_R_ILLEGAL_TAGGED_ANY 127
1243 #define ASN1_R_ILLEGAL_TIME_VALUE 184
1244 #define ASN1_R_INTEGER_NOT_ASCII_FORMAT 185
1245 #define ASN1_R_INTEGER_TOO_LARGE_FOR_LONG 128
1246 #define ASN1_R_INVALID_BMPSTRING_LENGTH 129
1247 #define ASN1_R_INVALID_DIGIT 130
1248 #define ASN1_R_INVALID_MODIFIER 186
1249 #define ASN1_R_INVALID_NUMBER 187
1250 #define ASN1_R_INVALID_SEPARATOR 131
1251 #define ASN1_R_INVALID_TIME_FORMAT 132
1252 #define ASN1_R_INVALID_UNIVERSALSTRING_LENGTH 133
1253 #define ASN1_R_INVALID_UTF8STRING 134
1254 #define ASN1_R_IV_TOO_LARGE 135
1255 #define ASN1_R_LENGTH_ERROR 136
1256 #define ASN1_R_LIST_ERROR 188
1257 #define ASN1_R_MISSING_EOC 137
1258 #define ASN1_R_MISSING_SECOND_NUMBER 138
1259 #define ASN1_R_MISSING_VALUE 189
1260 #define ASN1_R_MSTRING_NOT_UNIVERSAL 139
1261 #define ASN1_R_MSTRING_WRONG_TAG 140
1262 #define ASN1_R_NESTED_ASN1_STRING 197
1263 #define ASN1_R_NON_HEX_CHARACTERS 141
1264 #define ASN1_R_NOT_ASCII_FORMAT 190
1265 #define ASN1_R_NOT_ENOUGH_DATA 142
1266 #define ASN1_R_NO_MATCHING_CHOICE_TYPE 143
1267 #define ASN1_R_NULL_IS_WRONG_LENGTH 144
1268 #define ASN1_R_OBJECT_NOT_ASCII_FORMAT 191
1269 #define ASN1_R_ODD_NUMBER_OF_CHARS 145
1270 #define ASN1_R_PRIVATE_KEY_HEADER_MISSING 146
1271 #define ASN1_R_SECOND_NUMBER_TOO_LARGE 147
1272 #define ASN1_R_SEQUENCE_LENGTH_MISMATCH 148
1273 #define ASN1_R_SEQUENCE_NOT_CONSTRUCTED 149
1274 #define ASN1_R_SEQUENCE_OR_SET_NEEDS_CONFIG 192
1275 #define ASN1_R_SHORT_LINE 150
1276 #define ASN1_R_STRING_TOO_LONG 151
1277 #define ASN1_R_STRING_TOO_SHORT 152
1278 #define ASN1_R_TAG_VALUE_TOO_HIGH 153
1279 #define ASN1_R_THE_ASN1_OBJECT_IDENTIFIER_IS_NOT_KNOWN_FOR_THIS_MD 154
1280 #define ASN1_R_TIME_NOT_ASCII_FORMAT 193
1281 #define ASN1_R_TOO_LONG 155
1282 #define ASN1_R_TYPE_NOT_CONSTRUCTED 156
1283 #define ASN1_R_UNABLE_TO_DECODE_RSA_KEY 157
1284 #define ASN1_R_UNABLE_TO_DECODE_RSA_PRIVATE_KEY 158
1285 #define ASN1_R_UNEXPECTED_EOC 159
1286 #define ASN1_R_UNKNOWN_FORMAT 160
1287 #define ASN1_R_UNKNOWN_MESSAGE_DIGEST_ALGORITHM 161
1288 #define ASN1_R_UNKNOWN_OBJECT_TYPE 162
1289 #define ASN1_R_UNKNOWN_PUBLIC_KEY_TYPE 163
1290 #define ASN1_R_UNKNOWN_TAG 194
1291 #define ASN1_R_UNKOWN_FORMAT 195
1292 #define ASN1_R_UNSUPPORTED_ANY_DEFINED_BY_TYPE 164
1293 #define ASN1_R_UNSUPPORTED_CIPHER 165
1294 #define ASN1_R_UNSUPPORTED_ENCRYPTION_ALGORITHM 166
1295 #define ASN1_R_UNSUPPORTED_PUBLIC_KEY_TYPE 167
1296 #define ASN1_R_UNSUPPORTED_TYPE 196
1297 #define ASN1_R_WRONG_TAG 168
1298 #define ASN1_R_WRONG_TYPE 169