|
2
|
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 |
|