jdb.1 revision 0
t

Copyright 2000-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.

jdb 1 "2006 ǯ 9 �� 4 ��" "Java SE 6" "�桼�������ޥ��"
"̾��"
jdb - Java �ǥХå�

\f3jdb �ϡ�Java ����ץ?���ΥХ��򸫤Ĥ��ƽ������뤿��˻��Ѥ���ġ���Ǥ���

"����"
jdb [ options ] [ class ] [ arguments ]

15 options �ʲ��˻��ꤹ�륳�ޥ�ɹԥ��ץ����

class �ǥХå��򳫻Ϥ��륯�饹̾

arguments ���饹�� main(\|) �᥽�åɤ��Ϥ������

"��ǽ����"
"Java debugger" "" "Java debugger \(em \fLjdb" "jdb" "" "\fLjdb \(em Java debugger" Java �ǥХå��� jdb �ϡ� Java ���饹�Ѥ�ñ��ʥ��ޥ�ɹԥǥХå��Ǥ��� ��\f2Java Platform Debugger Architecture�� (http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html) ����̤�ɽ�����ʤ���¹Ԥ����?����ޤ��ϥ�⡼�Ȥ� Java ���ۥޥ��� �θ����ȥǥХå���Ԥ����Ȥ��Ǥ��ޤ���
"jdb ���å����γ���"
"jdb" "Starting a jdb Session" "\fLjdb \(em Java debugger" jdb ���å����򳫻Ϥ���ˤϤ��ޤ��ޤ���ˡ������ޤ��� ��äȤ����ˤ˻� ����Τϡ����ץꥱ�������Υᥤ�󥯥饹��ǥХå����ơ� jdb ���鿷���� Java ���ۥޥ��� (VM) ��ư������ˡ�Ǥ��� ���ޥ�ɹԤǡ� java (1) ������� jdb ���ޥ�ɤ����Ϥ��ޤ������Ȥ��С����ץꥱ�������Υᥤ�󥯥饹�� MyClass �ξ��ϡ����Υ��ޥ�ɤ���Ѥ��� jdb �Ķ��ǥǥХå����ޤ���

% jdb MyClass

���Τ褦�ˤ��Ƶ�ư����ȡ� jdb �� 2 ���ܤ� Java VM ��ƤӽФ������ꤵ�줿�ѥ�᡼�����Ϥ��� ���ꤵ�줿���饹��?�ɤ��ޤ������Τ��ȡ� ���饹�κǽ��̿���¹Ԥ������� VM ����ߤ����ޤ���

jdb �Τ⤦ 1 �Ĥλ�����ˡ�ϡ����Ǥ˵�ư���Ƥ��� Java VM �� jdb ����³���뤳�ȤǤ��� jdb ����³���� VM �򡢤��μ¹���˵�ư���뤿��ι�ʸ�򼡤˼����ޤ��� ����ϡ�����ץ?���ǥХå��ѥ饤�֥���?�ɤ�����³�μ������ꤷ�ޤ���

\f3
.fl
-agentlib:jdwp=transport=dt_socket,server=y,suspend=n
.fl

���Ȥ��С����Υ��ޥ�ɤ� MyClass ���ץꥱ��������¹Ԥ������ jdb ����³�Ǥ���褦�ˤ��ޤ���

\f3
.fl
 % java -agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n MyClass
.fl

���Υ��ޥ�ɤ� jdb �� VM ����³�Ǥ��ޤ���

% jdb -attach 8000

���ΤȤ��� jdb �Ͽ����� VM ��ư����ΤǤϤʤ�����¸�� VM ����³����Τǡ� jdb ���ޥ�ɹԤ� MyClass ����ꤷ�ʤ����Ȥ���դ��Ƥ���������

����ʳ��ˤ�ǥХå� (jdb) �� VM ����³������ˡ�Ϥ������󤢤ꡢ jdb �Ϥ��Τ��٤Ƥ���ˡ�򥵥ݡ��Ȥ��Ƥ��ޤ��� ���Τ褦����³���ץ����ˤĤ��Ƥϡ�

