diff -r fd16c54261b3 -r 90ce3da70b43 jdk/src/solaris/doc/sun/man/man1/ja/jdb.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/jdk/src/solaris/doc/sun/man/man1/ja/jdb.1 Sat Dec 01 00:00:00 2007 +0000 @@ -0,0 +1,504 @@ +'\" t +.\" Copyright 2006 Sun Microsystems, Inc. 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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, +.\" CA 95054 USA or visit www.sun.com if you need additional information or +.\" have any questions. +.\" ` +.\" +.\" This document was created by saving an HTML file as text +.\" from the JavaSoft web site: +.\" +.\" http://java.sun.com/j2se/1.4/docs/tooldocs/tools.html +.\" +.\" and adding appropriate troff macros. Because the JavaSoft web site +.\" man pages can change without notice, it may be helpful to diff +.\" files to identify changes other than new functionality. +.\" +.TH jdb 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド" +.SH "名前" +jdb \- Java デバッガ +.LP + +.LP +.LP +\f3jdb\fP は、Java 言語プログラムのバグを見つけて修正するために使用するツールです。 +.LP +.SH "形式" +.B jdb +[ +.I options +] [ +.I class +] [ +.I arguments +] +.LP +.TP 15 +.I options +以下に指定するコマンド行オプション +.TP +.I class +デバッグを開始するクラス名 +.TP +.I arguments +クラスの +.B main(\|) +メソッドに渡される引数 +.SH "機能説明" +.IX "Java debugger" "" "Java debugger \(em \fLjdb\fP" +.IX "jdb" "" "\fLjdb\fP \(em Java debugger" +Java デバッガの +.BR jdb +は、 +Java +クラス用の単純なコマンド行デバッガです。 +.na +「\f2Java Platform Debugger Architecture\fP」 +.fi + (http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html) +を画面に表示しながら実行し、ローカルまたはリモートの Java 仮想マシン +の検査とデバッグを行うことができます。 +.SS "jdb セッションの開始" +.IX "jdb" "Starting a jdb Session" "\fLjdb\fP \(em Java debugger" +jdb セッションを開始するにはさまざまな方法があります。 もっとも頻繁に使 +われるのは、アプリケーションのメインクラスをデバッグして、 +.B jdb +から新しく Java 仮想マシン (VM) を起動する方法です。 コマンド行で、 +.BR java (1) +の代わりに +.B jdb +コマンドを入力します。たとえば、アプリケーションのメインクラスが +.BR MyClass +の場合は、次のコマンドを使用して jdb 環境でデバッグします。 +.LP +.RS +.B % jdb MyClass +.RE +.LP +このようにして起動すると、 +.B jdb +は 2 つ目の Java VM を呼び出し、指定されたパラメータを渡し、 +指定されたクラスをロードします。そのあと、 +クラスの最初の命令を実行する前に VM を停止させます。 +.LP +.B jdb +のもう 1 つの使用方法は、すでに起動している Java VM に +.B jdb +を接続することです。 +jdb が接続する VM を、その実行中に起動するための構文を次に示します。 これは、インプロセスデバッグ用ライブラリをロードし、接続の種類を指定します。 +.LP +.nf +\f3 +.fl +\-agentlib:jdwp=transport=dt_socket,server=y,suspend=n +.fl +\fP +.fi + +.LP +.LP +たとえば、次のコマンドは +.B MyClass +アプリケーションを実行し、後で +.B jdb +を接続できるようにします。 +.LP +.nf +\f3 +.fl + % java \-agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n MyClass +.fl +\fP +.fi + +.LP +.LP +次のコマンドで +.B jdb +を VM に接続できます。 +.LP +.RS +.B % jdb \-attach 8000 +.RE +.LP +このとき、 +.B jdb +は新しい VM を起動するのではなく、既存の VM に接続するので、 +.B jdb +コマンド行で +.B MyClass +を指定しないことに注意してください。 +.LP +これ以外にもデバッガ (jdb) を VM に接続する方法はたくさんあり、 +.BR jdb +はそのすべての方法をサポートしています。 +このような接続オプションについては、 +.fi +http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html +で Java Platform Debugger Architecture のマニュアルを参照してください。 +\f3jdb\fP で使用するために J2SE 1.4.2 以前の VM を起動する方法については、 +.fi +http://java.sun.com/j2se/1.4.2/docs/technotes/guides/jpda/conninv.html +の 1.4.2 のドキュメントを参照してください。 +.SS " jdb 基本コマンド" +.IX "jdb" "Basic jdb Commands" "\fLjdb\fP \(em Java debugger" +以下に +.B jdb +基本コマンドの一覧を示します。 +Java +デバッガで使用可能なその他のコマンドは、 +.B help +コマンドで表示できます。 +.TP 15 +.B help または ? +.BR jdb +のコマンドの中でもっとも重要なのが、この +.B help +コマンドです。利用可能なコマンドの一覧を、 +各コマンドの簡単な説明つきで表示します。 +.TP 15 +.B run +.BR jdb +を起動して必要なブレークポイントを設定したあとに、このコマンドを使用して、 +デバッグするアプリケーションの実行を開始します。このコマンドは、 +デバッグするアプリケーションを +.B jdb +から起動するときにだけ使用できます。 +既存の VM に接続する場合とは異なります。 +.TP +.B cont +ブレークポイント、例外、またはステップ実行のあとで、デバッグ中の +アプリケーションの実行を継続します。 +.TP 15 +.B print +Java オブジェクトおよびプリミティブ値を表示します。 プリミティブ型の変数 +またはフィールドの場合には、実際の値を出力します。 オブジェクトの場合 +には、短い説明を出力します。 オブジェクトについては、以降の +.B dump +コマンドの説明を参照してください。 +.sp 1n +.LP +注: 局所 +(スタック) +変数をブラウズするには、そのクラスが +.B javac \-g +オプションでコンパイルされている必要があります。 +.sp 1n +.LP +.B print +は、メソッドの呼び出しを含む多数の簡単な Java 式をサポートします。 +次に例を示します。 +.RS +.TP 3 +\(bu +.B print MyClass.myStaticField +.PD 0 +.TP +\(bu +.B print myObj.myInstanceField +.TP +\(bu +\f3print\f1 \f2i\f1 \f3+\f1 \f2j\f1 \f3+\f1 \f2k\f1 ( +.IR i、 +.IR j 、 +および +.I k +はプリミティブであり、フィールドまたは局所変数のいずれか) +.TP +\(bu +\f3print myObj.myMethod(\|)\f1 ( +.B myMethod +が null 以外を返す場合) +.TP +\(bu +.B print new java.lang.String("Hello").length(\|) +.RE +.PD +.TP +.B dump +プリミティブ値の場合には、このコマンドは +.BR print +と同じです。オブジェクトの場合には、オブジェクト内に定義されている +各フィールドの現在の値を出力します。 static フィールドと instance +フィールドを出力します。 +.sp 1n +.LP +.B dump +コマンドは、 +.B print +コマンドと同じ式をサポートします。 +.TP +.B threads +現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、 +およびほかのコマンドに使用できるインデックスを出力します。次に例を +示します。 +.sp 1n +.RS 20 +.LP +.B 4. (java.lang.Thread)0x1 main running +.RE +.RS +.sp 1n +.LP +この例では、スレッドインデックスは +.BR 4 +であり、スレッドは +.BR java.lang.Thread +のインスタンスです。スレッドの名前は「 +.BR main +」であり、現在実行中です。 +.RE +.TP 15 +.B thread +現在のスレッドを選択します。 多くの +.B jdb +コマンドは、現在のスレッドの設定に基づいて実行されます。 スレッドは、 +.B threads +コマンドで説明するスレッドインデックスとともに指定します。 +.TP 15 +.B where +引数のない +.B where +コマンドは、現在のスレッド +( +.B thread +コマンドで設定) +のスタックをダンプします。 +.B where all +と指定すると、現在のスレッドグループにある全スレッドの +スタックをダンプします。 +.BI where " threadindex" +と指定すると、 +.I threadindex +が示すスレッドのスタックだけをダンプします。 +.sp 1n +.LP +現在のスレッドが (ブレークポイントなどのイベントや +.B suspend +コマンドで) 中断している場合、 +.B print +コマンドや +.B dump +コマンドを使用すれば、局所変数やフィールドを表示できます。 +どのスタックフレームを現在のフレームにするかは、 +.B up +および +.B down +コマンドで選択できます。 +.SS "ブレークポイント用コマンド" +.IX "jdb" "Breakpoints" "\fLjdb\fP \(em Java debugger" +.B jdb +では、ブレークポイントを行番号で、 +またはメソッドの最初の命令で +設定できます。次に例を示します。 +.TP 25 +.B stop at MyClass:22 +.BR MyClass +が含まれるソースファイルの +.B 22 +行目の最初の命令にブレークポイントを設定する +.TP +.B stop in java.lang.String.length +.BR java.lang.String.length +メソッドの最初にブレークポイントを設定する +.TP +.BI "stop in MyClass." init +.I init +は +.B MyClass +コンストラクタを識別する +.TP +.BI "stop in MyClass." clinit +.I clinit +は +.BR MyClass +の静的な初期化コードを識別する +.LP +メソッドがオーバーロードされる場合には、メソッドの引数の型も指定して、 +ブレークポイントに対して適切なメソッドが選択されるようにしなければなりませ +ん。 たとえば、次のように指定します。 +.LP +.RS 15 +.B MyClass.myMethod(int,java.lang.String) +.RE +.LP +または +.LP +.RS 15 +.B MyClass.myMethod() +.RE +.LP +.B clear +コマンドは、「 +.BR clear MyClass:45 +」のような構文を使用してブレークポイントを削除します。 +引数を指定しないで +.B clear +コマンドを使用すると、現在設定されてい +るすべてのブレークポイントが表示されます。 +.B cont +コマンドで実行が継続します。 +.SS "コマンドのステップ実行" +.IX "jdb" "Stepping" "\fLjdb\fP \(em Java debugger" +.B step +コマンドは、現在のスタックフレームまたは呼び出されたメソッド内で、 +次の行を実行します。 +.B next +コマンドは、現在のスタックフレームの次の行を +実行します。 +.SS "例外処理用コマンド" +.IX "jdb" "Exceptions" "\fLjdb\fP \(em Java debugger" +スローしているスレッドの呼び出しスタック上のどこにも catch 文がないような +例外が発生すると、VM は通常、例外トレースを出力して終了します。 ただし、 +.BR jdb +環境で実行している場合は、このような例外が発生すると +.B jdb +に制御が戻ります。 次に、 +.BR jdb +を使用して例外の原因を診断します。 +.TP 15 +.B catch +デバッグ中のアプリケーションは他の例外がスローされたところで停止します。 +次に例を示します。 +.LP +.RS 20 +.B catch java.io.FileNotFoundException +.RE +.sp 1n +.RS 15 +または +.RE +.LP +.RS 20 +.B catch mypackage.BigTroubleException +.RE +.sp 1n +.RS 15 +例外が指定したクラス (または、サブクラス) のインスタンスである場合、 +アプリケーションはスローされたところで停止します。 +.RE +.TP 15 +.B ignore +以前の +.B catch +コマンドの効果を無効にします。なお、この指定によって例外を無視するのは +デバッガだけであり、デバッグされた VM は無視しません。 +.SH "コマンド行オプション" +コマンド行で Java アプリケーション起動ツールの代わりに +.B jdb +を使用する場合、 +.B jdb +は、 +.BR \-D、 +.BR \-classpath、 +.BI \-X option\f1 +など、 +.BR java (1) +コマンドと同じオプションを多数使用できます。 +.LP +.B jdb +は、そのほかに次のオプションも使用できます。 +.TP 3 +.BI \-help +ヘルプメッセージを表示します。 +.TP 3 +.BI \-sourcepath " dir1\f1:\f2dir2\f1:..." +指定されたパスで、ソースファイルを検索します。 このオプションが +指定されていない場合は、デフォルトパスの「.」を検索します。 +.TP +.BI \-attach " address" +デフォルトの接続機構を使用して、すでに実行中の VM にデバッガを接続 +します。 +.TP +.BI \-listen " address" +実行中の VM が標準のコネクタを使って指定されたアドレスに接続するのを待機します。 +.TP +.BI \-listenany +実行中の VM が標準のコネクタを使って利用可能な任意のアドレスに接続するのを待機します。 +.TP +.B \-launch +デバッグするアプリケーションを +.BR jdb +の起動後ただちに起動します。 このオプションを使用すると、 +.B run +コマンドを使用する必要はありません。 デバッグするアプリケーションは、 +起動後、最初のアプリケーションクラスがロードされる直前に停止します。 +その時点で、必要なブレークポイントを設定できます。 +実行を継続するには +.B cont +コマンドを使用します。 +.TP 3 +\-listconnectors +この VM で利用できるコネクタを一覧表示します。 +.TP 3 +\-connect +:=,... +一覧表示された引数の値と指定のコネクタを使ってターゲット VM に接続します。 +.TP 3 +\-dbgtrace [flags] +jdb のデバッグ情報を出力します。 +.TP 3 +\-tclient +Java HotSpot(tm) VM (クライアント) 内でアプリケーションを実行します。 +.TP 3 +\-tserver +Java HotSpot(tm) VM (サーバ) 内でアプリケーションを実行します。 +.TP +.BI \-J "option" +jdb の実行に使用される Java 仮想マシンに \f2option\fP を渡します。(アプリケーション Java 仮想マシンに対するオプションは、\f3run\fP コマンドに渡される。) +たとえば、 +.I \-J-Xms48m +は、起動時に使用するメモリを 48M バイトに設定します。 + + +.LP +これ以外にも、デバッガをデバッグされる VM に接続するための代替機構 +用のオプションがサポートされています。 +このような接続の代替機構については、 +.fi +http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html +の Java Platform Debugger Architecture のマニュアルを参照してください。 +.LP +.SS +デバッグ対象のプロセスに転送されるオプション +.LP +.TP 3 +\-v \-verbose[:class|gc|jni] +冗長モードにします。 +.TP 3 +\-D= +システムプロパティを設定します。 +.TP 3 +\-classpath +クラスを検索するディレクトリを一覧表示します。 +.TP 3 +\-X