2 * Copyright © 2010 Intel Corporation
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
11 * The above copyright notice and this permission notice (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
21 * DEALINGS IN THE SOFTWARE.
25 * \file ir_validate.cpp
27 * Attempts to verify that various invariants of the IR tree are true.
29 * In particular, at the moment it makes sure that no single
30 * ir_instruction node except for ir_variable appears multiple times
31 * in the ir tree. ir_variable does appear multiple times: Once as a
32 * declaration in an exec_list, and multiple times as the endpoint of
33 * a dereference chain.
38 #include "ir_hierarchical_visitor.h"
39 #include "hash_table.h"
42 class ir_validate
: public ir_hierarchical_visitor
{
46 this->ht
= hash_table_ctor(0, hash_table_pointer_hash
,
47 hash_table_pointer_compare
);
49 this->current_function
= NULL
;
51 this->callback
= ir_validate::validate_ir
;
57 hash_table_dtor(this->ht
);
60 virtual ir_visitor_status
visit(ir_variable
*v
);
61 virtual ir_visitor_status
visit(ir_dereference_variable
*ir
);
63 virtual ir_visitor_status
visit_enter(ir_function
*ir
);
64 virtual ir_visitor_status
visit_leave(ir_function
*ir
);
65 virtual ir_visitor_status
visit_enter(ir_function_signature
*ir
);
67 static void validate_ir(ir_instruction
*ir
, void *data
);
69 ir_function
*current_function
;
71 struct hash_table
*ht
;
76 ir_validate::visit(ir_dereference_variable
*ir
)
78 if ((ir
->var
== NULL
) || (ir
->var
->as_variable() == NULL
)) {
79 printf("ir_dereference_variable @ %p does not specify a variable %p\n",
84 if (hash_table_find(ht
, ir
->var
) == NULL
) {
85 printf("ir_dereference_variable @ %p specifies undeclared variable "
87 ir
, ir
->var
->name
, ir
->var
);
91 this->validate_ir(ir
, this->data
);
93 return visit_continue
;
98 ir_validate::visit_enter(ir_function
*ir
)
100 /* Function definitions cannot be nested.
102 if (this->current_function
!= NULL
) {
103 printf("Function definition nested inside another function "
105 printf("%s %p inside %s %p\n",
107 this->current_function
->name
, this->current_function
);
111 /* Store the current function hierarchy being traversed. This is used
112 * by the function signature visitor to ensure that the signatures are
113 * linked with the correct functions.
115 this->current_function
= ir
;
117 this->validate_ir(ir
, this->data
);
119 return visit_continue
;
123 ir_validate::visit_leave(ir_function
*ir
)
127 this->current_function
= NULL
;
128 return visit_continue
;
132 ir_validate::visit_enter(ir_function_signature
*ir
)
134 if (this->current_function
!= ir
->function()) {
135 printf("Function signature nested inside wrong function "
137 printf("%p inside %s %p instead of %s %p\n",
139 this->current_function
->name
, this->current_function
,
140 ir
->function_name(), ir
->function());
144 this->validate_ir(ir
, this->data
);
146 return visit_continue
;
150 ir_validate::visit(ir_variable
*ir
)
152 /* An ir_variable is the one thing that can (and will) appear multiple times
153 * in an IR tree. It is added to the hashtable so that it can be used
154 * in the ir_dereference_variable handler to ensure that a variable is
155 * declared before it is dereferenced.
157 hash_table_insert(ht
, ir
, ir
);
158 return visit_continue
;
162 ir_validate::validate_ir(ir_instruction
*ir
, void *data
)
164 struct hash_table
*ht
= (struct hash_table
*) data
;
166 if (hash_table_find(ht
, ir
)) {
167 printf("Instruction node present twice in ir tree:\n");
172 hash_table_insert(ht
, ir
, ir
);
176 check_node_type(ir_instruction
*ir
, void *data
)
178 if (ir
->ir_type
<= ir_type_unset
|| ir
->ir_type
>= ir_type_max
) {
179 printf("Instruction node with unset type\n");
180 ir
->print(); printf("\n");
185 validate_ir_tree(exec_list
*instructions
)
191 foreach_iter(exec_list_iterator
, iter
, *instructions
) {
192 ir_instruction
*ir
= (ir_instruction
*)iter
.get();
194 visit_tree(ir
, check_node_type
, NULL
);