jdk/src/linux/doc/man/ja/jstack.1
author mfang
Tue, 10 May 2011 12:31:42 -0700
changeset 9566 d7241af95355
parent 9352 cabba0c0f3ee
child 23600 d21826f6c789
permissions -rw-r--r--
7043580: integrate man page translation drop 2 into jdk7 Reviewed-by: yhuang

." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jstack 1 "07 May 2011"

.LP
.SH "名前"
jstack \- スタックトレース
.br

.LP
.RS 3
.TP 2
o
形式 
.TP 2
o
パラメータ
.br
.TP 2
o
説明 
.TP 2
o
オプション 
.TP 2
o
関連項目 
.TP 2
o
既知のバグ
.br
.RE

.LP
.SH "形式"
.LP
.nf
\f3
.fl
\fP\f3jstack\fP [ option ] pid
.fl
\f3jstack\fP [ option ] executable core
.fl
\f3jstack\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
.fl
.fi

.LP
.SH "パラメータ"
.LP
.LP
各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。オプションを参照してください。
.LP
.RS 3
.TP 3
pid 
印刷するスタックトレースのプロセス ID です。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。 
.RE

.LP
.RS 3
.TP 3
executable 
コアダンプの作成元の Java 実行可能ファイルです。 
.br
.TP 3
core 
印刷するスタックトレースのコアファイルです。 
.br
.TP 3
remote\-hostname\-or\-IP 
リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。 
.br
.TP 3
server\-id 
複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。 
.RE

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

.LP
.nf
\f3
.fl
jstack \-J\-d64 \-m pid
.fl
\fP
.fi

.LP
.LP
\f3注\fP \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \f2PATH\fP 環境変数には、ターゲットプロセスによって使用される \f2jvm.dll\fP の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。
.LP
.LP
次に例を示します。 \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
.LP
.SH "オプション"
.LP
.RS 3
.TP 3
\-F 
「jstack [\-l] pid」が応答しない場合にスタックダンプを強制します。 
.TP 3
\-l 
長形式のリスト。所有 java.util.concurrent の
.na
\f2所有できるシンクロナイザ\fP @
.fi
http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.htmlの一覧など、ロックについての追加情報を印刷します。 
.TP 3
\-m 
混合モード (Java およびネイティブ C/C++ フレームの両方) のスタックトレースを印刷します。 
.TP 3
\-h 
ヘルプメッセージを印刷します。
.br
.br
.TP 3
\-help 
ヘルプメッセージを出力します。
.br
.RE

.LP
.SH "関連項目"
.LP
.RS 3
.TP 2
o
pstack(1) 
.TP 2
o
c++filt(1) 
.TP 2
o
jps(1) 
.TP 2
o
jsadebugd(1) 
.RE

.LP
.SH "既知のバグ"
.LP
.LP
混合モードのスタックトレース (\-m オプション使用) は、リモートデバッグサーバーでは機能しません。
.LP