1 /*
2  * Copyright (c) 2011, 2016, 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 
25 package org.graalvm.compiler.graph.spi;
26 
27 import jdk.vm.ci.meta.Assumptions;
28 import jdk.vm.ci.meta.ConstantReflectionProvider;
29 import jdk.vm.ci.meta.MetaAccessProvider;
30 
31 import org.graalvm.compiler.core.common.spi.ConstantFieldProvider;
32 import org.graalvm.compiler.graph.Node;
33 import org.graalvm.compiler.options.OptionValues;
34 
35 public interface CanonicalizerTool {
36 
getAssumptions()37     Assumptions getAssumptions();
38 
getMetaAccess()39     MetaAccessProvider getMetaAccess();
40 
getConstantReflection()41     ConstantReflectionProvider getConstantReflection();
42 
getConstantFieldProvider()43     ConstantFieldProvider getConstantFieldProvider();
44 
canonicalizeReads()45     boolean canonicalizeReads();
46 
47     /**
48      * If this method returns false, not all {@link Node#usages() usages of a node} are yet
49      * available. So a node must not be canonicalized base on, e.g., information returned from
50      * {@link Node#hasNoUsages()}.
51      */
allUsagesAvailable()52     boolean allUsagesAvailable();
53 
54     /**
55      * Indicates the smallest width for comparing an integer value on the target platform. If this
56      * method returns null, then there is no known smallest compare width.
57      */
smallestCompareWidth()58     Integer smallestCompareWidth();
59 
getOptions()60     OptionValues getOptions();
61 }
62