java

オプション

javaコマンドは、幅広いオプションをサポートしており、次のカテゴリに分けられます。

標準オプション
非標準オプション
拡張ランタイム・オプション
拡張JITコンパイラ・オプション
拡張保守性オプション
拡張ガベージ・コレクション・オプション

標準オプションは、Java仮想マシン(JVM)のすべての実装でサポートされることが保証されています。それらは、JREのバージョンの確認、クラス・パスの設定、詳細出力の有効化などの一般的なアクションに使用します。

非標準オプションはJava HotSpot仮想マシンに固有の汎用オプションであるため、すべてのJVM実装でサポートされる保証はなく、変更されることがあります。これらのオプションは-Xから始まります。

拡張オプションは不用意に使用することはお薦めしません。これらは、特定のシステム要件があり、システム構成パラメータに特権付きアクセスを必要とするようなJava HotSpot仮想マシンの操作の特定の領域のチューニングに使用するための開発者用オプションです。それらは、すべてのJVM実装でサポートされている保証はなく、変更されることがあります。拡張オプションは-XXから始まります。

最新のリリースで非推奨にされたか、削除されたオプションを追跡するには、ドキュメントの最後の「非推奨のオプションと削除されたオプション」というセクションがあります。

ブール・オプションは、デフォルトで無効にされている機能を有効にするか、デフォルトで有効にされている機能を無効にするために使用します。それらのオプションではパラメータは必要ありません。ブール-XXオプションは、プラス記号を使用して有効にし(-XX:+OptionName)、マイナス記号を使用して無効にします(-XX:-OptionName)。

引数を必要とするオプションの場合、引数とオプション名はスペース、コロン(:)または等号(=)で区切るか、またはオプションの後に直接引数を続けることもできます(正確な構文はオプションごとに異なります)。バイト単位のサイズを指定する必要がある場合は、接尾辞を使用しないか、またはキロバイト(KB)の場合に接尾辞kまたはK、メガバイト(MB)の場合にmまたはM、ギガバイト(GB)の場合にgまたはGを使用できます。たとえば、サイズを8Gバイトに設定するには、引数として、8g、8192m、8388608kまたは8589934592と指定できます。パーセンテージを指定する必要がある場合は、0から1の数値を使用します(たとえば、25%の場合0.25と指定する)。

標準オプション

これらは、JVMのすべての実装でサポートされるもっとも一般的に使われるオプションです。

-agentlib:libname[=options]

非標準オプション

これらのオプションは、Java HotSpot仮想マシンに固有の汎用オプションです。

-X

使用可能なすべての-Xオプションのヘルプを表示します。

-Xbatch

バックグラウンド・コンパイルを無効にします。デフォルトで、JVMは、メソッドをバックグラウンド・タスクとしてコンパイルし、バックグラウンド・コンパイルが終了するまでインタプリタ・モードでメソッドを実行します。-Xbatchフラグは、バックグラウンド・コンパイルを無効にするため、すべてのメソッドのコンパイルが完了するまでフォアグラウンド・タスクとして処理されます。

このオプションは-XX:-BackgroundCompilationと同等です。

-Xbootclasspath:path

ブート・クラス・ファイルを探すディレクトリ、JARファイル、およびZIPアーカイブをコロン(:)で区切ったリストで指定します。それらが、JDKに含まれるブート・クラス・ファイルの代わりに使用されます。

rt.jar内のクラスをオーバーライドするためにこのオプションを使用するアプリケーションは配備しないでください。これはJRE バイナリ・コード・ライセンス違反になります。

-Xbootclasspath/a:path

ディレクトリ、JARファイル、およびZIPアーカイブをコロン(:)で区切ったリストで指定します。これらはデフォルトのブートストラップ・クラス・パスの後に追加されます。

-Xbootclasspath/p:path

ディレクトリ、JARファイル、およびZIPアーカイブをコロン(:)で区切ったリストで指定します。これらはデフォルトのブートストラップ・クラス・パスの前に追加されます。

-Xcheck:jni

Java Native Interface (JNI)機能に対して追加チェックを行います。具体的には、それはJNI要求を処理する前に、JNI関数に渡されるパラメータと、実行時環境データを検証します。無効なデータが見つかった場合は、ネイティブ・コードに問題があることを示しており、その場合に、JVMは回復不能なエラーを発生して終了します。このオプションを使用すると、パフォーマンス低下が予想されます。

-Xcomp

最初の呼出しで、メソッドのコンパイルを強制的に実行します。デフォルトで、クライアントVM (-client)は1,000回の解析対象メソッドの呼出しを実行し、サーバーVM (-server)は10,000回の解析対象メソッドの呼出しを実行して、効率的なコンパイルのための情報を収集します。-Xcompオプションを指定すると、解析対象メソッドの呼出しを無効にするため、効率性と引き換えにコンパイルのパフォーマンスが向上します。

-XX:CompileThresholdオプションを使用して、コンパイル前の解析対象メソッドの呼出し数を変更することもできます。

-Xdebug

何も行いません。下位互換性を維持するために提供されています。

-Xdiag

追加の診断メッセージを表示します。

-Xfuture

クラスファイル形式の仕様への厳密な準拠を適用するクラスファイル形式の厳密なチェックを有効にします。将来のリリースでは、より厳密なチェックがデフォルトになるため、新しいコードを開発するときにはこのフラグを使用することをお薦めします。

