Up Top

Serviceability 機能 ： JVMTI の処理 ： JVMTI 関数の処理 ： イベント管理 (Event Management) ： 各イベントの通知処理 ： イベントの遅延通知 [CompiledMethodLoad, CompiledMethodUnload, DynamicCodeGenerated]

概要(Summary)

JVMTI のイベントの中には, 実際にそのイベントが起こった瞬間ではなく, 少し遅れてから通知されるものがある.

(現状の HotSpot の実装では, CompiledMethodLoad, CompiledMethodUnload, DynamicCodeGenerated が遅延配送される模様)

これらのイベントを遅延させているのは, イベント通知は JavaThread から行わないといけないが, これらのイベントは CompilerThread や VMThread の中で発生するものであるため.

そのため, CompilerThread や VMThread 内ではイベントが発生したという情報だけを記録しておき, "ServiceThread" という JavaThread が実際の通知処理を行うことにしている.

    ((cite: hotspot/src/share/vm/prims/jvmtiImpl.hpp))
    /**
     * When a thread (such as the compiler thread or VM thread) cannot post a
     * JVMTI event itself because the event needs to be posted from a Java
     * thread, then it can defer the event to the Service thread for posting.
     * The information needed to post the event is encapsulated into this class
     * and then enqueued onto the JvmtiDeferredEventQueue, where the Service
     * thread will pick it up and post it.
     *
     * This is currently only used for posting compiled-method-load and unload
     * events, which we don't want posted from the compiler thread.
     */

備考(Notes)

以下のクラス群によって遅延通知が実現されている.

• JvmtiDeferredEvent
• JvmtiDeferredEventQueue
• JvmtiDeferredEventQueue::QueueNode
• ServiceThread

すぐに post できないイベントが発生すると, そのイベントの内容を格納した JvmtiDeferredEvent オブジェクトが作られ, JvmtiDeferredEventQueue に格納される.

この JvmtiDeferredEventQueue は ServiceThread によって監視されており, JvmtiDeferredEvent オブジェクトが追加されると ServiceThread がそれを取り出して JvmtiDeferredEvent::post() を呼び出すことでイベント通知処理を実行する.

処理の流れ (概要)(Execution Flows : Summary)

(1) イベントの生成と ServiceThread の起床処理 (CompiledMethodLoad の場合)

(略) (See: here for details)
-> ciEnv::register_method()
   -> nmethod::post_compiled_method_load_event()
      -> nmethod::get_and_cache_jmethod_id()
      -> JvmtiDeferredEvent::compiled_method_load_event()
      -> JvmtiDeferredEventQueue::enqueue()

(略) (See: here for details)
-> AdapterHandlerLibrary::create_native_wrapper()
   -> nmethod::post_compiled_method_load_event()
      -> (同上)

(1) イベントの生成と ServiceThread の起床処理 (CompiledMethodUnload の場合)

(略) (See: ...)
-> nmethod::make_unloaded()
   -> nmethod::post_compiled_method_unload()
      -> JvmtiDeferredEvent::compiled_method_unload_event()
      -> * safepoint 中の場合
           -> JvmtiDeferredEventQueue::add_pending_event()
         * そうではない場合
           -> JvmtiDeferredEventQueue::enqueue()

(略) (See: ...)
-> nmethod::make_not_entrant_or_zombie()
   -> nmethod::post_compiled_method_unload()
      -> (同上)

(1) イベントの生成と ServiceThread の起床処理 (DynamicCodeGenerated の場合)

JvmtiExport::post_dynamic_code_generated(const char *name, const void *code_begin, const void *code_end)
-> * HotSpot の起動中の場合:
     -> JvmtiExport::post_dynamic_code_generated_internal()
   * それ以外の場合:
     -> JvmtiDeferredEvent::dynamic_code_generated_event()
     -> JvmtiDeferredEventQueue::enqueue()

(2) ServiceThread による通知機能の呼び出し

ServiceThread::service_thread_entry()
-> JvmtiDeferredEventQueue::has_events()
-> JvmtiDeferredEventQueue::dequeue()
-> JvmtiDeferredEvent::post()
   -> * CompiledMethodLoad の場合:
        -> JvmtiExport::post_compiled_method_load()
      * CompiledMethodUnload の場合:
        -> JvmtiExport::post_compiled_method_unload()
      * DynamicCodeGenerated の場合:
        -> JvmtiExport::post_dynamic_code_generated_internal()

処理の流れ (詳細)(Execution Flows : Details)

nmethod::post_compiled_method_load_event()

See: here for details

nmethod::get_and_cache_jmethod_id()

See: here for details

JvmtiDeferredEvent::compiled_method_load_event()

See: here for details

JvmtiDeferredEventQueue::enqueue()

(#Under Construction) See: here for details

JvmtiDeferredEventQueue::process_pending_events()

(#Under Construction) See: here for details

nmethod::post_compiled_method_unload()

(#Under Construction) See: here for details

JvmtiDeferredEvent::compiled_method_unload_event()

See: here for details

JvmtiExport::post_dynamic_code_generated(const char *name, const void *code_begin, const void *code_end)

(#Under Construction) See: here for details

JvmtiExport::post_dynamic_code_generated_internal()

(#Under Construction)

JvmtiDeferredEvent::dynamic_code_generated_event()

See: here for details

ServiceThread::service_thread_entry()

See: here for details

JvmtiDeferredEventQueue::has_events()

See: here for details

JvmtiDeferredEventQueue::dequeue()

(#Under Construction) See: here for details

JvmtiDeferredEvent::post()

See: here for details

This document is available under the GNU GENERAL PUBLIC LICENSE Version 2.