add missing \n at end
[libfirm] / ir / tr / trvrfy.c
1 /*
2  * Copyright (C) 1995-2007 University of Karlsruhe.  All right reserved.
3  *
4  * This file is part of libFirm.
5  *
6  * This file may be distributed and/or modified under the terms of the
7  * GNU General Public License version 2 as published by the Free Software
8  * Foundation and appearing in the file LICENSE.GPL included in the
9  * packaging of this file.
10  *
11  * Licensees holding valid libFirm Professional Edition licenses may use
12  * this file in accordance with the libFirm Commercial License.
13  * Agreement provided with the Software.
14  *
15  * This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
16  * WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17  * PURPOSE.
18  */
19
20 /**
21  * @file    tr_inheritance.c
22  * @brief   Check types and entities for correctness.
23  * @date    29.1.2003
24  * @author  Michael Beck, Goetz Lindenmaier
25  * @version $Id$
26  */
27 #ifdef HAVE_CONFIG_H
28 #include "config.h"
29 #endif
30
31 #include "irgraph_t.h"  /* for checking whether constant code is allocated
32                            on proper obstack */
33 #include "irflag_t.h"
34 #include "irprintf.h"
35 #include "irgwalk.h"
36
37
38 #ifdef NDEBUG
39 /*
40  * in RELEASE mode, returns ret if the expression expr evaluates to zero
41  * in ASSERT mode, asserts the expression expr (and the string string).
42  */
43 #define ASSERT_AND_RET(expr, string, ret)       if (!(expr)) return (ret)
44
45 /*
46  * in RELEASE mode, returns ret if the expression expr evaluates to zero
47  * in ASSERT mode, executes blk if the expression expr evaluates to zero and asserts expr
48  */
49 #define ASSERT_AND_RET_DBG(expr, string, ret, blk)      if (!(expr)) return (ret)
50 #else
51 #define ASSERT_AND_RET(expr, string, ret) \
52 do { \
53   if (opt_do_node_verification == FIRM_VERIFICATION_ON) {\
54     assert((expr) && string); } \
55   if (!(expr)) { \
56     if (opt_do_node_verification == FIRM_VERIFICATION_REPORT) \
57       fprintf(stderr, #expr " : " string "\n"); \
58     firm_vrfy_failure_msg = #expr " && " string; \
59     return (ret); \
60   } \
61 } while(0)
62
63 #define ASSERT_AND_RET_DBG(expr, string, ret, blk) \
64 do { \
65   if (!(expr)) { \
66     firm_vrfy_failure_msg = #expr " && " string; \
67     if (opt_do_node_verification != FIRM_VERIFICATION_ERROR_ONLY) { blk; } \
68     if (opt_do_node_verification == FIRM_VERIFICATION_REPORT) \
69       fprintf(stderr, #expr " : " string "\n"); \
70     else if (opt_do_node_verification == FIRM_VERIFICATION_ON) { \
71       assert((expr) && string); \
72     } \
73     return (ret); \
74   } \
75 } while(0)
76
77 #endif /* NDEBUG */
78
79 #ifndef NDEBUG
80
81 static const char *firm_vrfy_failure_msg;
82
83 /**
84  * Show diagnostic if an entity overwrites another one not
85  * in direct superclasses.
86  */
87 static void show_ent_not_supertp(ir_entity *ent, ir_entity *ovw) {
88         ir_type *owner = get_entity_owner(ent);
89         ir_type *ov_own = get_entity_owner(ovw);
90         int i;
91
92         fprintf(stderr, "Type verification error:\n");
93         ir_fprintf(stderr, "Entity %+F::%+e owerwrites ", owner, ent);
94         ir_fprintf(stderr, "Entity %+F::%+e\n", ov_own, ovw);
95
96         ir_fprintf(stderr, "Supertypes of %+F:\n", owner);
97         for (i = 0; i < get_class_n_supertypes(owner); ++i) {
98                 ir_type *super = get_class_supertype(owner, i);
99                 ir_fprintf(stderr, " %+F:\n", super);
100         }
101 }
102
103 /**
104  * Show diagnostic if an entity overwrites a wrong number of things.
105  */
106 static void show_ent_overwrite_cnt(ir_entity *ent) {
107         ir_type *owner = get_entity_owner(ent);
108         int i, j, k, found, show_stp = 0;
109
110         fprintf(stderr, "Type verification error:\n");
111         ir_fprintf(stderr, "Entity %t::%e owerwrites\n", owner, ent);
112         for (i = 0; i < get_entity_n_overwrites(ent); ++i) {
113                 ir_entity *ovw = get_entity_overwrites(ent, i);
114                 ir_type *ov_own = get_entity_owner(ovw);
115
116                 ir_fprintf(stderr, "  %t::%e\n", ov_own, ovw);
117                 for (k = 0; k < i; ++k)
118                         if (ovw == get_entity_overwrites(ent, k)) {
119                                 ir_fprintf(stderr, "  ->%t::%e entered more than once\n", ov_own, ovw);
120                                 break;
121                         }
122
123                 found = 0;
124                 for (j = get_class_n_supertypes(owner) - 1; j >= 0; --j) {
125                         if (ov_own == get_class_supertype(owner, j)) {
126                                 show_stp = found = 1;
127                                 break;
128                         }
129                 }
130                 if (! found)
131                         ir_fprintf(stderr, "  ->%t not in super types of %t\n", ov_own, owner);
132         }
133
134         if (show_stp) {
135                 ir_fprintf(stderr, "Supertypes of %t:\n", owner);
136                 for (i = 0; i < get_class_n_supertypes(owner); ++i) {
137                         ir_type *super = get_class_supertype(owner, i);
138                         ir_fprintf(stderr, " %t:\n", super);
139                 }
140         }
141 }
142
143 /**
144  * Shows a wrong entity allocation
145  */
146 static void show_ent_alloc_error(ir_entity *ent) {
147         ir_fprintf(stderr, "%+e owner %t has allocation %s\n",
148                 ent, get_entity_type(ent),
149                 get_allocation_name(get_entity_allocation(ent)));
150 }
151
152 #endif /* #ifndef NDEBUG */
153
154 /**
155  * Check a class
156  */
157 static int check_class(ir_type *tp) {
158         int i, j, k;
159         int found;
160
161         for (i = get_class_n_members(tp) - 1; i >= 0; --i) {
162                 ir_entity *mem = get_class_member(tp, i);
163
164                 ASSERT_AND_RET_DBG(
165                         tp == get_entity_owner(mem),
166                         "class member with wrong owner",
167                         error_ent_wrong_owner,
168                         ir_fprintf(stderr, "Type verification error:\n%+F %+e(owner %+F)\n",tp, mem, get_entity_owner(mem))
169                 );
170                 ASSERT_AND_RET_DBG(
171                         mem,
172                         "NULL members not allowed",
173                         error_null_mem,
174                         ir_fprintf(stderr, "Type verification error:\n%+F member %d is NULL\n", tp, i)
175                 );
176
177                 ASSERT_AND_RET_DBG(
178                         get_entity_n_overwrites(mem) <= get_class_n_supertypes(tp),
179                         "wrong number of entity overwrites",
180                         error_wrong_ent_overwrites,
181                         show_ent_overwrite_cnt(mem)
182                 );
183
184                 for (j = get_entity_n_overwrites(mem) - 1; j >= 0; --j) {
185                         ir_entity *ovw = get_entity_overwrites(mem, j);
186                         /*printf(" overwrites: "); DDME(ovw);*/
187                         /* Check whether ovw is member of one of tp's supertypes. If so,
188                         the representation is correct. */
189                         found = 0;
190                         for (k = get_class_n_supertypes(tp) - 1; k >= 0; --k) {
191                                 if (get_class_member_index(get_class_supertype(tp, k), ovw) >= 0) {
192                                         found = 1;
193                                         break;
194                                 }
195                         }
196                         ASSERT_AND_RET_DBG(
197                                 found,
198                                 "overwrites an entity not contained in direct supertype",
199                                 error_ent_not_cont,
200                                 show_ent_not_supertp(mem, ovw)
201                         );
202                 }
203         }
204         return 0;
205 }
206
207 /**
208  * Check an array.
209  */
210 static int check_array(ir_type *tp) {
211         int i, n_dim = get_array_n_dimensions(tp);
212
213         for (i = 0; i < n_dim; ++i) {
214                 ASSERT_AND_RET_DBG(
215                         has_array_lower_bound(tp, i) || has_array_upper_bound(tp, i),
216                         "array bound missing",
217                         1,
218                         ir_fprintf(stderr, "%+F in dimension %d\n", tp, i)
219                 );
220         }
221         return 0;
222 }
223
224
225 /**
226  * Check a primitive.
227  */
228 static int check_primitive(ir_type *tp) {
229         ASSERT_AND_RET_DBG(
230                 is_mode(get_type_mode(tp)),
231                 "Primitive type without mode",
232                 1,
233                 ir_fprintf(stderr, "%+F\n", tp)
234         );
235         return 0;
236 }
237
238
239 /*
240  * Checks a type.
241  *
242  * return
243  *  0   if no error encountered
244  */
245 int check_type(ir_type *tp) {
246         switch (get_type_tpop_code(tp)) {
247         case tpo_class:
248                 return check_class(tp);
249         case tpo_array:
250                 return check_array(tp);
251         case tpo_primitive:
252                 return check_primitive(tp);
253         default: break;
254         }
255         return 0;
256 }
257
258 /**
259  * checks the visited flag
260  */
261 static int check_visited_flag(ir_graph *irg, ir_node *n) {
262         ASSERT_AND_RET_DBG(
263                 get_irn_visited(n) <= get_irg_visited(irg),
264                 "Visited flag of node is larger than that of corresponding irg.",
265                 0,
266                 ir_fprintf(stderr, "%+F in %+F\n", n, irg)
267         );
268         return 1;
269 }
270
271 /**
272  * helper environment struct for constant_on_wrong_obstack()
273  */
274 struct myenv {
275         int res;
276         ir_graph *irg;
277 };
278
279 /**
280  * called by the walker
281  */
282 static void on_irg_storage(ir_node *n, void *env) {
283         struct myenv *myenv = env;
284
285         /* We also test whether the setting of the visited flag is legal. */
286         myenv->res = node_is_in_irgs_storage(myenv->irg, n) &&
287                      check_visited_flag(myenv->irg, n);
288 }
289
290 /**
291  * checks whether a given constant IR node is NOT on the
292  * constant IR graph.
293  */
294 static int constant_on_wrong_irg(ir_node *n) {
295         struct myenv env;
296
297         env.res = 1;  /* on right obstack */
298         env.irg = get_const_code_irg();
299
300         irg_walk(n, on_irg_storage, NULL, (void *)&env);
301         return ! env.res;
302 }
303
304 /**
305  * Check if constants node are NOT on the constant IR graph.
306  *
307  * @return NON-zero if an entity initializer constant is NOT on
308  * the current_ir_graph's obstack.
309  */
310 static int constants_on_wrong_irg(ir_entity *ent) {
311         if (get_entity_variability(ent) == variability_uninitialized) return 0;
312
313         if (is_compound_entity(ent)) {
314                 int i;
315                 for (i = get_compound_ent_n_values(ent) - 1; i >= 0; --i) {
316                         if (constant_on_wrong_irg(get_compound_ent_value(ent, i)))
317                                 return 1;
318                 }
319         } else {
320                 /* Might not be set if entity belongs to a description or is external allocated. */
321                 if (get_atomic_ent_value(ent))
322                         return constant_on_wrong_irg(get_atomic_ent_value(ent));
323                 else if (get_entity_visibility(ent) != visibility_external_allocated) {
324                         ASSERT_AND_RET_DBG(
325                                 is_Class_type(get_entity_owner(ent)) &&
326                                 get_class_peculiarity(get_entity_owner(ent)) == peculiarity_description,
327                                 "Value in constant atomic entity not set.",
328                                 0,
329                                 ir_fprintf(stderr, "%+e, owner %+F\n", ent, get_entity_owner(ent))
330                         );
331                 }
332         }
333         return 0;
334 }
335
336 /*
337  * Check an entity. Currently, we check only if initialized constants
338  * are build on the const irg graph.
339  *
340  * @return
341  *  0   if no error encountered
342  *  != 0    a trvrfy_error_codes code
343  */
344 int check_entity(ir_entity *ent) {
345         int rem_vpi;
346         ir_type *tp = get_entity_type(ent);
347         ir_type *owner = get_entity_owner(ent);
348
349         current_ir_graph =  get_const_code_irg();
350         ASSERT_AND_RET_DBG(
351                 constants_on_wrong_irg(ent) == 0,
352                 "Contants placed on wrong IRG",
353                 error_const_on_wrong_irg,
354                 ir_fprintf(stderr, "%+e not on %+F\n", ent, current_ir_graph)
355         );
356
357         rem_vpi = get_visit_pseudo_irgs();
358         set_visit_pseudo_irgs(1);
359         if ((get_entity_peculiarity(ent) == peculiarity_existent)         &&
360             (get_entity_visibility(ent) != visibility_external_allocated) &&
361             (is_Method_type(get_entity_type(ent)))                        &&
362             (!get_entity_irg(ent) || !(is_ir_graph(get_entity_irg(ent))))) {
363                 ASSERT_AND_RET_DBG(
364                         0,
365                         "Method ents with pec_exist must have an irg",
366                         error_existent_entity_without_irg,
367                         ir_fprintf(stderr, "%+e\n", ent)
368                 );
369         }
370         set_visit_pseudo_irgs(rem_vpi);
371
372         /* Originally, this test assumed, that only method entities have
373            pecularity_inherited.  As I changed this, I have to test for method type before
374            doing the test. */
375         if (get_entity_peculiarity(ent) == peculiarity_inherited) {
376                 if (is_Method_type(get_entity_type(ent))) {
377                         ir_entity *impl = get_SymConst_entity(get_atomic_ent_value(ent));
378                         ASSERT_AND_RET_DBG(
379                                 get_entity_peculiarity(impl) == peculiarity_existent,
380                                 "inherited method entities must have constant pointing to existent entity.",
381                                 error_inherited_ent_without_const,
382                                 ir_fprintf(stderr, "%+e points to %+e\n", ent, impl)
383                         );
384                 }
385         }
386
387         /* Entities in global type are not dynamic or automatic allocated. */
388         if (owner == get_glob_type()) {
389                 ASSERT_AND_RET_DBG(
390                         get_entity_allocation(ent) != allocation_dynamic &&
391                         get_entity_allocation(ent) != allocation_automatic,
392                         "Entities in global type are not allowed to by dynamic or automatic allocated",
393                         error_glob_ent_allocation,
394                         show_ent_alloc_error(ent)
395                 );
396         }
397
398         if (get_entity_variability(ent) != variability_uninitialized) {
399                 if (is_atomic_type(tp)) {
400                         ir_node *val = get_atomic_ent_value(ent);
401                         if (val) {
402                                 ASSERT_AND_RET_DBG(
403                                         get_irn_mode(val) == get_type_mode(tp),
404                                         "Mode of constant in entity must match type.",
405                                         error_ent_const_mode,
406                                         ir_fprintf(stderr, "%+e const %+F, type %+F(%+F)\n",
407                                         ent, val, tp, get_type_mode(tp))
408                                 );
409                         }
410                 }
411         }
412         return no_error;
413 }
414
415 /*
416  * check types and entities
417  */
418 static void check_tore(type_or_ent *tore, void *env) {
419         int *res = env;
420         assert(tore);
421         if (is_type(tore)) {
422                 *res = check_type((ir_type *)tore);
423         } else {
424                 assert(is_entity(tore));
425                 *res = check_entity((ir_entity *)tore);
426         }
427 }
428
429 /*
430  * Verify types and entities.
431  */
432 int tr_vrfy(void) {
433         int res;
434
435         type_walk(check_tore, NULL, &res);
436         return res;
437 }