• Oracle Technology Network
• ソフトウェアダウンロード
• ドキュメント

検索

目次

トランスポート

JPDA 内では、デバッガアプリケーションは Java Debug Interface (JDI) インタフェースとコネクタ抽象を使用してターゲット VM への接続を確立します。デバッガアプリケーションによって使用されるコネクタは、トランスポートをカプセル化します。ターゲット VM では、デバッガとの通信に Java^TM Debug Wire Protocol をサポートするエージェントが使用されます。このエージェント (ターゲット VM に組み込むか、実行時ライブラリからロード可能) は、デバッガと通信するためにトランスポートをカプセル化します。

Sun では、TCP/IP に基づくソケットトランスポートと共用メモリートランスポートの 2 つのトランスポート実装を、リファレンス実装とともに出荷しています。仕様では、特定のトランスポートの実装を必要としません。この実装とともに提供されるトランスポートのほかにも、アーキテクチャーに含まれるサービスプロバイダインタフェースを使用して、別のトランスポートを開発および配備できます。

ソケットトランスポート

コマンドと応答パケットは、JDWP トランスポートインタフェースを使用して、JDWP 仕様に従ってストリームに書き込まれます。JDWP を介して多数の小さなパケットを送信できるため、TCP_NO_DELAY ソケットオプションにより、小さなパケットが送信される前にソケット実装によってバッファーされる場合に発生する可能性のある遅延を回避することによって、一部のソケット実装でパフォーマンスを向上させることができます。可能な場合は未送信のデータが送信されるように、ソケットは適切に閉じられます。

ソケットトランスポートは、dt_socket という一意の文字列で識別されます。この名前は、ターゲット VM を呼び出すときに、ソケットトランスポートを選択するために使用できます。デバッガアプリケーションでは、対応するコネクタによってソケットトランスポートがカプセル化されます。

クライアントがサーバーに接続しているコンテキストでは、ソケットトランスポートアドレスの形式は、「<name>:<port>」になります。<name> はホスト名です。また、<port> は接続または待機しているソケットポート番号です。サーバーがクライアントの接続を待機しているコンテキストでは、アドレスはポート番号だけで構成されます (ホスト名は明示されません)。

共用メモリートランスポート

共用メモリートランスポートは、dt_shmem という一意の文字列で識別されます。この名前は、ターゲット VM を呼び出すときに、ソケットトランスポートを選択するために使用できます。デバッガアプリケーションでは、対応するコネクタによって共用メモリートランスポートがカプセル化されます。

共用メモリーのトランスポートアドレスは、Microsoft Windows のファイルマッピングオブジェクトの名前として使用できます。この名前の文字列には、バックスラッシュを除く任意の文字を含めることができます。

コネクタ

実装されるコネクタをユーザーが選択および構成できるように、JDI クライアントアプリケーションを作成することもできますが、特定のコネクタに関する情報をデバッガに組み込んでおくと、ユーザーが使いやすい構成になります。JPDA で提供されている JDB の実装例では、この方法が採用されています。

JDI リファレンス実装では、使用可能なトランスポートの種類および接続モード (起動、待機、および接続) に対応するいくつかのコネクタが提供されています。それらのコネクタについて、このあとのセクションで説明します。これらのコネクタのリストは、JDI メソッド VirtualMachineManager.allConnectors() によって返されます。また、各接続コネクタ、待機コネクタ、および起動コネクタは、対応する VirtualMachineManager メソッド attachingConnectors()、listeningConnectors()、および launchingConnectors() によって返されるリストに含まれます。

Sun コマンド行起動コネクタ

このコネクタは、「com.sun.jdi.CommandLineLaunch」という名前で一意に識別されます。
 

Raw コマンド行起動コネクタ

このコネクタは、「com.sun.jdi.RawCommandLineLaunch」という名前で一意に識別されます。
 

ソケット接続コネクタ

このコネクタは、「com.sun.jdi.SocketAttach」という名前で一意に識別されます。
 

共用メモリー接続コネクタ

このコネクタは、「com.sun.jdi.SharedMemoryAttach」という名前で一意に識別されます。
 

ソケット待機コネクタ

このコネクタでは、複数のターゲット VM からの接続を受け入れることができます。

このコネクタは、「com.sun.jdi.SocketListen」という名前で一意に識別されます。
 

