OLD | NEW |
1 // Copyright 2010 the V8 project authors. All rights reserved. | 1 // Copyright 2013 the V8 project authors. All rights reserved. |
2 // Redistribution and use in source and binary forms, with or without | 2 // Redistribution and use in source and binary forms, with or without |
3 // modification, are permitted provided that the following conditions are | 3 // modification, are permitted provided that the following conditions are |
4 // met: | 4 // met: |
5 // | 5 // |
6 // * Redistributions of source code must retain the above copyright | 6 // * Redistributions of source code must retain the above copyright |
7 // notice, this list of conditions and the following disclaimer. | 7 // notice, this list of conditions and the following disclaimer. |
8 // * Redistributions in binary form must reproduce the above | 8 // * Redistributions in binary form must reproduce the above |
9 // copyright notice, this list of conditions and the following | 9 // copyright notice, this list of conditions and the following |
10 // disclaimer in the documentation and/or other materials provided | 10 // disclaimer in the documentation and/or other materials provided |
11 // with the distribution. | 11 // with the distribution. |
12 // * Neither the name of Google Inc. nor the names of its | 12 // * Neither the name of Google Inc. nor the names of its |
13 // contributors may be used to endorse or promote products derived | 13 // contributors may be used to endorse or promote products derived |
14 // from this software without specific prior written permission. | 14 // from this software without specific prior written permission. |
15 // | 15 // |
16 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | 16 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
17 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | 17 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
18 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR | 18 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
19 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | 19 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
20 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | 20 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
21 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT | 21 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
22 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | 22 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
23 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | 23 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
24 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | 24 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
25 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | 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. | 26 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
27 | 27 |
28 #ifndef V8_V8_TEST_H_ | 28 #ifndef V8_V8_PLATFORM_H_ |
29 #define V8_V8_TEST_H_ | 29 #define V8_V8_PLATFORM_H_ |
30 | 30 |
31 #include "v8.h" | 31 #include "v8.h" |
32 | 32 |
33 /** | |
34 * Testing support for the V8 JavaScript engine. | |
35 */ | |
36 namespace v8 { | 33 namespace v8 { |
37 | 34 |
38 class V8_EXPORT Testing { | 35 /** |
| 36 * A Task represents a unit of work. |
| 37 */ |
| 38 class Task { |
39 public: | 39 public: |
40 enum StressType { | 40 virtual ~Task() {} |
41 kStressTypeOpt, | 41 |
42 kStressTypeDeopt | 42 virtual void Run() = 0; |
| 43 }; |
| 44 |
| 45 /** |
| 46 * V8 Platform abstraction layer. |
| 47 * |
| 48 * The embedder has to provide an implementation of this interface before |
| 49 * initializing the rest of V8. |
| 50 */ |
| 51 class Platform { |
| 52 public: |
| 53 /** |
| 54 * This enum is used to indicate whether a task is potentially long running, |
| 55 * or causes a long wait. The embedder might want to use this hint to decide |
| 56 * whether to execute the task on a dedicated thread. |
| 57 */ |
| 58 enum ExpectedRuntime { |
| 59 kShortRunningTask, |
| 60 kLongRunningTask |
43 }; | 61 }; |
44 | 62 |
45 /** | 63 /** |
46 * Set the type of stressing to do. The default if not set is kStressTypeOpt. | 64 * Schedules a task to be invoked on a background thread. |expected_runtime| |
| 65 * indicates that the task will run a long time. The Platform implementation |
| 66 * takes ownership of |task|. There is no guarantee about order of execution |
| 67 * of tasks wrt order of scheduling, nor is there a guarantee about the |
| 68 * thread the task will be run on. |
47 */ | 69 */ |
48 static void SetStressRunType(StressType type); | 70 virtual void CallOnBackgroundThread(Task* task, |
| 71 ExpectedRuntime expected_runtime) = 0; |
49 | 72 |
50 /** | 73 /** |
51 * Get the number of runs of a given test that is required to get the full | 74 * Schedules a task to be invoked on a foreground thread wrt a specific |
52 * stress coverage. | 75 * |isolate|. Tasks posted for the same isolate should be execute in order of |
| 76 * scheduling. The definition of "foreground" is opaque to V8. |
53 */ | 77 */ |
54 static int GetStressRuns(); | 78 virtual void CallOnForegroundThread(Isolate* isolate, Task* task) = 0; |
55 | 79 |
56 /** | 80 protected: |
57 * Indicate the number of the run which is about to start. The value of run | 81 virtual ~Platform() {} |
58 * should be between 0 and one less than the result from GetStressRuns() | |
59 */ | |
60 static void PrepareStressRun(int run); | |
61 | |
62 /** | |
63 * Force deoptimization of all functions. | |
64 */ | |
65 static void DeoptimizeAll(); | |
66 }; | 82 }; |
67 | 83 |
68 | |
69 } // namespace v8 | 84 } // namespace v8 |
70 | 85 |
71 #endif // V8_V8_TEST_H_ | 86 #endif // V8_V8_PLATFORM_H_ |
OLD | NEW |