1 ." Copyright (c) 2004, 2011, Oracle and/or its affiliates. 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 ." 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. 21 ." 22 .TH jmap 1 "07 May 2011" 23 24 .LP 25 .SH "名前" 26 jmap \- メモリーマップ 27 .LP 28 .RS 3 29 .TP 2 30 o 31 形式 32 .TP 2 33 o 34 パラメータ 35 .TP 2 36 o 37 説明 38 .TP 2 39 o 40 オプション 41 .TP 2 42 o 43 関連項目 44 .RE 45 46 .LP 47 .SH "形式" 48 .LP 49 .nf 50 \f3 51 .fl 52 \fP\f3jmap\fP [ option ] pid 53 .fl 54 \f3jmap\fP [ option ] executable core 55 .fl 56 \f3jmap\fP [ option ] [server\-id@]remote\-hostname\-or\-IP 57 .fl 58 .fi 59 60 .LP 61 .SH "パラメータ" 62 .LP 63 .RS 3 64 .TP 3 65 option 66 各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。 67 .TP 3 68 pid 69 印刷するメモリーマップのプロセス ID。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。 70 .br 71 .TP 3 72 executable 73 コアダンプの作成元の Java 実行可能ファイルです。 74 .br 75 .TP 3 76 core 77 印刷するメモリーマップのコアファイル。 78 .br 79 .TP 3 80 remote\-hostname\-or\-IP 81 リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。 82 .br 83 .TP 3 84 server\-id 85 複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。 86 .br 87 .RE 88 89 .LP 90 .SH "説明" 91 .LP 92 .LP 93 \f3jmap\fP は、指定されたプロセスやコアファイルまたはリモートデバッグサーバーの、共用オブジェクトメモリーマップまたはヒープメモリーの詳細を印刷します。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。 94 .LP 95 .nf 96 \f3 97 .fl 98 jmap \-J\-d64 \-heap pid 99 .fl 100 \fP 101 .fi 102 103 .LP 104 .LP 105 \f3注: このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \fP\f4PATH\fP\f3 環境変数には、ターゲットプロセスによって使用される \fP\f4jvm.dll\fP\f3 の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。\fP 106 .LP 107 .LP 108 \f3次に例を示します。 \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP 109 .LP 110 .br 111 112 .LP 113 .SH "オプション" 114 .LP 115 .RS 3 116 .TP 3 117 <オプションなし> 118 オプションを使用しない場合、jmap は共用オブジェクトマッピングを印刷します。ターゲット VM にロードされた共用オブジェクトごとに、開始アドレス、マッピングのサイズ、および共用オブジェクトファイルのフルパスが印刷されます。これは、Solaris \f3pmap\fP ユーティリティーと類似しています。 119 .br 120 .TP 3 121 \-dump:[live,]format=b,file=<filename> 122 Java ヒープを hprof バイナリ形式で filename にダンプします。\f2live\fP サブオプションは省略可能です。これが指定された場合、ヒープ内で生存中のオブジェクトのみがダンプされます。ヒープダンプを参照するには、生成されたファイルを jhat(1) (Java Heap Analysis Tool) を使って読み取ります。 123 .br 124 .TP 3 125 \-finalizerinfo 126 ファイナライズを待っているオブジェクトに関する情報を出力します。 127 .br 128 .TP 3 129 \-heap 130 ヒープサマリーを印刷します。使用される GC アルゴリズム、ヒープ構成、および世代ごとのヒープ使用率が印刷されます。 131 .br 132 .TP 3 133 \-histo[:live] 134 ヒープのヒストグラムを印刷します。Java クラスごとに、オブジェクトの数、バイト単位でのメモリーサイズ、および完全修飾クラス名が印刷されます。VM 内部クラス名は、「*」の接頭辞を付けて印刷されます。\f2live\fP サブオプションが指定された場合、生存中のオブジェクトのみがカウントされます。 135 .br 136 .TP 3 137 \-permstat 138 Permanent 世代の Java ヒープの、クラスローダー関連の統計データを印刷します。クラスローダーごとに、その名前、状態、アドレス、親クラスローダー、およびクラスローダーがロードしたクラスの数とサイズが印刷されます。さらに、intern された文字列の数とサイズも出力されます。 139 .br 140 .TP 3 141 \-F 142 強制 (Force)。pid が応答しない場合に、jmap \-dump または jmap \-histo オプションとともに使用します。このモードでは、\f2live\fP サブオプションはサポートされません。 143 .br 144 .TP 3 145 \-h 146 ヘルプメッセージを印刷します。 147 .br 148 .br 149 .TP 3 150 \-help 151 ヘルプメッセージを印刷します。 152 .br 153 .br 154 .TP 3 155 \-J<flag> 156 jmap が実行されている Java 仮想マシンに <flag> を渡します。 157 .br 158 .RE 159 160 .LP 161 .SH "関連項目" 162 .LP 163 .RS 3 164 .TP 2 165 o 166 pmap (1) 167 .TP 2 168 o 169 jhat(1) 170 .TP 2 171 o 172 jps(1) 173 .TP 2 174 o 175 jsadebugd(1) 176 .RE 177 178 .LP 179 | 1 '\" t 2 .\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. 3 .\" Title: jmap 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. 11 .\" 12 .\" 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 14 .\" published by the Free Software Foundation. 15 .\" 16 .\" 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 18 .\" 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 20 .\" accompanied this code). 21 .\" 22 .\" 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, 24 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 25 .\" 26 .\" 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 28 .\" questions. 29 .\" 30 .pl 99999 31 .TH "jmap" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール" 32 .\" ----------------------------------------------------------------- 33 .\" * Define some portability stuff 34 .\" ----------------------------------------------------------------- 35 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 36 .\" http://bugs.debian.org/507673 37 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html 38 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 39 .ie \n(.g .ds Aq \(aq 40 .el .ds Aq ' 41 .\" ----------------------------------------------------------------- 42 .\" * set default formatting 43 .\" ----------------------------------------------------------------- 44 .\" disable hyphenation 45 .nh 46 .\" disable justification (adjust text to left margin only) 47 .ad l 48 .\" ----------------------------------------------------------------- 49 .\" * MAIN CONTENT STARTS HERE * 50 .\" ----------------------------------------------------------------- 51 .SH "NAME" 52 jmap \- プロセスやコア・ファイルまたはリモート・デバッグ・サーバーの、共用オブジェクト・メモリー・マップまたはヒープ・メモリーの詳細を出力します。このコマンドは試験的なもので、サポートされていません。 53 .SH "概要" 54 .sp 55 .if n \{\ 56 .RS 4 57 .\} 58 .nf 59 \fIjmap\fR [ \fIoptions\fR ] \fIpid\fR 60 .fi 61 .if n \{\ 62 .RE 63 .\} 64 .sp 65 .if n \{\ 66 .RS 4 67 .\} 68 .nf 69 \fIjmap\fR [ \fIoptions\fR ] \fIexecutable\fR \fIcore\fR 70 .fi 71 .if n \{\ 72 .RE 73 .\} 74 .sp 75 .if n \{\ 76 .RS 4 77 .\} 78 .nf 79 \fIjmap\fR [ \fIoptions\fR ] [ \fIpid\fR ] \fIserver\-id\fR@ ] \fIremote\-hostname\-or\-IP\fR 80 .fi 81 .if n \{\ 82 .RE 83 .\} 84 .PP 85 \fIoptions\fR 86 .RS 4 87 コマンドライン・オプション。オプションを参照してください。 88 .RE 89 .PP 90 \fIpid\fR 91 .RS 4 92 出力するメモリー・マップのプロセスID。プロセスはJavaプロセスである必要があります。マシン上で実行しているJavaプロセスの一覧を取得するには、jps(1)コマンドを使用します。 93 .RE 94 .PP 95 \fI実行可能ファイル\fR 96 .RS 4 97 コア・ダンプの作成元のJava実行可能ファイル。 98 .RE 99 .PP 100 \fIコア\fR 101 .RS 4 102 出力するメモリー・マップのコア・ファイル。 103 .RE 104 .PP 105 \fIremote\-hostname\-or\-IP\fR 106 .RS 4 107 リモート・デバッグ・サーバーの\fIホスト名\fRまたは\fIIP\fRアドレス。jsadebugd(1)を参照してください。 108 .RE 109 .PP 110 \fIserver\-id\fR 111 .RS 4 112 複数のデバッグ・サーバーが同一のリモート・ホストで実行している場合の、オプション固有のID。 113 .RE 114 .SH "説明" 115 .PP 116 \fIjmap\fRコマンドは、指定されたプロセスやコア・ファイルまたはリモート・デバッグ・サーバーの、共用オブジェクト・メモリー・マップまたはヒープ・メモリーの詳細を出力します。指定されたプロセスが64ビットJava仮想マシン(JVM)上で実行されている場合、\fI\-J\-d64\fRオプションを指定する必要がある場合があります。次に例を示します。\fIjmap\fR 117 \fI\-J\-d64 \-heap pid\fR。 118 .PP 119 \fB注意:\fR 120 このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fIdbgeng\&.dll\fRファイルが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fIPATH\fR環境変数には、ターゲット・プロセスによって使用される\fIjvm\&.dll\fRの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。次に例を示します。\fIset PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fR。 121 .SH "オプション" 122 .PP 123 <オプションなし> 124 .RS 4 125 オプションを使用しない場合、\fIjmap\fRコマンドは共用オブジェクト・マッピングを出力します。ターゲットJVMにロードされた共用オブジェクトごとに、開始アドレス、マッピングのサイズおよび共用オブジェクト・ファイルのフルパスが出力されます。この動作は、Oracle Solaris 126 \fIpmap\fRユーティリティと類似しています。 127 .RE 128 .PP 129 \-dump:[live,] format=b, file=\fIfilename\fR 130 .RS 4 131 Javaヒープを\fIhprof\fRバイナリ形式で\fIfilename\fRにダンプします。\fIlive\fRサブオプションはオプションですが、指定した場合、ヒープ内のアクティブなオブジェクトのみがダンプされます。ヒープ・ダンプを参照するには、jhat(1)コマンドを使用して生成されたファイルを読み取ります。 132 .RE 133 .PP 134 \-finalizerinfo 135 .RS 4 136 ファイナライズを待っているオブジェクトに関する情報を出力します。 137 .RE 138 .PP 139 \-heap 140 .RS 4 141 使用されているガベージ・コレクションのヒープ・サマリー、ヘッダー構成、および世代関連のヒープ使用状況を出力します。さらに、internされた文字列の数とサイズも出力されます。 142 .RE 143 .PP 144 \-histo[:live] 145 .RS 4 146 ヒープのヒストグラムを出力します。Javaクラスごとに、オブジェクトの数、バイト単位でのメモリー・サイズ、および完全修飾クラス名が出力されます。JVMの内部クラス名はアスタリスク(*)の接頭辞を付けて出力されます。\fIlive\fRサブオプションが指定された場合、アクティブなオブジェクトのみがカウントされます。 147 .RE 148 .PP 149 \-clstats 150 .RS 4 151 Javaヒープの、クラス・ローダー関連の統計データを出力します。クラス・ローダーごとに、その名前、状態、アドレス、親クラス・ローダー、およびクラス・ローダーがロードしたクラスの数とサイズが出力されます。 152 .RE 153 .PP 154 \-F 155 .RS 4 156 強制します。PIDが応答しないときに、このオプションを\fIjmap \-dump\fRまたは\fIjmap \-histo\fRオプションとともに使用します。このモードでは、\fIlive\fRサブオプションはサポートされません。 157 .RE 158 .PP 159 \-h 160 .RS 4 161 ヘルプ・メッセージが出力されます。 162 .RE 163 .PP 164 \-help 165 .RS 4 166 ヘルプ・メッセージが出力されます。 167 .RE 168 .PP 169 \-J\fIflag\fR 170 .RS 4 171 \fIjmap\fRコマンドを実行しているJava仮想マシンに\fIflag\fRを渡します。 172 .RE 173 .SH "関連項目" 174 .sp 175 .RS 4 176 .ie n \{\ 177 \h'-04'\(bu\h'+03'\c 178 .\} 179 .el \{\ 180 .sp -1 181 .IP \(bu 2.3 182 .\} 183 jhat(1) 184 .RE 185 .sp 186 .RS 4 187 .ie n \{\ 188 \h'-04'\(bu\h'+03'\c 189 .\} 190 .el \{\ 191 .sp -1 192 .IP \(bu 2.3 193 .\} 194 jps(1) 195 .RE 196 .sp 197 .RS 4 198 .ie n \{\ 199 \h'-04'\(bu\h'+03'\c 200 .\} 201 .el \{\ 202 .sp -1 203 .IP \(bu 2.3 204 .\} 205 jsadebugd(1) 206 .RE 207 .br 208 'pl 8.5i 209 'bp |