共用メモリー待機コネクタ

このコネクタでは、複数のターゲット VM からの接続を受け入れることができます。

このコネクタは、「com.sun.jdi.SharedMemoryListen」という名前で一意に識別されます。
 

プロセス接続コネクタ

SA コア接続コネクタ

        
${JAVA_HOME}/bin/rmiregistry -J-Xbootclasspath/p:${JAVA_HOME}/lib/sa-jdi.jar

${JAVA_HOME}/bin/java \ 
    -classpath ${JAVA_HOME}/lib/sa-jdi.jar \
    sun.jvm.hotspot.jdi.SADebugServer \
    <pid> \
    [uniqueID]

${JAVA_HOME}/bin/java \
    -classpath ${JAVA_HOME}/lib/sa-jdi.jar \
    sun.jvm.hotspot.jdi.SADebugServer \
    <pathname to the java executable that produced the core file>\
    <pathname of the corefile to debug> \
     [uniqueID]

Sun VM の呼び出しオプション

Sun の VM 実装には、デバッグ用の JDWP エージェントをロードするコマンド行オプションが必要です。5.0 以降では、JDWP エージェントをロードしたり、そのオプションを指定したりするために -agentlib:jdwp オプションが使用されます。5.0 より前のリリースでは、-Xdebug および -Xrunjdwp オプションが使用されます (5.0 の実装では、-Xdebug および -Xrunjdwp オプションもサポートされますが、5.0 の JDWP エージェントは、VM に対して以前の JVMDI インタフェースではなく JVM TI インタフェースを使用するため、新しい -agentlib:jdwp オプションの使用をお勧めします)。

デバッガアプリケーションで JDI の Sun コマンド行起動コネクタを使用する場合、5.0 より前のターゲット VM への接続にこのコネクタが使用される可能性があるため、-Xdebug および -Xrunjdwp オプションがコネクタで使用されます。

ターゲット VM が 5.0 以降の場合、-agentlib:jdwp オプションは次のように指定します。

-agentlib:jdwp=<サブオプション>

JDWP の JPDA リファレンス実装をロードする。このライブラリは、ターゲット VM に配置されており、ターゲット VM と対話するときは JVM TI および JNI が使用される。別のデバッガアプリケーションと通信するときは、トランスポートと JDWP プロトコルが使用される。各サブオプションについては、後述する説明を参照してください。

5.0 より前のリリースの場合、-Xdebug および -Xrunjdwp オプションが使用されます。

-Xdebug

デバッグを有効にする

-Xrunjdwp:<サブオプション>

JDWP の JPDA リファレンス実装をロードする。このライブラリは、ターゲット VM に配置されており、ターゲット VM と対話するときは JVMDI および JNI が使用される。別のデバッガアプリケーションと通信するときは、トランスポートと JDWP プロトコルが使用される。各サブオプションについては、後述する説明を参照してください。

-agentlib:jdwp および -Xrunjdwp サブオプション

    -agentlib:jdwp=<name1>[=<value1>],<name2>[=<value2>]...

または

    -Xrunjdwp:<name1>[=<value1>],<name2>[=<value2>]...

使用できるオプションについて、次の表で説明します。
 

例

-agentlib:jdwp=transport=dt_socket,server=y,address=8000

ポート 8000 上でソケット接続を待機する。メインクラスがロードされる前にこの VM を中断する (デフォルトでは suspend=y)。デバッガアプリケーションが接続されたあと、そのアプリケーションが JDWP コマンドを送信して VM を再開する。

-agentlib:jdwp=transport=dt_socket,server=y,address=localhost:8000,timeout=5000

ループバックアドレス上のポート 8000 でのみソケット接続を待機する。デバッガが 5 秒以内に接続しない場合は終了する。メインクラスがロードされる前にこの VM を中断する (デフォルトでは suspend=y)。デバッガアプリケーションが接続されたあと、そのアプリケーションが JDWP コマンドを送信して VM を再開する。

-agentlib:jdwp=transport=dt_shmem,server=y,suspend=n

使用可能な共用メモリートランスポートのアドレスを選択して、標準出力に出力する。そのアドレスで共用メモリー接続を待機する。デバッガアプリケーションが接続される前に、VM は実行を開始する。

