src/linux/doc/man/ja/jstack.1

Print this page


   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 jstack 1 "07 May 2011"
  23 
  24 .LP
  25 .SH "名前"
  26 jstack \- スタックトレース
  27 .br
  28 
  29 .LP
  30 .RS 3
  31 .TP 2
  32 o
  33 形式 
  34 .TP 2
  35 o
  36 パラメータ
  37 .br
  38 .TP 2
  39 o
  40 説明 
  41 .TP 2
  42 o
  43 オプション 
  44 .TP 2
  45 o
  46 関連項目 
  47 .TP 2
  48 o
  49 既知のバグ
  50 .br











  51 .RE
  52 
  53 .LP
  54 .SH "形式"
  55 .LP

  56 .nf
  57 \f3
  58 .fl
  59 \fP\f3jstack\fP [ option ] pid
  60 .fl
  61 \f3jstack\fP [ option ] executable core
  62 .fl
  63 \f3jstack\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
  64 .fl
  65 .fi
  66 
  67 .LP
  68 .SH "パラメータ"
  69 .LP
  70 .LP
  71 各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。オプションを参照してください。
  72 .LP
  73 .RS 3
  74 .TP 3
  75 pid 
  76 印刷するスタックトレースのプロセス ID です。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。 
  77 .RE
  78 
  79 .LP
  80 .RS 3
  81 .TP 3
  82 executable 
  83 コアダンプの作成元の Java 実行可能ファイルです。 
  84 .br
  85 .TP 3
  86 core 
  87 印刷するスタックトレースのコアファイルです。 
  88 .br
  89 .TP 3
  90 remote\-hostname\-or\-IP 
  91 リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。 
  92 .br
  93 .TP 3
  94 server\-id 
  95 複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。 












  96 .RE
  97 
  98 .LP
  99 .SH "説明"
 100 .LP
 101 .LP
 102 \f3jstack\fP は、指定された Java プロセスやコアファイルまたはリモートデバッグサーバーに対する Java スレッドの Java スタックトレースを印刷します。Java フレームごとに、フルクラス名、メソッド名、「bci」(バイトコードインデックス)、および行番号 (利用可能な場合) が印刷されます。\-m オプションを使用すると、jstack は、すべてのスレッドの Java フレームとネイティブフレームの両方を、「pc」(プログラムカウンタ) とともに印刷します。ネイティブフレームごとに、「pc」にもっとも近いネイティブシンボル (利用可能な場合) が印刷されます。C++ 分解名は分解解除されません。C++ 名を分解解除するには、このコマンドの出力を \f3c++filt\fP にパイプします。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
 103 .br
 104 
 105 .LP




 106 .nf
 107 \f3
 108 .fl
 109 jstack \-J\-d64 \-m pid
 110 .fl
 111 \fP
 112 .fi
 113 
 114 .LP
 115 .LP
 116 \f3注\fP \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \f2PATH\fP 環境変数には、ターゲットプロセスによって使用される \f2jvm.dll\fP の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。
 117 .LP
 118 .LP
 119 次に例を示します。 \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
 120 .LP
 121 .SH "オプション"
 122 .LP
 123 .RS 3
 124 .TP 3
 125 \-F 
 126 「jstack [\-l] pid」が応答しない場合にスタックダンプを強制します。 
 127 .TP 3




 128 \-l 
 129 長形式のリスト。所有 java.util.concurrent の
 130 .na
 131 \f2所有できるシンクロナイザ\fP @
 132 .fi
 133 http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.htmlの一覧など、ロックについての追加情報を印刷します。 
 134 .TP 3
 135 \-m 
 136 混合モード (Java およびネイティブ C/C++ フレームの両方) のスタックトレースを印刷します。 
 137 .TP 3


 138 \-h 
 139 ヘルプメッセージを印刷します。
 140 .br
 141 .br
 142 .TP 3
 143 \-help 
 144 ヘルプメッセージを出力します。
 145 .br
 146 .RE
 147 
 148 .LP

 149 .SH "関連項目"
 150 .LP
 151 .RS 3
 152 .TP 2
 153 o





 154 pstack(1) 
 155 .TP 2
 156 o
 157 c++filt(1) 
 158 .TP 2
 159 o
















 160 jps(1) 
 161 .TP 2
 162 o








 163 jsadebugd(1) 
 164 .RE
 165 
 166 .LP
 167 .SH "既知のバグ"
 168 .LP
 169 .LP
 170 混合モードのスタックトレース (\-m オプション使用) は、リモートデバッグサーバーでは機能しません。
 171 .LP
 172  
   1 '\" t
   2 .\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
   3 .\" Title: jstack
   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 "jstack" "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 jstack \- Javaプロセス、コア・ファイルまたはリモート・デバッグ・サーバーに対するJavaスレッドのスタック・トレースを出力します。このコマンドは試験的なもので、サポートされていません。
  53 .SH "概要"
  54 .sp
  55 .if n \{\
  56 .RS 4
  57 .\}
  58 .nf
  59 \fIjstack\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 \fIjstack\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 \fIjstack\fR [ \fIoptions\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 \fIjstack\fRコマンドは、指定されたJavaプロセス、コア・ファイルまたはリモート・デバッグ・サーバーに対するJavaスレッドのJavaスタック・トレースを出力します。Javaフレームごとに、フルクラス名、メソッド名、バイトコード・インデックス(bci)、および行番号(利用可能な場合)が出力されます。\fI\-m\fRオプションを使用すると、\fIjstack\fRコマンドは、すべてのスレッドのJavaフレームとネイティブ・フレームの両方を、プログラム・カウンタ(PC)とともに出力します。ネイティブ・フレームごとに、PCに最も近いネイティブ・シンボル(利用可能な場合)が出力されます。C++分解名は分解解除されません。C++名を分解解除するには、このコマンドの出力を\fIc++filt\fRにパイプします。指定されたプロセスが64ビットJava仮想マシン上で実行されている場合は、\fI\-J\-d64\fRオプションを指定する必要があります(例:
 117 \fIjstack \-J\-d64 \-m pid\fR)。
 118 .PP
 119 \fB注意\fR
 120 このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。dbgeng\&.dllファイルが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。また、\fIPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。次に例を示します。
 121 .sp
 122 .if n \{\
 123 .RS 4
 124 .\}
 125 .nf
 126 set PATH=<jdk>\ejre\ebin\eclient;%PATH%




 127 .fi
 128 .if n \{\
 129 .RE
 130 .\}





 131 .SH "オプション"
 132 .PP


 133 \-F
 134 .RS 4
 135 \fIjstack\fR
 136 [\fI\-l\fR]
 137 \fIpid\fRが応答しない場合にスタック・ダンプを強制します。
 138 .RE
 139 .PP
 140 \-l
 141 .RS 4
 142 長形式のリスト。所有\fIjava\&.util\&.concurrent\fRの所有できるシンクロナイザの一覧など、ロックについての追加情報を印刷します。http://docs\&.oracle\&.com/javase/8/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer\&.htmlにある
 143 \fIAbstractOwnableSynchronizer\fRクラス記述を参照してください
 144 .RE
 145 .PP

 146 \-m
 147 .RS 4
 148 JavaおよびネイティブC/C++フレームの両方を持つ混合モードのスタック・トレースを出力します。
 149 .RE
 150 .PP
 151 \-h
 152 .RS 4
 153 ヘルプ・メッセージが出力されます。
 154 .RE
 155 .PP
 156 \-help
 157 .RS 4
 158 ヘルプ・メッセージが出力されます。
 159 .RE
 160 .SH "既知の不具合"
 161 .PP
 162 混合モードのスタック・トレースでは、\fI\-m\fRオプションはリモート・デバッグ・サーバーでは機能しません。
 163 .SH "関連項目"
 164 .sp
 165 .RS 4
 166 .ie n \{\
 167 \h'-04'\(bu\h'+03'\c
 168 .\}
 169 .el \{\
 170 .sp -1
 171 .IP \(bu 2.3
 172 .\}
 173 pstack(1)
 174 .RE
 175 .sp
 176 .RS 4
 177 .ie n \{\
 178 \h'-04'\(bu\h'+03'\c
 179 .\}
 180 .el \{\
 181 .sp -1
 182 .IP \(bu 2.3
 183 .\}
 184 C++filt(1)
 185 .RE
 186 .sp
 187 .RS 4
 188 .ie n \{\
 189 \h'-04'\(bu\h'+03'\c
 190 .\}
 191 .el \{\
 192 .sp -1
 193 .IP \(bu 2.3
 194 .\}
 195 jps(1)
 196 .RE
 197 .sp
 198 .RS 4
 199 .ie n \{\
 200 \h'-04'\(bu\h'+03'\c
 201 .\}
 202 .el \{\
 203 .sp -1
 204 .IP \(bu 2.3
 205 .\}
 206 jsadebugd(1)
 207 .RE
 208 .br
 209 'pl 8.5i
 210 'bp