asn1.h revision c895d6b1c580258e72e1ed3fcc86d38970ded9e1
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/* No supported universal tags may exceed this value, to avoid ambiguity with
89 * V_ASN1_NEG. */
90#define V_ASN1_MAX_UNIVERSAL		0xff
91
92#define V_ASN1_UNDEF			-1
93#define V_ASN1_EOC			0
94#define V_ASN1_BOOLEAN			1	/**/
95#define V_ASN1_INTEGER			2
96#define V_ASN1_NEG_INTEGER		(2 | V_ASN1_NEG)
97#define V_ASN1_BIT_STRING		3
98#define V_ASN1_OCTET_STRING		4
99#define V_ASN1_NULL			5
100#define V_ASN1_OBJECT			6
101#define V_ASN1_OBJECT_DESCRIPTOR	7
102#define V_ASN1_EXTERNAL			8
103#define V_ASN1_REAL			9
104#define V_ASN1_ENUMERATED		10
105#define V_ASN1_NEG_ENUMERATED		(10 | V_ASN1_NEG)
106#define V_ASN1_UTF8STRING		12
107#define V_ASN1_SEQUENCE			16
108#define V_ASN1_SET			17
109#define V_ASN1_NUMERICSTRING		18	/**/
110#define V_ASN1_PRINTABLESTRING		19
111#define V_ASN1_T61STRING		20
112#define V_ASN1_TELETEXSTRING		20	/* alias */
113#define V_ASN1_VIDEOTEXSTRING		21	/**/
114#define V_ASN1_IA5STRING		22
115#define V_ASN1_UTCTIME			23
116#define V_ASN1_GENERALIZEDTIME		24	/**/
117#define V_ASN1_GRAPHICSTRING		25	/**/
118#define V_ASN1_ISO64STRING		26	/**/
119#define V_ASN1_VISIBLESTRING		26	/* alias */
120#define V_ASN1_GENERALSTRING		27	/**/
121#define V_ASN1_UNIVERSALSTRING		28	/**/
122#define V_ASN1_BMPSTRING		30
123
124/* For use with d2i_ASN1_type_bytes() */
125#define B_ASN1_NUMERICSTRING	0x0001
126#define B_ASN1_PRINTABLESTRING	0x0002
127#define B_ASN1_T61STRING	0x0004
128#define B_ASN1_TELETEXSTRING	0x0004
129#define B_ASN1_VIDEOTEXSTRING	0x0008
130#define B_ASN1_IA5STRING	0x0010
131#define B_ASN1_GRAPHICSTRING	0x0020
132#define B_ASN1_ISO64STRING	0x0040
133#define B_ASN1_VISIBLESTRING	0x0040
134#define B_ASN1_GENERALSTRING	0x0080
135#define B_ASN1_UNIVERSALSTRING	0x0100
136#define B_ASN1_OCTET_STRING	0x0200
137#define B_ASN1_BIT_STRING	0x0400
138#define B_ASN1_BMPSTRING	0x0800
139#define B_ASN1_UNKNOWN		0x1000
140#define B_ASN1_UTF8STRING	0x2000
141#define B_ASN1_UTCTIME		0x4000
142#define B_ASN1_GENERALIZEDTIME	0x8000
143#define B_ASN1_SEQUENCE		0x10000
144
145/* For use with ASN1_mbstring_copy() */
146#define MBSTRING_FLAG		0x1000
147#define MBSTRING_UTF8		(MBSTRING_FLAG)
148#define MBSTRING_ASC		(MBSTRING_FLAG|1)
149#define MBSTRING_BMP		(MBSTRING_FLAG|2)
150#define MBSTRING_UNIV		(MBSTRING_FLAG|4)
151
152#define SMIME_OLDMIME		0x400
153#define SMIME_CRLFEOL		0x800
154#define SMIME_STREAM		0x1000
155
156#define DECLARE_ASN1_SET_OF(type) /* filled in by mkstack.pl */
157#define IMPLEMENT_ASN1_SET_OF(type) /* nothing, no longer needed */
158
159/* We MUST make sure that, except for constness, asn1_ctx_st and
160   asn1_const_ctx are exactly the same.  Fortunately, as soon as
161   the old ASN1 parsing macros are gone, we can throw this away
162   as well... */
163typedef struct asn1_ctx_st
164	{
165	unsigned char *p;/* work char pointer */
166	int eos;	/* end of sequence read for indefinite encoding */
167	int error;	/* error code to use when returning an error */
168	int inf;	/* constructed if 0x20, indefinite is 0x21 */
169	int tag;	/* tag from last 'get object' */
170	int xclass;	/* class from last 'get object' */
171	long slen;	/* length of last 'get object' */
172	unsigned char *max; /* largest value of p allowed */
173	unsigned char *q;/* temporary variable */
174	unsigned char **pp;/* variable */
175	int line;	/* used in error processing */
176	} ASN1_CTX;
177
178typedef struct asn1_const_ctx_st
179	{
180	const unsigned char *p;/* work char pointer */
181	int eos;	/* end of sequence read for indefinite encoding */
182	int error;	/* error code to use when returning an error */
183	int inf;	/* constructed if 0x20, indefinite is 0x21 */
184	int tag;	/* tag from last 'get object' */
185	int xclass;	/* class from last 'get object' */
186	long slen;	/* length of last 'get object' */
187	const unsigned char *max; /* largest value of p allowed */
188	const unsigned char *q;/* temporary variable */
189	const unsigned char **pp;/* variable */
190	int line;	/* used in error processing */
191	} ASN1_const_CTX;
192
193/* These are used internally in the ASN1_OBJECT to keep track of
194 * whether the names and data need to be free()ed */
195#define ASN1_OBJECT_FLAG_DYNAMIC	 0x01	/* internal use */
196#define ASN1_OBJECT_FLAG_CRITICAL	 0x02	/* critical x509v3 object id */
197#define ASN1_OBJECT_FLAG_DYNAMIC_STRINGS 0x04	/* internal use */
198#define ASN1_OBJECT_FLAG_DYNAMIC_DATA 	 0x08	/* internal use */
199struct asn1_object_st
200	{
201	const char *sn,*ln;
202	int nid;
203	int length;
204	const unsigned char *data;	/* data remains const after init */
205	int flags;	/* Should we free this one */
206	};
207
208#define ASN1_STRING_FLAG_BITS_LEFT 0x08 /* Set if 0x07 has bits left value */
209/* This indicates that the ASN1_STRING is not a real value but just a place
210 * holder for the location where indefinite length constructed data should
211 * be inserted in the memory buffer
212 */
213#define ASN1_STRING_FLAG_NDEF 0x010
214
215/* This flag is used by the CMS code to indicate that a string is not
216 * complete and is a place holder for content when it had all been
217 * accessed. The flag will be reset when content has been written to it.
218 */
219
220#define ASN1_STRING_FLAG_CONT 0x020
221/* This flag is used by ASN1 code to indicate an ASN1_STRING is an MSTRING
222 * type.
223 */
224#define ASN1_STRING_FLAG_MSTRING 0x040
225/* This is the base type that holds just about everything :-) */
226struct asn1_string_st
227	{
228	int length;
229	int type;
230	unsigned char *data;
231	/* The value of the following field depends on the type being
232	 * held.  It is mostly being used for BIT_STRING so if the
233	 * input data has a non-zero 'unused bits' value, it will be
234	 * handled correctly */
235	long flags;
236	};
237
238/* ASN1_ENCODING structure: this is used to save the received
239 * encoding of an ASN1 type. This is useful to get round
240 * problems with invalid encodings which can break signatures.
241 */
242
243typedef struct ASN1_ENCODING_st
244	{
245	unsigned char *enc;	/* DER encoding */
246	long len;		/* Length of encoding */
247	int modified;		 /* set to 1 if 'enc' is invalid */
248	} ASN1_ENCODING;
249
250/* Used with ASN1 LONG type: if a long is set to this it is omitted */
251#define ASN1_LONG_UNDEF	0x7fffffffL
252
253#define STABLE_FLAGS_MALLOC	0x01
254#define STABLE_NO_MASK		0x02
255#define DIRSTRING_TYPE	\
256 (B_ASN1_PRINTABLESTRING|B_ASN1_T61STRING|B_ASN1_BMPSTRING|B_ASN1_UTF8STRING)
257#define PKCS9STRING_TYPE (DIRSTRING_TYPE|B_ASN1_IA5STRING)
258
259typedef struct asn1_string_table_st {
260	int nid;
261	long minsize;
262	long maxsize;
263	unsigned long mask;
264	unsigned long flags;
265} ASN1_STRING_TABLE;
266
267/* size limits: this stuff is taken straight from RFC2459 */
268
269#define ub_name				32768
270#define ub_common_name			64
271#define ub_locality_name		128
272#define ub_state_name			128
273#define ub_organization_name		64
274#define ub_organization_unit_name	64
275#define ub_title			64
276#define ub_email_address		128
277
278/* Declarations for template structures: for full definitions
279 * see asn1t.h
280 */
281typedef struct ASN1_TEMPLATE_st ASN1_TEMPLATE;
282typedef struct ASN1_TLC_st ASN1_TLC;
283/* This is just an opaque pointer */
284typedef struct ASN1_VALUE_st ASN1_VALUE;
285
286/* Declare ASN1 functions: the implement macro in in asn1t.h */
287
288#define DECLARE_ASN1_FUNCTIONS(type) DECLARE_ASN1_FUNCTIONS_name(type, type)
289
290#define DECLARE_ASN1_ALLOC_FUNCTIONS(type) \
291	DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, type)
292
293#define DECLARE_ASN1_FUNCTIONS_name(type, name) \
294	DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \
295	DECLARE_ASN1_ENCODE_FUNCTIONS(type, name, name)
296
297#define DECLARE_ASN1_FUNCTIONS_fname(type, itname, name) \
298	DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \
299	DECLARE_ASN1_ENCODE_FUNCTIONS(type, itname, name)
300
301#define	DECLARE_ASN1_ENCODE_FUNCTIONS(type, itname, name) \
302	OPENSSL_EXPORT type *d2i_##name(type **a, const unsigned char **in, long len); \
303	OPENSSL_EXPORT int i2d_##name(type *a, unsigned char **out); \
304	DECLARE_ASN1_ITEM(itname)
305
306#define	DECLARE_ASN1_ENCODE_FUNCTIONS_const(type, name) \
307	OPENSSL_EXPORT type *d2i_##name(type **a, const unsigned char **in, long len); \
308	OPENSSL_EXPORT int i2d_##name(const type *a, unsigned char **out); \
309	DECLARE_ASN1_ITEM(name)
310
311#define	DECLARE_ASN1_NDEF_FUNCTION(name) \
312	OPENSSL_EXPORT int i2d_##name##_NDEF(name *a, unsigned char **out);
313
314#define DECLARE_ASN1_FUNCTIONS_const(name) \
315	DECLARE_ASN1_ALLOC_FUNCTIONS(name) \
316	DECLARE_ASN1_ENCODE_FUNCTIONS_const(name, name)
317
318#define DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \
319	OPENSSL_EXPORT type *name##_new(void); \
320	OPENSSL_EXPORT void name##_free(type *a);
321
322#define DECLARE_ASN1_PRINT_FUNCTION(stname) \
323	DECLARE_ASN1_PRINT_FUNCTION_fname(stname, stname)
324
325#define DECLARE_ASN1_PRINT_FUNCTION_fname(stname, fname) \
326	OPENSSL_EXPORT int fname##_print_ctx(BIO *out, stname *x, int indent, \
327					 const ASN1_PCTX *pctx);
328
329#define D2I_OF(type) type *(*)(type **,const unsigned char **,long)
330#define I2D_OF(type) int (*)(type *,unsigned char **)
331#define I2D_OF_const(type) int (*)(const type *,unsigned char **)
332
333#define CHECKED_D2I_OF(type, d2i) \
334    ((d2i_of_void*) (1 ? d2i : ((D2I_OF(type))0)))
335#define CHECKED_I2D_OF(type, i2d) \
336    ((i2d_of_void*) (1 ? i2d : ((I2D_OF(type))0)))
337#define CHECKED_NEW_OF(type, xnew) \
338    ((void *(*)(void)) (1 ? xnew : ((type *(*)(void))0)))
339#define CHECKED_PPTR_OF(type, p) \
340    ((void**) (1 ? p : (type**)0))
341
342#define TYPEDEF_D2I_OF(type) typedef type *d2i_of_##type(type **,const unsigned char **,long)
343#define TYPEDEF_I2D_OF(type) typedef int i2d_of_##type(const type *,unsigned char **)
344#define TYPEDEF_D2I2D_OF(type) TYPEDEF_D2I_OF(type); TYPEDEF_I2D_OF(type)
345
346TYPEDEF_D2I2D_OF(void);
347
348/* The following macros and typedefs allow an ASN1_ITEM
349 * to be embedded in a structure and referenced. Since
350 * the ASN1_ITEM pointers need to be globally accessible
351 * (possibly from shared libraries) they may exist in
352 * different forms. On platforms that support it the
353 * ASN1_ITEM structure itself will be globally exported.
354 * Other platforms will export a function that returns
355 * an ASN1_ITEM pointer.
356 *
357 * To handle both cases transparently the macros below
358 * should be used instead of hard coding an ASN1_ITEM
359 * pointer in a structure.
360 *
361 * The structure will look like this:
362 *
363 * typedef struct SOMETHING_st {
364 *      ...
365 *      ASN1_ITEM_EXP *iptr;
366 *      ...
367 * } SOMETHING;
368 *
369 * It would be initialised as e.g.:
370 *
371 * SOMETHING somevar = {...,ASN1_ITEM_ref(X509),...};
372 *
373 * and the actual pointer extracted with:
374 *
375 * const ASN1_ITEM *it = ASN1_ITEM_ptr(somevar.iptr);
376 *
377 * Finally an ASN1_ITEM pointer can be extracted from an
378 * appropriate reference with: ASN1_ITEM_rptr(X509). This
379 * would be used when a function takes an ASN1_ITEM * argument.
380 *
381 */
382
383/* ASN1_ITEM pointer exported type */
384typedef const ASN1_ITEM ASN1_ITEM_EXP;
385
386/* Macro to obtain ASN1_ITEM pointer from exported type */
387#define ASN1_ITEM_ptr(iptr) (iptr)
388
389/* Macro to include ASN1_ITEM pointer from base type */
390#define ASN1_ITEM_ref(iptr) (&(iptr##_it))
391
392#define ASN1_ITEM_rptr(ref) (&(ref##_it))
393
394#define DECLARE_ASN1_ITEM(name) \
395	extern OPENSSL_EXPORT const ASN1_ITEM name##_it;
396
397/* Parameters used by ASN1_STRING_print_ex() */
398
399/* These determine which characters to escape:
400 * RFC2253 special characters, control characters and
401 * MSB set characters
402 */
403
404#define ASN1_STRFLGS_ESC_2253		1
405#define ASN1_STRFLGS_ESC_CTRL		2
406#define ASN1_STRFLGS_ESC_MSB		4
407
408
409/* This flag determines how we do escaping: normally
410 * RC2253 backslash only, set this to use backslash and
411 * quote.
412 */
413
414#define ASN1_STRFLGS_ESC_QUOTE		8
415
416
417/* These three flags are internal use only. */
418
419/* Character is a valid PrintableString character */
420#define CHARTYPE_PRINTABLESTRING	0x10
421/* Character needs escaping if it is the first character */
422#define CHARTYPE_FIRST_ESC_2253		0x20
423/* Character needs escaping if it is the last character */
424#define CHARTYPE_LAST_ESC_2253		0x40
425
426/* NB the internal flags are safely reused below by flags
427 * handled at the top level.
428 */
429
430/* If this is set we convert all character strings
431 * to UTF8 first
432 */
433
434#define ASN1_STRFLGS_UTF8_CONVERT	0x10
435
436/* If this is set we don't attempt to interpret content:
437 * just assume all strings are 1 byte per character. This
438 * will produce some pretty odd looking output!
439 */
440
441#define ASN1_STRFLGS_IGNORE_TYPE	0x20
442
443/* If this is set we include the string type in the output */
444#define ASN1_STRFLGS_SHOW_TYPE		0x40
445
446/* This determines which strings to display and which to
447 * 'dump' (hex dump of content octets or DER encoding). We can
448 * only dump non character strings or everything. If we
449 * don't dump 'unknown' they are interpreted as character
450 * strings with 1 octet per character and are subject to
451 * the usual escaping options.
452 */
453
454#define ASN1_STRFLGS_DUMP_ALL		0x80
455#define ASN1_STRFLGS_DUMP_UNKNOWN	0x100
456
457/* These determine what 'dumping' does, we can dump the
458 * content octets or the DER encoding: both use the
459 * RFC2253 #XXXXX notation.
460 */
461
462#define ASN1_STRFLGS_DUMP_DER		0x200
463
464/* All the string flags consistent with RFC2253,
465 * escaping control characters isn't essential in
466 * RFC2253 but it is advisable anyway.
467 */
468
469#define ASN1_STRFLGS_RFC2253	(ASN1_STRFLGS_ESC_2253 | \
470				ASN1_STRFLGS_ESC_CTRL | \
471				ASN1_STRFLGS_ESC_MSB | \
472				ASN1_STRFLGS_UTF8_CONVERT | \
473				ASN1_STRFLGS_DUMP_UNKNOWN | \
474				ASN1_STRFLGS_DUMP_DER)
475
476DECLARE_ASN1_SET_OF(ASN1_INTEGER)
477
478typedef struct asn1_type_st
479	{
480	int type;
481	union	{
482		char *ptr;
483		ASN1_BOOLEAN		boolean;
484		ASN1_STRING *		asn1_string;
485		ASN1_OBJECT *		object;
486		ASN1_INTEGER *		integer;
487		ASN1_ENUMERATED *	enumerated;
488		ASN1_BIT_STRING *	bit_string;
489		ASN1_OCTET_STRING *	octet_string;
490		ASN1_PRINTABLESTRING *	printablestring;
491		ASN1_T61STRING *	t61string;
492		ASN1_IA5STRING *	ia5string;
493		ASN1_GENERALSTRING *	generalstring;
494		ASN1_BMPSTRING *	bmpstring;
495		ASN1_UNIVERSALSTRING *	universalstring;
496		ASN1_UTCTIME *		utctime;
497		ASN1_GENERALIZEDTIME *	generalizedtime;
498		ASN1_VISIBLESTRING *	visiblestring;
499		ASN1_UTF8STRING *	utf8string;
500		/* set and sequence are left complete and still
501		 * contain the set or sequence bytes */
502		ASN1_STRING *		set;
503		ASN1_STRING *		sequence;
504		ASN1_VALUE *		asn1_value;
505		} value;
506	} ASN1_TYPE;
507
508DECLARE_ASN1_SET_OF(ASN1_TYPE)
509
510typedef STACK_OF(ASN1_TYPE) ASN1_SEQUENCE_ANY;
511
512DECLARE_ASN1_ENCODE_FUNCTIONS_const(ASN1_SEQUENCE_ANY, ASN1_SEQUENCE_ANY)
513DECLARE_ASN1_ENCODE_FUNCTIONS_const(ASN1_SEQUENCE_ANY, ASN1_SET_ANY)
514
515struct X509_algor_st
516       {
517       ASN1_OBJECT *algorithm;
518       ASN1_TYPE *parameter;
519       } /* X509_ALGOR */;
520
521DECLARE_ASN1_FUNCTIONS(X509_ALGOR)
522
523typedef struct NETSCAPE_X509_st
524	{
525	ASN1_OCTET_STRING *header;
526	X509 *cert;
527	} NETSCAPE_X509;
528
529/* This is used to contain a list of bit names */
530typedef struct BIT_STRING_BITNAME_st {
531	int bitnum;
532	const char *lname;
533	const char *sname;
534} BIT_STRING_BITNAME;
535
536
537#define M_ASN1_STRING_length(x)	((x)->length)
538#define M_ASN1_STRING_length_set(x, n)	((x)->length = (n))
539#define M_ASN1_STRING_type(x)	((x)->type)
540#define M_ASN1_STRING_data(x)	((x)->data)
541
542/* Macros for string operations */
543#define M_ASN1_BIT_STRING_new()	(ASN1_BIT_STRING *)\
544		ASN1_STRING_type_new(V_ASN1_BIT_STRING)
545#define M_ASN1_BIT_STRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
546#define M_ASN1_BIT_STRING_dup(a) (ASN1_BIT_STRING *)\
547		ASN1_STRING_dup((const ASN1_STRING *)a)
548#define M_ASN1_BIT_STRING_cmp(a,b) ASN1_STRING_cmp(\
549		(const ASN1_STRING *)a,(const ASN1_STRING *)b)
550#define M_ASN1_BIT_STRING_set(a,b,c) ASN1_STRING_set((ASN1_STRING *)a,b,c)
551
552#define M_ASN1_INTEGER_new()	(ASN1_INTEGER *)\
553		ASN1_STRING_type_new(V_ASN1_INTEGER)
554#define M_ASN1_INTEGER_free(a)		ASN1_STRING_free((ASN1_STRING *)a)
555#define M_ASN1_INTEGER_dup(a) (ASN1_INTEGER *)\
556		ASN1_STRING_dup((const ASN1_STRING *)a)
557#define M_ASN1_INTEGER_cmp(a,b)	ASN1_STRING_cmp(\
558		(const ASN1_STRING *)a,(const ASN1_STRING *)b)
559
560#define M_ASN1_ENUMERATED_new()	(ASN1_ENUMERATED *)\
561		ASN1_STRING_type_new(V_ASN1_ENUMERATED)
562#define M_ASN1_ENUMERATED_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
563#define M_ASN1_ENUMERATED_dup(a) (ASN1_ENUMERATED *)\
564		ASN1_STRING_dup((const ASN1_STRING *)a)
565#define M_ASN1_ENUMERATED_cmp(a,b)	ASN1_STRING_cmp(\
566		(const ASN1_STRING *)a,(const ASN1_STRING *)b)
567
568#define M_ASN1_OCTET_STRING_new()	(ASN1_OCTET_STRING *)\
569		ASN1_STRING_type_new(V_ASN1_OCTET_STRING)
570#define M_ASN1_OCTET_STRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
571#define M_ASN1_OCTET_STRING_dup(a) (ASN1_OCTET_STRING *)\
572		ASN1_STRING_dup((const ASN1_STRING *)a)
573#define M_ASN1_OCTET_STRING_cmp(a,b) ASN1_STRING_cmp(\
574		(const ASN1_STRING *)a,(const ASN1_STRING *)b)
575#define M_ASN1_OCTET_STRING_set(a,b,c)	ASN1_STRING_set((ASN1_STRING *)a,b,c)
576#define M_ASN1_OCTET_STRING_print(a,b)	ASN1_STRING_print(a,(ASN1_STRING *)b)
577#define M_i2d_ASN1_OCTET_STRING(a,pp) \
578		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_OCTET_STRING,\
579		V_ASN1_UNIVERSAL)
580
581#define B_ASN1_TIME \
582			B_ASN1_UTCTIME | \
583			B_ASN1_GENERALIZEDTIME
584
585#define B_ASN1_PRINTABLE \
586			B_ASN1_NUMERICSTRING| \
587			B_ASN1_PRINTABLESTRING| \
588			B_ASN1_T61STRING| \
589			B_ASN1_IA5STRING| \
590			B_ASN1_BIT_STRING| \
591			B_ASN1_UNIVERSALSTRING|\
592			B_ASN1_BMPSTRING|\
593			B_ASN1_UTF8STRING|\
594			B_ASN1_SEQUENCE|\
595			B_ASN1_UNKNOWN
596
597#define B_ASN1_DIRECTORYSTRING \
598			B_ASN1_PRINTABLESTRING| \
599			B_ASN1_TELETEXSTRING|\
600			B_ASN1_BMPSTRING|\
601			B_ASN1_UNIVERSALSTRING|\
602			B_ASN1_UTF8STRING
603
604#define B_ASN1_DISPLAYTEXT \
605			B_ASN1_IA5STRING| \
606			B_ASN1_VISIBLESTRING| \
607			B_ASN1_BMPSTRING|\
608			B_ASN1_UTF8STRING
609
610#define M_ASN1_PRINTABLE_new()	ASN1_STRING_type_new(V_ASN1_T61STRING)
611#define M_ASN1_PRINTABLE_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
612#define M_i2d_ASN1_PRINTABLE(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\
613		pp,a->type,V_ASN1_UNIVERSAL)
614#define M_d2i_ASN1_PRINTABLE(a,pp,l) \
615		d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \
616			B_ASN1_PRINTABLE)
617
618#define M_DIRECTORYSTRING_new() ASN1_STRING_type_new(V_ASN1_PRINTABLESTRING)
619#define M_DIRECTORYSTRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
620#define M_i2d_DIRECTORYSTRING(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\
621						pp,a->type,V_ASN1_UNIVERSAL)
622#define M_d2i_DIRECTORYSTRING(a,pp,l) \
623		d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \
624			B_ASN1_DIRECTORYSTRING)
625
626#define M_DISPLAYTEXT_new() ASN1_STRING_type_new(V_ASN1_VISIBLESTRING)
627#define M_DISPLAYTEXT_free(a) ASN1_STRING_free((ASN1_STRING *)a)
628#define M_i2d_DISPLAYTEXT(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\
629						pp,a->type,V_ASN1_UNIVERSAL)
630#define M_d2i_DISPLAYTEXT(a,pp,l) \
631		d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \
632			B_ASN1_DISPLAYTEXT)
633
634#define M_ASN1_PRINTABLESTRING_new() (ASN1_PRINTABLESTRING *)\
635		ASN1_STRING_type_new(V_ASN1_PRINTABLESTRING)
636#define M_ASN1_PRINTABLESTRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
637#define M_i2d_ASN1_PRINTABLESTRING(a,pp) \
638		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_PRINTABLESTRING,\
639		V_ASN1_UNIVERSAL)
640#define M_d2i_ASN1_PRINTABLESTRING(a,pp,l) \
641		(ASN1_PRINTABLESTRING *)d2i_ASN1_type_bytes\
642		((ASN1_STRING **)a,pp,l,B_ASN1_PRINTABLESTRING)
643
644#define M_ASN1_T61STRING_new()	(ASN1_T61STRING *)\
645		ASN1_STRING_type_new(V_ASN1_T61STRING)
646#define M_ASN1_T61STRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
647#define M_i2d_ASN1_T61STRING(a,pp) \
648		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_T61STRING,\
649		V_ASN1_UNIVERSAL)
650#define M_d2i_ASN1_T61STRING(a,pp,l) \
651		(ASN1_T61STRING *)d2i_ASN1_type_bytes\
652		((ASN1_STRING **)a,pp,l,B_ASN1_T61STRING)
653
654#define M_ASN1_IA5STRING_new()	(ASN1_IA5STRING *)\
655		ASN1_STRING_type_new(V_ASN1_IA5STRING)
656#define M_ASN1_IA5STRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
657#define M_ASN1_IA5STRING_dup(a)	\
658		(ASN1_IA5STRING *)ASN1_STRING_dup((const ASN1_STRING *)a)
659#define M_i2d_ASN1_IA5STRING(a,pp) \
660		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_IA5STRING,\
661			V_ASN1_UNIVERSAL)
662#define M_d2i_ASN1_IA5STRING(a,pp,l) \
663		(ASN1_IA5STRING *)d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l,\
664			B_ASN1_IA5STRING)
665
666#define M_ASN1_UTCTIME_new()	(ASN1_UTCTIME *)\
667		ASN1_STRING_type_new(V_ASN1_UTCTIME)
668#define M_ASN1_UTCTIME_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
669#define M_ASN1_UTCTIME_dup(a) (ASN1_UTCTIME *)\
670		ASN1_STRING_dup((const ASN1_STRING *)a)
671
672#define M_ASN1_GENERALIZEDTIME_new()	(ASN1_GENERALIZEDTIME *)\
673		ASN1_STRING_type_new(V_ASN1_GENERALIZEDTIME)
674#define M_ASN1_GENERALIZEDTIME_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
675#define M_ASN1_GENERALIZEDTIME_dup(a) (ASN1_GENERALIZEDTIME *)ASN1_STRING_dup(\
676	(const ASN1_STRING *)a)
677
678#define M_ASN1_TIME_new()	(ASN1_TIME *)\
679		ASN1_STRING_type_new(V_ASN1_UTCTIME)
680#define M_ASN1_TIME_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
681#define M_ASN1_TIME_dup(a) (ASN1_TIME *)\
682	ASN1_STRING_dup((const ASN1_STRING *)a)
683
684#define M_ASN1_GENERALSTRING_new()	(ASN1_GENERALSTRING *)\
685		ASN1_STRING_type_new(V_ASN1_GENERALSTRING)
686#define M_ASN1_GENERALSTRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
687#define M_i2d_ASN1_GENERALSTRING(a,pp) \
688		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_GENERALSTRING,\
689			V_ASN1_UNIVERSAL)
690#define M_d2i_ASN1_GENERALSTRING(a,pp,l) \
691		(ASN1_GENERALSTRING *)d2i_ASN1_type_bytes\
692		((ASN1_STRING **)a,pp,l,B_ASN1_GENERALSTRING)
693
694#define M_ASN1_UNIVERSALSTRING_new()	(ASN1_UNIVERSALSTRING *)\
695		ASN1_STRING_type_new(V_ASN1_UNIVERSALSTRING)
696#define M_ASN1_UNIVERSALSTRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
697#define M_i2d_ASN1_UNIVERSALSTRING(a,pp) \
698		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_UNIVERSALSTRING,\
699			V_ASN1_UNIVERSAL)
700#define M_d2i_ASN1_UNIVERSALSTRING(a,pp,l) \
701		(ASN1_UNIVERSALSTRING *)d2i_ASN1_type_bytes\
702		((ASN1_STRING **)a,pp,l,B_ASN1_UNIVERSALSTRING)
703
704#define M_ASN1_BMPSTRING_new()	(ASN1_BMPSTRING *)\
705		ASN1_STRING_type_new(V_ASN1_BMPSTRING)
706#define M_ASN1_BMPSTRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
707#define M_i2d_ASN1_BMPSTRING(a,pp) \
708		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_BMPSTRING,\
709			V_ASN1_UNIVERSAL)
710#define M_d2i_ASN1_BMPSTRING(a,pp,l) \
711		(ASN1_BMPSTRING *)d2i_ASN1_type_bytes\
712		((ASN1_STRING **)a,pp,l,B_ASN1_BMPSTRING)
713
714#define M_ASN1_VISIBLESTRING_new()	(ASN1_VISIBLESTRING *)\
715		ASN1_STRING_type_new(V_ASN1_VISIBLESTRING)
716#define M_ASN1_VISIBLESTRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
717#define M_i2d_ASN1_VISIBLESTRING(a,pp) \
718		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_VISIBLESTRING,\
719			V_ASN1_UNIVERSAL)
720#define M_d2i_ASN1_VISIBLESTRING(a,pp,l) \
721		(ASN1_VISIBLESTRING *)d2i_ASN1_type_bytes\
722		((ASN1_STRING **)a,pp,l,B_ASN1_VISIBLESTRING)
723
724#define M_ASN1_UTF8STRING_new()	(ASN1_UTF8STRING *)\
725		ASN1_STRING_type_new(V_ASN1_UTF8STRING)
726#define M_ASN1_UTF8STRING_free(a)	ASN1_STRING_free((ASN1_STRING *)a)
727#define M_i2d_ASN1_UTF8STRING(a,pp) \
728		i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_UTF8STRING,\
729			V_ASN1_UNIVERSAL)
730#define M_d2i_ASN1_UTF8STRING(a,pp,l) \
731		(ASN1_UTF8STRING *)d2i_ASN1_type_bytes\
732		((ASN1_STRING **)a,pp,l,B_ASN1_UTF8STRING)
733
734  /* for the is_set parameter to i2d_ASN1_SET */
735#define IS_SEQUENCE	0
736#define IS_SET		1
737
738DECLARE_ASN1_FUNCTIONS_fname(ASN1_TYPE, ASN1_ANY, ASN1_TYPE)
739
740OPENSSL_EXPORT int ASN1_TYPE_get(ASN1_TYPE *a);
741OPENSSL_EXPORT void ASN1_TYPE_set(ASN1_TYPE *a, int type, void *value);
742OPENSSL_EXPORT int ASN1_TYPE_set1(ASN1_TYPE *a, int type, const void *value);
743OPENSSL_EXPORT int ASN1_TYPE_cmp(const ASN1_TYPE *a, const ASN1_TYPE *b);
744
745OPENSSL_EXPORT ASN1_OBJECT *	ASN1_OBJECT_new(void );
746OPENSSL_EXPORT void		ASN1_OBJECT_free(ASN1_OBJECT *a);
747OPENSSL_EXPORT int		i2d_ASN1_OBJECT(ASN1_OBJECT *a,unsigned char **pp);
748OPENSSL_EXPORT ASN1_OBJECT *	c2i_ASN1_OBJECT(ASN1_OBJECT **a,const unsigned char **pp,
749						long length);
750OPENSSL_EXPORT ASN1_OBJECT *	d2i_ASN1_OBJECT(ASN1_OBJECT **a,const unsigned char **pp,
751						long length);
752
753DECLARE_ASN1_ITEM(ASN1_OBJECT)
754
755DECLARE_ASN1_SET_OF(ASN1_OBJECT)
756
757OPENSSL_EXPORT ASN1_STRING *	ASN1_STRING_new(void);
758OPENSSL_EXPORT void		ASN1_STRING_free(ASN1_STRING *a);
759OPENSSL_EXPORT int		ASN1_STRING_copy(ASN1_STRING *dst, const ASN1_STRING *str);
760OPENSSL_EXPORT ASN1_STRING *	ASN1_STRING_dup(const ASN1_STRING *a);
761OPENSSL_EXPORT ASN1_STRING *	ASN1_STRING_type_new(int type );
762OPENSSL_EXPORT int 		ASN1_STRING_cmp(const ASN1_STRING *a, const ASN1_STRING *b);
763  /* Since this is used to store all sorts of things, via macros, for now, make
764     its data void * */
765OPENSSL_EXPORT int 		ASN1_STRING_set(ASN1_STRING *str, const void *data, int len);
766OPENSSL_EXPORT void		ASN1_STRING_set0(ASN1_STRING *str, void *data, int len);
767OPENSSL_EXPORT int ASN1_STRING_length(const ASN1_STRING *x);
768OPENSSL_EXPORT void ASN1_STRING_length_set(ASN1_STRING *x, int n);
769OPENSSL_EXPORT int ASN1_STRING_type(ASN1_STRING *x);
770OPENSSL_EXPORT unsigned char * ASN1_STRING_data(ASN1_STRING *x);
771
772DECLARE_ASN1_FUNCTIONS(ASN1_BIT_STRING)
773OPENSSL_EXPORT int		i2c_ASN1_BIT_STRING(ASN1_BIT_STRING *a,unsigned char **pp);
774OPENSSL_EXPORT ASN1_BIT_STRING *c2i_ASN1_BIT_STRING(ASN1_BIT_STRING **a,const unsigned char **pp, long length);
775OPENSSL_EXPORT int		ASN1_BIT_STRING_set(ASN1_BIT_STRING *a, unsigned char *d, int length );
776OPENSSL_EXPORT int		ASN1_BIT_STRING_set_bit(ASN1_BIT_STRING *a, int n, int value);
777OPENSSL_EXPORT int		ASN1_BIT_STRING_get_bit(ASN1_BIT_STRING *a, int n);
778OPENSSL_EXPORT int            ASN1_BIT_STRING_check(ASN1_BIT_STRING *a, unsigned char *flags, int flags_len);
779
780OPENSSL_EXPORT int ASN1_BIT_STRING_name_print(BIO *out, ASN1_BIT_STRING *bs, BIT_STRING_BITNAME *tbl, int indent);
781OPENSSL_EXPORT int ASN1_BIT_STRING_num_asc(char *name, BIT_STRING_BITNAME *tbl);
782OPENSSL_EXPORT int ASN1_BIT_STRING_set_asc(ASN1_BIT_STRING *bs, char *name, int value, BIT_STRING_BITNAME *tbl);
783
784OPENSSL_EXPORT int		i2d_ASN1_BOOLEAN(int a,unsigned char **pp);
785OPENSSL_EXPORT int 		d2i_ASN1_BOOLEAN(int *a,const unsigned char **pp,long length);
786
787DECLARE_ASN1_FUNCTIONS(ASN1_INTEGER)
788OPENSSL_EXPORT int		i2c_ASN1_INTEGER(ASN1_INTEGER *a,unsigned char **pp);
789OPENSSL_EXPORT ASN1_INTEGER *c2i_ASN1_INTEGER(ASN1_INTEGER **a,const unsigned char **pp, long length);
790OPENSSL_EXPORT ASN1_INTEGER *d2i_ASN1_UINTEGER(ASN1_INTEGER **a,const unsigned char **pp, long length);
791OPENSSL_EXPORT ASN1_INTEGER *	ASN1_INTEGER_dup(const ASN1_INTEGER *x);
792OPENSSL_EXPORT int ASN1_INTEGER_cmp(const ASN1_INTEGER *x, const ASN1_INTEGER *y);
793
794DECLARE_ASN1_FUNCTIONS(ASN1_ENUMERATED)
795
796OPENSSL_EXPORT int ASN1_UTCTIME_check(const ASN1_UTCTIME *a);
797OPENSSL_EXPORT ASN1_UTCTIME *ASN1_UTCTIME_set(ASN1_UTCTIME *s,time_t t);
798OPENSSL_EXPORT ASN1_UTCTIME *ASN1_UTCTIME_adj(ASN1_UTCTIME *s, time_t t, int offset_day, long offset_sec);
799OPENSSL_EXPORT int ASN1_UTCTIME_set_string(ASN1_UTCTIME *s, const char *str);
800OPENSSL_EXPORT int ASN1_UTCTIME_cmp_time_t(const ASN1_UTCTIME *s, time_t t);
801#if 0
802time_t ASN1_UTCTIME_get(const ASN1_UTCTIME *s);
803#endif
804
805OPENSSL_EXPORT int ASN1_GENERALIZEDTIME_check(const ASN1_GENERALIZEDTIME *a);
806OPENSSL_EXPORT ASN1_GENERALIZEDTIME *ASN1_GENERALIZEDTIME_set(ASN1_GENERALIZEDTIME *s,time_t t);
807OPENSSL_EXPORT ASN1_GENERALIZEDTIME *ASN1_GENERALIZEDTIME_adj(ASN1_GENERALIZEDTIME *s, time_t t, int offset_day, long offset_sec);
808OPENSSL_EXPORT int ASN1_GENERALIZEDTIME_set_string(ASN1_GENERALIZEDTIME *s, const char *str);
809OPENSSL_EXPORT int ASN1_TIME_diff(int *pday, int *psec, const ASN1_TIME *from, const ASN1_TIME *to);
810
811DECLARE_ASN1_FUNCTIONS(ASN1_OCTET_STRING)
812OPENSSL_EXPORT ASN1_OCTET_STRING *	ASN1_OCTET_STRING_dup(const ASN1_OCTET_STRING *a);
813OPENSSL_EXPORT int 	ASN1_OCTET_STRING_cmp(const ASN1_OCTET_STRING *a, const ASN1_OCTET_STRING *b);
814OPENSSL_EXPORT int 	ASN1_OCTET_STRING_set(ASN1_OCTET_STRING *str, const unsigned char *data, int len);
815
816DECLARE_ASN1_FUNCTIONS(ASN1_VISIBLESTRING)
817DECLARE_ASN1_FUNCTIONS(ASN1_UNIVERSALSTRING)
818DECLARE_ASN1_FUNCTIONS(ASN1_UTF8STRING)
819DECLARE_ASN1_FUNCTIONS(ASN1_NULL)
820DECLARE_ASN1_FUNCTIONS(ASN1_BMPSTRING)
821
822OPENSSL_EXPORT int UTF8_getc(const unsigned char *str, int len, unsigned long *val);
823OPENSSL_EXPORT int UTF8_putc(unsigned char *str, int len, unsigned long value);
824
825DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, ASN1_PRINTABLE)
826
827DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, DIRECTORYSTRING)
828DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, DISPLAYTEXT)
829DECLARE_ASN1_FUNCTIONS(ASN1_PRINTABLESTRING)
830DECLARE_ASN1_FUNCTIONS(ASN1_T61STRING)
831DECLARE_ASN1_FUNCTIONS(ASN1_IA5STRING)
832DECLARE_ASN1_FUNCTIONS(ASN1_GENERALSTRING)
833DECLARE_ASN1_FUNCTIONS(ASN1_UTCTIME)
834DECLARE_ASN1_FUNCTIONS(ASN1_GENERALIZEDTIME)
835DECLARE_ASN1_FUNCTIONS(ASN1_TIME)
836
837DECLARE_ASN1_ITEM(ASN1_OCTET_STRING_NDEF)
838
839OPENSSL_EXPORT ASN1_TIME *ASN1_TIME_set(ASN1_TIME *s,time_t t);
840OPENSSL_EXPORT ASN1_TIME *ASN1_TIME_adj(ASN1_TIME *s,time_t t, int offset_day, long offset_sec);
841OPENSSL_EXPORT int ASN1_TIME_check(ASN1_TIME *t);
842OPENSSL_EXPORT ASN1_GENERALIZEDTIME *ASN1_TIME_to_generalizedtime(ASN1_TIME *t, ASN1_GENERALIZEDTIME **out);
843OPENSSL_EXPORT int ASN1_TIME_set_string(ASN1_TIME *s, const char *str);
844
845OPENSSL_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);
846OPENSSL_EXPORT STACK_OF(OPENSSL_BLOCK) *d2i_ASN1_SET(STACK_OF(OPENSSL_BLOCK) **a,
847			      const unsigned char **pp,
848			      long length, d2i_of_void *d2i,
849			      void (*free_func)(OPENSSL_BLOCK), int ex_tag,
850			      int ex_class);
851
852OPENSSL_EXPORT int i2a_ASN1_INTEGER(BIO *bp, ASN1_INTEGER *a);
853OPENSSL_EXPORT int a2i_ASN1_INTEGER(BIO *bp,ASN1_INTEGER *bs,char *buf,int size);
854OPENSSL_EXPORT int i2a_ASN1_ENUMERATED(BIO *bp, ASN1_ENUMERATED *a);
855OPENSSL_EXPORT int a2i_ASN1_ENUMERATED(BIO *bp,ASN1_ENUMERATED *bs,char *buf,int size);
856OPENSSL_EXPORT int i2a_ASN1_OBJECT(BIO *bp,ASN1_OBJECT *a);
857OPENSSL_EXPORT int a2i_ASN1_STRING(BIO *bp,ASN1_STRING *bs,char *buf,int size);
858OPENSSL_EXPORT int i2a_ASN1_STRING(BIO *bp, ASN1_STRING *a, int type);
859OPENSSL_EXPORT int i2t_ASN1_OBJECT(char *buf,int buf_len,ASN1_OBJECT *a);
860
861OPENSSL_EXPORT int a2d_ASN1_OBJECT(unsigned char *out,int olen, const char *buf, int num);
862OPENSSL_EXPORT ASN1_OBJECT *ASN1_OBJECT_create(int nid, unsigned char *data,int len, const char *sn, const char *ln);
863
864OPENSSL_EXPORT int ASN1_INTEGER_set(ASN1_INTEGER *a, long v);
865OPENSSL_EXPORT long ASN1_INTEGER_get(const ASN1_INTEGER *a);
866OPENSSL_EXPORT ASN1_INTEGER *BN_to_ASN1_INTEGER(const BIGNUM *bn, ASN1_INTEGER *ai);
867OPENSSL_EXPORT BIGNUM *ASN1_INTEGER_to_BN(const ASN1_INTEGER *ai,BIGNUM *bn);
868
869OPENSSL_EXPORT int ASN1_ENUMERATED_set(ASN1_ENUMERATED *a, long v);
870OPENSSL_EXPORT long ASN1_ENUMERATED_get(ASN1_ENUMERATED *a);
871OPENSSL_EXPORT ASN1_ENUMERATED *BN_to_ASN1_ENUMERATED(BIGNUM *bn, ASN1_ENUMERATED *ai);
872OPENSSL_EXPORT BIGNUM *ASN1_ENUMERATED_to_BN(ASN1_ENUMERATED *ai,BIGNUM *bn);
873
874/* General */
875/* given a string, return the correct type, max is the maximum length */
876OPENSSL_EXPORT int ASN1_PRINTABLE_type(const unsigned char *s, int max);
877
878OPENSSL_EXPORT int i2d_ASN1_bytes(ASN1_STRING *a, unsigned char **pp, int tag, int xclass);
879OPENSSL_EXPORT ASN1_STRING *d2i_ASN1_bytes(ASN1_STRING **a, const unsigned char **pp, long length, int Ptag, int Pclass);
880OPENSSL_EXPORT unsigned long ASN1_tag2bit(int tag);
881/* type is one or more of the B_ASN1_ values. */
882OPENSSL_EXPORT ASN1_STRING *d2i_ASN1_type_bytes(ASN1_STRING **a,const unsigned char **pp, long length,int type);
883
884/* PARSING */
885OPENSSL_EXPORT int asn1_Finish(ASN1_CTX *c);
886OPENSSL_EXPORT int asn1_const_Finish(ASN1_const_CTX *c);
887
888/* SPECIALS */
889OPENSSL_EXPORT int ASN1_get_object(const unsigned char **pp, long *plength, int *ptag, int *pclass, long omax);
890OPENSSL_EXPORT int ASN1_check_infinite_end(unsigned char **p,long len);
891OPENSSL_EXPORT int ASN1_const_check_infinite_end(const unsigned char **p,long len);
892OPENSSL_EXPORT void ASN1_put_object(unsigned char **pp, int constructed, int length, int tag, int xclass);
893OPENSSL_EXPORT int ASN1_put_eoc(unsigned char **pp);
894OPENSSL_EXPORT int ASN1_object_size(int constructed, int length, int tag);
895
896/* Used to implement other functions */
897OPENSSL_EXPORT void *ASN1_dup(i2d_of_void *i2d, d2i_of_void *d2i, void *x);
898
899#define ASN1_dup_of(type,i2d,d2i,x) \
900    ((type*)ASN1_dup(CHECKED_I2D_OF(type, i2d), \
901		     CHECKED_D2I_OF(type, d2i), \
902		     CHECKED_PTR_OF(type, x)))
903
904#define ASN1_dup_of_const(type,i2d,d2i,x) \
905    ((type*)ASN1_dup(CHECKED_I2D_OF(const type, i2d), \
906		     CHECKED_D2I_OF(type, d2i), \
907		     CHECKED_PTR_OF(const type, x)))
908
909OPENSSL_EXPORT void *ASN1_item_dup(const ASN1_ITEM *it, void *x);
910
911/* ASN1 alloc/free macros for when a type is only used internally */
912
913#define M_ASN1_new_of(type) (type *)ASN1_item_new(ASN1_ITEM_rptr(type))
914#define M_ASN1_free_of(x, type) \
915		ASN1_item_free(CHECKED_PTR_OF(type, x), ASN1_ITEM_rptr(type))
916
917#ifndef OPENSSL_NO_FP_API
918OPENSSL_EXPORT void *ASN1_d2i_fp(void *(*xnew)(void), d2i_of_void *d2i, FILE *in, void **x);
919
920#define ASN1_d2i_fp_of(type,xnew,d2i,in,x) \
921    ((type*)ASN1_d2i_fp(CHECKED_NEW_OF(type, xnew), \
922			CHECKED_D2I_OF(type, d2i), \
923			in, \
924			CHECKED_PPTR_OF(type, x)))
925
926OPENSSL_EXPORT void *ASN1_item_d2i_fp(const ASN1_ITEM *it, FILE *in, void *x);
927OPENSSL_EXPORT int ASN1_i2d_fp(i2d_of_void *i2d,FILE *out,void *x);
928
929#define ASN1_i2d_fp_of(type,i2d,out,x) \
930    (ASN1_i2d_fp(CHECKED_I2D_OF(type, i2d), \
931		 out, \
932		 CHECKED_PTR_OF(type, x)))
933
934#define ASN1_i2d_fp_of_const(type,i2d,out,x) \
935    (ASN1_i2d_fp(CHECKED_I2D_OF(const type, i2d), \
936		 out, \
937		 CHECKED_PTR_OF(const type, x)))
938
939OPENSSL_EXPORT int ASN1_item_i2d_fp(const ASN1_ITEM *it, FILE *out, void *x);
940OPENSSL_EXPORT int ASN1_STRING_print_ex_fp(FILE *fp, ASN1_STRING *str, unsigned long flags);
941#endif
942
943OPENSSL_EXPORT int ASN1_STRING_to_UTF8(unsigned char **out, ASN1_STRING *in);
944
945OPENSSL_EXPORT void *ASN1_d2i_bio(void *(*xnew)(void), d2i_of_void *d2i, BIO *in, void **x);
946
947#define ASN1_d2i_bio_of(type,xnew,d2i,in,x) \
948    ((type*)ASN1_d2i_bio( CHECKED_NEW_OF(type, xnew), \
949			  CHECKED_D2I_OF(type, d2i), \
950			  in, \
951			  CHECKED_PPTR_OF(type, x)))
952
953OPENSSL_EXPORT void *ASN1_item_d2i_bio(const ASN1_ITEM *it, BIO *in, void *x);
954OPENSSL_EXPORT int ASN1_i2d_bio(i2d_of_void *i2d,BIO *out, void *x);
955
956#define ASN1_i2d_bio_of(type,i2d,out,x) \
957    (ASN1_i2d_bio(CHECKED_I2D_OF(type, i2d), \
958		  out, \
959		  CHECKED_PTR_OF(type, x)))
960
961#define ASN1_i2d_bio_of_const(type,i2d,out,x) \
962    (ASN1_i2d_bio(CHECKED_I2D_OF(const type, i2d), \
963		  out, \
964		  CHECKED_PTR_OF(const type, x)))
965
966OPENSSL_EXPORT int ASN1_item_i2d_bio(const ASN1_ITEM *it, BIO *out, void *x);
967OPENSSL_EXPORT int ASN1_UTCTIME_print(BIO *fp, const ASN1_UTCTIME *a);
968OPENSSL_EXPORT int ASN1_GENERALIZEDTIME_print(BIO *fp, const ASN1_GENERALIZEDTIME *a);
969OPENSSL_EXPORT int ASN1_TIME_print(BIO *fp, const ASN1_TIME *a);
970OPENSSL_EXPORT int ASN1_STRING_print(BIO *bp, const ASN1_STRING *v);
971OPENSSL_EXPORT int ASN1_STRING_print_ex(BIO *out, ASN1_STRING *str, unsigned long flags);
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 ASN1_TYPE *ASN1_generate_nconf(char *str, CONF *nconf);
1014OPENSSL_EXPORT ASN1_TYPE *ASN1_generate_v3(char *str, X509V3_CTX *cnf);
1015
1016
1017#ifdef  __cplusplus
1018}
1019#endif
1020
1021#define ASN1_R_ASN1_LENGTH_MISMATCH 100
1022#define ASN1_R_AUX_ERROR 101
1023#define ASN1_R_BAD_GET_ASN1_OBJECT_CALL 102
1024#define ASN1_R_BAD_OBJECT_HEADER 103
1025#define ASN1_R_BMPSTRING_IS_WRONG_LENGTH 104
1026#define ASN1_R_BN_LIB 105
1027#define ASN1_R_BOOLEAN_IS_WRONG_LENGTH 106
1028#define ASN1_R_BUFFER_TOO_SMALL 107
1029#define ASN1_R_CONTEXT_NOT_INITIALISED 108
1030#define ASN1_R_DECODE_ERROR 109
1031#define ASN1_R_DEPTH_EXCEEDED 110
1032#define ASN1_R_DIGEST_AND_KEY_TYPE_NOT_SUPPORTED 111
1033#define ASN1_R_ENCODE_ERROR 112
1034#define ASN1_R_ERROR_GETTING_TIME 113
1035#define ASN1_R_EXPECTING_AN_ASN1_SEQUENCE 114
1036#define ASN1_R_EXPECTING_AN_INTEGER 115
1037#define ASN1_R_EXPECTING_AN_OBJECT 116
1038#define ASN1_R_EXPECTING_A_BOOLEAN 117
1039#define ASN1_R_EXPECTING_A_TIME 118
1040#define ASN1_R_EXPLICIT_LENGTH_MISMATCH 119
1041#define ASN1_R_EXPLICIT_TAG_NOT_CONSTRUCTED 120
1042#define ASN1_R_FIELD_MISSING 121
1043#define ASN1_R_FIRST_NUM_TOO_LARGE 122
1044#define ASN1_R_HEADER_TOO_LONG 123
1045#define ASN1_R_ILLEGAL_BITSTRING_FORMAT 124
1046#define ASN1_R_ILLEGAL_BOOLEAN 125
1047#define ASN1_R_ILLEGAL_CHARACTERS 126
1048#define ASN1_R_ILLEGAL_FORMAT 127
1049#define ASN1_R_ILLEGAL_HEX 128
1050#define ASN1_R_ILLEGAL_IMPLICIT_TAG 129
1051#define ASN1_R_ILLEGAL_INTEGER 130
1052#define ASN1_R_ILLEGAL_NESTED_TAGGING 131
1053#define ASN1_R_ILLEGAL_NULL 132
1054#define ASN1_R_ILLEGAL_NULL_VALUE 133
1055#define ASN1_R_ILLEGAL_OBJECT 134
1056#define ASN1_R_ILLEGAL_OPTIONAL_ANY 135
1057#define ASN1_R_ILLEGAL_OPTIONS_ON_ITEM_TEMPLATE 136
1058#define ASN1_R_ILLEGAL_TAGGED_ANY 137
1059#define ASN1_R_ILLEGAL_TIME_VALUE 138
1060#define ASN1_R_INTEGER_NOT_ASCII_FORMAT 139
1061#define ASN1_R_INTEGER_TOO_LARGE_FOR_LONG 140
1062#define ASN1_R_INVALID_BIT_STRING_BITS_LEFT 141
1063#define ASN1_R_INVALID_BMPSTRING_LENGTH 142
1064#define ASN1_R_INVALID_DIGIT 143
1065#define ASN1_R_INVALID_MODIFIER 144
1066#define ASN1_R_INVALID_NUMBER 145
1067#define ASN1_R_INVALID_OBJECT_ENCODING 146
1068#define ASN1_R_INVALID_SEPARATOR 147
1069#define ASN1_R_INVALID_TIME_FORMAT 148
1070#define ASN1_R_INVALID_UNIVERSALSTRING_LENGTH 149
1071#define ASN1_R_INVALID_UTF8STRING 150
1072#define ASN1_R_LIST_ERROR 151
1073#define ASN1_R_MISSING_ASN1_EOS 152
1074#define ASN1_R_MISSING_EOC 153
1075#define ASN1_R_MISSING_SECOND_NUMBER 154
1076#define ASN1_R_MISSING_VALUE 155
1077#define ASN1_R_MSTRING_NOT_UNIVERSAL 156
1078#define ASN1_R_MSTRING_WRONG_TAG 157
1079#define ASN1_R_NESTED_ASN1_ERROR 158
1080#define ASN1_R_NESTED_ASN1_STRING 159
1081#define ASN1_R_NON_HEX_CHARACTERS 160
1082#define ASN1_R_NOT_ASCII_FORMAT 161
1083#define ASN1_R_NOT_ENOUGH_DATA 162
1084#define ASN1_R_NO_MATCHING_CHOICE_TYPE 163
1085#define ASN1_R_NULL_IS_WRONG_LENGTH 164
1086#define ASN1_R_OBJECT_NOT_ASCII_FORMAT 165
1087#define ASN1_R_ODD_NUMBER_OF_CHARS 166
1088#define ASN1_R_SECOND_NUMBER_TOO_LARGE 167
1089#define ASN1_R_SEQUENCE_LENGTH_MISMATCH 168
1090#define ASN1_R_SEQUENCE_NOT_CONSTRUCTED 169
1091#define ASN1_R_SEQUENCE_OR_SET_NEEDS_CONFIG 170
1092#define ASN1_R_SHORT_LINE 171
1093#define ASN1_R_STREAMING_NOT_SUPPORTED 172
1094#define ASN1_R_STRING_TOO_LONG 173
1095#define ASN1_R_STRING_TOO_SHORT 174
1096#define ASN1_R_TAG_VALUE_TOO_HIGH 175
1097#define ASN1_R_TIME_NOT_ASCII_FORMAT 176
1098#define ASN1_R_TOO_LONG 177
1099#define ASN1_R_TYPE_NOT_CONSTRUCTED 178
1100#define ASN1_R_TYPE_NOT_PRIMITIVE 179
1101#define ASN1_R_UNEXPECTED_EOC 180
1102#define ASN1_R_UNIVERSALSTRING_IS_WRONG_LENGTH 181
1103#define ASN1_R_UNKNOWN_FORMAT 182
1104#define ASN1_R_UNKNOWN_MESSAGE_DIGEST_ALGORITHM 183
1105#define ASN1_R_UNKNOWN_SIGNATURE_ALGORITHM 184
1106#define ASN1_R_UNKNOWN_TAG 185
1107#define ASN1_R_UNSUPPORTED_ANY_DEFINED_BY_TYPE 186
1108#define ASN1_R_UNSUPPORTED_PUBLIC_KEY_TYPE 187
1109#define ASN1_R_UNSUPPORTED_TYPE 188
1110#define ASN1_R_WRONG_PUBLIC_KEY_TYPE 189
1111#define ASN1_R_WRONG_TAG 190
1112#define ASN1_R_WRONG_TYPE 191
1113
1114#endif
1115