hotspot/src/jdk.internal.vm.compiler/share/classes/org.graalvm.compiler.lir/src/org/graalvm/compiler/lir/BailoutAndRestartBackendException.java
changeset 43972 1ade39b8381b
child 46344 694c102fd8ed
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/hotspot/src/jdk.internal.vm.compiler/share/classes/org.graalvm.compiler.lir/src/org/graalvm/compiler/lir/BailoutAndRestartBackendException.java	Thu Feb 16 15:46:09 2017 -0800
@@ -0,0 +1,73 @@
+/*
+ * Copyright (c) 2016, 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 org.graalvm.compiler.lir;
+
+import org.graalvm.compiler.common.PermanentBailoutException;
+import org.graalvm.compiler.lir.phases.LIRSuites;
+import org.graalvm.compiler.options.Option;
+import org.graalvm.compiler.options.OptionType;
+import org.graalvm.compiler.options.OptionValue;
+import org.graalvm.compiler.options.OptionValue.OverrideScope;
+import org.graalvm.compiler.options.StableOptionValue;
+
+/**
+ * Restarts the {@link LIR low-level} compilation with a modified configuration.
+ * {@link BailoutAndRestartBackendException.Options#LIRUnlockBackendRestart LIRUnlockBackendRestart}
+ * needs to be enabled. Use only for debugging purposes only.
+ */
+public abstract class BailoutAndRestartBackendException extends PermanentBailoutException {
+
+    public static class Options {
+        // @formatter:off
+        @Option(help = "Unlock backend restart feature.", type = OptionType.Debug)
+        public static final StableOptionValue<Boolean> LIRUnlockBackendRestart = new StableOptionValue<>(false);
+        // @formatter:on
+    }
+
+    private static final long serialVersionUID = 792969002851591180L;
+
+    public BailoutAndRestartBackendException(String msg) {
+        super(msg);
+    }
+
+    public BailoutAndRestartBackendException(Throwable cause, String msg) {
+        super(cause, msg);
+    }
+
+    /** Returns {@code true} if the low-level compilation should be restarted. */
+    public abstract boolean shouldRestart();
+
+    /**
+     * Returns an {@link OverrideScope} to change {@link OptionValue OptionValues} or {@code null}
+     * if no changes are required.
+     */
+    public abstract OverrideScope getOverrideScope();
+
+    /**
+     * Updates the {@link LIRSuites} used by the low-level compiler. Note that {@link LIRSuites} are
+     * usually shared, so a modified input parameter will affect other compilations. In case only
+     * the current compilation should be altered, create a copy using {@link LIRSuites#copy()}.
+     */
+    public abstract LIRSuites updateLIRSuites(LIRSuites lirSuites);
+
+}