http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html �� Java Platform Debugger Architecture �Υޥ˥奢��򻲾Ȥ��Ƥ��������� \f3jdb �ǻ��Ѥ��뤿��� J2SE 1.4.2 ������ VM ��ư������ˡ�ˤĤ��Ƥϡ� http://java.sun.com/j2se/1.4.2/docs/technotes/guides/jpda/conninv.html �� 1.4.2 �Υɥ�����Ȥ򻲾Ȥ��Ƥ���������
" jdb ���ܥ��ޥ��"
"jdb" "Basic jdb Commands" "\fLjdb \(em Java debugger" �ʲ��� jdb ���ܥ��ޥ�ɤΰ����򼨤��ޤ��� Java �ǥХå��ǻ��Ѳ�ǽ�ʤ���¾�Υ��ޥ�ɤϡ� help ���ޥ�ɤ�ɽ���Ǥ��ޤ���

15 help �ޤ��� ? jdb �Υ��ޥ�ɤ���Ǥ�äȤ���פʤΤ������� help ���ޥ�ɤǤ������Ѳ�ǽ�ʥ��ޥ�ɤΰ����� �ƥ��ޥ�ɤδ�ñ�������Ĥ���ɽ�����ޤ���

15 run jdb ��ư����ɬ�פʥ֥졼���ݥ���Ȥ����ꤷ�����Ȥˡ����Υ��ޥ�ɤ���Ѥ��ơ� �ǥХå����륢�ץꥱ�������μ¹Ԥ򳫻Ϥ��ޤ������Υ��ޥ�ɤϡ� �ǥХå����륢�ץꥱ�������� jdb ���鵯ư����Ȥ��ˤ������ѤǤ��ޤ��� ��¸�� VM ����³������Ȥϰۤʤ�ޤ���

cont �֥졼���ݥ���ȡ��㳰���ޤ��ϥ��ƥå׼¹ԤΤ��Ȥǡ��ǥХå���� ���ץꥱ�������μ¹Ԥ��³���ޤ���

15 print Java ���֥������Ȥ���ӥץ�ߥƥ����ͤ�ɽ�����ޤ��� �ץ�ߥƥ��ַ����ѿ� �ޤ��ϥե�����ɤξ��ˤϡ��ºݤ��ͤ���Ϥ��ޤ��� ���֥������Ȥξ�� �ˤϡ�û����������Ϥ��ޤ��� ���֥������ȤˤĤ��Ƥϡ��ʹߤ� dump ���ޥ�ɤ������򻲾Ȥ��Ƥ���������

��: �ɽ� (�����å�) �ѿ���֥饦������ˤϡ����Υ��饹�� javac -g ���ץ����ǥ���ѥ��뤵��Ƥ���ɬ�פ�����ޤ���

print �ϡ��᥽�åɤθƤӽФ���ޤ�¿���δ�ñ�� Java ���򥵥ݡ��Ȥ��ޤ��� ������򼨤��ޤ���

3 print MyClass.myStaticField

0

print myObj.myInstanceField

\f3print\f1 \f2i\f1 \f3+\f1 \f2j\f1 \f3+\f1 \f2k\f1 ( i�� j �� ����� k �ϥץ�ߥƥ��֤Ǥ��ꡢ�ե�����ɤޤ��϶ɽ��ѿ��Τ����줫)

\f3print myObj.myMethod(\|)\f1 ( myMethod �� null �ʳ����֤����)

print new java.lang.String("Hello").length(\|)

dump �ץ�ߥƥ����ͤξ��ˤϡ����Υ��ޥ�ɤ� print ��Ʊ���Ǥ������֥������Ȥξ��ˤϡ����֥�����������������Ƥ��� �ƥե�����ɤθ��ߤ��ͤ���Ϥ��ޤ��� static �ե�����ɤ� instance �ե�����ɤ���Ϥ��ޤ���

dump ���ޥ�ɤϡ� print ���ޥ�ɤ�Ʊ�����򥵥ݡ��Ȥ��ޤ���

threads ���߼¹���Υ���åɤ����ɽ�����ޤ�������åɤ��Ȥˡ�̾���ȸ��ߤξ��֡� ����Ӥۤ��Υ��ޥ�ɤ˻��ѤǤ��륤��ǥå�������Ϥ��ޤ���������� �����ޤ���

4. (java.lang.Thread)0x1 main running

������Ǥϡ�����åɥ���ǥå����� 4 �Ǥ��ꡢ����åɤ� java.lang.Thread �Υ��󥹥��󥹤Ǥ�������åɤ�̾���ϡ� main �פǤ��ꡢ���߼¹���Ǥ���

15 thread ���ߤΥ���åɤ����򤷤ޤ��� ¿���� jdb ���ޥ�ɤϡ����ߤΥ���åɤ�����˴�Ť��Ƽ¹Ԥ���ޤ��� ����åɤϡ� threads ���ޥ�ɤ��������륹��åɥ���ǥå����ȤȤ�˻��ꤷ�ޤ���

