1 /*
   2  * Copyright (c) 1997, 2019, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.
   8  *
   9  * This code is distributed in the hope that it will be useful, but WITHOUT
  10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  12  * version 2 for more details (a copy is included in the LICENSE file that
  13  * accompanied this code).
  14  *
  15  * You should have received a copy of the GNU General Public License version
  16  * 2 along with this work; if not, write to the Free Software Foundation,
  17  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  18  *
  19  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  20  * or visit www.oracle.com if you need additional information or have any
  21  * questions.
  22  *
  23  */
  24 
  25 #ifndef SHARE_UTILITIES_ACCESSFLAGS_HPP
  26 #define SHARE_UTILITIES_ACCESSFLAGS_HPP
  27 
  28 #include "jvm.h"
  29 #include "utilities/debug.hpp"
  30 #include "utilities/macros.hpp"
  31 
  32 // AccessFlags is an abstraction over Java access flags.
  33 
  34 class outputStream;
  35 
  36 enum {
  37   // See jvm.h for shared JVM_ACC_XXX access flags
  38 
  39   // HotSpot-specific access flags
  40 
  41   // flags actually put in .class file
  42   JVM_ACC_WRITTEN_FLAGS           = 0x00007FFF,
  43 
  44   // Method* flags
  45   JVM_ACC_MONITOR_MATCH           = 0x10000000,     // True if we know that monitorenter/monitorexit bytecodes match
  46   JVM_ACC_HAS_MONITOR_BYTECODES   = 0x20000000,     // Method contains monitorenter/monitorexit bytecodes
  47   JVM_ACC_HAS_LOOPS               = 0x40000000,     // Method has loops
  48   JVM_ACC_LOOPS_FLAG_INIT         = (int)0x80000000,// The loop flag has been initialized
  49   JVM_ACC_QUEUED                  = 0x01000000,     // Queued for compilation
  50   JVM_ACC_NOT_C2_COMPILABLE       = 0x02000000,
  51   JVM_ACC_NOT_C1_COMPILABLE       = 0x04000000,
  52   JVM_ACC_NOT_C2_OSR_COMPILABLE   = 0x08000000,
  53   JVM_ACC_HAS_LINE_NUMBER_TABLE   = 0x00100000,
  54   JVM_ACC_HAS_CHECKED_EXCEPTIONS  = 0x00400000,
  55   JVM_ACC_HAS_JSRS                = 0x00800000,
  56   JVM_ACC_IS_OLD                  = 0x00010000,     // RedefineClasses() has replaced this method
  57   JVM_ACC_IS_OBSOLETE             = 0x00020000,     // RedefineClasses() has made method obsolete
  58   JVM_ACC_IS_PREFIXED_NATIVE      = 0x00040000,     // JVMTI has prefixed this native method
  59   JVM_ACC_ON_STACK                = 0x00080000,     // RedefineClasses() was used on the stack
  60   JVM_ACC_IS_DELETED              = 0x00008000,     // RedefineClasses() has deleted this method
  61 
  62   // Klass* flags
  63   JVM_ACC_HAS_MIRANDA_METHODS     = 0x10000000,     // True if this class has miranda methods in it's vtable
  64   JVM_ACC_HAS_VANILLA_CONSTRUCTOR = 0x20000000,     // True if klass has a vanilla default constructor
  65   JVM_ACC_HAS_FINALIZER           = 0x40000000,     // True if klass has a non-empty finalize() method
  66   JVM_ACC_IS_CLONEABLE_FAST       = (int)0x80000000,// True if klass implements the Cloneable interface and can be optimized in generated code
  67   JVM_ACC_HAS_FINAL_METHOD        = 0x01000000,     // True if klass has final method
  68   JVM_ACC_IS_SHARED_CLASS         = 0x02000000,     // True if klass is shared
  69 
  70   // Klass* and Method* flags
  71   JVM_ACC_HAS_LOCAL_VARIABLE_TABLE= 0x00200000,
  72 
  73   JVM_ACC_PROMOTED_FLAGS          = 0x00200000,     // flags promoted from methods to the holding klass
  74 
  75   // field flags
  76   // Note: these flags must be defined in the low order 16 bits because
  77   // InstanceKlass only stores a ushort worth of information from the
  78   // AccessFlags value.
  79   // These bits must not conflict with any other field-related access flags
  80   // (e.g., ACC_ENUM).
  81   // Note that the class-related ACC_ANNOTATION bit conflicts with these flags.
  82   JVM_ACC_FIELD_ACCESS_WATCHED            = 0x00002000, // field access is watched by JVMTI
  83   JVM_ACC_FIELD_MODIFICATION_WATCHED      = 0x00008000, // field modification is watched by JVMTI
  84   JVM_ACC_FIELD_INTERNAL                  = 0x00000400, // internal field, same as JVM_ACC_ABSTRACT
  85   JVM_ACC_FIELD_STABLE                    = 0x00000020, // @Stable field, same as JVM_ACC_SYNCHRONIZED and JVM_ACC_SUPER
  86   JVM_ACC_FIELD_INITIALIZED_FINAL_UPDATE  = 0x00000200, // (static) final field updated outside (class) initializer, same as JVM_ACC_NATIVE
  87   JVM_ACC_FIELD_HAS_GENERIC_SIGNATURE     = 0x00000800, // field has generic signature
  88   /* JVM_ACC_FLATTENABLE                     = 0x00000100, */ // To be enabled when ACC_FLATTENABLE is removed from java.base
  89   JVM_ACC_FIELD_FLATTENED                 = 0x00008000, // flattened value field
  90 
  91   JVM_ACC_FIELD_INTERNAL_FLAGS       = JVM_ACC_FIELD_ACCESS_WATCHED |
  92                                        JVM_ACC_FIELD_MODIFICATION_WATCHED |
  93                                        JVM_ACC_FIELD_INTERNAL |
  94                                        JVM_ACC_FIELD_STABLE |
  95                                        JVM_ACC_FIELD_HAS_GENERIC_SIGNATURE |
  96                                        JVM_ACC_FLATTENABLE |
  97                                        JVM_ACC_FIELD_FLATTENED,
  98 
  99                                                     // flags accepted by set_field_flags()
 100   JVM_ACC_FIELD_FLAGS                = JVM_RECOGNIZED_FIELD_MODIFIERS | JVM_ACC_FIELD_INTERNAL_FLAGS
 101 
 102 };
 103 
 104 
 105 class AccessFlags {
 106   friend class VMStructs;
 107  private:
 108   jint _flags;
 109 
 110  public:
 111   AccessFlags() : _flags(0) {}
 112   explicit AccessFlags(jint flags) : _flags(flags) {}
 113 
 114   // Java access flags
 115   bool is_public      () const         { return (_flags & JVM_ACC_PUBLIC      ) != 0; }
 116   bool is_private     () const         { return (_flags & JVM_ACC_PRIVATE     ) != 0; }
 117   bool is_protected   () const         { return (_flags & JVM_ACC_PROTECTED   ) != 0; }
 118   bool is_static      () const         { return (_flags & JVM_ACC_STATIC      ) != 0; }
 119   bool is_final       () const         { return (_flags & JVM_ACC_FINAL       ) != 0; }
 120   bool is_synchronized() const         { return (_flags & JVM_ACC_SYNCHRONIZED) != 0; }
 121   bool is_super       () const         { return (_flags & JVM_ACC_SUPER       ) != 0; }
 122   bool is_volatile    () const         { return (_flags & JVM_ACC_VOLATILE    ) != 0; }
 123   bool is_transient   () const         { return (_flags & JVM_ACC_TRANSIENT   ) != 0; }
 124   bool is_native      () const         { return (_flags & JVM_ACC_NATIVE      ) != 0; }
 125   bool is_interface   () const         { return (_flags & JVM_ACC_INTERFACE   ) != 0; }
 126   bool is_abstract    () const         { return (_flags & JVM_ACC_ABSTRACT    ) != 0; }
 127   bool is_strict      () const         { return (_flags & JVM_ACC_STRICT      ) != 0; }
 128   bool is_value_type  () const         { return (_flags & JVM_ACC_VALUE       ) != 0; }
 129   bool is_flattenable () const         { return (_flags & JVM_ACC_FLATTENABLE ) != 0; }
 130 
 131   // Attribute flags
 132   bool is_synthetic   () const         { return (_flags & JVM_ACC_SYNTHETIC   ) != 0; }
 133 
 134   // Method* flags
 135   bool is_monitor_matching     () const { return (_flags & JVM_ACC_MONITOR_MATCH          ) != 0; }
 136   bool has_monitor_bytecodes   () const { return (_flags & JVM_ACC_HAS_MONITOR_BYTECODES  ) != 0; }
 137   bool has_loops               () const { return (_flags & JVM_ACC_HAS_LOOPS              ) != 0; }
 138   bool loops_flag_init         () const { return (_flags & JVM_ACC_LOOPS_FLAG_INIT        ) != 0; }
 139   bool queued_for_compilation  () const { return (_flags & JVM_ACC_QUEUED                 ) != 0; }
 140   bool is_not_c1_compilable    () const { return (_flags & JVM_ACC_NOT_C1_COMPILABLE      ) != 0; }
 141   bool is_not_c2_compilable    () const { return (_flags & JVM_ACC_NOT_C2_COMPILABLE      ) != 0; }
 142   bool is_not_c2_osr_compilable() const { return (_flags & JVM_ACC_NOT_C2_OSR_COMPILABLE  ) != 0; }
 143   bool has_linenumber_table    () const { return (_flags & JVM_ACC_HAS_LINE_NUMBER_TABLE  ) != 0; }
 144   bool has_checked_exceptions  () const { return (_flags & JVM_ACC_HAS_CHECKED_EXCEPTIONS ) != 0; }
 145   bool has_jsrs                () const { return (_flags & JVM_ACC_HAS_JSRS               ) != 0; }
 146   bool is_old                  () const { return (_flags & JVM_ACC_IS_OLD                 ) != 0; }
 147   bool is_obsolete             () const { return (_flags & JVM_ACC_IS_OBSOLETE            ) != 0; }
 148   bool is_deleted              () const { return (_flags & JVM_ACC_IS_DELETED             ) != 0; }
 149   bool is_prefixed_native      () const { return (_flags & JVM_ACC_IS_PREFIXED_NATIVE     ) != 0; }
 150 
 151   // Klass* flags
 152   bool has_miranda_methods     () const { return (_flags & JVM_ACC_HAS_MIRANDA_METHODS    ) != 0; }
 153   bool has_vanilla_constructor () const { return (_flags & JVM_ACC_HAS_VANILLA_CONSTRUCTOR) != 0; }
 154   bool has_finalizer           () const { return (_flags & JVM_ACC_HAS_FINALIZER          ) != 0; }
 155   bool has_final_method        () const { return (_flags & JVM_ACC_HAS_FINAL_METHOD       ) != 0; }
 156   bool is_cloneable_fast       () const { return (_flags & JVM_ACC_IS_CLONEABLE_FAST      ) != 0; }
 157   bool is_shared_class         () const { return (_flags & JVM_ACC_IS_SHARED_CLASS        ) != 0; }
 158 
 159   // Klass* and Method* flags
 160   bool has_localvariable_table () const { return (_flags & JVM_ACC_HAS_LOCAL_VARIABLE_TABLE) != 0; }
 161   void set_has_localvariable_table()    { atomic_set_bits(JVM_ACC_HAS_LOCAL_VARIABLE_TABLE); }
 162   void clear_has_localvariable_table()  { atomic_clear_bits(JVM_ACC_HAS_LOCAL_VARIABLE_TABLE); }
 163 
 164   // field flags
 165   bool is_field_access_watched() const  { return (_flags & JVM_ACC_FIELD_ACCESS_WATCHED) != 0; }
 166   bool is_field_modification_watched() const
 167                                         { return (_flags & JVM_ACC_FIELD_MODIFICATION_WATCHED) != 0; }
 168   bool has_field_initialized_final_update() const
 169                                         { return (_flags & JVM_ACC_FIELD_INITIALIZED_FINAL_UPDATE) != 0; }
 170   bool on_stack() const                 { return (_flags & JVM_ACC_ON_STACK) != 0; }
 171   bool is_internal() const              { return (_flags & JVM_ACC_FIELD_INTERNAL) != 0; }
 172   bool is_stable() const                { return (_flags & JVM_ACC_FIELD_STABLE) != 0; }
 173   bool field_has_generic_signature() const
 174                                         { return (_flags & JVM_ACC_FIELD_HAS_GENERIC_SIGNATURE) != 0; }
 175 
 176   // get .class file flags
 177   jint get_flags               () const { return (_flags & JVM_ACC_WRITTEN_FLAGS); }
 178 
 179   // Initialization
 180   void add_promoted_flags(jint flags)   { _flags |= (flags & JVM_ACC_PROMOTED_FLAGS); }
 181   void set_field_flags(jint flags)      {
 182     assert((flags & JVM_ACC_FIELD_FLAGS) == flags, "only recognized flags");
 183     _flags = (flags & JVM_ACC_FIELD_FLAGS);
 184   }
 185   void set_flags(jint flags)            { _flags = (flags & JVM_ACC_WRITTEN_FLAGS); }
 186 
 187   void set_queued_for_compilation()    { atomic_set_bits(JVM_ACC_QUEUED); }
 188   void clear_queued_for_compilation()  { atomic_clear_bits(JVM_ACC_QUEUED); }
 189 
 190   // Atomic update of flags
 191   void atomic_set_bits(jint bits);
 192   void atomic_clear_bits(jint bits);
 193 
 194  private:
 195   friend class Method;
 196   friend class Klass;
 197   friend class ClassFileParser;
 198   // the functions below should only be called on the _access_flags inst var directly,
 199   // otherwise they are just changing a copy of the flags
 200 
 201   // attribute flags
 202   void set_is_synthetic()              { atomic_set_bits(JVM_ACC_SYNTHETIC);               }
 203 
 204   // Method* flags
 205   void set_monitor_matching()          { atomic_set_bits(JVM_ACC_MONITOR_MATCH);           }
 206   void set_has_monitor_bytecodes()     { atomic_set_bits(JVM_ACC_HAS_MONITOR_BYTECODES);   }
 207   void set_has_loops()                 { atomic_set_bits(JVM_ACC_HAS_LOOPS);               }
 208   void set_loops_flag_init()           { atomic_set_bits(JVM_ACC_LOOPS_FLAG_INIT);         }
 209   void set_not_c1_compilable()         { atomic_set_bits(JVM_ACC_NOT_C1_COMPILABLE);       }
 210   void set_not_c2_compilable()         { atomic_set_bits(JVM_ACC_NOT_C2_COMPILABLE);       }
 211   void set_not_c2_osr_compilable()     { atomic_set_bits(JVM_ACC_NOT_C2_OSR_COMPILABLE);   }
 212   void set_has_linenumber_table()      { atomic_set_bits(JVM_ACC_HAS_LINE_NUMBER_TABLE);   }
 213   void set_has_checked_exceptions()    { atomic_set_bits(JVM_ACC_HAS_CHECKED_EXCEPTIONS);  }
 214   void set_has_jsrs()                  { atomic_set_bits(JVM_ACC_HAS_JSRS);                }
 215   void set_is_old()                    { atomic_set_bits(JVM_ACC_IS_OLD);                  }
 216   void set_is_obsolete()               { atomic_set_bits(JVM_ACC_IS_OBSOLETE);             }
 217   void set_is_deleted()                { atomic_set_bits(JVM_ACC_IS_DELETED);              }
 218   void set_is_prefixed_native()        { atomic_set_bits(JVM_ACC_IS_PREFIXED_NATIVE);      }
 219   void set_is_flattenable()            { atomic_set_bits(JVM_ACC_FLATTENABLE);             }
 220 
 221   void clear_not_c1_compilable()       { atomic_clear_bits(JVM_ACC_NOT_C1_COMPILABLE);       }
 222   void clear_not_c2_compilable()       { atomic_clear_bits(JVM_ACC_NOT_C2_COMPILABLE);       }
 223   void clear_not_c2_osr_compilable()   { atomic_clear_bits(JVM_ACC_NOT_C2_OSR_COMPILABLE);   }
 224   // Klass* flags
 225   void set_has_vanilla_constructor()   { atomic_set_bits(JVM_ACC_HAS_VANILLA_CONSTRUCTOR); }
 226   void set_has_finalizer()             { atomic_set_bits(JVM_ACC_HAS_FINALIZER);           }
 227   void set_has_final_method()          { atomic_set_bits(JVM_ACC_HAS_FINAL_METHOD);        }
 228   void set_is_cloneable_fast()         { atomic_set_bits(JVM_ACC_IS_CLONEABLE_FAST);       }
 229   void set_has_miranda_methods()       { atomic_set_bits(JVM_ACC_HAS_MIRANDA_METHODS);     }
 230   void set_is_shared_class()           { atomic_set_bits(JVM_ACC_IS_SHARED_CLASS);         }
 231 
 232  public:
 233   // field flags
 234   void set_is_field_access_watched(const bool value)
 235                                        {
 236                                          if (value) {
 237                                            atomic_set_bits(JVM_ACC_FIELD_ACCESS_WATCHED);
 238                                          } else {
 239                                            atomic_clear_bits(JVM_ACC_FIELD_ACCESS_WATCHED);
 240                                          }
 241                                        }
 242   void set_is_field_modification_watched(const bool value)
 243                                        {
 244                                          if (value) {
 245                                            atomic_set_bits(JVM_ACC_FIELD_MODIFICATION_WATCHED);
 246                                          } else {
 247                                            atomic_clear_bits(JVM_ACC_FIELD_MODIFICATION_WATCHED);
 248                                          }
 249                                        }
 250 
 251   void set_has_field_initialized_final_update(const bool value) {
 252     if (value) {
 253       atomic_set_bits(JVM_ACC_FIELD_INITIALIZED_FINAL_UPDATE);
 254     } else {
 255       atomic_clear_bits(JVM_ACC_FIELD_INITIALIZED_FINAL_UPDATE);
 256     }
 257   }
 258 
 259   void set_field_has_generic_signature()
 260                                        {
 261                                          atomic_set_bits(JVM_ACC_FIELD_HAS_GENERIC_SIGNATURE);
 262                                        }
 263 
 264   void set_on_stack(const bool value)
 265                                        {
 266                                          if (value) {
 267                                            atomic_set_bits(JVM_ACC_ON_STACK);
 268                                          } else {
 269                                            atomic_clear_bits(JVM_ACC_ON_STACK);
 270                                          }
 271                                        }
 272   // Conversion
 273   jshort as_short() const              { return (jshort)_flags; }
 274   jint   as_int() const                { return _flags; }
 275 
 276   inline friend AccessFlags accessFlags_from(jint flags);
 277 
 278   // Printing/debugging
 279 #if INCLUDE_JVMTI
 280   void print_on(outputStream* st) const;
 281 #else
 282   void print_on(outputStream* st) const PRODUCT_RETURN;
 283 #endif
 284 };
 285 
 286 inline AccessFlags accessFlags_from(jint flags) {
 287   AccessFlags af;
 288   af._flags = flags;
 289   return af;
 290 }
 291 
 292 #endif // SHARE_UTILITIES_ACCESSFLAGS_HPP