-Xint

インタプリタ専用モードでアプリケーションを実行します。ネイティブ・コードへのコンパイルは無効になり、すべてのバイト・コードがインタプリタによって実行されます。Just-In-Time (JIT)コンパイラが提供するパフォーマンス上の利点は、このモードでは実現されません。

-Xinternalversion

-versionオプションよりも詳しいJVMバージョン情報を表示して、終了します。

-Xloggc:filename

ロギングのため、詳細GCイベント情報をリダイレクトするファイルを設定します。このファイルに書き込まれる情報は、ロギングされた各イベントの前の最初のGCイベントから経過した時間での-verbose:gcの出力と似ています。同じjavaコマンドで両方が指定された場合に、-Xloggcオプションは、-verbose:gcをオーバーライドします。

例:

-Xloggc:garbage-collection.log

-Xmaxjitcodesize=size

JITでコンパイルされたコードの最大コード・キャッシュ・サイズ(バイト単位)を指定します。キロバイトを指定するには文字kまたはK、メガバイトを指定するには文字mまたはM、ギガバイトを指定するには文字gまたはGを付けます。デフォルトの最大コード・キャッシュ・サイズは240MBです。オプション-XX:-TieredCompilationを使用して階層化コンパイルを無効にした場合、デフォルトのサイズは48MBです。

-Xmaxjitcodesize=240m

このオプションは-XX:ReservedCodeCacheSizeと同等です。

-Xmixed

ネイティブ・コードにコンパイルされるホット・メソッドを除くすべてのバイトコードをインタプリタによって実行します。

-Xmnsize

Young世代(ナーサリ)のヒープの初期および最大サイズ(バイト単位)を設定します。キロバイトを指定するには文字kまたはK、メガバイトを指定するには文字mまたはM、ギガバイトを指定するには文字gまたはGを付けます。

ヒープのYoung世代領域は新しいオブジェクトに使用されます。この領域では他の領域よりも頻繁にGCが実行されます。Young世代のサイズが小さすぎる場合は、大量のマイナー・ガベージ・コレクションが実行されます。そのサイズが大きすぎる場合は、完全ガベージ・コレクションのみが実行されますが、これは完了までに長い時間がかかることがあります。Oracleでは、Young世代のサイズをヒープ・サイズ全体の半分から4分の1の間に維持することをお薦めします。

次の例では、様々な単位を使用して、Young世代の初期および最大サイズを256Mバイトに設定する方法を示します。

-Xmn256m
-Xmn262144k
-Xmn268435456

Young世代のヒープの初期サイズと最大サイズの両方を設定する-Xmnオプションの代わりに、-XX:NewSizeを使用して、初期サイズを設定し、-XX:MaxNewSizeを使用して、最大サイズを設定できます。

-Xmssize

ヒープの初期サイズ(バイト単位)を設定します。この値は、1024の倍数で1Mバイトより大きくなければなりません。キロバイトを指定するには文字kまたはK、メガバイトを指定するには文字mまたはM、ギガバイトを指定するには文字gまたはGを付けます。

次の例では、様々な単位を使用して、割り当てられたメモリーのサイズを6Mバイトに設定する方法を示します。

-Xms6291456
-Xms6144k
-Xms6m

このオプションを設定しない場合、初期サイズは、Old世代とYoung世代に割り当てられたサイズの合計として設定されます。Young世代のヒープの初期サイズは、-Xmnオプションまたは-XX:NewSizeオプションを使用して設定できます。

-Xmxsize

