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)