-agentlib:jdwp=transport=dt_socket,address=myhost:8000

実行中のデバッガアプリケーションに対して、ホスト myhost のポート 8000 にソケットを介して接続する。メインクラスがロードされる前に、この VM を中断する。

-agentlib:jdwp=transport=dt_shmem,address=mysharedmemory

トランスポートアドレス「mysharedmemory」の共用メモリーを介して、実行中のデバッガアプリケーションに接続する。メインクラスがロードされる前に、この VM を中断する。

-agentlib:jdwp=transport=dt_socket,server=y,address=8000,onthrow=java.io.IOException,launch=/usr/local/bin/debugstub

java.io.IOException のインスタンスがこの VM でスローされるのを待機する。この VM を中断する (デフォルトでは suspend=y)。ポート 8000 でソケット接続を待機する。「/usr/local/bin/debugstub dt_socket myhost:8000」を実行する。このプログラムによって、別のウィンドウでデバッガプロセスが起動されてこの VM に接続され、デバッグが開始される。

-agentlib:jdwp=transport=dt_shmem,server=y,onuncaught=y,launch=d:\bin\debugstub.exe

uncaught 例外がこの VM でスローされるのを待機する。VM を中断する。共用メモリートランスポートのアドレスを選択し、そのアドレスで接続を待機する。「d:\bin\debugstub.exe dt_shmem <address>」を実行する。<address> は、選択された共用メモリーアドレス。このプログラムによって、別のウィンドウでデバッガプロセスが起動されてこの VM に接続され、デバッグが開始される。

Plug-in アプレットのデバッグ

JDI の起動コネクタは、Plug-in アプレットのデバッグには使用できません。

JDB との接続

JDB では、-attach オプションを指定すると、リファレンス実装の接続コネクタ (Microsoft Windows 上では共用メモリー、Solaris および Linux プラットフォーム上ではソケット) にアクセスできます。-listen オプションを指定すると、リファレンス実装の待機コネクタ (Microsoft Windows 上では共用メモリー、Solaris および Linux プラットフォーム上ではソケット) にアクセスできます。コマンド行にクラス名と引数を直接指定すると、Sun コマンド行起動コネクタにアクセスできます。

たとえば、

jdb -attach myhost:8000

上のように入力すると、ソケット接続コネクタを使用して簡単にターゲット VM に接続できます (Solaris オペレーティング環境の場合)。

jdb Hello 1 2 3

上のように入力すると、Sun コマンド行起動コネクタを使用して簡単にターゲット VM を起動できます。

ただし、JDB には -connect オプションも用意されています。これにより、コネクタ名と、名前と値の引数ペアの任意のセットを指定することによって任意のコネクタを処理できます。たとえば、上記の 2 つのコマンド行は、次のコマンド行と同じことです。

jdb -connect com.sun.jdi.SocketAttach:hostname=myhost,port=8000
jdb -connect "com.sun.jdi.CommandLineLaunch:main=Hello 1 2 3"

これらのコマンド行は、最初の例よりも複雑ですが、-connect オプションを指定すれば任意のコネクタを使用できます。これらの操作から、JDI デバッガでは、任意のコネクタを使用できることがわかります。また、よく使われるコネクタを使用するための簡単なインタフェースも提供されています。

サービスプロバイダインタフェース

JPDA に含まれているサービスプロバイダインタフェースを使うと、コネクタやトランスポートの実装を開発および配置できます。これらのサービスプロバイダインタフェースにより、デバッガやほかのツールベンダーで新しいコネクタ実装を開発し、Sun が提供するソケットおよび共用メモリートランスポートを超える別のトランスポートメカニズムを提供できます。JDI のサービスプロバイダインタフェースは、com.sun.jdi.connect.spi パッケージで指定されます。

JDI のサービスプロバイダインタフェースに加え、Sun の実装には、Java ^TMDebug Wire Protocol Transport Interface と呼ばれるトランスポートライブラリインタフェースも含まれています。トランスポートライブラリは、ターゲット VM の JDWP エージェントによってロードされ、デバッガとの接続の確立、およびデバッガと VM 間の JDWP パケットのトランスポートに使用されます。

サービスプロバイダインタフェースに関する詳細は、「Java^TM Platform Debugger Architecture - サービスプロバイダインタフェース」のドキュメントを参照してください。