java

javaコマンドは、Javaアプリケーションを起動する場合に使用できます。

形式

Windows: javawコマンドは、javawにコンソール・ウィンドウが関連付けられていないこと以外は、javaコマンドと同じです。javawは、コマンド・プロンプト・ウィンドウを表示する必要がないときに使用します。ただし、javawランチャは、起動に失敗すると、エラー情報を示すダイアログ・ボックスを表示します。

クラス・ファイルを起動するには:

java [options] mainclass [args...]

JARファイルのメイン・クラスを起動するには:

java [options] -jar jarfile [args...]

モジュールのメイン・クラスを起動するには:

java [options] -m module[/mainclass] [args...]

または

java [options] --module module[/mainclass] [args...]

単一のソース・ファイル・プログラムを起動するには:

java [options] source-file [args...]

[options]

オプション: 空白で区切られたコマンド行オプションを指定します。使用可能なオプションの説明は、「javaのオプションの概要」を参照してください。

mainclass

起動するクラスの名前を指定します。classnameの後のコマンド行エントリは、メイン・メソッド用の引数です。

-jar jarfile

JARファイルにカプセル化されたプログラムを実行します。jarfile引数は、アプリケーションの開始位置として機能するpublic static void main(String[] args)メソッドによってクラスを定義する、Main-Class:classnameの形式の行を含むマニフェストのあるJARファイルの名前です。-jarを使用すると、指定したJARファイルがすべてのユーザー・クラスのソースになり、他のクラス・パスの設定は無視されます。JARファイルを使用している場合は、「jar」を参照してください。

-mまたは--module module[/mainclass]

モジュールのメイン・クラスを実行します。メイン・クラスはmainclassで指定され、この指定がない場合はmoduleの値が使用されます。つまり、mainclassは、モジュールでメイン・クラスが指定されていない場合に使用され、また指定されている場合はその値をオーバーライドします。

「javaの標準オプション」を参照してください。

source-file

単一のソース・ファイル・プログラムを起動する場合にのみ使用します。ソース・ファイル・モードを使用する場合に、メイン・クラスが含まれているソース・ファイルを指定します。「ソース・ファイル・モードで単一ファイルのソース・コードのプログラムを起動する方法」を参照してください

[args...]

オプション: mainclass、source-file、-jar jarfile、および-mまたは--module module/mainclassの後の引数は、メイン・クラスに引数として渡されます。

説明

javaコマンドはJavaアプリケーションを起動します。これは、Java Runtime Environment (JRE)を起動し、指定されたクラスをロードし、そのクラスのmain()メソッドを呼び出すことによって行われます。このメソッドは、publicおよびstaticとして宣言する必要があり、値を返すことができず、String配列をパラメータとして受け付ける必要があります。メソッド宣言の形式は次のとおりです。

public static void main(String[] args)

ソース・ファイル・モードでは、ソース・ファイル内に宣言されているクラスをjavaコマンドで起動できます。ソース・ファイル・モードの使用方法の詳細は、「ソース・ファイル・モードで単一ファイルのソース・コードのプログラムを起動する方法」を参照してください。

ノート:

JDK_JAVA_OPTIONSランチャ環境変数を使用して、その内容をjavaランチャの実際のコマンド行の先頭に追加できます。「JDK_JAVA_OPTIONSランチャ環境変数の使用方法」を参照してください。

デフォルトでは、javaコマンドのオプションでない最初の引数は呼び出されるクラスの完全修飾名です。-jarを指定した場合、その引数はアプリケーションのクラス・ファイルとリソース・ファイルを含むJARファイルの名前です。起動クラスはそのマニフェスト・ファイルのMain-Classマニフェスト・ヘッダーによって示される必要があります。

クラス・ファイル名またはJARファイル名の後にある引数は、main()メソッドに渡されます。

ソース・ファイル・モードで単一ファイルのソース・コードのプログラムを起動する方法

ソース・ファイル内に宣言されているクラスを起動するには、ソース・ファイル・モードでjavaランチャを実行します。ソース・ファイル・モードの開始は、javaコマンド行の2つの項目によって判断されます。

コマンド行の最初の項目(オプションやオプションの構成要素以外)。つまり、メイン・クラス名になりうるコマンド行の項目です。
--source versionオプション(存在する場合)。

クラス名から.java拡張子を持つ既存のファイルが特定されるか、--sourceオプションが指定されている場合は、ソース・ファイル・モードが選択されます。その後で、ソース・ファイルがコンパイルされて実行されます。--sourceオプションでは、ソース・コードのソースversion(またはN)を指定できます。これにより、使用可能なAPIが決まります。--source Nを設定した場合は、JDK Nで定義されたパブリックAPIのみを使用できます。

ノート:

Nの有効な値はリリースごとに異なり、新しい値が追加され、古い値は削除されています。サポートされなくなったN値を使用すると、エラー・メッセージが表示されます。このリリースでサポートされているNの値は、6、7、8、9、10および11です。

ファイルに.java拡張子が付いていない場合は、--sourceオプションを使用して、ソース・ファイル・モードを使用するようにjavaコマンドに指示する必要があります。--sourceオプションは、ソース・ファイルが実行対象の「スクリプト」であり、ソース・ファイル名がJavaソース・ファイルの通常の命名規則に準拠していない場合に使用します。

ソース・ファイル・モードでは、ソース・ファイルがメモリーにコンパイルされた場合と同様に、ソース・ファイル内で最初に検出されたクラスが実行されます。元のコマンド行でソース・ファイル名の後に引数が指定されていた場合、それらの引数はコンパイル済クラスの実行時に、そのコンパイル済クラスに渡されます。

たとえば、ファイル名がHelloWorld.javaで、hello.Worldという名前のクラスが含まれていた場合の、クラスを起動するソース・ファイル・モードのコマンドは次のようになります。

java HelloWorld.java

この例は、クラスは名前付きパッケージに配置でき、名前のないパッケージに配置する必要がないことを示しています。このようなソース・ファイル・モードの使用は、次の2つのコマンドを使用する方法と非公式には同じです(ここでは、hello.Worldがパッケージ内のクラスの名前です)。

javac -d memory HelloWorld.java
java -cp memory hello.World

ソース・ファイル・モードでの、その他のコマンド行オプションの処理手順:

