Thu, 01 Aug 2013 22:20:00 +0200
8014294: Assert in ThreadTimesClosure::do_thread() due to use of naked oop instead of handle
Summary: Assert in ThreadTimesClosure::do_thread() due to use of naked oop instead of handle
Reviewed-by: coleenp, sspitsyn
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 MemoryUsage usage((heap ? InitialHeapSize : total_init),
898 total_used,
899 total_committed,
900 (heap ? Universe::heap()->max_capacity() : total_max));
902 Handle obj = MemoryService::create_MemoryUsage_obj(usage, CHECK_NULL);
903 return JNIHandles::make_local(env, obj());
904 JVM_END
906 // Returns the boolean value of a given attribute.
907 JVM_LEAF(jboolean, jmm_GetBoolAttribute(JNIEnv *env, jmmBoolAttribute att))
908 switch (att) {
909 case JMM_VERBOSE_GC:
910 return MemoryService::get_verbose();
911 case JMM_VERBOSE_CLASS:
912 return ClassLoadingService::get_verbose();
913 case JMM_THREAD_CONTENTION_MONITORING:
914 return ThreadService::is_thread_monitoring_contention();
915 case JMM_THREAD_CPU_TIME:
916 return ThreadService::is_thread_cpu_time_enabled();
917 case JMM_THREAD_ALLOCATED_MEMORY:
918 return ThreadService::is_thread_allocated_memory_enabled();
919 default:
920 assert(0, "Unrecognized attribute");
921 return false;
922 }
923 JVM_END
925 // Sets the given boolean attribute and returns the previous value.
926 JVM_ENTRY(jboolean, jmm_SetBoolAttribute(JNIEnv *env, jmmBoolAttribute att, jboolean flag))
927 switch (att) {
928 case JMM_VERBOSE_GC:
929 return MemoryService::set_verbose(flag != 0);
930 case JMM_VERBOSE_CLASS:
931 return ClassLoadingService::set_verbose(flag != 0);
932 case JMM_THREAD_CONTENTION_MONITORING:
933 return ThreadService::set_thread_monitoring_contention(flag != 0);
934 case JMM_THREAD_CPU_TIME:
935 return ThreadService::set_thread_cpu_time_enabled(flag != 0);
936 case JMM_THREAD_ALLOCATED_MEMORY:
937 return ThreadService::set_thread_allocated_memory_enabled(flag != 0);
938 default:
939 assert(0, "Unrecognized attribute");
940 return false;
941 }
942 JVM_END
945 static jlong get_gc_attribute(GCMemoryManager* mgr, jmmLongAttribute att) {
946 switch (att) {
947 case JMM_GC_TIME_MS:
948 return mgr->gc_time_ms();
950 case JMM_GC_COUNT:
951 return mgr->gc_count();
953 case JMM_GC_EXT_ATTRIBUTE_INFO_SIZE:
954 // current implementation only has 1 ext attribute
955 return 1;
957 default:
958 assert(0, "Unrecognized GC attribute");
959 return -1;
960 }
961 }
963 class VmThreadCountClosure: public ThreadClosure {
964 private:
965 int _count;
966 public:
967 VmThreadCountClosure() : _count(0) {};
968 void do_thread(Thread* thread);
969 int count() { return _count; }
970 };
972 void VmThreadCountClosure::do_thread(Thread* thread) {
973 // exclude externally visible JavaThreads
974 if (thread->is_Java_thread() && !thread->is_hidden_from_external_view()) {
975 return;
976 }
978 _count++;
979 }
981 static jint get_vm_thread_count() {
982 VmThreadCountClosure vmtcc;
983 {
984 MutexLockerEx ml(Threads_lock);
985 Threads::threads_do(&vmtcc);
986 }
988 return vmtcc.count();
989 }
991 static jint get_num_flags() {
992 // last flag entry is always NULL, so subtract 1
993 int nFlags = (int) Flag::numFlags - 1;
994 int count = 0;
995 for (int i = 0; i < nFlags; i++) {
996 Flag* flag = &Flag::flags[i];
997 // Exclude the locked (diagnostic, experimental) flags
998 if (flag->is_unlocked() || flag->is_unlocker()) {
999 count++;
1000 }
1001 }
1002 return count;
1003 }
1005 static jlong get_long_attribute(jmmLongAttribute att) {
1006 switch (att) {
1007 case JMM_CLASS_LOADED_COUNT:
1008 return ClassLoadingService::loaded_class_count();
1010 case JMM_CLASS_UNLOADED_COUNT:
1011 return ClassLoadingService::unloaded_class_count();
1013 case JMM_THREAD_TOTAL_COUNT:
1014 return ThreadService::get_total_thread_count();
1016 case JMM_THREAD_LIVE_COUNT:
1017 return ThreadService::get_live_thread_count();
1019 case JMM_THREAD_PEAK_COUNT:
1020 return ThreadService::get_peak_thread_count();
1022 case JMM_THREAD_DAEMON_COUNT:
1023 return ThreadService::get_daemon_thread_count();
1025 case JMM_JVM_INIT_DONE_TIME_MS:
1026 return Management::vm_init_done_time();
1028 case JMM_COMPILE_TOTAL_TIME_MS:
1029 return Management::ticks_to_ms(CompileBroker::total_compilation_ticks());
1031 case JMM_OS_PROCESS_ID:
1032 return os::current_process_id();
1034 // Hotspot-specific counters
1035 case JMM_CLASS_LOADED_BYTES:
1036 return ClassLoadingService::loaded_class_bytes();
1038 case JMM_CLASS_UNLOADED_BYTES:
1039 return ClassLoadingService::unloaded_class_bytes();
1041 case JMM_SHARED_CLASS_LOADED_COUNT:
1042 return ClassLoadingService::loaded_shared_class_count();
1044 case JMM_SHARED_CLASS_UNLOADED_COUNT:
1045 return ClassLoadingService::unloaded_shared_class_count();
1048 case JMM_SHARED_CLASS_LOADED_BYTES:
1049 return ClassLoadingService::loaded_shared_class_bytes();
1051 case JMM_SHARED_CLASS_UNLOADED_BYTES:
1052 return ClassLoadingService::unloaded_shared_class_bytes();
1054 case JMM_TOTAL_CLASSLOAD_TIME_MS:
1055 return ClassLoader::classloader_time_ms();
1057 case JMM_VM_GLOBAL_COUNT:
1058 return get_num_flags();
1060 case JMM_SAFEPOINT_COUNT:
1061 return RuntimeService::safepoint_count();
1063 case JMM_TOTAL_SAFEPOINTSYNC_TIME_MS:
1064 return RuntimeService::safepoint_sync_time_ms();
1066 case JMM_TOTAL_STOPPED_TIME_MS:
1067 return RuntimeService::safepoint_time_ms();
1069 case JMM_TOTAL_APP_TIME_MS:
1070 return RuntimeService::application_time_ms();
1072 case JMM_VM_THREAD_COUNT:
1073 return get_vm_thread_count();
1075 case JMM_CLASS_INIT_TOTAL_COUNT:
1076 return ClassLoader::class_init_count();
1078 case JMM_CLASS_INIT_TOTAL_TIME_MS:
1079 return ClassLoader::class_init_time_ms();
1081 case JMM_CLASS_VERIFY_TOTAL_TIME_MS:
1082 return ClassLoader::class_verify_time_ms();
1084 case JMM_METHOD_DATA_SIZE_BYTES:
1085 return ClassLoadingService::class_method_data_size();
1087 case JMM_OS_MEM_TOTAL_PHYSICAL_BYTES:
1088 return os::physical_memory();
1090 default:
1091 return -1;
1092 }
1093 }
1096 // Returns the long value of a given attribute.
1097 JVM_ENTRY(jlong, jmm_GetLongAttribute(JNIEnv *env, jobject obj, jmmLongAttribute att))
1098 if (obj == NULL) {
1099 return get_long_attribute(att);
1100 } else {
1101 GCMemoryManager* mgr = get_gc_memory_manager_from_jobject(obj, CHECK_(0L));
1102 if (mgr != NULL) {
1103 return get_gc_attribute(mgr, att);
1104 }
1105 }
1106 return -1;
1107 JVM_END
1109 // Gets the value of all attributes specified in the given array
1110 // and sets the value in the result array.
1111 // Returns the number of attributes found.
1112 JVM_ENTRY(jint, jmm_GetLongAttributes(JNIEnv *env,
1113 jobject obj,
1114 jmmLongAttribute* atts,
1115 jint count,
1116 jlong* result))
1118 int num_atts = 0;
1119 if (obj == NULL) {
1120 for (int i = 0; i < count; i++) {
1121 result[i] = get_long_attribute(atts[i]);
1122 if (result[i] != -1) {
1123 num_atts++;
1124 }
1125 }
1126 } else {
1127 GCMemoryManager* mgr = get_gc_memory_manager_from_jobject(obj, CHECK_0);
1128 for (int i = 0; i < count; i++) {
1129 result[i] = get_gc_attribute(mgr, atts[i]);
1130 if (result[i] != -1) {
1131 num_atts++;
1132 }
1133 }
1134 }
1135 return num_atts;
1136 JVM_END
1138 // Helper function to do thread dump for a specific list of threads
1139 static void do_thread_dump(ThreadDumpResult* dump_result,
1140 typeArrayHandle ids_ah, // array of thread ID (long[])
1141 int num_threads,
1142 int max_depth,
1143 bool with_locked_monitors,
1144 bool with_locked_synchronizers,
1145 TRAPS) {
1147 // First get an array of threadObj handles.
1148 // A JavaThread may terminate before we get the stack trace.
1149 GrowableArray<instanceHandle>* thread_handle_array = new GrowableArray<instanceHandle>(num_threads);
1150 {
1151 MutexLockerEx ml(Threads_lock);
1152 for (int i = 0; i < num_threads; i++) {
1153 jlong tid = ids_ah->long_at(i);
1154 JavaThread* jt = find_java_thread_from_id(tid);
1155 oop thread_obj = (jt != NULL ? jt->threadObj() : (oop)NULL);
1156 instanceHandle threadObj_h(THREAD, (instanceOop) thread_obj);
1157 thread_handle_array->append(threadObj_h);
1158 }
1159 }
1161 // Obtain thread dumps and thread snapshot information
1162 VM_ThreadDump op(dump_result,
1163 thread_handle_array,
1164 num_threads,
1165 max_depth, /* stack depth */
1166 with_locked_monitors,
1167 with_locked_synchronizers);
1168 VMThread::execute(&op);
1169 }
1171 // Gets an array of ThreadInfo objects. Each element is the ThreadInfo
1172 // for the thread ID specified in the corresponding entry in
1173 // the given array of thread IDs; or NULL if the thread does not exist
1174 // or has terminated.
1175 //
1176 // Input parameters:
1177 // ids - array of thread IDs
1178 // maxDepth - the maximum depth of stack traces to be dumped:
1179 // maxDepth == -1 requests to dump entire stack trace.
1180 // maxDepth == 0 requests no stack trace.
1181 // infoArray - array of ThreadInfo objects
1182 //
1183 // QQQ - Why does this method return a value instead of void?
1184 JVM_ENTRY(jint, jmm_GetThreadInfo(JNIEnv *env, jlongArray ids, jint maxDepth, jobjectArray infoArray))
1185 // Check if threads is null
1186 if (ids == NULL || infoArray == NULL) {
1187 THROW_(vmSymbols::java_lang_NullPointerException(), -1);
1188 }
1190 if (maxDepth < -1) {
1191 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
1192 "Invalid maxDepth", -1);
1193 }
1195 ResourceMark rm(THREAD);
1196 typeArrayOop ta = typeArrayOop(JNIHandles::resolve_non_null(ids));
1197 typeArrayHandle ids_ah(THREAD, ta);
1199 oop infoArray_obj = JNIHandles::resolve_non_null(infoArray);
1200 objArrayOop oa = objArrayOop(infoArray_obj);
1201 objArrayHandle infoArray_h(THREAD, oa);
1203 // validate the thread id array
1204 validate_thread_id_array(ids_ah, CHECK_0);
1206 // validate the ThreadInfo[] parameters
1207 validate_thread_info_array(infoArray_h, CHECK_0);
1209 // infoArray must be of the same length as the given array of thread IDs
1210 int num_threads = ids_ah->length();
1211 if (num_threads != infoArray_h->length()) {
1212 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
1213 "The length of the given ThreadInfo array does not match the length of the given array of thread IDs", -1);
1214 }
1216 if (JDK_Version::is_gte_jdk16x_version()) {
1217 // make sure the AbstractOwnableSynchronizer klass is loaded before taking thread snapshots
1218 java_util_concurrent_locks_AbstractOwnableSynchronizer::initialize(CHECK_0);
1219 }
1221 // Must use ThreadDumpResult to store the ThreadSnapshot.
1222 // GC may occur after the thread snapshots are taken but before
1223 // this function returns. The threadObj and other oops kept
1224 // in the ThreadSnapshot are marked and adjusted during GC.
1225 ThreadDumpResult dump_result(num_threads);
1227 if (maxDepth == 0) {
1228 // no stack trace dumped - do not need to stop the world
1229 {
1230 MutexLockerEx ml(Threads_lock);
1231 for (int i = 0; i < num_threads; i++) {
1232 jlong tid = ids_ah->long_at(i);
1233 JavaThread* jt = find_java_thread_from_id(tid);
1234 ThreadSnapshot* ts;
1235 if (jt == NULL) {
1236 // if the thread does not exist or now it is terminated,
1237 // create dummy snapshot
1238 ts = new ThreadSnapshot();
1239 } else {
1240 ts = new ThreadSnapshot(jt);
1241 }
1242 dump_result.add_thread_snapshot(ts);
1243 }
1244 }
1245 } else {
1246 // obtain thread dump with the specific list of threads with stack trace
1247 do_thread_dump(&dump_result,
1248 ids_ah,
1249 num_threads,
1250 maxDepth,
1251 false, /* no locked monitor */
1252 false, /* no locked synchronizers */
1253 CHECK_0);
1254 }
1256 int num_snapshots = dump_result.num_snapshots();
1257 assert(num_snapshots == num_threads, "Must match the number of thread snapshots");
1258 int index = 0;
1259 for (ThreadSnapshot* ts = dump_result.snapshots(); ts != NULL; index++, ts = ts->next()) {
1260 // For each thread, create an java/lang/management/ThreadInfo object
1261 // and fill with the thread information
1263 if (ts->threadObj() == NULL) {
1264 // if the thread does not exist or now it is terminated, set threadinfo to NULL
1265 infoArray_h->obj_at_put(index, NULL);
1266 continue;
1267 }
1269 // Create java.lang.management.ThreadInfo object
1270 instanceOop info_obj = Management::create_thread_info_instance(ts, CHECK_0);
1271 infoArray_h->obj_at_put(index, info_obj);
1272 }
1273 return 0;
1274 JVM_END
1276 // Dump thread info for the specified threads.
1277 // It returns an array of ThreadInfo objects. Each element is the ThreadInfo
1278 // for the thread ID specified in the corresponding entry in
1279 // the given array of thread IDs; or NULL if the thread does not exist
1280 // or has terminated.
1281 //
1282 // Input parameter:
1283 // ids - array of thread IDs; NULL indicates all live threads
1284 // locked_monitors - if true, dump locked object monitors
1285 // locked_synchronizers - if true, dump locked JSR-166 synchronizers
1286 //
1287 JVM_ENTRY(jobjectArray, jmm_DumpThreads(JNIEnv *env, jlongArray thread_ids, jboolean locked_monitors, jboolean locked_synchronizers))
1288 ResourceMark rm(THREAD);
1290 if (JDK_Version::is_gte_jdk16x_version()) {
1291 // make sure the AbstractOwnableSynchronizer klass is loaded before taking thread snapshots
1292 java_util_concurrent_locks_AbstractOwnableSynchronizer::initialize(CHECK_NULL);
1293 }
1295 typeArrayOop ta = typeArrayOop(JNIHandles::resolve(thread_ids));
1296 int num_threads = (ta != NULL ? ta->length() : 0);
1297 typeArrayHandle ids_ah(THREAD, ta);
1299 ThreadDumpResult dump_result(num_threads); // can safepoint
1301 if (ids_ah() != NULL) {
1303 // validate the thread id array
1304 validate_thread_id_array(ids_ah, CHECK_NULL);
1306 // obtain thread dump of a specific list of threads
1307 do_thread_dump(&dump_result,
1308 ids_ah,
1309 num_threads,
1310 -1, /* entire stack */
1311 (locked_monitors ? true : false), /* with locked monitors */
1312 (locked_synchronizers ? true : false), /* with locked synchronizers */
1313 CHECK_NULL);
1314 } else {
1315 // obtain thread dump of all threads
1316 VM_ThreadDump op(&dump_result,
1317 -1, /* entire stack */
1318 (locked_monitors ? true : false), /* with locked monitors */
1319 (locked_synchronizers ? true : false) /* with locked synchronizers */);
1320 VMThread::execute(&op);
1321 }
1323 int num_snapshots = dump_result.num_snapshots();
1325 // create the result ThreadInfo[] object
1326 Klass* k = Management::java_lang_management_ThreadInfo_klass(CHECK_NULL);
1327 instanceKlassHandle ik (THREAD, k);
1328 objArrayOop r = oopFactory::new_objArray(ik(), num_snapshots, CHECK_NULL);
1329 objArrayHandle result_h(THREAD, r);
1331 int index = 0;
1332 for (ThreadSnapshot* ts = dump_result.snapshots(); ts != NULL; ts = ts->next(), index++) {
1333 if (ts->threadObj() == NULL) {
1334 // if the thread does not exist or now it is terminated, set threadinfo to NULL
1335 result_h->obj_at_put(index, NULL);
1336 continue;
1337 }
1339 ThreadStackTrace* stacktrace = ts->get_stack_trace();
1340 assert(stacktrace != NULL, "Must have a stack trace dumped");
1342 // Create Object[] filled with locked monitors
1343 // Create int[] filled with the stack depth where a monitor was locked
1344 int num_frames = stacktrace->get_stack_depth();
1345 int num_locked_monitors = stacktrace->num_jni_locked_monitors();
1347 // Count the total number of locked monitors
1348 for (int i = 0; i < num_frames; i++) {
1349 StackFrameInfo* frame = stacktrace->stack_frame_at(i);
1350 num_locked_monitors += frame->num_locked_monitors();
1351 }
1353 objArrayHandle monitors_array;
1354 typeArrayHandle depths_array;
1355 objArrayHandle synchronizers_array;
1357 if (locked_monitors) {
1358 // Constructs Object[] and int[] to contain the object monitor and the stack depth
1359 // where the thread locked it
1360 objArrayOop array = oopFactory::new_objArray(SystemDictionary::Object_klass(), num_locked_monitors, CHECK_NULL);
1361 objArrayHandle mh(THREAD, array);
1362 monitors_array = mh;
1364 typeArrayOop tarray = oopFactory::new_typeArray(T_INT, num_locked_monitors, CHECK_NULL);
1365 typeArrayHandle dh(THREAD, tarray);
1366 depths_array = dh;
1368 int count = 0;
1369 int j = 0;
1370 for (int depth = 0; depth < num_frames; depth++) {
1371 StackFrameInfo* frame = stacktrace->stack_frame_at(depth);
1372 int len = frame->num_locked_monitors();
1373 GrowableArray<oop>* locked_monitors = frame->locked_monitors();
1374 for (j = 0; j < len; j++) {
1375 oop monitor = locked_monitors->at(j);
1376 assert(monitor != NULL && monitor->is_instance(), "must be a Java object");
1377 monitors_array->obj_at_put(count, monitor);
1378 depths_array->int_at_put(count, depth);
1379 count++;
1380 }
1381 }
1383 GrowableArray<oop>* jni_locked_monitors = stacktrace->jni_locked_monitors();
1384 for (j = 0; j < jni_locked_monitors->length(); j++) {
1385 oop object = jni_locked_monitors->at(j);
1386 assert(object != NULL && object->is_instance(), "must be a Java object");
1387 monitors_array->obj_at_put(count, object);
1388 // Monitor locked via JNI MonitorEnter call doesn't have stack depth info
1389 depths_array->int_at_put(count, -1);
1390 count++;
1391 }
1392 assert(count == num_locked_monitors, "number of locked monitors doesn't match");
1393 }
1395 if (locked_synchronizers) {
1396 // Create Object[] filled with locked JSR-166 synchronizers
1397 assert(ts->threadObj() != NULL, "Must be a valid JavaThread");
1398 ThreadConcurrentLocks* tcl = ts->get_concurrent_locks();
1399 GrowableArray<instanceOop>* locks = (tcl != NULL ? tcl->owned_locks() : NULL);
1400 int num_locked_synchronizers = (locks != NULL ? locks->length() : 0);
1402 objArrayOop array = oopFactory::new_objArray(SystemDictionary::Object_klass(), num_locked_synchronizers, CHECK_NULL);
1403 objArrayHandle sh(THREAD, array);
1404 synchronizers_array = sh;
1406 for (int k = 0; k < num_locked_synchronizers; k++) {
1407 synchronizers_array->obj_at_put(k, locks->at(k));
1408 }
1409 }
1411 // Create java.lang.management.ThreadInfo object
1412 instanceOop info_obj = Management::create_thread_info_instance(ts,
1413 monitors_array,
1414 depths_array,
1415 synchronizers_array,
1416 CHECK_NULL);
1417 result_h->obj_at_put(index, info_obj);
1418 }
1420 return (jobjectArray) JNIHandles::make_local(env, result_h());
1421 JVM_END
1423 // Returns an array of Class objects.
1424 JVM_ENTRY(jobjectArray, jmm_GetLoadedClasses(JNIEnv *env))
1425 ResourceMark rm(THREAD);
1427 LoadedClassesEnumerator lce(THREAD); // Pass current Thread as parameter
1429 int num_classes = lce.num_loaded_classes();
1430 objArrayOop r = oopFactory::new_objArray(SystemDictionary::Class_klass(), num_classes, CHECK_0);
1431 objArrayHandle classes_ah(THREAD, r);
1433 for (int i = 0; i < num_classes; i++) {
1434 KlassHandle kh = lce.get_klass(i);
1435 oop mirror = kh()->java_mirror();
1436 classes_ah->obj_at_put(i, mirror);
1437 }
1439 return (jobjectArray) JNIHandles::make_local(env, classes_ah());
1440 JVM_END
1442 // Reset statistic. Return true if the requested statistic is reset.
1443 // Otherwise, return false.
1444 //
1445 // Input parameters:
1446 // obj - specify which instance the statistic associated with to be reset
1447 // For PEAK_POOL_USAGE stat, obj is required to be a memory pool object.
1448 // For THREAD_CONTENTION_COUNT and TIME stat, obj is required to be a thread ID.
1449 // type - the type of statistic to be reset
1450 //
1451 JVM_ENTRY(jboolean, jmm_ResetStatistic(JNIEnv *env, jvalue obj, jmmStatisticType type))
1452 ResourceMark rm(THREAD);
1454 switch (type) {
1455 case JMM_STAT_PEAK_THREAD_COUNT:
1456 ThreadService::reset_peak_thread_count();
1457 return true;
1459 case JMM_STAT_THREAD_CONTENTION_COUNT:
1460 case JMM_STAT_THREAD_CONTENTION_TIME: {
1461 jlong tid = obj.j;
1462 if (tid < 0) {
1463 THROW_(vmSymbols::java_lang_IllegalArgumentException(), JNI_FALSE);
1464 }
1466 // Look for the JavaThread of this given tid
1467 MutexLockerEx ml(Threads_lock);
1468 if (tid == 0) {
1469 // reset contention statistics for all threads if tid == 0
1470 for (JavaThread* java_thread = Threads::first(); java_thread != NULL; java_thread = java_thread->next()) {
1471 if (type == JMM_STAT_THREAD_CONTENTION_COUNT) {
1472 ThreadService::reset_contention_count_stat(java_thread);
1473 } else {
1474 ThreadService::reset_contention_time_stat(java_thread);
1475 }
1476 }
1477 } else {
1478 // reset contention statistics for a given thread
1479 JavaThread* java_thread = find_java_thread_from_id(tid);
1480 if (java_thread == NULL) {
1481 return false;
1482 }
1484 if (type == JMM_STAT_THREAD_CONTENTION_COUNT) {
1485 ThreadService::reset_contention_count_stat(java_thread);
1486 } else {
1487 ThreadService::reset_contention_time_stat(java_thread);
1488 }
1489 }
1490 return true;
1491 break;
1492 }
1493 case JMM_STAT_PEAK_POOL_USAGE: {
1494 jobject o = obj.l;
1495 if (o == NULL) {
1496 THROW_(vmSymbols::java_lang_NullPointerException(), JNI_FALSE);
1497 }
1499 oop pool_obj = JNIHandles::resolve(o);
1500 assert(pool_obj->is_instance(), "Should be an instanceOop");
1501 instanceHandle ph(THREAD, (instanceOop) pool_obj);
1503 MemoryPool* pool = MemoryService::get_memory_pool(ph);
1504 if (pool != NULL) {
1505 pool->reset_peak_memory_usage();
1506 return true;
1507 }
1508 break;
1509 }
1510 case JMM_STAT_GC_STAT: {
1511 jobject o = obj.l;
1512 if (o == NULL) {
1513 THROW_(vmSymbols::java_lang_NullPointerException(), JNI_FALSE);
1514 }
1516 GCMemoryManager* mgr = get_gc_memory_manager_from_jobject(o, CHECK_0);
1517 if (mgr != NULL) {
1518 mgr->reset_gc_stat();
1519 return true;
1520 }
1521 break;
1522 }
1523 default:
1524 assert(0, "Unknown Statistic Type");
1525 }
1526 return false;
1527 JVM_END
1529 // Returns the fast estimate of CPU time consumed by
1530 // a given thread (in nanoseconds).
1531 // If thread_id == 0, return CPU time for the current thread.
1532 JVM_ENTRY(jlong, jmm_GetThreadCpuTime(JNIEnv *env, jlong thread_id))
1533 if (!os::is_thread_cpu_time_supported()) {
1534 return -1;
1535 }
1537 if (thread_id < 0) {
1538 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
1539 "Invalid thread ID", -1);
1540 }
1542 JavaThread* java_thread = NULL;
1543 if (thread_id == 0) {
1544 // current thread
1545 return os::current_thread_cpu_time();
1546 } else {
1547 MutexLockerEx ml(Threads_lock);
1548 java_thread = find_java_thread_from_id(thread_id);
1549 if (java_thread != NULL) {
1550 return os::thread_cpu_time((Thread*) java_thread);
1551 }
1552 }
1553 return -1;
1554 JVM_END
1556 // Returns the CPU time consumed by a given thread (in nanoseconds).
1557 // If thread_id == 0, CPU time for the current thread is returned.
1558 // If user_sys_cpu_time = true, user level and system CPU time of
1559 // a given thread is returned; otherwise, only user level CPU time
1560 // is returned.
1561 JVM_ENTRY(jlong, jmm_GetThreadCpuTimeWithKind(JNIEnv *env, jlong thread_id, jboolean user_sys_cpu_time))
1562 if (!os::is_thread_cpu_time_supported()) {
1563 return -1;
1564 }
1566 if (thread_id < 0) {
1567 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
1568 "Invalid thread ID", -1);
1569 }
1571 JavaThread* java_thread = NULL;
1572 if (thread_id == 0) {
1573 // current thread
1574 return os::current_thread_cpu_time(user_sys_cpu_time != 0);
1575 } else {
1576 MutexLockerEx ml(Threads_lock);
1577 java_thread = find_java_thread_from_id(thread_id);
1578 if (java_thread != NULL) {
1579 return os::thread_cpu_time((Thread*) java_thread, user_sys_cpu_time != 0);
1580 }
1581 }
1582 return -1;
1583 JVM_END
1585 // Gets an array containing the CPU times consumed by a set of threads
1586 // (in nanoseconds). Each element of the array is the CPU time for the
1587 // thread ID specified in the corresponding entry in the given array
1588 // of thread IDs; or -1 if the thread does not exist or has terminated.
1589 // If user_sys_cpu_time = true, the sum of user level and system CPU time
1590 // for the given thread is returned; otherwise, only user level CPU time
1591 // is returned.
1592 JVM_ENTRY(void, jmm_GetThreadCpuTimesWithKind(JNIEnv *env, jlongArray ids,
1593 jlongArray timeArray,
1594 jboolean user_sys_cpu_time))
1595 // Check if threads is null
1596 if (ids == NULL || timeArray == NULL) {
1597 THROW(vmSymbols::java_lang_NullPointerException());
1598 }
1600 ResourceMark rm(THREAD);
1601 typeArrayOop ta = typeArrayOop(JNIHandles::resolve_non_null(ids));
1602 typeArrayHandle ids_ah(THREAD, ta);
1604 typeArrayOop tia = typeArrayOop(JNIHandles::resolve_non_null(timeArray));
1605 typeArrayHandle timeArray_h(THREAD, tia);
1607 // validate the thread id array
1608 validate_thread_id_array(ids_ah, CHECK);
1610 // timeArray must be of the same length as the given array of thread IDs
1611 int num_threads = ids_ah->length();
1612 if (num_threads != timeArray_h->length()) {
1613 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
1614 "The length of the given long array does not match the length of "
1615 "the given array of thread IDs");
1616 }
1618 MutexLockerEx ml(Threads_lock);
1619 for (int i = 0; i < num_threads; i++) {
1620 JavaThread* java_thread = find_java_thread_from_id(ids_ah->long_at(i));
1621 if (java_thread != NULL) {
1622 timeArray_h->long_at_put(i, os::thread_cpu_time((Thread*)java_thread,
1623 user_sys_cpu_time != 0));
1624 }
1625 }
1626 JVM_END
1628 // Returns a String array of all VM global flag names
1629 JVM_ENTRY(jobjectArray, jmm_GetVMGlobalNames(JNIEnv *env))
1630 // last flag entry is always NULL, so subtract 1
1631 int nFlags = (int) Flag::numFlags - 1;
1632 // allocate a temp array
1633 objArrayOop r = oopFactory::new_objArray(SystemDictionary::String_klass(),
1634 nFlags, CHECK_0);
1635 objArrayHandle flags_ah(THREAD, r);
1636 int num_entries = 0;
1637 for (int i = 0; i < nFlags; i++) {
1638 Flag* flag = &Flag::flags[i];
1639 // Exclude the locked (experimental, diagnostic) flags
1640 if (flag->is_unlocked() || flag->is_unlocker()) {
1641 Handle s = java_lang_String::create_from_str(flag->name, CHECK_0);
1642 flags_ah->obj_at_put(num_entries, s());
1643 num_entries++;
1644 }
1645 }
1647 if (num_entries < nFlags) {
1648 // Return array of right length
1649 objArrayOop res = oopFactory::new_objArray(SystemDictionary::String_klass(), num_entries, CHECK_0);
1650 for(int i = 0; i < num_entries; i++) {
1651 res->obj_at_put(i, flags_ah->obj_at(i));
1652 }
1653 return (jobjectArray)JNIHandles::make_local(env, res);
1654 }
1656 return (jobjectArray)JNIHandles::make_local(env, flags_ah());
1657 JVM_END
1659 // Utility function used by jmm_GetVMGlobals. Returns false if flag type
1660 // can't be determined, true otherwise. If false is returned, then *global
1661 // will be incomplete and invalid.
1662 bool add_global_entry(JNIEnv* env, Handle name, jmmVMGlobal *global, Flag *flag, TRAPS) {
1663 Handle flag_name;
1664 if (name() == NULL) {
1665 flag_name = java_lang_String::create_from_str(flag->name, CHECK_false);
1666 } else {
1667 flag_name = name;
1668 }
1669 global->name = (jstring)JNIHandles::make_local(env, flag_name());
1671 if (flag->is_bool()) {
1672 global->value.z = flag->get_bool() ? JNI_TRUE : JNI_FALSE;
1673 global->type = JMM_VMGLOBAL_TYPE_JBOOLEAN;
1674 } else if (flag->is_intx()) {
1675 global->value.j = (jlong)flag->get_intx();
1676 global->type = JMM_VMGLOBAL_TYPE_JLONG;
1677 } else if (flag->is_uintx()) {
1678 global->value.j = (jlong)flag->get_uintx();
1679 global->type = JMM_VMGLOBAL_TYPE_JLONG;
1680 } else if (flag->is_uint64_t()) {
1681 global->value.j = (jlong)flag->get_uint64_t();
1682 global->type = JMM_VMGLOBAL_TYPE_JLONG;
1683 } else if (flag->is_ccstr()) {
1684 Handle str = java_lang_String::create_from_str(flag->get_ccstr(), CHECK_false);
1685 global->value.l = (jobject)JNIHandles::make_local(env, str());
1686 global->type = JMM_VMGLOBAL_TYPE_JSTRING;
1687 } else {
1688 global->type = JMM_VMGLOBAL_TYPE_UNKNOWN;
1689 return false;
1690 }
1692 global->writeable = flag->is_writeable();
1693 global->external = flag->is_external();
1694 switch (flag->origin) {
1695 case DEFAULT:
1696 global->origin = JMM_VMGLOBAL_ORIGIN_DEFAULT;
1697 break;
1698 case COMMAND_LINE:
1699 global->origin = JMM_VMGLOBAL_ORIGIN_COMMAND_LINE;
1700 break;
1701 case ENVIRON_VAR:
1702 global->origin = JMM_VMGLOBAL_ORIGIN_ENVIRON_VAR;
1703 break;
1704 case CONFIG_FILE:
1705 global->origin = JMM_VMGLOBAL_ORIGIN_CONFIG_FILE;
1706 break;
1707 case MANAGEMENT:
1708 global->origin = JMM_VMGLOBAL_ORIGIN_MANAGEMENT;
1709 break;
1710 case ERGONOMIC:
1711 global->origin = JMM_VMGLOBAL_ORIGIN_ERGONOMIC;
1712 break;
1713 default:
1714 global->origin = JMM_VMGLOBAL_ORIGIN_OTHER;
1715 }
1717 return true;
1718 }
1720 // Fill globals array of count length with jmmVMGlobal entries
1721 // specified by names. If names == NULL, fill globals array
1722 // with all Flags. Return value is number of entries
1723 // created in globals.
1724 // If a Flag with a given name in an array element does not
1725 // exist, globals[i].name will be set to NULL.
1726 JVM_ENTRY(jint, jmm_GetVMGlobals(JNIEnv *env,
1727 jobjectArray names,
1728 jmmVMGlobal *globals,
1729 jint count))
1732 if (globals == NULL) {
1733 THROW_(vmSymbols::java_lang_NullPointerException(), 0);
1734 }
1736 ResourceMark rm(THREAD);
1738 if (names != NULL) {
1739 // return the requested globals
1740 objArrayOop ta = objArrayOop(JNIHandles::resolve_non_null(names));
1741 objArrayHandle names_ah(THREAD, ta);
1742 // Make sure we have a String array
1743 Klass* element_klass = ObjArrayKlass::cast(names_ah->klass())->element_klass();
1744 if (element_klass != SystemDictionary::String_klass()) {
1745 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
1746 "Array element type is not String class", 0);
1747 }
1749 int names_length = names_ah->length();
1750 int num_entries = 0;
1751 for (int i = 0; i < names_length && i < count; i++) {
1752 oop s = names_ah->obj_at(i);
1753 if (s == NULL) {
1754 THROW_(vmSymbols::java_lang_NullPointerException(), 0);
1755 }
1757 Handle sh(THREAD, s);
1758 char* str = java_lang_String::as_utf8_string(s);
1759 Flag* flag = Flag::find_flag(str, strlen(str));
1760 if (flag != NULL &&
1761 add_global_entry(env, sh, &globals[i], flag, THREAD)) {
1762 num_entries++;
1763 } else {
1764 globals[i].name = NULL;
1765 }
1766 }
1767 return num_entries;
1768 } else {
1769 // return all globals if names == NULL
1771 // last flag entry is always NULL, so subtract 1
1772 int nFlags = (int) Flag::numFlags - 1;
1773 Handle null_h;
1774 int num_entries = 0;
1775 for (int i = 0; i < nFlags && num_entries < count; i++) {
1776 Flag* flag = &Flag::flags[i];
1777 // Exclude the locked (diagnostic, experimental) flags
1778 if ((flag->is_unlocked() || flag->is_unlocker()) &&
1779 add_global_entry(env, null_h, &globals[num_entries], flag, THREAD)) {
1780 num_entries++;
1781 }
1782 }
1783 return num_entries;
1784 }
1785 JVM_END
1787 JVM_ENTRY(void, jmm_SetVMGlobal(JNIEnv *env, jstring flag_name, jvalue new_value))
1788 ResourceMark rm(THREAD);
1790 oop fn = JNIHandles::resolve_external_guard(flag_name);
1791 if (fn == NULL) {
1792 THROW_MSG(vmSymbols::java_lang_NullPointerException(),
1793 "The flag name cannot be null.");
1794 }
1795 char* name = java_lang_String::as_utf8_string(fn);
1796 Flag* flag = Flag::find_flag(name, strlen(name));
1797 if (flag == NULL) {
1798 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
1799 "Flag does not exist.");
1800 }
1801 if (!flag->is_writeable()) {
1802 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
1803 "This flag is not writeable.");
1804 }
1806 bool succeed;
1807 if (flag->is_bool()) {
1808 bool bvalue = (new_value.z == JNI_TRUE ? true : false);
1809 succeed = CommandLineFlags::boolAtPut(name, &bvalue, MANAGEMENT);
1810 } else if (flag->is_intx()) {
1811 intx ivalue = (intx)new_value.j;
1812 succeed = CommandLineFlags::intxAtPut(name, &ivalue, MANAGEMENT);
1813 } else if (flag->is_uintx()) {
1814 uintx uvalue = (uintx)new_value.j;
1815 succeed = CommandLineFlags::uintxAtPut(name, &uvalue, MANAGEMENT);
1816 } else if (flag->is_uint64_t()) {
1817 uint64_t uvalue = (uint64_t)new_value.j;
1818 succeed = CommandLineFlags::uint64_tAtPut(name, &uvalue, MANAGEMENT);
1819 } else if (flag->is_ccstr()) {
1820 oop str = JNIHandles::resolve_external_guard(new_value.l);
1821 if (str == NULL) {
1822 THROW(vmSymbols::java_lang_NullPointerException());
1823 }
1824 ccstr svalue = java_lang_String::as_utf8_string(str);
1825 succeed = CommandLineFlags::ccstrAtPut(name, &svalue, MANAGEMENT);
1826 }
1827 assert(succeed, "Setting flag should succeed");
1828 JVM_END
1830 class ThreadTimesClosure: public ThreadClosure {
1831 private:
1832 objArrayHandle _names_strings;
1833 char **_names_chars;
1834 typeArrayHandle _times;
1835 int _names_len;
1836 int _times_len;
1837 int _count;
1839 public:
1840 ThreadTimesClosure(objArrayHandle names, typeArrayHandle times);
1841 ~ThreadTimesClosure();
1842 virtual void do_thread(Thread* thread);
1843 void do_unlocked();
1844 int count() { return _count; }
1845 };
1847 ThreadTimesClosure::ThreadTimesClosure(objArrayHandle names,
1848 typeArrayHandle times) {
1849 assert(names() != NULL, "names was NULL");
1850 assert(times() != NULL, "times was NULL");
1851 _names_strings = names;
1852 _names_len = names->length();
1853 _names_chars = NEW_C_HEAP_ARRAY(char*, _names_len, mtInternal);
1854 _times = times;
1855 _times_len = times->length();
1856 _count = 0;
1857 }
1859 //
1860 // Called with Threads_lock held
1861 //
1862 void ThreadTimesClosure::do_thread(Thread* thread) {
1863 assert(thread != NULL, "thread was NULL");
1865 // exclude externally visible JavaThreads
1866 if (thread->is_Java_thread() && !thread->is_hidden_from_external_view()) {
1867 return;
1868 }
1870 if (_count >= _names_len || _count >= _times_len) {
1871 // skip if the result array is not big enough
1872 return;
1873 }
1875 EXCEPTION_MARK;
1876 ResourceMark rm(THREAD); // thread->name() uses ResourceArea
1878 assert(thread->name() != NULL, "All threads should have a name");
1879 _names_chars[_count] = strdup(thread->name());
1880 _times->long_at_put(_count, os::is_thread_cpu_time_supported() ?
1881 os::thread_cpu_time(thread) : -1);
1882 _count++;
1883 }
1885 // Called without Threads_lock, we can allocate String objects.
1886 void ThreadTimesClosure::do_unlocked() {
1888 EXCEPTION_MARK;
1889 for (int i = 0; i < _count; i++) {
1890 Handle s = java_lang_String::create_from_str(_names_chars[i], CHECK);
1891 _names_strings->obj_at_put(i, s());
1892 }
1893 }
1895 ThreadTimesClosure::~ThreadTimesClosure() {
1896 for (int i = 0; i < _count; i++) {
1897 free(_names_chars[i]);
1898 }
1899 FREE_C_HEAP_ARRAY(char *, _names_chars, mtInternal);
1900 }
1902 // Fills names with VM internal thread names and times with the corresponding
1903 // CPU times. If names or times is NULL, a NullPointerException is thrown.
1904 // If the element type of names is not String, an IllegalArgumentException is
1905 // thrown.
1906 // If an array is not large enough to hold all the entries, only the entries
1907 // that fit will be returned. Return value is the number of VM internal
1908 // threads entries.
1909 JVM_ENTRY(jint, jmm_GetInternalThreadTimes(JNIEnv *env,
1910 jobjectArray names,
1911 jlongArray times))
1912 if (names == NULL || times == NULL) {
1913 THROW_(vmSymbols::java_lang_NullPointerException(), 0);
1914 }
1915 objArrayOop na = objArrayOop(JNIHandles::resolve_non_null(names));
1916 objArrayHandle names_ah(THREAD, na);
1918 // Make sure we have a String array
1919 Klass* element_klass = ObjArrayKlass::cast(names_ah->klass())->element_klass();
1920 if (element_klass != SystemDictionary::String_klass()) {
1921 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
1922 "Array element type is not String class", 0);
1923 }
1925 typeArrayOop ta = typeArrayOop(JNIHandles::resolve_non_null(times));
1926 typeArrayHandle times_ah(THREAD, ta);
1928 ThreadTimesClosure ttc(names_ah, times_ah);
1929 {
1930 MutexLockerEx ml(Threads_lock);
1931 Threads::threads_do(&ttc);
1932 }
1933 ttc.do_unlocked();
1934 return ttc.count();
1935 JVM_END
1937 static Handle find_deadlocks(bool object_monitors_only, TRAPS) {
1938 ResourceMark rm(THREAD);
1940 VM_FindDeadlocks op(!object_monitors_only /* also check concurrent locks? */);
1941 VMThread::execute(&op);
1943 DeadlockCycle* deadlocks = op.result();
1944 if (deadlocks == NULL) {
1945 // no deadlock found and return
1946 return Handle();
1947 }
1949 int num_threads = 0;
1950 DeadlockCycle* cycle;
1951 for (cycle = deadlocks; cycle != NULL; cycle = cycle->next()) {
1952 num_threads += cycle->num_threads();
1953 }
1955 objArrayOop r = oopFactory::new_objArray(SystemDictionary::Thread_klass(), num_threads, CHECK_NH);
1956 objArrayHandle threads_ah(THREAD, r);
1958 int index = 0;
1959 for (cycle = deadlocks; cycle != NULL; cycle = cycle->next()) {
1960 GrowableArray<JavaThread*>* deadlock_threads = cycle->threads();
1961 int len = deadlock_threads->length();
1962 for (int i = 0; i < len; i++) {
1963 threads_ah->obj_at_put(index, deadlock_threads->at(i)->threadObj());
1964 index++;
1965 }
1966 }
1967 return threads_ah;
1968 }
1970 // Finds cycles of threads that are deadlocked involved in object monitors
1971 // and JSR-166 synchronizers.
1972 // Returns an array of Thread objects which are in deadlock, if any.
1973 // Otherwise, returns NULL.
1974 //
1975 // Input parameter:
1976 // object_monitors_only - if true, only check object monitors
1977 //
1978 JVM_ENTRY(jobjectArray, jmm_FindDeadlockedThreads(JNIEnv *env, jboolean object_monitors_only))
1979 Handle result = find_deadlocks(object_monitors_only != 0, CHECK_0);
1980 return (jobjectArray) JNIHandles::make_local(env, result());
1981 JVM_END
1983 // Finds cycles of threads that are deadlocked on monitor locks
1984 // Returns an array of Thread objects which are in deadlock, if any.
1985 // Otherwise, returns NULL.
1986 JVM_ENTRY(jobjectArray, jmm_FindMonitorDeadlockedThreads(JNIEnv *env))
1987 Handle result = find_deadlocks(true, CHECK_0);
1988 return (jobjectArray) JNIHandles::make_local(env, result());
1989 JVM_END
1991 // Gets the information about GC extension attributes including
1992 // the name of the attribute, its type, and a short description.
1993 //
1994 // Input parameters:
1995 // mgr - GC memory manager
1996 // info - caller allocated array of jmmExtAttributeInfo
1997 // count - number of elements of the info array
1998 //
1999 // Returns the number of GC extension attributes filled in the info array; or
2000 // -1 if info is not big enough
2001 //
2002 JVM_ENTRY(jint, jmm_GetGCExtAttributeInfo(JNIEnv *env, jobject mgr, jmmExtAttributeInfo* info, jint count))
2003 // All GC memory managers have 1 attribute (number of GC threads)
2004 if (count == 0) {
2005 return 0;
2006 }
2008 if (info == NULL) {
2009 THROW_(vmSymbols::java_lang_NullPointerException(), 0);
2010 }
2012 info[0].name = "GcThreadCount";
2013 info[0].type = 'I';
2014 info[0].description = "Number of GC threads";
2015 return 1;
2016 JVM_END
2018 // verify the given array is an array of java/lang/management/MemoryUsage objects
2019 // of a given length and return the objArrayOop
2020 static objArrayOop get_memory_usage_objArray(jobjectArray array, int length, TRAPS) {
2021 if (array == NULL) {
2022 THROW_(vmSymbols::java_lang_NullPointerException(), 0);
2023 }
2025 objArrayOop oa = objArrayOop(JNIHandles::resolve_non_null(array));
2026 objArrayHandle array_h(THREAD, oa);
2028 // array must be of the given length
2029 if (length != array_h->length()) {
2030 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
2031 "The length of the given MemoryUsage array does not match the number of memory pools.", 0);
2032 }
2034 // check if the element of array is of type MemoryUsage class
2035 Klass* usage_klass = Management::java_lang_management_MemoryUsage_klass(CHECK_0);
2036 Klass* element_klass = ObjArrayKlass::cast(array_h->klass())->element_klass();
2037 if (element_klass != usage_klass) {
2038 THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(),
2039 "The element type is not MemoryUsage class", 0);
2040 }
2042 return array_h();
2043 }
2045 // Gets the statistics of the last GC of a given GC memory manager.
2046 // Input parameters:
2047 // obj - GarbageCollectorMXBean object
2048 // gc_stat - caller allocated jmmGCStat where:
2049 // a. before_gc_usage - array of MemoryUsage objects
2050 // b. after_gc_usage - array of MemoryUsage objects
2051 // c. gc_ext_attributes_values_size is set to the
2052 // gc_ext_attribute_values array allocated
2053 // d. gc_ext_attribute_values is a caller allocated array of jvalue.
2054 //
2055 // On return,
2056 // gc_index == 0 indicates no GC statistics available
2057 //
2058 // before_gc_usage and after_gc_usage - filled with per memory pool
2059 // before and after GC usage in the same order as the memory pools
2060 // returned by GetMemoryPools for a given GC memory manager.
2061 // num_gc_ext_attributes indicates the number of elements in
2062 // the gc_ext_attribute_values array is filled; or
2063 // -1 if the gc_ext_attributes_values array is not big enough
2064 //
2065 JVM_ENTRY(void, jmm_GetLastGCStat(JNIEnv *env, jobject obj, jmmGCStat *gc_stat))
2066 ResourceMark rm(THREAD);
2068 if (gc_stat->gc_ext_attribute_values_size > 0 && gc_stat->gc_ext_attribute_values == NULL) {
2069 THROW(vmSymbols::java_lang_NullPointerException());
2070 }
2072 // Get the GCMemoryManager
2073 GCMemoryManager* mgr = get_gc_memory_manager_from_jobject(obj, CHECK);
2075 // Make a copy of the last GC statistics
2076 // GC may occur while constructing the last GC information
2077 int num_pools = MemoryService::num_memory_pools();
2078 GCStatInfo stat(num_pools);
2079 if (mgr->get_last_gc_stat(&stat) == 0) {
2080 gc_stat->gc_index = 0;
2081 return;
2082 }
2084 gc_stat->gc_index = stat.gc_index();
2085 gc_stat->start_time = Management::ticks_to_ms(stat.start_time());
2086 gc_stat->end_time = Management::ticks_to_ms(stat.end_time());
2088 // Current implementation does not have GC extension attributes
2089 gc_stat->num_gc_ext_attributes = 0;
2091 // Fill the arrays of MemoryUsage objects with before and after GC
2092 // per pool memory usage
2093 objArrayOop bu = get_memory_usage_objArray(gc_stat->usage_before_gc,
2094 num_pools,
2095 CHECK);
2096 objArrayHandle usage_before_gc_ah(THREAD, bu);
2098 objArrayOop au = get_memory_usage_objArray(gc_stat->usage_after_gc,
2099 num_pools,
2100 CHECK);
2101 objArrayHandle usage_after_gc_ah(THREAD, au);
2103 for (int i = 0; i < num_pools; i++) {
2104 Handle before_usage = MemoryService::create_MemoryUsage_obj(stat.before_gc_usage_for_pool(i), CHECK);
2105 Handle after_usage;
2107 MemoryUsage u = stat.after_gc_usage_for_pool(i);
2108 if (u.max_size() == 0 && u.used() > 0) {
2109 // If max size == 0, this pool is a survivor space.
2110 // Set max size = -1 since the pools will be swapped after GC.
2111 MemoryUsage usage(u.init_size(), u.used(), u.committed(), (size_t)-1);
2112 after_usage = MemoryService::create_MemoryUsage_obj(usage, CHECK);
2113 } else {
2114 after_usage = MemoryService::create_MemoryUsage_obj(stat.after_gc_usage_for_pool(i), CHECK);
2115 }
2116 usage_before_gc_ah->obj_at_put(i, before_usage());
2117 usage_after_gc_ah->obj_at_put(i, after_usage());
2118 }
2120 if (gc_stat->gc_ext_attribute_values_size > 0) {
2121 // Current implementation only has 1 attribute (number of GC threads)
2122 // The type is 'I'
2123 gc_stat->gc_ext_attribute_values[0].i = mgr->num_gc_threads();
2124 }
2125 JVM_END
2127 JVM_ENTRY(void, jmm_SetGCNotificationEnabled(JNIEnv *env, jobject obj, jboolean enabled))
2128 ResourceMark rm(THREAD);
2129 // Get the GCMemoryManager
2130 GCMemoryManager* mgr = get_gc_memory_manager_from_jobject(obj, CHECK);
2131 mgr->set_notification_enabled(enabled?true:false);
2132 JVM_END
2134 // Dump heap - Returns 0 if succeeds.
2135 JVM_ENTRY(jint, jmm_DumpHeap0(JNIEnv *env, jstring outputfile, jboolean live))
2136 #if INCLUDE_SERVICES
2137 ResourceMark rm(THREAD);
2138 oop on = JNIHandles::resolve_external_guard(outputfile);
2139 if (on == NULL) {
2140 THROW_MSG_(vmSymbols::java_lang_NullPointerException(),
2141 "Output file name cannot be null.", -1);
2142 }
2143 char* name = java_lang_String::as_platform_dependent_str(on, CHECK_(-1));
2144 if (name == NULL) {
2145 THROW_MSG_(vmSymbols::java_lang_NullPointerException(),
2146 "Output file name cannot be null.", -1);
2147 }
2148 HeapDumper dumper(live ? true : false);
2149 if (dumper.dump(name) != 0) {
2150 const char* errmsg = dumper.error_as_C_string();
2151 THROW_MSG_(vmSymbols::java_io_IOException(), errmsg, -1);
2152 }
2153 return 0;
2154 #else // INCLUDE_SERVICES
2155 return -1;
2156 #endif // INCLUDE_SERVICES
2157 JVM_END
2159 JVM_ENTRY(jobjectArray, jmm_GetDiagnosticCommands(JNIEnv *env))
2160 ResourceMark rm(THREAD);
2161 GrowableArray<const char *>* dcmd_list = DCmdFactory::DCmd_list(DCmd_Source_MBean);
2162 objArrayOop cmd_array_oop = oopFactory::new_objArray(SystemDictionary::String_klass(),
2163 dcmd_list->length(), CHECK_NULL);
2164 objArrayHandle cmd_array(THREAD, cmd_array_oop);
2165 for (int i = 0; i < dcmd_list->length(); i++) {
2166 oop cmd_name = java_lang_String::create_oop_from_str(dcmd_list->at(i), CHECK_NULL);
2167 cmd_array->obj_at_put(i, cmd_name);
2168 }
2169 return (jobjectArray) JNIHandles::make_local(env, cmd_array());
2170 JVM_END
2172 JVM_ENTRY(void, jmm_GetDiagnosticCommandInfo(JNIEnv *env, jobjectArray cmds,
2173 dcmdInfo* infoArray))
2174 if (cmds == NULL || infoArray == NULL) {
2175 THROW(vmSymbols::java_lang_NullPointerException());
2176 }
2178 ResourceMark rm(THREAD);
2180 objArrayOop ca = objArrayOop(JNIHandles::resolve_non_null(cmds));
2181 objArrayHandle cmds_ah(THREAD, ca);
2183 // Make sure we have a String array
2184 Klass* element_klass = ObjArrayKlass::cast(cmds_ah->klass())->element_klass();
2185 if (element_klass != SystemDictionary::String_klass()) {
2186 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
2187 "Array element type is not String class");
2188 }
2190 GrowableArray<DCmdInfo *>* info_list = DCmdFactory::DCmdInfo_list(DCmd_Source_MBean);
2192 int num_cmds = cmds_ah->length();
2193 for (int i = 0; i < num_cmds; i++) {
2194 oop cmd = cmds_ah->obj_at(i);
2195 if (cmd == NULL) {
2196 THROW_MSG(vmSymbols::java_lang_NullPointerException(),
2197 "Command name cannot be null.");
2198 }
2199 char* cmd_name = java_lang_String::as_utf8_string(cmd);
2200 if (cmd_name == NULL) {
2201 THROW_MSG(vmSymbols::java_lang_NullPointerException(),
2202 "Command name cannot be null.");
2203 }
2204 int pos = info_list->find((void*)cmd_name,DCmdInfo::by_name);
2205 if (pos == -1) {
2206 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
2207 "Unknown diagnostic command");
2208 }
2209 DCmdInfo* info = info_list->at(pos);
2210 infoArray[i].name = info->name();
2211 infoArray[i].description = info->description();
2212 infoArray[i].impact = info->impact();
2213 JavaPermission p = info->permission();
2214 infoArray[i].permission_class = p._class;
2215 infoArray[i].permission_name = p._name;
2216 infoArray[i].permission_action = p._action;
2217 infoArray[i].num_arguments = info->num_arguments();
2218 infoArray[i].enabled = info->is_enabled();
2219 }
2220 JVM_END
2222 JVM_ENTRY(void, jmm_GetDiagnosticCommandArgumentsInfo(JNIEnv *env,
2223 jstring command, dcmdArgInfo* infoArray))
2224 ResourceMark rm(THREAD);
2225 oop cmd = JNIHandles::resolve_external_guard(command);
2226 if (cmd == NULL) {
2227 THROW_MSG(vmSymbols::java_lang_NullPointerException(),
2228 "Command line cannot be null.");
2229 }
2230 char* cmd_name = java_lang_String::as_utf8_string(cmd);
2231 if (cmd_name == NULL) {
2232 THROW_MSG(vmSymbols::java_lang_NullPointerException(),
2233 "Command line content cannot be null.");
2234 }
2235 DCmd* dcmd = NULL;
2236 DCmdFactory*factory = DCmdFactory::factory(DCmd_Source_MBean, cmd_name,
2237 strlen(cmd_name));
2238 if (factory != NULL) {
2239 dcmd = factory->create_resource_instance(NULL);
2240 }
2241 if (dcmd == NULL) {
2242 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
2243 "Unknown diagnostic command");
2244 }
2245 DCmdMark mark(dcmd);
2246 GrowableArray<DCmdArgumentInfo*>* array = dcmd->argument_info_array();
2247 if (array->length() == 0) {
2248 return;
2249 }
2250 for (int i = 0; i < array->length(); i++) {
2251 infoArray[i].name = array->at(i)->name();
2252 infoArray[i].description = array->at(i)->description();
2253 infoArray[i].type = array->at(i)->type();
2254 infoArray[i].default_string = array->at(i)->default_string();
2255 infoArray[i].mandatory = array->at(i)->is_mandatory();
2256 infoArray[i].option = array->at(i)->is_option();
2257 infoArray[i].multiple = array->at(i)->is_multiple();
2258 infoArray[i].position = array->at(i)->position();
2259 }
2260 return;
2261 JVM_END
2263 JVM_ENTRY(jstring, jmm_ExecuteDiagnosticCommand(JNIEnv *env, jstring commandline))
2264 ResourceMark rm(THREAD);
2265 oop cmd = JNIHandles::resolve_external_guard(commandline);
2266 if (cmd == NULL) {
2267 THROW_MSG_NULL(vmSymbols::java_lang_NullPointerException(),
2268 "Command line cannot be null.");
2269 }
2270 char* cmdline = java_lang_String::as_utf8_string(cmd);
2271 if (cmdline == NULL) {
2272 THROW_MSG_NULL(vmSymbols::java_lang_NullPointerException(),
2273 "Command line content cannot be null.");
2274 }
2275 bufferedStream output;
2276 DCmd::parse_and_execute(DCmd_Source_MBean, &output, cmdline, ' ', CHECK_NULL);
2277 oop result = java_lang_String::create_oop_from_str(output.as_string(), CHECK_NULL);
2278 return (jstring) JNIHandles::make_local(env, result);
2279 JVM_END
2281 JVM_ENTRY(void, jmm_SetDiagnosticFrameworkNotificationEnabled(JNIEnv *env, jboolean enabled))
2282 DCmdFactory::set_jmx_notification_enabled(enabled?true:false);
2283 JVM_END
2285 jlong Management::ticks_to_ms(jlong ticks) {
2286 assert(os::elapsed_frequency() > 0, "Must be non-zero");
2287 return (jlong)(((double)ticks / (double)os::elapsed_frequency())
2288 * (double)1000.0);
2289 }
2291 const struct jmmInterface_1_ jmm_interface = {
2292 NULL,
2293 NULL,
2294 jmm_GetVersion,
2295 jmm_GetOptionalSupport,
2296 jmm_GetInputArguments,
2297 jmm_GetThreadInfo,
2298 jmm_GetInputArgumentArray,
2299 jmm_GetMemoryPools,
2300 jmm_GetMemoryManagers,
2301 jmm_GetMemoryPoolUsage,
2302 jmm_GetPeakMemoryPoolUsage,
2303 jmm_GetThreadAllocatedMemory,
2304 jmm_GetMemoryUsage,
2305 jmm_GetLongAttribute,
2306 jmm_GetBoolAttribute,
2307 jmm_SetBoolAttribute,
2308 jmm_GetLongAttributes,
2309 jmm_FindMonitorDeadlockedThreads,
2310 jmm_GetThreadCpuTime,
2311 jmm_GetVMGlobalNames,
2312 jmm_GetVMGlobals,
2313 jmm_GetInternalThreadTimes,
2314 jmm_ResetStatistic,
2315 jmm_SetPoolSensor,
2316 jmm_SetPoolThreshold,
2317 jmm_GetPoolCollectionUsage,
2318 jmm_GetGCExtAttributeInfo,
2319 jmm_GetLastGCStat,
2320 jmm_GetThreadCpuTimeWithKind,
2321 jmm_GetThreadCpuTimesWithKind,
2322 jmm_DumpHeap0,
2323 jmm_FindDeadlockedThreads,
2324 jmm_SetVMGlobal,
2325 NULL,
2326 jmm_DumpThreads,
2327 jmm_SetGCNotificationEnabled,
2328 jmm_GetDiagnosticCommands,
2329 jmm_GetDiagnosticCommandInfo,
2330 jmm_GetDiagnosticCommandArgumentsInfo,
2331 jmm_ExecuteDiagnosticCommand,
2332 jmm_SetDiagnosticFrameworkNotificationEnabled
2333 };
2334 #endif // INCLUDE_MANAGEMENT
2336 void* Management::get_jmm_interface(int version) {
2337 #if INCLUDE_MANAGEMENT
2338 if (version == JMM_VERSION_1_0) {
2339 return (void*) &jmm_interface;
2340 }
2341 #endif // INCLUDE_MANAGEMENT
2342 return NULL;
2343 }