src/compiler/nir/nir_search.h

   1 /*
   2  * Copyright © 2014 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 DEALINGS
  21  * IN THE SOFTWARE.
  22  *
  23  * Authors:
  24  *    Jason Ekstrand (jason@jlekstrand.net)
  25  *
  26  */
  27
  28 #ifndef _NIR_SEARCH_
  29 #define _NIR_SEARCH_
  30
  31 #include "nir.h"
  32
  33 #define NIR_SEARCH_MAX_VARIABLES 16
  34
  35 struct nir_builder;
  36
  37 typedef enum {
  38    nir_search_value_expression,
  39    nir_search_value_variable,
  40    nir_search_value_constant,
  41 } nir_search_value_type;
  42
  43 typedef struct {
  44    nir_search_value_type type;
  45
  46    /**
  47     * Bit size of the value. It is interpreted as follows:
  48     *
  49     * For a search expression:
  50     * - If bit_size > 0, then the value only matches an SSA value with the
  51     *   given bit size.
  52     * - If bit_size <= 0, then the value matches any size SSA value.
  53     *
  54     * For a replace expression:
  55     * - If bit_size > 0, then the value is constructed with the given bit size.
  56     * - If bit_size == 0, then the value is constructed with the same bit size
  57     *   as the search value.
  58     * - If bit_size < 0, then the value is constructed with the same bit size
  59     *   as variable (-bit_size - 1).
  60     */
  61    int bit_size;
  62 } nir_search_value;
  63
  64 typedef struct {
  65    nir_search_value value;
  66
  67    /** The variable index;  Must be less than NIR_SEARCH_MAX_VARIABLES */
  68    unsigned variable;
  69
  70    /** Indicates that the given variable must be a constant
  71     *
  72     * This is only allowed in search expressions and indicates that the
  73     * given variable is only allowed to match constant values.
  74     */
  75    bool is_constant;
  76
  77    /** Indicates that the given variable must have a certain type
  78     *
  79     * This is only allowed in search expressions and indicates that the
  80     * given variable is only allowed to match values that come from an ALU
  81     * instruction with the given output type.  A type of nir_type_void
  82     * means it can match any type.
  83     *
  84     * Note: A variable that is both constant and has a non-void type will
  85     * never match anything.
  86     */
  87    nir_alu_type type;
  88
  89    /** Optional condition fxn ptr
  90     *
  91     * This is only allowed in search expressions, and allows additional
  92     * constraints to be placed on the match.  Typically used for 'is_constant'
  93     * variables to require, for example, power-of-two in order for the search
  94     * to match.
  95     */
  96    bool (*cond)(nir_alu_instr *instr, unsigned src,
  97                 unsigned num_components, const uint8_t *swizzle);
  98 } nir_search_variable;
  99
 100 typedef struct {
 101    nir_search_value value;
 102
 103    nir_alu_type type;
 104
 105    union {
 106       uint64_t u;
 107       int64_t i;
 108       double d;
 109    } data;
 110 } nir_search_constant;
 111
 112 enum nir_search_op {
 113    nir_search_op_i2f = nir_last_opcode + 1,
 114    nir_search_op_u2f,
 115    nir_search_op_f2f,
 116    nir_search_op_f2u,
 117    nir_search_op_f2i,
 118    nir_search_op_u2u,
 119    nir_search_op_i2i,
 120 };
 121
 122 typedef struct {
 123    nir_search_value value;
 124
 125    /* When set on a search expression, the expression will only match an SSA
 126     * value that does *not* have the exact bit set.  If unset, the exact bit
 127     * on the SSA value is ignored.
 128     */
 129    bool inexact;
 130
 131    /* One of nir_op or nir_search_op */
 132    uint16_t opcode;
 133    const nir_search_value *srcs[4];
 134
 135    /** Optional condition fxn ptr
 136     *
 137     * This allows additional constraints on expression matching, it is
 138     * typically used to match an expressions uses such as the number of times
 139     * the expression is used, and whether its used by an if.
 140     */
 141    bool (*cond)(nir_alu_instr *instr);
 142 } nir_search_expression;
 143
 144 NIR_DEFINE_CAST(nir_search_value_as_variable, nir_search_value,
 145                 nir_search_variable, value,
 146                 type, nir_search_value_variable)
 147 NIR_DEFINE_CAST(nir_search_value_as_constant, nir_search_value,
 148                 nir_search_constant, value,
 149                 type, nir_search_value_constant)
 150 NIR_DEFINE_CAST(nir_search_value_as_expression, nir_search_value,
 151                 nir_search_expression, value,
 152                 type, nir_search_value_expression)
 153
 154 nir_ssa_def *
 155 nir_replace_instr(struct nir_builder *b, nir_alu_instr *instr,
 156                   const nir_search_expression *search,
 157                   const nir_search_value *replace);
 158
 159 #endif /* _NIR_SEARCH_ */