src/compiler/glsl/ir_validate.cpp

   1 /*
   2  * Copyright © 2010 Intel Corporation
   3  *
   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:
  10  *
  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
  13  * Software.
  14  *
  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.
  22  */
  23
  24 /**
  25  * \file ir_validate.cpp
  26  *
  27  * Attempts to verify that various invariants of the IR tree are true.
  28  *
  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.
  34  */
  35
  36 #include "ir.h"
  37 #include "ir_hierarchical_visitor.h"
  38 #include "util/hash_table.h"
  39 #include "util/macros.h"
  40 #include "util/set.h"
  41 #include "compiler/glsl_types.h"
  42
  43 namespace {
  44
  45 class ir_validate : public ir_hierarchical_visitor {
  46 public:
  47    ir_validate()
  48    {
  49       this->ir_set = _mesa_set_create(NULL, _mesa_hash_pointer,
  50                                       _mesa_key_pointer_equal);
  51
  52       this->current_function = NULL;
  53
  54       this->callback_enter = ir_validate::validate_ir;
  55       this->data_enter = ir_set;
  56    }
  57
  58    ~ir_validate()
  59    {
  60       _mesa_set_destroy(this->ir_set, NULL);
  61    }
  62
  63    virtual ir_visitor_status visit(ir_variable *v);
  64    virtual ir_visitor_status visit(ir_dereference_variable *ir);
  65
  66    virtual ir_visitor_status visit_enter(ir_discard *ir);
  67    virtual ir_visitor_status visit_enter(ir_if *ir);
  68
  69    virtual ir_visitor_status visit_enter(ir_function *ir);
  70    virtual ir_visitor_status visit_leave(ir_function *ir);
  71    virtual ir_visitor_status visit_enter(ir_function_signature *ir);
  72
  73    virtual ir_visitor_status visit_leave(ir_expression *ir);
  74    virtual ir_visitor_status visit_leave(ir_swizzle *ir);
  75
  76    virtual ir_visitor_status visit_enter(class ir_dereference_array *);
  77
  78    virtual ir_visitor_status visit_enter(ir_assignment *ir);
  79    virtual ir_visitor_status visit_enter(ir_call *ir);
  80
  81    static void validate_ir(ir_instruction *ir, void *data);
  82
  83    ir_function *current_function;
  84
  85    struct set *ir_set;
  86 };
  87
  88 } /* anonymous namespace */
  89
  90 ir_visitor_status
  91 ir_validate::visit(ir_dereference_variable *ir)
  92 {
  93    if ((ir->var == NULL) || (ir->var->as_variable() == NULL)) {
  94       printf("ir_dereference_variable @ %p does not specify a variable %p\n",
  95              (void *) ir, (void *) ir->var);
  96       abort();
  97    }
  98
  99    if (_mesa_set_search(ir_set, ir->var) == NULL) {
 100       printf("ir_dereference_variable @ %p specifies undeclared variable "
 101              "`%s' @ %p\n",
 102              (void *) ir, ir->var->name, (void *) ir->var);
 103       abort();
 104    }
 105
 106    this->validate_ir(ir, this->data_enter);
 107
 108    return visit_continue;
 109 }
 110
 111 ir_visitor_status
 112 ir_validate::visit_enter(class ir_dereference_array *ir)
 113 {
 114    if (!ir->array->type->is_array() && !ir->array->type->is_matrix() &&
 115       !ir->array->type->is_vector()) {
 116       printf("ir_dereference_array @ %p does not specify an array, a vector "
 117              "or a matrix\n",
 118              (void *) ir);
 119       ir->print();
 120       printf("\n");
 121       abort();
 122    }
 123
 124    if (!ir->array_index->type->is_scalar()) {
 125       printf("ir_dereference_array @ %p does not have scalar index: %s\n",
 126              (void *) ir, ir->array_index->type->name);
 127       abort();
 128    }
 129
 130    if (!ir->array_index->type->is_integer()) {
 131       printf("ir_dereference_array @ %p does not have integer index: %s\n",
 132              (void *) ir, ir->array_index->type->name);
 133       abort();
 134    }
 135
 136    return visit_continue;
 137 }
 138
 139 ir_visitor_status
 140 ir_validate::visit_enter(ir_discard *ir)
 141 {
 142    if (ir->condition && ir->condition->type != glsl_type::bool_type) {
 143       printf("ir_discard condition %s type instead of bool.\n",
 144              ir->condition->type->name);
 145       ir->print();
 146       printf("\n");
 147       abort();
 148    }
 149
 150    return visit_continue;
 151 }
 152
 153 ir_visitor_status
 154 ir_validate::visit_enter(ir_if *ir)
 155 {
 156    if (ir->condition->type != glsl_type::bool_type) {
 157       printf("ir_if condition %s type instead of bool.\n",
 158              ir->condition->type->name);
 159       ir->print();
 160       printf("\n");
 161       abort();
 162    }
 163
 164    return visit_continue;
 165 }
 166
 167
 168 ir_visitor_status
 169 ir_validate::visit_enter(ir_function *ir)
 170 {
 171    /* Function definitions cannot be nested.
 172     */
 173    if (this->current_function != NULL) {
 174       printf("Function definition nested inside another function "
 175              "definition:\n");
 176       printf("%s %p inside %s %p\n",
 177              ir->name, (void *) ir,
 178              this->current_function->name, (void *) this->current_function);
 179       abort();
 180    }
 181
 182    /* Store the current function hierarchy being traversed.  This is used
 183     * by the function signature visitor to ensure that the signatures are
 184     * linked with the correct functions.
 185     */
 186    this->current_function = ir;
 187
 188    this->validate_ir(ir, this->data_enter);
 189
 190    /* Verify that all of the things stored in the list of signatures are,
 191     * in fact, function signatures.
 192     */
 193    foreach_in_list(ir_instruction, sig, &ir->signatures) {
 194       if (sig->ir_type != ir_type_function_signature) {
 195          printf("Non-signature in signature list of function `%s'\n",
 196                 ir->name);
 197          abort();
 198       }
 199    }
 200
 201    return visit_continue;
 202 }
 203
 204 ir_visitor_status
 205 ir_validate::visit_leave(ir_function *ir)
 206 {
 207    assert(ralloc_parent(ir->name) == ir);
 208
 209    this->current_function = NULL;
 210    return visit_continue;
 211 }
 212
 213 ir_visitor_status
 214 ir_validate::visit_enter(ir_function_signature *ir)
 215 {
 216    if (this->current_function != ir->function()) {
 217       printf("Function signature nested inside wrong function "
 218              "definition:\n");
 219       printf("%p inside %s %p instead of %s %p\n",
 220              (void *) ir,
 221              this->current_function->name, (void *) this->current_function,
 222              ir->function_name(), (void *) ir->function());
 223       abort();
 224    }
 225
 226    if (ir->return_type == NULL) {
 227       printf("Function signature %p for function %s has NULL return type.\n",
 228              (void *) ir, ir->function_name());
 229       abort();
 230    }
 231
 232    this->validate_ir(ir, this->data_enter);
 233
 234    return visit_continue;
 235 }
 236
 237 ir_visitor_status
 238 ir_validate::visit_leave(ir_expression *ir)
 239 {
 240    for (unsigned i = ir->num_operands; i < 4; i++) {
 241       assert(ir->operands[i] == NULL);
 242    }
 243
 244    for (unsigned i = 0; i < ir->num_operands; i++) {
 245       assert(ir->operands[i] != NULL);
 246    }
 247
 248    switch (ir->operation) {
 249    case ir_unop_bit_not:
 250       assert(ir->operands[0]->type == ir->type);
 251       break;
 252    case ir_unop_logic_not:
 253       assert(ir->type->is_boolean());
 254       assert(ir->operands[0]->type->is_boolean());
 255       break;
 256
 257    case ir_unop_neg:
 258       assert(ir->type == ir->operands[0]->type);
 259       break;
 260
 261    case ir_unop_abs:
 262    case ir_unop_sign:
 263       assert(ir->operands[0]->type->base_type == GLSL_TYPE_INT ||
 264              ir->operands[0]->type->is_float() ||
 265              ir->operands[0]->type->is_double() ||
 266              ir->operands[0]->type->base_type == GLSL_TYPE_INT64);
 267       assert(ir->type == ir->operands[0]->type);
 268       break;
 269
 270    case ir_unop_rcp:
 271    case ir_unop_rsq:
 272    case ir_unop_sqrt:
 273       assert(ir->type->is_float() ||
 274              ir->type->is_double());
 275       assert(ir->type == ir->operands[0]->type);
 276       break;
 277
 278    case ir_unop_exp:
 279    case ir_unop_log:
 280    case ir_unop_exp2:
 281    case ir_unop_log2:
 282    case ir_unop_saturate:
 283       assert(ir->operands[0]->type->is_float());
 284       assert(ir->type == ir->operands[0]->type);
 285       break;
 286
 287    case ir_unop_f2i:
 288       assert(ir->operands[0]->type->is_float());
 289       assert(ir->type->base_type == GLSL_TYPE_INT);
 290       break;
 291    case ir_unop_f2u:
 292       assert(ir->operands[0]->type->is_float());
 293       assert(ir->type->base_type == GLSL_TYPE_UINT);
 294       break;
 295    case ir_unop_i2f:
 296       assert(ir->operands[0]->type->base_type == GLSL_TYPE_INT);
 297       assert(ir->type->is_float());
 298       break;
 299    case ir_unop_f2b:
 300       assert(ir->operands[0]->type->is_float());
 301       assert(ir->type->is_boolean());
 302       break;
 303    case ir_unop_b2f:
 304       assert(ir->operands[0]->type->is_boolean());
 305       assert(ir->type->is_float());
 306       break;
 307    case ir_unop_i2b:
 308       assert(ir->operands[0]->type->base_type == GLSL_TYPE_INT);
 309       assert(ir->type->is_boolean());
 310       break;
 311    case ir_unop_b2i:
 312       assert(ir->operands[0]->type->is_boolean());
 313       assert(ir->type->base_type == GLSL_TYPE_INT);
 314       break;
 315    case ir_unop_u2f:
 316       assert(ir->operands[0]->type->base_type == GLSL_TYPE_UINT);
 317       assert(ir->type->is_float());
 318       break;
 319    case ir_unop_i2u:
 320       assert(ir->operands[0]->type->base_type == GLSL_TYPE_INT);
 321       assert(ir->type->base_type == GLSL_TYPE_UINT);
 322       break;
 323    case ir_unop_u2i:
 324       assert(ir->operands[0]->type->base_type == GLSL_TYPE_UINT);
 325       assert(ir->type->base_type == GLSL_TYPE_INT);
 326       break;
 327    case ir_unop_bitcast_i2f:
 328       assert(ir->operands[0]->type->base_type == GLSL_TYPE_INT);
 329       assert(ir->type->is_float());
 330       break;
 331    case ir_unop_bitcast_f2i:
 332       assert(ir->operands[0]->type->is_float());
 333       assert(ir->type->base_type == GLSL_TYPE_INT);
 334       break;
 335    case ir_unop_bitcast_u2f:
 336       assert(ir->operands[0]->type->base_type == GLSL_TYPE_UINT);
 337       assert(ir->type->is_float());
 338       break;
 339    case ir_unop_bitcast_f2u:
 340       assert(ir->operands[0]->type->is_float());
 341       assert(ir->type->base_type == GLSL_TYPE_UINT);
 342       break;
 343
 344    case ir_unop_bitcast_u642d:
 345       assert(ir->operands[0]->type->base_type == GLSL_TYPE_UINT64);
 346       assert(ir->type->is_double());
 347       break;
 348    case ir_unop_bitcast_i642d:
 349       assert(ir->operands[0]->type->base_type == GLSL_TYPE_INT64);
 350       assert(ir->type->is_double());
 351       break;
 352    case ir_unop_bitcast_d2u64:
 353       assert(ir->operands[0]->type->is_double());
 354       assert(ir->type->base_type == GLSL_TYPE_UINT64);
 355       break;
 356    case ir_unop_bitcast_d2i64:
 357       assert(ir->operands[0]->type->is_double());
 358       assert(ir->type->base_type == GLSL_TYPE_INT64);
 359       break;
 360    case ir_unop_i642i:
 361       assert(ir->operands[0]->type->base_type == GLSL_TYPE_INT64);
 362       assert(ir->type->base_type == GLSL_TYPE_INT);
 363       break;
 364    case ir_unop_u642i:
 365       assert(ir->operands[0]->type->base_type == GLSL_TYPE_UINT64);
 366       assert(ir->type->base_type == GLSL_TYPE_INT);
 367       break;
 368    case ir_unop_i642u:
 369       assert(ir->operands[0]->type->base_type == GLSL_TYPE_INT64);
 370       assert(ir->type->base_type == GLSL_TYPE_UINT);
 371       break;
 372    case ir_unop_u642u:
 373       assert(ir->operands[0]->type->base_type == GLSL_TYPE_UINT64);
 374       assert(ir->type->base_type == GLSL_TYPE_UINT);
 375       break;
 376    case ir_unop_i642b:
 377       assert(ir->operands[0]->type->base_type == GLSL_TYPE_INT64);
 378       assert(ir->type->is_boolean());
 379       break;
 380    case ir_unop_i642f:
 381       assert(ir->operands[0]->type->base_type == GLSL_TYPE_INT64);
 382       assert(ir->type->is_float());
 383       break;
 384    case ir_unop_u642f:
 385       assert(ir->operands[0]->type->base_type == GLSL_TYPE_UINT64);
 386       assert(ir->type->is_float());
 387       break;
 388    case ir_unop_i642d:
 389       assert(ir->operands[0]->type->base_type == GLSL_TYPE_INT64);
 390       assert(ir->type->is_double());
 391       break;
 392    case ir_unop_u642d:
 393       assert(ir->operands[0]->type->base_type == GLSL_TYPE_UINT64);
 394       assert(ir->type->is_double());
 395       break;
 396    case ir_unop_i2i64:
 397       assert(ir->operands[0]->type->base_type == GLSL_TYPE_INT);
 398       assert(ir->type->base_type == GLSL_TYPE_INT64);
 399       break;
 400    case ir_unop_u2i64:
 401       assert(ir->operands[0]->type->base_type == GLSL_TYPE_UINT);
 402       assert(ir->type->base_type == GLSL_TYPE_INT64);
 403       break;
 404    case ir_unop_b2i64:
 405       assert(ir->operands[0]->type->is_boolean());
 406       assert(ir->type->base_type == GLSL_TYPE_INT64);
 407       break;
 408    case ir_unop_f2i64:
 409       assert(ir->operands[0]->type->is_float());
 410       assert(ir->type->base_type == GLSL_TYPE_INT64);
 411       break;
 412    case ir_unop_d2i64:
 413       assert(ir->operands[0]->type->is_double());
 414       assert(ir->type->base_type == GLSL_TYPE_INT64);
 415       break;
 416    case ir_unop_i2u64:
 417       assert(ir->operands[0]->type->base_type == GLSL_TYPE_INT);
 418       assert(ir->type->base_type == GLSL_TYPE_UINT64);
 419       break;
 420    case ir_unop_u2u64:
 421       assert(ir->operands[0]->type->base_type == GLSL_TYPE_UINT);
 422       assert(ir->type->base_type == GLSL_TYPE_UINT64);
 423       break;
 424    case ir_unop_f2u64:
 425       assert(ir->operands[0]->type->is_float());
 426       assert(ir->type->base_type == GLSL_TYPE_UINT64);
 427       break;
 428    case ir_unop_d2u64:
 429       assert(ir->operands[0]->type->is_double());
 430       assert(ir->type->base_type == GLSL_TYPE_UINT64);
 431       break;
 432    case ir_unop_u642i64:
 433       assert(ir->operands[0]->type->base_type == GLSL_TYPE_UINT64);
 434       assert(ir->type->base_type == GLSL_TYPE_INT64);
 435       break;
 436    case ir_unop_i642u64:
 437       assert(ir->operands[0]->type->base_type == GLSL_TYPE_INT64);
 438       assert(ir->type->base_type == GLSL_TYPE_UINT64);
 439       break;
 440    case ir_unop_trunc:
 441    case ir_unop_round_even:
 442    case ir_unop_ceil:
 443    case ir_unop_floor:
 444    case ir_unop_fract:
 445       assert(ir->operands[0]->type->is_float() ||
 446              ir->operands[0]->type->is_double());
 447       assert(ir->operands[0]->type == ir->type);
 448       break;
 449    case ir_unop_sin:
 450    case ir_unop_cos:
 451    case ir_unop_dFdx:
 452    case ir_unop_dFdx_coarse:
 453    case ir_unop_dFdx_fine:
 454    case ir_unop_dFdy:
 455    case ir_unop_dFdy_coarse:
 456    case ir_unop_dFdy_fine:
 457       assert(ir->operands[0]->type->is_float());
 458       assert(ir->operands[0]->type == ir->type);
 459       break;
 460
 461    case ir_unop_pack_snorm_2x16:
 462    case ir_unop_pack_unorm_2x16:
 463    case ir_unop_pack_half_2x16:
 464       assert(ir->type == glsl_type::uint_type);
 465       assert(ir->operands[0]->type == glsl_type::vec2_type);
 466       break;
 467
 468    case ir_unop_pack_snorm_4x8:
 469    case ir_unop_pack_unorm_4x8:
 470       assert(ir->type == glsl_type::uint_type);
 471       assert(ir->operands[0]->type == glsl_type::vec4_type);
 472       break;
 473
 474    case ir_unop_pack_double_2x32:
 475       assert(ir->type == glsl_type::double_type);
 476       assert(ir->operands[0]->type == glsl_type::uvec2_type);
 477       break;
 478
 479    case ir_unop_pack_int_2x32:
 480       assert(ir->type == glsl_type::int64_t_type);
 481       assert(ir->operands[0]->type == glsl_type::ivec2_type);
 482       break;
 483
 484    case ir_unop_pack_uint_2x32:
 485       assert(ir->type == glsl_type::uint64_t_type);
 486       assert(ir->operands[0]->type == glsl_type::uvec2_type);
 487       break;
 488
 489    case ir_unop_pack_sampler_2x32:
 490       assert(ir->type->is_sampler());
 491       assert(ir->operands[0]->type == glsl_type::uvec2_type);
 492       break;
 493
 494    case ir_unop_pack_image_2x32:
 495       assert(ir->type->is_image());
 496       assert(ir->operands[0]->type == glsl_type::uvec2_type);
 497       break;
 498
 499    case ir_unop_unpack_snorm_2x16:
 500    case ir_unop_unpack_unorm_2x16:
 501    case ir_unop_unpack_half_2x16:
 502       assert(ir->type == glsl_type::vec2_type);
 503       assert(ir->operands[0]->type == glsl_type::uint_type);
 504       break;
 505
 506    case ir_unop_unpack_snorm_4x8:
 507    case ir_unop_unpack_unorm_4x8:
 508       assert(ir->type == glsl_type::vec4_type);
 509       assert(ir->operands[0]->type == glsl_type::uint_type);
 510       break;
 511
 512    case ir_unop_unpack_double_2x32:
 513       assert(ir->type == glsl_type::uvec2_type);
 514       assert(ir->operands[0]->type == glsl_type::double_type);
 515       break;
 516
 517    case ir_unop_unpack_int_2x32:
 518       assert(ir->type == glsl_type::ivec2_type);
 519       assert(ir->operands[0]->type == glsl_type::int64_t_type);
 520       break;
 521
 522    case ir_unop_unpack_uint_2x32:
 523       assert(ir->type == glsl_type::uvec2_type);
 524       assert(ir->operands[0]->type == glsl_type::uint64_t_type);
 525       break;
 526
 527    case ir_unop_unpack_sampler_2x32:
 528       assert(ir->type == glsl_type::uvec2_type);
 529       assert(ir->operands[0]->type->is_sampler());
 530       break;
 531
 532    case ir_unop_unpack_image_2x32:
 533       assert(ir->type == glsl_type::uvec2_type);
 534       assert(ir->operands[0]->type->is_image());
 535       break;
 536
 537    case ir_unop_bitfield_reverse:
 538       assert(ir->operands[0]->type == ir->type);
 539       assert(ir->type->is_integer());
 540       break;
 541
 542    case ir_unop_bit_count:
 543    case ir_unop_find_msb:
 544    case ir_unop_find_lsb:
 545       assert(ir->operands[0]->type->vector_elements == ir->type->vector_elements);
 546       assert(ir->operands[0]->type->is_integer());
 547       assert(ir->type->base_type == GLSL_TYPE_INT);
 548       break;
 549
 550    case ir_unop_noise:
 551       /* XXX what can we assert here? */
 552       break;
 553
 554    case ir_unop_interpolate_at_centroid:
 555       assert(ir->operands[0]->type == ir->type);
 556       assert(ir->operands[0]->type->is_float());
 557       break;
 558
 559    case ir_unop_get_buffer_size:
 560       assert(ir->type == glsl_type::int_type);
 561       assert(ir->operands[0]->type == glsl_type::uint_type);
 562       break;
 563
 564    case ir_unop_ssbo_unsized_array_length:
 565       assert(ir->type == glsl_type::int_type);
 566       assert(ir->operands[0]->type->is_array());
 567       assert(ir->operands[0]->type->is_unsized_array());
 568       break;
 569
 570    case ir_unop_d2f:
 571       assert(ir->operands[0]->type->is_double());
 572       assert(ir->type->is_float());
 573       break;
 574    case ir_unop_f2d:
 575       assert(ir->operands[0]->type->is_float());
 576       assert(ir->type->is_double());
 577       break;
 578    case ir_unop_d2i:
 579       assert(ir->operands[0]->type->is_double());
 580       assert(ir->type->base_type == GLSL_TYPE_INT);
 581       break;
 582    case ir_unop_i2d:
 583       assert(ir->operands[0]->type->base_type == GLSL_TYPE_INT);
 584       assert(ir->type->is_double());
 585       break;
 586    case ir_unop_d2u:
 587       assert(ir->operands[0]->type->is_double());
 588       assert(ir->type->base_type == GLSL_TYPE_UINT);
 589       break;
 590    case ir_unop_u2d:
 591       assert(ir->operands[0]->type->base_type == GLSL_TYPE_UINT);
 592       assert(ir->type->is_double());
 593       break;
 594    case ir_unop_d2b:
 595       assert(ir->operands[0]->type->is_double());
 596       assert(ir->type->is_boolean());
 597       break;
 598
 599    case ir_unop_frexp_sig:
 600       assert(ir->operands[0]->type->is_float() ||
 601              ir->operands[0]->type->is_double());
 602       assert(ir->type->is_double());
 603       break;
 604    case ir_unop_frexp_exp:
 605       assert(ir->operands[0]->type->is_float() ||
 606              ir->operands[0]->type->is_double());
 607       assert(ir->type->base_type == GLSL_TYPE_INT);
 608       break;
 609    case ir_unop_subroutine_to_int:
 610       assert(ir->operands[0]->type->base_type == GLSL_TYPE_SUBROUTINE);
 611       assert(ir->type->base_type == GLSL_TYPE_INT);
 612       break;
 613
 614    case ir_binop_add:
 615    case ir_binop_sub:
 616    case ir_binop_mul:
 617    case ir_binop_div:
 618    case ir_binop_mod:
 619    case ir_binop_min:
 620    case ir_binop_max:
 621    case ir_binop_pow:
 622       assert(ir->operands[0]->type->base_type ==
 623              ir->operands[1]->type->base_type);
 624
 625       if (ir->operands[0]->type->is_scalar())
 626          assert(ir->operands[1]->type == ir->type);
 627       else if (ir->operands[1]->type->is_scalar())
 628          assert(ir->operands[0]->type == ir->type);
 629       else if (ir->operands[0]->type->is_vector() &&
 630                ir->operands[1]->type->is_vector()) {
 631          assert(ir->operands[0]->type == ir->operands[1]->type);
 632          assert(ir->operands[0]->type == ir->type);
 633       }
 634       break;
 635
 636    case ir_binop_imul_high:
 637       assert(ir->type == ir->operands[0]->type);
 638       assert(ir->type == ir->operands[1]->type);
 639       assert(ir->type->is_integer());
 640       break;
 641
 642    case ir_binop_carry:
 643    case ir_binop_borrow:
 644       assert(ir->type == ir->operands[0]->type);
 645       assert(ir->type == ir->operands[1]->type);
 646       assert(ir->type->base_type == GLSL_TYPE_UINT);
 647       break;
 648
 649    case ir_binop_less:
 650    case ir_binop_greater:
 651    case ir_binop_lequal:
 652    case ir_binop_gequal:
 653    case ir_binop_equal:
 654    case ir_binop_nequal:
 655       /* The semantics of the IR operators differ from the GLSL <, >, <=, >=,
 656        * ==, and != operators.  The IR operators perform a component-wise
 657        * comparison on scalar or vector types and return a boolean scalar or
 658        * vector type of the same size.
 659        */
 660       assert(ir->type->is_boolean());
 661       assert(ir->operands[0]->type == ir->operands[1]->type);
 662       assert(ir->operands[0]->type->is_vector()
 663              || ir->operands[0]->type->is_scalar());
 664       assert(ir->operands[0]->type->vector_elements
 665              == ir->type->vector_elements);
 666       break;
 667
 668    case ir_binop_all_equal:
 669    case ir_binop_any_nequal:
 670       /* GLSL == and != operate on scalars, vectors, matrices and arrays, and
 671        * return a scalar boolean.  The IR matches that.
 672        */
 673       assert(ir->type == glsl_type::bool_type);
 674       assert(ir->operands[0]->type == ir->operands[1]->type);
 675       break;
 676
 677    case ir_binop_lshift:
 678    case ir_binop_rshift:
 679       assert(ir->operands[0]->type->is_integer_32_64() &&
 680              ir->operands[1]->type->is_integer());
 681       if (ir->operands[0]->type->is_scalar()) {
 682           assert(ir->operands[1]->type->is_scalar());
 683       }
 684       if (ir->operands[0]->type->is_vector() &&
 685           ir->operands[1]->type->is_vector()) {
 686           assert(ir->operands[0]->type->components() ==
 687                  ir->operands[1]->type->components());
 688       }
 689       assert(ir->type == ir->operands[0]->type);
 690       break;
 691
 692    case ir_binop_bit_and:
 693    case ir_binop_bit_xor:
 694    case ir_binop_bit_or:
 695        assert(ir->operands[0]->type->base_type ==
 696               ir->operands[1]->type->base_type);
 697        assert(ir->type->is_integer_32_64());
 698        if (ir->operands[0]->type->is_vector() &&
 699            ir->operands[1]->type->is_vector()) {
 700            assert(ir->operands[0]->type->vector_elements ==
 701                   ir->operands[1]->type->vector_elements);
 702        }
 703        break;
 704
 705    case ir_binop_logic_and:
 706    case ir_binop_logic_xor:
 707    case ir_binop_logic_or:
 708       assert(ir->type->is_boolean());
 709       assert(ir->operands[0]->type->is_boolean());
 710       assert(ir->operands[1]->type->is_boolean());
 711       break;
 712
 713    case ir_binop_dot:
 714       assert(ir->type == glsl_type::float_type ||
 715              ir->type == glsl_type::double_type);
 716       assert(ir->operands[0]->type->is_float() ||
 717              ir->operands[0]->type->is_double());
 718       assert(ir->operands[0]->type->is_vector());
 719       assert(ir->operands[0]->type == ir->operands[1]->type);
 720       break;
 721
 722    case ir_binop_ubo_load:
 723       assert(ir->operands[0]->type == glsl_type::uint_type);
 724
 725       assert(ir->operands[1]->type == glsl_type::uint_type);
 726       break;
 727
 728    case ir_binop_ldexp:
 729       assert(ir->operands[0]->type == ir->type);
 730       assert(ir->operands[0]->type->is_float() ||
 731              ir->operands[0]->type->is_double());
 732       assert(ir->operands[1]->type->base_type == GLSL_TYPE_INT);
 733       assert(ir->operands[0]->type->components() ==
 734              ir->operands[1]->type->components());
 735       break;
 736
 737    case ir_binop_vector_extract:
 738       assert(ir->operands[0]->type->is_vector());
 739       assert(ir->operands[1]->type->is_scalar()
 740              && ir->operands[1]->type->is_integer());
 741       break;
 742
 743    case ir_binop_interpolate_at_offset:
 744       assert(ir->operands[0]->type == ir->type);
 745       assert(ir->operands[0]->type->is_float());
 746       assert(ir->operands[1]->type->components() == 2);
 747       assert(ir->operands[1]->type->is_float());
 748       break;
 749
 750    case ir_binop_interpolate_at_sample:
 751       assert(ir->operands[0]->type == ir->type);
 752       assert(ir->operands[0]->type->is_float());
 753       assert(ir->operands[1]->type == glsl_type::int_type);
 754       break;
 755
 756    case ir_triop_fma:
 757       assert(ir->type->is_float() ||
 758              ir->type->is_double());
 759       assert(ir->type == ir->operands[0]->type);
 760       assert(ir->type == ir->operands[1]->type);
 761       assert(ir->type == ir->operands[2]->type);
 762       break;
 763
 764    case ir_triop_lrp:
 765       assert(ir->operands[0]->type->is_float() ||
 766              ir->operands[0]->type->is_double());
 767       assert(ir->operands[0]->type == ir->operands[1]->type);
 768       assert(ir->operands[2]->type == ir->operands[0]->type ||
 769              ir->operands[2]->type == glsl_type::float_type ||
 770              ir->operands[2]->type == glsl_type::double_type);
 771       break;
 772
 773    case ir_triop_csel:
 774       assert(ir->operands[0]->type->is_boolean());
 775       assert(ir->type->vector_elements == ir->operands[0]->type->vector_elements);
 776       assert(ir->type == ir->operands[1]->type);
 777       assert(ir->type == ir->operands[2]->type);
 778       break;
 779
 780    case ir_triop_bitfield_extract:
 781       assert(ir->type->is_integer());
 782       assert(ir->operands[0]->type == ir->type);
 783       assert(ir->operands[1]->type == ir->type);
 784       assert(ir->operands[2]->type == ir->type);
 785       break;
 786
 787    case ir_triop_vector_insert:
 788       assert(ir->operands[0]->type->is_vector());
 789       assert(ir->operands[1]->type->is_scalar());
 790       assert(ir->operands[0]->type->base_type == ir->operands[1]->type->base_type);
 791       assert(ir->operands[2]->type->is_scalar()
 792              && ir->operands[2]->type->is_integer());
 793       assert(ir->type == ir->operands[0]->type);
 794       break;
 795
 796    case ir_quadop_bitfield_insert:
 797       assert(ir->type->is_integer());
 798       assert(ir->operands[0]->type == ir->type);
 799       assert(ir->operands[1]->type == ir->type);
 800       assert(ir->operands[2]->type == ir->type);
 801       assert(ir->operands[3]->type == ir->type);
 802       break;
 803
 804    case ir_quadop_vector:
 805       /* The vector operator collects some number of scalars and generates a
 806        * vector from them.
 807        *
 808        *  - All of the operands must be scalar.
 809        *  - Number of operands must matche the size of the resulting vector.
 810        *  - Base type of the operands must match the base type of the result.
 811        */
 812       assert(ir->type->is_vector());
 813       switch (ir->type->vector_elements) {
 814       case 2:
 815          assert(ir->operands[0]->type->is_scalar());
 816          assert(ir->operands[0]->type->base_type == ir->type->base_type);
 817          assert(ir->operands[1]->type->is_scalar());
 818          assert(ir->operands[1]->type->base_type == ir->type->base_type);
 819          assert(ir->operands[2] == NULL);
 820          assert(ir->operands[3] == NULL);
 821          break;
 822       case 3:
 823          assert(ir->operands[0]->type->is_scalar());
 824          assert(ir->operands[0]->type->base_type == ir->type->base_type);
 825          assert(ir->operands[1]->type->is_scalar());
 826          assert(ir->operands[1]->type->base_type == ir->type->base_type);
 827          assert(ir->operands[2]->type->is_scalar());
 828          assert(ir->operands[2]->type->base_type == ir->type->base_type);
 829          assert(ir->operands[3] == NULL);
 830          break;
 831       case 4:
 832          assert(ir->operands[0]->type->is_scalar());
 833          assert(ir->operands[0]->type->base_type == ir->type->base_type);
 834          assert(ir->operands[1]->type->is_scalar());
 835          assert(ir->operands[1]->type->base_type == ir->type->base_type);
 836          assert(ir->operands[2]->type->is_scalar());
 837          assert(ir->operands[2]->type->base_type == ir->type->base_type);
 838          assert(ir->operands[3]->type->is_scalar());
 839          assert(ir->operands[3]->type->base_type == ir->type->base_type);
 840          break;
 841       default:
 842          /* The is_vector assertion above should prevent execution from ever
 843           * getting here.
 844           */
 845          assert(!"Should not get here.");
 846          break;
 847       }
 848    }
 849
 850    return visit_continue;
 851 }
 852
 853 ir_visitor_status
 854 ir_validate::visit_leave(ir_swizzle *ir)
 855 {
 856    unsigned int chans[4] = {ir->mask.x, ir->mask.y, ir->mask.z, ir->mask.w};
 857
 858    for (unsigned int i = 0; i < ir->type->vector_elements; i++) {
 859       if (chans[i] >= ir->val->type->vector_elements) {
 860          printf("ir_swizzle @ %p specifies a channel not present "
 861                 "in the value.\n", (void *) ir);
 862          ir->print();
 863          abort();
 864       }
 865    }
 866
 867    return visit_continue;
 868 }
 869
 870 ir_visitor_status
 871 ir_validate::visit(ir_variable *ir)
 872 {
 873    /* An ir_variable is the one thing that can (and will) appear multiple times
 874     * in an IR tree.  It is added to the hashtable so that it can be used
 875     * in the ir_dereference_variable handler to ensure that a variable is
 876     * declared before it is dereferenced.
 877     */
 878    if (ir->name && ir->is_name_ralloced())
 879       assert(ralloc_parent(ir->name) == ir);
 880
 881    _mesa_set_add(ir_set, ir);
 882
 883    /* If a variable is an array, verify that the maximum array index is in
 884     * bounds.  There was once an error in AST-to-HIR conversion that set this
 885     * to be out of bounds.
 886     */
 887    if (ir->type->array_size() > 0) {
 888       if (ir->data.max_array_access >= (int)ir->type->length) {
 889          printf("ir_variable has maximum access out of bounds (%d vs %d)\n",
 890                 ir->data.max_array_access, ir->type->length - 1);
 891          ir->print();
 892          abort();
 893       }
 894    }
 895
 896    /* If a variable is an interface block (or an array of interface blocks),
 897     * verify that the maximum array index for each interface member is in
 898     * bounds.
 899     */
 900    if (ir->is_interface_instance()) {
 901       const glsl_struct_field *fields =
 902          ir->get_interface_type()->fields.structure;
 903       for (unsigned i = 0; i < ir->get_interface_type()->length; i++) {
 904          if (fields[i].type->array_size() > 0 &&
 905              !fields[i].implicit_sized_array) {
 906             const int *const max_ifc_array_access =
 907                ir->get_max_ifc_array_access();
 908
 909             assert(max_ifc_array_access != NULL);
 910
 911             if (max_ifc_array_access[i] >= (int)fields[i].type->length) {
 912                printf("ir_variable has maximum access out of bounds for "
 913                       "field %s (%d vs %d)\n", fields[i].name,
 914                       max_ifc_array_access[i], fields[i].type->length);
 915                ir->print();
 916                abort();
 917             }
 918          }
 919       }
 920    }
 921
 922    if (ir->constant_initializer != NULL && !ir->data.has_initializer) {
 923       printf("ir_variable didn't have an initializer, but has a constant "
 924              "initializer value.\n");
 925       ir->print();
 926       abort();
 927    }
 928
 929    if (ir->data.mode == ir_var_uniform
 930        && is_gl_identifier(ir->name)
 931        && ir->get_state_slots() == NULL) {
 932       printf("built-in uniform has no state\n");
 933       ir->print();
 934       abort();
 935    }
 936
 937    return visit_continue;
 938 }
 939
 940 ir_visitor_status
 941 ir_validate::visit_enter(ir_assignment *ir)
 942 {
 943    const ir_dereference *const lhs = ir->lhs;
 944    if (lhs->type->is_scalar() || lhs->type->is_vector()) {
 945       if (ir->write_mask == 0) {
 946          printf("Assignment LHS is %s, but write mask is 0:\n",
 947                 lhs->type->is_scalar() ? "scalar" : "vector");
 948          ir->print();
 949          abort();
 950       }
 951
 952       int lhs_components = 0;
 953       for (int i = 0; i < 4; i++) {
 954          if (ir->write_mask & (1 << i))
 955             lhs_components++;
 956       }
 957
 958       if (lhs_components != ir->rhs->type->vector_elements) {
 959          printf("Assignment count of LHS write mask channels enabled not\n"
 960                 "matching RHS vector size (%d LHS, %d RHS).\n",
 961                 lhs_components, ir->rhs->type->vector_elements);
 962          ir->print();
 963          abort();
 964       }
 965    }
 966
 967    this->validate_ir(ir, this->data_enter);
 968
 969    return visit_continue;
 970 }
 971
 972 ir_visitor_status
 973 ir_validate::visit_enter(ir_call *ir)
 974 {
 975    ir_function_signature *const callee = ir->callee;
 976
 977    if (callee->ir_type != ir_type_function_signature) {
 978       printf("IR called by ir_call is not ir_function_signature!\n");
 979       abort();
 980    }
 981
 982    if (ir->return_deref) {
 983       if (ir->return_deref->type != callee->return_type) {
 984          printf("callee type %s does not match return storage type %s\n",
 985                 callee->return_type->name, ir->return_deref->type->name);
 986          abort();
 987       }
 988    } else if (callee->return_type != glsl_type::void_type) {
 989       printf("ir_call has non-void callee but no return storage\n");
 990       abort();
 991    }
 992
 993    const exec_node *formal_param_node = callee->parameters.get_head_raw();
 994    const exec_node *actual_param_node = ir->actual_parameters.get_head_raw();
 995    while (true) {
 996       if (formal_param_node->is_tail_sentinel()
 997           != actual_param_node->is_tail_sentinel()) {
 998          printf("ir_call has the wrong number of parameters:\n");
 999          goto dump_ir;
1000       }
1001       if (formal_param_node->is_tail_sentinel()) {
1002          break;
1003       }
1004       const ir_variable *formal_param
1005          = (const ir_variable *) formal_param_node;
1006       const ir_rvalue *actual_param
1007          = (const ir_rvalue *) actual_param_node;
1008       if (formal_param->type != actual_param->type) {
1009          printf("ir_call parameter type mismatch:\n");
1010          goto dump_ir;
1011       }
1012       if (formal_param->data.mode == ir_var_function_out
1013           || formal_param->data.mode == ir_var_function_inout) {
1014          if (!actual_param->is_lvalue()) {
1015             printf("ir_call out/inout parameters must be lvalues:\n");
1016             goto dump_ir;
1017          }
1018       }
1019       formal_param_node = formal_param_node->next;
1020       actual_param_node = actual_param_node->next;
1021    }
1022
1023    return visit_continue;
1024
1025 dump_ir:
1026    ir->print();
1027    printf("callee:\n");
1028    callee->print();
1029    abort();
1030    return visit_stop;
1031 }
1032
1033 void
1034 ir_validate::validate_ir(ir_instruction *ir, void *data)
1035 {
1036    struct set *ir_set = (struct set *) data;
1037
1038    if (_mesa_set_search(ir_set, ir)) {
1039       printf("Instruction node present twice in ir tree:\n");
1040       ir->print();
1041       printf("\n");
1042       abort();
1043    }
1044    _mesa_set_add(ir_set, ir);
1045 }
1046
1047 MAYBE_UNUSED static void
1048 check_node_type(ir_instruction *ir, void *data)
1049 {
1050    (void) data;
1051
1052    if (ir->ir_type >= ir_type_max) {
1053       printf("Instruction node with unset type\n");
1054       ir->print(); printf("\n");
1055    }
1056    ir_rvalue *value = ir->as_rvalue();
1057    if (value != NULL)
1058       assert(value->type != glsl_type::error_type);
1059 }
1060
1061 void
1062 validate_ir_tree(exec_list *instructions)
1063 {
1064    /* We shouldn't have any reason to validate IR in a release build,
1065     * and it's half composed of assert()s anyway which wouldn't do
1066     * anything.
1067     */
1068 #ifdef DEBUG
1069    ir_validate v;
1070
1071    v.run(instructions);
1072
1073    foreach_in_list(ir_instruction, ir, instructions) {
1074       visit_tree(ir, check_node_type, NULL);
1075    }
1076 #endif
1077 }