1 ." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved.
   2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   3 ."
   4 ." This code is free software; you can redistribute it and/or modify it
   5 ." under the terms of the GNU General Public License version 2 only, as
   6 ." published by the Free Software Foundation.
   7 ."
   8 ." This code is distributed in the hope that it will be useful, but WITHOUT
   9 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  10 ." FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  11 ." version 2 for more details (a copy is included in the LICENSE file that
  12 ." accompanied this code).
  13 ."
  14 ." You should have received a copy of the GNU General Public License version
  15 ." 2 along with this work; if not, write to the Free Software Foundation,
  16 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  17 ."
  18 ." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  19 ." or visit www.oracle.com if you need additional information or have any
  20 ." questions.
  21 ."
  22 .TH jps 1 "07 May 2011"
  23 
  24 .LP
  25 .SH "名前"
  26 jps \- Java 仮想マシンプロセスステータスツール
  27 .LP
  28 .RS 3
  29 .TP 2
  30 o
  31 形式 
  32 .TP 2
  33 o
  34 パラメータ 
  35 .TP 2
  36 o
  37 説明 
  38 .TP 2
  39 o
  40 オプション 
  41 .TP 2
  42 o
  43 ホスト識別子 
  44 .TP 2
  45 o
  46 出力形式 
  47 .TP 2
  48 o
  49 例 
  50 .TP 2
  51 o
  52 関連項目 
  53 .RE
  54 
  55 .LP
  56 .SH "形式"
  57 .LP
  58 .nf
  59 \f3
  60 .fl
  61 \fP\f3jps\fP [ \f2options\fP ] [ \f2hostid\fP ]
  62 .br
  63 
  64 .fl
  65 .fi
  66 
  67 .LP
  68 .SH "パラメータ"
  69 .LP
  70 .RS 3
  71 .TP 3
  72 options 
  73 コマンド行オプション。 
  74 .TP 3
  75 hostid 
  76 プロセスレポートを生成するホストのホスト識別子。\f2hostid\fP には、通信プロトコル、ポート番号、実装に固有な他のデータを指定したオプションコンポーネントを含めることができます。 
  77 .RE
  78 
  79 .LP
  80 .SH " 説明"
  81 .LP
  82 .LP
  83 \f3jps\fP ツールは、ターゲットシステム上で計測された HotSpot Java 仮想マシン (JVM) を一覧表示します。このツールで表示できるレポート情報は、アクセス権を持った JVM に関するものに限定されます。
  84 .LP
  85 .LP
  86 \f2hostid\fP を指定せずに \f3jps\fP を実行した場合、ローカルホストで計測された JVM が検索されます。\f2hostid\fP を指定して起動した場合、指定されたプロトコルとポートを使用して、指定されたホスト上の JVM を検索します。\f3jstatd\fP プロセスがターゲットホスト上で実行されていると想定されます。
  87 .LP
  88 .LP
  89 \f3jps\fP コマンドは、ターゲットシステムで計測された各 JVM について、ローカル VM 識別子、つまり \f2lvmid\fP をレポートします。\f3lvmid\fP は、必須ではありませんが、一般的には JVM プロセスに対するオペレーティングシステムのプロセス識別子です。オプションを指定しない場合、\f3jps\fP によって、各 Java アプリケーションの \f2lvmid\fP が一覧表示され、それぞれにアプリケーションのクラス名または JAR ファイル名が簡単な形式で示されます。この簡単な形式のクラス名と JAR ファイル名では、クラスのパッケージ情報または JAR ファイルパス情報が省略されています。
  90 .LP
  91 .LP
  92 \f3jps\fP コマンドは、\f3Java\fP 起動ツールを使用して \f2main\fP メソッドに渡されるクラス名と引数を検索します。独自の起動ツールを使用してターゲット JVM を起動した場合は、 \f2main\fP メソッドに渡されるクラス名 (または JAR ファイル名) と引数は利用できません。この場合、\f3jps\fP コマンドは、main メソッドへ渡されるクラス名 (または JAR ファイル名) と引数に対して、文字列 \f2Unknown\fP を出力します。
  93 .LP
  94 .LP
  95 \f3jps\fP コマンドで生成される JVM のリストは、このコマンドを実行する主体に与えられたアクセス権に基づき、制限される場合があります。このコマンドは、オペレーティングシステム独自のアクセス制御機構による決定に基づいて、主体にアクセス権が与えられている JVM だけを一覧表示します。
  96 .LP
  97 .LP
  98 \f3注:\fP このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。現在、Windows 98 および Windows Me プラットフォームでは使用できません。
  99 .LP
 100 .SH "オプション"
 101 .LP
 102 .LP
 103 \f3jps\fP コマンドでは、コマンドの出力を変更するオプションが多数サポートされています。将来、これらのオプションは、変更または廃止される可能性があります。
 104 .LP
 105 .RS 3
 106 .TP 3
 107 \-q 
 108 クラス名、JAR ファイル名、および \f2main\fP メソッドに渡された引数の出力を抑制し、ローカル VM 識別子の一覧のみを生成します。 
 109 .TP 3
 110 \-m 
 111 main メソッドに渡される引数を出力します。この出力は、組み込まれている JVM に対して null になることもあります。  
 112 .TP 3
 113 \-l 
 114 アプリケーションの主要なクラスのフルパッケージ名、またはアプリケーションの JAR ファイルへのフルパス名を出力します。 
 115 .TP 3
 116 \-v 
 117 JVM に渡される引数を出力します。 
 118 .TP 3
 119 \-V 
 120 フラグファイル (.hotspotrc ファイルまたは \-XX:Flags=<\f2filename\fP> の引数で指定されたファイル) を通じて JVM に渡される引数を出力します。 
 121 .TP 3
 122 \-Joption 
 123 \f3jps\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。 
 124 .RE
 125 
 126 .LP
 127 .SS 
 128 ホスト識別子
 129 .LP
 130 .LP
 131 ホスト識別子、つまり \f2hostid\fP は、ターゲットシステムを示す文字列です。\f2hostid\fP 文字列の構文の大部分は、URI の構文に対応しています。
 132 .LP
 133 .nf
 134 \f3
 135 .fl
 136 [\fP\f4protocol\fP\f3:][[//]\fP\f4hostname\fP\f3][:\fP\f4port\fP\f3][/\fP\f4servername\fP\f3]\fP
 137 .br
 138 \f3
 139 .fl
 140 \fP
 141 .fi
 142 
 143 .LP
 144 .RS 3
 145 .TP 3
 146 protocol 
 147 通信プロトコルです。\f2protocol\fP が省略され、\f2hostname\fP が指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカルプロトコルになります。\f2protocol\fP が省略され、\f2hostname\fP が指定されている場合は、デフォルトプロトコルは \f3rmi\fP になります。 
 148 .TP 3
 149 hostname 
 150 ターゲットホストを示すホスト名または IP アドレスです。\f2hostname\fP が省略されている場合は、ターゲットホストはローカルホストになります。 
 151 .TP 3
 152 port 
 153 リモートサーバーと通信するためのデフォルトポートです。\f2hostname\fP が省略されているか、\f2protocol\fP で最適化されたローカルプロトコルが指定されている場合、\f2port\fP は無視されます。そうでなければ、\f2port\fP パラメータの扱いは、実装によって異なります。デフォルトの \f3rmi\fP プロトコルの場合、\f2port\fP は、リモートホスト上の rmiregistry のポート番号を示します。\f2port\fP が省略され、\f2protocol\fP で \f3rmi\fP が指定されている場合、デフォルトの rmiregistry ポート (1099) が使用されます。 
 154 .TP 3
 155 servername 
 156 このパラメータの扱いは、実装によって異なります。最適化されたローカルプロトコルの場合、このフィールドは無視されます。\f3rmi\fP プロトコルの場合、このパラメータは、リモートホスト上の RMI リモートオブジェクトの名前を示す文字列になります。jstatd(1) コマンドについては、\f3\-n\fP オプションを参照してください。 
 157 .RE
 158 
 159 .LP
 160 .SH "出力形式"
 161 .LP
 162 .LP
 163 \f3jps\fP コマンドの出力は、次のパターンに従います。
 164 .LP
 165 .nf
 166 \f3
 167 .fl
 168 \fP\f4lvmid\fP\f3 [ [ \fP\f4classname\fP\f3 | \fP\f4JARfilename\fP\f3 | "Unknown"] [ \fP\f4arg\fP\f3* ] [ \fP\f4jvmarg\fP\f3* ] ]\fP
 169 .br
 170 \f3
 171 .fl
 172 \fP
 173 .fi
 174 
 175 .LP
 176 .LP
 177 すべての出力トークンは空白で区切ります。\f2arg\fP の中で空白を使用すると、実際の定位置パラメータに引数をマッピングしようとするときに、あいまいになります。
 178 .br
 179 .br
 180 \f3注\fP: 将来のリリースでこの形式は変更される可能性があるため、\f3jps\fP の出力を解析するスクリプトは作成しないことをお勧めします。\f3jps\fP 出力を解析するスクリプトを作成すると、このツールの将来のリリースで、作成したスクリプトを変更する必要が予測されます。
 181 .br
 182 
 183 .LP
 184 .SH "例"
 185 .LP
 186 .LP
 187 この節では、\f3jps\fP コマンドの例を示します。
 188 .LP
 189 .LP
 190 ローカルホスト上で計測された JVM を一覧表示する場合:
 191 .LP
 192 .nf
 193 \f3
 194 .fl
 195 \fP\f3jps\fP
 196 .br
 197 
 198 .fl
 199 18027 Java2Demo.JAR
 200 .br
 201 
 202 .fl
 203 18032 jps
 204 .br
 205 
 206 .fl
 207 18005 jstat
 208 .br
 209 
 210 .fl
 211 .fi
 212 
 213 .LP
 214 .LP
 215 リモートホスト上で計測された JVM を一覧表示する場合:
 216 .LP
 217 .LP
 218 この例では、\f3jstat\fP サーバーと、その内部 RMI レジストリまたは別の外部 \f3rmiregistry\fP プロセスのいずれかとが、リモートホストのデフォルトポート (ポート 1099) で実行されていると想定しています。また、ローカルホストが、リモートホストへの有効なアクセス権を持っていることも想定しています。この例には、\f2\-l\fP オプションも含まれ、クラス名または JAR ファイル名を詳細な形式で出力します。
 219 .LP
 220 .nf
 221 \f3
 222 .fl
 223 \fP\f3jps \-l remote.domain\fP
 224 .br
 225 
 226 .fl
 227 3002 /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
 228 .br
 229 
 230 .fl
 231 2857 sun.tools.jstatd.jstatd
 232 .br
 233 
 234 .fl
 235 .fi
 236 
 237 .LP
 238 .LP
 239 RMI レジストリにデフォルトではないポートを使用して、リモートホスト上で計測された JVM を一覧表示する場合:
 240 .LP
 241 .LP
 242 この例では、内部 RMI レジストリがポート 2002 にバインドされた \f3jstatd\fP サーバーが、リモートホスト上で実行していると想定しています。また、\f2\-m\fP オプションを使用して、一覧表示されたそれぞれの Java アプリケーションの \f2main\fP メソッドに渡される引数を組み込んでいます。
 243 .LP
 244 .nf
 245 \f3
 246 .fl
 247 \fP\f3jps \-m remote.domain:2002\fP
 248 .br
 249 
 250 .fl
 251 3002 /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
 252 .br
 253 
 254 .fl
 255 3102 sun.tools.jstatd.jstatd \-p 2002
 256 .fl
 257 .fi
 258 
 259 .LP
 260 .SH "関連項目"
 261 .LP
 262 .RS 3
 263 .TP 2
 264 o
 265 「java(1) \- Java アプリケーション起動ツール」 
 266 .TP 2
 267 o
 268 「jstat(1) \- Java 仮想マシン統計データ監視ツール」 
 269 .TP 2
 270 o
 271 「jstatd(1) \- 仮想マシン jstat デーモン」 
 272 .TP 2
 273 o
 274 「rmiregistry(1) \- Java リモートオブジェクトレジストリ」 
 275 .RE
 276 
 277 .LP
 278