asn1.h revision e99801b603dea8893dcc61c70b327ef2d00b652c
1/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
2 * All rights reserved.
3 *
4 * This package is an SSL implementation written
5 * by Eric Young (eay@cryptsoft.com).
6 * The implementation was written so as to conform with Netscapes SSL.
7 *
8 * This library is free for commercial and non-commercial use as long as
9 * the following conditions are aheared to.  The following conditions
10 * apply to all code found in this distribution, be it the RC4, RSA,
11 * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
12 * included with this distribution is covered by the same copyright terms
13 * except that the holder is Tim Hudson (tjh@cryptsoft.com).
14 *
15 * Copyright remains Eric Young's, and as such any Copyright notices in
16 * the code are not to be removed.
17 * If this package is used in a product, Eric Young should be given attribution
18 * as the author of the parts of the library used.
19 * This can be in the form of a textual message at program startup or
20 * in documentation (online or textual) provided with the package.
21 *
22 * Redistribution and use in source and binary forms, with or without
23 * modification, are permitted provided that the following conditions
24 * are met:
25 * 1. Redistributions of source code must retain the copyright
26 *    notice, this list of conditions and the following disclaimer.
27 * 2. Redistributions in binary form must reproduce the above copyright
28 *    notice, this list of conditions and the following disclaimer in the
29 *    documentation and/or other materials provided with the distribution.
30 * 3. All advertising materials mentioning features or use of this software
31 *    must display the following acknowledgement:
32 *    "This product includes cryptographic software written by
33 *     Eric Young (eay@cryptsoft.com)"
34 *    The word 'cryptographic' can be left out if the rouines from the library
35 *    being used are not cryptographic related :-).
36 * 4. If you include any Windows specific code (or a derivative thereof) from
37 *    the apps directory (application code) you must include an acknowledgement:
38 *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
39 *
40 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
41 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
44 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
45 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
46 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
48 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
49 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
50 * SUCH DAMAGE.
51 *
52 * The licence and distribution terms for any publically available version or
53 * derivative of this code cannot be changed.  i.e. this code cannot simply be
54 * copied and put under another distribution licence
55 * [including the GNU Public Licence.]
56 */
57
58#ifndef HEADER_ASN1_H
59#define HEADER_ASN1_H
60
61#include <openssl/base.h>
62
63#include <time.h>
64
65#include <openssl/bio.h>
66#include <openssl/stack.h>
67
68#include <openssl/bn.h>
69
70#ifdef  __cplusplus
71extern "C" {
72#endif
73
74#define V_ASN1_UNIVERSAL		0x00
75#define	V_ASN1_APPLICATION		0x40
76#define V_ASN1_CONTEXT_SPECIFIC		0x80
77#define V_ASN1_PRIVATE			0xc0
78
79#define V_ASN1_CONSTRUCTED		0x20
80#define V_ASN1_PRIMITIVE_TAG		0x1f
81#define V_ASN1_PRIMATIVE_TAG		0x1f
82
83#define V_ASN1_APP_CHOOSE		-2	/* let the recipient choose */
84#define V_ASN1_OTHER			-3	/* used in ASN1_TYPE */
85#define V_ASN1_ANY			-4	/* used in ASN1 template code */
86
87#define V_ASN1_NEG			0x100	/* negative flag */
88
89#define V_ASN1_UNDEF			-1
90#define V_ASN1_EOC			0
91#define V_ASN1_BOOLEAN			1	/**/
92#define V_ASN1_INTEGER			2
93#define V_ASN1_NEG_INTEGER		(2 | V_ASN1_NEG)
94#define V_ASN1_BIT_STRING		3
95#define V_ASN1_OCTET_STRING		4
96#define V_ASN1_NULL			5
97#define V_ASN1_OBJECT			6
98#define V_ASN1_OBJECT_DESCRIPTOR	7
99#define V_ASN1_EXTERNAL			8
100#define V_ASN1_REAL			9
101#define V_ASN1_ENUMERATED		10
102#define V_ASN1_NEG_ENUMERATED		(10 | V_ASN1_NEG)
103#define V_ASN1_UTF8STRING		12
104#define V_ASN1_SEQUENCE			16
105#define V_ASN1_SET			17
106#define V_ASN1_NUMERICSTRING		18	/**/
107#define V_ASN1_PRINTABLESTRING		19
108#define V_ASN1_T61STRING		20
109#define V_ASN1_TELETEXSTRING		20	/* alias */
110#define V_ASN1_VIDEOTEXSTRING		21	/**/
111#define V_ASN1_IA5STRING		22
112#define V_ASN1_UTCTIME			23
113#define V_ASN1_GENERALIZEDTIME		24	/**/
114#define V_ASN1_GRAPHICSTRING		25	/**/
115#define V_ASN1_ISO64STRING		26	/**/
116#define V_ASN1_VISIBLESTRING		26	/* alias */
117#define V_ASN1_GENERALSTRING		27	/**/
118#define V_ASN1_UNIVERSALSTRING		28	/**/
119#define V_ASN1_BMPSTRING		30
120
121/* For use with d2i_ASN1_type_bytes() */
122#define B_ASN1_NUMERICSTRING	0x0001
123#define B_ASN1_PRINTABLESTRING	0x0002
124#define B_ASN1_T61STRING	0x0004
125#define B_ASN1_TELETEXSTRING	0x0004
126#define B_ASN1_VIDEOTEXSTRING	0x0008
127#define B_ASN1_IA5STRING	0x0010
128#define B_ASN1_GRAPHICSTRING	0x0020
129#define B_ASN1_ISO64STRING	0x0040
130#define B_ASN1_VISIBLESTRING	0x0040
131#define B_ASN1_GENERALSTRING	0x0080
132#define B_ASN1_UNIVERSALSTRING	0x0100
133#define B_ASN1_OCTET_STRING	0x0200
134#define B_ASN1_BIT_STRING	0x0400
135#define B_ASN1_BMPSTRING	0x0800
136#define B_ASN1_UNKNOWN		0x1000
137#define B_ASN1_UTF8STRING	0x2000
138#define B_ASN1_UTCTIME		0x4000
139#define B_ASN1_GENERALIZEDTIME	0x8000
140#define B_ASN1_SEQUENCE		0x10000
141
142/* For use with ASN1_mbstring_copy() */
143#define MBSTRING_FLAG		0x1000
144#define MBSTRING_UTF8		(MBSTRING_FLAG)
145#define MBSTRING_ASC		(MBSTRING_FLAG|1)
146#define MBSTRING_BMP		(MBSTRING_FLAG|2)
147#define MBSTRING_UNIV		(MBSTRING_FLAG|4)
148
149#define SMIME_OLDMIME		0x400
150#define SMIME_CRLFEOL		0x800
151#define SMIME_STREAM		0x1000
152
153#define DECLARE_ASN1_SET_OF(type) /* filled in by mkstack.pl */
154#define IMPLEMENT_ASN1_SET_OF(type) /* nothing, no longer needed */
155
156/* We MUST make sure that, except for constness, asn1_ctx_st and
157   asn1_const_ctx are exactly the same.  Fortunately, as soon as
158   the old ASN1 parsing macros are gone, we can throw this away
159   as well... */
160typedef struct asn1_ctx_st
161	{
162	unsigned char *p;/* work char pointer */
163	int eos;	/* end of sequence read for indefinite encoding */
164	int error;	/* error code to use when returning an error */
165	int inf;	/* constructed if 0x20, indefinite is 0x21 */
166	int tag;	/* tag from last 'get object' */
167	int xclass;	/* class from last 'get object' */
168	long slen;	/* length of last 'get object' */
169	unsigned char *max; /* largest value of p allowed */
170	unsigned char *q;/* temporary variable */
171	unsigned char **pp;/* variable */
172	int line;	/* used in error processing */
173	} ASN1_CTX;
174
175typedef struct asn1_const_ctx_st
176	{
177	const unsigned char *p;/* work char pointer */
178	int eos;	/* end of sequence read for indefinite encoding */
179	int error;	/* error code to use when returning an error */
180	int inf;	/* constructed if 0x20, indefinite is 0x21 */
181	int tag;	/* tag from last 'get object' */
182	int xclass;	/* class from last 'get object' */
183	long slen;	/* length of last 'get object' */
184	const unsigned char *max; /* largest value of p allowed */
185	const unsigned char *q;/* temporary variable */
186	const unsigned char **pp;/* variable */
187	int line;	/* used in error processing */
188	} ASN1_const_CTX;
189
190/* These are used internally in the ASN1_OBJECT to keep track of
191 * whether the names and data need to be free()ed */
192#define ASN1_OBJECT_FLAG_DYNAMIC	 0x01	/* internal use */
193#define ASN1_OBJECT_FLAG_CRITICAL	 0x02	/* critical x509v3 object id */
194#define ASN1_OBJECT_FLAG_DYNAMIC_STRINGS 0x04	/* internal use */
195#define ASN1_OBJECT_FLAG_DYNAMIC_DATA 	 0x08	/* internal use */
196struct asn1_object_st
197	{
198	const char *sn,*ln;
199	int nid;
200	int length;
201	const unsigned char *data;	/* data remains const after init */
202	int flags;	/* Should we free this one */
203	};
204
205#define ASN1_STRING_FLAG_BITS_LEFT 0x08 /* Set if 0x07 has bits left value */
206/* This indicates that the ASN1_STRING is not a real value but just a place
207 * holder for the location where indefinite length constructed data should
208 * be inserted in the memory buffer
209 */
210#define ASN1_STRING_FLAG_NDEF 0x010
211
212/* This flag is used by the CMS code to indicate that a string is not
213 * complete and is a place holder for content when it had all been
214 * accessed. The flag will be reset when content has been written to it.
215 */
216
217#define ASN1_STRING_FLAG_CONT 0x020
218/* This flag is used by ASN1 code to indicate an ASN1_STRING is an MSTRING
219 * type.
220 */
221#define ASN1_STRING_FLAG_MSTRING 0x040
222/* This is the base type that holds just about everything :-) */
223struct asn1_string_st
224	{
225	int length;
226	int type;
227	unsigned char *data;
228	/* The value of the following field depends on the type being
229	 * held.  It is mostly being used for BIT_STRING so if the
230	 * input data has a non-zero 'unused bits' value, it will be
231	 * handled correctly */
232	long flags;
233	};
234
235/* ASN1_ENCODING structure: this is used to save the received
236 * encoding of an ASN1 type. This is useful to get round
237 * problems with invalid encodings which can break signatures.
238 */
239
240typedef struct ASN1_ENCODING_st
241	{
242	unsigned char *enc;	/* DER encoding */
243	long len;		/* Length of encoding */
244	int modified;		 /* set to 1 if 'enc' is invalid */
245	} ASN1_ENCODING;
246
247/* Used with ASN1 LONG type: if a long is set to this it is omitted */
248#define ASN1_LONG_UNDEF	0x7fffffffL
249
250#define STABLE_FLAGS_MALLOC	0x01
251#define STABLE_NO_MASK		0x02
252#define DIRSTRING_TYPE	\
253 (B_ASN1_PRINTABLESTRING|B_ASN1_T61STRING|B_ASN1_BMPSTRING|B_ASN1_UTF8STRING)
254#define PKCS9STRING_TYPE (DIRSTRING_TYPE|B_ASN1_IA5STRING)
255
256typedef struct asn1_string_table_st {
257	int nid;
258	long minsize;
259	long maxsize;
260	unsigned long mask;
261	unsigned long flags;
262} ASN1_STRING_TABLE;
263
264/* size limits: this stuff is taken straight from RFC2459 */
265
266#define ub_name				32768
267#define ub_common_name			64
268#define ub_locality_name		128
269#define ub_state_name			128
270#define ub_organization_name		64
271#define ub_organization_unit_name	64
272#define ub_title			64
273#define ub_email_address		128
274
275/* Declarations for template structures: for full definitions
276 * see asn1t.h
277 */
278typedef struct ASN1_TEMPLATE_st ASN1_TEMPLATE;
279typedef struct ASN1_TLC_st ASN1_TLC;
280/* This is just an opaque pointer */
281typedef struct ASN1_VALUE_st ASN1_VALUE;
282
283/* Declare ASN1 functions: the implement macro in in asn1t.h */
284
285#define DECLARE_ASN1_FUNCTIONS(type) DECLARE_ASN1_FUNCTIONS_name(type, type)
286
287#define DECLARE_ASN1_ALLOC_FUNCTIONS(type) \
288	DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, type)
289
290#define DECLARE_ASN1_FUNCTIONS_name(type, name) \
291	DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \
292	DECLARE_ASN1_ENCODE_FUNCTIONS(type, name, name)
293
294#define DECLARE_ASN1_FUNCTIONS_fname(type, itname, name) \
295	DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \
296	DECLARE_ASN1_ENCODE_FUNCTIONS(type, itname, name)
297
298#define	DECLARE_ASN1_ENCODE_FUNCTIONS(type, itname, name) \
299	OPENSSL_EXPORT type *d2i_##name(type **a, const unsigned char **in, long len); \
300	OPENSSL_EXPORT int i2d_##name(type *a, unsigned char **out); \
301	DECLARE_ASN1_ITEM(itname)
302
303#define	DECLARE_ASN1_ENCODE_FUNCTIONS_const(type, name) \
304	OPENSSL_EXPORT type *d2i_##name(type **a, const unsigned char **in, long len); \
305	OPENSSL_EXPORT int i2d_##name(const type *a, unsigned char **out); \
306	DECLARE_ASN1_ITEM(name)
307
308#define	DECLARE_ASN1_NDEF_FUNCTION(name) \
309	OPENSSL_EXPORT int i2d_##name##_NDEF(name *a, unsigned char **out);
310
311#define DECLARE_ASN1_FUNCTIONS_const(name) \
312	DECLARE_ASN1_ALLOC_FUNCTIONS(name) \
313	DECLARE_ASN1_ENCODE_FUNCTIONS_const(name, name)
314
315#define DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \
316	OPENSSL_EXPORT type *name##_new(void); \
317	OPENSSL_EXPORT void name##_free(type *a);
318
319#define DECLARE_ASN1_PRINT_FUNCTION(stname) \
320	DECLARE_ASN1_PRINT_FUNCTION_fname(stname, stname)
321
322#define DECLARE_ASN1_PRINT_FUNCTION_fname(stname, fname) \
323	OPENSSL_EXPORT int fname##_print_ctx(BIO *out, stname *x, int indent, \
324					 const ASN1_PCTX *pctx);
325
326#define D2I_OF(type) type *(*)(type **,const unsigned char **,long)
327#define I2D_OF(type) int (*)(type *,unsigned char **)
328#define I2D_OF_const(type) int (*)(const type *,unsigned char **)
329
330#define CHECKED_D2I_OF(type, d2i) \
331    ((d2i_of_void*) (1 ? d2i : ((D2I_OF(type))0)))
332#define CHECKED_I2D_OF(type, i2d) \
333    ((i2d_of_void*) (1 ? i2d : ((I2D_OF(type))0)))
334#define CHECKED_NEW_OF(type, xnew) \
335    ((void *(*)(void)) (1 ? xnew : ((type *(*)(void))0)))
336#define CHECKED_PPTR_OF(type, p) \
337    ((void**) (1 ? p : (type**)0))
338
339#define TYPEDEF_D2I_OF(type) typedef type *d2i_of_##type(type **,const unsigned char **,long)
340#define TYPEDEF_I2D_OF(type) typedef int i2d_of_##type(const type *,unsigned char **)
341#define TYPEDEF_D2I2D_OF(type) TYPEDEF_D2I_OF(type); TYPEDEF_I2D_OF(type)
342
343TYPEDEF_D2I2D_OF(void);
344
345/* The following macros and typedefs allow an ASN1_ITEM
346 * to be embedded in a structure and referenced. Since
347 * the ASN1_ITEM pointers need to be globally accessible
348 * (possibly from shared libraries) they may exist in
349 * different forms. On platforms that support it the
350 * ASN1_ITEM structure itself will be globally exported.
351 * Other platforms will export a function that returns
352 * an ASN1_ITEM pointer.
353 *
354 * To handle both cases transparently the macros below
355 * should be used instead of hard coding an ASN1_ITEM
356 * pointer in a structure.
357 *
358 * The structure will look like this:
359 *
360 * typedef struct SOMETHING_st {
361 *      ...
362 *      ASN1_ITEM_EXP *iptr;
363 *      ...
364 * } SOMETHING;
365 *
366 * It would be initialised as e.g.:
367 *
368 * SOMETHING somevar = {...,ASN1_ITEM_ref(X509),...};
369 *
370 * and the actual pointer extracted with:
371 *
372 * const ASN1_ITEM *it = ASN1_ITEM_ptr(somevar.iptr);
373 *
374 * Finally an ASN1_ITEM pointer can be extracted from an
375 * appropriate reference with: ASN1_ITEM_rptr(X509). This
376 * would be used when a function takes an ASN1_ITEM * argument.
377 *
378 */
379
380/* ASN1_ITEM pointer exported type */
381typedef const ASN1_ITEM ASN1_ITEM_EXP;
382
383/* Macro to obtain ASN1_ITEM pointer from exported type */
384#define ASN1_ITEM_ptr(iptr) (iptr)
385
386/* Macro to include ASN1_ITEM pointer from base type */
387#define ASN1_ITEM_ref(iptr) (&(iptr##_it))
388
389#define ASN1_ITEM_rptr(ref) (&(ref##_it))
390
391#define DECLARE_ASN1_ITEM(name) \
392	extern OPENSSL_EXPORT const ASN1_ITEM name##_it;
393
394/* Parameters used by ASN1_STRING_print_ex() */
395
396/* These determine which characters to escape:
397 * RFC2253 special characters, control characters and
398 * MSB set characters
399 */
400
401#define ASN1_STRFLGS_ESC_2253		1
402#define ASN1_STRFLGS_ESC_CTRL		2
403#define ASN1_STRFLGS_ESC_MSB		4
404
405
406/* This flag determines how we do escaping: normally
407 * RC2253 backslash only, set this to use backslash and
408 * quote.
409 */
410
411#define ASN1_STRFLGS_ESC_QUOTE		8
412
413
414/* These three flags are internal use only. */
415
416/* Character is a valid PrintableString character */
417#define CHARTYPE_PRINTABLESTRING	0x10
418/* Character needs escaping if it is the first character */
419#define CHARTYPE_FIRST_ESC_2253		0x20
420/* Character needs escaping if it is the last character */
421#define CHARTYPE_LAST_ESC_2253		0x40
422
423/* NB the internal flags are safely reused below by flags
424 * handled at the top level.
425 */
426
427/* If this is set we convert all character strings
428 * to UTF8 first
429 */
430
431#define ASN1_STRFLGS_UTF8_CONVERT	0x10
432
433/* If this is set we don't attempt to interpret content:
434 * just assume all strings are 1 byte per character. This
435 * will produce some pretty odd looking output!
436 */
437
438#define ASN1_STRFLGS_IGNORE_TYPE	0x20
439
440/* If this is set we include the string type in the output */
441#define ASN1_STRFLGS_SHOW_TYPE		0x40
442
443/* This determines which strings to display and which to
444 * 'dump' (hex dump of content octets or DER encoding). We can
445 * only dump non character strings or everything. If we
446 * don't dump 'unknown' they are interpreted as character
447 * strings with 1 octet per character and are subject to
448 * the usual escaping options.
449 */
450
451#define ASN1_STRFLGS_DUMP_ALL		0x80
452#define ASN1_STRFLGS_DUMP_UNKNOWN	0x100
453
454/* These determine what 'dumping' does, we can dump the
455 * content octets or the DER encoding: both use the
456 * RFC2253 #XXXXX notation.
457 */
458
459#define ASN1_STRFLGS_DUMP_DER		0x200
460
461/* All the string flags consistent with RFC2253,
462 * escaping control characters isn't essential in
463 * RFC2253 but it is advisable anyway.
464 */
465
466#define ASN1_STRFLGS_RFC2253	(ASN1_STRFLGS_ESC_2253 | \
467				ASN1_STRFLGS_ESC_CTRL | \
468				ASN1_STRFLGS_ESC_MSB | \
469				ASN1_STRFLGS_UTF8_CONVERT | \
470				ASN1_STRFLGS_DUMP_UNKNOWN | \
471				ASN1_STRFLGS_DUMP_DER)
472
473DECLARE_ASN1_SET_OF(ASN1_INTEGER)
474
475typedef struct asn1_type_st
476	{
477	int type;
478	union	{
479		char *ptr;
480		ASN1_BOOLEAN		boolean;
481		ASN1_STRING *		asn1_string;
482		ASN1_OBJECT *		object;
483		ASN1_INTEGER *		integer;
484		ASN1_ENUMERATED *	enumerated;
485		ASN1_BIT_STRING *	bit_string;
486		ASN1_OCTET_STRING *	octet_string;
487		ASN1_PRINTABLESTRING *	printablestring;
488		ASN1_T61STRING *	t61string;
489		ASN1_IA5STRING *	ia5string;
490		ASN1_GENERALSTRING *	generalstring;
491		ASN1_BMPSTRING *	bmpstring;
492		ASN1_UNIVERSALSTRING *	universalstring;
493		ASN1_UTCTIME *		utctime;
494		ASN1_GENERALIZEDTIME *	generalizedtime;
495		ASN1_VISIBLESTRING *	visiblestring;
496		ASN1_UTF8STRING *	utf8string;
497		/* set and sequence are left complete and still
498		 * contain the set or sequence bytes */
499		ASN1_STRING *		set;
500		ASN1_STRING *		sequence;
501		ASN1_VALUE *		asn1_value;
502		} value;
503	} ASN1_TYPE;
504
505DECLARE_ASN1_SET_OF(ASN1_TYPE)
506
507typedef STACK_OF(ASN1_TYPE) ASN1_SEQUENCE_ANY;
508
509DECLARE_ASN1_ENCODE_FUNCTIONS_const(ASN1_SEQUENCE_ANY, ASN1_SEQUENCE_ANY)
510DECLARE_ASN1_ENCODE_FUNCTIONS_const(ASN1_SEQUENCE_ANY, ASN1_SET_ANY)
511
512struct X509_algor_st
513       {
514       ASN1_OBJECT *algorithm;
515       ASN1_TYPE *parameter;
516       } /* X509_ALGOR */;
517
518DECLARE_ASN1_FUNCTIONS(X509_ALGOR)
519
520typedef struct NETSCAPE_X509_st
521	{
522	ASN1_OCTET_STRING *header;
523	X509 *cert;
524	} NETSCAPE_X509;
525
526/* This is used to contain a list of bit names */
527typedef struct BIT_STRING_BITNAME_st {
528	int bitnum;
529	const char *lname;
530	const char *sname;
531} BIT_STRING_BITNAME;
532
533
534#define M_ASN1_STRING_length(x)	((x)->length)
535#define M_ASN1_STRING_length_set(x, n)	((x)->length = (n))
536#define M_ASN1_STRING_type(x)	((x)->type)
537#define M_ASN1_STRING_data(x)	((x)->data)
538
539/* Macros for string operations */
540#define M_ASN1_BIT_STRING_new()	(ASN1_BIT_STRING *)\
541		ASN1_STRING_type_new(V_ASN1_BIT_STRING)
542#define M_ASN1_BIT_STRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
543#define M_ASN1_BIT_STRING_dup(a) (ASN1_BIT_STRING *)\
544		ASN1_STRING_dup((const ASN1_STRING *)a)
545#define M_ASN1_BIT_STRING_cmp(a,b) ASN1_STRING_cmp(\
546		(const ASN1_STRING *)a,(const ASN1_STRING *)b)
547#define M_ASN1_BIT_STRING_set(a,b,c) ASN1_STRING_set((ASN1_STRING *)a,b,c)
548
549#define M_ASN1_INTEGER_new()	(ASN1_INTEGER *)\
550		ASN1_STRING_type_new(V_ASN1_INTEGER)
551#define M_ASN1_INTEGER_free(a)		ASN1_STRING_free((ASN1_STRING *)a)
552#define M_ASN1_INTEGER_dup(a) (ASN1_INTEGER *)\
553		ASN1_STRING_dup((const ASN1_STRING *)a)
554#define M_ASN1_INTEGER_cmp(a,b)	ASN1_STRING_cmp(\
555		(const ASN1_STRING *)a,(const ASN1_STRING *)b)
556
557#define M_ASN1_ENUMERATED_new()	(ASN1_ENUMERATED *)\
558		ASN1_STRING_type_new(V_ASN1_ENUMERATED)
559#define M_ASN1_ENUMERATED_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
560#define M_ASN1_ENUMERATED_dup(a) (ASN1_ENUMERATED *)\
561		ASN1_STRING_dup((const ASN1_STRING *)a)
562#define M_ASN1_ENUMERATED_cmp(a,b)	ASN1_STRING_cmp(\
563		(const ASN1_STRING *)a,(const ASN1_STRING *)b)
564
565#define M_ASN1_OCTET_STRING_new()	(ASN1_OCTET_STRING *)\
566		ASN1_STRING_type_new(V_ASN1_OCTET_STRING)
567#define M_ASN1_OCTET_STRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
568#define M_ASN1_OCTET_STRING_dup(a) (ASN1_OCTET_STRING *)\
569		ASN1_STRING_dup((const ASN1_STRING *)a)
570#define M_ASN1_OCTET_STRING_cmp(a,b) ASN1_STRING_cmp(\
571		(const ASN1_STRING *)a,(const ASN1_STRING *)b)
572#define M_ASN1_OCTET_STRING_set(a,b,c)	ASN1_STRING_set((ASN1_STRING *)a,b,c)
573#define M_ASN1_OCTET_STRING_print(a,b)	ASN1_STRING_print(a,(ASN1_STRING *)b)
574#define M_i2d_ASN1_OCTET_STRING(a,pp) \
575		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_OCTET_STRING,\
576		V_ASN1_UNIVERSAL)
577
578#define B_ASN1_TIME \
579			B_ASN1_UTCTIME | \
580			B_ASN1_GENERALIZEDTIME
581
582#define B_ASN1_PRINTABLE \
583			B_ASN1_NUMERICSTRING| \
584			B_ASN1_PRINTABLESTRING| \
585			B_ASN1_T61STRING| \
586			B_ASN1_IA5STRING| \
587			B_ASN1_BIT_STRING| \
588			B_ASN1_UNIVERSALSTRING|\
589			B_ASN1_BMPSTRING|\
590			B_ASN1_UTF8STRING|\
591			B_ASN1_SEQUENCE|\
592			B_ASN1_UNKNOWN
593
594#define B_ASN1_DIRECTORYSTRING \
595			B_ASN1_PRINTABLESTRING| \
596			B_ASN1_TELETEXSTRING|\
597			B_ASN1_BMPSTRING|\
598			B_ASN1_UNIVERSALSTRING|\
599			B_ASN1_UTF8STRING
600
601#define B_ASN1_DISPLAYTEXT \
602			B_ASN1_IA5STRING| \
603			B_ASN1_VISIBLESTRING| \
604			B_ASN1_BMPSTRING|\
605			B_ASN1_UTF8STRING
606
607#define M_ASN1_PRINTABLE_new()	ASN1_STRING_type_new(V_ASN1_T61STRING)
608#define M_ASN1_PRINTABLE_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
609#define M_i2d_ASN1_PRINTABLE(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\
610		pp,a->type,V_ASN1_UNIVERSAL)
611#define M_d2i_ASN1_PRINTABLE(a,pp,l) \
612		d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \
613			B_ASN1_PRINTABLE)
614
615#define M_DIRECTORYSTRING_new() ASN1_STRING_type_new(V_ASN1_PRINTABLESTRING)
616#define M_DIRECTORYSTRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
617#define M_i2d_DIRECTORYSTRING(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\
618						pp,a->type,V_ASN1_UNIVERSAL)
619#define M_d2i_DIRECTORYSTRING(a,pp,l) \
620		d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \
621			B_ASN1_DIRECTORYSTRING)
622
623#define M_DISPLAYTEXT_new() ASN1_STRING_type_new(V_ASN1_VISIBLESTRING)
624#define M_DISPLAYTEXT_free(a) ASN1_STRING_free((ASN1_STRING *)a)
625#define M_i2d_DISPLAYTEXT(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\
626						pp,a->type,V_ASN1_UNIVERSAL)
627#define M_d2i_DISPLAYTEXT(a,pp,l) \
628		d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \
629			B_ASN1_DISPLAYTEXT)
630
631#define M_ASN1_PRINTABLESTRING_new() (ASN1_PRINTABLESTRING *)\
632		ASN1_STRING_type_new(V_ASN1_PRINTABLESTRING)
633#define M_ASN1_PRINTABLESTRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
634#define M_i2d_ASN1_PRINTABLESTRING(a,pp) \
635		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_PRINTABLESTRING,\
636		V_ASN1_UNIVERSAL)
637#define M_d2i_ASN1_PRINTABLESTRING(a,pp,l) \
638		(ASN1_PRINTABLESTRING *)d2i_ASN1_type_bytes\
639		((ASN1_STRING **)a,pp,l,B_ASN1_PRINTABLESTRING)
640
641#define M_ASN1_T61STRING_new()	(ASN1_T61STRING *)\
642		ASN1_STRING_type_new(V_ASN1_T61STRING)
643#define M_ASN1_T61STRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
644#define M_i2d_ASN1_T61STRING(a,pp) \
645		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_T61STRING,\
646		V_ASN1_UNIVERSAL)
647#define M_d2i_ASN1_T61STRING(a,pp,l) \
648		(ASN1_T61STRING *)d2i_ASN1_type_bytes\
649		((ASN1_STRING **)a,pp,l,B_ASN1_T61STRING)
650
651#define M_ASN1_IA5STRING_new()	(ASN1_IA5STRING *)\
652		ASN1_STRING_type_new(V_ASN1_IA5STRING)
653#define M_ASN1_IA5STRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
654#define M_ASN1_IA5STRING_dup(a)	\
655		(ASN1_IA5STRING *)ASN1_STRING_dup((const ASN1_STRING *)a)
656#define M_i2d_ASN1_IA5STRING(a,pp) \
657		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_IA5STRING,\
658			V_ASN1_UNIVERSAL)
659#define M_d2i_ASN1_IA5STRING(a,pp,l) \
660		(ASN1_IA5STRING *)d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l,\
661			B_ASN1_IA5STRING)
662
663#define M_ASN1_UTCTIME_new()	(ASN1_UTCTIME *)\
664		ASN1_STRING_type_new(V_ASN1_UTCTIME)
665#define M_ASN1_UTCTIME_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
666#define M_ASN1_UTCTIME_dup(a) (ASN1_UTCTIME *)\
667		ASN1_STRING_dup((const ASN1_STRING *)a)
668
669#define M_ASN1_GENERALIZEDTIME_new()	(ASN1_GENERALIZEDTIME *)\
670		ASN1_STRING_type_new(V_ASN1_GENERALIZEDTIME)
671#define M_ASN1_GENERALIZEDTIME_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
672#define M_ASN1_GENERALIZEDTIME_dup(a) (ASN1_GENERALIZEDTIME *)ASN1_STRING_dup(\
673	(const ASN1_STRING *)a)
674
675#define M_ASN1_TIME_new()	(ASN1_TIME *)\
676		ASN1_STRING_type_new(V_ASN1_UTCTIME)
677#define M_ASN1_TIME_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
678#define M_ASN1_TIME_dup(a) (ASN1_TIME *)\
679	ASN1_STRING_dup((const ASN1_STRING *)a)
680
681#define M_ASN1_GENERALSTRING_new()	(ASN1_GENERALSTRING *)\
682		ASN1_STRING_type_new(V_ASN1_GENERALSTRING)
683#define M_ASN1_GENERALSTRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
684#define M_i2d_ASN1_GENERALSTRING(a,pp) \
685		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_GENERALSTRING,\
686			V_ASN1_UNIVERSAL)
687#define M_d2i_ASN1_GENERALSTRING(a,pp,l) \
688		(ASN1_GENERALSTRING *)d2i_ASN1_type_bytes\
689		((ASN1_STRING **)a,pp,l,B_ASN1_GENERALSTRING)
690
691#define M_ASN1_UNIVERSALSTRING_new()	(ASN1_UNIVERSALSTRING *)\
692		ASN1_STRING_type_new(V_ASN1_UNIVERSALSTRING)
693#define M_ASN1_UNIVERSALSTRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
694#define M_i2d_ASN1_UNIVERSALSTRING(a,pp) \
695		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_UNIVERSALSTRING,\
696			V_ASN1_UNIVERSAL)
697#define M_d2i_ASN1_UNIVERSALSTRING(a,pp,l) \
698		(ASN1_UNIVERSALSTRING *)d2i_ASN1_type_bytes\
699		((ASN1_STRING **)a,pp,l,B_ASN1_UNIVERSALSTRING)
700
701#define M_ASN1_BMPSTRING_new()	(ASN1_BMPSTRING *)\
702		ASN1_STRING_type_new(V_ASN1_BMPSTRING)
703#define M_ASN1_BMPSTRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
704#define M_i2d_ASN1_BMPSTRING(a,pp) \
705		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_BMPSTRING,\
706			V_ASN1_UNIVERSAL)
707#define M_d2i_ASN1_BMPSTRING(a,pp,l) \
708		(ASN1_BMPSTRING *)d2i_ASN1_type_bytes\
709		((ASN1_STRING **)a,pp,l,B_ASN1_BMPSTRING)
710
711#define M_ASN1_VISIBLESTRING_new()	(ASN1_VISIBLESTRING *)\
712		ASN1_STRING_type_new(V_ASN1_VISIBLESTRING)
713#define M_ASN1_VISIBLESTRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
714#define M_i2d_ASN1_VISIBLESTRING(a,pp) \
715		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_VISIBLESTRING,\
716			V_ASN1_UNIVERSAL)
717#define M_d2i_ASN1_VISIBLESTRING(a,pp,l) \
718		(ASN1_VISIBLESTRING *)d2i_ASN1_type_bytes\
719		((ASN1_STRING **)a,pp,l,B_ASN1_VISIBLESTRING)
720
721#define M_ASN1_UTF8STRING_new()	(ASN1_UTF8STRING *)\
722		ASN1_STRING_type_new(V_ASN1_UTF8STRING)
723#define M_ASN1_UTF8STRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
724#define M_i2d_ASN1_UTF8STRING(a,pp) \
725		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_UTF8STRING,\
726			V_ASN1_UNIVERSAL)
727#define M_d2i_ASN1_UTF8STRING(a,pp,l) \
728		(ASN1_UTF8STRING *)d2i_ASN1_type_bytes\
729		((ASN1_STRING **)a,pp,l,B_ASN1_UTF8STRING)
730
731  /* for the is_set parameter to i2d_ASN1_SET */
732#define IS_SEQUENCE	0
733#define IS_SET		1
734
735DECLARE_ASN1_FUNCTIONS_fname(ASN1_TYPE, ASN1_ANY, ASN1_TYPE)
736
737OPENSSL_EXPORT int ASN1_TYPE_get(ASN1_TYPE *a);
738OPENSSL_EXPORT void ASN1_TYPE_set(ASN1_TYPE *a, int type, void *value);
739OPENSSL_EXPORT int ASN1_TYPE_set1(ASN1_TYPE *a, int type, const void *value);
740OPENSSL_EXPORT int ASN1_TYPE_cmp(const ASN1_TYPE *a, const ASN1_TYPE *b);
741
742OPENSSL_EXPORT ASN1_OBJECT *	ASN1_OBJECT_new(void );
743OPENSSL_EXPORT void		ASN1_OBJECT_free(ASN1_OBJECT *a);
744OPENSSL_EXPORT int		i2d_ASN1_OBJECT(ASN1_OBJECT *a,unsigned char **pp);
745OPENSSL_EXPORT ASN1_OBJECT *	c2i_ASN1_OBJECT(ASN1_OBJECT **a,const unsigned char **pp,
746						long length);
747OPENSSL_EXPORT ASN1_OBJECT *	d2i_ASN1_OBJECT(ASN1_OBJECT **a,const unsigned char **pp,
748						long length);
749
750DECLARE_ASN1_ITEM(ASN1_OBJECT)
751
752DECLARE_ASN1_SET_OF(ASN1_OBJECT)
753
754OPENSSL_EXPORT ASN1_STRING *	ASN1_STRING_new(void);
755OPENSSL_EXPORT void		ASN1_STRING_free(ASN1_STRING *a);
756OPENSSL_EXPORT int		ASN1_STRING_copy(ASN1_STRING *dst, const ASN1_STRING *str);
757OPENSSL_EXPORT ASN1_STRING *	ASN1_STRING_dup(const ASN1_STRING *a);
758OPENSSL_EXPORT ASN1_STRING *	ASN1_STRING_type_new(int type );
759OPENSSL_EXPORT int 		ASN1_STRING_cmp(const ASN1_STRING *a, const ASN1_STRING *b);
760  /* Since this is used to store all sorts of things, via macros, for now, make
761     its data void * */
762OPENSSL_EXPORT int 		ASN1_STRING_set(ASN1_STRING *str, const void *data, int len);
763OPENSSL_EXPORT void		ASN1_STRING_set0(ASN1_STRING *str, void *data, int len);
764OPENSSL_EXPORT int ASN1_STRING_length(const ASN1_STRING *x);
765OPENSSL_EXPORT void ASN1_STRING_length_set(ASN1_STRING *x, int n);
766OPENSSL_EXPORT int ASN1_STRING_type(ASN1_STRING *x);
767OPENSSL_EXPORT unsigned char * ASN1_STRING_data(ASN1_STRING *x);
768
769DECLARE_ASN1_FUNCTIONS(ASN1_BIT_STRING)
770OPENSSL_EXPORT int		i2c_ASN1_BIT_STRING(ASN1_BIT_STRING *a,unsigned char **pp);
771OPENSSL_EXPORT ASN1_BIT_STRING *c2i_ASN1_BIT_STRING(ASN1_BIT_STRING **a,const unsigned char **pp, long length);
772OPENSSL_EXPORT int		ASN1_BIT_STRING_set(ASN1_BIT_STRING *a, unsigned char *d, int length );
773OPENSSL_EXPORT int		ASN1_BIT_STRING_set_bit(ASN1_BIT_STRING *a, int n, int value);
774OPENSSL_EXPORT int		ASN1_BIT_STRING_get_bit(ASN1_BIT_STRING *a, int n);
775OPENSSL_EXPORT int            ASN1_BIT_STRING_check(ASN1_BIT_STRING *a, unsigned char *flags, int flags_len);
776
777OPENSSL_EXPORT int ASN1_BIT_STRING_name_print(BIO *out, ASN1_BIT_STRING *bs, BIT_STRING_BITNAME *tbl, int indent);
778OPENSSL_EXPORT int ASN1_BIT_STRING_num_asc(char *name, BIT_STRING_BITNAME *tbl);
779OPENSSL_EXPORT int ASN1_BIT_STRING_set_asc(ASN1_BIT_STRING *bs, char *name, int value, BIT_STRING_BITNAME *tbl);
780
781OPENSSL_EXPORT int		i2d_ASN1_BOOLEAN(int a,unsigned char **pp);
782OPENSSL_EXPORT int 		d2i_ASN1_BOOLEAN(int *a,const unsigned char **pp,long length);
783
784DECLARE_ASN1_FUNCTIONS(ASN1_INTEGER)
785OPENSSL_EXPORT int		i2c_ASN1_INTEGER(ASN1_INTEGER *a,unsigned char **pp);
786OPENSSL_EXPORT ASN1_INTEGER *c2i_ASN1_INTEGER(ASN1_INTEGER **a,const unsigned char **pp, long length);
787OPENSSL_EXPORT ASN1_INTEGER *d2i_ASN1_UINTEGER(ASN1_INTEGER **a,const unsigned char **pp, long length);
788OPENSSL_EXPORT ASN1_INTEGER *	ASN1_INTEGER_dup(const ASN1_INTEGER *x);
789OPENSSL_EXPORT int ASN1_INTEGER_cmp(const ASN1_INTEGER *x, const ASN1_INTEGER *y);
790
791DECLARE_ASN1_FUNCTIONS(ASN1_ENUMERATED)
792
793OPENSSL_EXPORT int ASN1_UTCTIME_check(const ASN1_UTCTIME *a);
794OPENSSL_EXPORT ASN1_UTCTIME *ASN1_UTCTIME_set(ASN1_UTCTIME *s,time_t t);
795OPENSSL_EXPORT ASN1_UTCTIME *ASN1_UTCTIME_adj(ASN1_UTCTIME *s, time_t t, int offset_day, long offset_sec);
796OPENSSL_EXPORT int ASN1_UTCTIME_set_string(ASN1_UTCTIME *s, const char *str);
797OPENSSL_EXPORT int ASN1_UTCTIME_cmp_time_t(const ASN1_UTCTIME *s, time_t t);
798#if 0
799time_t ASN1_UTCTIME_get(const ASN1_UTCTIME *s);
800#endif
801
802OPENSSL_EXPORT int ASN1_GENERALIZEDTIME_check(const ASN1_GENERALIZEDTIME *a);
803OPENSSL_EXPORT ASN1_GENERALIZEDTIME *ASN1_GENERALIZEDTIME_set(ASN1_GENERALIZEDTIME *s,time_t t);
804OPENSSL_EXPORT ASN1_GENERALIZEDTIME *ASN1_GENERALIZEDTIME_adj(ASN1_GENERALIZEDTIME *s, time_t t, int offset_day, long offset_sec);
805OPENSSL_EXPORT int ASN1_GENERALIZEDTIME_set_string(ASN1_GENERALIZEDTIME *s, const char *str);
806OPENSSL_EXPORT int ASN1_TIME_diff(int *pday, int *psec, const ASN1_TIME *from, const ASN1_TIME *to);
807
808DECLARE_ASN1_FUNCTIONS(ASN1_OCTET_STRING)
809OPENSSL_EXPORT ASN1_OCTET_STRING *	ASN1_OCTET_STRING_dup(const ASN1_OCTET_STRING *a);
810OPENSSL_EXPORT int 	ASN1_OCTET_STRING_cmp(const ASN1_OCTET_STRING *a, const ASN1_OCTET_STRING *b);
811OPENSSL_EXPORT int 	ASN1_OCTET_STRING_set(ASN1_OCTET_STRING *str, const unsigned char *data, int len);
812
813DECLARE_ASN1_FUNCTIONS(ASN1_VISIBLESTRING)
814DECLARE_ASN1_FUNCTIONS(ASN1_UNIVERSALSTRING)
815DECLARE_ASN1_FUNCTIONS(ASN1_UTF8STRING)
816DECLARE_ASN1_FUNCTIONS(ASN1_NULL)
817DECLARE_ASN1_FUNCTIONS(ASN1_BMPSTRING)
818
819OPENSSL_EXPORT int UTF8_getc(const unsigned char *str, int len, unsigned long *val);
820OPENSSL_EXPORT int UTF8_putc(unsigned char *str, int len, unsigned long value);
821
822DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, ASN1_PRINTABLE)
823
824DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, DIRECTORYSTRING)
825DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, DISPLAYTEXT)
826DECLARE_ASN1_FUNCTIONS(ASN1_PRINTABLESTRING)
827DECLARE_ASN1_FUNCTIONS(ASN1_T61STRING)
828DECLARE_ASN1_FUNCTIONS(ASN1_IA5STRING)
829DECLARE_ASN1_FUNCTIONS(ASN1_GENERALSTRING)
830DECLARE_ASN1_FUNCTIONS(ASN1_UTCTIME)
831DECLARE_ASN1_FUNCTIONS(ASN1_GENERALIZEDTIME)
832DECLARE_ASN1_FUNCTIONS(ASN1_TIME)
833
834DECLARE_ASN1_ITEM(ASN1_OCTET_STRING_NDEF)
835
836OPENSSL_EXPORT ASN1_TIME *ASN1_TIME_set(ASN1_TIME *s,time_t t);
837OPENSSL_EXPORT ASN1_TIME *ASN1_TIME_adj(ASN1_TIME *s,time_t t, int offset_day, long offset_sec);
838OPENSSL_EXPORT int ASN1_TIME_check(ASN1_TIME *t);
839OPENSSL_EXPORT ASN1_GENERALIZEDTIME *ASN1_TIME_to_generalizedtime(ASN1_TIME *t, ASN1_GENERALIZEDTIME **out);
840OPENSSL_EXPORT int ASN1_TIME_set_string(ASN1_TIME *s, const char *str);
841
842OPENSSL_EXPORT int i2d_ASN1_SET(STACK_OF(OPENSSL_BLOCK) *a, unsigned char **pp, i2d_of_void *i2d, int ex_tag, int ex_class, int is_set);
843OPENSSL_EXPORT STACK_OF(OPENSSL_BLOCK) *d2i_ASN1_SET(STACK_OF(OPENSSL_BLOCK) **a,
844			      const unsigned char **pp,
845			      long length, d2i_of_void *d2i,
846			      void (*free_func)(OPENSSL_BLOCK), int ex_tag,
847			      int ex_class);
848
849OPENSSL_EXPORT int i2a_ASN1_INTEGER(BIO *bp, ASN1_INTEGER *a);
850OPENSSL_EXPORT int a2i_ASN1_INTEGER(BIO *bp,ASN1_INTEGER *bs,char *buf,int size);
851OPENSSL_EXPORT int i2a_ASN1_ENUMERATED(BIO *bp, ASN1_ENUMERATED *a);
852OPENSSL_EXPORT int a2i_ASN1_ENUMERATED(BIO *bp,ASN1_ENUMERATED *bs,char *buf,int size);
853OPENSSL_EXPORT int i2a_ASN1_OBJECT(BIO *bp,ASN1_OBJECT *a);
854OPENSSL_EXPORT int a2i_ASN1_STRING(BIO *bp,ASN1_STRING *bs,char *buf,int size);
855OPENSSL_EXPORT int i2a_ASN1_STRING(BIO *bp, ASN1_STRING *a, int type);
856OPENSSL_EXPORT int i2t_ASN1_OBJECT(char *buf,int buf_len,ASN1_OBJECT *a);
857
858OPENSSL_EXPORT int a2d_ASN1_OBJECT(unsigned char *out,int olen, const char *buf, int num);
859OPENSSL_EXPORT ASN1_OBJECT *ASN1_OBJECT_create(int nid, unsigned char *data,int len, const char *sn, const char *ln);
860
861OPENSSL_EXPORT int ASN1_INTEGER_set(ASN1_INTEGER *a, long v);
862OPENSSL_EXPORT long ASN1_INTEGER_get(const ASN1_INTEGER *a);
863OPENSSL_EXPORT ASN1_INTEGER *BN_to_ASN1_INTEGER(const BIGNUM *bn, ASN1_INTEGER *ai);
864OPENSSL_EXPORT BIGNUM *ASN1_INTEGER_to_BN(const ASN1_INTEGER *ai,BIGNUM *bn);
865
866OPENSSL_EXPORT int ASN1_ENUMERATED_set(ASN1_ENUMERATED *a, long v);
867OPENSSL_EXPORT long ASN1_ENUMERATED_get(ASN1_ENUMERATED *a);
868OPENSSL_EXPORT ASN1_ENUMERATED *BN_to_ASN1_ENUMERATED(BIGNUM *bn, ASN1_ENUMERATED *ai);
869OPENSSL_EXPORT BIGNUM *ASN1_ENUMERATED_to_BN(ASN1_ENUMERATED *ai,BIGNUM *bn);
870
871/* General */
872/* given a string, return the correct type, max is the maximum length */
873OPENSSL_EXPORT int ASN1_PRINTABLE_type(const unsigned char *s, int max);
874
875OPENSSL_EXPORT int i2d_ASN1_bytes(ASN1_STRING *a, unsigned char **pp, int tag, int xclass);
876OPENSSL_EXPORT ASN1_STRING *d2i_ASN1_bytes(ASN1_STRING **a, const unsigned char **pp, long length, int Ptag, int Pclass);
877OPENSSL_EXPORT unsigned long ASN1_tag2bit(int tag);
878/* type is one or more of the B_ASN1_ values. */
879OPENSSL_EXPORT ASN1_STRING *d2i_ASN1_type_bytes(ASN1_STRING **a,const unsigned char **pp, long length,int type);
880
881/* PARSING */
882OPENSSL_EXPORT int asn1_Finish(ASN1_CTX *c);
883OPENSSL_EXPORT int asn1_const_Finish(ASN1_const_CTX *c);
884
885/* SPECIALS */
886OPENSSL_EXPORT int ASN1_get_object(const unsigned char **pp, long *plength, int *ptag, int *pclass, long omax);
887OPENSSL_EXPORT int ASN1_check_infinite_end(unsigned char **p,long len);
888OPENSSL_EXPORT int ASN1_const_check_infinite_end(const unsigned char **p,long len);
889OPENSSL_EXPORT void ASN1_put_object(unsigned char **pp, int constructed, int length, int tag, int xclass);
890OPENSSL_EXPORT int ASN1_put_eoc(unsigned char **pp);
891OPENSSL_EXPORT int ASN1_object_size(int constructed, int length, int tag);
892
893/* Used to implement other functions */
894OPENSSL_EXPORT void *ASN1_dup(i2d_of_void *i2d, d2i_of_void *d2i, void *x);
895
896#define ASN1_dup_of(type,i2d,d2i,x) \
897    ((type*)ASN1_dup(CHECKED_I2D_OF(type, i2d), \
898		     CHECKED_D2I_OF(type, d2i), \
899		     CHECKED_PTR_OF(type, x)))
900
901#define ASN1_dup_of_const(type,i2d,d2i,x) \
902    ((type*)ASN1_dup(CHECKED_I2D_OF(const type, i2d), \
903		     CHECKED_D2I_OF(type, d2i), \
904		     CHECKED_PTR_OF(const type, x)))
905
906OPENSSL_EXPORT void *ASN1_item_dup(const ASN1_ITEM *it, void *x);
907
908/* ASN1 alloc/free macros for when a type is only used internally */
909
910#define M_ASN1_new_of(type) (type *)ASN1_item_new(ASN1_ITEM_rptr(type))
911#define M_ASN1_free_of(x, type) \
912		ASN1_item_free(CHECKED_PTR_OF(type, x), ASN1_ITEM_rptr(type))
913
914#ifndef OPENSSL_NO_FP_API
915OPENSSL_EXPORT void *ASN1_d2i_fp(void *(*xnew)(void), d2i_of_void *d2i, FILE *in, void **x);
916
917#define ASN1_d2i_fp_of(type,xnew,d2i,in,x) \
918    ((type*)ASN1_d2i_fp(CHECKED_NEW_OF(type, xnew), \
919			CHECKED_D2I_OF(type, d2i), \
920			in, \
921			CHECKED_PPTR_OF(type, x)))
922
923OPENSSL_EXPORT void *ASN1_item_d2i_fp(const ASN1_ITEM *it, FILE *in, void *x);
924OPENSSL_EXPORT int ASN1_i2d_fp(i2d_of_void *i2d,FILE *out,void *x);
925
926#define ASN1_i2d_fp_of(type,i2d,out,x) \
927    (ASN1_i2d_fp(CHECKED_I2D_OF(type, i2d), \
928		 out, \
929		 CHECKED_PTR_OF(type, x)))
930
931#define ASN1_i2d_fp_of_const(type,i2d,out,x) \
932    (ASN1_i2d_fp(CHECKED_I2D_OF(const type, i2d), \
933		 out, \
934		 CHECKED_PTR_OF(const type, x)))
935
936OPENSSL_EXPORT int ASN1_item_i2d_fp(const ASN1_ITEM *it, FILE *out, void *x);
937OPENSSL_EXPORT int ASN1_STRING_print_ex_fp(FILE *fp, ASN1_STRING *str, unsigned long flags);
938#endif
939
940OPENSSL_EXPORT int ASN1_STRING_to_UTF8(unsigned char **out, ASN1_STRING *in);
941
942OPENSSL_EXPORT void *ASN1_d2i_bio(void *(*xnew)(void), d2i_of_void *d2i, BIO *in, void **x);
943
944#define ASN1_d2i_bio_of(type,xnew,d2i,in,x) \
945    ((type*)ASN1_d2i_bio( CHECKED_NEW_OF(type, xnew), \
946			  CHECKED_D2I_OF(type, d2i), \
947			  in, \
948			  CHECKED_PPTR_OF(type, x)))
949
950OPENSSL_EXPORT void *ASN1_item_d2i_bio(const ASN1_ITEM *it, BIO *in, void *x);
951OPENSSL_EXPORT int ASN1_i2d_bio(i2d_of_void *i2d,BIO *out, void *x);
952
953#define ASN1_i2d_bio_of(type,i2d,out,x) \
954    (ASN1_i2d_bio(CHECKED_I2D_OF(type, i2d), \
955		  out, \
956		  CHECKED_PTR_OF(type, x)))
957
958#define ASN1_i2d_bio_of_const(type,i2d,out,x) \
959    (ASN1_i2d_bio(CHECKED_I2D_OF(const type, i2d), \
960		  out, \
961		  CHECKED_PTR_OF(const type, x)))
962
963OPENSSL_EXPORT int ASN1_item_i2d_bio(const ASN1_ITEM *it, BIO *out, void *x);
964OPENSSL_EXPORT int ASN1_UTCTIME_print(BIO *fp, const ASN1_UTCTIME *a);
965OPENSSL_EXPORT int ASN1_GENERALIZEDTIME_print(BIO *fp, const ASN1_GENERALIZEDTIME *a);
966OPENSSL_EXPORT int ASN1_TIME_print(BIO *fp, const ASN1_TIME *a);
967OPENSSL_EXPORT int ASN1_STRING_print(BIO *bp, const ASN1_STRING *v);
968OPENSSL_EXPORT int ASN1_STRING_print_ex(BIO *out, ASN1_STRING *str, unsigned long flags);
969OPENSSL_EXPORT int ASN1_bn_print(BIO *bp, const char *number, const BIGNUM *num, unsigned char *buf, int off);
970OPENSSL_EXPORT int ASN1_parse(BIO *bp,const unsigned char *pp,long len,int indent);
971OPENSSL_EXPORT int ASN1_parse_dump(BIO *bp,const unsigned char *pp,long len,int indent,int dump);
972OPENSSL_EXPORT const char *ASN1_tag2str(int tag);
973
974/* Used to load and write netscape format cert */
975
976DECLARE_ASN1_FUNCTIONS(NETSCAPE_X509)
977
978int ASN1_UNIVERSALSTRING_to_string(ASN1_UNIVERSALSTRING *s);
979
980OPENSSL_EXPORT STACK_OF(OPENSSL_BLOCK) *ASN1_seq_unpack(const unsigned char *buf, int len, d2i_of_void *d2i, void (*free_func)(OPENSSL_BLOCK));
981OPENSSL_EXPORT unsigned char *ASN1_seq_pack(STACK_OF(OPENSSL_BLOCK) *safes, i2d_of_void *i2d, unsigned char **buf, int *len );
982OPENSSL_EXPORT void *ASN1_unpack_string(ASN1_STRING *oct, d2i_of_void *d2i);
983OPENSSL_EXPORT void *ASN1_item_unpack(ASN1_STRING *oct, const ASN1_ITEM *it);
984OPENSSL_EXPORT ASN1_STRING *ASN1_pack_string(void *obj, i2d_of_void *i2d, ASN1_OCTET_STRING **oct);
985
986#define ASN1_pack_string_of(type,obj,i2d,oct) \
987    (ASN1_pack_string(CHECKED_PTR_OF(type, obj), \
988		      CHECKED_I2D_OF(type, i2d), \
989		      oct))
990
991OPENSSL_EXPORT ASN1_STRING *ASN1_item_pack(void *obj, const ASN1_ITEM *it, ASN1_OCTET_STRING **oct);
992
993OPENSSL_EXPORT void ASN1_STRING_set_default_mask(unsigned long mask);
994OPENSSL_EXPORT int ASN1_STRING_set_default_mask_asc(const char *p);
995OPENSSL_EXPORT unsigned long ASN1_STRING_get_default_mask(void);
996OPENSSL_EXPORT int ASN1_mbstring_copy(ASN1_STRING **out, const unsigned char *in, int len, int inform, unsigned long mask);
997OPENSSL_EXPORT int ASN1_mbstring_ncopy(ASN1_STRING **out, const unsigned char *in, int len, int inform, unsigned long mask, long minsize, long maxsize);
998
999OPENSSL_EXPORT ASN1_STRING *ASN1_STRING_set_by_NID(ASN1_STRING **out, const unsigned char *in, int inlen, int inform, int nid);
1000OPENSSL_EXPORT ASN1_STRING_TABLE *ASN1_STRING_TABLE_get(int nid);
1001OPENSSL_EXPORT int ASN1_STRING_TABLE_add(int, long, long, unsigned long, unsigned long);
1002OPENSSL_EXPORT void ASN1_STRING_TABLE_cleanup(void);
1003
1004/* ASN1 template functions */
1005
1006/* Old API compatible functions */
1007OPENSSL_EXPORT ASN1_VALUE *ASN1_item_new(const ASN1_ITEM *it);
1008OPENSSL_EXPORT void ASN1_item_free(ASN1_VALUE *val, const ASN1_ITEM *it);
1009OPENSSL_EXPORT ASN1_VALUE * ASN1_item_d2i(ASN1_VALUE **val, const unsigned char **in, long len, const ASN1_ITEM *it);
1010OPENSSL_EXPORT int ASN1_item_i2d(ASN1_VALUE *val, unsigned char **out, const ASN1_ITEM *it);
1011OPENSSL_EXPORT int ASN1_item_ndef_i2d(ASN1_VALUE *val, unsigned char **out, const ASN1_ITEM *it);
1012
1013OPENSSL_EXPORT void ASN1_add_oid_module(void);
1014
1015OPENSSL_EXPORT ASN1_TYPE *ASN1_generate_nconf(char *str, CONF *nconf);
1016OPENSSL_EXPORT ASN1_TYPE *ASN1_generate_v3(char *str, X509V3_CTX *cnf);
1017
1018/* ASN1 Print flags */
1019
1020/* Indicate missing OPTIONAL fields */
1021#define ASN1_PCTX_FLAGS_SHOW_ABSENT		0x001
1022/* Mark start and end of SEQUENCE */
1023#define ASN1_PCTX_FLAGS_SHOW_SEQUENCE		0x002
1024/* Mark start and end of SEQUENCE/SET OF */
1025#define ASN1_PCTX_FLAGS_SHOW_SSOF		0x004
1026/* Show the ASN1 type of primitives */
1027#define ASN1_PCTX_FLAGS_SHOW_TYPE		0x008
1028/* Don't show ASN1 type of ANY */
1029#define ASN1_PCTX_FLAGS_NO_ANY_TYPE		0x010
1030/* Don't show ASN1 type of MSTRINGs */
1031#define ASN1_PCTX_FLAGS_NO_MSTRING_TYPE		0x020
1032/* Don't show field names in SEQUENCE */
1033#define ASN1_PCTX_FLAGS_NO_FIELD_NAME		0x040
1034/* Show structure names of each SEQUENCE field */
1035#define ASN1_PCTX_FLAGS_SHOW_FIELD_STRUCT_NAME	0x080
1036/* Don't show structure name even at top level */
1037#define ASN1_PCTX_FLAGS_NO_STRUCT_NAME		0x100
1038
1039OPENSSL_EXPORT int ASN1_item_print(BIO *out, ASN1_VALUE *ifld, int indent, const ASN1_ITEM *it, const ASN1_PCTX *pctx);
1040OPENSSL_EXPORT ASN1_PCTX *ASN1_PCTX_new(void);
1041OPENSSL_EXPORT void ASN1_PCTX_free(ASN1_PCTX *p);
1042OPENSSL_EXPORT unsigned long ASN1_PCTX_get_flags(ASN1_PCTX *p);
1043OPENSSL_EXPORT void ASN1_PCTX_set_flags(ASN1_PCTX *p, unsigned long flags);
1044OPENSSL_EXPORT unsigned long ASN1_PCTX_get_nm_flags(ASN1_PCTX *p);
1045OPENSSL_EXPORT void ASN1_PCTX_set_nm_flags(ASN1_PCTX *p, unsigned long flags);
1046OPENSSL_EXPORT unsigned long ASN1_PCTX_get_cert_flags(ASN1_PCTX *p);
1047OPENSSL_EXPORT void ASN1_PCTX_set_cert_flags(ASN1_PCTX *p, unsigned long flags);
1048OPENSSL_EXPORT unsigned long ASN1_PCTX_get_oid_flags(ASN1_PCTX *p);
1049OPENSSL_EXPORT void ASN1_PCTX_set_oid_flags(ASN1_PCTX *p, unsigned long flags);
1050OPENSSL_EXPORT unsigned long ASN1_PCTX_get_str_flags(ASN1_PCTX *p);
1051OPENSSL_EXPORT void ASN1_PCTX_set_str_flags(ASN1_PCTX *p, unsigned long flags);
1052
1053OPENSSL_EXPORT const BIO_METHOD *BIO_f_asn1(void);
1054
1055OPENSSL_EXPORT BIO *BIO_new_NDEF(BIO *out, ASN1_VALUE *val, const ASN1_ITEM *it);
1056
1057OPENSSL_EXPORT int i2d_ASN1_bio_stream(BIO *out, ASN1_VALUE *val, BIO *in, int flags, const ASN1_ITEM *it);
1058OPENSSL_EXPORT int PEM_write_bio_ASN1_stream(BIO *out, ASN1_VALUE *val, BIO *in, int flags, const char *hdr, const ASN1_ITEM *it);
1059OPENSSL_EXPORT ASN1_VALUE *SMIME_read_ASN1(BIO *bio, BIO **bcont, const ASN1_ITEM *it);
1060OPENSSL_EXPORT int SMIME_crlf_copy(BIO *in, BIO *out, int flags);
1061OPENSSL_EXPORT int SMIME_text(BIO *in, BIO *out);
1062
1063/* BEGIN ERROR CODES */
1064/* The following lines are auto generated by the script mkerr.pl. Any changes
1065 * made after this point may be overwritten when the script is next run.
1066 */
1067void ERR_load_ASN1_strings(void);
1068
1069typedef int asn1_ps_func(BIO *b, unsigned char **pbuf, int *plen, void *parg);
1070OPENSSL_EXPORT int BIO_asn1_set_prefix(BIO *b, asn1_ps_func *prefix, asn1_ps_func *prefix_free);
1071OPENSSL_EXPORT int BIO_asn1_get_prefix(BIO *b, asn1_ps_func **pprefix, asn1_ps_func **pprefix_free);
1072OPENSSL_EXPORT int BIO_asn1_set_suffix(BIO *b, asn1_ps_func *suffix, asn1_ps_func *suffix_free);
1073OPENSSL_EXPORT int BIO_asn1_get_suffix(BIO *b, asn1_ps_func **psuffix, asn1_ps_func **psuffix_free);
1074
1075#ifdef  __cplusplus
1076}
1077#endif
1078
1079#define ASN1_R_ASN1_LENGTH_MISMATCH 100
1080#define ASN1_R_AUX_ERROR 101
1081#define ASN1_R_BAD_GET_ASN1_OBJECT_CALL 102
1082#define ASN1_R_BAD_OBJECT_HEADER 103
1083#define ASN1_R_BMPSTRING_IS_WRONG_LENGTH 104
1084#define ASN1_R_BN_LIB 105
1085#define ASN1_R_BOOLEAN_IS_WRONG_LENGTH 106
1086#define ASN1_R_BUFFER_TOO_SMALL 107
1087#define ASN1_R_DECODE_ERROR 108
1088#define ASN1_R_DEPTH_EXCEEDED 109
1089#define ASN1_R_ENCODE_ERROR 110
1090#define ASN1_R_ERROR_GETTING_TIME 111
1091#define ASN1_R_EXPECTING_AN_ASN1_SEQUENCE 112
1092#define ASN1_R_EXPECTING_AN_INTEGER 113
1093#define ASN1_R_EXPECTING_AN_OBJECT 114
1094#define ASN1_R_EXPECTING_A_BOOLEAN 115
1095#define ASN1_R_EXPECTING_A_TIME 116
1096#define ASN1_R_EXPLICIT_LENGTH_MISMATCH 117
1097#define ASN1_R_EXPLICIT_TAG_NOT_CONSTRUCTED 118
1098#define ASN1_R_FIELD_MISSING 119
1099#define ASN1_R_FIRST_NUM_TOO_LARGE 120
1100#define ASN1_R_HEADER_TOO_LONG 121
1101#define ASN1_R_ILLEGAL_BITSTRING_FORMAT 122
1102#define ASN1_R_ILLEGAL_BOOLEAN 123
1103#define ASN1_R_ILLEGAL_CHARACTERS 124
1104#define ASN1_R_ILLEGAL_FORMAT 125
1105#define ASN1_R_ILLEGAL_HEX 126
1106#define ASN1_R_ILLEGAL_IMPLICIT_TAG 127
1107#define ASN1_R_ILLEGAL_INTEGER 128
1108#define ASN1_R_ILLEGAL_NESTED_TAGGING 129
1109#define ASN1_R_ILLEGAL_NULL 130
1110#define ASN1_R_ILLEGAL_NULL_VALUE 131
1111#define ASN1_R_ILLEGAL_OBJECT 132
1112#define ASN1_R_ILLEGAL_OPTIONAL_ANY 133
1113#define ASN1_R_ILLEGAL_OPTIONS_ON_ITEM_TEMPLATE 134
1114#define ASN1_R_ILLEGAL_TAGGED_ANY 135
1115#define ASN1_R_ILLEGAL_TIME_VALUE 136
1116#define ASN1_R_INTEGER_NOT_ASCII_FORMAT 137
1117#define ASN1_R_INTEGER_TOO_LARGE_FOR_LONG 138
1118#define ASN1_R_INVALID_BIT_STRING_BITS_LEFT 139
1119#define ASN1_R_INVALID_BMPSTRING_LENGTH 140
1120#define ASN1_R_INVALID_DIGIT 141
1121#define ASN1_R_INVALID_MODIFIER 142
1122#define ASN1_R_INVALID_NUMBER 143
1123#define ASN1_R_INVALID_OBJECT_ENCODING 144
1124#define ASN1_R_INVALID_SEPARATOR 145
1125#define ASN1_R_INVALID_TIME_FORMAT 146
1126#define ASN1_R_INVALID_UNIVERSALSTRING_LENGTH 147
1127#define ASN1_R_INVALID_UTF8STRING 148
1128#define ASN1_R_LIST_ERROR 149
1129#define ASN1_R_MALLOC_FAILURE 150
1130#define ASN1_R_MISSING_ASN1_EOS 151
1131#define ASN1_R_MISSING_EOC 152
1132#define ASN1_R_MISSING_SECOND_NUMBER 153
1133#define ASN1_R_MISSING_VALUE 154
1134#define ASN1_R_MSTRING_NOT_UNIVERSAL 155
1135#define ASN1_R_MSTRING_WRONG_TAG 156
1136#define ASN1_R_NESTED_ASN1_ERROR 157
1137#define ASN1_R_NESTED_ASN1_STRING 158
1138#define ASN1_R_NON_HEX_CHARACTERS 159
1139#define ASN1_R_NOT_ASCII_FORMAT 160
1140#define ASN1_R_NOT_ENOUGH_DATA 161
1141#define ASN1_R_NO_MATCHING_CHOICE_TYPE 162
1142#define ASN1_R_NULL_IS_WRONG_LENGTH 163
1143#define ASN1_R_OBJECT_NOT_ASCII_FORMAT 164
1144#define ASN1_R_ODD_NUMBER_OF_CHARS 165
1145#define ASN1_R_SECOND_NUMBER_TOO_LARGE 166
1146#define ASN1_R_SEQUENCE_LENGTH_MISMATCH 167
1147#define ASN1_R_SEQUENCE_NOT_CONSTRUCTED 168
1148#define ASN1_R_SEQUENCE_OR_SET_NEEDS_CONFIG 169
1149#define ASN1_R_SHORT_LINE 170
1150#define ASN1_R_STREAMING_NOT_SUPPORTED 171
1151#define ASN1_R_STRING_TOO_LONG 172
1152#define ASN1_R_STRING_TOO_SHORT 173
1153#define ASN1_R_TAG_VALUE_TOO_HIGH 174
1154#define ASN1_R_TIME_NOT_ASCII_FORMAT 175
1155#define ASN1_R_TOO_LONG 176
1156#define ASN1_R_TYPE_NOT_CONSTRUCTED 177
1157#define ASN1_R_TYPE_NOT_PRIMITIVE 178
1158#define ASN1_R_UNEXPECTED_EOC 179
1159#define ASN1_R_UNIVERSALSTRING_IS_WRONG_LENGTH 180
1160#define ASN1_R_UNKNOWN_FORMAT 181
1161#define ASN1_R_UNKNOWN_TAG 182
1162#define ASN1_R_UNSUPPORTED_ANY_DEFINED_BY_TYPE 183
1163#define ASN1_R_UNSUPPORTED_PUBLIC_KEY_TYPE 184
1164#define ASN1_R_UNSUPPORTED_TYPE 185
1165#define ASN1_R_WRONG_TAG 186
1166#define ASN1_R_WRONG_TYPE 187
1167
1168#endif
1169