1 '\" t |
1 '\" t |
2 .\" Copyright (c) 2006, 2013, Oracle and/or its affiliates. All rights reserved. |
2 .\" Copyright (c) 2006, 2014, Oracle and/or its affiliates. All rights reserved. |
3 .\" Title: jhat |
|
4 .\" Language: English |
|
5 .\" Date: 2013年11月21日 |
|
6 .\" SectDesc: トラブルシューティング・ツール |
|
7 .\" Software: JDK 8 |
|
8 .\" Arch: 汎用 |
|
9 .\" |
|
10 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
3 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
11 .\" |
4 .\" |
12 .\" This code is free software; you can redistribute it and/or modify it |
5 .\" This code is free software; you can redistribute it and/or modify it |
13 .\" under the terms of the GNU General Public License version 2 only, as |
6 .\" under the terms of the GNU General Public License version 2 only, as |
14 .\" published by the Free Software Foundation. |
7 .\" published by the Free Software Foundation. |
15 .\" |
8 .\" |
16 .\" This code is distributed in the hope that it will be useful, but WITHOUT |
9 .\" This code is distributed in the hope that it will be useful, but WITHOUT |
17 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
10 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
18 .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
11 .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
19 .\" version 2 for more details (a copy is included in the LICENSE file that |
12 .\" version 2 for more details (a copy is included in the LICENSE file that |
20 .\" accompanied this code). |
13 .\" accompanied this code). |
21 .\" |
14 .\" |
22 .\" You should have received a copy of the GNU General Public License version |
15 .\" You should have received a copy of the GNU General Public License version |
23 .\" 2 along with this work; if not, write to the Free Software Foundation, |
16 .\" 2 along with this work; if not, write to the Free Software Foundation, |
25 .\" |
18 .\" |
26 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
19 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
27 .\" or visit www.oracle.com if you need additional information or have any |
20 .\" or visit www.oracle.com if you need additional information or have any |
28 .\" questions. |
21 .\" questions. |
29 .\" |
22 .\" |
30 .pl 99999 |
23 .\" Title: jhat |
31 .TH "jhat" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール" |
24 .\" Language: Japanese |
|
25 .\" Date: 2013ǯ1121 |
|
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ǯ1121" "JDK 8" "ȥ֥륷塼ƥġ" |
32 .\" ----------------------------------------------------------------- |
34 .\" ----------------------------------------------------------------- |
33 .\" * Define some portability stuff |
35 .\" * Define some portability stuff |
34 .\" ----------------------------------------------------------------- |
36 .\" ----------------------------------------------------------------- |
35 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
37 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
36 .\" http://bugs.debian.org/507673 |
38 .\" http://bugs.debian.org/507673 |
46 .\" disable justification (adjust text to left margin only) |
48 .\" disable justification (adjust text to left margin only) |
47 .ad l |
49 .ad l |
48 .\" ----------------------------------------------------------------- |
50 .\" ----------------------------------------------------------------- |
49 .\" * MAIN CONTENT STARTS HERE * |
51 .\" * MAIN CONTENT STARTS HERE * |
50 .\" ----------------------------------------------------------------- |
52 .\" ----------------------------------------------------------------- |
51 .SH "NAME" |
53 .SH "̾" |
52 jhat \- Javaヒープを分析します。このコマンドは試験的なもので、サポートされていません。 |
54 jhat \- JavaҡפʬϤޤΥޥɤϻŪʤΤǡݡȤƤޤ |
53 .SH "概要" |
55 .SH "" |
54 .sp |
56 .sp |
55 .if n \{\ |
57 .if n \{\ |
56 .RS 4 |
58 .RS 4 |
57 .\} |
59 .\} |
58 .nf |
60 .nf |
59 \fIjhat\fR [ \fIoptions\fR ] \fIheap\-dump\-file\fR |
61 \fBjhat\fR [ \fIoptions\fR ] \fIheap\-dump\-file\fR |
60 .fi |
62 .fi |
61 .if n \{\ |
63 .if n \{\ |
62 .RE |
64 .RE |
63 .\} |
65 .\} |
64 .PP |
66 .PP |
65 \fIoptions\fR |
67 \fIoptions\fR |
66 .RS 4 |
68 .RS 4 |
67 コマンドライン・オプション。オプションを参照してください。 |
69 ޥɹԥץץȤƤ |
68 .RE |
70 .RE |
69 .PP |
71 .PP |
70 \fIheap\-dump\-file\fR |
72 \fIheap\-dump\-file\fR |
71 .RS 4 |
73 .RS 4 |
72 ブラウズ対象となるJavaバイナリ・ヒープ・ダンプ・ファイル。複数のヒープ・ダンプを含むダンプ・ファイルの場合、\fImyfile\&.hprof#3\fRのようにファイル名の後に\fI#<number>\fRを付加することで、ファイル内の特定のダンプを指定できます。 |
74 ֥饦оݤȤʤJavaХʥꡦҡססե롣ʣΥҡספޤסեξ硢\fBmyfile\&.hprof#3\fRΤ褦˥ե̾θ\fB#<number>\fRղä뤳ȤǡեΥפǤޤ |
73 .RE |
75 .RE |
74 .SH "説明" |
76 .SH "" |
75 .PP |
77 .PP |
76 \fIjhat\fRコマンドはJavaヒープ・ダンプ・ファイルを解析し、Webサーバーを開始します。\fIjhat\fRコマンドを使用して、お気に入りのブラウザでヒープ・ダンプを参照できます。\fIjhat\fRコマンドは、既知のクラス\fIMyClass\fRのすべてのインスタンスを表示するなどの事前設計済の問合せやObject Query Language (OQL)をサポートします。ヒープ・ダンプの問合せを除き、OQLはSQLに似ています。OQLのヘルプには、\fIjhat\fRコマンドによって表示されるOQLヘルプ・ページからアクセスできます。デフォルト・ポートを使用する場合、OQLのヘルプはhttp://localhost:7000/oqlhelp/で利用可能です。 |
78 \fBjhat\fRޥɤJavaҡססեϤWebСϤޤ\fBjhat\fRޥɤѤơΥ֥饦ǥҡספȤǤޤ\fBjhat\fRޥɤϡΤΥ饹\fBMyClass\fRΤ٤ƤΥɽʤɤλ߷Ѥ礻Object Query Language (OQL)ݡȤޤҡספ礻OQLSQL˻ƤޤOQLΥإפˤϡ\fBjhat\fRޥɤˤäɽOQLإסڡ饢ǤޤǥեȡݡȤѤ硢OQLΥإפhttp://localhost:7000/oqlhelp/ѲǽǤ |
77 .PP |
79 .PP |
78 Javaのヒープ・ダンプを生成するには、次のいくつかの方法があります。 |
80 JavaΥҡספˤϡΤĤˡޤ |
79 .sp |
81 .sp |
80 .RS 4 |
82 .RS 4 |
81 .ie n \{\ |
83 .ie n \{\ |
82 \h'-04'\(bu\h'+03'\c |
84 \h'-04'\(bu\h'+03'\c |
83 .\} |
85 .\} |
84 .el \{\ |
86 .el \{\ |
85 .sp -1 |
87 .sp -1 |
86 .IP \(bu 2.3 |
88 .IP \(bu 2.3 |
87 .\} |
89 .\} |
88 \fIjmap \-dump\fRオプションを使用して実行時にヒープ・ダンプを取得します。jmap(1)を参照してください。 |
90 \fBjmap \-dump\fRץѤƼ¹Ի˥ҡספޤjmap(1)ȤƤ |
89 .RE |
91 .RE |
90 .sp |
92 .sp |
91 .RS 4 |
93 .RS 4 |
92 .ie n \{\ |
94 .ie n \{\ |
93 \h'-04'\(bu\h'+03'\c |
95 \h'-04'\(bu\h'+03'\c |
94 .\} |
96 .\} |
95 .el \{\ |
97 .el \{\ |
96 .sp -1 |
98 .sp -1 |
97 .IP \(bu 2.3 |
99 .IP \(bu 2.3 |
98 .\} |
100 .\} |
99 \fIjconsole\fRオプションを使用して\fIHotSpotDiagnosticMXBean\fR経由で実行時にヒープ・ダンプを取得します。jconsole(1)および\fIHotSpotDiagnosticMXBean\fRのインタフェースの説明( |
101 \fBjconsole\fRץѤ\fBHotSpotDiagnosticMXBean\fRͳǼ¹Ի˥ҡספޤjconsole(1)\fBHotSpotDiagnosticMXBean\fRΥե( |
100 http://docs\&.oracle\&.com/javase/8/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean\&.html)を参照してください。 |
102 http://docs\&.oracle\&.com/javase/8/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean\&.html)ȤƤ |
101 .RE |
103 .RE |
102 .sp |
104 .sp |
103 .RS 4 |
105 .RS 4 |
104 .ie n \{\ |
106 .ie n \{\ |
105 \h'-04'\(bu\h'+03'\c |
107 \h'-04'\(bu\h'+03'\c |
106 .\} |
108 .\} |
107 .el \{\ |
109 .el \{\ |
108 .sp -1 |
110 .sp -1 |
109 .IP \(bu 2.3 |
111 .IP \(bu 2.3 |
110 .\} |
112 .\} |
111 ヒープ・ダンプは、\fI\-XX:+HeapDumpOnOutOfMemoryError\fR |
113 ҡספϡ\fB\-XX:+HeapDumpOnOutOfMemoryError\fR |
112 Java仮想マシン(JVM)オプションを指定することで、\fIOutOfMemoryError\fRがスローされたときに生成されます。 |
114 Java Virtual Machine (JVM)ץꤹ뤳Ȥǡ\fBOutOfMemoryError\fR줿Ȥޤ |
113 .RE |
115 .RE |
114 .sp |
116 .sp |
115 .RS 4 |
117 .RS 4 |
116 .ie n \{\ |
118 .ie n \{\ |
117 \h'-04'\(bu\h'+03'\c |
119 \h'-04'\(bu\h'+03'\c |
118 .\} |
120 .\} |
119 .el \{\ |
121 .el \{\ |
120 .sp -1 |
122 .sp -1 |
121 .IP \(bu 2.3 |
123 .IP \(bu 2.3 |
122 .\} |
124 .\} |
123 \fIhprof\fRコマンドを使用します。HPROF: Heap/CPUプロファイリング・ツール |
125 \fBhprof\fRޥɤѤޤHPROF: Heap/CPUץեġ |
124 (http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/hprof\&.html)を参照してください |
126 (http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/hprof\&.html)ȤƤ |
125 .RE |
127 .RE |
126 .SH "オプション" |
128 .SH "ץ" |
127 .PP |
129 .PP |
128 \-stack false|true |
130 \-stack false|true |
129 .RS 4 |
131 .RS 4 |
130 オブジェクト割当呼出しスタックの追跡を無効にします。ヒープ・ダンプ内で割当サイト情報が使用できない場合、このフラグを\fIfalse\fRに設定する必要があります。デフォルトは\fItrue\fRです。 |
132 ֥ȳƽФåפ̵ˤޤҡסdzȾѤǤʤ硢Υե饰\fBfalse\fRꤹɬפޤǥեȤ\fBtrue\fRǤ |
131 .RE |
133 .RE |
132 .PP |
134 .PP |
133 \-refs false|true |
135 \-refs false|true |
134 .RS 4 |
136 .RS 4 |
135 オブジェクトへの参照の追跡を無効にします。デフォルトは\fItrue\fRです。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ(指定されたオブジェクトをポイントしているオブジェクト。参照者または受信参照とも呼ばれる)が計算されます。 |
137 ֥ȤؤλȤפ̵ˤޤǥեȤ\fBtrue\fRǤǥեȤǤϡҡΤ٤ƤΥ֥ȤˤĤơХåݥ(ꤵ줿֥ȤݥȤƤ륪֥ȡȼԤޤϼȤȤƤФ)ޤ |
136 .RE |
138 .RE |
137 .PP |
139 .PP |
138 \-port \fIport\-number\fR |
140 \-port \fIport\-number\fR |
139 .RS 4 |
141 .RS 4 |
140 \fIjhat\fRのHTTPサーバーのポートを設定します。デフォルトは7000です。 |
142 \fBjhat\fRHTTPСΥݡȤꤷޤǥեȤ7000Ǥ |
141 .RE |
143 .RE |
142 .PP |
144 .PP |
143 \-exclude \fIexclude\-file\fR |
145 \-exclude \fIexclude\-file\fR |
144 .RS 4 |
146 .RS 4 |
145 到達可能なオブジェクトの問合せから除外する必要があるデータ・メンバーの一覧を含むファイルを指定します。たとえば、このファイルに\fIjava\&.lang\&.String\&.value\fRが含まれていた場合、特定のオブジェクト\fIo\fRから到達可能なオブジェクトのリストを計算する際に、\fIjava\&.lang\&.String\&.value\fRフィールドに関連する参照パスが考慮されなくなります。 |
147 ãǽʥ֥Ȥ礻ɬפǡСΰޤեꤷޤȤСΥե\fBjava\&.lang\&.String\&.value\fRޤޤƤ硢Υ֥\fBo\fRãǽʥ֥ȤΥꥹȤݤˡ\fBjava\&.lang\&.String\&.value\fRեɤ˴Ϣ뻲ȥѥθʤʤޤ |
146 .RE |
148 .RE |
147 .PP |
149 .PP |
148 \-baseline \fIexclude\-file\fR |
150 \-baseline \fIexclude\-file\fR |
149 .RS 4 |
151 .RS 4 |
150 ベースラインとなるヒープ・ダンプを指定します。両方のヒープ・ダンプ内で同じオブジェクトIDを持つオブジェクトは新規ではないとしてマークされます。他のオブジェクトは新規としてマークされます。これは、異なる2つのヒープ・ダンプを比較する際に役立ちます。 |
152 ١饤ȤʤҡספꤷޤξΥҡסƱ֥IDĥ֥ȤϿǤϤʤȤƥޡޤ¾Υ֥ȤϿȤƥޡޤϡۤʤ2ĤΥҡספӤݤΩޤ |
151 .RE |
153 .RE |
152 .PP |
154 .PP |
153 \-debug \fIint\fR |
155 \-debug \fIint\fR |
154 .RS 4 |
156 .RS 4 |
155 このツールのデバッグ・レベルを設定します。レベル0はデバッグ出力がないことを意味します。より大きな値を設定すると、より冗長なモードになります。 |
157 ΥġΥǥХå٥ꤷޤ٥0ϥǥХåϤʤȤ̣ޤ礭ͤꤹȡĹʥ⡼ɤˤʤޤ |
156 .RE |
158 .RE |
157 .PP |
159 .PP |
158 \-version |
160 \-version |
159 .RS 4 |
161 .RS 4 |
160 リリース番号をレポートして終了します |
162 ֹݡȤƽλޤ |
161 .RE |
163 .RE |
162 .PP |
164 .PP |
163 \-h |
165 \-h |
164 .RS 4 |
166 .RS 4 |
165 ヘルプ・メッセージを表示して終了します。 |
167 إסåɽƽλޤ |
166 .RE |
168 .RE |
167 .PP |
169 .PP |
168 \-help |
170 \-help |
169 .RS 4 |
171 .RS 4 |
170 ヘルプ・メッセージを表示して終了します。 |
172 إסåɽƽλޤ |
171 .RE |
173 .RE |
172 .PP |
174 .PP |
173 \-J\fIflag\fR |
175 \-J\fIflag\fR |
174 .RS 4 |
176 .RS 4 |
175 \fIjhat\fRコマンドを実行しているJava仮想マシンに\fIflag\fRを渡します。たとえば、512Mバイトの最大ヒープ・サイズを使用するには、\fI\-J\-Xmx512m\fRとします。 |
177 \fBjhat\fRޥɤ¹ԤƤJava Virtual Machine\fBflag\fRϤޤȤС512MХȤκҡסѤˤϡ\fB\-J\-Xmx512m\fRȤޤ |
176 .RE |
178 .RE |
177 .SH "関連項目" |
179 .SH "Ϣ" |
178 .sp |
180 .sp |
179 .RS 4 |
181 .RS 4 |
180 .ie n \{\ |
182 .ie n \{\ |
181 \h'-04'\(bu\h'+03'\c |
183 \h'-04'\(bu\h'+03'\c |
182 .\} |
184 .\} |