• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 // Copyright 2009 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 #ifndef V8_REGEXP_STACK_H_
29 #define V8_REGEXP_STACK_H_
30 
31 namespace v8 {
32 namespace internal {
33 
34 class RegExpStack;
35 
36 // Maintains a per-v8thread stack area that can be used by irregexp
37 // implementation for its backtracking stack.
38 // Since there is only one stack area, the Irregexp implementation is not
39 // re-entrant. I.e., no regular expressions may be executed in the same thread
40 // during a preempted Irregexp execution.
41 class RegExpStackScope {
42  public:
43   // Create and delete an instance to control the life-time of a growing stack.
44 
45   // Initializes the stack memory area if necessary.
46   explicit RegExpStackScope(Isolate* isolate);
47   ~RegExpStackScope();  // Releases the stack if it has grown.
48 
stack()49   RegExpStack* stack() const { return regexp_stack_; }
50 
51  private:
52   RegExpStack* regexp_stack_;
53 
54   DISALLOW_COPY_AND_ASSIGN(RegExpStackScope);
55 };
56 
57 
58 class RegExpStack {
59  public:
60   // Number of allocated locations on the stack below the limit.
61   // No sequence of pushes must be longer that this without doing a stack-limit
62   // check.
63   static const int kStackLimitSlack = 32;
64 
65   // Gives the top of the memory used as stack.
stack_base()66   Address stack_base() {
67     ASSERT(thread_local_.memory_size_ != 0);
68     return thread_local_.memory_ + thread_local_.memory_size_;
69   }
70 
71   // The total size of the memory allocated for the stack.
stack_capacity()72   size_t stack_capacity() { return thread_local_.memory_size_; }
73 
74   // If the stack pointer gets below the limit, we should react and
75   // either grow the stack or report an out-of-stack exception.
76   // There is only a limited number of locations below the stack limit,
77   // so users of the stack should check the stack limit during any
78   // sequence of pushes longer that this.
limit_address()79   Address* limit_address() { return &(thread_local_.limit_); }
80 
81   // Ensures that there is a memory area with at least the specified size.
82   // If passing zero, the default/minimum size buffer is allocated.
83   Address EnsureCapacity(size_t size);
84 
85   // Thread local archiving.
ArchiveSpacePerThread()86   static int ArchiveSpacePerThread() {
87     return static_cast<int>(sizeof(ThreadLocal));
88   }
89   char* ArchiveStack(char* to);
90   char* RestoreStack(char* from);
FreeThreadResources()91   void FreeThreadResources() { thread_local_.Free(); }
92  private:
93   RegExpStack();
94   ~RegExpStack();
95 
96   // Artificial limit used when no memory has been allocated.
97   static const uintptr_t kMemoryTop = static_cast<uintptr_t>(-1);
98 
99   // Minimal size of allocated stack area.
100   static const size_t kMinimumStackSize = 1 * KB;
101 
102   // Maximal size of allocated stack area.
103   static const size_t kMaximumStackSize = 64 * MB;
104 
105   // Structure holding the allocated memory, size and limit.
106   struct ThreadLocal {
ThreadLocalThreadLocal107     ThreadLocal() { Clear(); }
108     // If memory_size_ > 0 then memory_ must be non-NULL.
109     Address memory_;
110     size_t memory_size_;
111     Address limit_;
ClearThreadLocal112     void Clear() {
113       memory_ = NULL;
114       memory_size_ = 0;
115       limit_ = reinterpret_cast<Address>(kMemoryTop);
116     }
117     void Free();
118   };
119 
120   // Address of allocated memory.
memory_address()121   Address memory_address() {
122     return reinterpret_cast<Address>(&thread_local_.memory_);
123   }
124 
125   // Address of size of allocated memory.
memory_size_address()126   Address memory_size_address() {
127     return reinterpret_cast<Address>(&thread_local_.memory_size_);
128   }
129 
130   // Resets the buffer if it has grown beyond the default/minimum size.
131   // After this, the buffer is either the default size, or it is empty, so
132   // you have to call EnsureCapacity before using it again.
133   void Reset();
134 
135   ThreadLocal thread_local_;
136   Isolate* isolate_;
137 
138   friend class ExternalReference;
139   friend class Isolate;
140   friend class RegExpStackScope;
141 
142   DISALLOW_COPY_AND_ASSIGN(RegExpStack);
143 };
144 
145 }}  // namespace v8::internal
146 
147 #endif  // V8_REGEXP_STACK_H_
148