src/share/vm/runtime/java.hpp

Wed, 07 Sep 2011 13:55:42 -0700

author
ysr
date
Wed, 07 Sep 2011 13:55:42 -0700
changeset 3117
eca1193ca245
parent 2497
3582bf76420e
child 3767
9d679effd28c
permissions
-rw-r--r--

4965777: GC changes to support use of discovered field for pending references
Summary: If and when the reference handler thread is able to use the discovered field to link reference objects in its pending list, so will GC. In that case, GC will scan through this field once a reference object has been placed on the pending list, but not scan that field before that stage, as the field is used by the concurrent GC thread to link discovered objects. When ReferenceHandleR thread does not use the discovered field for the purpose of linking the elements in the pending list, as would be the case in older JDKs, the JVM will fall back to the old behaviour of using the next field for that purpose.
Reviewed-by: jcoomes, mchung, stefank

duke@435 1 /*
kevinw@2449 2 * Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved.
duke@435 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
duke@435 4 *
duke@435 5 * This code is free software; you can redistribute it and/or modify it
duke@435 6 * under the terms of the GNU General Public License version 2 only, as
duke@435 7 * published by the Free Software Foundation.
duke@435 8 *
duke@435 9 * This code is distributed in the hope that it will be useful, but WITHOUT
duke@435 10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
duke@435 11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
duke@435 12 * version 2 for more details (a copy is included in the LICENSE file that
duke@435 13 * accompanied this code).
duke@435 14 *
duke@435 15 * You should have received a copy of the GNU General Public License version
duke@435 16 * 2 along with this work; if not, write to the Free Software Foundation,
duke@435 17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
duke@435 18 *
trims@1907 19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
trims@1907 20 * or visit www.oracle.com if you need additional information or have any
trims@1907 21 * questions.
duke@435 22 *
duke@435 23 */
duke@435 24
stefank@2314 25 #ifndef SHARE_VM_RUNTIME_JAVA_HPP
stefank@2314 26 #define SHARE_VM_RUNTIME_JAVA_HPP
stefank@2314 27
stefank@2314 28 #include "runtime/os.hpp"
stefank@2314 29
duke@435 30 // Register function to be called by before_exit
duke@435 31 extern "C" { void register_on_exit_function(void (*func)(void)) ;}
duke@435 32
duke@435 33 // Execute code before all handles are released and thread is killed; prologue to vm_exit
duke@435 34 extern void before_exit(JavaThread * thread);
duke@435 35
duke@435 36 // Forced VM exit (i.e, internal error or JVM_Exit)
duke@435 37 extern void vm_exit(int code);
duke@435 38
duke@435 39 // Wrapper for ::exit()
duke@435 40 extern void vm_direct_exit(int code);
duke@435 41
duke@435 42 // Shutdown the VM but do not exit the process
duke@435 43 extern void vm_shutdown();
duke@435 44 // Shutdown the VM and abort the process
poonam@662 45 extern void vm_abort(bool dump_core=true);
duke@435 46
duke@435 47 // Trigger any necessary notification of the VM being shutdown
duke@435 48 extern void notify_vm_shutdown();
duke@435 49
duke@435 50 // VM exit if error occurs during initialization of VM
duke@435 51 extern void vm_exit_during_initialization(Handle exception);
coleenp@2497 52 extern void vm_exit_during_initialization(Symbol* exception_name, const char* message);
duke@435 53 extern void vm_exit_during_initialization(const char* error, const char* message = NULL);
duke@435 54 extern void vm_shutdown_during_initialization(const char* error, const char* message = NULL);
duke@435 55
kamg@677 56 /**
kamg@677 57 * Discovering the JDK_Version during initialization is tricky when the
kamg@677 58 * running JDK is less than JDK6. For JDK6 and greater, a "GetVersion"
kamg@677 59 * function exists in libjava.so and we simply call it during the
kamg@677 60 * 'initialize()' call to find the version. For JDKs with version < 6, no
kamg@677 61 * such call exists and we have to probe the JDK in order to determine
kamg@677 62 * the exact version. This probing cannot happen during late in
kamg@677 63 * the VM initialization process so there's a period of time during
kamg@677 64 * initialization when we don't know anything about the JDK version other than
kamg@677 65 * that it less than version 6. This is the "partially initialized" time,
kamg@677 66 * when we can answer only certain version queries (such as, is the JDK
kamg@677 67 * version greater than 5? Answer: no). Once the JDK probing occurs, we
kamg@677 68 * know the version and are considered fully initialized.
kamg@677 69 */
kamg@677 70 class JDK_Version VALUE_OBJ_CLASS_SPEC {
duke@435 71 friend class VMStructs;
kamg@677 72 friend class Universe;
kamg@677 73 friend void JDK_Version_init();
duke@435 74 private:
kamg@677 75
kamg@677 76 static JDK_Version _current;
kamg@677 77
kamg@677 78 // In this class, we promote the minor version of release to be the
kamg@677 79 // major version for releases >= 5 in anticipation of the JDK doing the
kamg@677 80 // same thing. For example, we represent "1.5.0" as major version 5 (we
kamg@677 81 // drop the leading 1 and use 5 as the 'major').
kamg@677 82
kamg@677 83 uint8_t _major;
kamg@677 84 uint8_t _minor;
kamg@677 85 uint8_t _micro;
kamg@677 86 uint8_t _update;
kamg@677 87 uint8_t _special;
kamg@677 88 uint8_t _build;
kamg@677 89
kamg@677 90 // If partially initialized, the above fields are invalid and we know
kamg@677 91 // that we're less than major version 6.
kamg@677 92 bool _partially_initialized;
kamg@677 93
kamg@677 94 bool _thread_park_blocker;
ysr@3117 95 bool _pending_list_uses_discovered_field;
kevinw@2449 96 bool _post_vm_init_hook_enabled;
kamg@677 97
kamg@677 98 bool is_valid() const {
kamg@677 99 return (_major != 0 || _partially_initialized);
kamg@677 100 }
kamg@677 101
kamg@677 102 // initializes or partially initializes the _current static field
kamg@677 103 static void initialize();
kamg@677 104
kamg@677 105 // Completes initialization for a pre-JDK6 version.
kamg@677 106 static void fully_initialize(uint8_t major, uint8_t minor = 0,
kamg@677 107 uint8_t micro = 0, uint8_t update = 0);
duke@435 108
duke@435 109 public:
duke@435 110
kamg@677 111 // Returns true if the the current version has only been partially initialized
kamg@677 112 static bool is_partially_initialized() {
kamg@677 113 return _current._partially_initialized;
kamg@677 114 }
kamg@611 115
kamg@677 116 JDK_Version() : _major(0), _minor(0), _micro(0), _update(0),
kamg@677 117 _special(0), _build(0), _partially_initialized(false),
ysr@3117 118 _thread_park_blocker(false), _post_vm_init_hook_enabled(false),
ysr@3117 119 _pending_list_uses_discovered_field(false) {}
kamg@677 120
kamg@677 121 JDK_Version(uint8_t major, uint8_t minor = 0, uint8_t micro = 0,
kamg@677 122 uint8_t update = 0, uint8_t special = 0, uint8_t build = 0,
ysr@3117 123 bool thread_park_blocker = false, bool post_vm_init_hook_enabled = false,
ysr@3117 124 bool pending_list_uses_discovered_field = false) :
kamg@677 125 _major(major), _minor(minor), _micro(micro), _update(update),
kamg@677 126 _special(special), _build(build), _partially_initialized(false),
kevinw@2449 127 _thread_park_blocker(thread_park_blocker),
ysr@3117 128 _post_vm_init_hook_enabled(post_vm_init_hook_enabled),
ysr@3117 129 _pending_list_uses_discovered_field(pending_list_uses_discovered_field) {}
kamg@677 130
kamg@677 131 // Returns the current running JDK version
kamg@677 132 static JDK_Version current() { return _current; }
kamg@677 133
kamg@677 134 // Factory methods for convenience
kamg@677 135 static JDK_Version jdk(uint8_t m) {
kamg@677 136 return JDK_Version(m);
kamg@677 137 }
kamg@677 138
kamg@677 139 static JDK_Version jdk_update(uint8_t major, uint8_t update_number) {
kamg@677 140 return JDK_Version(major, 0, 0, update_number);
kamg@677 141 }
kamg@677 142
kamg@677 143 uint8_t major_version() const { return _major; }
kamg@677 144 uint8_t minor_version() const { return _minor; }
kamg@677 145 uint8_t micro_version() const { return _micro; }
kamg@677 146 uint8_t update_version() const { return _update; }
kamg@677 147 uint8_t special_update_version() const { return _special; }
kamg@677 148 uint8_t build_number() const { return _build; }
kamg@677 149
kamg@677 150 bool supports_thread_park_blocker() const {
kamg@677 151 return _thread_park_blocker;
kamg@677 152 }
kevinw@2449 153 bool post_vm_init_hook_enabled() const {
kevinw@2449 154 return _post_vm_init_hook_enabled;
kevinw@2449 155 }
ysr@3117 156 // For compatibility wrt pre-4965777 JDK's
ysr@3117 157 bool pending_list_uses_discovered_field() const {
ysr@3117 158 return _pending_list_uses_discovered_field;
ysr@3117 159 }
kamg@677 160
kamg@677 161 // Performs a full ordering comparison using all fields (update, build, etc.)
kamg@677 162 int compare(const JDK_Version& other) const;
kamg@677 163
kamg@677 164 /**
kamg@677 165 * Performs comparison using only the major version, returning negative
kamg@677 166 * if the major version of 'this' is less than the parameter, 0 if it is
kamg@677 167 * equal, and a positive value if it is greater.
kamg@677 168 */
kamg@677 169 int compare_major(int version) const {
kamg@677 170 if (_partially_initialized) {
kamg@677 171 if (version >= 6) {
kamg@677 172 return -1;
kamg@677 173 } else {
kamg@677 174 assert(false, "Can't make this comparison during init time");
kamg@677 175 return -1; // conservative
kamg@677 176 }
kamg@611 177 } else {
kamg@677 178 return major_version() - version;
kamg@611 179 }
kamg@611 180 }
kamg@611 181
kamg@677 182 void to_string(char* buffer, size_t buflen) const;
kamg@677 183
kamg@677 184 // Convenience methods for queries on the current major/minor version
kamg@677 185 static bool is_jdk12x_version() {
kamg@677 186 return current().compare_major(2) == 0;
kamg@611 187 }
duke@435 188
kamg@677 189 static bool is_jdk13x_version() {
kamg@677 190 return current().compare_major(3) == 0;
kamg@677 191 }
kamg@677 192
kamg@677 193 static bool is_jdk14x_version() {
kamg@677 194 return current().compare_major(4) == 0;
kamg@677 195 }
kamg@677 196
kamg@677 197 static bool is_jdk15x_version() {
kamg@677 198 return current().compare_major(5) == 0;
kamg@677 199 }
kamg@677 200
kamg@677 201 static bool is_jdk16x_version() {
kamg@677 202 return current().compare_major(6) == 0;
kamg@677 203 }
kamg@677 204
kamg@677 205 static bool is_jdk17x_version() {
kamg@677 206 return current().compare_major(7) == 0;
kamg@677 207 }
kamg@677 208
kamg@677 209 static bool is_gte_jdk13x_version() {
kamg@677 210 return current().compare_major(3) >= 0;
kamg@677 211 }
duke@435 212
duke@435 213 static bool is_gte_jdk14x_version() {
kamg@677 214 return current().compare_major(4) >= 0;
duke@435 215 }
kamg@677 216
duke@435 217 static bool is_gte_jdk15x_version() {
kamg@677 218 return current().compare_major(5) >= 0;
duke@435 219 }
kamg@677 220
duke@435 221 static bool is_gte_jdk16x_version() {
kamg@677 222 return current().compare_major(6) >= 0;
duke@435 223 }
duke@435 224
duke@435 225 static bool is_gte_jdk17x_version() {
kamg@677 226 return current().compare_major(7) >= 0;
duke@435 227 }
duke@435 228 };
stefank@2314 229
stefank@2314 230 #endif // SHARE_VM_RUNTIME_JAVA_HPP

mercurial