bootstrapper.h revision e46be819fca9468a0cd4e74859ce0f778eb8ca60
1// Copyright 2006-2008 the V8 project authors. All rights reserved. 2// Redistribution and use in source and binary forms, with or without 3// modification, are permitted provided that the following conditions are 4// met: 5// 6// * Redistributions of source code must retain the above copyright 7// notice, this list of conditions and the following disclaimer. 8// * Redistributions in binary form must reproduce the above 9// copyright notice, this list of conditions and the following 10// disclaimer in the documentation and/or other materials provided 11// with the distribution. 12// * Neither the name of Google Inc. nor the names of its 13// contributors may be used to endorse or promote products derived 14// from this software without specific prior written permission. 15// 16// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 17// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 18// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 19// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 20// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 21// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 22// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 23// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 24// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 26// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27 28 29#ifndef V8_BOOTSTRAPPER_H_ 30#define V8_BOOTSTRAPPER_H_ 31 32namespace v8 { 33namespace internal { 34 35// The Boostrapper is the public interface for creating a JavaScript global 36// context. 37class Bootstrapper : public AllStatic { 38 public: 39 // Requires: Heap::Setup has been called. 40 static void Initialize(bool create_heap_objects); 41 static void TearDown(); 42 43 // Creates a JavaScript Global Context with initial object graph. 44 // The returned value is a global handle casted to V8Environment*. 45 static Handle<Context> CreateEnvironment( 46 Handle<Object> global_object, 47 v8::Handle<v8::ObjectTemplate> global_template, 48 v8::ExtensionConfiguration* extensions); 49 50 // Detach the environment from its outer global object. 51 static void DetachGlobal(Handle<Context> env); 52 53 // Traverses the pointers for memory management. 54 static void Iterate(ObjectVisitor* v); 55 56 // Accessors for the native scripts cache. Used in lazy loading. 57 static Handle<String> NativesSourceLookup(int index); 58 static bool NativesCacheLookup(Vector<const char> name, 59 Handle<JSFunction>* handle); 60 static void NativesCacheAdd(Vector<const char> name, Handle<JSFunction> fun); 61 62 // Append code that needs fixup at the end of boot strapping. 63 static void AddFixup(Code* code, MacroAssembler* masm); 64 65 // Tells whether bootstrapping is active. 66 static bool IsActive(); 67 68 // Encoding/decoding support for fixup flags. 69 class FixupFlagsUseCodeObject: public BitField<bool, 0, 1> {}; 70 class FixupFlagsArgumentsCount: public BitField<uint32_t, 1, 32-1> {}; 71 72 // Support for thread preemption. 73 static int ArchiveSpacePerThread(); 74 static char* ArchiveState(char* to); 75 static char* RestoreState(char* from); 76 static void FreeThreadResources(); 77 78 // This will allocate a char array that is deleted when V8 is shut down. 79 // It should only be used for strictly finite allocations. 80 static char* AllocateAutoDeletedArray(int bytes); 81}; 82 83 84class NativesExternalStringResource 85 : public v8::String::ExternalAsciiStringResource { 86 public: 87 explicit NativesExternalStringResource(const char* source); 88 89 const char* data() const { 90 return data_; 91 } 92 93 size_t length() const { 94 return length_; 95 } 96 private: 97 const char* data_; 98 size_t length_; 99}; 100 101}} // namespace v8::internal 102 103#endif // V8_BOOTSTRAPPER_H_ 104