Mercurial > hg > graal-jvmci-8
annotate jvmci/jdk.vm.ci.code/src/jdk/vm/ci/code/CallingConvention.java @ 22672:1bbd4a7c274b
Rename jdk.internal.jvmci to jdk.vm.ci
| author | Tom Rodriguez <tom.rodriguez@oracle.com> |
|---|---|
| date | Thu, 08 Oct 2015 17:28:41 -0700 |
| parents | jvmci/jdk.internal.jvmci.code/src/jdk/internal/jvmci/code/CallingConvention.java@ec96f33a101d |
| children | d63506bb5237 |
| rev | line source |
|---|---|
| 22054 | 1 /* |
| 2 * Copyright (c) 2009, 2012, 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 */ | |
|
22672
1bbd4a7c274b
Rename jdk.internal.jvmci to jdk.vm.ci
Tom Rodriguez <tom.rodriguez@oracle.com>
parents:
22569
diff
changeset
|
23 package jdk.vm.ci.code; |
| 22054 | 24 |
|
22672
1bbd4a7c274b
Rename jdk.internal.jvmci to jdk.vm.ci
Tom Rodriguez <tom.rodriguez@oracle.com>
parents:
22569
diff
changeset
|
25 import static jdk.vm.ci.code.ValueUtil.isAllocatableValue; |
|
1bbd4a7c274b
Rename jdk.internal.jvmci to jdk.vm.ci
Tom Rodriguez <tom.rodriguez@oracle.com>
parents:
22569
diff
changeset
|
26 import static jdk.vm.ci.code.ValueUtil.isStackSlot; |
|
1bbd4a7c274b
Rename jdk.internal.jvmci to jdk.vm.ci
Tom Rodriguez <tom.rodriguez@oracle.com>
parents:
22569
diff
changeset
|
27 import jdk.vm.ci.meta.AllocatableValue; |
|
1bbd4a7c274b
Rename jdk.internal.jvmci to jdk.vm.ci
Tom Rodriguez <tom.rodriguez@oracle.com>
parents:
22569
diff
changeset
|
28 import jdk.vm.ci.meta.Value; |
| 22054 | 29 |
| 30 /** | |
| 31 * A calling convention describes the locations in which the arguments for a call are placed and the | |
| 32 * location in which the return value is placed if the call is not void. | |
| 33 */ | |
| 34 public class CallingConvention { | |
| 35 | |
| 36 /** | |
| 37 * Constants denoting the type of a call for which a calling convention is requested. | |
| 38 */ | |
| 39 public enum Type { | |
| 40 /** | |
| 41 * A request for the outgoing argument locations at a call site to Java code. | |
| 42 */ | |
| 43 JavaCall(true), | |
| 44 | |
| 45 /** | |
| 46 * A request for the incoming argument locations. | |
| 47 */ | |
| 48 JavaCallee(false), | |
| 49 | |
| 50 /** | |
| 51 * A request for the outgoing argument locations at a call site to external native code that | |
| 52 * complies with the platform ABI. | |
| 53 */ | |
| 54 NativeCall(true); | |
| 55 | |
| 56 /** | |
| 57 * Determines if this is a request for the outgoing argument locations at a call site. | |
| 58 */ | |
| 59 public final boolean out; | |
| 60 | |
| 61 public static final Type[] VALUES = values(); | |
| 62 | |
| 63 private Type(boolean out) { | |
| 64 this.out = out; | |
| 65 } | |
| 66 } | |
| 67 | |
| 68 /** | |
| 69 * The amount of stack space (in bytes) required for the stack-based arguments of the call. | |
| 70 */ | |
| 71 private final int stackSize; | |
| 72 | |
| 73 private final AllocatableValue returnLocation; | |
| 74 | |
| 75 /** | |
| 76 * The ordered locations in which the arguments are placed. | |
| 77 */ | |
| 78 private final AllocatableValue[] argumentLocations; | |
| 79 | |
| 80 /** | |
| 81 * Creates a description of the registers and stack locations used by a call. | |
| 82 * | |
| 83 * @param stackSize amount of stack space (in bytes) required for the stack-based arguments of | |
| 84 * the call | |
| 85 * @param returnLocation the location for the return value or {@link Value#ILLEGAL} if a void | |
| 86 * call | |
| 87 * @param argumentLocations the ordered locations in which the arguments are placed | |
| 88 */ | |
| 89 public CallingConvention(int stackSize, AllocatableValue returnLocation, AllocatableValue... argumentLocations) { | |
| 90 assert argumentLocations != null; | |
| 91 assert returnLocation != null; | |
| 92 this.argumentLocations = argumentLocations; | |
| 93 this.stackSize = stackSize; | |
| 94 this.returnLocation = returnLocation; | |
| 95 assert verify(); | |
| 96 } | |
| 97 | |
| 98 /** | |
| 99 * Gets the location for the return value or {@link Value#ILLEGAL} if a void call. | |
| 100 */ | |
| 101 public AllocatableValue getReturn() { | |
| 102 return returnLocation; | |
| 103 } | |
| 104 | |
| 105 /** | |
| 106 * Gets the location for the {@code index}'th argument. | |
| 107 */ | |
| 108 public AllocatableValue getArgument(int index) { | |
| 109 return argumentLocations[index]; | |
| 110 } | |
| 111 | |
| 112 /** | |
| 113 * Gets the amount of stack space (in bytes) required for the stack-based arguments of the call. | |
| 114 */ | |
| 115 public int getStackSize() { | |
| 116 return stackSize; | |
| 117 } | |
| 118 | |
| 119 /** | |
| 120 * Gets the number of locations required for the arguments. | |
| 121 */ | |
| 122 public int getArgumentCount() { | |
| 123 return argumentLocations.length; | |
| 124 } | |
| 125 | |
| 126 /** | |
| 127 * Gets the locations required for the arguments. | |
| 128 */ | |
| 129 public AllocatableValue[] getArguments() { | |
| 130 if (argumentLocations.length == 0) { | |
| 131 return argumentLocations; | |
| 132 } | |
| 133 return argumentLocations.clone(); | |
| 134 } | |
| 135 | |
| 136 @Override | |
| 137 public String toString() { | |
| 138 StringBuilder sb = new StringBuilder(); | |
| 139 sb.append("CallingConvention["); | |
| 140 String sep = ""; | |
| 141 for (Value op : argumentLocations) { | |
| 142 sb.append(sep).append(op); | |
| 143 sep = ", "; | |
| 144 } | |
| 145 if (!returnLocation.equals(Value.ILLEGAL)) { | |
| 146 sb.append(" -> ").append(returnLocation); | |
| 147 } | |
| 148 sb.append("]"); | |
| 149 return sb.toString(); | |
| 150 } | |
| 151 | |
| 152 private boolean verify() { | |
| 153 for (int i = 0; i < argumentLocations.length; i++) { | |
| 154 Value location = argumentLocations[i]; | |
| 155 assert isStackSlot(location) || isAllocatableValue(location); | |
| 156 } | |
| 157 return true; | |
| 158 } | |
| 159 } |