Merge from vendor branch HEIMDAL:
[dragonfly.git] / crypto / heimdal-0.6.3 / lib / asn1 / der.h
1 /*
2  * Copyright (c) 1997 - 2001 Kungliga Tekniska Högskolan
3  * (Royal Institute of Technology, Stockholm, Sweden). 
4  * All rights reserved. 
5  *
6  * Redistribution and use in source and binary forms, with or without 
7  * modification, are permitted provided that the following conditions 
8  * are met: 
9  *
10  * 1. Redistributions of source code must retain the above copyright 
11  *    notice, this list of conditions and the following disclaimer. 
12  *
13  * 2. Redistributions in binary form must reproduce the above copyright 
14  *    notice, this list of conditions and the following disclaimer in the 
15  *    documentation and/or other materials provided with the distribution. 
16  *
17  * 3. Neither the name of the Institute nor the names of its contributors 
18  *    may be used to endorse or promote products derived from this software 
19  *    without specific prior written permission. 
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND 
22  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 
24  * ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE 
25  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 
26  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 
27  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 
28  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
29  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 
30  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 
31  * SUCH DAMAGE. 
32  */
33
34 /* $Id: der.h,v 1.22 2001/09/27 16:20:35 assar Exp $ */
35
36 #ifndef __DER_H__
37 #define __DER_H__
38
39 #include <time.h>
40
41 typedef enum {UNIV = 0, APPL = 1, CONTEXT = 2 , PRIVATE = 3} Der_class;
42
43 typedef enum {PRIM = 0, CONS = 1} Der_type;
44
45 /* Universal tags */
46
47 enum {
48      UT_Boolean         = 1,
49      UT_Integer         = 2,
50      UT_BitString       = 3,
51      UT_OctetString     = 4,
52      UT_Null            = 5,
53      UT_OID             = 6,
54      UT_Enumerated      = 10,
55      UT_Sequence        = 16,
56      UT_Set             = 17,
57      UT_PrintableString = 19,
58      UT_IA5String       = 22,
59      UT_UTCTime         = 23,
60      UT_GeneralizedTime = 24,
61      UT_VisibleString   = 26,
62      UT_GeneralString   = 27
63 };
64
65 #define ASN1_INDEFINITE 0xdce0deed
66
67 #ifndef HAVE_TIMEGM
68 time_t timegm (struct tm *);
69 #endif
70
71 int time2generalizedtime (time_t t, octet_string *s);
72
73 int der_get_int (const unsigned char *p, size_t len, int *ret, size_t *size);
74 int der_get_length (const unsigned char *p, size_t len,
75                     size_t *val, size_t *size);
76 int der_get_general_string (const unsigned char *p, size_t len, 
77                             general_string *str, size_t *size);
78 int der_get_octet_string (const unsigned char *p, size_t len, 
79                           octet_string *data, size_t *size);
80 int der_get_oid (const unsigned char *p, size_t len,
81                  oid *data, size_t *size);
82 int der_get_tag (const unsigned char *p, size_t len, 
83                  Der_class *class, Der_type *type,
84                  int *tag, size_t *size);
85
86 int der_match_tag (const unsigned char *p, size_t len, 
87                    Der_class class, Der_type type,
88                    int tag, size_t *size);
89 int der_match_tag_and_length (const unsigned char *p, size_t len,
90                               Der_class class, Der_type type, int tag,
91                               size_t *length_ret, size_t *size);
92
93 int decode_integer (const unsigned char*, size_t, int*, size_t*);
94 int decode_unsigned (const unsigned char*, size_t, unsigned*, size_t*);
95 int decode_enumerated (const unsigned char*, size_t, unsigned*, size_t*);
96 int decode_general_string (const unsigned char*, size_t,
97                            general_string*, size_t*);
98 int decode_oid (const unsigned char *p, size_t len, 
99                 oid *k, size_t *size);
100 int decode_octet_string (const unsigned char*, size_t, octet_string*, size_t*);
101 int decode_generalized_time (const unsigned char*, size_t, time_t*, size_t*);
102
103 int der_put_int (unsigned char *p, size_t len, int val, size_t*);
104 int der_put_length (unsigned char *p, size_t len, size_t val, size_t*);
105 int der_put_general_string (unsigned char *p, size_t len,
106                             const general_string *str, size_t*);
107 int der_put_octet_string (unsigned char *p, size_t len,
108                           const octet_string *data, size_t*);
109 int der_put_oid (unsigned char *p, size_t len,
110                  const oid *data, size_t *size);
111 int der_put_tag (unsigned char *p, size_t len, Der_class class, Der_type type,
112                  int tag, size_t*);
113 int der_put_length_and_tag (unsigned char*, size_t, size_t, 
114                             Der_class, Der_type, int, size_t*);
115
116 int encode_integer (unsigned char *p, size_t len,
117                     const int *data, size_t*);
118 int encode_unsigned (unsigned char *p, size_t len,
119                      const unsigned *data, size_t*);
120 int encode_enumerated (unsigned char *p, size_t len,
121                        const unsigned *data, size_t*);
122 int encode_general_string (unsigned char *p, size_t len, 
123                            const general_string *data, size_t*);
124 int encode_octet_string (unsigned char *p, size_t len,
125                          const octet_string *k, size_t*);
126 int encode_oid (unsigned char *p, size_t len,
127                 const oid *k, size_t*);
128 int encode_generalized_time (unsigned char *p, size_t len,
129                              const time_t *t, size_t*);
130
131 void free_integer (int *num);
132 void free_general_string (general_string *str);
133 void free_octet_string (octet_string *k);
134 void free_oid (oid *k);
135 void free_generalized_time (time_t *t);
136
137 size_t length_len (size_t len);
138 size_t length_integer (const int *data);
139 size_t length_unsigned (const unsigned *data);
140 size_t length_enumerated (const unsigned *data);
141 size_t length_general_string (const general_string *data);
142 size_t length_octet_string (const octet_string *k);
143 size_t length_oid (const oid *k);
144 size_t length_generalized_time (const time_t *t);
145
146 int copy_general_string (const general_string *from, general_string *to);
147 int copy_octet_string (const octet_string *from, octet_string *to);
148 int copy_oid (const oid *from, oid *to);
149
150 int fix_dce(size_t reallen, size_t *len);
151
152 #endif /* __DER_H__ */