15 where ����Τʤ� where ���ޥ�ɤϡ����ߤΥ���å� ( thread ���ޥ�ɤ�����) �Υ����å������פ��ޤ��� where all �Ȼ��ꤹ��ȡ����ߤΥ���åɥ��롼�פˤ���������åɤ� �����å������פ��ޤ��� where " threadindex" �Ȼ��ꤹ��ȡ� threadindex ����������åɤΥ����å����������פ��ޤ���

���ߤΥ���åɤ� (�֥졼���ݥ���ȤʤɤΥ��٥�Ȥ� suspend ���ޥ�ɤ�) ���Ǥ��Ƥ����硢 print ���ޥ�ɤ� dump ���ޥ�ɤ���Ѥ���С��ɽ��ѿ���ե�����ɤ�ɽ���Ǥ��ޤ��� �ɤΥ����å��ե졼��򸽺ߤΥե졼��ˤ��뤫�ϡ� up ����� down ���ޥ�ɤ�����Ǥ��ޤ���

"�֥졼���ݥ�����ѥ��ޥ��"
"jdb" "Breakpoints" "\fLjdb \(em Java debugger" jdb �Ǥϡ��֥졼���ݥ���Ȥ���ֹ�ǡ� �ޤ��ϥ᥽�åɤκǽ��̿��� ����Ǥ��ޤ���������򼨤��ޤ���

25 stop at MyClass:22 MyClass ���ޤޤ�륽�����ե������ 22 ���ܤκǽ��̿��˥֥졼���ݥ���Ȥ����ꤹ��

stop in java.lang.String.length java.lang.String.length �᥽�åɤκǽ�˥֥졼���ݥ���Ȥ����ꤹ��

"stop in MyClass." init init �� MyClass ���󥹥ȥ饯�����̤���

"stop in MyClass." clinit clinit �� MyClass ����Ū�ʽ����ɤ��̤���

�᥽�åɤ������С��?�ɤ������ˤϡ��᥽�åɤΰ���η�����ꤷ�ơ� �֥졼���ݥ���Ȥ��Ф���Ŭ�ڤʥ᥽�åɤ����򤵤��褦�ˤ��ʤ���Фʤ�ޤ� �� ���Ȥ��С����Τ褦�˻��ꤷ�ޤ���

MyClass.myMethod(int,java.lang.String)

�ޤ���

MyClass.myMethod()

clear ���ޥ�ɤϡ��� clear MyClass:45 �פΤ褦�ʹ�ʸ����Ѥ��ƥ֥졼���ݥ���Ȥ���ޤ��� �������ꤷ�ʤ��� clear ���ޥ�ɤ���Ѥ���ȡ��������ꤵ��Ƥ� �뤹�٤ƤΥ֥졼���ݥ���Ȥ�ɽ������ޤ��� cont ���ޥ�ɤǼ¹Ԥ���³���ޤ���

"���ޥ�ɤΥ��ƥå׼¹�"
"jdb" "Stepping" "\fLjdb \(em Java debugger" step ���ޥ�ɤϡ����ߤΥ����å��ե졼��ޤ��ϸƤӽФ��줿�᥽�å���ǡ� ���ιԤ�¹Ԥ��ޤ��� next ���ޥ�ɤϡ����ߤΥ����å��ե졼��μ��ιԤ� �¹Ԥ��ޤ���
"�㳰�����ѥ��ޥ��"
"jdb" "Exceptions" "\fLjdb \(em Java debugger" ���?���Ƥ��륹��åɤθƤӽФ������å���Τɤ��ˤ� catch ʸ���ʤ��褦�� �㳰��ȯ������ȡ�VM ���̾�㳰�ȥ졼������Ϥ��ƽ�λ���ޤ��� �������� jdb �Ķ��Ǽ¹Ԥ��Ƥ�����ϡ����Τ褦���㳰��ȯ������� jdb �����椬���ޤ��� ���ˡ� jdb ����Ѥ����㳰�θ������Ǥ��ޤ���

15 catch �ǥХå���Υ��ץꥱ��������¾���㳰�����?���줿�Ȥ������ߤ��ޤ��� ������򼨤��ޤ���

catch java.io.FileNotFoundException

�ޤ���

catch mypackage.BigTroubleException

�㳰�����ꤷ�����饹 (�ޤ��ϡ����֥��饹) �Υ��󥹥��󥹤Ǥ����硢 ���ץꥱ�������ϥ��?���줿�Ȥ������ߤ��ޤ���

