gcc/tree-ssanames.h

   1 /* SSA name expresssons routines
   2    Copyright (C) 2013-2024 Free Software Foundation, Inc.
   3
   4 This file is part of GCC.
   5
   6 GCC is free software; you can redistribute it and/or modify it under
   7 the terms of the GNU General Public License as published by the Free
   8 Software Foundation; either version 3, or (at your option) any later
   9 version.
  10
  11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with GCC; see the file COPYING3.  If not see
  18 <http://www.gnu.org/licenses/>.  */
  19
  20 #ifndef GCC_TREE_SSANAMES_H
  21 #define GCC_TREE_SSANAMES_H
  22
  23 /* Aliasing information for SSA_NAMEs representing pointer variables.  */
  24
  25 struct GTY(()) ptr_info_def
  26 {
  27   /* The points-to solution.  */
  28   struct pt_solution pt;
  29
  30   /* Alignment and misalignment of the pointer in bytes.  Together
  31      align and misalign specify low known bits of the pointer.
  32      ptr & (align - 1) == misalign.  */
  33
  34   /* When known, this is the power-of-two byte alignment of the object this
  35      pointer points into.  This is usually DECL_ALIGN_UNIT for decls and
  36      MALLOC_ABI_ALIGNMENT for allocated storage.  When the alignment is not
  37      known, it is zero.  Do not access directly but use functions
  38      get_ptr_info_alignment, set_ptr_info_alignment,
  39      mark_ptr_info_alignment_unknown and similar.  */
  40   unsigned int align;
  41
  42   /* When alignment is known, the byte offset this pointer differs from the
  43      above alignment.  Access only through the same helper functions as align
  44      above.  */
  45   unsigned int misalign;
  46 };
  47
  48
  49 #define SSANAMES(fun) (fun)->gimple_df->ssa_names
  50 #define DEFAULT_DEFS(fun) (fun)->gimple_df->default_defs
  51
  52 #define num_ssa_names (vec_safe_length (cfun->gimple_df->ssa_names))
  53 #define ssa_name(i) ((*cfun->gimple_df->ssa_names)[(i)])
  54
  55 #define FOR_EACH_SSA_NAME(I, VAR, FN)                                   \
  56   for (I = 1; SSANAMES (FN)->iterate (I, &VAR); ++I)                    \
  57     if (VAR)
  58
  59 /* Sets the value range to SSA.  */
  60 extern bool set_range_info (tree, const vrange &);
  61 extern void set_nonzero_bits (tree, const wide_int &);
  62 extern void set_bitmask (tree, const wide_int &value, const wide_int &mask);
  63 extern wide_int get_nonzero_bits (const_tree);
  64 extern bool ssa_name_has_boolean_range (tree);
  65 extern void init_ssanames (struct function *, int);
  66 extern void fini_ssanames (struct function *);
  67 extern void ssanames_print_statistics (void);
  68 extern tree make_ssa_name_fn (struct function *, tree, gimple *,
  69                               unsigned int version = 0);
  70 extern void init_ssa_name_imm_use (tree);
  71 extern void release_ssa_name_fn (struct function *, tree);
  72 extern bool get_ptr_info_alignment (struct ptr_info_def *, unsigned int *,
  73                                     unsigned int *);
  74 extern void mark_ptr_info_alignment_unknown (struct ptr_info_def *);
  75 extern void set_ptr_info_alignment (struct ptr_info_def *, unsigned int,
  76                                     unsigned int);
  77 extern void adjust_ptr_info_misalignment (struct ptr_info_def *, poly_uint64);
  78 extern struct ptr_info_def *get_ptr_info (tree);
  79 extern void set_ptr_nonnull (tree);
  80
  81 extern tree copy_ssa_name_fn (struct function *, tree, gimple *);
  82 extern tree duplicate_ssa_name_fn (struct function *, tree, gimple *);
  83 extern void duplicate_ssa_name_ptr_info (tree, struct ptr_info_def *);
  84 extern void duplicate_ssa_name_range_info (tree dest, tree src);
  85 extern void maybe_duplicate_ssa_info_at_copy (tree dest, tree src);
  86 extern void reset_flow_sensitive_info (tree);
  87 extern void reset_flow_sensitive_info_in_bb (basic_block);
  88 extern void release_defs (gimple *);
  89 extern void replace_ssa_name_symbol (tree, tree);
  90 extern void flush_ssaname_freelist (void);
  91
  92
  93 /* Return an SSA_NAME node for variable VAR defined in statement STMT
  94    in function cfun.  */
  95
  96 inline tree
  97 make_ssa_name (tree var, gimple *stmt = NULL)
  98 {
  99   return make_ssa_name_fn (cfun, var, stmt);
 100 }
 101
 102 /* Return an SSA_NAME node using the template SSA name NAME defined in
 103    statement STMT in function cfun.  */
 104
 105 inline tree
 106 copy_ssa_name (tree var, gimple *stmt = NULL)
 107 {
 108   return copy_ssa_name_fn (cfun, var, stmt);
 109 }
 110
 111 /*  Creates a duplicate of a SSA name NAME tobe defined by statement STMT
 112     in function cfun.  */
 113
 114 inline tree
 115 duplicate_ssa_name (tree var, gimple *stmt)
 116 {
 117   return duplicate_ssa_name_fn (cfun, var, stmt);
 118 }
 119
 120 /* Release the SSA name NAME used in function cfun.  */
 121
 122 inline void
 123 release_ssa_name (tree name)
 124 {
 125   release_ssa_name_fn (cfun, name);
 126 }
 127
 128 /* Return an anonymous SSA_NAME node for type TYPE defined in statement STMT
 129    in function cfun.  Arrange so that it uses NAME in dumps.  */
 130
 131 inline tree
 132 make_temp_ssa_name (tree type, gimple *stmt, const char *name)
 133 {
 134   tree ssa_name;
 135   gcc_checking_assert (TYPE_P (type));
 136   ssa_name = make_ssa_name_fn (cfun, type, stmt);
 137   SET_SSA_NAME_VAR_OR_IDENTIFIER (ssa_name, get_identifier (name));
 138   return ssa_name;
 139 }
 140
 141 /* A class which is used to save/restore the flow sensitive information.  */
 142 class flow_sensitive_info_storage
 143 {
 144 public:
 145   void save (tree);
 146   void save_and_clear (tree);
 147   void restore (tree);
 148   void clear_storage ();
 149 private:
 150   /* 0 means there is nothing saved.
 151      1 means non pointer is saved.
 152      -1 means a pointer type is saved.
 153      -2 means a pointer type is saved but no information was saved. */
 154   int state = 0;
 155   /* The range info for non pointers */
 156   vrange_storage *range_info = nullptr;
 157   /* Flow sensitive pointer information. */
 158   unsigned int align = 0;
 159   unsigned int misalign = 0;
 160   bool null = true;
 161 };
 162
 163 #endif /* GCC_TREE_SSANAMES_H */