1 /*
  2  * Copyright (c) 2016, 2024, Oracle and/or its affiliates. All rights reserved.
  3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  4  *
  5  * This code is free software; you can redistribute it and/or modify it
  6  * under the terms of the GNU General Public License version 2 only, as
  7  * published by the Free Software Foundation.
  8  *
  9  * This code is distributed in the hope that it will be useful, but WITHOUT
 10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 12  * version 2 for more details (a copy is included in the LICENSE file that
 13  * accompanied this code).
 14  *
 15  * You should have received a copy of the GNU General Public License version
 16  * 2 along with this work; if not, write to the Free Software Foundation,
 17  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 18  *
 19  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 20  * or visit www.oracle.com if you need additional information or have any
 21  * questions.
 22  */
 23 
 24 package requires;
 25 
 26 import java.io.BufferedInputStream;
 27 import java.io.FileInputStream;
 28 import java.io.IOException;
 29 import java.io.InputStream;
 30 import java.io.File;
 31 import java.nio.charset.Charset;
 32 import java.nio.file.Files;
 33 import java.nio.file.Path;
 34 import java.nio.file.Paths;
 35 import java.nio.file.StandardOpenOption;
 36 import java.time.Instant;
 37 import java.util.ArrayList;
 38 import java.util.Collections;
 39 import java.util.HashMap;
 40 import java.util.List;
 41 import java.util.Map;
 42 import java.util.Properties;
 43 import java.util.Set;
 44 import java.util.concurrent.Callable;
 45 import java.util.concurrent.TimeUnit;
 46 import java.util.function.Predicate;
 47 import java.util.function.Supplier;
 48 import java.util.regex.Matcher;
 49 import java.util.regex.Pattern;
 50 import java.util.stream.Stream;
 51 
 52 import jdk.internal.foreign.CABI;
 53 import jdk.test.whitebox.code.Compiler;
 54 import jdk.test.whitebox.cpuinfo.CPUInfo;
 55 import jdk.test.whitebox.gc.GC;
 56 import jdk.test.whitebox.WhiteBox;
 57 import jdk.test.lib.Platform;
 58 import jdk.test.lib.Container;
 59 
 60 /**
 61  * The Class to be invoked by jtreg prior Test Suite execution to
 62  * collect information about VM.
 63  * Do not use any APIs that may not be available in all target VMs.
 64  * Properties set by this Class will be available in the @requires expressions.
 65  */
 66 public class VMProps implements Callable<Map<String, String>> {
 67     // value known to jtreg as an indicator of error state
 68     private static final String ERROR_STATE = "__ERROR__";
 69 
 70     private static final String GC_PREFIX = "-XX:+Use";
 71     private static final String GC_SUFFIX = "GC";
 72 
 73     private static final WhiteBox WB = WhiteBox.getWhiteBox();
 74 
 75     private static class SafeMap {
 76         private final Map<String, String> map = new HashMap<>();
 77 
 78         public void put(String key, Supplier<String> s) {
 79             String value;
 80             try {
 81                 value = s.get();
 82             } catch (Throwable t) {
 83                 System.err.println("failed to get value for " + key);
 84                 t.printStackTrace(System.err);
 85                 value = ERROR_STATE + t;
 86             }
 87             map.put(key, value);
 88         }
 89     }
 90 
 91     /**
 92      * Collects information about VM properties.
 93      * This method will be invoked by jtreg.
 94      *
 95      * @return Map of property-value pairs.
 96      */
 97     @Override
 98     public Map<String, String> call() {
 99         log("Entering call()");
100         SafeMap map = new SafeMap();
101         map.put("vm.flavor", this::vmFlavor);
102         map.put("vm.compMode", this::vmCompMode);
103         map.put("vm.bits", this::vmBits);
104         map.put("vm.flightRecorder", this::vmFlightRecorder);
105         map.put("vm.simpleArch", this::vmArch);
106         map.put("vm.debug", this::vmDebug);
107         map.put("vm.jvmci", this::vmJvmci);
108         map.put("vm.jvmci.enabled", this::vmJvmciEnabled);
109         map.put("vm.emulatedClient", this::vmEmulatedClient);
110         // vm.hasSA is "true" if the VM contains the serviceability agent
111         // and jhsdb.
112         map.put("vm.hasSA", this::vmHasSA);
113         // vm.hasJFR is "true" if JFR is included in the build of the VM and
114         // so tests can be executed.
115         map.put("vm.hasJFR", this::vmHasJFR);
116         map.put("vm.hasDTrace", this::vmHasDTrace);
117         map.put("vm.jvmti", this::vmHasJVMTI);
118         map.put("vm.cpu.features", this::cpuFeatures);
119         map.put("vm.pageSize", this::vmPageSize);
120         map.put("vm.rtm.cpu", this::vmRTMCPU);
121         map.put("vm.rtm.compiler", this::vmRTMCompiler);
122         // vm.cds is true if the VM is compiled with cds support.
123         map.put("vm.cds", this::vmCDS);
124         map.put("vm.cds.custom.loaders", this::vmCDSForCustomLoaders);
125         map.put("vm.cds.write.archived.java.heap", this::vmCDSCanWriteArchivedJavaHeap);
126         map.put("vm.continuations", this::vmContinuations);
127         // vm.graal.enabled is true if Graal is used as JIT
128         map.put("vm.graal.enabled", this::isGraalEnabled);
129         // jdk.hasLibgraal is true if the libgraal shared library file is present
130         map.put("jdk.hasLibgraal", this::hasLibgraal);
131         // vm.libgraal.enabled is true if libgraal is used as JIT
132         map.put("vm.libgraal.enabled", this::isLibgraalEnabled);
133         map.put("vm.compiler1.enabled", this::isCompiler1Enabled);
134         map.put("vm.compiler2.enabled", this::isCompiler2Enabled);
135         map.put("docker.support", this::dockerSupport);
136         map.put("vm.musl", this::isMusl);
137         map.put("release.implementor", this::implementor);
138         map.put("jdk.containerized", this::jdkContainerized);
139         map.put("vm.flagless", this::isFlagless);
140         map.put("jdk.foreign.linker", this::jdkForeignLinker);
141         vmGC(map); // vm.gc.X = true/false
142         vmGCforCDS(map); // may set vm.gc
143         vmOptFinalFlags(map);
144 
145         dump(map.map);
146         log("Leaving call()");
147         return map.map;
148     }
149 
150     /**
151      * Print a stack trace before returning error state;
152      * Used by the various helper functions which parse information from
153      * VM properties in the case where they don't find an expected property
154      * or a property doesn't conform to an expected format.
155      *
156      * @return {@link #ERROR_STATE}
157      */
158     private String errorWithMessage(String message) {
159         new Exception(message).printStackTrace();
160         return ERROR_STATE + message;
161     }
162 
163     /**
164      * @return vm.simpleArch value of "os.simpleArch" property of tested JDK.
165      */
166     protected String vmArch() {
167         String arch = System.getProperty("os.arch");
168         if (arch.equals("x86_64") || arch.equals("amd64")) {
169             return "x64";
170         } else if (arch.contains("86")) {
171             return "x86";
172         } else {
173             return arch;
174         }
175     }
176 
177     /**
178      * @return VM type value extracted from the "java.vm.name" property.
179      */
180     protected String vmFlavor() {
181         // E.g. "Java HotSpot(TM) 64-Bit Server VM"
182         String vmName = System.getProperty("java.vm.name");
183         if (vmName == null) {
184             return errorWithMessage("Can't get 'java.vm.name' property");
185         }
186 
187         Pattern startP = Pattern.compile(".* (\\S+) VM");
188         Matcher m = startP.matcher(vmName);
189         if (m.matches()) {
190             return m.group(1).toLowerCase();
191         }
192         return errorWithMessage("Can't get VM flavor from 'java.vm.name'");
193     }
194 
195     /**
196      * @return VM compilation mode extracted from the "java.vm.info" property.
197      */
198     protected String vmCompMode() {
199         // E.g. "mixed mode"
200         String vmInfo = System.getProperty("java.vm.info");
201         if (vmInfo == null) {
202             return errorWithMessage("Can't get 'java.vm.info' property");
203         }
204         vmInfo = vmInfo.toLowerCase();
205         if (vmInfo.contains("mixed mode")) {
206             return "Xmixed";
207         } else if (vmInfo.contains("compiled mode")) {
208             return "Xcomp";
209         } else if (vmInfo.contains("interpreted mode")) {
210             return "Xint";
211         } else {
212             return errorWithMessage("Can't get compilation mode from 'java.vm.info'");
213         }
214     }
215 
216     /**
217      * @return VM bitness, the value of the "sun.arch.data.model" property.
218      */
219     protected String vmBits() {
220         String dataModel = System.getProperty("sun.arch.data.model");
221         if (dataModel != null) {
222             return dataModel;
223         } else {
224             return errorWithMessage("Can't get 'sun.arch.data.model' property");
225         }
226     }
227 
228     /**
229      * @return "true" if Flight Recorder is enabled, "false" if is disabled.
230      */
231     protected String vmFlightRecorder() {
232         Boolean isFlightRecorder = WB.getBooleanVMFlag("FlightRecorder");
233         String startFROptions = WB.getStringVMFlag("StartFlightRecording");
234         if (isFlightRecorder != null && isFlightRecorder) {
235             return "true";
236         }
237         if (startFROptions != null && !startFROptions.isEmpty()) {
238             return "true";
239         }
240         return "false";
241     }
242 
243     /**
244      * @return debug level value extracted from the "jdk.debug" property.
245      */
246     protected String vmDebug() {
247         String debug = System.getProperty("jdk.debug");
248         if (debug != null) {
249             return "" + debug.contains("debug");
250         } else {
251             return errorWithMessage("Can't get 'jdk.debug' property");
252         }
253     }
254 
255     /**
256      * @return true if VM supports JVMCI and false otherwise
257      */
258     protected String vmJvmci() {
259         // builds with jvmci have this flag
260         if (WB.getBooleanVMFlag("EnableJVMCI") == null) {
261             return "false";
262         }
263 
264         // Not all GCs have full JVMCI support
265         if (!WB.isJVMCISupportedByGC()) {
266           return "false";
267         }
268 
269         // Interpreted mode cannot enable JVMCI
270         if (vmCompMode().equals("Xint")) {
271           return "false";
272         }
273 
274         return "true";
275     }
276 
277 
278     /**
279      * @return true if JVMCI is enabled
280      */
281     protected String vmJvmciEnabled() {
282         // builds with jvmci have this flag
283         if ("false".equals(vmJvmci())) {
284             return "false";
285         }
286 
287         return "" + Compiler.isJVMCIEnabled();
288     }
289 
290 
291     /**
292      * @return true if VM runs in emulated-client mode and false otherwise.
293      */
294     protected String vmEmulatedClient() {
295         String vmInfo = System.getProperty("java.vm.info");
296         if (vmInfo == null) {
297             return errorWithMessage("Can't get 'java.vm.info' property");
298         }
299         return "" + vmInfo.contains(" emulated-client");
300     }
301 
302     /**
303      * @return supported CPU features
304      */
305     protected String cpuFeatures() {
306         return CPUInfo.getFeatures().toString();
307     }
308 
309     /**
310      * For all existing GC sets vm.gc.X property.
311      * Example vm.gc.G1=true means:
312      *    VM supports G1
313      *    User either set G1 explicitely (-XX:+UseG1GC) or did not set any GC
314      *    G1 can be selected, i.e. it doesn't conflict with other VM flags
315      *
316      * @param map - property-value pairs
317      */
318     protected void vmGC(SafeMap map) {
319         var isJVMCIEnabled = Compiler.isJVMCIEnabled();
320         Predicate<GC> vmGCProperty = (GC gc) -> (gc.isSupported()
321                                         && (!isJVMCIEnabled || gc.isSupportedByJVMCICompiler())
322                                         && (gc.isSelected() || GC.isSelectedErgonomically()));
323         for (GC gc: GC.values()) {
324             map.put("vm.gc." + gc.name(), () -> "" + vmGCProperty.test(gc));
325         }
326 
327         // Special handling for ZGC modes
328         var vmGCZ = vmGCProperty.test(GC.Z);
329         var genZ = WB.getBooleanVMFlag("ZGenerational");
330         var genZIsDefault = WB.isDefaultVMFlag("ZGenerational");
331         // vm.gc.ZGenerational=true means:
332         //    vm.gc.Z is true and ZGenerational is either explicitly true, or default
333         map.put("vm.gc.ZGenerational", () -> "" + (vmGCZ && (genZ || genZIsDefault)));
334         // vm.gc.ZSinglegen=true means:
335         //    vm.gc.Z is true and ZGenerational is either explicitly false, or default
336         map.put("vm.gc.ZSinglegen", () -> "" + (vmGCZ && (!genZ || genZIsDefault)));
337     }
338 
339     /**
340      * "jtreg -vmoptions:-Dtest.cds.runtime.options=..." can be used to specify
341      * the GC type to be used when running with a CDS archive. Set "vm.gc" accordingly,
342      * so that tests that need to explicitly choose the GC type can be excluded
343      * with "@requires vm.gc == null".
344      *
345      * @param map - property-value pairs
346      */
347     protected void vmGCforCDS(SafeMap map) {
348         if (!GC.isSelectedErgonomically()) {
349             // The GC has been explicitly specified on the command line, so
350             // jtreg will set the "vm.gc" property. Let's not interfere with it.
351             return;
352         }
353 
354         String jtropts = System.getProperty("test.cds.runtime.options");
355         if (jtropts != null) {
356             for (String opt : jtropts.split(",")) {
357                 if (opt.startsWith(GC_PREFIX) && opt.endsWith(GC_SUFFIX)) {
358                     String gc = opt.substring(GC_PREFIX.length(), opt.length() - GC_SUFFIX.length());
359                     map.put("vm.gc", () -> gc);
360                 }
361             }
362         }
363     }
364 
365     /**
366      * Selected final flag.
367      *
368      * @param map - property-value pairs
369      * @param flagName - flag name
370      */
371     private void vmOptFinalFlag(SafeMap map, String flagName) {
372         map.put("vm.opt.final." + flagName,
373                 () -> String.valueOf(WB.getBooleanVMFlag(flagName)));
374     }
375 
376     /**
377      * Selected sets of final flags.
378      *
379      * @param map - property-value pairs
380      */
381     protected void vmOptFinalFlags(SafeMap map) {
382         vmOptFinalFlag(map, "ClassUnloading");
383         vmOptFinalFlag(map, "ClassUnloadingWithConcurrentMark");
384         vmOptFinalFlag(map, "CriticalJNINatives");
385         vmOptFinalFlag(map, "EnableJVMCI");
386         vmOptFinalFlag(map, "EliminateAllocations");
387         vmOptFinalFlag(map, "UseCompressedOops");
388         vmOptFinalFlag(map, "UseVectorizedMismatchIntrinsic");
389         vmOptFinalFlag(map, "ZGenerational");
390     }
391 
392     /**
393      * @return "true" if VM has a serviceability agent.
394      */
395     protected String vmHasSA() {
396         return "" + Platform.hasSA();
397     }
398 
399     /**
400      * @return "true" if the VM is compiled with Java Flight Recorder (JFR)
401      * support.
402      */
403     protected String vmHasJFR() {
404         return "" + WB.isJFRIncluded();
405     }
406 
407     /**
408      * @return "true" if the VM is compiled with JVMTI
409      */
410     protected String vmHasJVMTI() {
411         return "" + WB.isJVMTIIncluded();
412     }
413 
414     /**
415      * @return "true" if the VM is compiled with DTrace
416      */
417     protected String vmHasDTrace() {
418         return "" + WB.isDTraceIncluded();
419     }
420 
421     /**
422      * @return "true" if compiler in use supports RTM and "false" otherwise.
423      * Note: Lightweight locking does not support RTM (for now).
424      */
425     protected String vmRTMCompiler() {
426         boolean isRTMCompiler = false;
427 
428         if (Compiler.isC2Enabled() &&
429             (Platform.isX86() || Platform.isX64() || Platform.isPPC()) &&
430             is_LM_LIGHTWEIGHT().equals("false")) {
431             isRTMCompiler = true;
432         }
433         return "" + isRTMCompiler;
434     }
435 
436     /**
437      * @return true if VM runs RTM supported CPU and false otherwise.
438      */
439     protected String vmRTMCPU() {
440         return "" + CPUInfo.hasFeature("rtm");
441     }
442 
443     /**
444      * Check for CDS support.
445      *
446      * @return true if CDS is supported by the VM to be tested.
447      */
448     protected String vmCDS() {
449         return "" + WB.isCDSIncluded();
450     }
451 
452     /**
453      * Check for CDS support for custom loaders.
454      *
455      * @return true if CDS provides support for customer loader in the VM to be tested.
456      */
457     protected String vmCDSForCustomLoaders() {
458         return "" + ("true".equals(vmCDS()) && Platform.areCustomLoadersSupportedForCDS());
459     }
460 
461     /**
462      * @return true if this VM can write Java heap objects into the CDS archive
463      */
464     protected String vmCDSCanWriteArchivedJavaHeap() {
465         return "" + ("true".equals(vmCDS()) && WB.canWriteJavaHeapArchive()
466                      && isCDSRuntimeOptionsCompatible());
467     }
468 
469     /**
470      * @return true if the VM options specified via the "test.cds.runtime.options"
471      * property is compatible with writing Java heap objects into the CDS archive
472      */
473     protected boolean isCDSRuntimeOptionsCompatible() {
474         String jtropts = System.getProperty("test.cds.runtime.options");
475         if (jtropts == null) {
476             return true;
477         }
478         String CCP_DISABLED = "-XX:-UseCompressedClassPointers";
479         String G1GC_ENABLED = "-XX:+UseG1GC";
480         for (String opt : jtropts.split(",")) {
481             if (opt.equals(CCP_DISABLED)) {
482                 return false;
483             }
484             if (opt.startsWith(GC_PREFIX) && opt.endsWith(GC_SUFFIX) &&
485                 !opt.equals(G1GC_ENABLED)) {
486                 return false;
487             }
488         }
489         return true;
490     }
491 
492     /**
493      * @return "true" if this VM supports continuations.
494      */
495     protected String vmContinuations() {
496         if (WB.getBooleanVMFlag("VMContinuations")) {
497             return "true";
498         } else {
499             return "false";
500         }
501     }
502 
503     /**
504      * @return System page size in bytes.
505      */
506     protected String vmPageSize() {
507         return "" + WB.getVMPageSize();
508     }
509 
510     /**
511      * @return LockingMode.
512      */
513     protected String vmLockingMode() {
514         return "" + WB.getIntVMFlag("LockingMode");
515     }
516 
517     /**
518      * @return "true" if LockingMode == 0 (LM_MONITOR)
519      */
520     protected String is_LM_MONITOR() {
521         return "" + vmLockingMode().equals("0");
522     }
523 
524     /**
525      * @return "true" if LockingMode == 1 (LM_LEGACY)
526      */
527     protected String is_LM_LEGACY() {
528         return "" + vmLockingMode().equals("1");
529     }
530 
531     /**
532      * @return "true" if LockingMode == 2 (LM_LIGHTWEIGHT)
533      */
534     protected String is_LM_LIGHTWEIGHT() {
535         return "" + vmLockingMode().equals("2");
536     }
537 
538     /**
539      * Check if Graal is used as JIT compiler.
540      *
541      * @return true if Graal is used as JIT compiler.
542      */
543     protected String isGraalEnabled() {
544         return "" + Compiler.isGraalEnabled();
545     }
546 
547     /**
548      * Check if the libgraal shared library file is present.
549      *
550      * @return true if the libgraal shared library file is present.
551      */
552     protected String hasLibgraal() {
553         return "" + WB.hasLibgraal();
554     }
555 
556     /**
557      * Check if libgraal is used as JIT compiler.
558      *
559      * @return true if libgraal is used as JIT compiler.
560      */
561     protected String isLibgraalEnabled() {
562         return "" + Compiler.isLibgraalEnabled();
563     }
564 
565     /**
566      * Check if Compiler1 is present.
567      *
568      * @return true if Compiler1 is used as JIT compiler, either alone or as part of the tiered system.
569      */
570     protected String isCompiler1Enabled() {
571         return "" + Compiler.isC1Enabled();
572     }
573 
574     /**
575      * Check if Compiler2 is present.
576      *
577      * @return true if Compiler2 is used as JIT compiler, either alone or as part of the tiered system.
578      */
579     protected String isCompiler2Enabled() {
580         return "" + Compiler.isC2Enabled();
581     }
582 
583     /**
584      * A simple check for docker support
585      *
586      * @return true if docker is supported in a given environment
587      */
588     protected String dockerSupport() {
589         log("Entering dockerSupport()");
590 
591         boolean isSupported = false;
592         if (Platform.isLinux()) {
593            // currently docker testing is only supported for Linux,
594            // on certain platforms
595 
596            String arch = System.getProperty("os.arch");
597 
598            if (Platform.isX64()) {
599               isSupported = true;
600            } else if (Platform.isAArch64()) {
601               isSupported = true;
602            } else if (Platform.isS390x()) {
603               isSupported = true;
604            } else if (arch.equals("ppc64le")) {
605               isSupported = true;
606            }
607         }
608 
609         log("dockerSupport(): platform check: isSupported = " + isSupported);
610 
611         if (isSupported) {
612            try {
613               isSupported = checkDockerSupport();
614            } catch (Exception e) {
615               isSupported = false;
616            }
617          }
618 
619         log("dockerSupport(): returning isSupported = " + isSupported);
620         return "" + isSupported;
621     }
622 
623     // Configures process builder to redirect process stdout and stderr to a file.
624     // Returns file names for stdout and stderr.
625     private Map<String, String> redirectOutputToLogFile(String msg, ProcessBuilder pb, String fileNameBase) {
626         Map<String, String> result = new HashMap<>();
627         String timeStamp = Instant.now().toString().replace(":", "-").replace(".", "-");
628 
629         String stdoutFileName = String.format("./%s-stdout--%s.log", fileNameBase, timeStamp);
630         pb.redirectOutput(new File(stdoutFileName));
631         log(msg + ": child process stdout redirected to " + stdoutFileName);
632         result.put("stdout", stdoutFileName);
633 
634         String stderrFileName = String.format("./%s-stderr--%s.log", fileNameBase, timeStamp);
635         pb.redirectError(new File(stderrFileName));
636         log(msg + ": child process stderr redirected to " + stderrFileName);
637         result.put("stderr", stderrFileName);
638 
639         return result;
640     }
641 
642     private void printLogfileContent(Map<String, String> logFileNames) {
643         logFileNames.entrySet().stream()
644             .forEach(entry ->
645                 {
646                     log("------------- " + entry.getKey());
647                     try {
648                         Files.lines(Path.of(entry.getValue()))
649                             .forEach(line -> log(line));
650                     } catch (IOException ie) {
651                         log("Exception while reading file: " + ie);
652                     }
653                     log("-------------");
654                 });
655     }
656 
657     private boolean checkDockerSupport() throws IOException, InterruptedException {
658         log("checkDockerSupport(): entering");
659         ProcessBuilder pb = new ProcessBuilder("which", Container.ENGINE_COMMAND);
660         Map<String, String> logFileNames =
661             redirectOutputToLogFile("checkDockerSupport(): which " + Container.ENGINE_COMMAND,
662                                                       pb, "which-container");
663         Process p = pb.start();
664         p.waitFor(10, TimeUnit.SECONDS);
665         int exitValue = p.exitValue();
666 
667         log(String.format("checkDockerSupport(): exitValue = %s, pid = %s", exitValue, p.pid()));
668         if (exitValue != 0) {
669             printLogfileContent(logFileNames);
670         }
671 
672         return (exitValue == 0);
673     }
674 
675     /**
676      * Checks musl libc.
677      *
678      * @return true if musl libc is used.
679      */
680     protected String isMusl() {
681         return Boolean.toString(WB.getLibcName().contains("musl"));
682     }
683 
684     private String implementor() {
685         try (InputStream in = new BufferedInputStream(new FileInputStream(
686                 System.getProperty("java.home") + "/release"))) {
687             Properties properties = new Properties();
688             properties.load(in);
689             String implementorProperty = properties.getProperty("IMPLEMENTOR");
690             if (implementorProperty != null) {
691                 return implementorProperty.replace("\"", "");
692             }
693             return errorWithMessage("Can't get 'IMPLEMENTOR' property from 'release' file");
694         } catch (IOException e) {
695             e.printStackTrace();
696             return errorWithMessage("Failed to read 'release' file " + e);
697         }
698     }
699 
700     private String jdkContainerized() {
701         String isEnabled = System.getenv("TEST_JDK_CONTAINERIZED");
702         return "" + "true".equalsIgnoreCase(isEnabled);
703     }
704 
705     /**
706      * Checks if we are in <i>almost</i> out-of-box configuration, i.e. the flags
707      * which JVM is started with don't affect its behavior "significantly".
708      * {@code TEST_VM_FLAGLESS} enviroment variable can be used to force this
709      * method to return true or false and allow or reject any flags.
710      *
711      * @return true if there are no JVM flags
712      */
713     private String isFlagless() {
714         boolean result = true;
715         String flagless = System.getenv("TEST_VM_FLAGLESS");
716         if (flagless != null) {
717             return "" + "true".equalsIgnoreCase(flagless);
718         }
719 
720         List<String> allFlags = allFlags().toList();
721 
722         // check -XX flags
723         var ignoredXXFlags = Set.of(
724                 // added by run-test framework
725                 "MaxRAMPercentage",
726                 // added by test environment
727                 "CreateCoredumpOnCrash"
728         );
729         result &= allFlags.stream()
730                           .filter(s -> s.startsWith("-XX:"))
731                           // map to names:
732                               // remove -XX:
733                               .map(s -> s.substring(4))
734                               // remove +/- from bool flags
735                               .map(s -> s.charAt(0) == '+' || s.charAt(0) == '-' ? s.substring(1) : s)
736                               // remove =.* from others
737                               .map(s -> s.contains("=") ? s.substring(0, s.indexOf('=')) : s)
738                           // skip known-to-be-there flags
739                           .filter(s -> !ignoredXXFlags.contains(s))
740                           .findAny()
741                           .isEmpty();
742 
743         // check -X flags
744         var ignoredXFlags = Set.of(
745                 // default, yet still seen to be explicitly set
746                 "mixed",
747                 // -XmxmNNNm added by run-test framework for non-hotspot tests
748                 "mx"
749         );
750         result &= allFlags.stream()
751                           .filter(s -> s.startsWith("-X") && !s.startsWith("-XX:"))
752                           // map to names:
753                           // remove -X
754                           .map(s -> s.substring(2))
755                           // remove :.* from flags with values
756                           .map(s -> s.contains(":") ? s.substring(0, s.indexOf(':')) : s)
757                           // remove size like 4G, 768m which might be set for non-hotspot tests
758                           .map(s -> s.replaceAll("(\\d+)[mMgGkK]", ""))
759                           // skip known-to-be-there flags
760                           .filter(s -> !ignoredXFlags.contains(s))
761                           .findAny()
762                           .isEmpty();
763 
764         return "" + result;
765     }
766 
767     private Stream<String> allFlags() {
768         return Stream.of((System.getProperty("test.vm.opts", "") + " " + System.getProperty("test.java.opts", "")).trim().split("\\s+"));
769     }
770 
771     /*
772      * A string indicating the foreign linker that is currently being used. See jdk.internal.foreign.CABI
773      * for valid values.
774      *
775      * "FALLBACK" and "UNSUPPORTED" are special values. The former indicates the fallback linker is
776      * being used. The latter indicates an unsupported platform.
777      */
778     private String jdkForeignLinker() {
779         return String.valueOf(CABI.current());
780     }
781 
782     /**
783      * Dumps the map to the file if the file name is given as the property.
784      * This functionality could be helpful to know context in the real
785      * execution.
786      *
787      * @param map
788      */
789     protected static void dump(Map<String, String> map) {
790         String dumpFileName = System.getProperty("vmprops.dump");
791         if (dumpFileName == null) {
792             return;
793         }
794         List<String> lines = new ArrayList<>();
795         map.forEach((k, v) -> lines.add(k + ":" + v));
796         Collections.sort(lines);
797         try {
798             Files.write(Paths.get(dumpFileName), lines,
799                     StandardOpenOption.APPEND, StandardOpenOption.CREATE);
800         } catch (IOException e) {
801             throw new RuntimeException("Failed to dump properties into '"
802                     + dumpFileName + "'", e);
803         }
804     }
805 
806     /**
807      * Log diagnostic message.
808      *
809      * @param msg
810      */
811     protected static void log(String msg) {
812         // Always log to a file.
813         logToFile(msg);
814 
815         // Also log to stderr; guarded by property to avoid excessive verbosity.
816         // By jtreg design stderr produced here will be visible
817         // in the output of a parent process. Note: stdout should not be used
818         // for logging as jtreg parses that output directly and only echoes it
819         // in the event of a failure.
820         if (Boolean.getBoolean("jtreg.log.vmprops")) {
821             System.err.println("VMProps: " + msg);
822         }
823     }
824 
825     /**
826      * Log diagnostic message to a file.
827      *
828      * @param msg
829      */
830     protected static void logToFile(String msg) {
831         String fileName = "./vmprops.log";
832         try {
833             Files.writeString(Paths.get(fileName), msg + "\n", Charset.forName("ISO-8859-1"),
834                     StandardOpenOption.APPEND, StandardOpenOption.CREATE);
835         } catch (IOException e) {
836             throw new RuntimeException("Failed to log into '" + fileName + "'", e);
837         }
838     }
839 
840     /**
841      * This method is for the testing purpose only.
842      *
843      * @param args
844      */
845     public static void main(String args[]) {
846         Map<String, String> map = new VMProps().call();
847         map.forEach((k, v) -> System.out.println(k + ": '" + v + "'"));
848     }
849 }