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 .TH jps 1 "05 Jul 2012" 24 .SH 名前 25 jps \- Java 仮想マシンプロセスステータスツール 26 .\" 27 .SH 形式 28 .B jps 29 .BI [ options ] 30 .BI [ hostid ] 31 .LP 32 .SH パラメータ 33 .if t .TP 20 34 .if n .TP 15 35 .I options 36 コマンド行オプション。 37 .if t .TP 20 38 .if n .TP 15 39 .I hostid 40 プロセスレポートを生成するホストのホスト識別子。 41 .I hostid 42 には、通信プロトコル、ポート番号、およびその他固有の実装データを示すオプションコンポーネントを含めることができます。 43 .SH 機能説明 44 .B jps 45 ツールは、ターゲットシステム上の計測機構付き HotSpot Java 仮想マシン (JVM) をリストします。このツールは、アクセス権がある JVM 上の情報だけを報告します。 46 .LP 47 ホスト ID を指定せずに 48 .B jps 49 が実行された場合は、ローカルホスト上の計測機構付き JVM を探します。ホスト ID が指定された場合は、指定されたホスト上の JVM を、指定されたプロトコルとポートを使用して探します。 50 .B jstatd 51 プロセスがターゲットホスト上で稼動していることが前提となります。 52 .LP 53 .B jps 54 コマンドは、ターゲットシステム上で見つかった計測機構付き JVM のそれぞれについて、ローカル VM 識別子 (lvmid) を報告します。lvmid は、一般に、オペレーティングシステムの JVM プロセスのプロセス識別子ですが、必ずしもそうとは限りません。オプションが指定されなかった場合、 55 .B jps 56 は各 Java アプリケーションの lvmid の後に短い形式のアプリケーションのクラス名または jar ファイル名を続けてリストします。短い形式のクラス名または JAR ファイル名では、クラスのパッケージ情報や JAR ファイルのパス情報は省かれます。 57 .LP 58 .B jps 59 コマンドは java 起動ツールを使用して、クラス名と main メソッドに渡された引数を探します。ターゲット JVM がカスタム起動ツールで起動された場合、クラス名 (または JAR ファイル名) と main メソッドに渡された引数は入手できません。この場合、 60 .B jps 61 コマンドは、クラス名または JAR ファイル名と main メソッドの引数として、Unknown という文字列を出力します。 62 .LP 63 .B jps 64 コマンドによって生成される JVM のリストは、コマンドを実行した主体に許可されているアクセス権によって制限されることがあります。このコマンドは、オペレーティングシステム固有のアクセス制御機構に従って、主体がアクセス権を持っている JVM だけをリストします。 65 .LP 66 注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。現在、Windows 98 および Windows ME プラットフォームでは使用できません。 67 .SH オプション 68 .B jps 69 コマンドは、コマンド出力を変更する多数のオプションをサポートしています。これらのオプションは、将来、変更または削除されることがあります。 70 .if t .TP 20 71 .if n .TP 15 72 .BI \-q 73 クラス名、JAR ファイル名、および main メソッドに渡された引数の出力を抑制して、ローカル VM 識別子のリストだけを生成します。 74 .if t .TP 20 75 .if n .TP 15 76 .BI \-m 77 main メソッドに渡された引数を出力します。埋め込み JVM の場合、出力は NULL になることがあります。 78 .if t .TP 20 79 .if n .TP 15 80 .BI \-l 81 アプリケーションの main クラスのフルパッケージ名、またはアプリケーションの JAR ファイルのフルパス名を出力します。 82 .if t .TP 20 83 .if n .TP 15 84 .BI \-v 85 JVM に渡された引数を出力します。 86 .if t .TP 20 87 .if n .TP 15 88 .BI \-V 89 フラグファイル (.hotspotrc ファイル、または -XX:Flags=<filename> 引数によって指定されたファイル) を通じて JVM に渡された引数を出力します。 90 .if t .TP 20 91 .if n .TP 15 92 .BI \-J "option" 93 .B jps 94 によって呼び出された java 起動ツールにオプションを渡します。 95 たとえば、-J-Xms48m は、起動メモリを 48M バイトに設定します。Java で作成された下層の VM 実行アプリケーションにオプションを渡すのが、\-J の一般的規則です。 96 .SH ホスト識別子 97 ホスト識別子 (hostid) は、ターゲットシステムを示す文字列です。hostid 文字列の構文は、URI の構文とほぼ同じです。 98 .LP 99 .RS 100 .ft 3 101 .nf 102 [protocol:][[//]hostname][:port][/servername] 103 .fi 104 .ft 1 105 .RE 106 .if t .TP 20 107 .if n .TP 15 108 .B protocol 109 通信プロトコル。protocol が省かれ、hostname が指定されなかった場合、デフォルトのプロトコルは、プラットフォームに固有の最適化されたローカルプロトコルです。protocol が省かれ、hostname が指定された場合、デフォルトのプロトコルは rmi です。 110 .if t .TP 20 111 .if n .TP 15 112 .I hostname 113 ターゲットホストを示すホスト名または IP アドレス。hostname が省かれた場合、ターゲットホストはローカルホストです。 114 .if t .TP 20 115 .if n .TP 15 116 .I port 117 リモートサーバーと通信するためのデフォルトポート。hostname が省かれるか、protocol が最適化されたローカルプロトコルを指定している場合、port は無視されます。そうでない場合、port パラメータの扱いは、実装に固有です。デフォルトの rmi プロトコルの場合、port はリモートホスト上の rmiregistry のポート番号を示します。port が省かれ、protocol が rmi を示す場合は、デフォルトの rmiregistry ポート (1099) が使用されます。 118 .if t .TP 20 119 .if n .TP 15 120 .I servername 121 このパラメータの取り扱いは、実装によって異なります。最適化されたローカルプロトコルの場合、このフィールドは無視されます。rmi プロトコルの場合、このパラメータは、リモートホスト上の RMI リモートオブジェクトの名前を表す文字列です。 122 .B jstatd 123 コマンドの \-n オプションを参照してください。 124 .SH 出力形式 125 jps コマンドの出力は、次のパターンに従います。 126 .LP 127 .RS 128 .ft 3 129 .nf 130 lvmid [ [ classname | JARfilename | "Unknown"] [ arg* ] [ jvmarg* ] ] 131 .fi 132 .ft 1 133 .RE 134 .LP 135 出力トークンはすべて、空白で区切られます。埋め込まれた空白を含む arg があると、引数を実際の位置パラメータにマップするときにあいまいさが生じます。 136 .LP 137 注 - 将来のリリースで形式が変更される可能性があるので、 138 .B jps 139 の出力を解析するスクリプトは書かない方がよいでしょう。jps 出力を解析するスクリプトを書く場合は、このツールの将来のリリースでは修正が必要になることを予想しておいてください。 140 .SH 使用例 141 このセクションでは、 142 .B jps 143 コマンドの例を示します。 144 .LP 145 ローカルホスト上の計測機構付き JVM をリストする: 146 .LP 147 .RS 148 .ft 3 149 .nf 150 jps 151 18027 Java2Demo.JAR 152 18032 jps 153 18005 jstat 154 .fi 155 .ft 1 156 .RE 157 .TP 158 リモートホスト上の計測機構付き JVM をリストする: 159 .LP 160 この例では、jstat サーバーとその内部 RMI レジストリまたは個別の外部 rmiregistry プロセスがリモートホストのデフォルトポート (ポート 1099) で実行していることを前提としています。また、ローカルホストはリモートホストにアクセスするための適切なアクセス権を持っているものとします。また、この例には、長い形式のクラス名または JAR ファイル名を出力するための -l オプションが含まれています。 161 .LP 162 .RS 163 .ft 3 164 .nf 165 jps -l remote.domain 166 3002 /opt/j2sdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR 167 2857 sun.tools.jstatd.jstatd 168 .fi 169 .ft 1 170 .RE 171 .LP 172 RMI レジストリ用にデフォルト以外のポートを使用するリモートホスト上の計測機構付き Java 仮想マシンをリストする: 173 .LP 174 この例では、jstatd サーバーがリモートホスト上で実行していて、内部 RMI レジストリがポート 2002 にバインドされていることを前提としています。また、この例では、リストされる各 Java アプリケーションの main メソッドに渡された引数を含めるために、-m オプションを使用しています。 175 .LP 176 .RS 177 .ft 3 178 .nf 179 jps -m remote.domain:2002 180 3002 /opt/j2sdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR 181 3102 sun.tools.jstatd.jstatd -p 2002 182 .fi 183 .ft 1 184 .RE 185 .SH 関連項目 186 .LP 187 .RS 3 188 .TP 2 189 * 190 java \- Java アプリケーション起動プログラム 191 .TP 2 192 * 193 jstat \- Java 仮想マシン統計監視ツール 194 .TP 2 195 * 196 jstatd \- 仮想マシン jstat デーモン 197 .TP 2 198 * 199 rmiregistry \- Java リモートオブジェクトレジストリ 200 .RE 201 202 .LP 203 204 .LP 205