G1MMUTracker クラス関連のクラス (G1MMUTracker, G1MMUTrackerQueueElem, G1MMUTrackerQueue)

これらは, G1CollectorPolicy クラスの補助クラス. ユーザーから指定されたソフトリアルタイム制約を満たすために, GC 処理の時間を追跡して「いつからなら GC 処理を行っていいか」を判断する (See: G1CollectorPolicy).

    ((cite: hotspot/src/share/vm/gc_implementation/g1/g1MMUTracker.hpp))
    // Keeps track of the GC work and decides when it is OK to do GC work
    // and for how long so that the MMU invariants are maintained.

    ((cite: hotspot/src/share/vm/gc_implementation/g1/g1MMUTracker.hpp))
    /***** ALL TIMES ARE IN SECS!!!!!!! *****/

クラス一覧(class list)

G1MMUTracker

概要(Summary)

ユーザーから指定されたソフトリアルタイム制約を満たすために, GC 処理の時間を追跡して「いつからなら GC 処理を行っていいか」を判断する.

このために, MaxGCPauseMillis や GCPauseIntervalMillis といったコマンドラインオプションの値を管理し, また実際に Concurrent Mark 等で停止していた時間を記録している. これらに基づいて, (上記のオプションで指定された) 制約を守るために必要となる時間を計算する.

なお, このクラス自体は abstract class であり, 実際に使われるのはサブクラス.

    ((cite: hotspot/src/share/vm/gc_implementation/g1/g1MMUTracker.hpp))
    // this is the "interface"
    class G1MMUTracker: public CHeapObj {

詳細(Details)

G1MMUTrackerQueueElem

概要(Summary)

G1MMUTrackerQueue クラス内で使用される補助クラス(ValueObjクラス).

    ((cite: hotspot/src/share/vm/gc_implementation/g1/g1MMUTracker.hpp))
    class G1MMUTrackerQueueElem VALUE_OBJ_CLASS_SPEC {

使われ方(Usage)

インスタンスの格納場所(where its instances are stored)

各 G1MMUTrackerQueue オブジェクトの _array フィールドに(のみ)格納されている

(正確には, このフィールドは G1MMUTrackerQueueElem の配列を格納するフィールド. この中に, その G1MMUTrackerQueue 内で使用される全ての G1MMUTrackerQueueElem オブジェクトが格納されている).

生成箇所(where its instances are created)

(G1MMUTrackerQueue クラスの _array フィールドは, ポインタ型ではなく実体なので, G1MMUTrackerQueue オブジェクトの生成時に一緒に生成される)

情報の記録箇所(where information is recorded)

値の更新処理は以下の箇所で行われている模様. (#TODO 他にもあるか??)

使用箇所(where its instances are used)

記録された情報は以下の箇所で参照されている. (#TODO 他にもあるか??)

内部構造(Internal structure)

定義されているフィールドはこれだけ (メソッドもこれらのフィールドへのアクセサメソッドのみ).

    ((cite: hotspot/src/share/vm/gc_implementation/g1/g1MMUTracker.hpp))
      double _start_time;
      double _end_time;

詳細(Details)

G1MMUTrackerQueue

概要(Summary)

固定長のキューに直近の GC 処理による停止時間を記録しておくことで処理を実現している.

    ((cite: hotspot/src/share/vm/gc_implementation/g1/g1MMUTracker.hpp))
    // this is an implementation of the MMUTracker using a (fixed-size) queue
    // that keeps track of all the recent pause times
    class G1MMUTrackerQueue: public G1MMUTracker {

使われ方(Usage)

インスタンスの格納場所(where its instances are stored)

各 G1CollectorPolicy オブジェクトの _mmu_tracker フィールドに(のみ)格納されている

生成箇所(where its instances are created)

内部構造(Internal structure)

内部は, G1MMUTrackerQueueElem オブジェクトの配列として実現されている (この配列をリングバッファとして使用している).

    ((cite: hotspot/src/share/vm/gc_implementation/g1/g1MMUTracker.hpp))
      // The array keeps track of all the pauses that fall within a time
      // slice (the last time slice during which pauses took place).
      // The data structure implemented is a circular queue.
      // Head "points" to the most recent addition, tail to the oldest one.
      // The array is of fixed size and I don't think we'll need more than
      // two or three entries with the current behaviour of G1 pauses.
      // If the array is full, an easy fix is to look for the pauses with
      // the shortest gap between them and consolidate them.
      // For now, we have taken the expedient alternative of forgetting
      // the oldest entry in the event that +G1UseFixedWindowMMUTracker, thus
      // potentially violating MMU specs for some time thereafter.

      G1MMUTrackerQueueElem _array[QueueLength];
      int                   _head_index;
      int                   _tail_index;

    ((cite: hotspot/src/share/vm/gc_implementation/g1/g1MMUTracker.hpp))
      enum PrivateConstants {
        QueueLength = 64
      };