C 環境変数とシステム・プロパティ

この付録では、Java HotSpot VMの問題をトラブルシューティングする際に役立つ可能性のある環境変数とシステム・プロパティについて説明します。

「バグ・レポートの提出」「環境変数」に、環境変数の収集に関する情報が含まれています。

この付録の内容は次のとおりです。

JAVA_TOOL_OPTIONS環境変数

多くの環境では、必要なコマンド行オプションを使用してアプリケーションを起動するコマンド行には容易にアクセスできません。

これは、埋込みVMを使用するアプリケーション(VMの起動にJava Native Interface (JNI)呼出しAPIを使用することを意味する)や、起動がスクリプト内で深く入れ子になっている場合に頻繁に起こります。このような環境では、JAVA_TOOL_OPTIONS環境変数がコマンド行の拡張に役立つ可能性があります。

ノート:

セキュリティ上の理由により、このオプションが無効になる場合があります。

この環境変数では、ツールの初期化(具体的には-agentlibまたは-javaagentオプションを使用したネイティブまたはJavaプログラミング言語エージェントの起動)を指定できます。

この変数は、診断の目的でコマンド行をほかのオプションを使って拡張するためにも使用できます。たとえば、-XX:OnErrorオプションを使用すると、致命的エラーが発生した場合に実行されるスクリプトまたはコマンドを指定できます。

この環境変数はJNI_CreateJavaVM関数の呼出し時に検査されるため、通常はランチャによって処理されるオプションを使用したコマンド行の拡張(-clientまたは-serverオプションを使ったVM選択など)には使用できません。

java.security.debugシステム・プロパティ

このシステム・プロパティは、Javaランタイムのセキュリティ・システムが、実行中にトレース・メッセージを出力するかどうかを制御します。

このオプションは、JDK内のセキュリティ・ライブラリに関する問題を診断する場合に役立つ可能性があります。

java.security.debugシステム・プロパティについてさらに学習するには、『Java Platform, Standard Editionセキュリティ開発者ガイド』セキュリティのトラブルシューティングに関する項を参照してください。