jmap(1)

名前
jmap - メモリーマップ

    o   形式

    o   パラメータ

    o   説明

    o   オプション

    o   関連項目

形式

jmap [ option ] pid
jmap [ option ] executable core
jmap [ option ] [server-id@]remote-hostname-or-IP

パラメータ

    option
        各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。

    pid 印刷するメモリーマップのプロセス ID。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。

    executable
        コアダンプの作成元の Java 実行可能ファイルです。

    core
        印刷するメモリーマップのコアファイル。

    remote-hostname-or-IP
        リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。

    server-id
        複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。

説明

jmap は、指定されたプロセスやコアファイルまたはリモートデバッグサーバーの、共用オブジェクトメモリーマップまたはヒープメモリーの詳細を印刷します。指定されたプロセスが 64 ビット VM 上で実行されている場合、-J-d64 オプションを指定しなければならない場合があります。次に例を示します。

jmap -J-d64 -heap pid

注: このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 PATH 環境変数には、ターゲットプロセスによって使用される jvm.dll の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。

次に例を示します。 set PATH=<jdk>\jre\bin\client;%PATH%

オプション

    <オプションなし>
        オプションを使用しない場合、jmap は共用オブジェクトマッピングを印刷します。ターゲット VM にロードされた共用オブジェクトごとに、開始アドレス、マッピングのサイズ、および共用オブジェクトファイルのフルパスが印刷されます。これは、Solaris pmap ユーティリティーと類似しています。

    -dump:[live,]format=b,file=<filename>
        Java ヒープを hprof バイナリ形式で filename にダンプします。live サブオプションは省略可能です。これが指定された場合、ヒープ内で生存中のオブジェクトのみがダンプされます。ヒープダンプを参照するには、生成されたファイルを jhat(1) (Java Heap Analysis Tool) を使って読み取ります。

    -finalizerinfo
        ファイナライズを待っているオブジェクトに関する情報を出力します。

    -heap
        ヒープサマリーを印刷します。使用される GC アルゴリズム、ヒープ構成、および世代ごとのヒープ使用率が印刷されます。

    -histo[:live]
        ヒープのヒストグラムを印刷します。Java クラスごとに、オブジェクトの数、バイト単位でのメモリーサイズ、および完全修飾クラス名が印刷されます。VM 内部クラス名は、「*」の接頭辞を付けて印刷されます。live サブオプションが指定された場合、生存中のオブジェクトのみがカウントされます。

    -permstat
        Permanent 世代の Java ヒープの、クラスローダー関連の統計データを印刷します。クラスローダーごとに、その名前、状態、アドレス、親クラスローダー、およびクラスローダーがロードしたクラスの数とサイズが印刷されます。さらに、intern された文字列の数とサイズも出力されます。

    -F  強制 (Force)。pid が応答しない場合に、jmap -dump または jmap -histo オプションとともに使用します。このモードでは、live サブオプションはサポートされません。

    -h  ヘルプメッセージを印刷します。

    -help
        ヘルプメッセージを印刷します。

    -J<flag>
        jmap が実行されている Java 仮想マシンに <flag> を渡します。

関連項目

    o   pmap (1)

    o   jhat(1)

    o   jps(1)

    o   jsadebugd(1)