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