7.12.2 -XX:ExplicitMemoryExcludeClassListFile
-XX:ExplicitMemoryExcludeClassListFile specifies the file path for the explicit memory management functionality exclusion configuration file.
Description
-XX:ExplicitMemoryExcludeClassListFile specifies the file path for the explicit memory management functionality exclusion configuration file that is used by the functionality that excludes classes from the explicit memory management functionality. The explicit memory management functionality is not applied to the classes specified in this file.
When Java VM starts, the file whose path is specified for this option is loaded as the explicit memory management functionality exclusion configuration file. If you omit this option or specify a null character for this option, the file in the default file path is loaded as the explicit memory management functionality exclusion configuration file.
- Prerequisite options
-
-
-XX:+HitachiUseExplicitMemory
-
-XX:+ExplicitMemoryUseExcludeClass
-
- Related options
-
-
-XX:ExplicitMemoryFullGCPolicy
-
-XX:+HitachiAutoExplicitMemory
-
-XX:ExplicitMemoryNotExcludeClassListFile
-
Syntax
-XX:ExplicitMemoryExcludeClassListFile:character_string
Specifiable values
- character_string
-
Type: String
Specify a relative path from the current directory for the Java VM process or an absolute path. You can specify a path that includes directory names.
Note that you can specify only one file as the explicit memory management functionality exclusion configuration file. In addition, use ASCII code as the character encoding for the file.
Default value
- If the definition item is omitted:
-
-XX:ExplicitMemoryExcludeClassListFile:<null character>
The path of the file to be loaded when <null character> is specified is as follows:
installation_directory_for_JDK/usrconf/exmemexcludeclass.cfg
Notes
-
If the specified file cannot be opened or loaded, a warning message is output to the event log for the explicit memory management functionality, and then the configuration file in the default path is loaded. If the file in the default path cannot be opened or loaded, the functionality that excludes classes from the explicit memory management functionality does not become enabled.
-
If the format of the specified file is incorrect, a warning message is output to the event log for the explicit memory management functionality, and then syntax analysis processing continues from the next line.
-
If the same class name is specified in both the explicit memory management functionality exclusion configuration file and the configuration file that disables exclusions from the explicit memory management functionality, the configuration file that disables exclusions from the explicit memory management functionality has priority. In such cases, the functionality that excludes classes from the explicit memory management functionality is disabled for those classes.