ランチャがソース・ファイルの前に指定されているオプションをスキャンして、ソース・ファイルをコンパイルするための関連オプションを探します。

対象: --class-path、--module-path、--add-exports、--add-modules、--limit-modules、--patch-module、--upgrade-module-path、およびこれらのオプションの様々な形式。これには、--enable-previewオプションも含まれます(『JEP 12: Preview Language and VM Features』を参照)。
追加オプション(-processorや-Werrorなど)をコンパイラに渡すためのプロビジョニングは行われません。
コマンド行引数ファイル(@-files)を標準的な方法で使用できます。ファイル名の先頭に@文字を付けると、コマンド行で指定されたファイルに、呼び出されるVMまたはプログラムに対する引数の長いリストを配置することができます。

ソース・ファイル・モードでのコンパイルの手順:

コンパイル環境に関連するすべてのコマンド行オプションが考慮されます。
他のソース・ファイルは、ソース・パスが空の値に設定された場合と同様に、検出もコンパイルもされません。
-proc:noneが有効な場合と同様に、注釈処理は無効化されます。
--sourceオプションでバージョンが指定されている場合、その値は暗黙的な--releaseオプションの引数としてコンパイルで使用されます。これにより、コンパイラによって受け入れられるソース・バージョンと、ソース・ファイル内のコードで使用されるシステムAPIの両方が設定されます。
ソース・ファイルは、名前のないモジュールのコンテキストでコンパイルされます。
ソース・ファイルには最上位クラスが1つ以上含まれている必要があり、そのうちの最初のクラスが実行対象として扱われます。
コンパイラでは、JLS §7.6の最後に定義されているオプションの制約(つまり、名前付きパッケージ内の型は、その型名の後に.java拡張子が付いた名前のファイル内に存在する必要があるという制約)は強制されません。
ソース・ファイルにエラーがあると、適切なエラー・メッセージが標準エラー・ストリームに書き出された後、ランチャは非ゼロの終了コードで終了します。

ソース・ファイル・モードでの実行の手順:

実行されるクラスは、ソース・ファイル内で最初に検出された最上位クラスです。それには、標準のpublic static void main(String[])メソッドの宣言が含まれている必要があります。
コンパイル済クラスはカスタム・クラス・ローダーでロードされ、アプリケーション・クラス・ローダーに委譲します。これは、アプリケーション・クラス・パスに表示されているクラスはソース・ファイルに宣言されているどのクラスも参照できないことを意味します。
コンパイル済クラスは、--add-modules=ALL-DEFAULTが有効な場合と同様に、名前のないモジュールのコンテキストで実行されます。これは、コマンド行で指定されていた他の--add-moduleオプションに追加されるものです。
コマンド行でファイル名の後に引数が指定されている場合、それらの引数は標準のmainメソッドに明示的に渡されます。
実行されるクラスと同じ名前のクラスがアプリケーション・クラス・パスにある場合はエラーになります。

詳細は、『JEP 330: Launch Single-File Source-Code Programs』を参照してください。

JDK_JAVA_OPTIONSランチャ環境変数の使用方法

JDK_JAVA_OPTIONSは、その内容をコマンド行から解析されるオプションの先頭に追加します。JDK_JAVA_OPTIONS環境変数の内容は、空白文字(isspace()で指定)で区切られた引数のリストです。これらは、javaランチャに渡されるコマンド行引数の先頭に追加されます。環境変数のエンコーディング要件は、システムのjavaコマンド行と同じです。JDK_JAVA_OPTIONS環境変数の内容は、コマンド行に指定した場合と同じ方法で処理されます。

