jdk-24/test/jtreg-ext/requires/VMProps.java

888 lines
30 KiB
Java
Raw Normal View History

/*
* Copyright (c) 2016, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package requires;
import java.io.BufferedInputStream;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.File;
import java.nio.charset.Charset;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardOpenOption;
import java.time.Instant;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Properties;
import java.util.Set;
import java.util.concurrent.Callable;
import java.util.concurrent.TimeUnit;
import java.util.function.Predicate;
import java.util.function.Supplier;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
import java.util.stream.Stream;
import jdk.internal.foreign.CABI;
import jdk.test.whitebox.code.Compiler;
import jdk.test.whitebox.cpuinfo.CPUInfo;
import jdk.test.whitebox.gc.GC;
import jdk.test.whitebox.WhiteBox;
import jdk.test.lib.Platform;
import jdk.test.lib.Container;
/**
* The Class to be invoked by jtreg prior Test Suite execution to
* collect information about VM.
* Do not use any APIs that may not be available in all target VMs.
* Properties set by this Class will be available in the @requires expressions.
*/
public class VMProps implements Callable<Map<String, String>> {
// value known to jtreg as an indicator of error state
private static final String ERROR_STATE = "__ERROR__";
private static final String GC_PREFIX = "-XX:+Use";
private static final String GC_SUFFIX = "GC";
private static final WhiteBox WB = WhiteBox.getWhiteBox();
private static class SafeMap {
private final Map<String, String> map = new HashMap<>();
public void put(String key, Supplier<String> s) {
String value;
try {
value = s.get();
} catch (Throwable t) {
System.err.println("failed to get value for " + key);
t.printStackTrace(System.err);
value = ERROR_STATE + t;
}
map.put(key, value);
}
}
/**
* Collects information about VM properties.
* This method will be invoked by jtreg.
*
* @return Map of property-value pairs.
*/
@Override
public Map<String, String> call() {
log("Entering call()");
SafeMap map = new SafeMap();
map.put("vm.flavor", this::vmFlavor);
map.put("vm.compMode", this::vmCompMode);
map.put("vm.bits", this::vmBits);
map.put("vm.flightRecorder", this::vmFlightRecorder);
map.put("vm.simpleArch", this::vmArch);
map.put("vm.debug", this::vmDebug);
map.put("vm.jvmci", this::vmJvmci);
map.put("vm.jvmci.enabled", this::vmJvmciEnabled);
map.put("vm.emulatedClient", this::vmEmulatedClient);
// vm.hasSA is "true" if the VM contains the serviceability agent
// and jhsdb.
map.put("vm.hasSA", this::vmHasSA);
// vm.hasJFR is "true" if JFR is included in the build of the VM and
// so tests can be executed.
map.put("vm.hasJFR", this::vmHasJFR);
map.put("vm.hasDTrace", this::vmHasDTrace);
map.put("vm.jvmti", this::vmHasJVMTI);
map.put("vm.cpu.features", this::cpuFeatures);
map.put("vm.pageSize", this::vmPageSize);
map.put("vm.rtm.cpu", this::vmRTMCPU);
map.put("vm.rtm.compiler", this::vmRTMCompiler);
// vm.cds is true if the VM is compiled with cds support.
map.put("vm.cds", this::vmCDS);
map.put("vm.cds.custom.loaders", this::vmCDSForCustomLoaders);
map.put("vm.cds.supports.aot.class.linking", this::vmCDSSupportsAOTClassLinking);
map.put("vm.cds.write.archived.java.heap", this::vmCDSCanWriteArchivedJavaHeap);
map.put("vm.continuations", this::vmContinuations);
// vm.graal.enabled is true if Graal is used as JIT
map.put("vm.graal.enabled", this::isGraalEnabled);
// jdk.hasLibgraal is true if the libgraal shared library file is present
map.put("jdk.hasLibgraal", this::hasLibgraal);
map.put("vm.libgraal.jit", this::isLibgraalJIT);
map.put("vm.compiler1.enabled", this::isCompiler1Enabled);
map.put("vm.compiler2.enabled", this::isCompiler2Enabled);
map.put("container.support", this::containerSupport);
map.put("systemd.support", this::systemdSupport);
map.put("vm.musl", this::isMusl);
map.put("release.implementor", this::implementor);
map.put("jdk.containerized", this::jdkContainerized);
map.put("vm.flagless", this::isFlagless);
map.put("jdk.foreign.linker", this::jdkForeignLinker);
map.put("jlink.packagedModules", this::packagedModules);
vmGC(map); // vm.gc.X = true/false
vmGCforCDS(map); // may set vm.gc
vmOptFinalFlags(map);
dump(map.map);
log("Leaving call()");
return map.map;
}
/**
* Print a stack trace before returning error state;
* Used by the various helper functions which parse information from
* VM properties in the case where they don't find an expected property
* or a property doesn't conform to an expected format.
*
* @return {@link #ERROR_STATE}
*/
private String errorWithMessage(String message) {
new Exception(message).printStackTrace();
return ERROR_STATE + message;
}
/**
* @return vm.simpleArch value of "os.simpleArch" property of tested JDK.
*/
protected String vmArch() {
String arch = System.getProperty("os.arch");
if (arch.equals("x86_64") || arch.equals("amd64")) {
return "x64";
} else if (arch.contains("86")) {
return "x86";
} else {
return arch;
}
}
/**
* @return VM type value extracted from the "java.vm.name" property.
*/
protected String vmFlavor() {
// E.g. "Java HotSpot(TM) 64-Bit Server VM"
String vmName = System.getProperty("java.vm.name");
if (vmName == null) {
return errorWithMessage("Can't get 'java.vm.name' property");
}
Pattern startP = Pattern.compile(".* (\\S+) VM");
Matcher m = startP.matcher(vmName);
if (m.matches()) {
return m.group(1).toLowerCase();
}
return errorWithMessage("Can't get VM flavor from 'java.vm.name'");
}
/**
* @return VM compilation mode extracted from the "java.vm.info" property.
*/
protected String vmCompMode() {
// E.g. "mixed mode"
String vmInfo = System.getProperty("java.vm.info");
if (vmInfo == null) {
return errorWithMessage("Can't get 'java.vm.info' property");
}
vmInfo = vmInfo.toLowerCase();
if (vmInfo.contains("mixed mode")) {
return "Xmixed";
} else if (vmInfo.contains("compiled mode")) {
return "Xcomp";
} else if (vmInfo.contains("interpreted mode")) {
return "Xint";
} else {
return errorWithMessage("Can't get compilation mode from 'java.vm.info'");
}
}
/**
* @return VM bitness, the value of the "sun.arch.data.model" property.
*/
protected String vmBits() {
String dataModel = System.getProperty("sun.arch.data.model");
if (dataModel != null) {
return dataModel;
} else {
return errorWithMessage("Can't get 'sun.arch.data.model' property");
}
}
/**
* @return "true" if Flight Recorder is enabled, "false" if is disabled.
*/
protected String vmFlightRecorder() {
Boolean isFlightRecorder = WB.getBooleanVMFlag("FlightRecorder");
String startFROptions = WB.getStringVMFlag("StartFlightRecording");
if (isFlightRecorder != null && isFlightRecorder) {
return "true";
}
if (startFROptions != null && !startFROptions.isEmpty()) {
return "true";
}
return "false";
}
/**
* @return debug level value extracted from the "jdk.debug" property.
*/
protected String vmDebug() {
String debug = System.getProperty("jdk.debug");
if (debug != null) {
return "" + debug.contains("debug");
} else {
return errorWithMessage("Can't get 'jdk.debug' property");
}
}
/**
* @return true if VM supports JVMCI and false otherwise
*/
protected String vmJvmci() {
// builds with jvmci have this flag
if (WB.getBooleanVMFlag("EnableJVMCI") == null) {
return "false";
}
// Not all GCs have full JVMCI support
if (!WB.isJVMCISupportedByGC()) {
return "false";
}
// Interpreted mode cannot enable JVMCI
if (vmCompMode().equals("Xint")) {
return "false";
}
return "true";
}
/**
* @return true if JVMCI is enabled
*/
protected String vmJvmciEnabled() {
// builds with jvmci have this flag
if ("false".equals(vmJvmci())) {
return "false";
}
return "" + Compiler.isJVMCIEnabled();
}
/**
* @return true if VM runs in emulated-client mode and false otherwise.
*/
protected String vmEmulatedClient() {
String vmInfo = System.getProperty("java.vm.info");
if (vmInfo == null) {
return errorWithMessage("Can't get 'java.vm.info' property");
}
return "" + vmInfo.contains(" emulated-client");
}
/**
* @return supported CPU features
*/
protected String cpuFeatures() {
return CPUInfo.getFeatures().toString();
}
/**
* For all existing GC sets vm.gc.X property.
* Example vm.gc.G1=true means:
* VM supports G1
* User either set G1 explicitely (-XX:+UseG1GC) or did not set any GC
* G1 can be selected, i.e. it doesn't conflict with other VM flags
*
* @param map - property-value pairs
*/
protected void vmGC(SafeMap map) {
var isJVMCIEnabled = Compiler.isJVMCIEnabled();
Predicate<GC> vmGCProperty = (GC gc) -> (gc.isSupported()
&& (!isJVMCIEnabled || gc.isSupportedByJVMCICompiler())
&& (gc.isSelected() || GC.isSelectedErgonomically()));
for (GC gc: GC.values()) {
map.put("vm.gc." + gc.name(), () -> "" + vmGCProperty.test(gc));
}
}
/**
* "jtreg -vmoptions:-Dtest.cds.runtime.options=..." can be used to specify
* the GC type to be used when running with a CDS archive. Set "vm.gc" accordingly,
* so that tests that need to explicitly choose the GC type can be excluded
* with "@requires vm.gc == null".
*
* @param map - property-value pairs
*/
protected void vmGCforCDS(SafeMap map) {
if (!GC.isSelectedErgonomically()) {
// The GC has been explicitly specified on the command line, so
// jtreg will set the "vm.gc" property. Let's not interfere with it.
return;
}
String jtropts = System.getProperty("test.cds.runtime.options");
if (jtropts != null) {
for (String opt : jtropts.split(",")) {
if (opt.startsWith(GC_PREFIX) && opt.endsWith(GC_SUFFIX)) {
String gc = opt.substring(GC_PREFIX.length(), opt.length() - GC_SUFFIX.length());
map.put("vm.gc", () -> gc);
}
}
}
}
/**
* Selected final flag.
*
* @param map - property-value pairs
* @param flagName - flag name
*/
private void vmOptFinalFlag(SafeMap map, String flagName) {
map.put("vm.opt.final." + flagName,
() -> String.valueOf(WB.getBooleanVMFlag(flagName)));
}
/**
* Selected sets of final flags.
*
* @param map - property-value pairs
*/
protected void vmOptFinalFlags(SafeMap map) {
vmOptFinalFlag(map, "ClassUnloading");
vmOptFinalFlag(map, "ClassUnloadingWithConcurrentMark");
vmOptFinalFlag(map, "CriticalJNINatives");
vmOptFinalFlag(map, "EnableJVMCI");
vmOptFinalFlag(map, "EliminateAllocations");
vmOptFinalFlag(map, "UnlockExperimentalVMOptions");
vmOptFinalFlag(map, "UseCompressedOops");
vmOptFinalFlag(map, "UseLargePages");
vmOptFinalFlag(map, "UseVectorizedMismatchIntrinsic");
}
/**
* @return "true" if VM has a serviceability agent.
*/
protected String vmHasSA() {
return "" + Platform.hasSA();
}
/**
* @return "true" if the VM is compiled with Java Flight Recorder (JFR)
* support.
*/
protected String vmHasJFR() {
return "" + WB.isJFRIncluded();
}
/**
* @return "true" if the VM is compiled with JVMTI
*/
protected String vmHasJVMTI() {
return "" + WB.isJVMTIIncluded();
}
/**
* @return "true" if the VM is compiled with DTrace
*/
protected String vmHasDTrace() {
return "" + WB.isDTraceIncluded();
}
/**
* @return "true" if compiler in use supports RTM and "false" otherwise.
* Note: Lightweight locking does not support RTM (for now).
*/
protected String vmRTMCompiler() {
boolean isRTMCompiler = false;
if (Compiler.isC2Enabled() &&
(Platform.isX86() || Platform.isX64() || Platform.isPPC()) &&
is_LM_LIGHTWEIGHT().equals("false")) {
isRTMCompiler = true;
}
return "" + isRTMCompiler;
}
/**
* @return true if VM runs RTM supported CPU and false otherwise.
*/
protected String vmRTMCPU() {
return "" + CPUInfo.hasFeature("rtm");
}
/**
* Check for CDS support.
*
* @return true if CDS is supported by the VM to be tested.
*/
protected String vmCDS() {
return "" + WB.isCDSIncluded();
}
/**
* Check for CDS support for custom loaders.
*
* @return true if CDS provides support for customer loader in the VM to be tested.
*/
protected String vmCDSForCustomLoaders() {
return "" + ("true".equals(vmCDS()) && Platform.areCustomLoadersSupportedForCDS());
}
/**
* @return true if this VM can write Java heap objects into the CDS archive
*/
protected String vmCDSCanWriteArchivedJavaHeap() {
return "" + ("true".equals(vmCDS()) && WB.canWriteJavaHeapArchive()
&& isCDSRuntimeOptionsCompatible());
}
/**
* @return true if this VM can support the -XX:AOTClassLinking option
*/
protected String vmCDSSupportsAOTClassLinking() {
// Currently, the VM supports AOTClassLinking as long as it's able to write archived java heap.
return vmCDSCanWriteArchivedJavaHeap();
}
/**
* @return true if the VM options specified via the "test.cds.runtime.options"
* property is compatible with writing Java heap objects into the CDS archive
*/
protected boolean isCDSRuntimeOptionsCompatible() {
String jtropts = System.getProperty("test.cds.runtime.options");
if (jtropts == null) {
return true;
}
String CCP_DISABLED = "-XX:-UseCompressedClassPointers";
String G1GC_ENABLED = "-XX:+UseG1GC";
String PARALLELGC_ENABLED = "-XX:+UseParallelGC";
String SERIALGC_ENABLED = "-XX:+UseSerialGC";
for (String opt : jtropts.split(",")) {
if (opt.equals(CCP_DISABLED)) {
return false;
}
if (opt.startsWith(GC_PREFIX) && opt.endsWith(GC_SUFFIX) &&
!opt.equals(G1GC_ENABLED) && !opt.equals(PARALLELGC_ENABLED) && !opt.equals(SERIALGC_ENABLED)) {
return false;
}
}
return true;
}
/**
* @return "true" if this VM supports continuations.
*/
protected String vmContinuations() {
if (WB.getBooleanVMFlag("VMContinuations")) {
return "true";
} else {
return "false";
}
}
/**
* @return System page size in bytes.
*/
protected String vmPageSize() {
return "" + WB.getVMPageSize();
}
/**
* @return LockingMode.
*/
protected String vmLockingMode() {
return "" + WB.getIntVMFlag("LockingMode");
}
/**
* @return "true" if LockingMode == 0 (LM_MONITOR)
*/
protected String is_LM_MONITOR() {
return "" + vmLockingMode().equals("0");
}
/**
* @return "true" if LockingMode == 1 (LM_LEGACY)
*/
protected String is_LM_LEGACY() {
return "" + vmLockingMode().equals("1");
}
/**
* @return "true" if LockingMode == 2 (LM_LIGHTWEIGHT)
*/
protected String is_LM_LIGHTWEIGHT() {
return "" + vmLockingMode().equals("2");
}
/**
* Check if Graal is used as JIT compiler.
*
* @return true if Graal is used as JIT compiler.
*/
protected String isGraalEnabled() {
return "" + Compiler.isGraalEnabled();
}
/**
* Check if the libgraal shared library file is present.
*
* @return true if the libgraal shared library file is present.
*/
protected String hasLibgraal() {
return "" + WB.hasLibgraal();
}
/**
* Check if libgraal is used as JIT compiler.
*
* @return true if libgraal is used as JIT compiler.
*/
protected String isLibgraalJIT() {
return "" + Compiler.isLibgraalJIT();
}
/**
* Check if Compiler1 is present.
*
* @return true if Compiler1 is used as JIT compiler, either alone or as part of the tiered system.
*/
protected String isCompiler1Enabled() {
return "" + Compiler.isC1Enabled();
}
/**
* Check if Compiler2 is present.
*
* @return true if Compiler2 is used as JIT compiler, either alone or as part of the tiered system.
*/
protected String isCompiler2Enabled() {
return "" + Compiler.isC2Enabled();
}
/**
* A simple check for container support
*
* @return true if container is supported in a given environment
*/
protected String containerSupport() {
log("Entering containerSupport()");
boolean isSupported = false;
if (Platform.isLinux()) {
// currently container testing is only supported for Linux,
// on certain platforms
String arch = System.getProperty("os.arch");
if (Platform.isX64()) {
isSupported = true;
} else if (Platform.isAArch64()) {
isSupported = true;
} else if (Platform.isS390x()) {
isSupported = true;
} else if (arch.equals("ppc64le")) {
isSupported = true;
}
}
log("containerSupport(): platform check: isSupported = " + isSupported);
if (isSupported) {
try {
isSupported = checkProgramSupport("checkContainerSupport()", Container.ENGINE_COMMAND);
} catch (Exception e) {
isSupported = false;
}
}
log("containerSupport(): returning isSupported = " + isSupported);
return "" + isSupported;
}
/**
* A simple check for systemd support
*
* @return true if systemd is supported in a given environment
*/
protected String systemdSupport() {
log("Entering systemdSupport()");
boolean isSupported = Platform.isLinux();
if (isSupported) {
try {
isSupported = checkProgramSupport("checkSystemdSupport()", "systemd-run");
} catch (Exception e) {
isSupported = false;
}
}
log("systemdSupport(): returning isSupported = " + isSupported);
return "" + isSupported;
}
// Configures process builder to redirect process stdout and stderr to a file.
// Returns file names for stdout and stderr.
private Map<String, String> redirectOutputToLogFile(String msg, ProcessBuilder pb, String fileNameBase) {
Map<String, String> result = new HashMap<>();
String timeStamp = Instant.now().toString().replace(":", "-").replace(".", "-");
String stdoutFileName = String.format("./%s-stdout--%s.log", fileNameBase, timeStamp);
pb.redirectOutput(new File(stdoutFileName));
log(msg + ": child process stdout redirected to " + stdoutFileName);
result.put("stdout", stdoutFileName);
String stderrFileName = String.format("./%s-stderr--%s.log", fileNameBase, timeStamp);
pb.redirectError(new File(stderrFileName));
log(msg + ": child process stderr redirected to " + stderrFileName);
result.put("stderr", stderrFileName);
return result;
}
private void printLogfileContent(Map<String, String> logFileNames) {
logFileNames.entrySet().stream()
.forEach(entry ->
{
log("------------- " + entry.getKey());
try {
Files.lines(Path.of(entry.getValue()))
.forEach(line -> log(line));
} catch (IOException ie) {
log("Exception while reading file: " + ie);
}
log("-------------");
});
}
private boolean checkProgramSupport(String logString, String cmd) throws IOException, InterruptedException {
log(logString + ": entering");
ProcessBuilder pb = new ProcessBuilder("which", cmd);
Map<String, String> logFileNames =
redirectOutputToLogFile(logString + ": which " + cmd,
pb, "which-cmd");
Process p = pb.start();
p.waitFor(10, TimeUnit.SECONDS);
int exitValue = p.exitValue();
log(String.format("%s: exitValue = %s, pid = %s", logString, exitValue, p.pid()));
if (exitValue != 0) {
printLogfileContent(logFileNames);
}
return (exitValue == 0);
}
/**
* Checks musl libc.
*
* @return true if musl libc is used.
*/
protected String isMusl() {
return Boolean.toString(WB.getLibcName().contains("musl"));
}
private String implementor() {
try (InputStream in = new BufferedInputStream(new FileInputStream(
System.getProperty("java.home") + "/release"))) {
Properties properties = new Properties();
properties.load(in);
String implementorProperty = properties.getProperty("IMPLEMENTOR");
if (implementorProperty != null) {
return implementorProperty.replace("\"", "");
}
return errorWithMessage("Can't get 'IMPLEMENTOR' property from 'release' file");
} catch (IOException e) {
e.printStackTrace();
return errorWithMessage("Failed to read 'release' file " + e);
}
}
private String jdkContainerized() {
String isEnabled = System.getenv("TEST_JDK_CONTAINERIZED");
return "" + "true".equalsIgnoreCase(isEnabled);
}
private String packagedModules() {
// Some jlink tests require packaged modules being present (jmods).
// For a runtime linkable image build packaged modules aren't present
try {
Path jmodsDir = Path.of(System.getProperty("java.home"), "jmods");
if (jmodsDir.toFile().exists()) {
return Boolean.TRUE.toString();
} else {
return Boolean.FALSE.toString();
}
} catch (Throwable t) {
return Boolean.FALSE.toString();
}
}
/**
* Checks if we are in <i>almost</i> out-of-box configuration, i.e. the flags
* which JVM is started with don't affect its behavior "significantly".
* {@code TEST_VM_FLAGLESS} enviroment variable can be used to force this
* method to return true or false and allow or reject any flags.
*
* @return true if there are no JVM flags
*/
private String isFlagless() {
boolean result = true;
String flagless = System.getenv("TEST_VM_FLAGLESS");
if (flagless != null) {
return "" + "true".equalsIgnoreCase(flagless);
}
List<String> allFlags = allFlags().toList();
// check -XX flags
var ignoredXXFlags = Set.of(
// added by run-test framework
"MaxRAMPercentage",
// added by test environment
"CreateCoredumpOnCrash"
);
result &= allFlags.stream()
.filter(s -> s.startsWith("-XX:"))
// map to names:
// remove -XX:
.map(s -> s.substring(4))
// remove +/- from bool flags
.map(s -> s.charAt(0) == '+' || s.charAt(0) == '-' ? s.substring(1) : s)
// remove =.* from others
.map(s -> s.contains("=") ? s.substring(0, s.indexOf('=')) : s)
// skip known-to-be-there flags
.filter(s -> !ignoredXXFlags.contains(s))
.findAny()
.isEmpty();
// check -X flags
var ignoredXFlags = Set.of(
// default, yet still seen to be explicitly set
"mixed",
// -XmxmNNNm added by run-test framework for non-hotspot tests
"mx"
);
result &= allFlags.stream()
.filter(s -> s.startsWith("-X") && !s.startsWith("-XX:"))
// map to names:
// remove -X
.map(s -> s.substring(2))
// remove :.* from flags with values
.map(s -> s.contains(":") ? s.substring(0, s.indexOf(':')) : s)
// remove size like 4G, 768m which might be set for non-hotspot tests
.map(s -> s.replaceAll("(\\d+)[mMgGkK]", ""))
// skip known-to-be-there flags
.filter(s -> !ignoredXFlags.contains(s))
.findAny()
.isEmpty();
return "" + result;
}
private Stream<String> allFlags() {
return Stream.of((System.getProperty("test.vm.opts", "") + " " + System.getProperty("test.java.opts", "")).trim().split("\\s+"));
}
/*
* A string indicating the foreign linker that is currently being used. See jdk.internal.foreign.CABI
* for valid values.
*
* "FALLBACK" and "UNSUPPORTED" are special values. The former indicates the fallback linker is
* being used. The latter indicates an unsupported platform.
*/
private String jdkForeignLinker() {
return String.valueOf(CABI.current());
}
/**
* Dumps the map to the file if the file name is given as the property.
* This functionality could be helpful to know context in the real
* execution.
*
* @param map
*/
protected static void dump(Map<String, String> map) {
String dumpFileName = System.getProperty("vmprops.dump");
if (dumpFileName == null) {
return;
}
List<String> lines = new ArrayList<>();
map.forEach((k, v) -> lines.add(k + ":" + v));
Collections.sort(lines);
try {
Files.write(Paths.get(dumpFileName), lines,
StandardOpenOption.APPEND, StandardOpenOption.CREATE);
} catch (IOException e) {
throw new RuntimeException("Failed to dump properties into '"
+ dumpFileName + "'", e);
}
}
/**
* Log diagnostic message.
*
* @param msg
*/
protected static void log(String msg) {
// Always log to a file.
logToFile(msg);
// Also log to stderr; guarded by property to avoid excessive verbosity.
// By jtreg design stderr produced here will be visible
// in the output of a parent process. Note: stdout should not be used
// for logging as jtreg parses that output directly and only echoes it
// in the event of a failure.
if (Boolean.getBoolean("jtreg.log.vmprops")) {
System.err.println("VMProps: " + msg);
}
}
/**
* Log diagnostic message to a file.
*
* @param msg
*/
protected static void logToFile(String msg) {
String fileName = "./vmprops.log";
try {
Files.writeString(Paths.get(fileName), msg + "\n", Charset.forName("ISO-8859-1"),
StandardOpenOption.APPEND, StandardOpenOption.CREATE);
} catch (IOException e) {
throw new RuntimeException("Failed to log into '" + fileName + "'", e);
}
}
/**
* This method is for the testing purpose only.
*
* @param args
*/
public static void main(String args[]) {
Map<String, String> map = new VMProps().call();
map.forEach((k, v) -> System.out.println(k + ": '" + v + "'"));
}
}