メモリー割当てプールの最大サイズ(バイト単位)を指定します。この値は、1024の倍数で、2Mバイトより大きくなければなりません。キロバイトを指定するには文字kまたはK、メガバイトを指定するには文字mまたはM、ギガバイトを指定するには文字gまたはGを付けます。デフォルト値は、実行時にシステムの設定に基づいて選択されます。サーバー配備の場合、-Xmsと-Xmxが同一の値に設定されていることがよくあります。『Java SE HotSpot Virtual Machineガベージ・コレクション・チューニング・ガイド』(http://docs.oracle.com/javase/8/docs/technotes/guides/vm/gctuning/index.html)のエルゴノミクスに関する項を参照してください。

次の例では、様々な単位を使用して、割り当てられたメモリーの最大許容サイズを80Mバイトに設定する方法を示します。

-Xmx83886080
-Xmx81920k
-Xmx80m

-Xmxオプションは-XX:MaxHeapSizeと同等です。

-Xnoclassgc

クラスのガベージ・コレクション(GC)を無効にします。これによりいくらかのGC時間が節約され、アプリケーション実行時の割込みが短くなります。

起動時に-Xnoclassgcを指定すると、GC時にアプリケーションのクラス・オブジェクトがそのままの状態にされ、常に有効であるとみなされます。これにより、多くのメモリーが永続的に占有されることになるため、慎重に使用しないと、メモリー不足の例外がスローされます。

-Xprof

実行中のプログラムのプロファイルを生成し、プロファイル・データを標準出力に出力します。このオプションは、プログラム開発で役立つユーティリティとして提供されており、本番稼動システムでの使用を目的としたものではありません。

-Xrs

JVMによるオペレーティング・システム・シグナルの使用を減らします。

シャットダウン・フックにより、JVMが突然終了した場合でも、シャットダウン時にユーザー・クリーン・アップコード(データベース接続のクローズなど)を実行して、Javaアプリケーションの正常なシャットダウンができるようになりました。

JVMは、シグナルをキャッチすることによって、異常終了のためのシャットダウン・フックを実装します。JVMは、SIGHUP、SIGINT、およびSIGTERMを使用して、シャットダウン・フックの実行を開始します。

JVMは、デバッグ用のスレッド・スタックをダンプする機能を実現するためにも、同様のメカニズムを使用します。JVMは、スレッド・ダンプを実行するためにSIGQUITを使用します。

JVMを埋め込んでいるアプリケーションがSIGINTやSIGTERMなどのシグナルを頻繁にトラップする必要があると、JVMのシグナル・ハンドラの処理に支障が出る可能性があります。-Xrsオプションを使用すると、この問題に対処できます。-Xrsを使用すると、SIGINT、SIGTERM、SIGHUP、およびSIGQUITに対するシグナル・マスクはJVMによって変更されず、これらのシグナルに対するシグナル・ハンドラはインストールされません。

-Xrsを指定した場合は、2つの影響があります。

SIGQUITによるスレッド・ダンプを利用できない。
シャットダウン・フックの実行は、JVMが終了しようとしている時点でSystem.exit()を呼び出すなどして、ユーザー・コード側で行います。

-Xshare:mode

クラス・データ共有(CDS)モードを設定します。このオプションのmode引数には次を指定できます。

auto

可能な場合は、CDSを使用します。これはJava HotSpot 32-Bit Client VMのデフォルト値です。

on

CDSの使用が必須です。クラス・データ共有を使用できない場合は、エラー・メッセージを出力し、終了します。

off

CDSは使用しないでください。これはJava HotSpot 32-Bit Server VM、Java HotSpot 64-Bit Client VMおよびJava HotSpot 64-Bit Server VMのデフォルト値です。

dump

CDSアーカイブを手動で生成します。「クラス・パスの設定」の説明に従って、アプリケーション・クラス・パスを指定します。

新しいJDKリリースを使用してCDSアーカイブを再生成する必要があります。

-XshowSettings:category

設定を表示し、続行します。このオプションのcategory引数には次を指定できます。

all: 設定のすべてのカテゴリを表示します。これがデフォルト値です。
locale: ロケールに関連する設定を表示します。
properties: システム・プロパティに関連する設定を表示します。
vm: JVMの設定を表示します。

-Xsssize

スレッド・スタック・サイズ(バイト単位)を設定します。Kバイトを指定するには文字kまたはK、Mバイトを指定するには文字mまたはM、Gバイトを指定するには文字gまたはGを付けます。デフォルト値はプラットフォームによって異なります。

Linux/ARM (32ビット): 320Kバイト
Linux/i386 (32ビット): 320Kバイト
Linux/x64 (64ビット): 1024Kバイト
OS X (64ビット): 1024Kバイト
Oracle Solaris/i386 (32ビット): 320Kバイト
Oracle Solaris/x64 (64ビット): 1024Kバイト

次の例では、様々な単位でスレッド・スタック・サイズを1024Kバイトに設定します。

-Xss1m
-Xss1024k
-Xss1048576

このオプションは-XX:ThreadStackSizeと同等です。

-Xusealtsigs

JVM内部シグナルとして、SIGUSR1およびSIGUSR2のかわりに代替シグナルを使用します。このオプションは-XX:+UseAltSigsと同等です。

-Xverify:mode

バイトコード・ベリファイアのモードを設定します。バイトコード検証では、クラス・ファイルの形式が正しく、Java仮想マシンの仕様のセクション4.10、classファイルの検証に関する項に記載されている制約を満足していることが確認されます。

検証を無効にすると、Javaが提供している保護が低下し、形式が正しくないクラス・ファイルのために問題が発生することもあるため、無効にしないでください。

このオプションのmode引数には次を指定できます。

remote: ブートストラップ・クラス・ローダーでロードされていないすべてのバイトコードを検証します。これは-Xverifyオプションを指定しない場合のデフォルトの動作です。
all: すべてのバイトコードの検証を有効にします。
none: すべてのバイトコードの検証を無効にします。-Xverify:noneの使用はサポートされていません。

拡張ランタイム・オプション

これらのオプションはJava HotSpot VMのランタイム動作を制御します。

-XX:+CheckEndorsedAndExtDirs

承認された標準のオーバーライド機構または拡張機能機構を使用する場合、javaコマンドがJavaアプリケーションを実行するのを、オプションで防止できるようにします。このオプションは、次を確認することによって、アプリケーションがそのいずれかの機構を使用しているかどうかを確認します。

java.ext.dirsまたはjava.endorsed.dirsシステム・プロパティが設定されている。
lib/endorsedディレクトリが存在し、空でない。
lib/extディレクトリに、JDKのものを除き、あらゆるJARファイルがある。
プラットフォーム固有のシステム全体の拡張ディレクトリにJARファイルが含まれている。

-XX:+DisableAttachMechanism

ツールをJVMに添付できるメカニズムを無効にするオプションを有効にします。デフォルトでこのオプションは無効であり、添付メカニズムが有効にされていることを意味するため、jcmd、jstack、jmapおよびjinfoなどのツールを使用できます。

-XX:ErrorFile=filename

回復不能なエラーが発生した場合に、エラー・データが書き込まれるパスとファイル名を指定します。デフォルトで、このファイルは現在の作業ディレクトリに作成され、hs_err_pidpid.logと名付けられます。ここでpidはエラーを発生させたプロセスの識別子です。次の例では、デフォルトのログ・ファイルを設定する方法を示します(プロセスの識別子は%pで指定されることに注意してください)。

-XX:ErrorFile=./hs_err_pid%p.log

次の例は、エラー・ログを/var/log/java/java_error.logに設定する方法を示しています。

-XX:ErrorFile=/var/log/java/java_error.log

指定されたディレクトリにファイルを作成できない場合(領域不足、アクセス権の問題またはその他の問題のため)、ファイルはオペレーティング・システムの一時ディレクトリに作成されます。一時ディレクトリは/tmpです。

-XX:+FailOverToOldVerifier

新しい型チェッカーが失敗した場合に、古いベリファイアへの自動フェールオーバーを有効にします。デフォルトでは、このオプションは無効になっており、最近のバイトコード・バージョンのクラスに対してこれが無視されます(つまり、無効として扱われる)。古いバージョンのバイトコードのクラスに対してそれを有効にできます。

-XX:+FlightRecorder

アプリケーション実行時のJava Flight Recorder (JFR)の使用を有効にします。これは、次のように、-XX:+UnlockCommercialFeaturesオプションとともに動作する商用機能です:

java -XX:+UnlockCommercialFeatures -XX:+FlightRecorder

このオプションを指定しない場合、適切なjcmd診断コマンドを使用することで、実行中のJVMでJava Flight Recorderを有効化することもできます。

-XX:-FlightRecorder

アプリケーション実行時のJava Flight Recorder (JFR)の使用を無効にします。これは、次のように、-XX:+UnlockCommercialFeaturesオプションとともに動作する商用機能です:

java -XX:+UnlockCommercialFeatures -XX:-FlightRecorder

このオプションを指定する場合、実行中のJVMでJava Flight Recorderを有効化することはできません。

-XX:FlightRecorderOptions=parameter=value

JFRの動作を制御するパラメータを設定します。これは、-XX:+UnlockCommercialFeaturesオプションとともに動作する商用機能です:このオプションは、JFRが有効になっている(つまり、-XX:+FlightRecorderオプションが指定されている)場合にのみ使用できます。

次のリストには、使用可能なすべてのJFRパラメータが含まれています。

defaultrecording={true|false}

記録が連続的バックグラウンド記録なのか、限られた期間だけ実行するのかを指定します。デフォルトでは、このパラメータはfalse (限られた期間だけ記録を実行する)に設定されます。記録を連続的に実行するには、このパラメータをtrueに設定します。

disk={true|false}

JFRが連続的な記録をディスクに書き込むべきかどうかを指定します。デフォルトでは、このパラメータはfalse (ディスクへの連続的な記録を無効にする)に設定されます。有効にするには、このパラメータをtrueに設定し、同時にdefaultrecording=trueに設定します。

dumponexit={true|false}

制御された方法でJVMが終了するときに、JFRデータのダンプ・ファイルを生成するべきかどうかを指定します。デフォルトでは、このパラメータはfalse (終了時にダンプ・ファイルを生成しない)に設定されます。有効にするには、このパラメータをtrueに設定し、同時にdefaultrecording=trueに設定します。

ダンプ・ファイルは、dumponexitpathパラメータによって定義された場所に書き込まれます。

dumponexitpath=path

制御された方法でJVMが終了するとき(dumponexit=trueパラメータを設定した場合)に作成される、JFRデータを含むダンプ・ファイルのパスと名前を指定します。このパスの設定は、同時にdefaultrecording=trueを設定した場合にのみ有効です。

指定されたパスがディレクトリの場合、JVMは作成日時を示すファイル名を割り当てます。指定されたパスにファイル名が含まれており、そのファイルがすでに存在する場合、JVMは指定されたファイル名に日時スタンプを追加して新しいファイルを作成します。

globalbuffersize=size

データの保持に使用されるプライマリ・メモリーの合計量(バイト単位)を指定します。Kバイト単位のサイズを指定するにはkまたはK、Mバイト単位のサイズを指定するにはmまたはM、Gバイト単位のサイズを指定するにはgまたはGを付けます。デフォルトでは、このサイズは462848バイトに設定されます。

loglevel={quiet|error|warning|info|debug|trace}

JFRによってログ・ファイルに書き込まれるデータの量を指定します。デフォルトでは、infoに設定されます。

maxage=time

デフォルトの記録用にディスク・データを維持する最大期間を指定します。時間を秒で指定するためにはs、分の場合はm、時間の場合はhまたは日の場合dを追加します(たとえば、30sの指定は、30秒を意味します)。デフォルトでは、最大期間は15分(15m)に設定されます。

このパラメータは、disk=trueパラメータを設定した場合にのみ有効です。

maxchunksize=size

記録のデータ・チャンクの最大サイズ(バイト単位)を指定します。Kバイト単位のサイズを指定するにはkまたはK、Mバイト単位のサイズを指定するにはmまたはM、Gバイト単位のサイズを指定するにはgまたはGを付けます。デフォルトでは、データ・チャンクの最大サイズは12Mバイトに設定されます。

maxsize=size

デフォルト記録用に維持するディスク・データの最大サイズ(バイト単位)を指定します。Kバイト単位のサイズを指定するにはkまたはK、Mバイト単位のサイズを指定するにはmまたはM、Gバイト単位のサイズを指定するにはgまたはGを付けます。デフォルトで、ディスク・データの最大サイズは無制限で、このパラメータは0に設定されています。

このパラメータは、disk=trueパラメータを設定した場合にのみ有効です。

repository=path

一時ディスク・ストレージのリポジトリ(ディレクトリ)を指定します。デフォルトでは、システムの一時ディレクトリが使用されます。

samplethreads={true|false}

スレッド・サンプリングを有効にするかどうかを指定します。スレッド・サンプリングは、このパラメータとともにサンプリング・イベントが有効にされている場合にのみ行われます。デフォルトでは、このパラメータは有効になっています。

settings=path

イベント設定ファイル(種類はJFC)のパスと名前を指定します。デフォルトでは、JAVA_HOME/jre/lib/jfrにあるdefault.jfcファイルが使用されます。

stackdepth=depth

JFRによるスタック・トレースのスタックの深さ。デフォルトでは、この深さは64回のメソッド呼出しに設定されます。最大は2048、最小は1です。

threadbuffersize=size

スレッドごとのローカル・バッファ・サイズ(バイト単位)を指定します。Kバイト単位のサイズを指定するにはkまたはK、Mバイト単位のサイズを指定するにはmまたはM、Gバイト単位のサイズを指定するにはgまたはGを付けます。このパラメータの値を大きくすると、グローバル・ストレージへのフラッシュと競合せずに、より多くのデータを収集できます。スレッドリッチ環境でアプリケーション・フットプリントが増加する場合があります。デフォルトでは、ローカル・バッファ・サイズは5Kバイトに設定されます。

複数のパラメータの値を指定するには、それらをコロンで区切ります。たとえば、連続的な記録をディスクに書き込むようにJFRに指示し、データ・チャンクの最大サイズを10Mバイトに設定するには、次を指定します。

-XX:FlightRecorderOptions=defaultrecording=true,disk=true,maxchunksize=10M

-XX:LargePageSizeInBytes=size

Solarisでは、Javaヒープに使用されるラージ・ページの最大サイズ(バイト単位)を設定します。size引数は2の累乗でなければなりません(2、4、8、16...)。キロバイトを指定するには文字kまたはK、メガバイトを指定するには文字mまたはM、ギガバイトを指定するには文字gまたはGを付けます。デフォルトでサイズは0に設定され、JVMがラージ・ページのサイズを自動的に選択することを意味します。

次の例では、ラージ・ページ・サイズを4Mバイトに設定する方法を示します。

-XX:LargePageSizeInBytes=4m

-XX:MaxDirectMemorySize=size

New I/O (java.nioパッケージ)ダイレクトバッファ割当ての最大合計サイズ(バイト単位)を設定します。キロバイトを指定するには文字kまたはK、メガバイトを指定するには文字mまたはM、ギガバイトを指定するには文字gまたはGを付けます。デフォルトでサイズは0に設定され、JVMがNIOダイレクトバッファ割当てのサイズを自動的に選択することを意味します。

次の例では、様々な単位でNIOのサイズを1024Kバイトに設定する方法を示しています。

-XX:MaxDirectMemorySize=1m
-XX:MaxDirectMemorySize=1024k
-XX:MaxDirectMemorySize=1048576

-XX:NativeMemoryTracking=mode

JVMネイティブ・メモリーの使用状況の追跡のモードを指定します。このオプションのmode引数には次を指定できます。

off: JVMネイティブ・メモリーの使用状況を追跡しません。これは-XX:NativeMemoryTrackingオプションを指定しない場合のデフォルトの動作です。
summary: Javaヒープ、クラス、コード、およびスレッドなどのJVMサブシステムによるメモリー使用状況のみを追跡します。
detail: JVMサブシステムによるメモリー使用状況の追跡に加えて、各CallSite、各仮想メモリー領域およびそのコミット済領域によるメモリー使用状況を追跡します。

-XX:ObjectAlignmentInBytes=alignment

Javaオブジェクトのメモリー配置を設定します(バイト単位)。デフォルトでは、値が8バイトに設定されます。指定される値は、2の累乗にして8から256(両端を含む)の範囲内にする必要があります。このオプションにより、大きいJavaヒープ・サイズで圧縮ポインタを使用できます。

バイト単位のヒープ・サイズ制限は次のように計算されます:

4GB * ObjectAlignmentInBytes

注意: 配置の値が増えると、オブジェクト間の未使用の領域も増えます。結果として、大きいヒープ・サイズで圧縮ポインタを使用するメリットがわからない可能性があります。

-XX:OnError=string

回復不能なエラーが発生した場合に実行するカスタム・コマンドまたは一連のセミコロン区切りのコマンドを設定します。文字列にスペースを含む場合は、二重引用符で囲む必要があります。

次の例は、-XX:OnErrorオプションを使用してgcoreコマンドを実行する方法を示しています。回復不能なエラーが発生した場合に、このコマンドによってコア・イメージを作成し、デバッガを起動してプロセスに接続します(%pは現在のプロセスを指定します)。

-XX:OnError="gcore %p;dbx - %p"

-XX:OnOutOfMemoryError=string

OutOfMemoryError例外が最初にスローされた場合に実行するカスタム・コマンドまたは一連のセミコロン区切りのコマンドを設定します。文字列にスペースを含む場合は、二重引用符で囲む必要があります。コマンド文字列の例については、-XX:OnErrorオプションの説明を参照してください。

-XX:+PerfDataSaveToFile

有効にすると、Javaアプリケーションの終了時に jstat(1)バイナリ・データを保存します。このバイナリ・データは、hsperfdata_<pid>という名前のファイルに保存されます。ここで<pid>は実行したJavaアプリケーションのプロセス識別子です。次のようにjstatを使用して、このファイルに含まれるパフォーマンス・データを表示します。

jstat -class file:///<path>/hsperfdata_<pid>
jstat -gc file:///<path>/hsperfdata_<pid>

-XX:-PreferContainerQuotaForCPUCount

trueの場合は、そのCPU CFS (Completely Fair Scheduler)割当ての値(設定されている場合)に基づいてコンテナCPUの可用性を計算します。falseの場合、CPU共有値がCPU割当て値より小さければ、CPU共有値をかわりに使用します。

VMでは、-XX:ActiveProcessorCountオプションを使用して指定しなかった場合、コンテナCPUの可用性の値を使用して、使用可能なプロセッサの数を計算します。

注意: プロセスで使用可能なアクティブ・プロセッサの数をCPU数が超えることはありません。アクティブなプロセッサは、無効にするか、コンテナのcpuset (CPUのリスト。PrintContainerInfoオプションを参照)を選択することによって、制限されている場合があります。

-XX:+PrintCommandLineFlags

コマンド行に表示されるエルゴノミクスに従って選択されたJVMフラグの出力を有効にします。これは、ヒープ領域サイズや選択されたガベージ・コレクタなどのJVMによって設定されたエルゴノミクス値を知るために役立つ可能性があります。デフォルトでは、このオプションは無効になっており、フラグは出力されません。

-XX:+PrintContainerInfo

コンテナに関する次の情報を出力します:

cpuset.cpus: 複数のCPUまたはコアがある場合にコンテナで使用できるCPUまたはコアのカンマ区切りのリストまたはハイフン区切りの範囲。たとえば、0-3という値は、コンテナが最初、2番目、3番目および4番目のCPUを使用できることを意味します。
cpuset.mems: 実行、アプリケーションの実行を許可するメモリー・ノード(MRM)のカンマ区切りリストまたはハイフン区切りの範囲。不均一メモリー・アクセス(NUMA)システムでのみ有効です。
CPU Shares: プロセスで使用可能なCPU共有の量。
CPU Quota: 期間当たりのプロセスが実行されることが保証された時間(ミリ秒)。
CPU Period: CPUのCompletely Fair Scheduler (CFS)期間(ミリ秒単位)
OSContainer::active_processor_count: 使用するVMのアクティブなプロセッサの数。
Memory Limit: コンテナで使用できるメモリーの最大量(バイト単位)。
Memory Soft Limit: コンテナで使用するメモリーの最大量(バイト単位)。この制限はMemory Limitよりも小さくなりますが、ソフト制限のためコンテナはその値を超える場合があります。
Memory Usage: このプロセスの使用済メモリーの量(バイト単位)。
Maximum Memory Usage: このプロセスの使用済メモリーの最大量(バイト単位)。

-XX:+PrintNMTStatistics

メモリー追跡が有効にされている場合(-XX:NativeMemoryTrackingを参照)、JVMで収集されたネイティブ・メモリー追跡データの出力を有効にします。デフォルトでは、このオプションは無効になっており、ネイティブ・メモリー追跡データは出力されません。

-XX:+RelaxAccessControlCheck

ベリファイアのアクセス制御チェックの量を減らします。デフォルトでは、このオプションは無効になっており、最近のバイトコード・バージョンのクラスに対してこれが無視されます(つまり、無効として扱われる)。古いバージョンのバイトコードのクラスに対してそれを有効にできます。

-XX:+ResourceManagement

アプリケーションの実行中にリソース管理の使用を有効にします。

これは、次のように-XX:+UnlockCommercialFeaturesオプションを同時に指定する必要がある商用機能です。

java -XX:+UnlockCommercialFeatures -XX:+ResourceManagement

-XX:ResourceManagementSampleInterval=value (ミリ秒)

ミリ秒単位でリソース管理測定のサンプリング間隔を制御するパラメータを設定します。

リソース管理が有効な場合のみ(つまり、-XX:+ResourceManagementオプションが指定されている場合)、このオプションを使用できます。

-XX:SharedArchiveFile=path

クラス・データ共有(CDS)アーカイブ・ファイルのパスと名前を指定します

-XX:SharedClassListFile=file_name

クラス・データ共有(CDS)アーカイブに格納するクラス・ファイルの名前を含むテキスト・ファイルを指定します。このファイルは、クラス・ファイルのフル・ネームを1行に1つ含みます。ただしスラッシュ(/)はドット(.)に置換されます。たとえば、クラスjava.lang.Objectとhello.Mainを指定するには、次の2行を含むテキスト・ファイルを作成します。

java/lang/Object
hello/Main

このテキスト・ファイルで指定するクラス・ファイルには、アプリケーションでよく使用されるクラスを含める必要があります。アプリケーション、機能拡張またはブートストラップ・クラス・パスからのあらゆるクラスが含まれる場合があります。

-XX:+ShowMessageBoxOnError

JVMで回復不能なエラーが発生した場合に、ダイアログ・ボックスの表示を有効にします。これにより、JVMの終了を回避し、プロセスをアクティブに維持するため、これにデバッガを接続して、エラーの原因を調査できます。デフォルトでは、このオプションは無効になっています。

-XX:StartFlightRecording=parameter=value

JavaアプリケーションのJFR記録を開始します。これは、-XX:+UnlockCommercialFeaturesオプションとともに動作する商用機能です:このオプションは、実行時に記録を開始するJFR.start診断コマンドと同等です。JFR記録を開始するときに、次のパラメータを設定できます。

compress={true|false}

gzipファイル圧縮ユーティリティを使用してディスク上のJFR記録ログ・ファイル(種類はJFR)を圧縮するかどうかを指定します。このパラメータは、filenameパラメータが指定されている場合にのみ有効です。デフォルトでは、false (記録を圧縮しない)に設定されます。圧縮を有効にするには、このパラメータをtrueに設定します。

defaultrecording={true|false}

delay=time

Javaアプリケーションの起動時間から記録を開始するまでの遅延時間を指定します。時間を秒で指定するためにはs、分の場合はm、時間の場合はhまたは日の場合はdを追加します(たとえば、10mの指定は、10分を意味します)。デフォルトでは、遅延はなく、このパラメータは0に設定されます。

dumponexit={true|false}

制御された方法でJVMが終了するときに、JFRデータのダンプ・ファイルを生成するべきかどうかを指定します。デフォルトでは、このパラメータはfalse (終了時にダンプ・ファイルを生成しない)に設定されます。有効にするには、パラメータをtrueに設定します。

ダンプ・ファイルは、filenameパラメータで定義された場所に書き込まれます。

例:

-XX:StartFlightRecording=name=test,filename=D:\test.jfr,dumponexit=true

duration=time

記録の継続時間を指定します。時間を秒で指定するためにはs、分の場合はm、時間の場合はhまたは日の場合はdを追加します(たとえば、5hの指定は、5時間を意味します)。デフォルトで、継続時間は無制限で、このパラメータは0に設定されています。

filename=path

JFR記録ログ・ファイルのパスと名前を指定します。

name=identifier

JFR記録の識別子を返します。デフォルトでは、Recording xに設定されます。

maxage=time

maxsize=size

settings=path

イベント設定ファイル(種類はJFC)のパスと名前を指定します。デフォルトでは、JAVA_HOME/jre/lib/jfrにあるdefault.jfcファイルが使用されます。

複数のパラメータの値を指定するには、それらをコロンで区切ります。たとえば、現在の作業ディレクトリ内のtest.jfrに記録を保存し、ログ・ファイルを圧縮するようにJFRに指示するには、次を指定します。

-XX:StartFlightRecording=filename=test.jfr,compress=true

-XX:ThreadStackSize=size

スレッド・スタック・サイズ(バイト単位)を設定します。キロバイトを指定するには文字kまたはK、メガバイトを指定するには文字mまたはM、ギガバイトを指定するには文字gまたはGを付けます。デフォルト値はプラットフォームによって異なります。

Linux/ARM (32ビット): 320Kバイト
Linux/i386 (32ビット): 320Kバイト
Linux/x64 (64ビット): 1024Kバイト
OS X (64ビット): 1024Kバイト
Oracle Solaris/i386 (32ビット): 320Kバイト
Oracle Solaris/x64 (64ビット): 1024Kバイト

次の例では、様々な単位でスレッド・スタックのサイズを1024Kバイトに設定する方法を示しています。

-XX:ThreadStackSize=1m
-XX:ThreadStackSize=1024k
-XX:ThreadStackSize=1048576

このオプションは-Xssと同等です。

-XX:+TraceClassLoading

クラスがロードされたときに、それらの追跡を有効にします。デフォルトでは、このオプションは無効になっており、クラスは追跡されません。

-XX:+TraceClassLoadingPreorder

ロードされたすべてのクラスの追跡をそれらが参照される順番で有効にします。デフォルトでは、このオプションは無効になっており、クラスは追跡されません。

-XX:+TraceClassResolution

定数プールの解決の追跡を有効にします。デフォルトでは、このオプションは無効になっており、定数プールの解決は追跡されません。

-XX:+TraceClassUnloading

クラスがアンロードされたときに、それらの追跡を有効にします。デフォルトでは、このオプションは無効になっており、クラスは追跡されません。

-XX:+TraceLoaderConstraints

ローダーの制約の記録の追跡を有効にします。デフォルトでは、このオプションは無効であり、ローダー制約の記録は追跡されません。

-XX:+UnlockCommercialFeatures

商用機能の使用を有効にします。商用機能は、http://www.oracle.com/technetwork/java/javase/terms/products/index.htmlのJava SE製品のページで定義されているOracle Java SE AdvancedまたはOracle Java SE Suiteパッケージに含まれています。

デフォルトでは、このオプションは無効になっており、JVMは商用機能なしで実行します。JVMプロセスでそれらを有効にすると、そのプロセスでのそれらの使用を無効にすることはできません。

このオプションを指定しない場合、適切なjcmd診断コマンドを使用することでも、実行中のJVMで商用機能のロックを解除できます。

-XX:+UseAltSigs

JVM内部シグナルとして、SIGUSR1およびSIGUSR2のかわりに代替シグナルを使用できるようにします。デフォルトでは、このオプションは無効になっており、代替シグナルは使用されません。このオプションは-Xusealtsigsと同等です。

-XX:+UseAppCDS

アプリケーション・クラス・データ共有(AppCDS)を有効化します。AppCDSを使用するには、CDSダンプ時刻(オプション-Xshare:dumpを参照)とアプリケーション実行時刻の間に、オプション-XX:SharedClassListFileおよび-XX:SharedArchiveFileの値を指定する必要もあります。

これは、-XX:+UnlockCommercialFeaturesオプションを同時に指定する必要がある商用機能です。これは実験的な機能でもあり、今後のリリースで変更される場合があります。

「アプリケーション・クラス・データ共有」を参照してください。

-XX:-UseBiasedLocking

バイアス・ロックの使用を無効にします。大量の非競合同期を行うアプリケーションは、このフラグを有効にすることで大幅な高速化が実現されることがありますが、特定のパターンのロックを行うアプリケーションは速度が低下することがあります。Biased Locking技法の詳細は、http://www.oracle.com/technetwork/java/tuning-139912.html#section4.2.5のJavaのチューニングに関するホワイト・ペーパーの例を参照してください。

デフォルトでは、このオプションが有効になっています。

-XX:-UseCompressedOops

圧縮されたポインタの使用を無効にします。デフォルトではこのオプションが有効であり、Javaヒープ・サイズが32GBより小さい場合に圧縮ポインタが使用されます。このオプションが有効にされている場合、オブジェクト参照は64ビット・ポインタの代わりに32ビットのオフセットで表され、アプリケーションを32GB未満のJavaヒープ・サイズで実行している場合に、一般にパフォーマンスが向上します。このオプションは64ビットJVMの場合にのみ機能します。

Javaヒープ・サイズが32GBより大きい場合にも圧縮ポインタを使用できます。-XX:ObjectAlignmentInBytesオプションを参照してください。

-XX:-UseContainerSupport

VMで自動コンテナ検出サポートが提供され、これによって、Dockerコンテナ内で実行されるJavaプロセスで使用可能なメモリーの容量およびプロセッサの数をVMで決定できます。この情報はシステム・リソースを割り当てるために使用されます。このサポートはLinux x64プラットフォームでのみ使用できます。サポートされている場合、このフラグのデフォルト値はtrueで、コンテナのサポートはデフォルトで有効になります。無効にするには、-XX:-UseContainerSupportを使用します。

-XX:+UseHugeTLBFS

Linux用のこのオプションは、-XX:+UseLargePagesを指定するのと同じです。このオプションはデフォルトでは無効です。このオプションは、メモリーの予約時にすべてのラージ・ページを事前に割り当てます。そのため、JVMはラージ・ページ・メモリー領域を動的に拡張または縮小できません。この動作を行う場合は、-XX:UseTransparentHugePagesを参照してください。

詳細は、「ラージ・ページ」を参照してください。

-XX:+UseLargePages

ラージ・ページ・メモリーの使用を有効にします。デフォルトでは、このオプションは無効になっており、ラージ・ページ・メモリーは使用されません。

詳細は、「ラージ・ページ」を参照してください。

-XX:+UseMembar

スレッド状態の遷移時にメンバーの発行を有効にします。このオプションは、有効になっているARMサーバーを除くすべてのプラットフォーム上で、デフォルトでは無効になっています。(ARMサーバーでこのオプションを無効にしないことをお薦めします。)

-XX:+UsePerfData

perfdata機能を有効にします。このオプションはデフォルトで有効にされており、JVMのモニタリングとパフォーマンスのテストが許可されます。これを無効にすると、hsperfdata_useridディレクトリの作成が抑制されます。perfdata機能を無効にするには、-XX:-UsePerfDataを指定します。

-XX:+UseTransparentHugePages

Linuxでは、動的に拡張または縮小できるラージ・ページの使用を有効化してください。このオプションはデフォルトでは無効です。OSが他のページを移動してヒュージ・ページを作成するため、透過的ヒュージ・ページでパフォーマンスの問題が検出される場合があります。このオプションは試験的に使用できます。

詳細は、「ラージ・ページ」を参照してください。

-XX:+AllowUserSignalHandlers

アプリケーションがシグナル・ハンドラをインストールできるようにします。デフォルトでは、このオプションは無効になっており、アプリケーションはシグナル・ハンドラをインストールできません。

拡張JITコンパイラ・オプション

これらのオプションはJava HotSpot VMによって実行されるJust-in-Time (JIT)動的コンパイルを制御します。

-XX:+AggressiveOpts

将来のリリースでデフォルトになることが予想される積極的なパフォーマンス最適化機能の使用を有効にします。デフォルトでは、このオプションは無効になっており、試験的パフォーマンス機能は使用されません。

-XX:AllocateInstancePrefetchLines=lines

インスタンス割当てポインタの前にプリフェッチする行数を設定します。デフォルトでプリフェッチする行数は1に設定されています。

-XX:AllocateInstancePrefetchLines=1