Mercurial > hg > truffle
view graal/com.oracle.graal.asm/src/com/oracle/graal/asm/Assembler.java @ 16868:db090a8d3705
clarify documentation about assumption and profile storage in final fields
author | Michael Haupt <michael.haupt@oracle.com> |
---|---|
date | Wed, 20 Aug 2014 15:16:11 +0200 |
parents | 164903a50a9a |
children | 5a7b82c1514e |
line wrap: on
line source
/* * Copyright (c) 2009, 2011, 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 com.oracle.graal.asm; import java.nio.*; import java.util.*; import com.oracle.graal.api.code.*; /** * The platform-independent base class for the assembler. */ public abstract class Assembler { public final TargetDescription target; /** * Backing code buffer. */ private final Buffer codeBuffer; public Assembler(TargetDescription target) { this.target = target; if (target.arch.getByteOrder() == ByteOrder.BIG_ENDIAN) { this.codeBuffer = new Buffer.BigEndian(); } else { this.codeBuffer = new Buffer.LittleEndian(); } } /** * Returns the current position of the underlying code buffer. * * @return current position in code buffer */ public int position() { return codeBuffer.position(); } public final void emitByte(int x) { codeBuffer.emitByte(x); } public final void emitShort(int x) { codeBuffer.emitShort(x); } public final void emitInt(int x) { codeBuffer.emitInt(x); } public final void emitLong(long x) { codeBuffer.emitLong(x); } public final void emitByte(int b, int pos) { codeBuffer.emitByte(b, pos); } public final void emitShort(int b, int pos) { codeBuffer.emitShort(b, pos); } public final void emitInt(int b, int pos) { codeBuffer.emitInt(b, pos); } public final void emitLong(long b, int pos) { codeBuffer.emitLong(b, pos); } public final int getByte(int pos) { return codeBuffer.getByte(pos); } public final int getShort(int pos) { return codeBuffer.getShort(pos); } public final int getInt(int pos) { return codeBuffer.getInt(pos); } private static final String NEWLINE = System.getProperty("line.separator"); /** * Some GPU architectures have a text based encoding. */ public final void emitString(String x) { emitString0("\t"); // XXX REMOVE ME pretty-printing emitString0(x); emitString0(NEWLINE); } // XXX for pretty-printing public final void emitString0(String x) { codeBuffer.emitBytes(x.getBytes(), 0, x.length()); } public void emitString(String s, int pos) { codeBuffer.emitBytes(s.getBytes(), pos); } /** * Closes this assembler. No extra data can be written to this assembler after this call. * * @param trimmedCopy if {@code true}, then a copy of the underlying byte array up to (but not * including) {@code position()} is returned * @return the data in this buffer or a trimmed copy if {@code trimmedCopy} is {@code true} */ public byte[] close(boolean trimmedCopy) { return codeBuffer.close(trimmedCopy); } public void bind(Label l) { assert !l.isBound() : "can bind label only once"; l.bind(position()); l.patchInstructions(this); } public abstract void align(int modulus); public abstract void jmp(Label l); protected abstract void patchJumpTarget(int branch, int jumpTarget); private Map<Label, String> nameMap; /** * Creates a name for a label. * * @param l the label for which a name is being created * @param id a label identifier that is unique with the scope of this assembler * @return a label name in the form of "L123" */ protected String createLabelName(Label l, int id) { return "L" + id; } /** * Gets a name for a label, creating it if it does not yet exist. By default, the returned name * is only unique with the scope of this assembler. */ public String nameOf(Label l) { if (nameMap == null) { nameMap = new HashMap<>(); } String name = nameMap.get(l); if (name == null) { name = createLabelName(l, nameMap.size()); nameMap.put(l, name); } return name; } /** * This is used by the CompilationResultBuilder to convert a {@link StackSlot} to an * {@link AbstractAddress}. */ public abstract AbstractAddress makeAddress(Register base, int displacement); /** * Returns a target specific placeholder address that can be used for code patching. */ public abstract AbstractAddress getPlaceholder(); /** * Emits a NOP instruction to advance the current PC. */ public abstract void ensureUniquePC(); }