1 ." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved. |
1 '\" t |
2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
2 .\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. |
3 ." |
3 .\" Title: jsadebugd |
4 ." This code is free software; you can redistribute it and/or modify it |
4 .\" Language: English |
5 ." under the terms of the GNU General Public License version 2 only, as |
5 .\" Date: 2013年11月21日 |
6 ." published by the Free Software Foundation. |
6 .\" SectDesc: トラブルシューティング・ツール |
7 ." |
7 .\" Software: JDK 8 |
8 ." This code is distributed in the hope that it will be useful, but WITHOUT |
8 .\" Arch: 汎用 |
9 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
9 .\" |
10 ." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
10 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
11 ." version 2 for more details (a copy is included in the LICENSE file that |
11 .\" |
12 ." accompanied this code). |
12 .\" This code is free software; you can redistribute it and/or modify it |
13 ." |
13 .\" under the terms of the GNU General Public License version 2 only, as |
14 ." You should have received a copy of the GNU General Public License version |
14 .\" published by the Free Software Foundation. |
15 ." 2 along with this work; if not, write to the Free Software Foundation, |
15 .\" |
16 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
16 .\" This code is distributed in the hope that it will be useful, but WITHOUT |
17 ." |
17 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
18 ." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
18 .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
19 ." or visit www.oracle.com if you need additional information or have any |
19 .\" version 2 for more details (a copy is included in the LICENSE file that |
20 ." questions. |
20 .\" accompanied this code). |
21 ." |
21 .\" |
22 .TH jsadebugd 1 "07 May 2011" |
22 .\" You should have received a copy of the GNU General Public License version |
23 |
23 .\" 2 along with this work; if not, write to the Free Software Foundation, |
24 .LP |
24 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
25 .SH "名前" |
25 .\" |
26 jsadebugd \- サービスアビリティーエージェントデバッグデーモン |
26 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
27 .LP |
27 .\" or visit www.oracle.com if you need additional information or have any |
28 .RS 3 |
28 .\" questions. |
29 .TP 2 |
29 .\" |
30 o |
30 .pl 99999 |
31 形式 |
31 .TH "jsadebugd" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール" |
32 .TP 2 |
32 .\" ----------------------------------------------------------------- |
33 o |
33 .\" * Define some portability stuff |
34 パラメータ |
34 .\" ----------------------------------------------------------------- |
35 .TP 2 |
35 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
36 o |
36 .\" http://bugs.debian.org/507673 |
37 説明 |
37 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html |
38 .TP 2 |
38 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
39 o |
39 .ie \n(.g .ds Aq \(aq |
40 関連項目 |
40 .el .ds Aq ' |
|
41 .\" ----------------------------------------------------------------- |
|
42 .\" * set default formatting |
|
43 .\" ----------------------------------------------------------------- |
|
44 .\" disable hyphenation |
|
45 .nh |
|
46 .\" disable justification (adjust text to left margin only) |
|
47 .ad l |
|
48 .\" ----------------------------------------------------------------- |
|
49 .\" * MAIN CONTENT STARTS HERE * |
|
50 .\" ----------------------------------------------------------------- |
|
51 .SH "NAME" |
|
52 jsadebugd \- Javaプロセスまたはコア・ファイルに接続し、デバッグ・サーバーとして機能します。このコマンドは試験的なもので、サポートされていません。 |
|
53 .SH "概要" |
|
54 .sp |
|
55 .if n \{\ |
|
56 .RS 4 |
|
57 .\} |
|
58 .nf |
|
59 \fIjsadebugd\fR \fIpid\fR [ \fIserver\-id\fR ] |
|
60 .fi |
|
61 .if n \{\ |
41 .RE |
62 .RE |
42 |
63 .\} |
43 .LP |
64 .sp |
44 .SH "形式" |
65 .if n \{\ |
45 .LP |
66 .RS 4 |
|
67 .\} |
46 .nf |
68 .nf |
47 \f3 |
69 \fIjsadebugd\fR \fIexecutable\fR \fIcore\fR [ \fIserver\-id\fR ] |
48 .fl |
|
49 \fP\f3jsadebugd\fP pid [ server\-id ] |
|
50 .fl |
|
51 \f3jsadebugd\fP executable core [ server\-id ] |
|
52 .fl |
|
53 .fi |
70 .fi |
54 |
71 .if n \{\ |
55 .LP |
|
56 .SH "パラメータ" |
|
57 .LP |
|
58 .RS 3 |
|
59 .TP 3 |
|
60 pid |
|
61 デバッグサーバーが接続するプロセスのプロセス ID です。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。単一のプロセスに接続できるデバッグサーバーのインスタンスは、1 つに制限されます。 |
|
62 .RE |
72 .RE |
63 |
73 .\} |
64 .LP |
74 .PP |
65 .RS 3 |
75 \fIpid\fR |
66 .TP 3 |
76 .RS 4 |
67 executable |
77 デバッグ・サーバーが接続するプロセスのプロセスIDです。プロセスはJavaプロセスである必要があります。マシン上で実行しているJavaプロセスの一覧を取得するには、jps(1)コマンドを使用します。単一のプロセスに接続できるデバッグ・サーバーのインスタンスは、1つに制限されます。 |
68 .RE |
78 .RE |
69 |
79 .PP |
70 .LP |
80 \fI実行可能ファイル\fR |
71 .RS 3 |
81 .RS 4 |
72 .TP 3 |
82 コア・ダンプの作成元のJava実行可能ファイル。 |
73 コアダンプの作成元になる Java 実行可能ファイルです。 |
|
74 .RE |
83 .RE |
75 |
84 .PP |
76 .LP |
85 \fIコア\fR |
77 .RS 3 |
86 .RS 4 |
78 .TP 3 |
87 デバッグ・サーバーを接続するコア・ファイルです。 |
79 core |
|
80 デバッグサーバーを接続するコアファイルです。 |
|
81 .RE |
88 .RE |
82 |
89 .PP |
83 .LP |
90 \fIserver\-id\fR |
84 .RS 3 |
91 .RS 4 |
85 .TP 3 |
92 複数のデバッグ・サーバーが同一のマシン上で実行されている場合に必要になる、オプションの一意のIDです。このIDは、リモート・クライアントが、接続先のデバッグ・サーバーを特定するために使用する必要があります。このIDは、単一のマシン内で一意にする必要があります。 |
86 server\-id |
|
87 複数のデバッグサーバーが同一のマシン上で実行している場合に必要になる、オプション固有の ID です。この ID は、リモートクライアントが、接続先のデバッグサーバーを特定するために使用する必要があります。この ID は、単一のマシン内で一意でなければなりません。 |
|
88 .RE |
93 .RE |
89 |
|
90 .LP |
|
91 .SH "説明" |
94 .SH "説明" |
92 .LP |
95 .PP |
93 .LP |
96 \fIjsadebugd\fRコマンドは、Javaプロセスまたはコア・ファイルに接続し、デバッグ・サーバーとして機能します。\fIjstack\fR、\fIjmap\fRおよび\fIjinfo\fRなどのリモート・クライアントは、Java Remote Method Invocation (RMI)を使用しているサーバーに接続できます。\fIjsadebugd\fRコマンドを起動する前に、\fIrmiregistry\fRコマンドでRMIレジストリを次のように起動します。\fI$JAVA_HOME\fRはJDKのインストール・ディレクトリです。 |
94 \f3jsadebugd\fP は、Java プロセスまたはコアファイルに接続し、デバッグサーバーとして機能します。jstack(1)、jmap(1)、および jinfo(1) などのリモートクライアントは、Java Remote Method Invocation (RMI) を使用しているサーバーに接続できます。 \f2jsadebugd\fP を起動する前に、次のようにして |
97 .sp |
95 .na |
98 .if n \{\ |
96 \f2rmiregistry\fP @ |
99 .RS 4 |
|
100 .\} |
|
101 .nf |
|
102 rmiregistry \-J\-Xbootclasspath/p:$JAVA_HOME/lib/sajdi\&.jar |
97 .fi |
103 .fi |
98 http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi を起動する必要があります。 |
104 .if n \{\ |
99 .LP |
105 .RE |
100 .nf |
106 .\} |
101 \f3 |
107 .PP |
102 .fl |
108 RMIレジストリが起動していない場合、\fIjsadebugd\fRコマンドはRMIレジストリを標準(1099)ポートで内部で起動します。デバッグ・サーバーは、\fISIGINT\fRを送信することにより停止できます。SIGINTを送信するには、\fB[Ctrl] + [C]\fRを押します。 |
103 \fP\f4rmiregistry \-J\-Xbootclasspath/p:$JAVA_HOME/lib/sajdi.jar\fP\f3 |
109 .PP |
104 .fl |
110 \fB注意:\fR |
105 \fP |
111 このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fIdbgeng\&.dll\fRが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fIPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。例: |
106 .fi |
112 \fIs\fR\fIet PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fR |
107 |
|
108 .LP |
|
109 .LP |
|
110 ここで、 \f2$JAVA_HOME\fP は JDK インストールディレクトリです。rmiregistry が起動していない場合、jsadebugd は標準 (1099) ポートの rmiregistry を内部で起動します。デバッグサーバーは、SIGINT を送信する (Ctrl+C を押す) ことにより停止できます。 |
|
111 .LP |
|
112 .LP |
|
113 \f3注\fP \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \f2PATH\fP 環境変数には、ターゲットプロセスによって使用される \f2jvm.dll\fP の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。 |
|
114 .LP |
|
115 .LP |
|
116 次に例を示します。 \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP |
|
117 .LP |
|
118 .SH "関連項目" |
113 .SH "関連項目" |
119 .LP |
114 .sp |
120 .RS 3 |
115 .RS 4 |
121 .TP 2 |
116 .ie n \{\ |
122 o |
117 \h'-04'\(bu\h'+03'\c |
123 jinfo(1) |
118 .\} |
124 .TP 2 |
119 .el \{\ |
125 o |
120 .sp -1 |
126 jmap(1) |
121 .IP \(bu 2.3 |
127 .TP 2 |
122 .\} |
128 o |
123 jinfo(1) |
129 jps(1) |
|
130 .TP 2 |
|
131 o |
|
132 jstack(1) |
|
133 .TP 2 |
|
134 o |
|
135 .na |
|
136 \f2rmiregistry\fP @ |
|
137 .fi |
|
138 http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi |
|
139 .RE |
124 .RE |
140 |
125 .sp |
141 .LP |
126 .RS 4 |
142 |
127 .ie n \{\ |
|
128 \h'-04'\(bu\h'+03'\c |
|
129 .\} |
|
130 .el \{\ |
|
131 .sp -1 |
|
132 .IP \(bu 2.3 |
|
133 .\} |
|
134 jmap(1) |
|
135 .RE |
|
136 .sp |
|
137 .RS 4 |
|
138 .ie n \{\ |
|
139 \h'-04'\(bu\h'+03'\c |
|
140 .\} |
|
141 .el \{\ |
|
142 .sp -1 |
|
143 .IP \(bu 2.3 |
|
144 .\} |
|
145 jps(1) |
|
146 .RE |
|
147 .sp |
|
148 .RS 4 |
|
149 .ie n \{\ |
|
150 \h'-04'\(bu\h'+03'\c |
|
151 .\} |
|
152 .el \{\ |
|
153 .sp -1 |
|
154 .IP \(bu 2.3 |
|
155 .\} |
|
156 jstack(1) |
|
157 .RE |
|
158 .sp |
|
159 .RS 4 |
|
160 .ie n \{\ |
|
161 \h'-04'\(bu\h'+03'\c |
|
162 .\} |
|
163 .el \{\ |
|
164 .sp -1 |
|
165 .IP \(bu 2.3 |
|
166 .\} |
|
167 rmiregistry(1) |
|
168 .RE |
|
169 .br |
|
170 'pl 8.5i |
|
171 'bp |