00001 package ca.mcgill.sable.soot.coffi; 00002 00003 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 00004 * Jimple, a 3-address code Java(TM) bytecode representation. * 00005 * Copyright (C) 1997, 1998 Raja Vallee-Rai (kor@sable.mcgill.ca) * 00006 * All rights reserved. * 00007 * * 00008 * This work was done as a project of the Sable Research Group, * 00009 * School of Computer Science, McGill University, Canada * 00010 * (http://www.sable.mcgill.ca/). It is understood that any * 00011 * modification not identified as such is not covered by the * 00012 * preceding statement. * 00013 * * 00014 * This work is free software; you can redistribute it and/or * 00015 * modify it under the terms of the GNU Library General Public * 00016 * License as published by the Free Software Foundation; either * 00017 * version 2 of the License, or (at your option) any later version. * 00018 * * 00019 * This work is distributed in the hope that it will be useful, * 00020 * but WITHOUT ANY WARRANTY; without even the implied warranty of * 00021 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * 00022 * Library General Public License for more details. * 00023 * * 00024 * You should have received a copy of the GNU Library General Public * 00025 * License along with this library; if not, write to the * 00026 * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * 00027 * Boston, MA 02111-1307, USA. * 00028 * * 00029 * Java is a trademark of Sun Microsystems, Inc. * 00030 * * 00031 * To submit a bug report, send a comment, or get the latest news on * 00032 * this project and other Sable Research Group projects, please * 00033 * visit the web site: http://www.sable.mcgill.ca/ * 00034 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ 00035 00036 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 00037 * Coffi, a bytecode parser for the Java(TM) language. * 00038 * Copyright (C) 1996, 1997 Clark Verbrugge (clump@sable.mcgill.ca). * 00039 * All rights reserved. * 00040 * * 00041 * This work was done as a project of the Sable Research Group, * 00042 * School of Computer Science, McGill University, Canada * 00043 * (http://www.sable.mcgill.ca/). It is understood that any * 00044 * modification not identified as such is not covered by the * 00045 * preceding statement. * 00046 * * 00047 * This work is free software; you can redistribute it and/or * 00048 * modify it under the terms of the GNU Library General Public * 00049 * License as published by the Free Software Foundation; either * 00050 * version 2 of the License, or (at your option) any later version. * 00051 * * 00052 * This work is distributed in the hope that it will be useful, * 00053 * but WITHOUT ANY WARRANTY; without even the implied warranty of * 00054 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * 00055 * Library General Public License for more details. * 00056 * * 00057 * You should have received a copy of the GNU Library General Public * 00058 * License along with this library; if not, write to the * 00059 * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * 00060 * Boston, MA 02111-1307, USA. * 00061 * * 00062 * Java is a trademark of Sun Microsystems, Inc. * 00063 * * 00064 * To submit a bug report, send a comment, or get the latest news on * 00065 * this project and other Sable Research Group projects, please * 00066 * visit the web site: http://www.sable.mcgill.ca/ * 00067 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ 00068 00069 /* 00070 Reference Version 00071 ----------------- 00072 This is the latest official version on which this file is based. 00073 The reference version is: $CoffiVersion: 1.1 $ 00074 $SootVersion: 1.beta.4 $ 00075 00076 Change History 00077 -------------- 00078 A) Notes: 00079 00080 Please use the following template. Most recent changes should 00081 appear at the top of the list. 00082 00083 - Modified on [date (March 1, 1900)] by [name]. [(*) if appropriate] 00084 [description of modification]. 00085 00086 Any Modification flagged with "(*)" was done as a project of the 00087 Sable Research Group, School of Computer Science, 00088 McGill University, Canada (http://www.sable.mcgill.ca/). 00089 00090 You should add your copyright, using the following template, at 00091 the top of this file, along with other copyrights. 00092 00093 * * 00094 * Modifications by [name] are * 00095 * Copyright (C) [year(s)] [your name (or company)]. All rights * 00096 * reserved. * 00097 * * 00098 00099 B) Changes: 00100 00101 - Modified on November 2, 1998 by Raja Vallee-Rai (kor@sable.mcgill.ca) (*) 00102 Repackaged all source files and performed extensive modifications. 00103 First initial release of Soot. 00104 00105 - Modified on September 3, 1998 by Raja Vallee-Rai (kor@sable.mcgill.ca). (*) 00106 Changed the toString() so that it does not throw exceptions when 00107 called in unusual places. 00108 00109 - Modified on 15-Jun-1998 by Raja Vallee-Rai (kor@sable.mcgill.ca). (*) 00110 First internal release (Version 0.1). 00111 */ 00112 00113 import java.io.*; 00114 /** Instruction subclasses are used to represent parsed bytecode; each 00115 * bytecode operation has a corresponding subclass of Instruction. 00116 * <p> 00117 * Each subclass is derived from one of 00118 * <ul><li>Instruction</li> 00119 * <li>Instruction_noargs (an Instruction with no embedded arguments)</li> 00120 * <li>Instruction_byte (an Instruction with a single byte data argument)</li> 00121 * <li>Instruction_bytevar (a byte argument specifying a local variable)</li> 00122 * <li>Instruction_byteindex (a byte argument specifying a constant pool index)</li> 00123 * <li>Instruction_int (an Instruction with a single short data argument)</li> 00124 * <li>Instruction_intvar (a short argument specifying a local variable)</li> 00125 * <li>Instruction_intindex (a short argument specifying a constant pool index)</li> 00126 * <li>Instruction_intbranch (a short argument specifying a code offset)</li> 00127 * <li>Instruction_longbranch (an int argument specifying a code offset)</li> 00128 * </ul> 00129 * @author Clark Verbrugge 00130 * @see Instruction 00131 * @see Instruction_noargs 00132 * @see Instruction_byte 00133 * @see Instruction_bytevar 00134 * @see Instruction_byteindex 00135 * @see Instruction_int 00136 * @see Instruction_intvar 00137 * @see Instruction_intindex 00138 * @see Instruction_intbranch 00139 * @see Instruction_longbranch 00140 * @see Instruction_Unknown 00141 */ 00142 class Instruction_intbranch extends Instruction { 00143 public int arg_i; 00144 public Instruction target; // pointer to target instruction 00145 public Instruction_intbranch(byte c) { super(c); branches = true; } 00146 // returns the array of instructions which might be the target of a 00147 // branch with this instruction, assuming the next instruction is next 00148 public Instruction[] branchpoints(Instruction next) { 00149 Instruction i[] = new Instruction[2]; 00150 i[0] = target; i[1] = next; 00151 return i; 00152 } 00153 public int compile(byte bc[],int index) { 00154 bc[index++] = code; 00155 if (target!=null) 00156 shortToBytes((short)(target.label-label),bc,index); 00157 else 00158 shortToBytes((short)(arg_i),bc,index); 00159 return index+2; 00160 } 00161 public int nextOffset(int curr) { return curr+3; } 00162 public void offsetToPointer(ByteCode bc) { 00163 target = bc.locateInst(arg_i+label); 00164 if (target==null) { 00165 System.out.println("Warning: can't locate target of instruction"); 00166 System.out.println(" which should be at byte address " + (label+arg_i)); 00167 } else 00168 target.labelled = true; 00169 } 00170 public int parse(byte bc[],int index) { 00171 arg_i = getShort(bc,index); 00172 return index+2; 00173 } 00174 public String toString(cp_info constant_pool[]) { 00175 return super.toString(constant_pool) + argsep + "[?]"; 00176 } 00177 }