1 /*
   2  * Copyright (c) 2015, 2020, 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 import jdk.test.lib.process.ProcessTools;
  25 import jdk.test.lib.process.OutputAnalyzer;
  26 import jdk.test.lib.cli.*;
  27 
  28 /*
  29  * @test
  30  * @bug 8066821
  31  * @summary Test that various options are deprecated. See deprecated_jvm_flags in arguments.cpp.
  32  * @modules java.base/jdk.internal.misc
  33  * @library /test/lib
  34  * @run driver VMDeprecatedOptions
  35  */
  36 public class VMDeprecatedOptions {
  37 
  38     /**
  39      * each entry is {[0]: option name, [1]: value to set
  40      * (true/false/n/string)}.
  41      */
  42     public static final String[][] DEPRECATED_OPTIONS = {
  43         // deprecated non-alias flags:
  44         {"MaxGCMinorPauseMillis",     "1032"},
  45         {"MaxRAMFraction",            "8"},
  46         {"MinRAMFraction",            "2"},
  47         {"InitialRAMFraction",        "64"},
  48         {"TLABStats",                 "false"},
  49         {"AllowRedefinitionToAddDeleteMethods", "true"},
  50         {"PrintVMQWaitTime",          "true"},
  51         {"UseNewFieldLayout",         "true"},
  52         {"UseBiasedLocking",                    "false"},
  53         {"BiasedLockingStartupDelay",           "0"},
  54         {"BiasedLockingBulkRebiasThreshold",    "20"},
  55         {"BiasedLockingBulkRevokeThreshold",    "40"},
  56         {"BiasedLockingDecayTime",              "25000"},
  57         {"UseOptoBiasInlining",                 "true"},
  58         {"InitialBootClassLoaderMetaspaceSize", "2200000"},
  59         {"UseLargePagesInMetaspace",            "true"},
  60 
  61         // deprecated alias flags (see also aliased_jvm_flags):
  62         {"DefaultMaxRAMFraction", "4"},
  63         {"CreateMinidumpOnCrash", "false"}
  64     };
  65 
  66     static String getDeprecationString(String optionName) {
  67         return "Option " + optionName
  68             + " was deprecated in version [\\S]+ and will likely be removed in a future release";
  69     }
  70 
  71     static void testDeprecated(String[][] optionInfo) throws Throwable {
  72         String optionNames[] = new String[optionInfo.length];
  73         String expectedValues[] = new String[optionInfo.length];
  74         for (int i = 0; i < optionInfo.length; i++) {
  75             optionNames[i] = optionInfo[i][0];
  76             expectedValues[i] = optionInfo[i][1];
  77         }
  78 
  79         OutputAnalyzer output = CommandLineOptionTest.startVMWithOptions(optionNames, expectedValues);
  80 
  81         // check for option deprecation messages:
  82         output.shouldHaveExitValue(0);
  83         for (String[] deprecated : optionInfo) {
  84             String match = getDeprecationString(deprecated[0]);
  85             output.shouldMatch(match);
  86         }
  87     }
  88 
  89     // Deprecated diagnostic command line options need to be preceded on the
  90     // command line by -XX:+UnlockDiagnosticVMOptions.
  91     static void testDeprecatedDiagnostic(String option, String value)  throws Throwable {
  92         String XXoption = CommandLineOptionTest.prepareFlag(option, value);
  93         ProcessBuilder processBuilder = ProcessTools.createJavaProcessBuilder(
  94             CommandLineOptionTest.UNLOCK_DIAGNOSTIC_VM_OPTIONS, XXoption, "-version");
  95         OutputAnalyzer output = new OutputAnalyzer(processBuilder.start());
  96         // check for option deprecation message:
  97         output.shouldHaveExitValue(0);
  98         String match = getDeprecationString(option);
  99         output.shouldMatch(match);
 100     }
 101 
 102     // Deprecated experimental command line options need to be preceded on the
 103     // command line by -XX:+UnlockExperimentalVMOption.
 104     static void testDeprecatedExperimental(String option, String value)  throws Throwable {
 105         String XXoption = CommandLineOptionTest.prepareFlag(option, value);
 106         ProcessBuilder processBuilder = ProcessTools.createJavaProcessBuilder(
 107             CommandLineOptionTest.UNLOCK_EXPERIMENTAL_VM_OPTIONS, XXoption, "-version");
 108         OutputAnalyzer output = new OutputAnalyzer(processBuilder.start());
 109         // check for option deprecation message:
 110         output.shouldHaveExitValue(0);
 111         String match = getDeprecationString(option);
 112         output.shouldMatch(match);
 113     }
 114 
 115     public static void main(String[] args) throws Throwable {
 116         testDeprecated(DEPRECATED_OPTIONS);  // Make sure that each deprecated option is mentioned in the output.
 117     }
 118 }