Remove /* foo.c */ comments
[openssl.git] / crypto / asn1 / tasn_fre.c
1 /*
2  * Written by Dr Stephen N Henson (steve@openssl.org) for the OpenSSL project
3  * 2000.
4  */
5 /* ====================================================================
6  * Copyright (c) 2000 The OpenSSL Project.  All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  *
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice, this list of conditions and the following disclaimer.
14  *
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in
17  *    the documentation and/or other materials provided with the
18  *    distribution.
19  *
20  * 3. All advertising materials mentioning features or use of this
21  *    software must display the following acknowledgment:
22  *    "This product includes software developed by the OpenSSL Project
23  *    for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
24  *
25  * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
26  *    endorse or promote products derived from this software without
27  *    prior written permission. For written permission, please contact
28  *    licensing@OpenSSL.org.
29  *
30  * 5. Products derived from this software may not be called "OpenSSL"
31  *    nor may "OpenSSL" appear in their names without prior written
32  *    permission of the OpenSSL Project.
33  *
34  * 6. Redistributions of any form whatsoever must retain the following
35  *    acknowledgment:
36  *    "This product includes software developed by the OpenSSL Project
37  *    for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
38  *
39  * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
40  * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
41  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
42  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
43  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
44  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
45  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
46  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
48  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
49  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
50  * OF THE POSSIBILITY OF SUCH DAMAGE.
51  * ====================================================================
52  *
53  * This product includes cryptographic software written by Eric Young
54  * (eay@cryptsoft.com).  This product includes software written by Tim
55  * Hudson (tjh@cryptsoft.com).
56  *
57  */
58
59 #include <stddef.h>
60 #include <openssl/asn1.h>
61 #include <openssl/asn1t.h>
62 #include <openssl/objects.h>
63 #include "asn1_locl.h"
64
65 static void asn1_item_embed_free(ASN1_VALUE **pval, const ASN1_ITEM *it,
66                                  int embed);
67
68 /* Free up an ASN1 structure */
69
70 void ASN1_item_free(ASN1_VALUE *val, const ASN1_ITEM *it)
71 {
72     asn1_item_embed_free(&val, it, 0);
73 }
74
75 void ASN1_item_ex_free(ASN1_VALUE **pval, const ASN1_ITEM *it)
76 {
77     asn1_item_embed_free(pval, it, 0);
78 }
79
80 static void asn1_item_embed_free(ASN1_VALUE **pval, const ASN1_ITEM *it,
81                                  int embed)
82 {
83     const ASN1_TEMPLATE *tt = NULL, *seqtt;
84     const ASN1_EXTERN_FUNCS *ef;
85     const ASN1_AUX *aux = it->funcs;
86     ASN1_aux_cb *asn1_cb;
87     int i;
88
89     if (!pval)
90         return;
91     if ((it->itype != ASN1_ITYPE_PRIMITIVE) && !*pval)
92         return;
93     if (aux && aux->asn1_cb)
94         asn1_cb = aux->asn1_cb;
95     else
96         asn1_cb = 0;
97
98     switch (it->itype) {
99
100     case ASN1_ITYPE_PRIMITIVE:
101         if (it->templates)
102             asn1_template_free(pval, it->templates);
103         else
104             asn1_primitive_free(pval, it);
105         break;
106
107     case ASN1_ITYPE_MSTRING:
108         asn1_primitive_free(pval, it);
109         break;
110
111     case ASN1_ITYPE_CHOICE:
112         if (asn1_cb) {
113             i = asn1_cb(ASN1_OP_FREE_PRE, pval, it, NULL);
114             if (i == 2)
115                 return;
116         }
117         i = asn1_get_choice_selector(pval, it);
118         if ((i >= 0) && (i < it->tcount)) {
119             ASN1_VALUE **pchval;
120
121             tt = it->templates + i;
122             pchval = asn1_get_field_ptr(pval, tt);
123             asn1_template_free(pchval, tt);
124         }
125         if (asn1_cb)
126             asn1_cb(ASN1_OP_FREE_POST, pval, it, NULL);
127         if (embed == 0) {
128             OPENSSL_free(*pval);
129             *pval = NULL;
130         }
131         break;
132
133     case ASN1_ITYPE_EXTERN:
134         ef = it->funcs;
135         if (ef && ef->asn1_ex_free)
136             ef->asn1_ex_free(pval, it);
137         break;
138
139     case ASN1_ITYPE_NDEF_SEQUENCE:
140     case ASN1_ITYPE_SEQUENCE:
141         if (asn1_do_lock(pval, -1, it) > 0)
142             return;
143         if (asn1_cb) {
144             i = asn1_cb(ASN1_OP_FREE_PRE, pval, it, NULL);
145             if (i == 2)
146                 return;
147         }
148         asn1_enc_free(pval, it);
149         /*
150          * If we free up as normal we will invalidate any ANY DEFINED BY
151          * field and we wont be able to determine the type of the field it
152          * defines. So free up in reverse order.
153          */
154         tt = it->templates + it->tcount - 1;
155         for (i = 0; i < it->tcount; tt--, i++) {
156             ASN1_VALUE **pseqval;
157             seqtt = asn1_do_adb(pval, tt, 0);
158             if (!seqtt)
159                 continue;
160             pseqval = asn1_get_field_ptr(pval, seqtt);
161             asn1_template_free(pseqval, seqtt);
162         }
163         if (asn1_cb)
164             asn1_cb(ASN1_OP_FREE_POST, pval, it, NULL);
165         if (embed == 0) {
166             OPENSSL_free(*pval);
167             *pval = NULL;
168         }
169         break;
170     }
171 }
172
173 void asn1_template_free(ASN1_VALUE **pval, const ASN1_TEMPLATE *tt)
174 {
175     int embed = tt->flags & ASN1_TFLG_EMBED;
176     ASN1_VALUE *tval;
177     if (embed) {
178         tval = (ASN1_VALUE *)pval;
179         pval = &tval;
180     }
181     if (tt->flags & ASN1_TFLG_SK_MASK) {
182         STACK_OF(ASN1_VALUE) *sk = (STACK_OF(ASN1_VALUE) *)*pval;
183         int i;
184
185         for (i = 0; i < sk_ASN1_VALUE_num(sk); i++) {
186             ASN1_VALUE *vtmp = sk_ASN1_VALUE_value(sk, i);
187
188             asn1_item_embed_free(&vtmp, ASN1_ITEM_ptr(tt->item), embed);
189         }
190         sk_ASN1_VALUE_free(sk);
191         *pval = NULL;
192     } else {
193         asn1_item_embed_free(pval, ASN1_ITEM_ptr(tt->item), embed);
194     }
195 }
196
197 void asn1_primitive_free(ASN1_VALUE **pval, const ASN1_ITEM *it)
198 {
199     int utype;
200
201     /* Special case: if 'it' is a primitive with a free_func, use that. */
202     if (it) {
203         const ASN1_PRIMITIVE_FUNCS *pf = it->funcs;
204
205         if (pf && pf->prim_free) {
206             pf->prim_free(pval, it);
207             return;
208         }
209     }
210
211     /* Special case: if 'it' is NULL, free contents of ASN1_TYPE */
212     if (!it) {
213         ASN1_TYPE *typ = (ASN1_TYPE *)*pval;
214
215         utype = typ->type;
216         pval = &typ->value.asn1_value;
217         if (!*pval)
218             return;
219     } else if (it->itype == ASN1_ITYPE_MSTRING) {
220         utype = -1;
221         if (!*pval)
222             return;
223     } else {
224         utype = it->utype;
225         if ((utype != V_ASN1_BOOLEAN) && !*pval)
226             return;
227     }
228
229     switch (utype) {
230     case V_ASN1_OBJECT:
231         ASN1_OBJECT_free((ASN1_OBJECT *)*pval);
232         break;
233
234     case V_ASN1_BOOLEAN:
235         if (it)
236             *(ASN1_BOOLEAN *)pval = it->size;
237         else
238             *(ASN1_BOOLEAN *)pval = -1;
239         return;
240
241     case V_ASN1_NULL:
242         break;
243
244     case V_ASN1_ANY:
245         asn1_primitive_free(pval, NULL);
246         OPENSSL_free(*pval);
247         break;
248
249     default:
250         ASN1_STRING_free((ASN1_STRING *)*pval);
251         break;
252     }
253     *pval = NULL;
254 }