jhat.1 revision 2509
2509N/A." Copyright (c) 2006, 2010, Oracle and/or its affiliates. All rights reserved.
0N/A." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A."
0N/A." This code is free software; you can redistribute it and/or modify it
0N/A." under the terms of the GNU General Public License version 2 only, as
0N/A." published by the Free Software Foundation.
0N/A."
0N/A." This code is distributed in the hope that it will be useful, but WITHOUT
0N/A." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A." version 2 for more details (a copy is included in the LICENSE file that
0N/A." accompanied this code).
0N/A."
0N/A." You should have received a copy of the GNU General Public License version
0N/A." 2 along with this work; if not, write to the Free Software Foundation,
0N/A." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A."
2362N/A." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2362N/A." or visit www.oracle.com if you need additional information or have any
2362N/A." questions.
1178N/A."
2509N/A.TH jhat 1 "02 Jun 2010"
0N/A
0N/A.LP
1178N/A.SH "名前"
1178N/Ajhat \- Java ヒープ解析ツール
0N/A.LP
1178N/A.RS 3
1178N/A.TP 2
1178N/Ao
1178N/A形式
1178N/A.TP 2
1178N/Ao
1178N/Aパラメータ
1178N/A.TP 2
1178N/Ao
1178N/A説明
1178N/A.TP 2
1178N/Ao
1178N/Aオプション
1178N/A.TP 2
1178N/Ao
1178N/A関連項目
1178N/A.RE
1178N/A
1178N/A.LP
1178N/A.SH "形式"
0N/A.LP
0N/A
0N/A.LP
0N/A.nf
0N/A\f3
0N/A.fl
0N/A\fP\f3jhat\fP [ \f2options\fP ] <heap\-dump\-file>
0N/A.fl
0N/A
0N/A.fl
0N/A.fi
0N/A
0N/A.LP
1178N/A.SH "パラメータ"
0N/A.LP
0N/A
0N/A.LP
1178N/A.RS 3
1178N/A.TP 3
1178N/Aoptions
1178N/Aオプションを使用する場合、コマンド名の直後に記述してください。
1178N/A.br
1178N/A.TP 3
1178N/Aheap\-dump\-file
1178N/Aブラウズ対象となる Java バイナリヒープダンプファイル。複数のヒープダンプを含むダンプファイルの場合、「foo.hprof#3」のようにファイル名の後に「#<number>」を付加することで、ファイル内の特定のダンプを指定できます。
1178N/A.SH "説明"
0N/A.LP
0N/A.LP
1178N/A\f3jhat\fP コマンドは、java ヒープダンプファイルを解析し、Web サーバーを起動します。 jhat を使えば、お好みの Web ブラウザを使ってヒープダンプをブラウズできます。 jhat は、「ある既知のクラス「Foo」のすべてのインスタンスを表示する」といった、事前に設計されたクエリのほか、\f3OQL\fP (\f3O\fPbject \f3Q\fPuery \f3L\fPanguage) もサポートします。OQL のヘルプには、jhat によって表示される OQL ヘルプページからアクセスできます。デフォルトポートを使用する場合、OQL のヘルプは http://localhost:7000/oqlhelp/ で利用可能です。
1178N/A.LP
1178N/A.LP
1178N/AJava のヒープダンプを生成するには、いくつかの方法があります。
0N/A.LP
0N/A.RS 3
0N/A.TP 2
1178N/Ao
1178N/Ajmap(1) の \-dump オプションを使って実行時にヒープダンプを取得する。
0N/A.TP 2
1178N/Ao
1178N/Ajconsole(1) のオプションを使って
1178N/A.na
1178N/A\f2HotSpotDiagnosticMXBean\fP @
1178N/A.fi
1178N/Ahttp://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean.html 経由で実行時にヒープダンプを取得する。
0N/A.TP 2
1178N/Ao
1178N/A\-XX:+HeapDumpOnOutOfMemoryError VM オプションを指定すると、OutOfMemoryError のスロー時にヒープダンプが生成される。
1178N/A.TP 2
1178N/Ao
0N/A.na
1178N/A\f2hprof\fP @
0N/A.fi
1178N/Ahttp://java.sun.com/developer/technicalArticles/Programming/HPROF.html を使用する。
0N/A.RE
0N/A
0N/A.LP
0N/A.LP
1178N/A\f3注:\fP このツールは\f3試験的なもの\fPであり、将来の JDK のバージョンでは\f3利用できなくなる\fP可能性があります。
0N/A.LP
1178N/A.SH "オプション"
1178N/A.RS 3
0N/A.TP 3
0N/A\-stack false/true
1178N/Aオブジェクト割り当て呼び出しスタックの追跡を無効にします。ヒープダンプ内で割り当てサイト情報が使用できない場合、このフラグを false に設定する必要があります。デフォルトは true です。
0N/A.TP 3
0N/A\-refs false/true
1178N/Aオブジェクトへの参照の追跡を無効にします。デフォルトは true です。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ (指定されたオブジェクトをポイントしているオブジェクト。 参照者または受信参照とも呼ばれる) が計算されます。
0N/A.TP 3
0N/A\-port port\-number
1178N/Ajhat の HTTP サーバーのポートを設定します。デフォルトは 7000 です。
0N/A.TP 3
0N/A\-exclude exclude\-file
1178N/A「到達可能なオブジェクト」のクエリから除外すべきデータメンバーの一覧を含むファイルを指定します。たとえば、このファイルに \f2java.lang.String.value\fP が含まれていた場合、特定のオブジェクト「o」から到達可能なオブジェクトのリストを計算する際に、\f2java.lang.String.value\fP フィールドに関連する参照パスが考慮されなくなります。
0N/A.TP 3
0N/A\-baseline baseline\-dump\-file
1178N/Aベースラインとなるヒープダンプを指定します。両方のヒープダンプ内で同じオブジェクト ID を持つオブジェクトは「新規ではない」としてマークされます。その他のオブジェクトは「新規」としてマークされます。これは、異なる 2 つのヒープダンプを比較する際に役立ちます。
0N/A.TP 3
0N/A\-debug int
1178N/Aこのツールのデバッグレベルを設定します。0 は「デバッグ出力なし」を意味します。より大きな値を設定すると、より冗長なモードになります。
0N/A.TP 3
0N/A\-version\
1178N/Aバージョン番号を報告したあと、終了します。
0N/A.TP 3
0N/A\-h\
1178N/Aヘルプメッセージを出力して終了します。
0N/A.TP 3
0N/A\-help\
1178N/Aヘルプメッセージを出力して終了します。
0N/A.TP 3
0N/A\-J<flag>\
1178N/Ajhat が実行されている Java 仮想マシンに <flag> を渡します。たとえば、512M バイトの最大ヒープサイズを使用するには、\-J\-Xmx512m とします。
0N/A.RE
0N/A
0N/A.LP
1178N/A.SH "関連項目"
1178N/A.RS 3
1178N/A.TP 2
1178N/Ao
1178N/Ajmap(1)
1178N/A.TP 2
1178N/Ao
1178N/Ajconsole(1)
1178N/A.TP 2
1178N/Ao
1178N/A.na
1178N/A\f2hprof \- ヒープおよび CPU プロファイリングツール\fP @
1178N/A.fi
1178N/Ahttp://java.sun.com/developer/technicalArticles/Programming/HPROF.html
1178N/A.RE
1178N/A.RE
0N/A