jhsdbコマンド

名前

jhsdb - Javaプロセスにアタッチするか、postmortemデバッガを起動して、クラッシュしたJava Virtual Machine (JVM)からのコア・ダンプの内容を分析

シノプシス

jhsdb clhsdb [--pid pid | --exe executable --core coredump]

jhsdb debugd [options] (pid | executable coredump) [server-id]

jhsdb hsdb [--pid pid | --exe executable --core coredump]

jhsdb jstack [--pid pid | --exe executable --core coredump] [options]

jhsdb jmap [--pid pid | --exe executable --core coredump] [options]

jhsdb jinfo [--pid pid | --exe executable --core coredump] [options]

jhsdb jsnap [options] [--pid pid | --exe executable --core coredump]

pid

jhsdbツールの接続先となるプロセスIDです。 プロセスはJavaプロセスである必要があります。 マシン上で実行されているJavaプロセスのリストを取得するには、psコマンドを使用するか、JVMプロセスが別のDockerインスタンスで実行されていない場合はjpsコマンドを使用します。

ノート: JDK 10は、別のドッキング・プロセスで実行されているJavaプロセスにアタッチするときにAPIを使用するためのサポートを追加しました。 ただし、jpsコマンドでは、別のDockerインスタンスで実行されているJVMプロセスをリストしません。 Dockerコンテナ内の仮想マシンとLinuxホストの接続を試みる場合は、psなどのツールを使用して、JVMのPIDを参照する必要があります。

server-id

複数のデバッグ・サーバーが同一のリモート・ホストで実行している場合に使用するオプション固有のIDです。

executable

コア・ダンプの作成元となるJava実行可能ファイルです。

coredump

jhsdbツールの接続先となるコア・ファイルです。

options

jhsdbモードでのコマンド行オプションです。 「jhsdbモードの共通オプション」、「debugdモードのオプション」、「jinfoモードのオプション」、「jmapモードのオプション」、「jmapモードのオプション」、「jstackモードのオプション」および「jsnapモードのオプション」を参照してください。

注:

pid、またはexecutableとcoreファイルのペアのいずれかを指定する必要があります。

説明

jhsdbツールは、Javaプロセスに接続するか、事後デバッガを起動して、クラッシュしたJava仮想マシン(JVM)からのコア・ダンプの内容を分析する場合に使用します。 このコマンドは試験的なものであり、サポート対象外になっています。

注:

jhsdbツールをライブ・プロセスに接続すると、プロセスはハングし、デバッガによる切離しの際にクラッシュする可能性があります。

jhsdbツールは、次のモードのいずれかで起動できます。

jhsdb clhsdb

対話型コマンドライン・デバッガを起動します。

jhsdb debugd

リモート・デバッグ・サーバーを開始します。

jhsdb hsdb

対話型GUIデバッガを開始します。

jhsdb jstack

スタックして情報をロックします。

jhsdb jmap

ヒープ情報を出力します。

jhsdb jinfo

基本的なJVM情報を出力します。

jhsdb jsnap

パフォーマンス・カウンタ情報を印刷します。

jhsdbモードの共通オプション

必須のjstack、jmap、jinfoまたはjsnapモード固有のオプションに加えて、pid、exeまたはcoreオプションは、すべてのモードに対して指定する必要があります。 次のオプションは、すべてのモードで使用できます。

--pid

ぶら下がりプロセスのプロセスID。

--exe

実行可能ファイル名。

--core

コア・ダンプ・ファイル名。

--help

コマンドで使用できるオプションを表示します。

debugdモードのオプション

server-id

このデバッグ・サーバーのオプションの一意のID。 これは、複数のデバッグ・サーバーを同じマシン上で実行する場合に必要です。

jinfoモードのオプション

オプションが指定されていないと、jhsdb jinfoは、フラグとプロパティの両方を出力します。

--flags

VMフラグを出力します。

--sysprops

Javaシステム・プロパティを出力します。

オプションなし

VMフラグおよびJavaシステム・プロパティを出力します。

jmapモードのオプション

次のモード固有のオプションに加えて、pid、exeまたはcoreオプション(「jhsdbモードの共通オプション」を参照)を指定する必要があります。

オプションなし

Solarisのpmapと同じ情報を出力します。

--heap

javaヒープ・サマリーを出力します。

--binaryheap

javaヒープをhprofバイナリ形式でダンプします。

--dumpfile

ダンプファイルの名前を出力します。

--histo

javaオブジェクト・ヒープのヒストグラムを出力します。

--clstats

クラス・ローダーの統計情報を出力します。

--finalizerinfo

ファイナライズを待機しているオブジェクトに関する情報を出力します。

jstackモードのオプション

次のモード固有のオプションに加えて、pid、exeまたはcoreオプション(「jhsdbモードの共通オプション」を参照)を指定する必要があります。

--locks

java.util.concurrentのロック情報を出力します。

--mixed

javaと、プラットフォームで使用できる場合はネイティブ・フレームの両方を出力しようとします。

jsnapモードのオプション

次のモード固有のオプションに加えて、pid、exeまたはcoreオプション(「jhsdbモードの共通オプション」を参照)を指定する必要があります。

--all

すべてのパフォーマンス・カウンタを出力します。