comparison graal/com.oracle.jvmci.code/src/com/oracle/jvmci/code/ForeignCallsProvider.java @ 21556:48c1ebd24120

renamed com.oracle.graal.api[meta|code] modules to com.oracle.jvmci.[meta|code] (JBS:GRAAL-53)
author Doug Simon <doug.simon@oracle.com>
date Wed, 27 May 2015 00:36:16 +0200
parents graal/com.oracle.graal.api.code/src/com/oracle/graal/api/code/ForeignCallsProvider.java@3d0116ec99c5
children
comparison
equal deleted inserted replaced
21555:d12eaef9af72 21556:48c1ebd24120
1 /*
2 * Copyright (c) 2013, 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 package com.oracle.jvmci.code;
24
25 import com.oracle.jvmci.meta.LocationIdentity;
26 import com.oracle.jvmci.meta.ForeignCallDescriptor;
27
28 /**
29 * Details about a set of supported {@link ForeignCallDescriptor foreign calls}.
30 */
31 public interface ForeignCallsProvider {
32
33 /**
34 * Determines if a given foreign call is side-effect free. Deoptimization cannot return
35 * execution to a point before a foreign call that has a side effect.
36 */
37 boolean isReexecutable(ForeignCallDescriptor descriptor);
38
39 /**
40 * Gets the set of memory locations killed by a given foreign call. Returning the special value
41 * {@link LocationIdentity#any()} denotes that the call kills all memory locations. Returning
42 * any empty array denotes that the call does not kill any memory locations.
43 */
44 LocationIdentity[] getKilledLocations(ForeignCallDescriptor descriptor);
45
46 /**
47 * Determines if deoptimization can occur during a given foreign call.
48 */
49 boolean canDeoptimize(ForeignCallDescriptor descriptor);
50
51 /**
52 * Gets the linkage for a foreign call.
53 */
54 ForeignCallLinkage lookupForeignCall(ForeignCallDescriptor descriptor);
55 }