Fri, 03 May 2013 05:05:31 -0700
8004095: Add support for JMX interface to Diagnostic Framework and Commands
Reviewed-by: acorn, sla
1 /*
2 * Copyright (c) 2003, 2013, 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 */
25 #include "precompiled.hpp"
26 #include "classfile/systemDictionary.hpp"
27 #include "compiler/compileBroker.hpp"
28 #include "memory/iterator.hpp"
29 #include "memory/oopFactory.hpp"
30 #include "memory/resourceArea.hpp"
31 #include "oops/klass.hpp"
32 #include "oops/objArrayKlass.hpp"
33 #include "oops/oop.inline.hpp"
34 #include "runtime/arguments.hpp"
35 #include "runtime/globals.hpp"
36 #include "runtime/handles.inline.hpp"
37 #include "runtime/interfaceSupport.hpp"
38 #include "runtime/javaCalls.hpp"
39 #include "runtime/jniHandles.hpp"
40 #include "runtime/os.hpp"
41 #include "runtime/serviceThread.hpp"
42 #include "services/classLoadingService.hpp"
43 #include "services/diagnosticCommand.hpp"
44 #include "services/diagnosticFramework.hpp"
45 #include "services/heapDumper.hpp"
46 #include "services/jmm.h"
47 #include "services/lowMemoryDetector.hpp"
48 #include "services/gcNotifier.hpp"
49 #include "services/nmtDCmd.hpp"
50 #include "services/management.hpp"
51 #include "services/memoryManager.hpp"
52 #include "services/memoryPool.hpp"
53 #include "services/memoryService.hpp"
54 #include "services/runtimeService.hpp"
55 #include "services/threadService.hpp"
56 #include "utilities/macros.hpp"
58 PerfVariable* Management::_begin_vm_creation_time = NULL;
59 PerfVariable* Management::_end_vm_creation_time = NULL;
60 PerfVariable* Management::_vm_init_done_time = NULL;
62 Klass* Management::_sensor_klass = NULL;
63 Klass* Management::_threadInfo_klass = NULL;
64 Klass* Management::_memoryUsage_klass = NULL;
65 Klass* Management::_memoryPoolMXBean_klass = NULL;
66 Klass* Management::_memoryManagerMXBean_klass = NULL;
67 Klass* Management::_garbageCollectorMXBean_klass = NULL;
68 Klass* Management::_managementFactory_klass = NULL;
69 Klass* Management::_garbageCollectorImpl_klass = NULL;
70 Klass* Management::_gcInfo_klass = NULL;
71 Klass* Management::_diagnosticCommandImpl_klass = NULL;
72 Klass* Management::_managementFactoryHelper_klass = NULL;
75 jmmOptionalSupport Management::_optional_support = {0};
76 TimeStamp Management::_stamp;
78 void management_init() {
79 #if INCLUDE_MANAGEMENT
80 Management::init();
81 ThreadService::init();
82 RuntimeService::init();
83 ClassLoadingService::init();
84 #else
85 ThreadService::init();
86 // Make sure the VM version is initialized
87 // This is normally called by RuntimeService::init().
88 // Since that is conditionalized out, we need to call it here.
89 Abstract_VM_Version::initialize();
90 #endif // INCLUDE_MANAGEMENT
91 }
93 #if INCLUDE_MANAGEMENT
95 void Management::init() {
96 EXCEPTION_MARK;
98 // These counters are for java.lang.management API support.
99 // They are created even if -XX:-UsePerfData is set and in
100 // that case, they will be allocated on C heap.
102 _begin_vm_creation_time =
103 PerfDataManager::create_variable(SUN_RT, "createVmBeginTime",
104 PerfData::U_None, CHECK);
106 _end_vm_creation_time =
107 PerfDataManager::create_variable(SUN_RT, "createVmEndTime",
108 PerfData::U_None, CHECK);
110 _vm_init_done_time =
111 PerfDataManager::create_variable(SUN_RT, "vmInitDoneTime",
112 PerfData::U_None, CHECK);
114 // Initialize optional support
115 _optional_support.isLowMemoryDetectionSupported = 1;
116 _optional_support.isCompilationTimeMonitoringSupported = 1;
117 _optional_support.isThreadContentionMonitoringSupported = 1;
119 if (os::is_thread_cpu_time_supported()) {
120 _optional_support.isCurrentThreadCpuTimeSupported = 1;
121 _optional_support.isOtherThreadCpuTimeSupported = 1;
122 } else {
123 _optional_support.isCurrentThreadCpuTimeSupported = 0;
124 _optional_support.isOtherThreadCpuTimeSupported = 0;
125 }
127 _optional_support.isBootClassPathSupported = 1;
128 _optional_support.isObjectMonitorUsageSupported = 1;
129 #if INCLUDE_SERVICES
130 // This depends on the heap inspector
131 _optional_support.isSynchronizerUsageSupported = 1;
132 #endif // INCLUDE_SERVICES
133 _optional_support.isThreadAllocatedMemorySupported = 1;
134 _optional_support.isRemoteDiagnosticCommandsSupported = 1;
136 // Registration of the diagnostic commands
137 DCmdRegistrant::register_dcmds();
138 DCmdRegistrant::register_dcmds_ext();
139 uint32_t full_export = DCmd_Source_Internal | DCmd_Source_AttachAPI
140 | DCmd_Source_MBean;
141 DCmdFactory::register_DCmdFactory(new DCmdFactoryImpl<NMTDCmd>(full_export, true, false));
142 }
144 void Management::initialize(TRAPS) {
145 // Start the service thread
146 ServiceThread::initialize();
148 if (ManagementServer) {
149 ResourceMark rm(THREAD);
150 HandleMark hm(THREAD);
152 // Load and initialize the sun.management.Agent class
153 // invoke startAgent method to start the management server
154 Handle loader = Handle(THREAD, SystemDictionary::java_system_loader());
155 Klass* k = SystemDictionary::resolve_or_fail(vmSymbols::sun_management_Agent(),
156 loader,
157 Handle(),
158 true,
159 CHECK);
160 instanceKlassHandle ik (THREAD, k);
162 JavaValue result(T_VOID);
163 JavaCalls::call_static(&result,
164 ik,
165 vmSymbols::startAgent_name(),
166 vmSymbols::void_method_signature(),
167 CHECK);
168 }
169 }
171 void Management::get_optional_support(jmmOptionalSupport* support) {
172 memcpy(support, &_optional_support, sizeof(jmmOptionalSupport));
173 }
175 Klass* Management::load_and_initialize_klass(Symbol* sh, TRAPS) {
176 Klass* k = SystemDictionary::resolve_or_fail(sh, true, CHECK_NULL);
177 instanceKlassHandle ik (THREAD, k);
178 if (ik->should_be_initialized()) {
179 ik->initialize(CHECK_NULL);
180 }
181 // If these classes change to not be owned by the boot loader, they need
182 // to be walked to keep their class loader alive in oops_do.
183 assert(ik->class_loader() == NULL, "need to follow in oops_do");
184 return ik();
185 }
187 void Management::record_vm_startup_time(jlong begin, jlong duration) {
188 // if the performance counter is not initialized,
189 // then vm initialization failed; simply return.
190 if (_begin_vm_creation_time == NULL) return;
192 _begin_vm_creation_time->set_value(begin);
193 _end_vm_creation_time->set_value(begin + duration);
194 PerfMemory::set_accessible(true);
195 }
197 jlong Management::timestamp() {
198 TimeStamp t;
199 t.update();
200 return t.ticks() - _stamp.ticks();
201 }
203 void Management::oops_do(OopClosure* f) {
204 MemoryService::oops_do(f);
205 ThreadService::oops_do(f);
206 }
208 Klass* Management::java_lang_management_ThreadInfo_klass(TRAPS) {
209 if (_threadInfo_klass == NULL) {
210 _threadInfo_klass = load_and_initialize_klass(vmSymbols::java_lang_management_ThreadInfo(), CHECK_NULL);
211 }
212 return _threadInfo_klass;
213 }
215 Klass* Management::java_lang_management_MemoryUsage_klass(TRAPS) {
216 if (_memoryUsage_klass == NULL) {
217 _memoryUsage_klass = load_and_initialize_klass(vmSymbols::java_lang_management_MemoryUsage(), CHECK_NULL);
218 }
219 return _memoryUsage_klass;
220 }
222 Klass* Management::java_lang_management_MemoryPoolMXBean_klass(TRAPS) {
223 if (_memoryPoolMXBean_klass == NULL) {
224 _memoryPoolMXBean_klass = load_and_initialize_klass(vmSymbols::java_lang_management_MemoryPoolMXBean(), CHECK_NULL);
225 }
226 return _memoryPoolMXBean_klass;
227 }
229 Klass* Management::java_lang_management_MemoryManagerMXBean_klass(TRAPS) {
230 if (_memoryManagerMXBean_klass == NULL) {
231 _memoryManagerMXBean_klass = load_and_initialize_klass(vmSymbols::java_lang_management_MemoryManagerMXBean(), CHECK_NULL);
232 }
233 return _memoryManagerMXBean_klass;
234 }
236 Klass* Management::java_lang_management_GarbageCollectorMXBean_klass(TRAPS) {
237 if (_garbageCollectorMXBean_klass == NULL) {
238 _garbageCollectorMXBean_klass = load_and_initialize_klass(vmSymbols::java_lang_management_GarbageCollectorMXBean(), CHECK_NULL);
239 }
240 return _garbageCollectorMXBean_klass;
241 }
243 Klass* Management::sun_management_Sensor_klass(TRAPS) {
244 if (_sensor_klass == NULL) {
245 _sensor_klass = load_and_initialize_klass(vmSymbols::sun_management_Sensor(), CHECK_NULL);
246 }
247 return _sensor_klass;
248 }
250 Klass* Management::sun_management_ManagementFactory_klass(TRAPS) {
251 if (_managementFactory_klass == NULL) {
252 _managementFactory_klass = load_and_initialize_klass(vmSymbols::sun_management_ManagementFactory(), CHECK_NULL);
253 }
254 return _managementFactory_klass;
255 }
257 Klass* Management::sun_management_GarbageCollectorImpl_klass(TRAPS) {
258 if (_garbageCollectorImpl_klass == NULL) {
259 _garbageCollectorImpl_klass = load_and_initialize_klass(vmSymbols::sun_management_GarbageCollectorImpl(), CHECK_NULL);
260 }
261 return _garbageCollectorImpl_klass;
262 }
264 Klass* Management::com_sun_management_GcInfo_klass(TRAPS) {
265 if (_gcInfo_klass == NULL) {
266 _gcInfo_klass = load_and_initialize_klass(vmSymbols::com_sun_management_GcInfo(), CHECK_NULL);
267 }
268 return _gcInfo_klass;
269 }
271 Klass* Management::sun_management_DiagnosticCommandImpl_klass(TRAPS) {
272 if (_diagnosticCommandImpl_klass == NULL) {
273 _diagnosticCommandImpl_klass = load_and_initialize_klass(vmSymbols::sun_management_DiagnosticCommandImpl(), CHECK_NULL);
274 }
275 return _diagnosticCommandImpl_klass;
276 }
278 Klass* Management::sun_management_ManagementFactoryHelper_klass(TRAPS) {
279 if (_managementFactoryHelper_klass == NULL) {
280 _managementFactoryHelper_klass = load_and_initialize_klass(vmSymbols::sun_management_ManagementFactoryHelper(), CHECK_NULL);
281 }
282 return _managementFactoryHelper_klass;
283 }
285 static void initialize_ThreadInfo_constructor_arguments(JavaCallArguments* args, ThreadSnapshot* snapshot, TRAPS) {
286 Handle snapshot_thread(THREAD, snapshot->threadObj());
288 jlong contended_time;
289 jlong waited_time;
290 if (ThreadService::is_thread_monitoring_contention()) {
291 contended_time = Management::ticks_to_ms(snapshot->contended_enter_ticks());
292 waited_time = Management::ticks_to_ms(snapshot->monitor_wait_ticks() + snapshot->sleep_ticks());
293 } else {
294 // set them to -1 if thread contention monitoring is disabled.
295 contended_time = max_julong;
296 waited_time = max_julong;
297 }
299 int thread_status = snapshot->thread_status();
300 assert((thread_status & JMM_THREAD_STATE_FLAG_MASK) == 0, "Flags already set in thread_status in Thread object");
301 if (snapshot->is_ext_suspended()) {
302 thread_status |= JMM_THREAD_STATE_FLAG_SUSPENDED;
303 }
304 if (snapshot->is_in_native()) {
305 thread_status |= JMM_THREAD_STATE_FLAG_NATIVE;
306 }
308 ThreadStackTrace* st = snapshot->get_stack_trace();
309 Handle stacktrace_h;
310 if (st != NULL) {
311 stacktrace_h = st->allocate_fill_stack_trace_element_array(CHECK);
312 } else {
313 stacktrace_h = Handle();
314 }
316 args->push_oop(snapshot_thread);
317 args->push_int(thread_status);
318 args->push_oop(Handle(THREAD, snapshot->blocker_object()));
319 args->push_oop(Handle(THREAD, snapshot->blocker_object_owner()));
320 args->push_long(snapshot->contended_enter_count());
321 args->push_long(contended_time);
322 args->push_long(snapshot->monitor_wait_count() + snapshot->sleep_count());
323 args->push_long(waited_time);
324 args->push_oop(stacktrace_h);
325 }
327 // Helper function to construct a ThreadInfo object
328 instanceOop Management::create_thread_info_instance(ThreadSnapshot* snapshot, TRAPS) {
329 Klass* k = Management::java_lang_management_ThreadInfo_klass(CHECK_NULL);
330 instanceKlassHandle ik (THREAD, k);
332 JavaValue result(T_VOID);
333 JavaCallArguments args(14);
335 // First allocate a ThreadObj object and
336 // push the receiver as the first argument
337 Handle element = ik->allocate_instance_handle(CHECK_NULL);
338 args.push_oop(element);
340 // initialize the arguments for the ThreadInfo constructor
341 initialize_ThreadInfo_constructor_arguments(&args, snapshot, CHECK_NULL);
343 // Call ThreadInfo constructor with no locked monitors and synchronizers
344 JavaCalls::call_special(&result,
345 ik,
346 vmSymbols::object_initializer_name(),
347 vmSymbols::java_lang_management_ThreadInfo_constructor_signature(),
348 &args,
349 CHECK_NULL);
351 return (instanceOop) element();
352 }
354 instanceOop Management::create_thread_info_instance(ThreadSnapshot* snapshot,
355 objArrayHandle monitors_array,
356 typeArrayHandle depths_array,
357 objArrayHandle synchronizers_array,
358 TRAPS) {
359 Klass* k = Management::java_lang_management_ThreadInfo_klass(CHECK_NULL);
360 instanceKlassHandle ik (THREAD, k);
362 JavaValue result(T_VOID);
363 JavaCallArguments args(17);
365 // First allocate a ThreadObj object and
366 // push the receiver as the first argument
367 Handle element = ik->allocate_instance_handle(CHECK_NULL);
368 args.push_oop(element);
370 // initialize the arguments for the ThreadInfo constructor
371 initialize_ThreadInfo_constructor_arguments(&args, snapshot, CHECK_NULL);
373 // push the locked monitors and synchronizers in the arguments
374 args.push_oop(monitors_array);
375 args.push_oop(depths_array);
376 args.push_oop(synchronizers_array);
378 // Call ThreadInfo constructor with locked monitors and synchronizers
379 JavaCalls::call_special(&result,
380 ik,
381 vmSymbols::object_initializer_name(),
382 vmSymbols::java_lang_management_ThreadInfo_with_locks_constructor_signature(),
383 &args,
384 CHECK_NULL);
386 return (instanceOop) element();
387 }
389 // Helper functions
390 static JavaThread* find_java_thread_from_id(jlong thread_id) {
391 assert(Threads_lock->owned_by_self(), "Must hold Threads_lock");
393 JavaThread* java_thread = NULL;
394 // Sequential search for now. Need to do better optimization later.
395 for (JavaThread* thread = Threads::first(); thread != NULL; thread = thread->next()) {
396 oop tobj = thread->threadObj();
397 if (!thread->is_exiting() &&
398 tobj != NULL &&
399 thread_id == java_lang_Thread::thread_id(tobj)) {
400 java_thread = thread;
401 break;
402 }
403 }
404 return java_thread;
405 }
407 static GCMemoryManager* get_gc_memory_manager_from_jobject(jobject mgr, TRAPS) {
408 if (mgr == NULL) {
409 THROW_(vmSymbols::java_lang_NullPointerException(), NULL);
410 }
411 oop mgr_obj = JNIHandles::resolve(mgr);
412 instanceHandle h(THREAD, (instanceOop) mgr_obj);
414 Klass* k = Management::java_lang_management_GarbageCollectorMXBean_klass(CHECK_NULL);
415 if (!h->is_a(k)) {
416 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
417 "the object is not an instance of java.lang.management.GarbageCollectorMXBean class",
418 NULL);
419 }
421 MemoryManager* gc = MemoryService::get_memory_manager(h);
422 if (gc == NULL || !gc->is_gc_memory_manager()) {
423 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
424 "Invalid GC memory manager",
425 NULL);
426 }
427 return (GCMemoryManager*) gc;
428 }
430 static MemoryPool* get_memory_pool_from_jobject(jobject obj, TRAPS) {
431 if (obj == NULL) {
432 THROW_(vmSymbols::java_lang_NullPointerException(), NULL);
433 }
435 oop pool_obj = JNIHandles::resolve(obj);
436 assert(pool_obj->is_instance(), "Should be an instanceOop");
437 instanceHandle ph(THREAD, (instanceOop) pool_obj);
439 return MemoryService::get_memory_pool(ph);
440 }
442 static void validate_thread_id_array(typeArrayHandle ids_ah, TRAPS) {
443 int num_threads = ids_ah->length();
445 // Validate input thread IDs
446 int i = 0;
447 for (i = 0; i < num_threads; i++) {
448 jlong tid = ids_ah->long_at(i);
449 if (tid <= 0) {
450 // throw exception if invalid thread id.
451 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
452 "Invalid thread ID entry");
453 }
454 }
455 }
457 static void validate_thread_info_array(objArrayHandle infoArray_h, TRAPS) {
458 // check if the element of infoArray is of type ThreadInfo class
459 Klass* threadinfo_klass = Management::java_lang_management_ThreadInfo_klass(CHECK);
460 Klass* element_klass = ObjArrayKlass::cast(infoArray_h->klass())->element_klass();
461 if (element_klass != threadinfo_klass) {
462 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
463 "infoArray element type is not ThreadInfo class");
464 }
465 }
468 static MemoryManager* get_memory_manager_from_jobject(jobject obj, TRAPS) {
469 if (obj == NULL) {
470 THROW_(vmSymbols::java_lang_NullPointerException(), NULL);
471 }
473 oop mgr_obj = JNIHandles::resolve(obj);
474 assert(mgr_obj->is_instance(), "Should be an instanceOop");
475 instanceHandle mh(THREAD, (instanceOop) mgr_obj);
477 return MemoryService::get_memory_manager(mh);
478 }
480 // Returns a version string and sets major and minor version if
481 // the input parameters are non-null.
482 JVM_LEAF(jint, jmm_GetVersion(JNIEnv *env))
483 return JMM_VERSION;
484 JVM_END
486 // Gets the list of VM monitoring and management optional supports
487 // Returns 0 if succeeded; otherwise returns non-zero.
488 JVM_LEAF(jint, jmm_GetOptionalSupport(JNIEnv *env, jmmOptionalSupport* support))
489 if (support == NULL) {
490 return -1;
491 }
492 Management::get_optional_support(support);
493 return 0;
494 JVM_END
496 // Returns a java.lang.String object containing the input arguments to the VM.
497 JVM_ENTRY(jobject, jmm_GetInputArguments(JNIEnv *env))
498 ResourceMark rm(THREAD);
500 if (Arguments::num_jvm_args() == 0 && Arguments::num_jvm_flags() == 0) {
501 return NULL;
502 }
504 char** vm_flags = Arguments::jvm_flags_array();
505 char** vm_args = Arguments::jvm_args_array();
506 int num_flags = Arguments::num_jvm_flags();
507 int num_args = Arguments::num_jvm_args();
509 size_t length = 1; // null terminator
510 int i;
511 for (i = 0; i < num_flags; i++) {
512 length += strlen(vm_flags[i]);
513 }
514 for (i = 0; i < num_args; i++) {
515 length += strlen(vm_args[i]);
516 }
517 // add a space between each argument
518 length += num_flags + num_args - 1;
520 // Return the list of input arguments passed to the VM
521 // and preserve the order that the VM processes.
522 char* args = NEW_RESOURCE_ARRAY(char, length);
523 args[0] = '\0';
524 // concatenate all jvm_flags
525 if (num_flags > 0) {
526 strcat(args, vm_flags[0]);
527 for (i = 1; i < num_flags; i++) {
528 strcat(args, " ");
529 strcat(args, vm_flags[i]);
530 }
531 }
533 if (num_args > 0 && num_flags > 0) {
534 // append a space if args already contains one or more jvm_flags
535 strcat(args, " ");
536 }
538 // concatenate all jvm_args
539 if (num_args > 0) {
540 strcat(args, vm_args[0]);
541 for (i = 1; i < num_args; i++) {
542 strcat(args, " ");
543 strcat(args, vm_args[i]);
544 }
545 }
547 Handle hargs = java_lang_String::create_from_platform_dependent_str(args, CHECK_NULL);
548 return JNIHandles::make_local(env, hargs());
549 JVM_END
551 // Returns an array of java.lang.String object containing the input arguments to the VM.
552 JVM_ENTRY(jobjectArray, jmm_GetInputArgumentArray(JNIEnv *env))
553 ResourceMark rm(THREAD);
555 if (Arguments::num_jvm_args() == 0 && Arguments::num_jvm_flags() == 0) {
556 return NULL;
557 }
559 char** vm_flags = Arguments::jvm_flags_array();
560 char** vm_args = Arguments::jvm_args_array();
561 int num_flags = Arguments::num_jvm_flags();
562 int num_args = Arguments::num_jvm_args();
564 instanceKlassHandle ik (THREAD, SystemDictionary::String_klass());
565 objArrayOop r = oopFactory::new_objArray(ik(), num_args + num_flags, CHECK_NULL);
566 objArrayHandle result_h(THREAD, r);
568 int index = 0;
569 for (int j = 0; j < num_flags; j++, index++) {
570 Handle h = java_lang_String::create_from_platform_dependent_str(vm_flags[j], CHECK_NULL);
571 result_h->obj_at_put(index, h());
572 }
573 for (int i = 0; i < num_args; i++, index++) {
574 Handle h = java_lang_String::create_from_platform_dependent_str(vm_args[i], CHECK_NULL);
575 result_h->obj_at_put(index, h());
576 }
577 return (jobjectArray) JNIHandles::make_local(env, result_h());
578 JVM_END
580 // Returns an array of java/lang/management/MemoryPoolMXBean object
581 // one for each memory pool if obj == null; otherwise returns
582 // an array of memory pools for a given memory manager if
583 // it is a valid memory manager.
584 JVM_ENTRY(jobjectArray, jmm_GetMemoryPools(JNIEnv* env, jobject obj))
585 ResourceMark rm(THREAD);
587 int num_memory_pools;
588 MemoryManager* mgr = NULL;
589 if (obj == NULL) {
590 num_memory_pools = MemoryService::num_memory_pools();
591 } else {
592 mgr = get_memory_manager_from_jobject(obj, CHECK_NULL);
593 if (mgr == NULL) {
594 return NULL;
595 }
596 num_memory_pools = mgr->num_memory_pools();
597 }
599 // Allocate the resulting MemoryPoolMXBean[] object
600 Klass* k = Management::java_lang_management_MemoryPoolMXBean_klass(CHECK_NULL);
601 instanceKlassHandle ik (THREAD, k);
602 objArrayOop r = oopFactory::new_objArray(ik(), num_memory_pools, CHECK_NULL);
603 objArrayHandle poolArray(THREAD, r);
605 if (mgr == NULL) {
606 // Get all memory pools
607 for (int i = 0; i < num_memory_pools; i++) {
608 MemoryPool* pool = MemoryService::get_memory_pool(i);
609 instanceOop p = pool->get_memory_pool_instance(CHECK_NULL);
610 instanceHandle ph(THREAD, p);
611 poolArray->obj_at_put(i, ph());
612 }
613 } else {
614 // Get memory pools managed by a given memory manager
615 for (int i = 0; i < num_memory_pools; i++) {
616 MemoryPool* pool = mgr->get_memory_pool(i);
617 instanceOop p = pool->get_memory_pool_instance(CHECK_NULL);
618 instanceHandle ph(THREAD, p);
619 poolArray->obj_at_put(i, ph());
620 }
621 }
622 return (jobjectArray) JNIHandles::make_local(env, poolArray());
623 JVM_END
625 // Returns an array of java/lang/management/MemoryManagerMXBean object
626 // one for each memory manager if obj == null; otherwise returns
627 // an array of memory managers for a given memory pool if
628 // it is a valid memory pool.
629 JVM_ENTRY(jobjectArray, jmm_GetMemoryManagers(JNIEnv* env, jobject obj))
630 ResourceMark rm(THREAD);
632 int num_mgrs;
633 MemoryPool* pool = NULL;
634 if (obj == NULL) {
635 num_mgrs = MemoryService::num_memory_managers();
636 } else {
637 pool = get_memory_pool_from_jobject(obj, CHECK_NULL);
638 if (pool == NULL) {
639 return NULL;
640 }
641 num_mgrs = pool->num_memory_managers();
642 }
644 // Allocate the resulting MemoryManagerMXBean[] object
645 Klass* k = Management::java_lang_management_MemoryManagerMXBean_klass(CHECK_NULL);
646 instanceKlassHandle ik (THREAD, k);
647 objArrayOop r = oopFactory::new_objArray(ik(), num_mgrs, CHECK_NULL);
648 objArrayHandle mgrArray(THREAD, r);
650 if (pool == NULL) {
651 // Get all memory managers
652 for (int i = 0; i < num_mgrs; i++) {
653 MemoryManager* mgr = MemoryService::get_memory_manager(i);
654 instanceOop p = mgr->get_memory_manager_instance(CHECK_NULL);
655 instanceHandle ph(THREAD, p);
656 mgrArray->obj_at_put(i, ph());
657 }
658 } else {
659 // Get memory managers for a given memory pool
660 for (int i = 0; i < num_mgrs; i++) {
661 MemoryManager* mgr = pool->get_memory_manager(i);
662 instanceOop p = mgr->get_memory_manager_instance(CHECK_NULL);
663 instanceHandle ph(THREAD, p);
664 mgrArray->obj_at_put(i, ph());
665 }
666 }
667 return (jobjectArray) JNIHandles::make_local(env, mgrArray());
668 JVM_END
671 // Returns a java/lang/management/MemoryUsage object containing the memory usage
672 // of a given memory pool.
673 JVM_ENTRY(jobject, jmm_GetMemoryPoolUsage(JNIEnv* env, jobject obj))
674 ResourceMark rm(THREAD);
676 MemoryPool* pool = get_memory_pool_from_jobject(obj, CHECK_NULL);
677 if (pool != NULL) {
678 MemoryUsage usage = pool->get_memory_usage();
679 Handle h = MemoryService::create_MemoryUsage_obj(usage, CHECK_NULL);
680 return JNIHandles::make_local(env, h());
681 } else {
682 return NULL;
683 }
684 JVM_END
686 // Returns a java/lang/management/MemoryUsage object containing the memory usage
687 // of a given memory pool.
688 JVM_ENTRY(jobject, jmm_GetPeakMemoryPoolUsage(JNIEnv* env, jobject obj))
689 ResourceMark rm(THREAD);
691 MemoryPool* pool = get_memory_pool_from_jobject(obj, CHECK_NULL);
692 if (pool != NULL) {
693 MemoryUsage usage = pool->get_peak_memory_usage();
694 Handle h = MemoryService::create_MemoryUsage_obj(usage, CHECK_NULL);
695 return JNIHandles::make_local(env, h());
696 } else {
697 return NULL;
698 }
699 JVM_END
701 // Returns a java/lang/management/MemoryUsage object containing the memory usage
702 // of a given memory pool after most recent GC.
703 JVM_ENTRY(jobject, jmm_GetPoolCollectionUsage(JNIEnv* env, jobject obj))
704 ResourceMark rm(THREAD);
706 MemoryPool* pool = get_memory_pool_from_jobject(obj, CHECK_NULL);
707 if (pool != NULL && pool->is_collected_pool()) {
708 MemoryUsage usage = pool->get_last_collection_usage();
709 Handle h = MemoryService::create_MemoryUsage_obj(usage, CHECK_NULL);
710 return JNIHandles::make_local(env, h());
711 } else {
712 return NULL;
713 }
714 JVM_END
716 // Sets the memory pool sensor for a threshold type
717 JVM_ENTRY(void, jmm_SetPoolSensor(JNIEnv* env, jobject obj, jmmThresholdType type, jobject sensorObj))
718 if (obj == NULL || sensorObj == NULL) {
719 THROW(vmSymbols::java_lang_NullPointerException());
720 }
722 Klass* sensor_klass = Management::sun_management_Sensor_klass(CHECK);
723 oop s = JNIHandles::resolve(sensorObj);
724 assert(s->is_instance(), "Sensor should be an instanceOop");
725 instanceHandle sensor_h(THREAD, (instanceOop) s);
726 if (!sensor_h->is_a(sensor_klass)) {
727 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
728 "Sensor is not an instance of sun.management.Sensor class");
729 }
731 MemoryPool* mpool = get_memory_pool_from_jobject(obj, CHECK);
732 assert(mpool != NULL, "MemoryPool should exist");
734 switch (type) {
735 case JMM_USAGE_THRESHOLD_HIGH:
736 case JMM_USAGE_THRESHOLD_LOW:
737 // have only one sensor for threshold high and low
738 mpool->set_usage_sensor_obj(sensor_h);
739 break;
740 case JMM_COLLECTION_USAGE_THRESHOLD_HIGH:
741 case JMM_COLLECTION_USAGE_THRESHOLD_LOW:
742 // have only one sensor for threshold high and low
743 mpool->set_gc_usage_sensor_obj(sensor_h);
744 break;
745 default:
746 assert(false, "Unrecognized type");
747 }
749 JVM_END
752 // Sets the threshold of a given memory pool.
753 // Returns the previous threshold.
754 //
755 // Input parameters:
756 // pool - the MemoryPoolMXBean object
757 // type - threshold type
758 // threshold - the new threshold (must not be negative)
759 //
760 JVM_ENTRY(jlong, jmm_SetPoolThreshold(JNIEnv* env, jobject obj, jmmThresholdType type, jlong threshold))
761 if (threshold < 0) {
762 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
763 "Invalid threshold value",
764 -1);
765 }
767 if ((size_t)threshold > max_uintx) {
768 stringStream st;
769 st.print("Invalid valid threshold value. Threshold value (" UINT64_FORMAT ") > max value of size_t (" SIZE_FORMAT ")", (size_t)threshold, max_uintx);
770 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(), st.as_string(), -1);
771 }
773 MemoryPool* pool = get_memory_pool_from_jobject(obj, CHECK_(0L));
774 assert(pool != NULL, "MemoryPool should exist");
776 jlong prev = 0;
777 switch (type) {
778 case JMM_USAGE_THRESHOLD_HIGH:
779 if (!pool->usage_threshold()->is_high_threshold_supported()) {
780 return -1;
781 }
782 prev = pool->usage_threshold()->set_high_threshold((size_t) threshold);
783 break;
785 case JMM_USAGE_THRESHOLD_LOW:
786 if (!pool->usage_threshold()->is_low_threshold_supported()) {
787 return -1;
788 }
789 prev = pool->usage_threshold()->set_low_threshold((size_t) threshold);
790 break;
792 case JMM_COLLECTION_USAGE_THRESHOLD_HIGH:
793 if (!pool->gc_usage_threshold()->is_high_threshold_supported()) {
794 return -1;
795 }
796 // return and the new threshold is effective for the next GC
797 return pool->gc_usage_threshold()->set_high_threshold((size_t) threshold);
799 case JMM_COLLECTION_USAGE_THRESHOLD_LOW:
800 if (!pool->gc_usage_threshold()->is_low_threshold_supported()) {
801 return -1;
802 }
803 // return and the new threshold is effective for the next GC
804 return pool->gc_usage_threshold()->set_low_threshold((size_t) threshold);
806 default:
807 assert(false, "Unrecognized type");
808 return -1;
809 }
811 // When the threshold is changed, reevaluate if the low memory
812 // detection is enabled.
813 if (prev != threshold) {
814 LowMemoryDetector::recompute_enabled_for_collected_pools();
815 LowMemoryDetector::detect_low_memory(pool);
816 }
817 return prev;
818 JVM_END
820 // Gets an array containing the amount of memory allocated on the Java
821 // heap for a set of threads (in bytes). Each element of the array is
822 // the amount of memory allocated for the thread ID specified in the
823 // corresponding entry in the given array of thread IDs; or -1 if the
824 // thread does not exist or has terminated.
825 JVM_ENTRY(void, jmm_GetThreadAllocatedMemory(JNIEnv *env, jlongArray ids,
826 jlongArray sizeArray))
827 // Check if threads is null
828 if (ids == NULL || sizeArray == NULL) {
829 THROW(vmSymbols::java_lang_NullPointerException());
830 }
832 ResourceMark rm(THREAD);
833 typeArrayOop ta = typeArrayOop(JNIHandles::resolve_non_null(ids));
834 typeArrayHandle ids_ah(THREAD, ta);
836 typeArrayOop sa = typeArrayOop(JNIHandles::resolve_non_null(sizeArray));
837 typeArrayHandle sizeArray_h(THREAD, sa);
839 // validate the thread id array
840 validate_thread_id_array(ids_ah, CHECK);
842 // sizeArray must be of the same length as the given array of thread IDs
843 int num_threads = ids_ah->length();
844 if (num_threads != sizeArray_h->length()) {
845 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
846 "The length of the given long array does not match the length of "
847 "the given array of thread IDs");
848 }
850 MutexLockerEx ml(Threads_lock);
851 for (int i = 0; i < num_threads; i++) {
852 JavaThread* java_thread = find_java_thread_from_id(ids_ah->long_at(i));
853 if (java_thread != NULL) {
854 sizeArray_h->long_at_put(i, java_thread->cooked_allocated_bytes());
855 }
856 }
857 JVM_END
859 // Returns a java/lang/management/MemoryUsage object representing
860 // the memory usage for the heap or non-heap memory.
861 JVM_ENTRY(jobject, jmm_GetMemoryUsage(JNIEnv* env, jboolean heap))
862 ResourceMark rm(THREAD);
864 // Calculate the memory usage
865 size_t total_init = 0;
866 size_t total_used = 0;
867 size_t total_committed = 0;
868 size_t total_max = 0;
869 bool has_undefined_init_size = false;
870 bool has_undefined_max_size = false;
872 for (int i = 0; i < MemoryService::num_memory_pools(); i++) {
873 MemoryPool* pool = MemoryService::get_memory_pool(i);
874 if ((heap && pool->is_heap()) || (!heap && pool->is_non_heap())) {
875 MemoryUsage u = pool->get_memory_usage();
876 total_used += u.used();
877 total_committed += u.committed();
879 // if any one of the memory pool has undefined init_size or max_size,
880 // set it to -1
881 if (u.init_size() == (size_t)-1) {
882 has_undefined_init_size = true;
883 }
884 if (!has_undefined_init_size) {
885 total_init += u.init_size();
886 }
888 if (u.max_size() == (size_t)-1) {
889 has_undefined_max_size = true;
890 }
891 if (!has_undefined_max_size) {
892 total_max += u.max_size();
893 }
894 }
895 }
897 // In our current implementation, we make sure that all non-heap
898 // pools have defined init and max sizes. Heap pools do not matter,
899 // as we never use total_init and total_max for them.
900 assert(heap || !has_undefined_init_size, "Undefined init size");
901 assert(heap || !has_undefined_max_size, "Undefined max size");
903 MemoryUsage usage((heap ? InitialHeapSize : total_init),
904 total_used,
905 total_committed,
906 (heap ? Universe::heap()->max_capacity() : total_max));
908 Handle obj = MemoryService::create_MemoryUsage_obj(usage, CHECK_NULL);
909 return JNIHandles::make_local(env, obj());
910 JVM_END
912 // Returns the boolean value of a given attribute.
913 JVM_LEAF(jboolean, jmm_GetBoolAttribute(JNIEnv *env, jmmBoolAttribute att))
914 switch (att) {
915 case JMM_VERBOSE_GC:
916 return MemoryService::get_verbose();
917 case JMM_VERBOSE_CLASS:
918 return ClassLoadingService::get_verbose();
919 case JMM_THREAD_CONTENTION_MONITORING:
920 return ThreadService::is_thread_monitoring_contention();
921 case JMM_THREAD_CPU_TIME:
922 return ThreadService::is_thread_cpu_time_enabled();
923 case JMM_THREAD_ALLOCATED_MEMORY:
924 return ThreadService::is_thread_allocated_memory_enabled();
925 default:
926 assert(0, "Unrecognized attribute");
927 return false;
928 }
929 JVM_END
931 // Sets the given boolean attribute and returns the previous value.
932 JVM_ENTRY(jboolean, jmm_SetBoolAttribute(JNIEnv *env, jmmBoolAttribute att, jboolean flag))
933 switch (att) {
934 case JMM_VERBOSE_GC:
935 return MemoryService::set_verbose(flag != 0);
936 case JMM_VERBOSE_CLASS:
937 return ClassLoadingService::set_verbose(flag != 0);
938 case JMM_THREAD_CONTENTION_MONITORING:
939 return ThreadService::set_thread_monitoring_contention(flag != 0);
940 case JMM_THREAD_CPU_TIME:
941 return ThreadService::set_thread_cpu_time_enabled(flag != 0);
942 case JMM_THREAD_ALLOCATED_MEMORY:
943 return ThreadService::set_thread_allocated_memory_enabled(flag != 0);
944 default:
945 assert(0, "Unrecognized attribute");
946 return false;
947 }
948 JVM_END
951 static jlong get_gc_attribute(GCMemoryManager* mgr, jmmLongAttribute att) {
952 switch (att) {
953 case JMM_GC_TIME_MS:
954 return mgr->gc_time_ms();
956 case JMM_GC_COUNT:
957 return mgr->gc_count();
959 case JMM_GC_EXT_ATTRIBUTE_INFO_SIZE:
960 // current implementation only has 1 ext attribute
961 return 1;
963 default:
964 assert(0, "Unrecognized GC attribute");
965 return -1;
966 }
967 }
969 class VmThreadCountClosure: public ThreadClosure {
970 private:
971 int _count;
972 public:
973 VmThreadCountClosure() : _count(0) {};
974 void do_thread(Thread* thread);
975 int count() { return _count; }
976 };
978 void VmThreadCountClosure::do_thread(Thread* thread) {
979 // exclude externally visible JavaThreads
980 if (thread->is_Java_thread() && !thread->is_hidden_from_external_view()) {
981 return;
982 }
984 _count++;
985 }
987 static jint get_vm_thread_count() {
988 VmThreadCountClosure vmtcc;
989 {
990 MutexLockerEx ml(Threads_lock);
991 Threads::threads_do(&vmtcc);
992 }
994 return vmtcc.count();
995 }
997 static jint get_num_flags() {
998 // last flag entry is always NULL, so subtract 1
999 int nFlags = (int) Flag::numFlags - 1;
1000 int count = 0;
1001 for (int i = 0; i < nFlags; i++) {
1002 Flag* flag = &Flag::flags[i];
1003 // Exclude the locked (diagnostic, experimental) flags
1004 if (flag->is_unlocked() || flag->is_unlocker()) {
1005 count++;
1006 }
1007 }
1008 return count;
1009 }
1011 static jlong get_long_attribute(jmmLongAttribute att) {
1012 switch (att) {
1013 case JMM_CLASS_LOADED_COUNT:
1014 return ClassLoadingService::loaded_class_count();
1016 case JMM_CLASS_UNLOADED_COUNT:
1017 return ClassLoadingService::unloaded_class_count();
1019 case JMM_THREAD_TOTAL_COUNT:
1020 return ThreadService::get_total_thread_count();
1022 case JMM_THREAD_LIVE_COUNT:
1023 return ThreadService::get_live_thread_count();
1025 case JMM_THREAD_PEAK_COUNT:
1026 return ThreadService::get_peak_thread_count();
1028 case JMM_THREAD_DAEMON_COUNT:
1029 return ThreadService::get_daemon_thread_count();
1031 case JMM_JVM_INIT_DONE_TIME_MS:
1032 return Management::vm_init_done_time();
1034 case JMM_COMPILE_TOTAL_TIME_MS:
1035 return Management::ticks_to_ms(CompileBroker::total_compilation_ticks());
1037 case JMM_OS_PROCESS_ID:
1038 return os::current_process_id();
1040 // Hotspot-specific counters
1041 case JMM_CLASS_LOADED_BYTES:
1042 return ClassLoadingService::loaded_class_bytes();
1044 case JMM_CLASS_UNLOADED_BYTES:
1045 return ClassLoadingService::unloaded_class_bytes();
1047 case JMM_SHARED_CLASS_LOADED_COUNT:
1048 return ClassLoadingService::loaded_shared_class_count();
1050 case JMM_SHARED_CLASS_UNLOADED_COUNT:
1051 return ClassLoadingService::unloaded_shared_class_count();
1054 case JMM_SHARED_CLASS_LOADED_BYTES:
1055 return ClassLoadingService::loaded_shared_class_bytes();
1057 case JMM_SHARED_CLASS_UNLOADED_BYTES:
1058 return ClassLoadingService::unloaded_shared_class_bytes();
1060 case JMM_TOTAL_CLASSLOAD_TIME_MS:
1061 return ClassLoader::classloader_time_ms();
1063 case JMM_VM_GLOBAL_COUNT:
1064 return get_num_flags();
1066 case JMM_SAFEPOINT_COUNT:
1067 return RuntimeService::safepoint_count();
1069 case JMM_TOTAL_SAFEPOINTSYNC_TIME_MS:
1070 return RuntimeService::safepoint_sync_time_ms();
1072 case JMM_TOTAL_STOPPED_TIME_MS:
1073 return RuntimeService::safepoint_time_ms();
1075 case JMM_TOTAL_APP_TIME_MS:
1076 return RuntimeService::application_time_ms();
1078 case JMM_VM_THREAD_COUNT:
1079 return get_vm_thread_count();
1081 case JMM_CLASS_INIT_TOTAL_COUNT:
1082 return ClassLoader::class_init_count();
1084 case JMM_CLASS_INIT_TOTAL_TIME_MS:
1085 return ClassLoader::class_init_time_ms();
1087 case JMM_CLASS_VERIFY_TOTAL_TIME_MS:
1088 return ClassLoader::class_verify_time_ms();
1090 case JMM_METHOD_DATA_SIZE_BYTES:
1091 return ClassLoadingService::class_method_data_size();
1093 case JMM_OS_MEM_TOTAL_PHYSICAL_BYTES:
1094 return os::physical_memory();
1096 default:
1097 return -1;
1098 }
1099 }
1102 // Returns the long value of a given attribute.
1103 JVM_ENTRY(jlong, jmm_GetLongAttribute(JNIEnv *env, jobject obj, jmmLongAttribute att))
1104 if (obj == NULL) {
1105 return get_long_attribute(att);
1106 } else {
1107 GCMemoryManager* mgr = get_gc_memory_manager_from_jobject(obj, CHECK_(0L));
1108 if (mgr != NULL) {
1109 return get_gc_attribute(mgr, att);
1110 }
1111 }
1112 return -1;
1113 JVM_END
1115 // Gets the value of all attributes specified in the given array
1116 // and sets the value in the result array.
1117 // Returns the number of attributes found.
1118 JVM_ENTRY(jint, jmm_GetLongAttributes(JNIEnv *env,
1119 jobject obj,
1120 jmmLongAttribute* atts,
1121 jint count,
1122 jlong* result))
1124 int num_atts = 0;
1125 if (obj == NULL) {
1126 for (int i = 0; i < count; i++) {
1127 result[i] = get_long_attribute(atts[i]);
1128 if (result[i] != -1) {
1129 num_atts++;
1130 }
1131 }
1132 } else {
1133 GCMemoryManager* mgr = get_gc_memory_manager_from_jobject(obj, CHECK_0);
1134 for (int i = 0; i < count; i++) {
1135 result[i] = get_gc_attribute(mgr, atts[i]);
1136 if (result[i] != -1) {
1137 num_atts++;
1138 }
1139 }
1140 }
1141 return num_atts;
1142 JVM_END
1144 // Helper function to do thread dump for a specific list of threads
1145 static void do_thread_dump(ThreadDumpResult* dump_result,
1146 typeArrayHandle ids_ah, // array of thread ID (long[])
1147 int num_threads,
1148 int max_depth,
1149 bool with_locked_monitors,
1150 bool with_locked_synchronizers,
1151 TRAPS) {
1153 // First get an array of threadObj handles.
1154 // A JavaThread may terminate before we get the stack trace.
1155 GrowableArray<instanceHandle>* thread_handle_array = new GrowableArray<instanceHandle>(num_threads);
1156 {
1157 MutexLockerEx ml(Threads_lock);
1158 for (int i = 0; i < num_threads; i++) {
1159 jlong tid = ids_ah->long_at(i);
1160 JavaThread* jt = find_java_thread_from_id(tid);
1161 oop thread_obj = (jt != NULL ? jt->threadObj() : (oop)NULL);
1162 instanceHandle threadObj_h(THREAD, (instanceOop) thread_obj);
1163 thread_handle_array->append(threadObj_h);
1164 }
1165 }
1167 // Obtain thread dumps and thread snapshot information
1168 VM_ThreadDump op(dump_result,
1169 thread_handle_array,
1170 num_threads,
1171 max_depth, /* stack depth */
1172 with_locked_monitors,
1173 with_locked_synchronizers);
1174 VMThread::execute(&op);
1175 }
1177 // Gets an array of ThreadInfo objects. Each element is the ThreadInfo
1178 // for the thread ID specified in the corresponding entry in
1179 // the given array of thread IDs; or NULL if the thread does not exist
1180 // or has terminated.
1181 //
1182 // Input parameters:
1183 // ids - array of thread IDs
1184 // maxDepth - the maximum depth of stack traces to be dumped:
1185 // maxDepth == -1 requests to dump entire stack trace.
1186 // maxDepth == 0 requests no stack trace.
1187 // infoArray - array of ThreadInfo objects
1188 //
1189 // QQQ - Why does this method return a value instead of void?
1190 JVM_ENTRY(jint, jmm_GetThreadInfo(JNIEnv *env, jlongArray ids, jint maxDepth, jobjectArray infoArray))
1191 // Check if threads is null
1192 if (ids == NULL || infoArray == NULL) {
1193 THROW_(vmSymbols::java_lang_NullPointerException(), -1);
1194 }
1196 if (maxDepth < -1) {
1197 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
1198 "Invalid maxDepth", -1);
1199 }
1201 ResourceMark rm(THREAD);
1202 typeArrayOop ta = typeArrayOop(JNIHandles::resolve_non_null(ids));
1203 typeArrayHandle ids_ah(THREAD, ta);
1205 oop infoArray_obj = JNIHandles::resolve_non_null(infoArray);
1206 objArrayOop oa = objArrayOop(infoArray_obj);
1207 objArrayHandle infoArray_h(THREAD, oa);
1209 // validate the thread id array
1210 validate_thread_id_array(ids_ah, CHECK_0);
1212 // validate the ThreadInfo[] parameters
1213 validate_thread_info_array(infoArray_h, CHECK_0);
1215 // infoArray must be of the same length as the given array of thread IDs
1216 int num_threads = ids_ah->length();
1217 if (num_threads != infoArray_h->length()) {
1218 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
1219 "The length of the given ThreadInfo array does not match the length of the given array of thread IDs", -1);
1220 }
1222 if (JDK_Version::is_gte_jdk16x_version()) {
1223 // make sure the AbstractOwnableSynchronizer klass is loaded before taking thread snapshots
1224 java_util_concurrent_locks_AbstractOwnableSynchronizer::initialize(CHECK_0);
1225 }
1227 // Must use ThreadDumpResult to store the ThreadSnapshot.
1228 // GC may occur after the thread snapshots are taken but before
1229 // this function returns. The threadObj and other oops kept
1230 // in the ThreadSnapshot are marked and adjusted during GC.
1231 ThreadDumpResult dump_result(num_threads);
1233 if (maxDepth == 0) {
1234 // no stack trace dumped - do not need to stop the world
1235 {
1236 MutexLockerEx ml(Threads_lock);
1237 for (int i = 0; i < num_threads; i++) {
1238 jlong tid = ids_ah->long_at(i);
1239 JavaThread* jt = find_java_thread_from_id(tid);
1240 ThreadSnapshot* ts;
1241 if (jt == NULL) {
1242 // if the thread does not exist or now it is terminated,
1243 // create dummy snapshot
1244 ts = new ThreadSnapshot();
1245 } else {
1246 ts = new ThreadSnapshot(jt);
1247 }
1248 dump_result.add_thread_snapshot(ts);
1249 }
1250 }
1251 } else {
1252 // obtain thread dump with the specific list of threads with stack trace
1253 do_thread_dump(&dump_result,
1254 ids_ah,
1255 num_threads,
1256 maxDepth,
1257 false, /* no locked monitor */
1258 false, /* no locked synchronizers */
1259 CHECK_0);
1260 }
1262 int num_snapshots = dump_result.num_snapshots();
1263 assert(num_snapshots == num_threads, "Must match the number of thread snapshots");
1264 int index = 0;
1265 for (ThreadSnapshot* ts = dump_result.snapshots(); ts != NULL; index++, ts = ts->next()) {
1266 // For each thread, create an java/lang/management/ThreadInfo object
1267 // and fill with the thread information
1269 if (ts->threadObj() == NULL) {
1270 // if the thread does not exist or now it is terminated, set threadinfo to NULL
1271 infoArray_h->obj_at_put(index, NULL);
1272 continue;
1273 }
1275 // Create java.lang.management.ThreadInfo object
1276 instanceOop info_obj = Management::create_thread_info_instance(ts, CHECK_0);
1277 infoArray_h->obj_at_put(index, info_obj);
1278 }
1279 return 0;
1280 JVM_END
1282 // Dump thread info for the specified threads.
1283 // It returns an array of ThreadInfo objects. Each element is the ThreadInfo
1284 // for the thread ID specified in the corresponding entry in
1285 // the given array of thread IDs; or NULL if the thread does not exist
1286 // or has terminated.
1287 //
1288 // Input parameter:
1289 // ids - array of thread IDs; NULL indicates all live threads
1290 // locked_monitors - if true, dump locked object monitors
1291 // locked_synchronizers - if true, dump locked JSR-166 synchronizers
1292 //
1293 JVM_ENTRY(jobjectArray, jmm_DumpThreads(JNIEnv *env, jlongArray thread_ids, jboolean locked_monitors, jboolean locked_synchronizers))
1294 ResourceMark rm(THREAD);
1296 if (JDK_Version::is_gte_jdk16x_version()) {
1297 // make sure the AbstractOwnableSynchronizer klass is loaded before taking thread snapshots
1298 java_util_concurrent_locks_AbstractOwnableSynchronizer::initialize(CHECK_NULL);
1299 }
1301 typeArrayOop ta = typeArrayOop(JNIHandles::resolve(thread_ids));
1302 int num_threads = (ta != NULL ? ta->length() : 0);
1303 typeArrayHandle ids_ah(THREAD, ta);
1305 ThreadDumpResult dump_result(num_threads); // can safepoint
1307 if (ids_ah() != NULL) {
1309 // validate the thread id array
1310 validate_thread_id_array(ids_ah, CHECK_NULL);
1312 // obtain thread dump of a specific list of threads
1313 do_thread_dump(&dump_result,
1314 ids_ah,
1315 num_threads,
1316 -1, /* entire stack */
1317 (locked_monitors ? true : false), /* with locked monitors */
1318 (locked_synchronizers ? true : false), /* with locked synchronizers */
1319 CHECK_NULL);
1320 } else {
1321 // obtain thread dump of all threads
1322 VM_ThreadDump op(&dump_result,
1323 -1, /* entire stack */
1324 (locked_monitors ? true : false), /* with locked monitors */
1325 (locked_synchronizers ? true : false) /* with locked synchronizers */);
1326 VMThread::execute(&op);
1327 }
1329 int num_snapshots = dump_result.num_snapshots();
1331 // create the result ThreadInfo[] object
1332 Klass* k = Management::java_lang_management_ThreadInfo_klass(CHECK_NULL);
1333 instanceKlassHandle ik (THREAD, k);
1334 objArrayOop r = oopFactory::new_objArray(ik(), num_snapshots, CHECK_NULL);
1335 objArrayHandle result_h(THREAD, r);
1337 int index = 0;
1338 for (ThreadSnapshot* ts = dump_result.snapshots(); ts != NULL; ts = ts->next(), index++) {
1339 if (ts->threadObj() == NULL) {
1340 // if the thread does not exist or now it is terminated, set threadinfo to NULL
1341 result_h->obj_at_put(index, NULL);
1342 continue;
1343 }
1345 ThreadStackTrace* stacktrace = ts->get_stack_trace();
1346 assert(stacktrace != NULL, "Must have a stack trace dumped");
1348 // Create Object[] filled with locked monitors
1349 // Create int[] filled with the stack depth where a monitor was locked
1350 int num_frames = stacktrace->get_stack_depth();
1351 int num_locked_monitors = stacktrace->num_jni_locked_monitors();
1353 // Count the total number of locked monitors
1354 for (int i = 0; i < num_frames; i++) {
1355 StackFrameInfo* frame = stacktrace->stack_frame_at(i);
1356 num_locked_monitors += frame->num_locked_monitors();
1357 }
1359 objArrayHandle monitors_array;
1360 typeArrayHandle depths_array;
1361 objArrayHandle synchronizers_array;
1363 if (locked_monitors) {
1364 // Constructs Object[] and int[] to contain the object monitor and the stack depth
1365 // where the thread locked it
1366 objArrayOop array = oopFactory::new_objArray(SystemDictionary::Object_klass(), num_locked_monitors, CHECK_NULL);
1367 objArrayHandle mh(THREAD, array);
1368 monitors_array = mh;
1370 typeArrayOop tarray = oopFactory::new_typeArray(T_INT, num_locked_monitors, CHECK_NULL);
1371 typeArrayHandle dh(THREAD, tarray);
1372 depths_array = dh;
1374 int count = 0;
1375 int j = 0;
1376 for (int depth = 0; depth < num_frames; depth++) {
1377 StackFrameInfo* frame = stacktrace->stack_frame_at(depth);
1378 int len = frame->num_locked_monitors();
1379 GrowableArray<oop>* locked_monitors = frame->locked_monitors();
1380 for (j = 0; j < len; j++) {
1381 oop monitor = locked_monitors->at(j);
1382 assert(monitor != NULL && monitor->is_instance(), "must be a Java object");
1383 monitors_array->obj_at_put(count, monitor);
1384 depths_array->int_at_put(count, depth);
1385 count++;
1386 }
1387 }
1389 GrowableArray<oop>* jni_locked_monitors = stacktrace->jni_locked_monitors();
1390 for (j = 0; j < jni_locked_monitors->length(); j++) {
1391 oop object = jni_locked_monitors->at(j);
1392 assert(object != NULL && object->is_instance(), "must be a Java object");
1393 monitors_array->obj_at_put(count, object);
1394 // Monitor locked via JNI MonitorEnter call doesn't have stack depth info
1395 depths_array->int_at_put(count, -1);
1396 count++;
1397 }
1398 assert(count == num_locked_monitors, "number of locked monitors doesn't match");
1399 }
1401 if (locked_synchronizers) {
1402 // Create Object[] filled with locked JSR-166 synchronizers
1403 assert(ts->threadObj() != NULL, "Must be a valid JavaThread");
1404 ThreadConcurrentLocks* tcl = ts->get_concurrent_locks();
1405 GrowableArray<instanceOop>* locks = (tcl != NULL ? tcl->owned_locks() : NULL);
1406 int num_locked_synchronizers = (locks != NULL ? locks->length() : 0);
1408 objArrayOop array = oopFactory::new_objArray(SystemDictionary::Object_klass(), num_locked_synchronizers, CHECK_NULL);
1409 objArrayHandle sh(THREAD, array);
1410 synchronizers_array = sh;
1412 for (int k = 0; k < num_locked_synchronizers; k++) {
1413 synchronizers_array->obj_at_put(k, locks->at(k));
1414 }
1415 }
1417 // Create java.lang.management.ThreadInfo object
1418 instanceOop info_obj = Management::create_thread_info_instance(ts,
1419 monitors_array,
1420 depths_array,
1421 synchronizers_array,
1422 CHECK_NULL);
1423 result_h->obj_at_put(index, info_obj);
1424 }
1426 return (jobjectArray) JNIHandles::make_local(env, result_h());
1427 JVM_END
1429 // Returns an array of Class objects.
1430 JVM_ENTRY(jobjectArray, jmm_GetLoadedClasses(JNIEnv *env))
1431 ResourceMark rm(THREAD);
1433 LoadedClassesEnumerator lce(THREAD); // Pass current Thread as parameter
1435 int num_classes = lce.num_loaded_classes();
1436 objArrayOop r = oopFactory::new_objArray(SystemDictionary::Class_klass(), num_classes, CHECK_0);
1437 objArrayHandle classes_ah(THREAD, r);
1439 for (int i = 0; i < num_classes; i++) {
1440 KlassHandle kh = lce.get_klass(i);
1441 oop mirror = kh()->java_mirror();
1442 classes_ah->obj_at_put(i, mirror);
1443 }
1445 return (jobjectArray) JNIHandles::make_local(env, classes_ah());
1446 JVM_END
1448 // Reset statistic. Return true if the requested statistic is reset.
1449 // Otherwise, return false.
1450 //
1451 // Input parameters:
1452 // obj - specify which instance the statistic associated with to be reset
1453 // For PEAK_POOL_USAGE stat, obj is required to be a memory pool object.
1454 // For THREAD_CONTENTION_COUNT and TIME stat, obj is required to be a thread ID.
1455 // type - the type of statistic to be reset
1456 //
1457 JVM_ENTRY(jboolean, jmm_ResetStatistic(JNIEnv *env, jvalue obj, jmmStatisticType type))
1458 ResourceMark rm(THREAD);
1460 switch (type) {
1461 case JMM_STAT_PEAK_THREAD_COUNT:
1462 ThreadService::reset_peak_thread_count();
1463 return true;
1465 case JMM_STAT_THREAD_CONTENTION_COUNT:
1466 case JMM_STAT_THREAD_CONTENTION_TIME: {
1467 jlong tid = obj.j;
1468 if (tid < 0) {
1469 THROW_(vmSymbols::java_lang_IllegalArgumentException(), JNI_FALSE);
1470 }
1472 // Look for the JavaThread of this given tid
1473 MutexLockerEx ml(Threads_lock);
1474 if (tid == 0) {
1475 // reset contention statistics for all threads if tid == 0
1476 for (JavaThread* java_thread = Threads::first(); java_thread != NULL; java_thread = java_thread->next()) {
1477 if (type == JMM_STAT_THREAD_CONTENTION_COUNT) {
1478 ThreadService::reset_contention_count_stat(java_thread);
1479 } else {
1480 ThreadService::reset_contention_time_stat(java_thread);
1481 }
1482 }
1483 } else {
1484 // reset contention statistics for a given thread
1485 JavaThread* java_thread = find_java_thread_from_id(tid);
1486 if (java_thread == NULL) {
1487 return false;
1488 }
1490 if (type == JMM_STAT_THREAD_CONTENTION_COUNT) {
1491 ThreadService::reset_contention_count_stat(java_thread);
1492 } else {
1493 ThreadService::reset_contention_time_stat(java_thread);
1494 }
1495 }
1496 return true;
1497 break;
1498 }
1499 case JMM_STAT_PEAK_POOL_USAGE: {
1500 jobject o = obj.l;
1501 if (o == NULL) {
1502 THROW_(vmSymbols::java_lang_NullPointerException(), JNI_FALSE);
1503 }
1505 oop pool_obj = JNIHandles::resolve(o);
1506 assert(pool_obj->is_instance(), "Should be an instanceOop");
1507 instanceHandle ph(THREAD, (instanceOop) pool_obj);
1509 MemoryPool* pool = MemoryService::get_memory_pool(ph);
1510 if (pool != NULL) {
1511 pool->reset_peak_memory_usage();
1512 return true;
1513 }
1514 break;
1515 }
1516 case JMM_STAT_GC_STAT: {
1517 jobject o = obj.l;
1518 if (o == NULL) {
1519 THROW_(vmSymbols::java_lang_NullPointerException(), JNI_FALSE);
1520 }
1522 GCMemoryManager* mgr = get_gc_memory_manager_from_jobject(o, CHECK_0);
1523 if (mgr != NULL) {
1524 mgr->reset_gc_stat();
1525 return true;
1526 }
1527 break;
1528 }
1529 default:
1530 assert(0, "Unknown Statistic Type");
1531 }
1532 return false;
1533 JVM_END
1535 // Returns the fast estimate of CPU time consumed by
1536 // a given thread (in nanoseconds).
1537 // If thread_id == 0, return CPU time for the current thread.
1538 JVM_ENTRY(jlong, jmm_GetThreadCpuTime(JNIEnv *env, jlong thread_id))
1539 if (!os::is_thread_cpu_time_supported()) {
1540 return -1;
1541 }
1543 if (thread_id < 0) {
1544 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
1545 "Invalid thread ID", -1);
1546 }
1548 JavaThread* java_thread = NULL;
1549 if (thread_id == 0) {
1550 // current thread
1551 return os::current_thread_cpu_time();
1552 } else {
1553 MutexLockerEx ml(Threads_lock);
1554 java_thread = find_java_thread_from_id(thread_id);
1555 if (java_thread != NULL) {
1556 return os::thread_cpu_time((Thread*) java_thread);
1557 }
1558 }
1559 return -1;
1560 JVM_END
1562 // Returns the CPU time consumed by a given thread (in nanoseconds).
1563 // If thread_id == 0, CPU time for the current thread is returned.
1564 // If user_sys_cpu_time = true, user level and system CPU time of
1565 // a given thread is returned; otherwise, only user level CPU time
1566 // is returned.
1567 JVM_ENTRY(jlong, jmm_GetThreadCpuTimeWithKind(JNIEnv *env, jlong thread_id, jboolean user_sys_cpu_time))
1568 if (!os::is_thread_cpu_time_supported()) {
1569 return -1;
1570 }
1572 if (thread_id < 0) {
1573 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
1574 "Invalid thread ID", -1);
1575 }
1577 JavaThread* java_thread = NULL;
1578 if (thread_id == 0) {
1579 // current thread
1580 return os::current_thread_cpu_time(user_sys_cpu_time != 0);
1581 } else {
1582 MutexLockerEx ml(Threads_lock);
1583 java_thread = find_java_thread_from_id(thread_id);
1584 if (java_thread != NULL) {
1585 return os::thread_cpu_time((Thread*) java_thread, user_sys_cpu_time != 0);
1586 }
1587 }
1588 return -1;
1589 JVM_END
1591 // Gets an array containing the CPU times consumed by a set of threads
1592 // (in nanoseconds). Each element of the array is the CPU time for the
1593 // thread ID specified in the corresponding entry in the given array
1594 // of thread IDs; or -1 if the thread does not exist or has terminated.
1595 // If user_sys_cpu_time = true, the sum of user level and system CPU time
1596 // for the given thread is returned; otherwise, only user level CPU time
1597 // is returned.
1598 JVM_ENTRY(void, jmm_GetThreadCpuTimesWithKind(JNIEnv *env, jlongArray ids,
1599 jlongArray timeArray,
1600 jboolean user_sys_cpu_time))
1601 // Check if threads is null
1602 if (ids == NULL || timeArray == NULL) {
1603 THROW(vmSymbols::java_lang_NullPointerException());
1604 }
1606 ResourceMark rm(THREAD);
1607 typeArrayOop ta = typeArrayOop(JNIHandles::resolve_non_null(ids));
1608 typeArrayHandle ids_ah(THREAD, ta);
1610 typeArrayOop tia = typeArrayOop(JNIHandles::resolve_non_null(timeArray));
1611 typeArrayHandle timeArray_h(THREAD, tia);
1613 // validate the thread id array
1614 validate_thread_id_array(ids_ah, CHECK);
1616 // timeArray must be of the same length as the given array of thread IDs
1617 int num_threads = ids_ah->length();
1618 if (num_threads != timeArray_h->length()) {
1619 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
1620 "The length of the given long array does not match the length of "
1621 "the given array of thread IDs");
1622 }
1624 MutexLockerEx ml(Threads_lock);
1625 for (int i = 0; i < num_threads; i++) {
1626 JavaThread* java_thread = find_java_thread_from_id(ids_ah->long_at(i));
1627 if (java_thread != NULL) {
1628 timeArray_h->long_at_put(i, os::thread_cpu_time((Thread*)java_thread,
1629 user_sys_cpu_time != 0));
1630 }
1631 }
1632 JVM_END
1634 // Returns a String array of all VM global flag names
1635 JVM_ENTRY(jobjectArray, jmm_GetVMGlobalNames(JNIEnv *env))
1636 // last flag entry is always NULL, so subtract 1
1637 int nFlags = (int) Flag::numFlags - 1;
1638 // allocate a temp array
1639 objArrayOop r = oopFactory::new_objArray(SystemDictionary::String_klass(),
1640 nFlags, CHECK_0);
1641 objArrayHandle flags_ah(THREAD, r);
1642 int num_entries = 0;
1643 for (int i = 0; i < nFlags; i++) {
1644 Flag* flag = &Flag::flags[i];
1645 // Exclude the locked (experimental, diagnostic) flags
1646 if (flag->is_unlocked() || flag->is_unlocker()) {
1647 Handle s = java_lang_String::create_from_str(flag->name, CHECK_0);
1648 flags_ah->obj_at_put(num_entries, s());
1649 num_entries++;
1650 }
1651 }
1653 if (num_entries < nFlags) {
1654 // Return array of right length
1655 objArrayOop res = oopFactory::new_objArray(SystemDictionary::String_klass(), num_entries, CHECK_0);
1656 for(int i = 0; i < num_entries; i++) {
1657 res->obj_at_put(i, flags_ah->obj_at(i));
1658 }
1659 return (jobjectArray)JNIHandles::make_local(env, res);
1660 }
1662 return (jobjectArray)JNIHandles::make_local(env, flags_ah());
1663 JVM_END
1665 // Utility function used by jmm_GetVMGlobals. Returns false if flag type
1666 // can't be determined, true otherwise. If false is returned, then *global
1667 // will be incomplete and invalid.
1668 bool add_global_entry(JNIEnv* env, Handle name, jmmVMGlobal *global, Flag *flag, TRAPS) {
1669 Handle flag_name;
1670 if (name() == NULL) {
1671 flag_name = java_lang_String::create_from_str(flag->name, CHECK_false);
1672 } else {
1673 flag_name = name;
1674 }
1675 global->name = (jstring)JNIHandles::make_local(env, flag_name());
1677 if (flag->is_bool()) {
1678 global->value.z = flag->get_bool() ? JNI_TRUE : JNI_FALSE;
1679 global->type = JMM_VMGLOBAL_TYPE_JBOOLEAN;
1680 } else if (flag->is_intx()) {
1681 global->value.j = (jlong)flag->get_intx();
1682 global->type = JMM_VMGLOBAL_TYPE_JLONG;
1683 } else if (flag->is_uintx()) {
1684 global->value.j = (jlong)flag->get_uintx();
1685 global->type = JMM_VMGLOBAL_TYPE_JLONG;
1686 } else if (flag->is_uint64_t()) {
1687 global->value.j = (jlong)flag->get_uint64_t();
1688 global->type = JMM_VMGLOBAL_TYPE_JLONG;
1689 } else if (flag->is_ccstr()) {
1690 Handle str = java_lang_String::create_from_str(flag->get_ccstr(), CHECK_false);
1691 global->value.l = (jobject)JNIHandles::make_local(env, str());
1692 global->type = JMM_VMGLOBAL_TYPE_JSTRING;
1693 } else {
1694 global->type = JMM_VMGLOBAL_TYPE_UNKNOWN;
1695 return false;
1696 }
1698 global->writeable = flag->is_writeable();
1699 global->external = flag->is_external();
1700 switch (flag->origin) {
1701 case DEFAULT:
1702 global->origin = JMM_VMGLOBAL_ORIGIN_DEFAULT;
1703 break;
1704 case COMMAND_LINE:
1705 global->origin = JMM_VMGLOBAL_ORIGIN_COMMAND_LINE;
1706 break;
1707 case ENVIRON_VAR:
1708 global->origin = JMM_VMGLOBAL_ORIGIN_ENVIRON_VAR;
1709 break;
1710 case CONFIG_FILE:
1711 global->origin = JMM_VMGLOBAL_ORIGIN_CONFIG_FILE;
1712 break;
1713 case MANAGEMENT:
1714 global->origin = JMM_VMGLOBAL_ORIGIN_MANAGEMENT;
1715 break;
1716 case ERGONOMIC:
1717 global->origin = JMM_VMGLOBAL_ORIGIN_ERGONOMIC;
1718 break;
1719 default:
1720 global->origin = JMM_VMGLOBAL_ORIGIN_OTHER;
1721 }
1723 return true;
1724 }
1726 // Fill globals array of count length with jmmVMGlobal entries
1727 // specified by names. If names == NULL, fill globals array
1728 // with all Flags. Return value is number of entries
1729 // created in globals.
1730 // If a Flag with a given name in an array element does not
1731 // exist, globals[i].name will be set to NULL.
1732 JVM_ENTRY(jint, jmm_GetVMGlobals(JNIEnv *env,
1733 jobjectArray names,
1734 jmmVMGlobal *globals,
1735 jint count))
1738 if (globals == NULL) {
1739 THROW_(vmSymbols::java_lang_NullPointerException(), 0);
1740 }
1742 ResourceMark rm(THREAD);
1744 if (names != NULL) {
1745 // return the requested globals
1746 objArrayOop ta = objArrayOop(JNIHandles::resolve_non_null(names));
1747 objArrayHandle names_ah(THREAD, ta);
1748 // Make sure we have a String array
1749 Klass* element_klass = ObjArrayKlass::cast(names_ah->klass())->element_klass();
1750 if (element_klass != SystemDictionary::String_klass()) {
1751 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
1752 "Array element type is not String class", 0);
1753 }
1755 int names_length = names_ah->length();
1756 int num_entries = 0;
1757 for (int i = 0; i < names_length && i < count; i++) {
1758 oop s = names_ah->obj_at(i);
1759 if (s == NULL) {
1760 THROW_(vmSymbols::java_lang_NullPointerException(), 0);
1761 }
1763 Handle sh(THREAD, s);
1764 char* str = java_lang_String::as_utf8_string(s);
1765 Flag* flag = Flag::find_flag(str, strlen(str));
1766 if (flag != NULL &&
1767 add_global_entry(env, sh, &globals[i], flag, THREAD)) {
1768 num_entries++;
1769 } else {
1770 globals[i].name = NULL;
1771 }
1772 }
1773 return num_entries;
1774 } else {
1775 // return all globals if names == NULL
1777 // last flag entry is always NULL, so subtract 1
1778 int nFlags = (int) Flag::numFlags - 1;
1779 Handle null_h;
1780 int num_entries = 0;
1781 for (int i = 0; i < nFlags && num_entries < count; i++) {
1782 Flag* flag = &Flag::flags[i];
1783 // Exclude the locked (diagnostic, experimental) flags
1784 if ((flag->is_unlocked() || flag->is_unlocker()) &&
1785 add_global_entry(env, null_h, &globals[num_entries], flag, THREAD)) {
1786 num_entries++;
1787 }
1788 }
1789 return num_entries;
1790 }
1791 JVM_END
1793 JVM_ENTRY(void, jmm_SetVMGlobal(JNIEnv *env, jstring flag_name, jvalue new_value))
1794 ResourceMark rm(THREAD);
1796 oop fn = JNIHandles::resolve_external_guard(flag_name);
1797 if (fn == NULL) {
1798 THROW_MSG(vmSymbols::java_lang_NullPointerException(),
1799 "The flag name cannot be null.");
1800 }
1801 char* name = java_lang_String::as_utf8_string(fn);
1802 Flag* flag = Flag::find_flag(name, strlen(name));
1803 if (flag == NULL) {
1804 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
1805 "Flag does not exist.");
1806 }
1807 if (!flag->is_writeable()) {
1808 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
1809 "This flag is not writeable.");
1810 }
1812 bool succeed;
1813 if (flag->is_bool()) {
1814 bool bvalue = (new_value.z == JNI_TRUE ? true : false);
1815 succeed = CommandLineFlags::boolAtPut(name, &bvalue, MANAGEMENT);
1816 } else if (flag->is_intx()) {
1817 intx ivalue = (intx)new_value.j;
1818 succeed = CommandLineFlags::intxAtPut(name, &ivalue, MANAGEMENT);
1819 } else if (flag->is_uintx()) {
1820 uintx uvalue = (uintx)new_value.j;
1821 succeed = CommandLineFlags::uintxAtPut(name, &uvalue, MANAGEMENT);
1822 } else if (flag->is_uint64_t()) {
1823 uint64_t uvalue = (uint64_t)new_value.j;
1824 succeed = CommandLineFlags::uint64_tAtPut(name, &uvalue, MANAGEMENT);
1825 } else if (flag->is_ccstr()) {
1826 oop str = JNIHandles::resolve_external_guard(new_value.l);
1827 if (str == NULL) {
1828 THROW(vmSymbols::java_lang_NullPointerException());
1829 }
1830 ccstr svalue = java_lang_String::as_utf8_string(str);
1831 succeed = CommandLineFlags::ccstrAtPut(name, &svalue, MANAGEMENT);
1832 }
1833 assert(succeed, "Setting flag should succeed");
1834 JVM_END
1836 class ThreadTimesClosure: public ThreadClosure {
1837 private:
1838 objArrayHandle _names_strings;
1839 char **_names_chars;
1840 typeArrayOop _times;
1841 int _names_len;
1842 int _times_len;
1843 int _count;
1845 public:
1846 ThreadTimesClosure(objArrayHandle names, typeArrayOop times);
1847 ~ThreadTimesClosure();
1848 virtual void do_thread(Thread* thread);
1849 void do_unlocked();
1850 int count() { return _count; }
1851 };
1853 ThreadTimesClosure::ThreadTimesClosure(objArrayHandle names,
1854 typeArrayOop times) {
1855 assert(names() != NULL, "names was NULL");
1856 assert(times != NULL, "times was NULL");
1857 _names_strings = names;
1858 _names_len = names->length();
1859 _names_chars = NEW_C_HEAP_ARRAY(char*, _names_len, mtInternal);
1860 _times = times;
1861 _times_len = times->length();
1862 _count = 0;
1863 }
1865 //
1866 // Called with Threads_lock held
1867 //
1868 void ThreadTimesClosure::do_thread(Thread* thread) {
1869 assert(thread != NULL, "thread was NULL");
1871 // exclude externally visible JavaThreads
1872 if (thread->is_Java_thread() && !thread->is_hidden_from_external_view()) {
1873 return;
1874 }
1876 if (_count >= _names_len || _count >= _times_len) {
1877 // skip if the result array is not big enough
1878 return;
1879 }
1881 EXCEPTION_MARK;
1882 ResourceMark rm(THREAD); // thread->name() uses ResourceArea
1884 assert(thread->name() != NULL, "All threads should have a name");
1885 _names_chars[_count] = strdup(thread->name());
1886 _times->long_at_put(_count, os::is_thread_cpu_time_supported() ?
1887 os::thread_cpu_time(thread) : -1);
1888 _count++;
1889 }
1891 // Called without Threads_lock, we can allocate String objects.
1892 void ThreadTimesClosure::do_unlocked() {
1894 EXCEPTION_MARK;
1895 for (int i = 0; i < _count; i++) {
1896 Handle s = java_lang_String::create_from_str(_names_chars[i], CHECK);
1897 _names_strings->obj_at_put(i, s());
1898 }
1899 }
1901 ThreadTimesClosure::~ThreadTimesClosure() {
1902 for (int i = 0; i < _count; i++) {
1903 free(_names_chars[i]);
1904 }
1905 FREE_C_HEAP_ARRAY(char *, _names_chars, mtInternal);
1906 }
1908 // Fills names with VM internal thread names and times with the corresponding
1909 // CPU times. If names or times is NULL, a NullPointerException is thrown.
1910 // If the element type of names is not String, an IllegalArgumentException is
1911 // thrown.
1912 // If an array is not large enough to hold all the entries, only the entries
1913 // that fit will be returned. Return value is the number of VM internal
1914 // threads entries.
1915 JVM_ENTRY(jint, jmm_GetInternalThreadTimes(JNIEnv *env,
1916 jobjectArray names,
1917 jlongArray times))
1918 if (names == NULL || times == NULL) {
1919 THROW_(vmSymbols::java_lang_NullPointerException(), 0);
1920 }
1921 objArrayOop na = objArrayOop(JNIHandles::resolve_non_null(names));
1922 objArrayHandle names_ah(THREAD, na);
1924 // Make sure we have a String array
1925 Klass* element_klass = ObjArrayKlass::cast(names_ah->klass())->element_klass();
1926 if (element_klass != SystemDictionary::String_klass()) {
1927 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
1928 "Array element type is not String class", 0);
1929 }
1931 typeArrayOop ta = typeArrayOop(JNIHandles::resolve_non_null(times));
1932 typeArrayHandle times_ah(THREAD, ta);
1934 ThreadTimesClosure ttc(names_ah, times_ah());
1935 {
1936 MutexLockerEx ml(Threads_lock);
1937 Threads::threads_do(&ttc);
1938 }
1939 ttc.do_unlocked();
1940 return ttc.count();
1941 JVM_END
1943 static Handle find_deadlocks(bool object_monitors_only, TRAPS) {
1944 ResourceMark rm(THREAD);
1946 VM_FindDeadlocks op(!object_monitors_only /* also check concurrent locks? */);
1947 VMThread::execute(&op);
1949 DeadlockCycle* deadlocks = op.result();
1950 if (deadlocks == NULL) {
1951 // no deadlock found and return
1952 return Handle();
1953 }
1955 int num_threads = 0;
1956 DeadlockCycle* cycle;
1957 for (cycle = deadlocks; cycle != NULL; cycle = cycle->next()) {
1958 num_threads += cycle->num_threads();
1959 }
1961 objArrayOop r = oopFactory::new_objArray(SystemDictionary::Thread_klass(), num_threads, CHECK_NH);
1962 objArrayHandle threads_ah(THREAD, r);
1964 int index = 0;
1965 for (cycle = deadlocks; cycle != NULL; cycle = cycle->next()) {
1966 GrowableArray<JavaThread*>* deadlock_threads = cycle->threads();
1967 int len = deadlock_threads->length();
1968 for (int i = 0; i < len; i++) {
1969 threads_ah->obj_at_put(index, deadlock_threads->at(i)->threadObj());
1970 index++;
1971 }
1972 }
1973 return threads_ah;
1974 }
1976 // Finds cycles of threads that are deadlocked involved in object monitors
1977 // and JSR-166 synchronizers.
1978 // Returns an array of Thread objects which are in deadlock, if any.
1979 // Otherwise, returns NULL.
1980 //
1981 // Input parameter:
1982 // object_monitors_only - if true, only check object monitors
1983 //
1984 JVM_ENTRY(jobjectArray, jmm_FindDeadlockedThreads(JNIEnv *env, jboolean object_monitors_only))
1985 Handle result = find_deadlocks(object_monitors_only != 0, CHECK_0);
1986 return (jobjectArray) JNIHandles::make_local(env, result());
1987 JVM_END
1989 // Finds cycles of threads that are deadlocked on monitor locks
1990 // Returns an array of Thread objects which are in deadlock, if any.
1991 // Otherwise, returns NULL.
1992 JVM_ENTRY(jobjectArray, jmm_FindMonitorDeadlockedThreads(JNIEnv *env))
1993 Handle result = find_deadlocks(true, CHECK_0);
1994 return (jobjectArray) JNIHandles::make_local(env, result());
1995 JVM_END
1997 // Gets the information about GC extension attributes including
1998 // the name of the attribute, its type, and a short description.
1999 //
2000 // Input parameters:
2001 // mgr - GC memory manager
2002 // info - caller allocated array of jmmExtAttributeInfo
2003 // count - number of elements of the info array
2004 //
2005 // Returns the number of GC extension attributes filled in the info array; or
2006 // -1 if info is not big enough
2007 //
2008 JVM_ENTRY(jint, jmm_GetGCExtAttributeInfo(JNIEnv *env, jobject mgr, jmmExtAttributeInfo* info, jint count))
2009 // All GC memory managers have 1 attribute (number of GC threads)
2010 if (count == 0) {
2011 return 0;
2012 }
2014 if (info == NULL) {
2015 THROW_(vmSymbols::java_lang_NullPointerException(), 0);
2016 }
2018 info[0].name = "GcThreadCount";
2019 info[0].type = 'I';
2020 info[0].description = "Number of GC threads";
2021 return 1;
2022 JVM_END
2024 // verify the given array is an array of java/lang/management/MemoryUsage objects
2025 // of a given length and return the objArrayOop
2026 static objArrayOop get_memory_usage_objArray(jobjectArray array, int length, TRAPS) {
2027 if (array == NULL) {
2028 THROW_(vmSymbols::java_lang_NullPointerException(), 0);
2029 }
2031 objArrayOop oa = objArrayOop(JNIHandles::resolve_non_null(array));
2032 objArrayHandle array_h(THREAD, oa);
2034 // array must be of the given length
2035 if (length != array_h->length()) {
2036 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
2037 "The length of the given MemoryUsage array does not match the number of memory pools.", 0);
2038 }
2040 // check if the element of array is of type MemoryUsage class
2041 Klass* usage_klass = Management::java_lang_management_MemoryUsage_klass(CHECK_0);
2042 Klass* element_klass = ObjArrayKlass::cast(array_h->klass())->element_klass();
2043 if (element_klass != usage_klass) {
2044 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
2045 "The element type is not MemoryUsage class", 0);
2046 }
2048 return array_h();
2049 }
2051 // Gets the statistics of the last GC of a given GC memory manager.
2052 // Input parameters:
2053 // obj - GarbageCollectorMXBean object
2054 // gc_stat - caller allocated jmmGCStat where:
2055 // a. before_gc_usage - array of MemoryUsage objects
2056 // b. after_gc_usage - array of MemoryUsage objects
2057 // c. gc_ext_attributes_values_size is set to the
2058 // gc_ext_attribute_values array allocated
2059 // d. gc_ext_attribute_values is a caller allocated array of jvalue.
2060 //
2061 // On return,
2062 // gc_index == 0 indicates no GC statistics available
2063 //
2064 // before_gc_usage and after_gc_usage - filled with per memory pool
2065 // before and after GC usage in the same order as the memory pools
2066 // returned by GetMemoryPools for a given GC memory manager.
2067 // num_gc_ext_attributes indicates the number of elements in
2068 // the gc_ext_attribute_values array is filled; or
2069 // -1 if the gc_ext_attributes_values array is not big enough
2070 //
2071 JVM_ENTRY(void, jmm_GetLastGCStat(JNIEnv *env, jobject obj, jmmGCStat *gc_stat))
2072 ResourceMark rm(THREAD);
2074 if (gc_stat->gc_ext_attribute_values_size > 0 && gc_stat->gc_ext_attribute_values == NULL) {
2075 THROW(vmSymbols::java_lang_NullPointerException());
2076 }
2078 // Get the GCMemoryManager
2079 GCMemoryManager* mgr = get_gc_memory_manager_from_jobject(obj, CHECK);
2081 // Make a copy of the last GC statistics
2082 // GC may occur while constructing the last GC information
2083 int num_pools = MemoryService::num_memory_pools();
2084 GCStatInfo stat(num_pools);
2085 if (mgr->get_last_gc_stat(&stat) == 0) {
2086 gc_stat->gc_index = 0;
2087 return;
2088 }
2090 gc_stat->gc_index = stat.gc_index();
2091 gc_stat->start_time = Management::ticks_to_ms(stat.start_time());
2092 gc_stat->end_time = Management::ticks_to_ms(stat.end_time());
2094 // Current implementation does not have GC extension attributes
2095 gc_stat->num_gc_ext_attributes = 0;
2097 // Fill the arrays of MemoryUsage objects with before and after GC
2098 // per pool memory usage
2099 objArrayOop bu = get_memory_usage_objArray(gc_stat->usage_before_gc,
2100 num_pools,
2101 CHECK);
2102 objArrayHandle usage_before_gc_ah(THREAD, bu);
2104 objArrayOop au = get_memory_usage_objArray(gc_stat->usage_after_gc,
2105 num_pools,
2106 CHECK);
2107 objArrayHandle usage_after_gc_ah(THREAD, au);
2109 for (int i = 0; i < num_pools; i++) {
2110 Handle before_usage = MemoryService::create_MemoryUsage_obj(stat.before_gc_usage_for_pool(i), CHECK);
2111 Handle after_usage;
2113 MemoryUsage u = stat.after_gc_usage_for_pool(i);
2114 if (u.max_size() == 0 && u.used() > 0) {
2115 // If max size == 0, this pool is a survivor space.
2116 // Set max size = -1 since the pools will be swapped after GC.
2117 MemoryUsage usage(u.init_size(), u.used(), u.committed(), (size_t)-1);
2118 after_usage = MemoryService::create_MemoryUsage_obj(usage, CHECK);
2119 } else {
2120 after_usage = MemoryService::create_MemoryUsage_obj(stat.after_gc_usage_for_pool(i), CHECK);
2121 }
2122 usage_before_gc_ah->obj_at_put(i, before_usage());
2123 usage_after_gc_ah->obj_at_put(i, after_usage());
2124 }
2126 if (gc_stat->gc_ext_attribute_values_size > 0) {
2127 // Current implementation only has 1 attribute (number of GC threads)
2128 // The type is 'I'
2129 gc_stat->gc_ext_attribute_values[0].i = mgr->num_gc_threads();
2130 }
2131 JVM_END
2133 JVM_ENTRY(void, jmm_SetGCNotificationEnabled(JNIEnv *env, jobject obj, jboolean enabled))
2134 ResourceMark rm(THREAD);
2135 // Get the GCMemoryManager
2136 GCMemoryManager* mgr = get_gc_memory_manager_from_jobject(obj, CHECK);
2137 mgr->set_notification_enabled(enabled?true:false);
2138 JVM_END
2140 // Dump heap - Returns 0 if succeeds.
2141 JVM_ENTRY(jint, jmm_DumpHeap0(JNIEnv *env, jstring outputfile, jboolean live))
2142 #if INCLUDE_SERVICES
2143 ResourceMark rm(THREAD);
2144 oop on = JNIHandles::resolve_external_guard(outputfile);
2145 if (on == NULL) {
2146 THROW_MSG_(vmSymbols::java_lang_NullPointerException(),
2147 "Output file name cannot be null.", -1);
2148 }
2149 char* name = java_lang_String::as_platform_dependent_str(on, CHECK_(-1));
2150 if (name == NULL) {
2151 THROW_MSG_(vmSymbols::java_lang_NullPointerException(),
2152 "Output file name cannot be null.", -1);
2153 }
2154 HeapDumper dumper(live ? true : false);
2155 if (dumper.dump(name) != 0) {
2156 const char* errmsg = dumper.error_as_C_string();
2157 THROW_MSG_(vmSymbols::java_io_IOException(), errmsg, -1);
2158 }
2159 return 0;
2160 #else // INCLUDE_SERVICES
2161 return -1;
2162 #endif // INCLUDE_SERVICES
2163 JVM_END
2165 JVM_ENTRY(jobjectArray, jmm_GetDiagnosticCommands(JNIEnv *env))
2166 ResourceMark rm(THREAD);
2167 GrowableArray<const char *>* dcmd_list = DCmdFactory::DCmd_list(DCmd_Source_MBean);
2168 objArrayOop cmd_array_oop = oopFactory::new_objArray(SystemDictionary::String_klass(),
2169 dcmd_list->length(), CHECK_NULL);
2170 objArrayHandle cmd_array(THREAD, cmd_array_oop);
2171 for (int i = 0; i < dcmd_list->length(); i++) {
2172 oop cmd_name = java_lang_String::create_oop_from_str(dcmd_list->at(i), CHECK_NULL);
2173 cmd_array->obj_at_put(i, cmd_name);
2174 }
2175 return (jobjectArray) JNIHandles::make_local(env, cmd_array());
2176 JVM_END
2178 JVM_ENTRY(void, jmm_GetDiagnosticCommandInfo(JNIEnv *env, jobjectArray cmds,
2179 dcmdInfo* infoArray))
2180 if (cmds == NULL || infoArray == NULL) {
2181 THROW(vmSymbols::java_lang_NullPointerException());
2182 }
2184 ResourceMark rm(THREAD);
2186 objArrayOop ca = objArrayOop(JNIHandles::resolve_non_null(cmds));
2187 objArrayHandle cmds_ah(THREAD, ca);
2189 // Make sure we have a String array
2190 Klass* element_klass = ObjArrayKlass::cast(cmds_ah->klass())->element_klass();
2191 if (element_klass != SystemDictionary::String_klass()) {
2192 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
2193 "Array element type is not String class");
2194 }
2196 GrowableArray<DCmdInfo *>* info_list = DCmdFactory::DCmdInfo_list(DCmd_Source_MBean);
2198 int num_cmds = cmds_ah->length();
2199 for (int i = 0; i < num_cmds; i++) {
2200 oop cmd = cmds_ah->obj_at(i);
2201 if (cmd == NULL) {
2202 THROW_MSG(vmSymbols::java_lang_NullPointerException(),
2203 "Command name cannot be null.");
2204 }
2205 char* cmd_name = java_lang_String::as_utf8_string(cmd);
2206 if (cmd_name == NULL) {
2207 THROW_MSG(vmSymbols::java_lang_NullPointerException(),
2208 "Command name cannot be null.");
2209 }
2210 int pos = info_list->find((void*)cmd_name,DCmdInfo::by_name);
2211 if (pos == -1) {
2212 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
2213 "Unknown diagnostic command");
2214 }
2215 DCmdInfo* info = info_list->at(pos);
2216 infoArray[i].name = info->name();
2217 infoArray[i].description = info->description();
2218 infoArray[i].impact = info->impact();
2219 JavaPermission p = info->permission();
2220 infoArray[i].permission_class = p._class;
2221 infoArray[i].permission_name = p._name;
2222 infoArray[i].permission_action = p._action;
2223 infoArray[i].num_arguments = info->num_arguments();
2224 infoArray[i].enabled = info->is_enabled();
2225 }
2226 JVM_END
2228 JVM_ENTRY(void, jmm_GetDiagnosticCommandArgumentsInfo(JNIEnv *env,
2229 jstring command, dcmdArgInfo* infoArray))
2230 ResourceMark rm(THREAD);
2231 oop cmd = JNIHandles::resolve_external_guard(command);
2232 if (cmd == NULL) {
2233 THROW_MSG(vmSymbols::java_lang_NullPointerException(),
2234 "Command line cannot be null.");
2235 }
2236 char* cmd_name = java_lang_String::as_utf8_string(cmd);
2237 if (cmd_name == NULL) {
2238 THROW_MSG(vmSymbols::java_lang_NullPointerException(),
2239 "Command line content cannot be null.");
2240 }
2241 DCmd* dcmd = NULL;
2242 DCmdFactory*factory = DCmdFactory::factory(DCmd_Source_MBean, cmd_name,
2243 strlen(cmd_name));
2244 if (factory != NULL) {
2245 dcmd = factory->create_resource_instance(NULL);
2246 }
2247 if (dcmd == NULL) {
2248 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
2249 "Unknown diagnostic command");
2250 }
2251 DCmdMark mark(dcmd);
2252 GrowableArray<DCmdArgumentInfo*>* array = dcmd->argument_info_array();
2253 if (array->length() == 0) {
2254 return;
2255 }
2256 for (int i = 0; i < array->length(); i++) {
2257 infoArray[i].name = array->at(i)->name();
2258 infoArray[i].description = array->at(i)->description();
2259 infoArray[i].type = array->at(i)->type();
2260 infoArray[i].default_string = array->at(i)->default_string();
2261 infoArray[i].mandatory = array->at(i)->is_mandatory();
2262 infoArray[i].option = array->at(i)->is_option();
2263 infoArray[i].multiple = array->at(i)->is_multiple();
2264 infoArray[i].position = array->at(i)->position();
2265 }
2266 return;
2267 JVM_END
2269 JVM_ENTRY(jstring, jmm_ExecuteDiagnosticCommand(JNIEnv *env, jstring commandline))
2270 ResourceMark rm(THREAD);
2271 oop cmd = JNIHandles::resolve_external_guard(commandline);
2272 if (cmd == NULL) {
2273 THROW_MSG_NULL(vmSymbols::java_lang_NullPointerException(),
2274 "Command line cannot be null.");
2275 }
2276 char* cmdline = java_lang_String::as_utf8_string(cmd);
2277 if (cmdline == NULL) {
2278 THROW_MSG_NULL(vmSymbols::java_lang_NullPointerException(),
2279 "Command line content cannot be null.");
2280 }
2281 bufferedStream output;
2282 DCmd::parse_and_execute(DCmd_Source_MBean, &output, cmdline, ' ', CHECK_NULL);
2283 oop result = java_lang_String::create_oop_from_str(output.as_string(), CHECK_NULL);
2284 return (jstring) JNIHandles::make_local(env, result);
2285 JVM_END
2287 JVM_ENTRY(void, jmm_SetDiagnosticFrameworkNotificationEnabled(JNIEnv *env, jboolean enabled))
2288 DCmdFactory::set_jmx_notification_enabled(enabled?true:false);
2289 JVM_END
2291 jlong Management::ticks_to_ms(jlong ticks) {
2292 assert(os::elapsed_frequency() > 0, "Must be non-zero");
2293 return (jlong)(((double)ticks / (double)os::elapsed_frequency())
2294 * (double)1000.0);
2295 }
2297 const struct jmmInterface_1_ jmm_interface = {
2298 NULL,
2299 NULL,
2300 jmm_GetVersion,
2301 jmm_GetOptionalSupport,
2302 jmm_GetInputArguments,
2303 jmm_GetThreadInfo,
2304 jmm_GetInputArgumentArray,
2305 jmm_GetMemoryPools,
2306 jmm_GetMemoryManagers,
2307 jmm_GetMemoryPoolUsage,
2308 jmm_GetPeakMemoryPoolUsage,
2309 jmm_GetThreadAllocatedMemory,
2310 jmm_GetMemoryUsage,
2311 jmm_GetLongAttribute,
2312 jmm_GetBoolAttribute,
2313 jmm_SetBoolAttribute,
2314 jmm_GetLongAttributes,
2315 jmm_FindMonitorDeadlockedThreads,
2316 jmm_GetThreadCpuTime,
2317 jmm_GetVMGlobalNames,
2318 jmm_GetVMGlobals,
2319 jmm_GetInternalThreadTimes,
2320 jmm_ResetStatistic,
2321 jmm_SetPoolSensor,
2322 jmm_SetPoolThreshold,
2323 jmm_GetPoolCollectionUsage,
2324 jmm_GetGCExtAttributeInfo,
2325 jmm_GetLastGCStat,
2326 jmm_GetThreadCpuTimeWithKind,
2327 jmm_GetThreadCpuTimesWithKind,
2328 jmm_DumpHeap0,
2329 jmm_FindDeadlockedThreads,
2330 jmm_SetVMGlobal,
2331 NULL,
2332 jmm_DumpThreads,
2333 jmm_SetGCNotificationEnabled,
2334 jmm_GetDiagnosticCommands,
2335 jmm_GetDiagnosticCommandInfo,
2336 jmm_GetDiagnosticCommandArgumentsInfo,
2337 jmm_ExecuteDiagnosticCommand,
2338 jmm_SetDiagnosticFrameworkNotificationEnabled
2339 };
2340 #endif // INCLUDE_MANAGEMENT
2342 void* Management::get_jmm_interface(int version) {
2343 #if INCLUDE_MANAGEMENT
2344 if (version == JMM_VERSION_1_0) {
2345 return (void*) &jmm_interface;
2346 }
2347 #endif // INCLUDE_MANAGEMENT
2348 return NULL;
2349 }