/* * Copyright (c) 2014, 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 jdk.vm.ci.options; import static jdk.vm.ci.inittimer.InitTimer.timer; import java.io.BufferedReader; import java.io.File; import java.io.FileReader; import java.io.IOException; import java.io.PrintStream; import java.util.ArrayList; import java.util.Collections; import java.util.Formatter; import java.util.HashSet; import java.util.List; import java.util.Map; import java.util.ServiceLoader; import java.util.Set; import java.util.SortedMap; import jdk.vm.ci.inittimer.InitTimer; /** * This class contains methods for parsing JVMCI options and matching them against a set of * {@link OptionDescriptors}. The {@link OptionDescriptors} are loaded via a {@link ServiceLoader}. */ public class OptionsParser { private static final OptionValue PrintFlags = new OptionValue<>(false); private static final OptionValue ShowFlags = new OptionValue<>(false); /** * A service for looking up {@link OptionDescriptor}s. */ public interface OptionDescriptorsProvider { /** * Gets the {@link OptionDescriptor} matching a given option {@linkplain Option#name() name} * or null if no option of that name is provided by this object. */ OptionDescriptor get(String name); } public interface OptionConsumer { void set(OptionDescriptor desc, Object value); } /** * Parses the options in {@code /lib/jvmci.options} if {@code parseOptionsFile == true} and * the file exists followed by the JVMCI options in {@code options} if {@code options != null}. * * Called from VM. This method has an object return type to allow it to be called with a VM * utility function used to call other static initialization methods. * * @param options JVMCI options as serialized (name, value) pairs * @param parseOptionsFile specifies whether to look for and parse * {@code /lib/jvmci.options} */ @SuppressWarnings("try") public static Boolean parseOptionsFromVM(String[] options, boolean parseOptionsFile) { try (InitTimer t = timer("ParseOptions")) { if (parseOptionsFile) { File javaHome = new File(System.getProperty("java.home")); File lib = new File(javaHome, "lib"); File jvmciOptions = new File(lib, "jvmci.options"); if (jvmciOptions.exists()) { try (BufferedReader br = new BufferedReader(new FileReader(jvmciOptions))) { String optionSetting = null; int lineNo = 1; List optionSettings = new ArrayList<>(); while ((optionSetting = br.readLine()) != null) { if (!optionSetting.isEmpty() && optionSetting.charAt(0) != '#') { try { parseOptionSettingTo(optionSetting, optionSettings); } catch (Throwable e) { throw new InternalError("Error parsing " + jvmciOptions + ", line " + lineNo, e); } } lineNo++; } try { parseOptions(optionSettings.toArray(new String[optionSettings.size()]), null, null, null); } catch (Throwable e) { throw new InternalError("Error parsing an option from " + jvmciOptions, e); } } catch (IOException e) { throw new InternalError("Error reading " + jvmciOptions, e); } } } parseOptions(options, null, null, null); } return Boolean.TRUE; } /** * Parses an ordered list of (name, value) pairs assigning values to JVMCI options. * * @param optionSettings JVMCI options as serialized (name, value) pairs * @param setter the object to notify of the parsed option and value * @param odp if non-null, the service to use for looking up {@link OptionDescriptor}s * @param options the options database to use if {@code odp == null}. If * {@code options == null && odp == null}, {@link OptionsLoader#options} is used. * @throws IllegalArgumentException if there's a problem parsing {@code option} */ public static void parseOptions(String[] optionSettings, OptionConsumer setter, OptionDescriptorsProvider odp, SortedMap options) { if (optionSettings != null && optionSettings.length != 0) { assert optionSettings.length % 2 == 0; moveHelpFlagsToTail(optionSettings); for (int i = 0; i < optionSettings.length / 2; i++) { String name = optionSettings[i * 2]; String value = optionSettings[i * 2 + 1]; parseOption(name, value, setter, odp, options); } if (PrintFlags.getValue() || ShowFlags.getValue()) { Set explicitlyAssigned = new HashSet<>(optionSettings.length / 2); for (int i = 0; i < optionSettings.length / 2; i++) { String name = optionSettings[i * 2]; explicitlyAssigned.add(name); } printFlags(resolveOptions(options), "JVMCI", System.out, explicitlyAssigned); if (PrintFlags.getValue()) { System.exit(0); } } } } /** * Moves all {@code PrintFlags} and {@code ShowFlags} option settings to the back of * {@code optionSettings}. This allows the help message to show which options had their value * explicitly set (even if to their default value). */ private static void moveHelpFlagsToTail(String[] optionSettings) { List tail = null; int insert = 0; for (int i = 0; i < optionSettings.length / 2; i++) { String name = optionSettings[i * 2]; String value = optionSettings[i * 2 + 1]; if (name.equals("ShowFlags") || name.equals("PrintFlags")) { if (tail == null) { tail = new ArrayList<>(4); insert = i * 2; } tail.add(name); tail.add(value); } else if (tail != null) { optionSettings[insert++] = name; optionSettings[insert++] = value; } } if (tail != null) { assert tail.size() + insert == optionSettings.length; String[] tailArr = tail.toArray(new String[tail.size()]); System.arraycopy(tailArr, 0, optionSettings, insert, tailArr.length); } } /** * Parses a given option setting string to a list of (name, value) pairs. * * @param optionSetting a string matching the pattern {@code =} */ public static void parseOptionSettingTo(String optionSetting, List dst) { int eqIndex = optionSetting.indexOf('='); if (eqIndex == -1) { throw new InternalError("Option setting has does not match the pattern =: " + optionSetting); } dst.add(optionSetting.substring(0, eqIndex)); dst.add(optionSetting.substring(eqIndex + 1)); } /** * Resolves {@code options} to a non-null value. This ensures {@link OptionsLoader#options} is * only loaded if necessary. */ private static SortedMap resolveOptions(SortedMap options) { return options != null ? options : OptionsLoader.options; } /** * Parses a given option name and value. * * @param name the option name * @param valueString the option value as a string * @param setter the object to notify of the parsed option and value * @param odp if non-null, the service to use for looking up {@link OptionDescriptor}s * @param options the options database to use if {@code odp == null}. If * {@code options == null && odp == null}, {@link OptionsLoader#options} is used. * @throws IllegalArgumentException if there's a problem parsing {@code option} */ private static void parseOption(String name, String valueString, OptionConsumer setter, OptionDescriptorsProvider odp, SortedMap options) { OptionDescriptor desc = odp != null ? odp.get(name) : resolveOptions(options).get(name); if (desc == null) { if (name.equals("PrintFlags")) { desc = OptionDescriptor.create("PrintFlags", Boolean.class, "Prints all JVMCI flags and exits", OptionsParser.class, "PrintFlags", PrintFlags); } else if (name.equals("ShowFlags")) { desc = OptionDescriptor.create("ShowFlags", Boolean.class, "Prints all JVMCI flags and continues", OptionsParser.class, "ShowFlags", ShowFlags); } } if (desc == null) { List matches = fuzzyMatch(resolveOptions(options), name); Formatter msg = new Formatter(); msg.format("Could not find option %s", name); if (!matches.isEmpty()) { msg.format("%nDid you mean one of the following?"); for (OptionDescriptor match : matches) { msg.format("%n %s=", match.getName()); } } throw new IllegalArgumentException(msg.toString()); } Class optionType = desc.getType(); Object value; if (optionType == Boolean.class) { if ("true".equals(valueString)) { value = Boolean.TRUE; } else if ("false".equals(valueString)) { value = Boolean.FALSE; } else { throw new IllegalArgumentException("Boolean option '" + name + "' must have value \"true\" or \"false\", not \"" + valueString + "\""); } } else if (optionType == Float.class) { value = Float.parseFloat(valueString); } else if (optionType == Double.class) { value = Double.parseDouble(valueString); } else if (optionType == Integer.class) { value = Integer.valueOf((int) parseLong(valueString)); } else if (optionType == Long.class) { value = Long.valueOf(parseLong(valueString)); } else if (optionType == String.class) { value = valueString; } else { throw new IllegalArgumentException("Wrong value for option '" + name + "'"); } if (setter == null) { desc.getOptionValue().setValue(value); } else { setter.set(desc, value); } } private static long parseLong(String v) { String valueString = v.toLowerCase(); long scale = 1; if (valueString.endsWith("k")) { scale = 1024L; } else if (valueString.endsWith("m")) { scale = 1024L * 1024L; } else if (valueString.endsWith("g")) { scale = 1024L * 1024L * 1024L; } else if (valueString.endsWith("t")) { scale = 1024L * 1024L * 1024L * 1024L; } if (scale != 1) { /* Remove trailing scale character. */ valueString = valueString.substring(0, valueString.length() - 1); } return Long.parseLong(valueString) * scale; } /** * Wraps some given text to one or more lines of a given maximum width. * * @param text text to wrap * @param width maximum width of an output line, exception for words in {@code text} longer than * this value * @return {@code text} broken into lines */ private static List wrap(String text, int width) { List lines = Collections.singletonList(text); if (text.length() > width) { String[] chunks = text.split("\\s+"); lines = new ArrayList<>(); StringBuilder line = new StringBuilder(); for (String chunk : chunks) { if (line.length() + chunk.length() > width) { lines.add(line.toString()); line.setLength(0); } if (line.length() != 0) { line.append(' '); } String[] embeddedLines = chunk.split("%n", -2); if (embeddedLines.length == 1) { line.append(chunk); } else { for (int i = 0; i < embeddedLines.length; i++) { line.append(embeddedLines[i]); if (i < embeddedLines.length - 1) { lines.add(line.toString()); line.setLength(0); } } } } if (line.length() != 0) { lines.add(line.toString()); } } return lines; } private static void printFlags(SortedMap sortedOptions, String prefix, PrintStream out, Set explicitlyAssigned) { out.println("[List of " + prefix + " options]"); for (Map.Entry e : sortedOptions.entrySet()) { e.getKey(); OptionDescriptor desc = e.getValue(); Object value = desc.getOptionValue().getValue(); List helpLines = wrap(desc.getHelp(), 70); String name = e.getKey(); String assign = explicitlyAssigned.contains(name) ? ":=" : " ="; out.printf("%9s %-40s %s %-14s %s%n", desc.getType().getSimpleName(), name, assign, value, helpLines.get(0)); for (int i = 1; i < helpLines.size(); i++) { out.printf("%67s %s%n", " ", helpLines.get(i)); } } } /** * Compute string similarity based on Dice's coefficient. * * Ported from str_similar() in globals.cpp. */ static float stringSimiliarity(String str1, String str2) { int hit = 0; for (int i = 0; i < str1.length() - 1; ++i) { for (int j = 0; j < str2.length() - 1; ++j) { if ((str1.charAt(i) == str2.charAt(j)) && (str1.charAt(i + 1) == str2.charAt(j + 1))) { ++hit; break; } } } return 2.0f * hit / (str1.length() + str2.length()); } private static final float FUZZY_MATCH_THRESHOLD = 0.7F; /** * Returns the set of options that fuzzy match a given option name. */ private static List fuzzyMatch(SortedMap options, String optionName) { List matches = new ArrayList<>(); for (Map.Entry e : options.entrySet()) { float score = stringSimiliarity(e.getKey(), optionName); if (score >= FUZZY_MATCH_THRESHOLD) { matches.add(e.getValue()); } } return matches; } }