1 '\" t
2 .\" Copyright (c) 2006, 2014, Oracle and/or its affiliates. All rights reserved.
3 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 .\"
5 .\" This code is free software; you can redistribute it and/or modify it
6 .\" under the terms of the GNU General Public License version 2 only, as
7 .\" published by the Free Software Foundation.
8 .\"
9 .\" This code is distributed in the hope that it will be useful, but WITHOUT
10 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
12 .\" version 2 for more details (a copy is included in the LICENSE file that
13 .\" accompanied this code).
14 .\"
15 .\" You should have received a copy of the GNU General Public License version
16 .\" 2 along with this work; if not, write to the Free Software Foundation,
17 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 .\"
19 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 .\" or visit www.oracle.com if you need additional information or have any
21 .\" questions.
22 .\"
23 .\" Title: jhat
24 .\" Language: Japanese
25 .\" Date: 2013年11月21日
26 .\" SectDesc: トラブルシューティング・ツール
27 .\" Software: JDK 8
28 .\" Arch: 汎用
29 .\" Part Number: E58103-01
30 .\" Doc ID: JSSON
31 .\"
32 .if n .pl 99999
33 .TH "jhat" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール"
34 .\" -----------------------------------------------------------------
35 .\" * Define some portability stuff
36 .\" -----------------------------------------------------------------
37 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
38 .\" http://bugs.debian.org/507673
39 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
40 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
41 .ie \n(.g .ds Aq \(aq
42 .el .ds Aq '
43 .\" -----------------------------------------------------------------
44 .\" * set default formatting
45 .\" -----------------------------------------------------------------
46 .\" disable hyphenation
47 .nh
48 .\" disable justification (adjust text to left margin only)
49 .ad l
50 .\" -----------------------------------------------------------------
51 .\" * MAIN CONTENT STARTS HERE *
52 .\" -----------------------------------------------------------------
53 .SH "名前"
54 jhat \- Javaヒープを分析します。このコマンドは試験的なもので、サポートされていません。
55 .SH "概要"
56 .sp
57 .if n \{\
58 .RS 4
59 .\}
60 .nf
61 \fBjhat\fR [ \fIoptions\fR ] \fIheap\-dump\-file\fR
62 .fi
63 .if n \{\
64 .RE
65 .\}
66 .PP
67 \fIoptions\fR
68 .RS 4
69 コマンド行オプション。オプションを参照してください。
70 .RE
71 .PP
72 \fIheap\-dump\-file\fR
73 .RS 4
74 ブラウズ対象となるJavaバイナリ・ヒープ・ダンプ・ファイル。複数のヒープ・ダンプを含むダンプ・ファイルの場合、\fBmyfile\&.hprof#3\fRのようにファイル名の後に\fB#<number>\fRを付加することで、ファイル内の特定のダンプを指定できます。
75 .RE
76 .SH "説明"
77 .PP
78 \fBjhat\fRコマンドはJavaヒープ・ダンプ・ファイルを解析し、Webサーバーを開始します。\fBjhat\fRコマンドを使用して、お気に入りのブラウザでヒープ・ダンプを参照できます。\fBjhat\fRコマンドは、既知のクラス\fBMyClass\fRのすべてのインスタンスを表示するなどの事前設計済の問合せやObject Query Language (OQL)をサポートします。ヒープ・ダンプの問合せを除き、OQLはSQLに似ています。OQLのヘルプには、\fBjhat\fRコマンドによって表示されるOQLヘルプ・ページからアクセスできます。デフォルト・ポートを使用する場合、OQLのヘルプはhttp://localhost:7000/oqlhelp/で利用可能です。
79 .PP
80 Javaのヒープ・ダンプを生成するには、次のいくつかの方法があります。
81 .sp
82 .RS 4
83 .ie n \{\
84 \h'-04'\(bu\h'+03'\c
85 .\}
86 .el \{\
87 .sp -1
88 .IP \(bu 2.3
89 .\}
90 \fBjmap \-dump\fRオプションを使用して実行時にヒープ・ダンプを取得します。jmap(1)を参照してください。
91 .RE
92 .sp
93 .RS 4
94 .ie n \{\
95 \h'-04'\(bu\h'+03'\c
96 .\}
97 .el \{\
98 .sp -1
99 .IP \(bu 2.3
100 .\}
101 \fBjconsole\fRオプションを使用して\fBHotSpotDiagnosticMXBean\fR経由で実行時にヒープ・ダンプを取得します。jconsole(1)および\fBHotSpotDiagnosticMXBean\fRのインタフェースの説明(
102 http://docs\&.oracle\&.com/javase/8/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean\&.html)を参照してください。
103 .RE
104 .sp
105 .RS 4
106 .ie n \{\
107 \h'-04'\(bu\h'+03'\c
108 .\}
109 .el \{\
110 .sp -1
111 .IP \(bu 2.3
112 .\}
113 ヒープ・ダンプは、\fB\-XX:+HeapDumpOnOutOfMemoryError\fR
114 Java Virtual Machine (JVM)オプションを指定することで、\fBOutOfMemoryError\fRがスローされたときに生成されます。
115 .RE
116 .sp
117 .RS 4
118 .ie n \{\
119 \h'-04'\(bu\h'+03'\c
120 .\}
121 .el \{\
122 .sp -1
123 .IP \(bu 2.3
124 .\}
125 \fBhprof\fRコマンドを使用します。HPROF: Heap/CPUプロファイリング・ツール
126 (http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/hprof\&.html)を参照してください
127 .RE
128 .SH "オプション"
129 .PP
130 \-stack false|true
131 .RS 4
132 オブジェクト割当呼出しスタックの追跡を無効にします。ヒープ・ダンプ内で割当サイト情報が使用できない場合、このフラグを\fBfalse\fRに設定する必要があります。デフォルトは\fBtrue\fRです。
133 .RE
134 .PP
135 \-refs false|true
136 .RS 4
137 オブジェクトへの参照の追跡を無効にします。デフォルトは\fBtrue\fRです。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ(指定されたオブジェクトをポイントしているオブジェクト。参照者または受信参照とも呼ばれる)が計算されます。
138 .RE
139 .PP
140 \-port \fIport\-number\fR
141 .RS 4
142 \fBjhat\fRのHTTPサーバーのポートを設定します。デフォルトは7000です。
143 .RE
144 .PP
145 \-exclude \fIexclude\-file\fR
146 .RS 4
147 到達可能なオブジェクトの問合せから除外する必要があるデータ・メンバーの一覧を含むファイルを指定します。たとえば、このファイルに\fBjava\&.lang\&.String\&.value\fRが含まれていた場合、特定のオブジェクト\fBo\fRから到達可能なオブジェクトのリストを計算する際に、\fBjava\&.lang\&.String\&.value\fRフィールドに関連する参照パスが考慮されなくなります。
148 .RE
149 .PP
150 \-baseline \fIexclude\-file\fR
151 .RS 4
152 ベースラインとなるヒープ・ダンプを指定します。両方のヒープ・ダンプ内で同じオブジェクトIDを持つオブジェクトは新規ではないとしてマークされます。他のオブジェクトは新規としてマークされます。これは、異なる2つのヒープ・ダンプを比較する際に役立ちます。
153 .RE
154 .PP
155 \-debug \fIint\fR
156 .RS 4
157 このツールのデバッグ・レベルを設定します。レベル0はデバッグ出力がないことを意味します。より大きな値を設定すると、より冗長なモードになります。
158 .RE
159 .PP
160 \-version
161 .RS 4
162 リリース番号をレポートして終了します
163 .RE
164 .PP
165 \-h
166 .RS 4
167 ヘルプ・メッセージを表示して終了します。
168 .RE
169 .PP
170 \-help
171 .RS 4
172 ヘルプ・メッセージを表示して終了します。
173 .RE
174 .PP
175 \-J\fIflag\fR
176 .RS 4
177 \fBjhat\fRコマンドを実行しているJava Virtual Machineに\fBflag\fRを渡します。たとえば、512Mバイトの最大ヒープ・サイズを使用するには、\fB\-J\-Xmx512m\fRとします。
178 .RE
179 .SH "関連項目"
180 .sp
181 .RS 4
182 .ie n \{\
183 \h'-04'\(bu\h'+03'\c
184 .\}
185 .el \{\
186 .sp -1
187 .IP \(bu 2.3
188 .\}
189 jmap(1)
190 .RE
191 .sp
192 .RS 4
193 .ie n \{\
194 \h'-04'\(bu\h'+03'\c
195 .\}
196 .el \{\
197 .sp -1
198 .IP \(bu 2.3
199 .\}
200 jconsole(1)
201 .RE
202 .sp
203 .RS 4
204 .ie n \{\
205 \h'-04'\(bu\h'+03'\c
206 .\}
207 .el \{\
208 .sp -1
209 .IP \(bu 2.3
210 .\}
211 HPROF: Heap/CPUプロファイリング・ツール
212 (http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/hprof\&.html)
213 .RE
214 .br
215 'pl 8.5i
216 'bp