1 '\" t
   2 .\" Copyright 2006 Sun Microsystems, Inc.  All Rights Reserved.
   3 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4 .\"
   5 .\" This code is free software; you can redistribute it and/or modify it
   6 .\" under the terms of the GNU General Public License version 2 only, as
   7 .\" published by the Free Software Foundation.
   8 .\"
   9 .\" This code is distributed in the hope that it will be useful, but WITHOUT
  10 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11 .\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  12 .\" version 2 for more details (a copy is included in the LICENSE file that
  13 .\" accompanied this code).
  14 .\"
  15 .\" You should have received a copy of the GNU General Public License version
  16 .\" 2 along with this work; if not, write to the Free Software Foundation,
  17 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  18 .\"
  19 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  20 .\" or visit www.oracle.com if you need additional information or have any
  21 .\" questions.
  22 .\" ` 
  23 .\" 
  24 .\"  This document was created by saving an HTML file as text
  25 .\"  from the JavaSoft web site:
  26 .\" 
  27 .\" http://java.sun.com/j2se/1.4/docs/tooldocs/tools.html
  28 .\" 
  29 .\"  and adding appropriate troff macros.  Because the JavaSoft web site 
  30 .\"  man pages can change without notice, it may be helpful to diff
  31 .\"  files to identify changes other than new functionality. 
  32 .\" 
  33 .TH jdb 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
  34 .SH "名前"
  35 jdb \- Java デバッガ
  36 .LP
  37 
  38 .LP
  39 .LP
  40 \f3jdb\fP は、Java 言語プログラムのバグを見つけて修正するために使用するツールです。
  41 .LP
  42 .SH "形式"
  43 .B jdb 
  44 [ 
  45 .I options
  46 ] [
  47 .I class
  48 ] [
  49 .I  arguments
  50 ]
  51 .LP
  52 .TP 15
  53 .I options
  54 以下に指定するコマンド行オプション
  55 .TP
  56 .I class
  57 デバッグを開始するクラス名
  58 .TP
  59 .I arguments
  60 クラスの
  61 .B main(\|)
  62 メソッドに渡される引数
  63 .SH "機能説明"
  64 .IX "Java debugger" "" "Java debugger \(em \fLjdb\fP"
  65 .IX "jdb" "" "\fLjdb\fP \(em Java debugger"
  66 Java デバッガの
  67 .BR jdb
  68 は、
  69 Java
  70 クラス用の単純なコマンド行デバッガです。
  71 .na
  72 「\f2Java Platform Debugger Architecture\fP」
  73 .fi
  74  (http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html) 
  75 を画面に表示しながら実行し、ローカルまたはリモートの Java 仮想マシン
  76 の検査とデバッグを行うことができます。
  77 .SS "jdb セッションの開始"
  78 .IX "jdb" "Starting a jdb Session" "\fLjdb\fP \(em Java debugger"
  79 jdb セッションを開始するにはさまざまな方法があります。 もっとも頻繁に使
  80 われるのは、アプリケーションのメインクラスをデバッグして、
  81 .B jdb
  82 から新しく Java 仮想マシン (VM) を起動する方法です。 コマンド行で、
  83 .BR java (1)
  84 の代わりに
  85 .B jdb
  86 コマンドを入力します。たとえば、アプリケーションのメインクラスが
  87 .BR MyClass
  88 の場合は、次のコマンドを使用して jdb 環境でデバッグします。
  89 .LP
  90 .RS
  91 .B % jdb MyClass
  92 .RE
  93 .LP
  94 このようにして起動すると、
  95 .B jdb
  96 は 2 つ目の Java VM を呼び出し、指定されたパラメータを渡し、
  97 指定されたクラスをロードします。そのあと、
  98 クラスの最初の命令を実行する前に VM を停止させます。
  99 .LP
 100 .B jdb
 101 のもう 1 つの使用方法は、すでに起動している Java VM に
 102 .B jdb
 103 を接続することです。
 104 jdb が接続する VM を、その実行中に起動するための構文を次に示します。 これは、インプロセスデバッグ用ライブラリをロードし、接続の種類を指定します。
 105 .LP
 106 .nf
 107 \f3
 108 .fl
 109 \-agentlib:jdwp=transport=dt_socket,server=y,suspend=n
 110 .fl
 111 \fP
 112 .fi
 113 
 114 .LP
 115 .LP
 116 たとえば、次のコマンドは
 117 .B MyClass
 118 アプリケーションを実行し、後で
 119 .B jdb 
 120 を接続できるようにします。
 121 .LP
 122 .nf
 123 \f3
 124 .fl
 125  % java \-agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n MyClass
 126 .fl
 127 \fP
 128 .fi
 129 
 130 .LP
 131 .LP
 132 次のコマンドで
 133 .B jdb 
 134 を VM に接続できます。
 135 .LP
 136 .RS
 137 .B % jdb \-attach 8000
 138 .RE
 139 .LP
 140 このとき、
 141 .B jdb
 142 は新しい VM を起動するのではなく、既存の VM に接続するので、
 143 .B jdb 
 144 コマンド行で
 145 .B MyClass
 146 を指定しないことに注意してください。
 147 .LP
 148 これ以外にもデバッガ (jdb) を VM に接続する方法はたくさんあり、
 149 .BR jdb
 150 はそのすべての方法をサポートしています。
 151 このような接続オプションについては、
 152 .fi
 153 http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html
 154 で Java Platform Debugger Architecture のマニュアルを参照してください。
 155 \f3jdb\fP で使用するために J2SE 1.4.2 以前の VM を起動する方法については、
 156 .fi
 157 http://java.sun.com/j2se/1.4.2/docs/technotes/guides/jpda/conninv.html
 158 の 1.4.2 のドキュメントを参照してください。
 159 .SS " jdb 基本コマンド"
 160 .IX "jdb" "Basic jdb Commands" "\fLjdb\fP \(em Java debugger"
 161 以下に
 162 .B jdb
 163 基本コマンドの一覧を示します。
 164 Java
 165 デバッガで使用可能なその他のコマンドは、
 166 .B help
 167 コマンドで表示できます。
 168 .TP 15
 169 .B help または ?
 170 .BR jdb
 171 のコマンドの中でもっとも重要なのが、この
 172 .B help
 173 コマンドです。利用可能なコマンドの一覧を、
 174 各コマンドの簡単な説明つきで表示します。
 175 .TP 15
 176 .B run
 177 .BR jdb
 178 を起動して必要なブレークポイントを設定したあとに、このコマンドを使用して、
 179 デバッグするアプリケーションの実行を開始します。このコマンドは、
 180 デバッグするアプリケーションを
 181 .B jdb
 182 から起動するときにだけ使用できます。 
 183 既存の VM に接続する場合とは異なります。
 184 .TP
 185 .B cont
 186 ブレークポイント、例外、またはステップ実行のあとで、デバッグ中の
 187 アプリケーションの実行を継続します。
 188 .TP 15
 189 .B print
 190 Java オブジェクトおよびプリミティブ値を表示します。 プリミティブ型の変数
 191 またはフィールドの場合には、実際の値を出力します。 オブジェクトの場合
 192 には、短い説明を出力します。 オブジェクトについては、以降の
 193 .B dump
 194 コマンドの説明を参照してください。 
 195 .sp 1n
 196 .LP
 197 注: 局所
 198 (スタック)
 199 変数をブラウズするには、そのクラスが
 200 .B javac \-g
 201 オプションでコンパイルされている必要があります。
 202 .sp 1n
 203 .LP
 204 .B print
 205 は、メソッドの呼び出しを含む多数の簡単な Java 式をサポートします。
 206 次に例を示します。 
 207 .RS
 208 .TP 3
 209 \(bu
 210 .B print MyClass.myStaticField 
 211 .PD 0
 212 .TP
 213 \(bu
 214 .B print myObj.myInstanceField 
 215 .TP
 216 \(bu
 217 \f3print\f1 \f2i\f1 \f3+\f1 \f2j\f1 \f3+\f1 \f2k\f1 (
 218 .IR i、
 219 .IR j 、
 220 および 
 221 .I k
 222 はプリミティブであり、フィールドまたは局所変数のいずれか) 
 223 .TP
 224 \(bu
 225 \f3print myObj.myMethod(\|)\f1 (
 226 .B myMethod
 227 が null 以外を返す場合) 
 228 .TP
 229 \(bu
 230 .B print new java.lang.String("Hello").length(\|)
 231 .RE
 232 .PD
 233 .TP
 234 .B dump
 235 プリミティブ値の場合には、このコマンドは
 236 .BR print
 237 と同じです。オブジェクトの場合には、オブジェクト内に定義されている
 238 各フィールドの現在の値を出力します。 static フィールドと instance
 239 フィールドを出力します。 
 240 .sp 1n
 241 .LP
 242 .B dump
 243 コマンドは、
 244 .B print
 245 コマンドと同じ式をサポートします。 
 246 .TP
 247 .B threads
 248 現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、
 249 およびほかのコマンドに使用できるインデックスを出力します。次に例を
 250 示します。 
 251 .sp 1n
 252 .RS 20
 253 .LP
 254 .B 4. (java.lang.Thread)0x1 main      running
 255 .RE
 256 .RS 
 257 .sp 1n
 258 .LP
 259 この例では、スレッドインデックスは
 260 .BR 4
 261 であり、スレッドは
 262 .BR java.lang.Thread 
 263 のインスタンスです。スレッドの名前は「
 264 .BR main
 265 」であり、現在実行中です。 
 266 .RE
 267 .TP 15
 268 .B thread
 269 現在のスレッドを選択します。 多くの
 270 .B jdb
 271 コマンドは、現在のスレッドの設定に基づいて実行されます。 スレッドは、
 272 .B threads 
 273 コマンドで説明するスレッドインデックスとともに指定します。 
 274 .TP 15
 275 .B where
 276 引数のない
 277 .B where
 278 コマンドは、現在のスレッド
 279 (
 280 .B thread
 281 コマンドで設定)
 282 のスタックをダンプします。
 283 .B where all
 284 と指定すると、現在のスレッドグループにある全スレッドの
 285 スタックをダンプします。
 286 .BI where " threadindex"
 287 と指定すると、
 288 .I threadindex
 289 が示すスレッドのスタックだけをダンプします。
 290 .sp 1n
 291 .LP
 292 現在のスレッドが (ブレークポイントなどのイベントや
 293 .B suspend
 294 コマンドで) 中断している場合、
 295 .B print 
 296 コマンドや
 297 .B dump
 298 コマンドを使用すれば、局所変数やフィールドを表示できます。
 299 どのスタックフレームを現在のフレームにするかは、
 300 .B up
 301 および
 302 .B down
 303 コマンドで選択できます。
 304 .SS "ブレークポイント用コマンド"
 305 .IX "jdb" "Breakpoints" "\fLjdb\fP \(em Java debugger"
 306 .B jdb
 307 では、ブレークポイントを行番号で、
 308 またはメソッドの最初の命令で
 309 設定できます。次に例を示します。
 310 .TP 25
 311 .B stop at MyClass:22
 312 .BR MyClass
 313 が含まれるソースファイルの
 314 .B 22
 315 行目の最初の命令にブレークポイントを設定する
 316 .TP
 317 .B stop in java.lang.String.length
 318 .BR java.lang.String.length
 319 メソッドの最初にブレークポイントを設定する
 320 .TP
 321 .BI "stop in MyClass." init
 322 .I init
 323 は
 324 .B MyClass
 325 コンストラクタを識別する
 326 .TP
 327 .BI "stop in MyClass." clinit
 328 .I clinit
 329 は
 330 .BR MyClass
 331 の静的な初期化コードを識別する 
 332 .LP
 333 メソッドがオーバーロードされる場合には、メソッドの引数の型も指定して、
 334 ブレークポイントに対して適切なメソッドが選択されるようにしなければなりませ
 335 ん。 たとえば、次のように指定します。
 336 .LP
 337 .RS 15
 338 .B MyClass.myMethod(int,java.lang.String)
 339 .RE
 340 .LP
 341 または
 342 .LP
 343 .RS 15
 344 .B MyClass.myMethod() 
 345 .RE
 346 .LP
 347 .B clear
 348 コマンドは、「
 349 .BR clear MyClass:45
 350 」のような構文を使用してブレークポイントを削除します。
 351 引数を指定しないで
 352 .B clear
 353 コマンドを使用すると、現在設定されてい
 354 るすべてのブレークポイントが表示されます。
 355 .B cont
 356 コマンドで実行が継続します。 
 357 .SS "コマンドのステップ実行"
 358 .IX "jdb" "Stepping" "\fLjdb\fP \(em Java debugger"
 359 .B step
 360 コマンドは、現在のスタックフレームまたは呼び出されたメソッド内で、
 361 次の行を実行します。 
 362 .B next
 363 コマンドは、現在のスタックフレームの次の行を
 364 実行します。 
 365 .SS "例外処理用コマンド"
 366 .IX "jdb" "Exceptions" "\fLjdb\fP \(em Java debugger"
 367 スローしているスレッドの呼び出しスタック上のどこにも catch 文がないような
 368 例外が発生すると、VM は通常、例外トレースを出力して終了します。 ただし、
 369 .BR jdb 
 370 環境で実行している場合は、このような例外が発生すると
 371 .B jdb
 372 に制御が戻ります。 次に、
 373 .BR jdb 
 374 を使用して例外の原因を診断します。 
 375 .TP 15
 376 .B catch
 377 デバッグ中のアプリケーションは他の例外がスローされたところで停止します。
 378 次に例を示します。
 379 .LP
 380 .RS 20
 381 .B catch java.io.FileNotFoundException
 382 .RE
 383 .sp 1n
 384 .RS 15
 385 または
 386 .RE
 387 .LP
 388 .RS 20
 389 .B catch mypackage.BigTroubleException
 390 .RE
 391 .sp 1n
 392 .RS 15
 393 例外が指定したクラス (または、サブクラス) のインスタンスである場合、
 394 アプリケーションはスローされたところで停止します。
 395 .RE
 396 .TP 15
 397 .B ignore
 398 以前の
 399 .B catch
 400 コマンドの効果を無効にします。なお、この指定によって例外を無視するのは
 401 デバッガだけであり、デバッグされた VM は無視しません。
 402 .SH "コマンド行オプション"
 403 コマンド行で Java アプリケーション起動ツールの代わりに
 404 .B jdb
 405 を使用する場合、
 406 .B jdb
 407 は、
 408 .BR \-D、
 409 .BR \-classpath、
 410 .BI \-X option\f1
 411 など、
 412 .BR java (1)
 413 コマンドと同じオプションを多数使用できます。
 414 .LP
 415 .B jdb 
 416 は、そのほかに次のオプションも使用できます。 
 417 .TP 3
 418 .BI \-help 
 419 ヘルプメッセージを表示します。
 420 .TP 3
 421 .BI \-sourcepath " dir1\f1:\f2dir2\f1:..."
 422 指定されたパスで、ソースファイルを検索します。 このオプションが
 423 指定されていない場合は、デフォルトパスの「.」を検索します。 
 424 .TP
 425 .BI \-attach " address"
 426 デフォルトの接続機構を使用して、すでに実行中の VM にデバッガを接続
 427 します。 
 428 .TP
 429 .BI \-listen " address"
 430 実行中の VM が標準のコネクタを使って指定されたアドレスに接続するのを待機します。
 431 .TP
 432 .BI \-listenany
 433 実行中の VM が標準のコネクタを使って利用可能な任意のアドレスに接続するのを待機します。
 434 .TP
 435 .B \-launch
 436 デバッグするアプリケーションを
 437 .BR jdb
 438 の起動後ただちに起動します。 このオプションを使用すると、
 439 .B run
 440 コマンドを使用する必要はありません。 デバッグするアプリケーションは、
 441 起動後、最初のアプリケーションクラスがロードされる直前に停止します。
 442 その時点で、必要なブレークポイントを設定できます。
 443 実行を継続するには
 444 .B cont
 445 コマンドを使用します。
 446 .TP 3
 447 \-listconnectors 
 448 この VM で利用できるコネクタを一覧表示します。
 449 .TP 3
 450 \-connect
 451 <connector\-name>:<name1>=<value1>,... 
 452 一覧表示された引数の値と指定のコネクタを使ってターゲット VM に接続します。
 453 .TP 3
 454 \-dbgtrace [flags] 
 455 jdb のデバッグ情報を出力します。
 456 .TP 3
 457 \-tclient 
 458 Java HotSpot(tm) VM (クライアント) 内でアプリケーションを実行します。
 459 .TP 3
 460 \-tserver 
 461 Java HotSpot(tm) VM (サーバ) 内でアプリケーションを実行します。
 462 .TP
 463 .BI \-J "option"
 464 jdb の実行に使用される Java 仮想マシンに \f2option\fP を渡します。(アプリケーション Java 仮想マシンに対するオプションは、\f3run\fP コマンドに渡される。)
 465 たとえば、
 466 .I \-J-Xms48m
 467 は、起動時に使用するメモリを 48M バイトに設定します。
 468 
 469 
 470 .LP
 471 これ以外にも、デバッガをデバッグされる VM に接続するための代替機構
 472 用のオプションがサポートされています。
 473 このような接続の代替機構については、
 474 .fi
 475 http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html
 476 の Java Platform Debugger Architecture のマニュアルを参照してください。
 477 .LP
 478 .SS 
 479 デバッグ対象のプロセスに転送されるオプション
 480 .LP
 481 .TP 3
 482 \-v \-verbose[:class|gc|jni] 
 483 冗長モードにします。
 484 .TP 3
 485 \-D<name>=<value> 
 486 システムプロパティを設定します。
 487 .TP 3
 488 \-classpath <directories separated by
 489 ":"> 
 490 クラスを検索するディレクトリを一覧表示します。
 491 .TP 3
 492 \-X<option> 
 493 非標準ターゲット VM オプションです。
 494 .LP
 495 .SH "関連項目"
 496 .LP
 497 
 498 .LP
 499 .LP
 500 javac、java、javah、javap、javadoc
 501 .LP
 502 
 503 .LP
 504