一重引用符(')または二重引用符(")を使用して、空白文字が含まれる引数を囲むことができます。開始引用符と対応する最初の終了引用符の間の内容すべてが引用符のペアを除いて保存されます。対応する引用符が見つからなかった場合、ランチャはエラー・メッセージを発行して停止します。@-filesは、コマンド行に指定するとサポートされます。ただし、@-files内と同様、ワイルドカードの使用はサポートされません。JDK_JAVA_OPTIONSの動作の誤用の可能性を緩和するために、メイン・クラスを指定するオプション(-jarなど)またはメイン・クラスを実行せずにjavaランチャを終了させるオプション(-hなど)は環境変数で指定できません。このようなオプションのいずれかが環境変数に指定されている場合、ランチャはエラー・メッセージを発行して停止します。JDK_JAVA_OPTIONSを設定すると、ランチャはメッセージをstderrにリマインダとして出力します。

例:

export JDK_JAVA_OPTIONS='-g @file1 -Dprop=value @file2 -Dws.prop="white spaces"' 
$ java -Xint @file3

これは次のコマンド行と同等です。

java -g @file1 -Dprop=value @file2 -Dws.prop="white spaces" -Xint @file3

javaのオプションの概要

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

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

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

javaの拡張ランタイム・オプション: Java HotSpot VMのランタイム動作を制御します。
javaの拡張JITコンパイラ・オプション: Java HotSpot VMによって実行されるJust-in-Time (JIT)動的コンパイルを制御します。
javaの拡張保守性オプション: システム情報の収集および詳細デバッグの実行を有効にします。
javaの拡張ガベージ・コレクション・オプション: Java HotSpotによってガベージ・コレクション(GC)がどのように実行されるかを制御します

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

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

次の各項では、廃止、非推奨および削除されたオプションについて説明します。

非推奨のjavaオプション: 使用でき、処理されます - 使用すると警告が発行されます。
廃止されたjavaオプション: 使用できますが、無視されます - 使用すると警告が発行されます。
削除されたjavaオプション: 削除されました - 使用するとエラーになります。

javaの標準オプション

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

ノート:

長形式のオプションの引数を指定するには、--name=valueまたは--name valueを使用できます。

-agentlib:libname[=options]

指定したネイティブ・エージェント・ライブラリをロードします。ライブラリ名の後に、ライブラリに固有のオプションのカンマ区切りのリストを使用できます。

Oracle Solaris、LinuxおよびmacOS: オプション-agentlib:fooが指定された場合、JVMはlibfoo.soという名前のライブラリを、LD_LIBRARY_PATHシステム変数(macOSではこの変数はDYLD_LIBRARY_PATH)で指定された場所にロードしようとします。
Windows: オプション-agentlib:fooが指定された場合、JVMはfoo.dllという名前のライブラリを、PATHシステム変数で指定された場所にロードしようとします。

次の例では、ava Debug Wire Protocol (JDWP)ライブラリをロードし、ポート8000でソケット接続をリスニングし、メイン・クラスのロード前にJVMを一時停止する方法を示しています。
```
-agentlib:jdwp=transport=dt_socket,server=y,address=8000
```

-agentpath:pathname[=options]

絶対パス名で指定されたネイティブ・エージェント・ライブラリをロードします。このオプションは-agentlibと同等ですが、ライブラリのフル・パスとファイル名を使用します。

--class-path classpath、-classpath classpathまたは-cp classpath

クラス・ファイルを検索するディレクトリ、JARアーカイブおよびZIPアーカイブのセミコロン(;)で区切られたリスト。

classpathを指定すると、CLASSPATH環境変数の設定がオーバーライドされます。classpathオプションを使用せず、classpathを設定していない場合、ユーザー・クラス・パスは現在のディレクトリ(.)になります。

便宜上、アスタリスク(*)のベース名を含むクラス・パス要素は、ディレクトリ内の拡張子.jarまたは.JARを持つすべてのファイルのリストを指定するのと同じと見なされます。Javaプログラムはこの2つの呼出しの違いを認識できません。たとえば、ディレクトリmydirにa.jarとb.JARが含まれている場合、クラス・パス要素mydir/*はA.jar:b.JARに展開されますが、JARファイルの順番は決まっていません。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての.jarファイルが含まれます。アスタリスク(*)からなるクラス・パス・エントリは、現在のディレクトリ内のすべてのjarファイルのリストに展開されます。CLASSPATH環境変数(定義されているとき)も同様に展開されます。クラス・パスのワイルドカード展開は、Java VMの起動前に実行されます。System.getenv("CLASSPATH")の呼出しなどによって環境を照会しないかぎり、Javaプログラムが展開されていないワイルドカードを認識することはありません。

--disable-@files

引数ファイル内を含めコマンド行の任意の場所で使用して、@filenameがそれ以上展開されないようにすることができます。このオプションは、オプションの後にある@-argfilesを展開できないようにします。

--enable-preview

クラスがリリースのプレビュー機能に依存できるようにします。

--module-path modulepath...または-p modulepath

ディレクトリのセミコロン(;)区切りリスト(各ディレクトリはモジュールのディレクトリです)。

--upgrade-module-path modulepath...

ディレクトリのセミコロン(;)区切りリスト(各ディレクトリは、ランタイム・イメージのアップグレード可能モジュールを置換するモジュールのディレクトリです)。

--add-modules module[,module...]

初期モジュールに加えて解決するルート・モジュールを指定します。また、moduleは、ALL-DEFAULT、ALL-SYSTEMおよびALL-MODULE-PATHのいずれかにすることもできます。

--list-modules

参照可能なモジュールをリストして終了します。

-d module nameまたは--describe-module module_name

指定されたモジュールの説明を表示して終了します。

--dry-run

VMを作成しますが、メイン・メソッドは実行しません。この--dry-runオプションは、モジュール・システム構成などのコマンド行オプションの検証に使用すると便利なことがあります。

--validate-modules

すべてのモジュールを検証して終了します。このオプションは、モジュール・パス上のモジュールで競合などのエラーを検出する場合に役立ちます。

-Dproperty=value

システム・プロパティの値を設定します。property変数はプロパティの名前を表す空白なしの文字列です。value変数はプロパティの値を表す文字列です。valueが空白のある文字列の場合、それを引用符で囲みます(-Dfoo="foo bar"など)。

-disableassertions[:[packagename]...|:classname]または-da[:[packagename]...|:classname]

アサーションを無効にします。デフォルトでは、すべてのパッケージとクラスでアサーションは無効になっています。引数なしで、-disableassertions (-da)は、すべてのパッケージとクラスでアサーションを無効にします。...で終わるpackagename引数を指定すると、スイッチは指定されたパッケージとサブパッケージ内でアサーションを無効にします。引数が...のみの場合、スイッチは現在の作業ディレクトリにある名前のないパッケージ内でアサーションを無効にします。classname引数を指定すると、スイッチは指定されたクラス内でアサーションを無効にします。

-disableassertions (-da)オプションは、すべてのクラス・ローダーおよびシステム・クラス(クラス・ローダーを持たない)に適用されます。このルールには1つの例外があります。引数なしでオプションが指定された場合、システム・クラスには適用されません。これにより、システム・クラスを除くすべてのクラスでアサーションを簡単に無効にできます。-disablesystemassertionsオプションは、すべてのシステム・クラスでアサーションを無効にできます。特定のパッケージまたはクラスでアサーションを明示的に有効にするには、-enableassertions (-ea)オプションを使用します。両方のオプションを同時に使用することはできません。たとえば、com.wombat.fruitbatパッケージ(およびすべてのサブパッケージ)内でアサーションを有効にし、com.wombat.fruitbat.Brickbatクラス内では無効にして、MyClassアプリケーションを実行するには、次のコマンドを使用します。

java -ea:com.wombat.fruitbat... -da:com.wombat.fruitbat.Brickbat MyClass

-disablesystemassertionsまたは-dsa

すべてのシステム・クラス内でアサーションを無効にします。

-enableassertions[:[packagename]...|:classname]または-ea[:[packagename]...|:classname]

アサーションを有効にします。デフォルトでは、すべてのパッケージとクラスでアサーションは無効になっています。引数なしで、-enableassertions (-ea)は、すべてのパッケージとクラスでアサーションを有効にします。...で終わるpackagename引数を指定すると、スイッチは指定されたパッケージとすべてのサブパッケージ内でアサーションを有効にします。引数が...のみの場合、スイッチは現在の作業ディレクトリにある名前のないパッケージ内でアサーションを有効にします。classname引数を指定すると、スイッチは指定されたクラス内でアサーションを有効にします。

-enableassertions (-ea)オプションは、すべてのクラス・ローダーおよびシステム・クラス(クラス・ローダーを持たない)に適用されます。このルールには1つの例外があります。引数なしでオプションが指定された場合、システム・クラスには適用されません。これにより、システム・クラスを除くすべてのクラスでアサーションを簡単に有効にできます。-enablesystemassertionsオプションは、すべてのシステム・クラスでアサーションを有効にするために個別のスイッチを提供します。特定のパッケージまたはクラスでアサーションを明示的に無効にするには、-disableassertions (-da)オプションを使用します。単一のコマンドにこれらのスイッチのインスタンスを複数指定した場合は、指定したスイッチが順番に処理されてからクラスがロードされます。たとえば、com.wombat.fruitbatパッケージ(およびすべてのサブパッケージ)内でのみアサーションを有効にし、com.wombat.fruitbat.Brickbatクラス内では無効にして、MyClassアプリケーションを実行するには、次のコマンドを使用します。

java -ea:com.wombat.fruitbat... -da:com.wombat.fruitbat.Brickbat MyClass

-enablesystemassertionsまたは-esa

すべてのシステム・クラス内でアサーションを有効にします。

-help、-hまたは-?

ヘルプ・メッセージをエラー・ストリームに出力します。

--help

ヘルプ・メッセージを出力ストリームに出力します。

-javaagent:jarpath[=options]

指定したJavaプログラミング言語エージェントをロードします。

--show-version

製品バージョンを出力ストリームに出力して続行します。

-showversion

製品バージョンをエラー・ストリームに出力して続行します。

--show-module-resolution

起動時にモジュール解決出力を表示します。

-splash:imagepath

imagepathで指定されたイメージを含むスプラッシュ画面を表示します。HiDPIスケールのイメージが自動的にサポートされて、使用可能な場合は使用されます。スケーリングされないイメージのファイル名(image.extなど)を常に引数として-splashオプションに渡す必要があります。指定された最も適切なスケーリング済のイメージが自動的に選択されます。

たとえば、アプリケーションの起動時に、imagesディレクトリのsplash.gifファイルを表示するには、次のオプションを使用します。

-splash:images/splash.gif

詳細は、SplashScreen APIのドキュメントを参照してください。

-verbose:class

ロードされる各クラスに関する情報を表示します。

-verbose:gc

各ガベージ・コレクション(GC)イベントに関する情報を表示します。

-verbose:jni

ネイティブ・メソッドおよびその他のJava Native Interface (JNI)アクティビティの使用に関する情報を表示します。

-verbose:module

使用中のモジュールに関する情報を表示します。

--version

製品バージョンをエラー・ストリームに出力して終了します。

-version

製品バージョンを出力ストリームに出力して終了します。

-X

追加オプションに関するヘルプをエラー・ストリームに出力します。

--help-extra

追加オプションに関するヘルプを出力ストリームに出力します。

@argfile

javaコマンドで使用される、先頭に@が付く引数ファイルを1つ以上指定します。クラスパスで必要となる.jarファイルのため、javaコマンド行が非常に長くなることは珍しいことではありません。@argfileオプションにより、シェル拡張の後かつ引数処理の前にランチャで引数ファイルの内容を展開できるようになることで、コマンド行の長さに関する制限を克服できます。引数ファイルの内容が展開されるのは、そうしないと、-Xdisable-@filesオプションが検出されるまでコマンド行に指定されるためです。

また、引数ファイルには、メイン・クラス名およびすべてのオプションを含めることもできます。引数ファイルにjavaコマンドに必要なオプションがすべて含まれている場合、コマンド行は単に次のようになります。

java @argfile

@argfileの使用方法の説明および例は、「javaのコマンド行引数ファイル」を参照してください。

javaの追加オプション

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

-Xbatch

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

-Xbootclasspath/a:directories|zip|JAR-files

デフォルトのブートストラップ・クラス・パスの最後に追加するディレクトリ、JARファイルおよびZIPアーカイブのリストを指定します。

Oracle Solaris、LinuxおよびmacOS: コロン(:)でこのリストのエントリを区切ります。

Windows: セミコロン(:)でこのリストのエントリを区切ります。

-Xcheck:jni

Java Native Interface (JNI)機能に対して追加チェックを行います。具体的には、それは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:option

JVM統合ロギング・フレームワークを有効にします。GCステータスをタイムスタンプとともにファイルに記録します。

-Xlog:option

Java仮想マシン(JVM)統合ロギング・フレームワークを使用したロギングを構成または有効にします。「JVM統合ロギングフレームワークを使用したロギングの有効化」を参照してください。

-Xmixed

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

-Xmn size

Young世代(ナーサリ)のヒープの初期および最大サイズ(バイト単位)を設定します。キロバイトを指定するには文字kまたはK、メガバイトを指定するには文字mまたはM、ギガバイトを指定するには文字gまたはGを付けます。ヒープのYoung世代領域は新しいオブジェクトに使用されます。この領域では他の領域よりも頻繁にGCが実行されます。Young世代のサイズが小さすぎる場合は、大量のマイナー・ガベージ・コレクションが実行されます。そのサイズが大きすぎる場合は、フル・ガベージ・コレクションのみが実行されますが、これは完了までに長時間かかることがあります。Young世代のサイズをヒープ・サイズ全体の25%から50%の間に維持することをお薦めします。次の例では、様々な単位を使用して、Young世代の初期および最大サイズを256Mバイトに設定する方法を示します。

-Xmn256m
-Xmn262144k
-Xmn268435456

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

-Xms size

ヒープの最小サイズおよび初期サイズ(バイト単位)を設定します。この値は、1024の倍数で、1Mバイトより大きくなければなりません。キロバイトを指定するには文字kまたはK、メガバイトを指定するには文字mまたはM、ギガバイトを指定するには文字gまたはGを付けます。次の例では、様々な単位を使用して、割り当てられたメモリーのサイズを6MBに設定する方法を示します。

-Xms6291456
-Xms6144k
-Xms6m

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

ノート:

-XX:InitalHeapSizeオプションを使用して、初期ヒープ・サイズを設定することもできます。コマンドラインで-Xmsの後に指定されている場合、初期ヒープ・サイズは-XX:InitalHeapSizeで指定された値に設定されます。

-Xmx size

メモリー割当てプールの最大サイズ(バイト単位)を指定します。この値は、1024の倍数で、2Mバイトより大きくなければなりません。キロバイトを指定するには文字kまたはK、メガバイトを指定するには文字mまたはM、ギガバイトを指定するには文字gまたはGを付けます。デフォルト値は、実行時にシステムの設定に基づいて選択されます。サーバー配備の場合、-Xmsと-Xmxが同一の値に設定されていることがよくあります。次の例では、様々な単位を使用して、割り当てられたメモリーの最大許容サイズを80Mバイトに設定する方法を示します。

-Xmx83886080
-Xmx81920k
-Xmx80m

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

-Xnoclassgc

クラスのガベージ・コレクション(GC)を無効にします。これによりいくらかのGC時間が節約され、アプリケーション実行時の割込みが短くなります。起動時に-Xnoclassgcを指定すると、GC時にアプリケーションのクラス・オブジェクトがそのままの状態にされ、常に有効であると見なされます。これにより、より多くのメモリーが永続的に占有されることになるため、慎重に使用しないと、メモリー不足の例外がスローされる可能性があります。

-Xrs

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

Oracle Solaris、LinuxおよびmacOS:
- JVMは、シグナルをキャッチすることによって、異常終了のためのシャットダウン・フックを実装します。JVMは、SIGHUP、SIGINT、およびSIGTERMを使用して、シャットダウン・フックの実行を開始します。
- JVMを埋め込んでいるアプリケーションがSIGINTやSIGTERMなどのシグナルを頻繁にトラップする必要があると、JVMのシグナル・ハンドラの処理に支障が出る可能性があります。-Xrsオプションを使用すると、この問題に対処できます。-Xrsを使用すると、SIGINT、SIGTERM、SIGHUPおよびSIGQUITに対するシグナル・マスクはJVMによって変更されず、これらのシグナルに対するシグナル・ハンドラはインストールされません。
Windows:
- JVMは、コンソール制御イベントを監視して予期しない終了のシャットダウン・フックを実装します。具体的には、JVMは、シャットダウン・フック処理を開始するコンソール制御ハンドラを登録し、CTRL_C_EVENT、CTRL_CLOSE_EVENT、CTRL_LOGOFF_EVENTおよびCTRL_SHUTDOWN_EVENTに対してTRUEを返します。
- JVMは、デバッグ用のスレッド・スタックをダンプする機能を実現するためにも、同様のメカニズムを使用します。JVMは、スレッド・ダンプを実行するためにCTRL_BREAK_EVENTを使用します。
- JVMがサービス(Webサーバー用のサーブレット・エンジンなど)として実行されている場合、CTRL_LOGOFF_EVENTを受け取ることはできますが、オペレーティング・システムが実際にはプロセスを終了しないため、シャットダウンを開始しないでください。このような干渉の可能性を避けるため、-Xrsオプションを使用できます。-Xrsオプションを使用すると、JVMは、コンソール制御ハンドラをインストールしないため、CTRL_C_EVENT、CTRL_CLOSE_EVENT、CTRL_LOGOFF_EVENTまたはCTRL_SHUTDOWN_EVENTの監視や処理を行わないことを意味します。

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

Oracle Solaris、LinuxおよびmacOS: SIGQUITによるスレッド・ダンプは使用できません。
Windows: [Ctrl]+[Break]によるスレッド・ダンプは使用できません。

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

-Xshare:mode

クラス・データ共有(CDS)モードを設定します。

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

auto: 可能な場合は、CDSを使用します。これはJava HotSpot 32-Bit Client VMのデフォルト値です。
on: CDSの使用が必須です。このオプションは、クラス・データ共有を使用できない場合、エラー・メッセージを出力して終了します。

ノート:

-Xshare:onはテスト目的にのみ使用されますが、オペレーティング・システムでアドレス空間配置のランダム化が使用されることにより、断続的なエラーが発生する可能性があります。このオプションは、本番環境では使用しないでください。
off: CDSを使用しないように指示します。

-XshowSettings

すべての設定を表示してから、続行します。

-XshowSettings:category

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

all: 設定のすべてのカテゴリを表示します。これはデフォルト値です。
locale: ロケールに関連する設定を表示します。
properties: システム・プロパティに関連する設定を表示します。
vm: JVMの設定を表示します。
system: Linux: ホスト・システムまたはコンテナ構成を表示して続行します。

-Xss size

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

Linux/x64 (64ビット): 1024KB
macOS (64ビット): 1024KB
Oracle Solaris/x64 (64ビット): 1024KB
Windows: デフォルト値は、仮想メモリーによって異なります。

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

-Xss1m
-Xss1024k
-Xss1048576

このオプションは-XX:ThreadStackSizeと似ています。

-Xverify

バイトコード・ベリファイアのモードを設定します。

--add-reads module=target-module(,target-module)*

モジュール宣言に関係なく、target-moduleを読み取るようにmoduleを更新します。target-moduleをALL-UNNAMEDにすると、名前のないモジュールをすべて読み取ることができます。

--add-exports module/package=target-module(,target-module)*

モジュール宣言に関係なく、packageをtarget-moduleにエクスポートするようにmoduleを更新します。target-moduleをALL-UNNAMEDにすると、名前のないモジュールをすべてエクスポートできます。

--add-opens module/package=target-module(,target-module)*

モジュール宣言に関係なく、packageをtarget-moduleに対してオープンするようにmoduleを更新します。

--illegal-access=parameter

実行時に指定する場合、--illegal-access=は操作モードを指定するキーワードparameterを取ります。

ノート:

このオプションは今後のリリースで削除される予定です。

permit: このモードでは、ランタイム・イメージの各モジュール内の各パッケージを、名前のないすべてのモジュールのコード(クラス・パスにあるコードなど)に対してオープンします(そのパッケージがJDK 8に入っていた場合)。これにより、静的アクセス(コンパイル済のバイトコードなどによる)と、プラットフォームの各種リフレクションAPIを介したディープ・リフレクション・アクセスの両方が使用可能になります。このようなパッケージに対して初めてリフレクション・アクセス操作を行うと、警告が発行されます。しかし、次の操作から警告は発行されません。この1回の警告に、以降の警告を有効にする方法が記載されています。このモードは、現在のJDKのデフォルトですが、将来のリリースでは変更される予定です。
warn: このモードは、permitと同じですが、不正なリフレクション・アクセス操作ごとに警告メッセージが発行されます。
debug: このモードは、warnと同じですが、不正なリフレクション・アクセス操作ごとに警告メッセージとスタック・トレースの両方が発行されます。
deny: このモードは、不正アクセス操作をすべて無効にしますが、--add-opensなどの他のコマンド行オプションによって有効にされている操作は除きます。このモードは、将来のリリースでデフォルトとなる予定です。

デフォルト・モード--illegal-access=permitは、JDK内部APIに少なくとも1回はリフレクション・アクセスを実行するクラス・パス上のコードをユーザーに認識させることを目的としています。このようなアクセスをすべて認識するには、warnモードまたはdebugモードを使用できます。不正アクセスを必要とするクラス・パス上のライブラリまたはフレームワークそれぞれに対して、2つの選択肢があります。

コンポーネントのメンテナンス管理者がJDK内部APIを使用しなくなった修正済バージョンをすでにリリースしている場合は、そのバージョンへのアップグレードを検討できます。
引き続きコンポーネントの修正が必要な場合は、メンテナンス管理者に連絡して、JDK内部APIの使用部分をエクスポートされた正式のAPIで置換するように依頼できます。

不正アクセスを必要とするコンポーネントを引き続き使用する必要がある場合は、1つ以上の--add-opensオプションを使用してアクセスする必要がある内部パッケージのみをオープンすることで、警告メッセージが発行されないようにできます。

アプリケーションが将来のバージョンのJDKに対応できるかどうかを確認するには、必要な--add-opensオプションとともに--illegal-access=denyを指定して実行します。残りの不正アクセス・エラーは、コンパイル済のコードからJDK内部APIへの静的リファレンスによる可能性が最も高いです。--jdk-internalsオプションを指定してjdepsツールを実行すると、それらを特定できます。パフォーマンス上の理由から、現在のJDKでは、不正な静的アクセス操作に関しての警告を発行しません。

--limit-modules module[,module...]

参照可能なモジュールの領域の制限を指定します。

--patch-module module=file(;file)*

JARファイルまたはディレクトリ内のクラスおよびリソースでモジュールをオーバーライドまたは拡張します。

--disable-@files

--source version

ソース・ファイル・モードのソースのバージョンを設定します。

macOSの追加オプション

次の追加オプションは、macO専用です。

-XstartOnFirstThread: 最初の(AppKit)スレッドでmain()メソッドを実行します。
-Xdock:name=application_name: ドックに表示されるデフォルトのアプリケーション名をオーバーライドします。
-Xdock:icon=path_to_icon_file: ドックに表示されるデフォルトのアイコンをオーバーライドします。

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

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

-XX:ActiveProcessorCount=x

ガベージ・コレクションやForkJoinPoolなどの様々な操作に使用するスレッド・プールのサイズを計算するために、VMが使用するCPUの数をオーバーライドします。

通常、VMはオペレーティング・システムから使用可能なプロセッサの数を決定します。このフラグは、Dockerコンテナ内で複数のJavaプロセスを実行するときに、CPUリソースをパーティション化するために役立ちます。UseContainerSupportが有効になっていない場合でも、このフラグが使用されます。コンテナのサポートの有効化および無効化の説明は、-XX:-UseContainerSupportを参照してください。

--XX:AllocateHeapAt=path

ファイル・システムへのパスを取得し、メモリー・マッピングを使用してメモリー・デバイスにオブジェクト・ヒープを割り当てます。このオプションを使用すると、ユーザーが指定したNV-DIMMなどの代替メモリー・デバイスに、HotSpot VMがJavaオブジェクト・ヒープを割り当てられるようになります。

DRAMと同じセマンティクス(アトミック操作のセマンティクスを含む)を持つ代替メモリー・デバイスを、既存のアプリケーション・コードを変更せずに、オブジェクト・ヒープ用のDRAMのかわりに使用できます。他のメモリー構造体(コード・ヒープ、メタスペース、スレッド・スタックなど)はすべて、引き続きDRAM内に残ります。

一部のオペレーティング・システムでは、ファイル・システムを使用して非DRAMメモリーを公開します。これらのファイル・システムのメモリー・マップ・ファイルは、ページ・キャッシュをバイパスして、デバイスの物理メモリーに対する仮想メモリーのダイレクト・マッピングを提供します。既存のヒープ関連フラグ(-Xmx、-Xmsなど)およびガベージ・コレクション関連フラグは、引き続き以前と同様に動作します。

-XX:-CompactStrings

コンパクト文字列機能を無効にします。デフォルトでは、このオプションが有効になっています。このオプションが有効になっていると、シングルバイト文字のみが含まれるJava文字列は、ISO-8859-1またはLatin-1エンコーディングを使用して1文字当たり1バイトの文字列として内部的に表され、格納されます。これにより、シングルバイト文字列のみが含まれる文字列に必要な容量が50%削減されます。1つ以上のマルチバイト文字が含まれるJava文字列の場合、これらはUTF-16エンコーディングを使用して1文字当たり2バイトとして表され、格納されます。コンパクト文字列機能を無効にすると、すべてのJava文字列に対してUTF-16エンコーディングを内部表現として使用することが強制されます。

コンパクト文字列を無効にした方が有益な場合は、次のとおりです。

アプリケーションで圧倒的にマルチバイト文字の文字列を割り当てることがわかっている場合
Java SE 8からJava SE 9以降への移行でパフォーマンス低下が観測され、コンパクト文字列がその低下を招いていることを分析が示している予期しないイベント

いずれのシナリオでも、コンパクト文字列を無効にすることが理にかなっています。

-XX:CompilerDirectivesFile=file

プログラムの起動時にディレクティブをファイルからディレクティブのスタックに追加します。コンパイラ・ディレクティブおよびコマンド行に関する項を参照してください。

-XX:CompilerDirectivesPrint

プログラムの起動時または新しいディレクティブの追加時にディレクティブのスタックを出力します。

-XX:ConcGCThreads=n

パラレル・マーキング・スレッド数を設定します。nをパラレル・ガベージ・コレクション・スレッド(ParallelGCThreads)の数の約1/4に設定します。

-XX:+DisableAttachMechanism

ツールをJVMに接続するメカニズムを無効にします。デフォルトでは、このオプションは無効になっており、アタッチ・メカニズムは有効になっているため、jcmd、jstack、jmap、jinfoなどの診断ツールおよびトラブルシューティング・ツールを使用できます。

ノート:

JDKに同梱されているjcmd、jinfo、jmap、jstackなどのツールは、あるJDKバージョンのツールを使用して別のJDKバージョンをトラブルシューティングした場合にはサポートされません。

-XX:ErrorFile=filename

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

次の例では、デフォルトのログ・ファイルを設定する方法を示します(プロセスの識別子は%pで指定されることに注意してください)。

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

Oracle Solaris、LinuxおよびmacOS: 次の例は、エラー・ログを/var/log/java/java_error.logに設定する方法を示しています。
```
-XX:ErrorFile=/var/log/java/java_error.log
```
Windows: 次の例は、エラー・ログ・ファイルをC:/log/java/java_error.logに設定する方法を示しています。
```
-XX:ErrorFile=C:/log/java/java_error.log
```

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

Oracle Solaris、LinuxおよびmacOS: 一時ディレクトリは/tmpです。
Windows: 一時ディレクトリは環境変数TMPの値で指定されます。この環境変数が指定されていないと、環境変数TEMPの値が使用されます。

-XX:+ExtensiveErrorReports

ErrorFileにより広範なエラー情報のレポートを作成できます。このオプションは、最大情報が必要な環境で有効にできます。結果のログが非常に大きい場合、または機密とみなされる可能性がある情報が含まれる場合(あるいはその両方)でも有効です。情報は、リリースごと、異なるプラットフォーム間で異なる場合があります。デフォルトではこのオプションは無効になっています。

-XX:+FailOverToOldVerifier

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

-XX:+FlightRecorder

アプリケーション実行時のJava Flight Recorder (JFR)の使用を有効にします。

ノート:

-XX:+FlightRecorderオプションは、JFRを使用するのに不要になりました。この変更は、JDK 8u40で行われました。

-XX:FlightRecorderOptions=parameter=value

JFRの動作を制御するパラメータを設定します。

使用可能なJFR parameter=valueエントリは次のとおりです。

allow_threadbuffers_to_disk={true|false}: バッファ・スレッドがブロックされた場合にスレッド・バッファをディスクに直接書き込むかどうかを指定します。デフォルトでは、このパラメータは無効になっています。
globalbuffersize=size: データ保存に使用される主メモリーの合計量を指定します。デフォルト値はmemorysizeに指定された値に基づきます。memorysizeパラメータを変更して、グローバル・バッファのサイズを変更します。
maxchunksize=size: 記録のデータ・チャンクの最大サイズ(バイト単位)を指定します。mまたはMを追加してサイズをMB単位で指定するか、gまたはGを追加してサイズをGB単位で指定します。デフォルトでは、データ・チャンクの最大サイズは12Mバイトに設定されます。最小許容値は1 MBです。
memorysize=size: 使用する必要があるバッファ・メモリーの容量を決定し、指定されたサイズに基づいてglobalbuffersizeパラメータおよびnumglobalbuffersパラメータを設定します。mまたはMを追加してサイズをMB単位で指定するか、gまたはGを追加してサイズをGB単位で指定します。デフォルトでは、メモリー・サイズは10 MBに設定されます。
numglobalbuffers: 使用するグローバル・バッファの数を指定します。デフォルト値は指定されたメモリー・サイズに基づきます。memorysizeパラメータを変更して、グローバル・バッファの数を変更します。
old-object-queue-size=number-of-objects: 追跡する古いオブジェクトの最大数。デフォルトでは、オブジェクトの数は256に設定されます。
repository=path: 一時ディスク・ストレージのリポジトリ(ディレクトリ)を指定します。デフォルトでは、システムの一時ディレクトリが使用されます。
retransform={true|false}: JVMTIを使用してイベント・クラスを再変換するかどうかを指定します。falseの場合、イベント・クラスのロード時にインストゥルメンテーションが追加されます。デフォルトで、このパラメータは有効です。
samplethreads={true|false}: スレッド・サンプリングを有効にするかどうかを指定します。スレッド・サンプリングは、このパラメータとともにサンプリング・イベントが有効にされている場合にのみ行われます。デフォルトで、このパラメータは有効です。
stackdepth=depth: スタック・トレースのスタックの深さ。デフォルトでは、この深さは64回のメソッド呼出しに設定されます。最大値は2048です。64よりも大きい値を指定すると、大量のオーバーヘッドが発生し、パフォーマンスが低下する可能性があります。
threadbuffersize=size: スレッドごとのローカル・バッファ・サイズ(バイト単位)を指定します。デフォルトでは、ローカル・バッファ・サイズは8 KBに設定されます。このパラメータをオーバーライドするとパフォーマンスが低下する可能性があるため、お薦めしません。

複数のパラメータの値を指定するには、それらをコロンで区切ります。

-XX:InitiatingHeapOccupancyPercent=n

マーキング・サイクルを開始するJavaヒープ占有率のしきい値を設定します。デフォルトの占有率はJavaヒープ全体の45%です。

-XX:LargePageSizeInBytes=size

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

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

-XX:LargePageSizeInBytes=4m

-XX:MaxDirectMemorySize=size

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

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

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

-XX:-MaxFDLimit

オープン・ファイル・ディスクリプタ数のソフト制限をハード制限に設定する試みを無効にします。デフォルトでは、このオプションはすべてのプラットフォームで有効になっていますが、Windowsでは無視されます。Mac OSでこのオプションを無効にする必要があるのは、実際のシステムの最大値を下回る最大値10240が課せられる場合のみです。

-XX:MaxGCPauseMillis=ms

望ましい最大一時停止時間の目標値を設定します。デフォルト値は200ミリ秒です。指定された値はヒープ・サイズには適応されません。

-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

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

Oracle Solaris、LinuxおよびmacOS: 次の例は、-XX:OnErrorオプションを使用して、回復不能なエラーが発生した場合にgcoreコマンドを実行してコア・イメージを作成し、デバッガを起動してプロセスに接続する方法を示しています(%pは現在のプロセスを指定します)。
```
-XX:OnError="gcore %p;dbx - %p"
```
Windows: 次の例は、-XX:OnErrorオプションを使用して、回復不能なエラーが発生した場合にuserdump.exeユーティリティを実行し、クラッシュ・ダンプを取得する方法を示しています(%pは現在のプロセスを指定します)。この例では、userdump.exeユーティリティのパスがPATH環境変数に指定されていることを前提としています。
```
-XX:OnError="userdump.exe %p"
```

-XX:OnOutOfMemoryError=string

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

-XX:ParallelGCThreads=n

STWワーカー・スレッドの値を設定します。nの値は論理プロセッサ数に設定します。nの値は論理プロセッサ数と同じです(最大値は8)。論理プロセッサが9個以上ある場合は、nの値を論理プロセッサ数の約5/8に設定します。これはほとんどのケースで機能しますが、nの値が論理プロセッサ数の約5/16になるような大規模なSPARCは例外です。

-XX:+PerfDataSaveToFile

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

jstat -class file:///path/hsperfdata_pid

jstat -gc file:///path/hsperfdata_pid

-XX:+PrintCommandLineFlags

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

-XX:+PreserveFramePointer

汎用レジスタとしてRBPレジスタを使用するか(-XX:-PreserveFramePointer)、RBPレジスタを使用して現在実行されているメソッドのフレーム・ポインタを保持するか(-XX:+PreserveFramePointer)を選択します。フレーム・ポインタが使用可能な場合は、外部プロファイリング・ツール(Linux perfなど)でより正確なスタック・トレースを構成できます。

-XX:+PrintNMTStatistics

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

-XX:+RelaxAccessControlCheck

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

-XX:SharedArchiveFile=path

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

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

-XX:SharedArchiveConfigFile=shared_config_file

アーカイブ・ファイルに追加されるその他の共有データを指定します。

-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記録を開始します。このオプションは、実行時に記録を開始するJFR.start診断コマンドと同等です。JFR記録を開始するときに、次のparameter=valueエントリを設定できます。

delay=time

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

disk={true|false}

一時データをディスク・リポジトリに書き込むかどうかを指定します。デフォルトでは、このパラメータはfalseに設定されています。有効にするには、パラメータをtrueに設定します。

dumponexit={true|false}

JVMが停止するときに、実行中の記録をダンプするかどうかを指定します。これが有効でfilenameが入力されていない場合、記録はプロセスが開始されたディレクトリ内のファイルに書き込まれます。ファイル名は、プロセスID、記録IDおよび現在のタイムスタンプを含む(hotspot-pid-47496-id-1-2018_01_25_19_10_41.jfrのような)システム生成名になります。デフォルトでは、このパラメータは無効になっています。

duration=time

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

filename=path

記録が停止するときに、記録が書き込まれるファイルのパスと名前を指定します。たとえば:

recording.jfr
/home/user/recordings/recording.jfr
c:\recordings\recording.jfr

name=identifier

記録の名前と識別子の両方を取ります。

maxage=time

記録用保持するディスク・データの最大保持期間を指定します。このパラメータは、diskパラメータがtrueに設定されている場合にのみ有効です。時間を秒で指定する場合はs、分の場合はm、時間の場合はh、日の場合はdを追加します。たとえば、30sと指定すると、30秒を意味します。デフォルトでは、最大期間は制限されず、このパラメータは0sに設定されます。

maxsize=size

記録用に保持するディスク・データの最大サイズ(バイト単位)を指定します。このパラメータは、diskパラメータがtrueに設定されている場合にのみ有効です。値は、-XX:FlightRecorderOptionsで設定したmaxchunksizeパラメータの値以上にする必要があります。mまたはMを追加してサイズをMB単位で指定するか、gまたはGを追加してサイズをGB単位で指定します。デフォルトでは、ディスク・データの最大サイズは制限されず、このパラメータは0に設定されます。

path-to-gc-roots={true|false}

記録の終了時にガベージ・コレクション(GC)のルートへのパスを収集するかどうかを指定します。デフォルトでは、このパラメータは無効になっています。

GCルートへのパスはメモリー・リークを探すのに役立ちますが、この収集には時間がかかります。メモリー・リークが疑われるアプリケーションの記録を開始する場合にのみ、このオプションを有効にします。settingsパラメータがprofileに設定されている場合、リークの可能性があるオブジェクトが割り当てられている場所からのスタック・トレースが、収集情報に含まれます。

settings=path

イベント設定ファイル(種類はJFC)のパスと名前を指定します。デフォルトでは、JRE_HOME/lib/jfrにあるdefault.jfcファイルが使用されます。このデフォルト設定ファイルは低いオーバーヘッドで定義済の情報セットを収集するため、パフォーマンスに及ぼす影響は最小となり、継続的に実行される記録で使用できます。

第2設定ファイル(profile.jfc)もあり、これはデフォルト構成よりも多くのデータを提供しますが、オーバーヘッドもパフォーマンスに与える影響も大きくなる可能性があります。より多くの情報が必要な場合に、この構成を短期間で使用します。

複数のパラメータの値を指定するには、それらをコロンで区切ります。

-XX:ThreadStackSize=size

Javaスレッド・スタック・サイズ(KB単位)を設定します。kなどのスケール接尾辞を使用すると、-XX:ThreadStackSize=1kがJavaスレッド・スタック・サイズを1024*1024バイトまたは1MBに設定するように、KB値のスケールとなります。デフォルト値はプラットフォームによって異なります。

Linux: 1024KB
macOS: 1024KB
Oracle Solaris: 1024KB
Windows: デフォルト値は、仮想メモリーによって異なります。

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

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

このオプションは-Xssと似ています。

-XX:-UseBiasedLocking

バイアス・ロックの使用を無効にします。大量の非競合同期を行うアプリケーションでは、このフラグを有効にすることで大幅な高速化が実現されることがありますが、特定のパターンのロックを行うアプリケーションでは速度が低下することがあります

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

-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を使用して無効にできます。

このサポートに関連する問題を診断する際に、統合ロギングが役立ちます。

-Xlog:os+container=traceを使用して、コンテナ情報の最大ログを取得します。統合ロギングの使用の説明は、JVM統合ロギングフレームワークを使用したロギングの有効化を参照してください。

XX:+UseGCLogRotation

大きなログ・ファイルを処理します。このオプションは、-Xloggc:filenameと一緒に使用する必要があります。

-XX:NumberOfGClogFiles=number_of_files

大きなログ・ファイルを処理します。number_of_filesは、1以上にする必要があります。デフォルトは1です。

-XX:GCLogFileSize=number

大きなログ・ファイルを処理します。numberの形式は、numberMまたはnumberKのいずれかです。デフォルトは512Kに設定されています。

-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

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

-XX:VMOptionsFile=filename

ユーザーがVMオプションをファイルに指定できるようにします。たとえば、java -XX:VMOptionsFile=/var/my_vm_options HelloWorld。

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

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

-XX:AllocateInstancePrefetchLines=lines

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

-XX:AllocateInstancePrefetchLines=1