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.
\f3jdb �ϡ�Java ����ץ?���ΥХ��Ĥ��ƽ������뤿��˻��Ѥ���ġ���Ǥ���
15 options �ʲ��˻��ꤹ�륳�ޥ�ɹԥ��ץ����
class �ǥХå��Ϥ��륯�饹̾
arguments ���饹�� main(\|) ��åɤ��Ϥ������
% 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 �Υɥ�����ȤȤ��Ƥ���������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 ���ޥ�ɤ�����Ǥ��ޤ���
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 ���ޥ�ɤǼ¹Ԥ���³���ޤ���
15 catch �ǥХå���Υ��ץꥱ��������¾���㳰�����?���줿�Ȥ������ߤ��ޤ��� ��������ޤ���
catch java.io.FileNotFoundException
�ޤ���
catch mypackage.BigTroubleException
�㳰�����ꤷ�����饹 (�ޤ��ϡ����֥��饹) �Υ����Ǥ����硢 ���ץꥱ�������ϥ��?���줿�Ȥ������ߤ��ޤ���
15 ignore ������ catch ���ޥ�ɤθ�̤�̵��ˤ��ޤ����ʤ������λ���ˤ�ä��㳰��̵�뤹��Τ� �ǥХå������Ǥ��ꡢ�ǥХå����줿 VM ��̵�뤷�ޤ���
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