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