1 .'" t
   2 ." Copyright 2006 Sun Microsystems, Inc.  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 .TH jhat 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
  24 ." Generated by html2roff
  25 
  26 .LP
  27 .SH 名前
  28 jhat \- Java ヒープ解析ツール
  29 .LP
  30 .SH "形式"
  31 .LP
  32 
  33 .LP
  34 .nf
  35 \f3
  36 .fl
  37 \fP\f3jhat\fP [ \f2options\fP ] <heap\-dump\-file>
  38 .fl
  39 
  40 .fl
  41 .fi
  42 
  43 .LP
  44 .SH "パラメータ"
  45 .LP
  46 
  47 .LP
  48 .TP 3
  49 options 
  50 オプションを使用する場合、コマンド名の直後に記述してください。 
  51 .TP 3
  52 heap\-dump\-file 
  53 ブラウズ対象となる Java バイナリヒープダンプファイル。複数のヒープダンプを含むダンプファイルの場合、「foo.hprof#3」のようにファイル名の後に「#<number>」を付加することで、ファイル内の特定のダンプを指定できます。 
  54 .LP
  55 .SH "説明"
  56 .LP
  57 
  58 .LP
  59 .LP
  60 \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/ で利用可能です。
  61 .LP
  62 .LP
  63 Java のヒープダンプを生成するには、いくつかの方法があります。
  64 .LP
  65 .RS 3
  66 .TP 2
  67 *
  68 jmap の \-dump オプションを使って実行時にヒープダンプを取得する。 
  69 .TP 2
  70 *
  71 jconsole のオプションを使って 
  72 .na
  73 \f2HotSpotDiagnosticMXBean\fP
  74 .fi
  75 (http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticsMXBean.html) 経由で実行時にヒープダンプを取得する。 
  76 .TP 2
  77 *
  78 \-XX:+HeapDumpOnOutOfMemoryError VM オプションを指定すると、OutOfMemoryError のスロー時にヒープダンプが生成される。 
  79 .TP 2
  80 *
  81 
  82 .na
  83 \f2hprof\fP
  84 .fi
  85 (http://java.sun.com/developer/technicalArticles/Programming/HPROF.html) を使用する。 
  86 .RE
  87 
  88 .LP
  89 .LP
  90 \f3注:\fP このツールは試験的なものであり、JDK の将来のバージョンでは使用できない可能性があります。
  91 .LP
  92 .SH "オプション"
  93 .LP
  94 
  95 .LP
  96 .TP 3
  97 \-stack false/true 
  98 オブジェクト割り当て呼び出しスタックの追跡を無効にします。ヒープダンプ内で割り当てサイト情報が使用できない場合、このフラグを false に設定する必要があります。デフォルトは true です。 
  99 .TP 3
 100 \-refs false/true 
 101 オブジェクトへの参照の追跡を無効にします。デフォルトは true です。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ (指定されたオブジェクトをポイントしているオブジェクト。つまり、参照者または受信参照) が計算されます。 
 102 .TP 3
 103 \-port port\-number 
 104 jhat の HTTP サーバのポートを設定します。デフォルトは 7000 です。 
 105 .TP 3
 106 \-exclude exclude\-file 
 107 「到達可能なオブジェクト」のクエリから除外すべきデータメンバの一覧を含むファイルを指定します。たとえば、このファイルに \f2java.lang.String.value\fP が含まれていた場合、特定のオブジェクト「o」から到達可能なオブジェクトのリストを計算する際に、\f2java.lang.String.value\fP フィールドに関連する参照パスが考慮されなくなります。 
 108 .TP 3
 109 \-baseline baseline\-dump\-file 
 110 ベースラインとなるヒープダンプを指定します。両方のヒープダンプ内で同じオブジェクト ID を持つオブジェクトは「新規ではない」としてマークされます。その他のオブジェクトは「新規」としてマークされます。これは、異なる 2 つのヒープダンプを比較する際に役立ちます。 
 111 .TP 3
 112 \-debug int 
 113 このツールのデバッグレベルを設定します。0 は「デバッグ出力なし」を意味します。より大きな値を設定すると、より冗長なモードになります。 
 114 .TP 3
 115 \-version\  
 116 バージョン番号を報告したあと、終了します。 
 117 .TP 3
 118 \-h\  
 119 ヘルプメッセージを出力したあと、終了します。 
 120 .TP 3
 121 \-help\  
 122 ヘルプメッセージを出力したあと、終了します。 
 123 .TP 3
 124 \-J<flag>\  
 125 jhat が実行されている Java 仮想マシンに <flag> を渡します。たとえば、512M バイトの最大ヒープサイズを使用するには、\-J\-Xmx512m とします。 
 126 .LP
 127 .SH "関連項目"
 128 .LP
 129 .RS 3
 130 .TP 2
 131 *
 132 jmap \- Java メモリマップ 
 133 .TP 2
 134 *
 135 jconsole \- Java 監視および管理コンソール 
 136 .TP 2
 137 *
 138 .na
 139 \f2hprof \- ヒープおよび CPU プロファイリングツール\fP
 140 .fi
 141 (http://java.sun.com/developer/technicalArticles/Programming/HPROF.html)
 142 .RE
 143 
 144 .LP
 145 
 146 .LP
 147