15 ignore ������ catch ���ޥ�ɤθ�̤�̵��ˤ��ޤ����ʤ������λ���ˤ�ä��㳰��̵�뤹��Τ� �ǥХå������Ǥ��ꡢ�ǥХå����줿 VM ��̵�뤷�ޤ���

"���ޥ�ɹԥ��ץ����"
���ޥ�ɹԤ� Java ���ץꥱ�������ư�ġ��������� jdb ����Ѥ����硢 jdb �ϡ� -D�� -classpath�� -X option\f1 �ʤɡ� java (1) ���ޥ�ɤ�Ʊ�����ץ�����¿�����ѤǤ��ޤ���

jdb �ϡ����Τۤ��˼��Υ��ץ�������ѤǤ��ޤ���

3 -help �إ�ץ�å�������ɽ�����ޤ���

3 -sourcepath " dir1\f1:\f2dir2\f1:..." ���ꤵ�줿�ѥ��ǡ��������ե�����򸡺����ޤ��� ���Υ��ץ���� ���ꤵ��Ƥ��ʤ����ϡ��ǥե���ȥѥ��Ρ�.�פ򸡺����ޤ���

-attach " address" �ǥե���Ȥ���³��������Ѥ��ơ����Ǥ˼¹���� VM �˥ǥХå�����³ ���ޤ���

-listen " address" �¹���� VM ��ɸ��Υ��ͥ�����Ȥäƻ��ꤵ�줿���ɥ쥹����³����Τ��Ե����ޤ���

-listenany �¹���� VM ��ɸ��Υ��ͥ�����Ȥä����Ѳ�ǽ��Ǥ�դΥ��ɥ쥹����³����Τ��Ե����ޤ���

-launch �ǥХå����륢�ץꥱ�������� jdb �ε�ư�夿�����˵�ư���ޤ��� ���Υ��ץ�������Ѥ���ȡ� run ���ޥ�ɤ���Ѥ���ɬ�פϤ���ޤ��� �ǥХå����륢�ץꥱ�������ϡ� ��ư�塢�ǽ�Υ��ץꥱ������󥯥饹���?�ɤ����ľ������ߤ��ޤ��� ���λ����ǡ�ɬ�פʥ֥졼���ݥ���Ȥ�����Ǥ��ޤ��� �¹Ԥ��³����ˤ� cont ���ޥ�ɤ���Ѥ��ޤ���

3 -listconnectors ���� VM �����ѤǤ��륳�ͥ��������ɽ�����ޤ���

3 -connect <connector-name>:<name1>=<value1>,... ����ɽ�����줿������ͤȻ���Υ��ͥ�����Ȥäƥ������å� VM ����³���ޤ���

3 -dbgtrace [flags] jdb �ΥǥХå��������Ϥ��ޤ���

3 -tclient Java HotSpot(tm) VM (���饤�����) ��ǥ��ץꥱ��������¹Ԥ��ޤ���

3 -tserver Java HotSpot(tm) VM (������) ��ǥ��ץꥱ��������¹Ԥ��ޤ���

-J "option" jdb �μ¹Ԥ˻��Ѥ���� Java ���ۥޥ���� \f2option ���Ϥ��ޤ���(���ץꥱ������� Java ���ۥޥ�����Ф��륪�ץ����ϡ�\f3run ���ޥ�ɤ��Ϥ���롣) ���Ȥ��С� -J-Xms48m �ϡ���ư���˻��Ѥ������� 48M �Х��Ȥ����ꤷ�ޤ���

����ʳ��ˤ⡢�ǥХå���ǥХå������ VM ����³���뤿������ص��� �ѤΥ��ץ���󤬥��ݡ��Ȥ���Ƥ��ޤ��� ���Τ褦����³�����ص����ˤĤ��Ƥϡ�

http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html �� Java Platform Debugger Architecture �Υޥ˥奢��򻲾Ȥ��Ƥ���������

�ǥХå��оݤΥץ?����ž������륪�ץ����

3 -v -verbose[:class|gc|jni] ��Ĺ�⡼�ɤˤ��ޤ���

3 -D<name>=<value> �����ƥ�ץ�ѥƥ������ꤷ�ޤ���

3 -classpath <directories separated by ":"> ���饹�򸡺�����ǥ��쥯�ȥ�����ɽ�����ޤ���

3 -X<option> ��ɸ�ॿ�����å� VM ���ץ����Ǥ���

"��Ϣ����"

javac��java��javah��javap��javadoc