interpreter/Interpreter.h

   1 /*
   2  * Copyright (C) 2008 Apple Inc. All rights reserved.
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions
   6  * are met:
   7  *
   8  * 1.  Redistributions of source code must retain the above copyright
   9  *     notice, this list of conditions and the following disclaimer.
  10  * 2.  Redistributions in binary form must reproduce the above copyright
  11  *     notice, this list of conditions and the following disclaimer in the
  12  *     documentation and/or other materials provided with the distribution.
  13  * 3.  Neither the name of Apple Computer, Inc. ("Apple") nor the names of
  14  *     its contributors may be used to endorse or promote products derived
  15  *     from this software without specific prior written permission.
  16  *
  17  * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
  18  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  19  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  20  * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
  21  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  22  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  23  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  24  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27  */
  28
  29 #ifndef Interpreter_h
  30 #define Interpreter_h
  31
  32 #include "ArgList.h"
  33 #include "JSCell.h"
  34 #include "JSValue.h"
  35 #include "JSObject.h"
  36 #include "Opcode.h"
  37 #include "RegisterFile.h"
  38
  39 #include <wtf/HashMap.h>
  40
  41 namespace JSC {
  42
  43     class CodeBlock;
  44     class EvalExecutable;
  45     class FunctionExecutable;
  46     class JSFunction;
  47     class JSGlobalObject;
  48     class ProgramExecutable;
  49     class Register;
  50     class ScopeChainNode;
  51     class SamplingTool;
  52     struct CallFrameClosure;
  53     struct HandlerInfo;
  54     struct Instruction;
  55
  56     enum DebugHookID {
  57         WillExecuteProgram,
  58         DidExecuteProgram,
  59         DidEnterCallFrame,
  60         DidReachBreakpoint,
  61         WillLeaveCallFrame,
  62         WillExecuteStatement
  63     };
  64
  65     // We use a smaller reentrancy limit on iPhone because of the high amount of
  66     // stack space required on the web thread.
  67     enum { MaxLargeThreadReentryDepth = 93, MaxSmallThreadReentryDepth = 32 };
  68
  69     class Interpreter {
  70         WTF_MAKE_FAST_ALLOCATED;
  71         friend class JIT;
  72         friend class CachedCall;
  73     public:
  74         Interpreter(JSGlobalData&);
  75
  76         RegisterFile& registerFile() { return m_registerFile; }
  77
  78         Opcode getOpcode(OpcodeID id)
  79         {
  80             #if ENABLE(COMPUTED_GOTO_INTERPRETER)
  81                 return m_opcodeTable[id];
  82             #else
  83                 return id;
  84             #endif
  85         }
  86
  87         OpcodeID getOpcodeID(Opcode opcode)
  88         {
  89             #if ENABLE(COMPUTED_GOTO_INTERPRETER)
  90                 ASSERT(isOpcode(opcode));
  91                 return m_opcodeIDTable.get(opcode);
  92             #else
  93                 return opcode;
  94             #endif
  95         }
  96
  97         bool isOpcode(Opcode);
  98
  99         JSValue execute(ProgramExecutable*, CallFrame*, ScopeChainNode*, JSObject* thisObj);
 100         JSValue executeCall(CallFrame*, JSObject* function, CallType, const CallData&, JSValue thisValue, const ArgList&);
 101         JSObject* executeConstruct(CallFrame*, JSObject* function, ConstructType, const ConstructData&, const ArgList&);
 102         JSValue execute(EvalExecutable* evalNode, CallFrame* exec, JSObject* thisObj, ScopeChainNode* scopeChain);
 103
 104         JSValue retrieveArguments(CallFrame*, JSFunction*) const;
 105         JSValue retrieveCaller(CallFrame*, JSFunction*) const;
 106         void retrieveLastCaller(CallFrame*, int& lineNumber, intptr_t& sourceID, UString& sourceURL, JSValue& function) const;
 107
 108         void getArgumentsData(CallFrame*, JSFunction*&, ptrdiff_t& firstParameterIndex, Register*& argv, int& argc);
 109
 110         SamplingTool* sampler() { return m_sampler.get(); }
 111
 112         NEVER_INLINE JSValue callEval(CallFrame*, RegisterFile*, Register* argv, int argc, int registerOffset);
 113         NEVER_INLINE HandlerInfo* throwException(CallFrame*&, JSValue&, unsigned bytecodeOffset);
 114         NEVER_INLINE void debug(CallFrame*, DebugHookID, int firstLine, int lastLine);
 115
 116         void dumpSampleData(ExecState* exec);
 117         void startSampling();
 118         void stopSampling();
 119     private:
 120         enum ExecutionFlag { Normal, InitializeAndReturn };
 121
 122         CallFrameClosure prepareForRepeatCall(FunctionExecutable*, CallFrame*, JSFunction*, int argCount, ScopeChainNode*);
 123         void endRepeatCall(CallFrameClosure&);
 124         JSValue execute(CallFrameClosure&);
 125
 126         JSValue execute(EvalExecutable*, CallFrame*, JSObject* thisObject, int globalRegisterOffset, ScopeChainNode*);
 127
 128 #if ENABLE(INTERPRETER)
 129         NEVER_INLINE bool resolve(CallFrame*, Instruction*, JSValue& exceptionValue);
 130         NEVER_INLINE bool resolveSkip(CallFrame*, Instruction*, JSValue& exceptionValue);
 131         NEVER_INLINE bool resolveGlobal(CallFrame*, Instruction*, JSValue& exceptionValue);
 132         NEVER_INLINE bool resolveGlobalDynamic(CallFrame*, Instruction*, JSValue& exceptionValue);
 133         NEVER_INLINE void resolveBase(CallFrame*, Instruction* vPC);
 134         NEVER_INLINE bool resolveBaseAndProperty(CallFrame*, Instruction*, JSValue& exceptionValue);
 135         NEVER_INLINE ScopeChainNode* createExceptionScope(CallFrame*, const Instruction* vPC);
 136
 137         void tryCacheGetByID(CallFrame*, CodeBlock*, Instruction*, JSValue baseValue, const Identifier& propertyName, const PropertySlot&);
 138         void uncacheGetByID(CodeBlock*, Instruction* vPC);
 139         void tryCachePutByID(CallFrame*, CodeBlock*, Instruction*, JSValue baseValue, const PutPropertySlot&);
 140         void uncachePutByID(CodeBlock*, Instruction* vPC);
 141 #endif // ENABLE(INTERPRETER)
 142
 143         NEVER_INLINE bool unwindCallFrame(CallFrame*&, JSValue, unsigned& bytecodeOffset, CodeBlock*&);
 144
 145         static ALWAYS_INLINE CallFrame* slideRegisterWindowForCall(CodeBlock*, RegisterFile*, CallFrame*, size_t registerOffset, int argc);
 146
 147         static CallFrame* findFunctionCallFrame(CallFrame*, JSFunction*);
 148
 149         JSValue privateExecute(ExecutionFlag, RegisterFile*, CallFrame*);
 150
 151         void dumpCallFrame(CallFrame*);
 152         void dumpRegisters(CallFrame*);
 153
 154         bool isCallBytecode(Opcode opcode) { return opcode == getOpcode(op_call) || opcode == getOpcode(op_construct) || opcode == getOpcode(op_call_eval); }
 155
 156         void enableSampler();
 157         int m_sampleEntryDepth;
 158         OwnPtr<SamplingTool> m_sampler;
 159
 160         int m_reentryDepth;
 161
 162         RegisterFile m_registerFile;
 163
 164 #if ENABLE(COMPUTED_GOTO_INTERPRETER)
 165         Opcode m_opcodeTable[numOpcodeIDs]; // Maps OpcodeID => Opcode for compiling
 166         HashMap<Opcode, OpcodeID> m_opcodeIDTable; // Maps Opcode => OpcodeID for decompiling
 167 #endif
 168     };
 169
 170 } // namespace JSC
 171
 172 #endif // Interpreter_h