|
1 .'" t |
|
2 ." |
|
3 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved. |
|
4 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
|
5 ." |
|
6 ." This code is free software; you can redistribute it and/or modify it |
|
7 ." under the terms of the GNU General Public License version 2 only, as |
|
8 ." published by the Free Software Foundation. |
|
9 ." |
|
10 ." This code is distributed in the hope that it will be useful, but WITHOUT |
|
11 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
12 ." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
13 ." version 2 for more details (a copy is included in the LICENSE file that |
|
14 ." accompanied this code). |
|
15 ." |
|
16 ." You should have received a copy of the GNU General Public License version |
|
17 ." 2 along with this work; if not, write to the Free Software Foundation, |
|
18 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
|
19 ." |
|
20 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, |
|
21 ." CA 95054 USA or visit www.sun.com if you need additional information or |
|
22 ." have any questions. |
|
23 ." |
|
24 ." ` |
|
25 .TH jhat 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド" |
|
26 ." Generated by html2roff |
|
27 |
|
28 .LP |
|
29 .SH 名前 |
|
30 jhat \- Java ヒープ解析ツール |
|
31 .LP |
|
32 .SH "形式" |
|
33 .LP |
|
34 |
|
35 .LP |
|
36 .nf |
|
37 \f3 |
|
38 .fl |
|
39 \fP\f3jhat\fP [ \f2options\fP ] <heap\-dump\-file> |
|
40 .fl |
|
41 |
|
42 .fl |
|
43 .fi |
|
44 |
|
45 .LP |
|
46 .SH "パラメータ" |
|
47 .LP |
|
48 |
|
49 .LP |
|
50 .TP 3 |
|
51 options |
|
52 オプションを使用する場合、コマンド名の直後に記述してください。 |
|
53 .TP 3 |
|
54 heap\-dump\-file |
|
55 ブラウズ対象となる Java バイナリヒープダンプファイル。複数のヒープダンプを含むダンプファイルの場合、「foo.hprof#3」のようにファイル名の後に「#<number>」を付加することで、ファイル内の特定のダンプを指定できます。 |
|
56 .LP |
|
57 .SH "説明" |
|
58 .LP |
|
59 |
|
60 .LP |
|
61 .LP |
|
62 \f3jhat\fP コマンドは、java ヒープダンプファイルを解析し、Web サーバを起動します。jhat を使えば、お好みの Web ブラウザを使ってヒープダンプをブラウズできます。jhat は、「ある既知のクラス「Foo」のすべてのインスタンスを表示する」といった、事前に設計されたクエリのほか、\f3OQL\fP (\f3O\fPbject \f3Q\fPuery \f3L\fPanguage) もサポートします。\f3OQL\fP は、ヒープダンプに対するクエリを行うための、SQL に似たクエリ言語です。OQL のヘルプには、jhat によって表示される OQL ヘルプページからアクセスできます。デフォルトポートを使用する場合、OQL のヘルプは http://localhost:7000/oqlhelp/ で利用可能です。 |
|
63 .LP |
|
64 .LP |
|
65 Java のヒープダンプを生成するには、いくつかの方法があります。 |
|
66 .LP |
|
67 .RS 3 |
|
68 .TP 2 |
|
69 * |
|
70 jmap の \-dump オプションを使って実行時にヒープダンプを取得する。 |
|
71 .TP 2 |
|
72 * |
|
73 jconsole のオプションを使って |
|
74 .na |
|
75 \f2HotSpotDiagnosticMXBean\fP |
|
76 .fi |
|
77 (http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticsMXBean.html) 経由で実行時にヒープダンプを取得する。 |
|
78 .TP 2 |
|
79 * |
|
80 \-XX:+HeapDumpOnOutOfMemoryError VM オプションを指定すると、OutOfMemoryError のスロー時にヒープダンプが生成される。 |
|
81 .TP 2 |
|
82 * |
|
83 |
|
84 .na |
|
85 \f2hprof\fP |
|
86 .fi |
|
87 (http://java.sun.com/developer/technicalArticles/Programming/HPROF.html) を使用する。 |
|
88 .RE |
|
89 |
|
90 .LP |
|
91 .LP |
|
92 \f3注:\fP このツールは試験的なものであり、JDK の将来のバージョンでは使用できない可能性があります。 |
|
93 .LP |
|
94 .SH "オプション" |
|
95 .LP |
|
96 |
|
97 .LP |
|
98 .TP 3 |
|
99 \-stack false/true |
|
100 オブジェクト割り当て呼び出しスタックの追跡を無効にします。ヒープダンプ内で割り当てサイト情報が使用できない場合、このフラグを false に設定する必要があります。デフォルトは true です。 |
|
101 .TP 3 |
|
102 \-refs false/true |
|
103 オブジェクトへの参照の追跡を無効にします。デフォルトは true です。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ (指定されたオブジェクトをポイントしているオブジェクト。つまり、参照者または受信参照) が計算されます。 |
|
104 .TP 3 |
|
105 \-port port\-number |
|
106 jhat の HTTP サーバのポートを設定します。デフォルトは 7000 です。 |
|
107 .TP 3 |
|
108 \-exclude exclude\-file |
|
109 「到達可能なオブジェクト」のクエリから除外すべきデータメンバの一覧を含むファイルを指定します。たとえば、このファイルに \f2java.lang.String.value\fP が含まれていた場合、特定のオブジェクト「o」から到達可能なオブジェクトのリストを計算する際に、\f2java.lang.String.value\fP フィールドに関連する参照パスが考慮されなくなります。 |
|
110 .TP 3 |
|
111 \-baseline baseline\-dump\-file |
|
112 ベースラインとなるヒープダンプを指定します。両方のヒープダンプ内で同じオブジェクト ID を持つオブジェクトは「新規ではない」としてマークされます。その他のオブジェクトは「新規」としてマークされます。これは、異なる 2 つのヒープダンプを比較する際に役立ちます。 |
|
113 .TP 3 |
|
114 \-debug int |
|
115 このツールのデバッグレベルを設定します。0 は「デバッグ出力なし」を意味します。より大きな値を設定すると、より冗長なモードになります。 |
|
116 .TP 3 |
|
117 \-version\ |
|
118 バージョン番号を報告したあと、終了します。 |
|
119 .TP 3 |
|
120 \-h\ |
|
121 ヘルプメッセージを出力したあと、終了します。 |
|
122 .TP 3 |
|
123 \-help\ |
|
124 ヘルプメッセージを出力したあと、終了します。 |
|
125 .TP 3 |
|
126 \-J<flag>\ |
|
127 jhat が実行されている Java 仮想マシンに <flag> を渡します。たとえば、512M バイトの最大ヒープサイズを使用するには、\-J\-Xmx512m とします。 |
|
128 .LP |
|
129 .SH "関連項目" |
|
130 .LP |
|
131 .RS 3 |
|
132 .TP 2 |
|
133 * |
|
134 jmap \- Java メモリマップ |
|
135 .TP 2 |
|
136 * |
|
137 jconsole \- Java 監視および管理コンソール |
|
138 .TP 2 |
|
139 * |
|
140 .na |
|
141 \f2hprof \- ヒープおよび CPU プロファイリングツール\fP |
|
142 .fi |
|
143 (http://java.sun.com/developer/technicalArticles/Programming/HPROF.html) |
|
144 .RE |
|
145 |
|
146 .LP |
|
147 |
|
148 .LP |
|
149 |