1 /*
   2  * Copyright (c) 1997, 2018, 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_VM_MEMORY_UNIVERSE_HPP
  26 #define SHARE_VM_MEMORY_UNIVERSE_HPP
  27 
  28 #include "oops/array.hpp"
  29 #include "runtime/handles.hpp"
  30 #include "utilities/growableArray.hpp"
  31 
  32 // Universe is a name space holding known system classes and objects in the VM.
  33 //
  34 // Loaded classes are accessible through the SystemDictionary.
  35 //
  36 // The object heap is allocated and accessed through Universe, and various allocation
  37 // support is provided. Allocation by the interpreter and compiled code is done inline
  38 // and bails out to Scavenge::invoke_and_allocate.
  39 
  40 class CollectedHeap;
  41 class DeferredObjAllocEvent;
  42 class OopStorage;
  43 
  44 
  45 // A helper class for caching a Method* when the user of the cache
  46 // only cares about the latest version of the Method*.  This cache safely
  47 // interacts with the RedefineClasses API.
  48 
  49 class LatestMethodCache : public CHeapObj<mtClass> {
  50   // We save the Klass* and the idnum of Method* in order to get
  51   // the current cached Method*.
  52  private:
  53   Klass*                _klass;
  54   int                   _method_idnum;
  55 
  56  public:
  57   LatestMethodCache()   { _klass = NULL; _method_idnum = -1; }
  58   ~LatestMethodCache()  { _klass = NULL; _method_idnum = -1; }
  59 
  60   void   init(Klass* k, Method* m);
  61   Klass* klass() const           { return _klass; }
  62   int    method_idnum() const    { return _method_idnum; }
  63 
  64   Method* get_method();
  65 
  66   // CDS support.  Replace the klass in this with the archive version
  67   // could use this for Enhanced Class Redefinition also.
  68   void serialize(SerializeClosure* f) {
  69     f->do_ptr((void**)&_klass);
  70   }
  71   void metaspace_pointers_do(MetaspaceClosure* it);
  72 };
  73 
  74 
  75 // For UseCompressedOops.
  76 struct NarrowPtrStruct {
  77   // Base address for oop-within-java-object materialization.
  78   // NULL if using wide oops or zero based narrow oops.
  79   address _base;
  80   // Number of shift bits for encoding/decoding narrow ptrs.
  81   // 0 if using wide ptrs or zero based unscaled narrow ptrs,
  82   // LogMinObjAlignmentInBytes/LogKlassAlignmentInBytes otherwise.
  83   int     _shift;
  84   // Generate code with implicit null checks for narrow ptrs.
  85   bool    _use_implicit_null_checks;
  86 };
  87 
  88 enum VerifyOption {
  89       VerifyOption_Default = 0,
  90 
  91       // G1
  92       VerifyOption_G1UsePrevMarking = VerifyOption_Default,
  93       VerifyOption_G1UseNextMarking = VerifyOption_G1UsePrevMarking + 1,
  94       VerifyOption_G1UseFullMarking = VerifyOption_G1UseNextMarking + 1
  95 };
  96 
  97 class Universe: AllStatic {
  98   // Ugh.  Universe is much too friendly.
  99   friend class MarkSweep;
 100   friend class oopDesc;
 101   friend class ClassLoader;
 102   friend class SystemDictionary;
 103   friend class ReservedHeapSpace;
 104   friend class VMStructs;
 105   friend class VM_PopulateDumpSharedSpace;
 106   friend class Metaspace;
 107   friend class MetaspaceShared;
 108 
 109   friend jint  universe_init();
 110   friend void  universe2_init();
 111   friend bool  universe_post_init();
 112   friend void  universe_post_module_init();
 113 
 114  private:
 115   // Known classes in the VM
 116   static Klass* _boolArrayKlassObj;
 117   static Klass* _byteArrayKlassObj;
 118   static Klass* _charArrayKlassObj;
 119   static Klass* _intArrayKlassObj;
 120   static Klass* _shortArrayKlassObj;
 121   static Klass* _longArrayKlassObj;
 122   static Klass* _singleArrayKlassObj;
 123   static Klass* _doubleArrayKlassObj;
 124   static Klass* _typeArrayKlassObjs[T_VOID+1];
 125 
 126   static Klass* _objectArrayKlassObj;
 127 
 128   // VM weak OopStorage object.
 129   static OopStorage* _vm_weak_oop_storage;
 130 
 131   // Known objects in the VM
 132 
 133   // Primitive objects
 134   static oop _int_mirror;
 135   static oop _float_mirror;
 136   static oop _double_mirror;
 137   static oop _byte_mirror;
 138   static oop _bool_mirror;
 139   static oop _char_mirror;
 140   static oop _long_mirror;
 141   static oop _short_mirror;
 142   static oop _void_mirror;
 143 
 144   static oop          _main_thread_group;             // Reference to the main thread group object
 145   static oop          _system_thread_group;           // Reference to the system thread group object
 146 
 147   static objArrayOop  _the_empty_class_klass_array;   // Canonicalized obj array of type java.lang.Class
 148   static oop          _the_null_sentinel;             // A unique object pointer unused except as a sentinel for null.
 149   static oop          _the_null_string;               // A cache of "null" as a Java string
 150   static oop          _the_min_jint_string;          // A cache of "-2147483648" as a Java string
 151   static LatestMethodCache* _finalizer_register_cache; // static method for registering finalizable objects
 152   static LatestMethodCache* _loader_addClass_cache;    // method for registering loaded classes in class loader vector
 153   static LatestMethodCache* _pd_implies_cache;         // method for checking protection domain attributes
 154   static LatestMethodCache* _throw_illegal_access_error_cache; // Unsafe.throwIllegalAccessError() method
 155   static LatestMethodCache* _do_stack_walk_cache;      // method for stack walker callback
 156 
 157   // preallocated error objects (no backtrace)
 158   static oop          _out_of_memory_error_java_heap;
 159   static oop          _out_of_memory_error_metaspace;
 160   static oop          _out_of_memory_error_class_metaspace;
 161   static oop          _out_of_memory_error_array_size;
 162   static oop          _out_of_memory_error_gc_overhead_limit;
 163   static oop          _out_of_memory_error_realloc_objects;
 164 
 165   // preallocated cause message for delayed StackOverflowError
 166   static oop          _delayed_stack_overflow_error_message;
 167 
 168   static Array<int>*       _the_empty_int_array;    // Canonicalized int array
 169   static Array<u2>*        _the_empty_short_array;  // Canonicalized short array
 170   static Array<Klass*>*  _the_empty_klass_array;  // Canonicalized klass obj array
 171   static Array<Method*>* _the_empty_method_array; // Canonicalized method obj array
 172 
 173   static Array<Klass*>*  _the_array_interfaces_array;
 174 
 175   // array of preallocated error objects with backtrace
 176   static objArrayOop   _preallocated_out_of_memory_error_array;
 177 
 178   // number of preallocated error objects available for use
 179   static volatile jint _preallocated_out_of_memory_error_avail_count;
 180 
 181   static oop          _null_ptr_exception_instance;   // preallocated exception object
 182   static oop          _arithmetic_exception_instance; // preallocated exception object
 183   static oop          _virtual_machine_error_instance; // preallocated exception object
 184   // The object used as an exception dummy when exceptions are thrown for
 185   // the vm thread.
 186   static oop          _vm_exception;
 187 
 188   // References waiting to be transferred to the ReferenceHandler
 189   static oop          _reference_pending_list;
 190 
 191   // The particular choice of collected heap.
 192   static CollectedHeap* _collectedHeap;
 193 
 194   static intptr_t _non_oop_bits;
 195 
 196   // For UseCompressedOops.
 197   static struct NarrowPtrStruct _narrow_oop;
 198   // For UseCompressedClassPointers.
 199   static struct NarrowPtrStruct _narrow_klass;
 200   static address _narrow_ptrs_base;
 201   // CompressedClassSpaceSize set to 1GB, but appear 3GB away from _narrow_ptrs_base during CDS dump.
 202   static uint64_t _narrow_klass_range;
 203   // array of dummy objects used with +FullGCAlot
 204   debug_only(static objArrayOop _fullgc_alot_dummy_array;)
 205   // index of next entry to clear
 206   debug_only(static int         _fullgc_alot_dummy_next;)
 207 
 208   // Compiler/dispatch support
 209   static int  _base_vtable_size;                      // Java vtbl size of klass Object (in words)
 210 
 211   // Initialization
 212   static bool _bootstrapping;                         // true during genesis
 213   static bool _module_initialized;                    // true after call_initPhase2 called
 214   static bool _fully_initialized;                     // true after universe_init and initialize_vtables called
 215 
 216   // the array of preallocated errors with backtraces
 217   static objArrayOop  preallocated_out_of_memory_errors()     { return _preallocated_out_of_memory_error_array; }
 218 
 219   // generate an out of memory error; if possible using an error with preallocated backtrace;
 220   // otherwise return the given default error.
 221   static oop        gen_out_of_memory_error(oop default_err);
 222 
 223   // Historic gc information
 224   static size_t _heap_capacity_at_last_gc;
 225   static size_t _heap_used_at_last_gc;
 226 
 227   static CollectedHeap* create_heap();
 228   static jint initialize_heap();
 229   static void initialize_basic_type_mirrors(TRAPS);
 230   static void fixup_mirrors(TRAPS);
 231 
 232   static void reinitialize_vtable_of(Klass* k, TRAPS);
 233   static void reinitialize_itables(TRAPS);
 234   static void compute_base_vtable_size();             // compute vtable size of class Object
 235 
 236   static void initialize_oop_storage();
 237 
 238   static void genesis(TRAPS);                         // Create the initial world
 239 
 240   // Mirrors for primitive classes (created eagerly)
 241   static oop check_mirror(oop m) {
 242     assert(m != NULL, "mirror not initialized");
 243     return m;
 244   }
 245 
 246   static void     set_narrow_oop_base(address base) {
 247     assert(UseCompressedOops, "no compressed oops?");
 248     _narrow_oop._base    = base;
 249   }
 250   static void     set_narrow_klass_base(address base) {
 251     assert(UseCompressedClassPointers, "no compressed klass ptrs?");
 252     _narrow_klass._base   = base;
 253   }
 254   static void     set_narrow_klass_range(uint64_t range) {
 255      assert(UseCompressedClassPointers, "no compressed klass ptrs?");
 256      _narrow_klass_range = range;
 257   }
 258   static void     set_narrow_oop_use_implicit_null_checks(bool use) {
 259     assert(UseCompressedOops, "no compressed ptrs?");
 260     _narrow_oop._use_implicit_null_checks   = use;
 261   }
 262 
 263   // Debugging
 264   static int _verify_count;                           // number of verifies done
 265 
 266   // True during call to verify().  Should only be set/cleared in verify().
 267   static bool _verify_in_progress;
 268   static long verify_flags;
 269 
 270   static uintptr_t _verify_oop_mask;
 271   static uintptr_t _verify_oop_bits;
 272 
 273   static void calculate_verify_data(HeapWord* low_boundary, HeapWord* high_boundary) PRODUCT_RETURN;
 274   static void compute_verify_oop_data();
 275 
 276  public:
 277   // Known classes in the VM
 278   static Klass* boolArrayKlassObj()                 { return _boolArrayKlassObj;   }
 279   static Klass* byteArrayKlassObj()                 { return _byteArrayKlassObj;   }
 280   static Klass* charArrayKlassObj()                 { return _charArrayKlassObj;   }
 281   static Klass* intArrayKlassObj()                  { return _intArrayKlassObj;    }
 282   static Klass* shortArrayKlassObj()                { return _shortArrayKlassObj;  }
 283   static Klass* longArrayKlassObj()                 { return _longArrayKlassObj;   }
 284   static Klass* singleArrayKlassObj()               { return _singleArrayKlassObj; }
 285   static Klass* doubleArrayKlassObj()               { return _doubleArrayKlassObj; }
 286 
 287   static Klass* objectArrayKlassObj() {
 288     return _objectArrayKlassObj;
 289   }
 290 
 291   static Klass* typeArrayKlassObj(BasicType t) {
 292     assert((uint)t < T_VOID+1, "range check for type: %s", type2name(t));
 293     assert(_typeArrayKlassObjs[t] != NULL, "domain check");
 294     return _typeArrayKlassObjs[t];
 295   }
 296 
 297   static OopStorage* vm_weak_oop_storage();
 298 
 299   // Known objects in the VM
 300   static oop int_mirror()                   { return check_mirror(_int_mirror); }
 301   static oop float_mirror()                 { return check_mirror(_float_mirror); }
 302   static oop double_mirror()                { return check_mirror(_double_mirror); }
 303   static oop byte_mirror()                  { return check_mirror(_byte_mirror); }
 304   static oop bool_mirror()                  { return check_mirror(_bool_mirror); }
 305   static oop char_mirror()                  { return check_mirror(_char_mirror); }
 306   static oop long_mirror()                  { return check_mirror(_long_mirror); }
 307   static oop short_mirror()                 { return check_mirror(_short_mirror); }
 308   static oop void_mirror()                  { return check_mirror(_void_mirror); }
 309 
 310   static void set_int_mirror(oop m)         { _int_mirror = m;    }
 311   static void set_float_mirror(oop m)       { _float_mirror = m;  }
 312   static void set_double_mirror(oop m)      { _double_mirror = m; }
 313   static void set_byte_mirror(oop m)        { _byte_mirror = m;   }
 314   static void set_bool_mirror(oop m)        { _bool_mirror = m;   }
 315   static void set_char_mirror(oop m)        { _char_mirror = m;   }
 316   static void set_long_mirror(oop m)        { _long_mirror = m;   }
 317   static void set_short_mirror(oop m)       { _short_mirror = m;  }
 318   static void set_void_mirror(oop m)        { _void_mirror = m;   }
 319 
 320   // table of same
 321   static oop _mirrors[T_VOID+1];
 322 
 323   static oop java_mirror(BasicType t) {
 324     assert((uint)t < T_VOID+1, "range check");
 325     return check_mirror(_mirrors[t]);
 326   }
 327   static oop      main_thread_group()                 { return _main_thread_group; }
 328   static void set_main_thread_group(oop group)        { _main_thread_group = group;}
 329 
 330   static oop      system_thread_group()               { return _system_thread_group; }
 331   static void set_system_thread_group(oop group)      { _system_thread_group = group;}
 332 
 333   static objArrayOop  the_empty_class_klass_array ()  { return _the_empty_class_klass_array;   }
 334   static Array<Klass*>* the_array_interfaces_array() { return _the_array_interfaces_array;   }
 335   static oop          the_null_string()               { return _the_null_string;               }
 336   static oop          the_min_jint_string()          { return _the_min_jint_string;          }
 337 
 338   static Method*      finalizer_register_method()     { return _finalizer_register_cache->get_method(); }
 339   static Method*      loader_addClass_method()        { return _loader_addClass_cache->get_method(); }
 340 
 341   static Method*      protection_domain_implies_method() { return _pd_implies_cache->get_method(); }
 342   static Method*      throw_illegal_access_error()    { return _throw_illegal_access_error_cache->get_method(); }
 343 
 344   static Method*      do_stack_walk_method()          { return _do_stack_walk_cache->get_method(); }
 345 
 346   static oop          the_null_sentinel()             { return _the_null_sentinel;             }
 347   static address      the_null_sentinel_addr()        { return (address) &_the_null_sentinel;  }
 348 
 349   // Function to initialize these
 350   static void initialize_known_methods(TRAPS);
 351 
 352   static oop          null_ptr_exception_instance()   { return _null_ptr_exception_instance;   }
 353   static oop          arithmetic_exception_instance() { return _arithmetic_exception_instance; }
 354   static oop          virtual_machine_error_instance() { return _virtual_machine_error_instance; }
 355   static oop          vm_exception()                  { return _vm_exception; }
 356 
 357   // Reference pending list manipulation.  Access is protected by
 358   // Heap_lock.  The getter, setter and predicate require the caller
 359   // owns the lock.  Swap is used by parallel non-concurrent reference
 360   // processing threads, where some higher level controller owns
 361   // Heap_lock, so requires the lock is locked, but not necessarily by
 362   // the current thread.
 363   static oop          reference_pending_list();
 364   static void         set_reference_pending_list(oop list);
 365   static bool         has_reference_pending_list();
 366   static oop          swap_reference_pending_list(oop list);
 367 
 368   static Array<int>*       the_empty_int_array()    { return _the_empty_int_array; }
 369   static Array<u2>*        the_empty_short_array()  { return _the_empty_short_array; }
 370   static Array<Method*>* the_empty_method_array() { return _the_empty_method_array; }
 371   static Array<Klass*>*  the_empty_klass_array()  { return _the_empty_klass_array; }
 372 
 373   // OutOfMemoryError support. Returns an error with the required message. The returned error
 374   // may or may not have a backtrace. If error has a backtrace then the stack trace is already
 375   // filled in.
 376   static oop out_of_memory_error_java_heap()          { return gen_out_of_memory_error(_out_of_memory_error_java_heap);  }
 377   static oop out_of_memory_error_metaspace()          { return gen_out_of_memory_error(_out_of_memory_error_metaspace);   }
 378   static oop out_of_memory_error_class_metaspace()    { return gen_out_of_memory_error(_out_of_memory_error_class_metaspace);   }
 379   static oop out_of_memory_error_array_size()         { return gen_out_of_memory_error(_out_of_memory_error_array_size); }
 380   static oop out_of_memory_error_gc_overhead_limit()  { return gen_out_of_memory_error(_out_of_memory_error_gc_overhead_limit);  }
 381   static oop out_of_memory_error_realloc_objects()    { return gen_out_of_memory_error(_out_of_memory_error_realloc_objects);  }
 382   static oop delayed_stack_overflow_error_message()   { return _delayed_stack_overflow_error_message; }
 383 
 384   // Accessors needed for fast allocation
 385   static Klass** boolArrayKlassObj_addr()           { return &_boolArrayKlassObj;   }
 386   static Klass** byteArrayKlassObj_addr()           { return &_byteArrayKlassObj;   }
 387   static Klass** charArrayKlassObj_addr()           { return &_charArrayKlassObj;   }
 388   static Klass** intArrayKlassObj_addr()            { return &_intArrayKlassObj;    }
 389   static Klass** shortArrayKlassObj_addr()          { return &_shortArrayKlassObj;  }
 390   static Klass** longArrayKlassObj_addr()           { return &_longArrayKlassObj;   }
 391   static Klass** singleArrayKlassObj_addr()         { return &_singleArrayKlassObj; }
 392   static Klass** doubleArrayKlassObj_addr()         { return &_doubleArrayKlassObj; }
 393   static Klass** objectArrayKlassObj_addr()         { return &_objectArrayKlassObj; }
 394 
 395   // The particular choice of collected heap.
 396   static CollectedHeap* heap() { return _collectedHeap; }
 397 
 398   // For UseCompressedOops
 399   // Narrow Oop encoding mode:
 400   // 0 - Use 32-bits oops without encoding when
 401   //     NarrowOopHeapBaseMin + heap_size < 4Gb
 402   // 1 - Use zero based compressed oops with encoding when
 403   //     NarrowOopHeapBaseMin + heap_size < 32Gb
 404   // 2 - Use compressed oops with disjoint heap base if
 405   //     base is 32G-aligned and base > 0. This allows certain
 406   //     optimizations in encoding/decoding.
 407   //     Disjoint: Bits used in base are disjoint from bits used
 408   //     for oops ==> oop = (cOop << 3) | base.  One can disjoint
 409   //     the bits of an oop into base and compressed oop.
 410   // 3 - Use compressed oops with heap base + encoding.
 411   enum NARROW_OOP_MODE {
 412     UnscaledNarrowOop  = 0,
 413     ZeroBasedNarrowOop = 1,
 414     DisjointBaseNarrowOop = 2,
 415     HeapBasedNarrowOop = 3,
 416     AnyNarrowOopMode = 4
 417   };
 418   static NARROW_OOP_MODE narrow_oop_mode();
 419   static const char* narrow_oop_mode_to_string(NARROW_OOP_MODE mode);
 420   static char*    preferred_heap_base(size_t heap_size, size_t alignment, NARROW_OOP_MODE mode);
 421   static char*    preferred_metaspace_base(size_t heap_size, NARROW_OOP_MODE mode);
 422   static address  narrow_oop_base()                  { return  _narrow_oop._base; }
 423   // Test whether bits of addr and possible offsets into the heap overlap.
 424   static bool     is_disjoint_heap_base_address(address addr) {
 425     return (((uint64_t)(intptr_t)addr) &
 426             (((uint64_t)UCONST64(0xFFFFffffFFFFffff)) >> (32-LogMinObjAlignmentInBytes))) == 0;
 427   }
 428   // Check for disjoint base compressed oops.
 429   static bool     narrow_oop_base_disjoint()        {
 430     return _narrow_oop._base != NULL && is_disjoint_heap_base_address(_narrow_oop._base);
 431   }
 432   // Check for real heapbased compressed oops.
 433   // We must subtract the base as the bits overlap.
 434   // If we negate above function, we also get unscaled and zerobased.
 435   static bool     narrow_oop_base_overlaps()          {
 436     return _narrow_oop._base != NULL && !is_disjoint_heap_base_address(_narrow_oop._base);
 437   }
 438   static bool  is_narrow_oop_base(void* addr)             { return (narrow_oop_base() == (address)addr); }
 439   static int      narrow_oop_shift()                      { return  _narrow_oop._shift; }
 440   static bool     narrow_oop_use_implicit_null_checks()   { return  _narrow_oop._use_implicit_null_checks; }
 441 
 442   // For UseCompressedClassPointers
 443   static address  narrow_klass_base()                     { return  _narrow_klass._base; }
 444   static bool  is_narrow_klass_base(void* addr)           { return (narrow_klass_base() == (address)addr); }
 445   static uint64_t narrow_klass_range()                    { return  _narrow_klass_range; }
 446   static int      narrow_klass_shift()                    { return  _narrow_klass._shift; }
 447   static bool     narrow_klass_use_implicit_null_checks() { return  _narrow_klass._use_implicit_null_checks; }
 448 
 449   static address* narrow_ptrs_base_addr()                 { return &_narrow_ptrs_base; }
 450   static void     set_narrow_ptrs_base(address a)         { _narrow_ptrs_base = a; }
 451   static address  narrow_ptrs_base()                      { return _narrow_ptrs_base; }
 452 
 453   static void     print_compressed_oops_mode(outputStream* st);
 454 
 455   // this is set in vm_version on sparc (and then reset in universe afaict)
 456   static void     set_narrow_oop_shift(int shift)         {
 457     _narrow_oop._shift   = shift;
 458   }
 459 
 460   static void     set_narrow_klass_shift(int shift)       {
 461     assert(shift == 0 || shift == LogKlassAlignmentInBytes, "invalid shift for klass ptrs");
 462     _narrow_klass._shift   = shift;
 463   }
 464 
 465   // Reserve Java heap and determine CompressedOops mode
 466   static ReservedSpace reserve_heap(size_t heap_size, size_t alignment);
 467 
 468   // Historic gc information
 469   static size_t get_heap_capacity_at_last_gc()         { return _heap_capacity_at_last_gc; }
 470   static size_t get_heap_free_at_last_gc()             { return _heap_capacity_at_last_gc - _heap_used_at_last_gc; }
 471   static size_t get_heap_used_at_last_gc()             { return _heap_used_at_last_gc; }
 472   static void update_heap_info_at_gc();
 473 
 474   // Testers
 475   static bool is_bootstrapping()                      { return _bootstrapping; }
 476   static bool is_module_initialized()                 { return _module_initialized; }
 477   static bool is_fully_initialized()                  { return _fully_initialized; }
 478 
 479   static bool        on_page_boundary(void* addr);
 480   static bool        should_fill_in_stack_trace(Handle throwable);
 481   static void check_alignment(uintx size, uintx alignment, const char* name);
 482 
 483   // Iteration
 484 
 485   // Apply "f" to the addresses of all the direct heap pointers maintained
 486   // as static fields of "Universe".
 487   static void oops_do(OopClosure* f, bool do_all = false);
 488 
 489   // CDS support
 490   static void serialize(SerializeClosure* f, bool do_all = false);
 491 
 492   // Apply "f" to all klasses for basic types (classes not present in
 493   // SystemDictionary).
 494   static void basic_type_classes_do(void f(Klass*));
 495   static void metaspace_pointers_do(MetaspaceClosure* it);
 496 
 497   // Debugging
 498   enum VERIFY_FLAGS {
 499     Verify_Threads = 1,
 500     Verify_Heap = 2,
 501     Verify_SymbolTable = 4,
 502     Verify_StringTable = 8,
 503     Verify_CodeCache = 16,
 504     Verify_SystemDictionary = 32,
 505     Verify_ClassLoaderDataGraph = 64,
 506     Verify_MetaspaceUtils = 128,
 507     Verify_JNIHandles = 256,
 508     Verify_CodeCacheOops = 512,
 509     Verify_All = -1
 510   };
 511   static void initialize_verify_flags();
 512   static bool should_verify_subset(uint subset);
 513   static bool verify_in_progress() { return _verify_in_progress; }
 514   static void verify(VerifyOption option, const char* prefix);
 515   static void verify(const char* prefix) {
 516     verify(VerifyOption_Default, prefix);
 517   }
 518   static void verify() {
 519     verify("");
 520   }
 521 
 522   static int  verify_count()       { return _verify_count; }
 523   static void print_on(outputStream* st);
 524   static void print_heap_at_SIGBREAK();
 525   static void print_heap_before_gc();
 526   static void print_heap_after_gc();
 527 
 528   // Change the number of dummy objects kept reachable by the full gc dummy
 529   // array; this should trigger relocation in a sliding compaction collector.
 530   debug_only(static bool release_fullgc_alot_dummy();)
 531   // The non-oop pattern (see compiledIC.hpp, etc)
 532   static void*   non_oop_word();
 533 
 534   // Oop verification (see MacroAssembler::verify_oop)
 535   static uintptr_t verify_oop_mask()          PRODUCT_RETURN0;
 536   static uintptr_t verify_oop_bits()          PRODUCT_RETURN0;
 537   static uintptr_t verify_mark_bits()         PRODUCT_RETURN0;
 538   static uintptr_t verify_mark_mask()         PRODUCT_RETURN0;
 539 
 540   // Compiler support
 541   static int base_vtable_size()               { return _base_vtable_size; }
 542 };
 543 
 544 class DeferredObjAllocEvent : public CHeapObj<mtInternal> {
 545   private:
 546     oop    _oop;
 547     size_t _bytesize;
 548     jint   _arena_id;
 549 
 550   public:
 551     DeferredObjAllocEvent(const oop o, const size_t s, const jint id) {
 552       _oop      = o;
 553       _bytesize = s;
 554       _arena_id = id;
 555     }
 556 
 557     ~DeferredObjAllocEvent() {
 558     }
 559 
 560     jint   arena_id() { return _arena_id; }
 561     size_t bytesize() { return _bytesize; }
 562     oop    get_oop()  { return _oop; }
 563 };
 564 
 565 #endif // SHARE_VM_MEMORY_UNIVERSE_HPP