| OLD | NEW |
| 1 // Copyright 2012 the V8 project authors. All rights reserved. | 1 // Copyright 2012 the V8 project authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 /** \mainpage V8 API Reference Guide | 5 /** \mainpage V8 API Reference Guide |
| 6 * | 6 * |
| 7 * V8 is Google's open source JavaScript engine. | 7 * V8 is Google's open source JavaScript engine. |
| 8 * | 8 * |
| 9 * This set of documents provides reference material generated from the | 9 * This set of documents provides reference material generated from the |
| 10 * V8 header file, include/v8.h. | 10 * V8 header file, include/v8.h. |
| (...skipping 4510 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 4521 * \param return_addr_location points to a location on stack where the machine | 4521 * \param return_addr_location points to a location on stack where the machine |
| 4522 * return address resides. This can be used to identify the caller of | 4522 * return address resides. This can be used to identify the caller of |
| 4523 * \p function, and/or modified to divert execution when \p function exits. | 4523 * \p function, and/or modified to divert execution when \p function exits. |
| 4524 * | 4524 * |
| 4525 * \note the entry hook must not cause garbage collection. | 4525 * \note the entry hook must not cause garbage collection. |
| 4526 */ | 4526 */ |
| 4527 typedef void (*FunctionEntryHook)(uintptr_t function, | 4527 typedef void (*FunctionEntryHook)(uintptr_t function, |
| 4528 uintptr_t return_addr_location); | 4528 uintptr_t return_addr_location); |
| 4529 | 4529 |
| 4530 /** | 4530 /** |
| 4531 * A JIT code event is issued each time code is added, moved or removed. | 4531 * A JIT code event is issued each time code is added or moved. |
| 4532 * | |
| 4533 * \note removal events are not currently issued. | |
| 4534 */ | 4532 */ |
| 4535 struct JitCodeEvent { | 4533 struct JitCodeEvent { |
| 4536 enum EventType { | 4534 enum EventType { |
| 4537 CODE_ADDED, | 4535 CODE_ADDED, |
| 4538 CODE_MOVED, | 4536 CODE_MOVED, |
| 4539 CODE_REMOVED, | |
| 4540 CODE_ADD_LINE_POS_INFO, | 4537 CODE_ADD_LINE_POS_INFO, |
| 4541 CODE_START_LINE_INFO_RECORDING, | 4538 CODE_START_LINE_INFO_RECORDING, |
| 4542 CODE_END_LINE_INFO_RECORDING | 4539 CODE_END_LINE_INFO_RECORDING |
| 4543 }; | 4540 }; |
| 4544 // Definition of the code position type. The "POSITION" type means the place | 4541 // Definition of the code position type. The "POSITION" type means the place |
| 4545 // in the source code which are of interest when making stack traces to | 4542 // in the source code which are of interest when making stack traces to |
| 4546 // pin-point the source location of a stack frame as close as possible. | 4543 // pin-point the source location of a stack frame as close as possible. |
| 4547 // The "STATEMENT_POSITION" means the place at the beginning of each | 4544 // The "STATEMENT_POSITION" means the place at the beginning of each |
| 4548 // statement, and is used to indicate possible break locations. | 4545 // statement, and is used to indicate possible break locations. |
| 4549 enum PositionType { POSITION, STATEMENT_POSITION }; | 4546 enum PositionType { POSITION, STATEMENT_POSITION }; |
| (...skipping 101 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 4651 * The optional entry_hook allows the host application to provide the | 4648 * The optional entry_hook allows the host application to provide the |
| 4652 * address of a function that's invoked on entry to every V8-generated | 4649 * address of a function that's invoked on entry to every V8-generated |
| 4653 * function. Note that entry_hook is invoked at the very start of each | 4650 * function. Note that entry_hook is invoked at the very start of each |
| 4654 * generated function. Furthermore, if an entry_hook is given, V8 will | 4651 * generated function. Furthermore, if an entry_hook is given, V8 will |
| 4655 * always run without a context snapshot. | 4652 * always run without a context snapshot. |
| 4656 */ | 4653 */ |
| 4657 FunctionEntryHook entry_hook; | 4654 FunctionEntryHook entry_hook; |
| 4658 | 4655 |
| 4659 /** | 4656 /** |
| 4660 * Allows the host application to provide the address of a function that is | 4657 * Allows the host application to provide the address of a function that is |
| 4661 * notified each time code is added, moved or removed. | 4658 * notified each time code is added or moved. |
| 4662 */ | 4659 */ |
| 4663 JitCodeEventHandler code_event_handler; | 4660 JitCodeEventHandler code_event_handler; |
| 4664 | 4661 |
| 4665 /** | 4662 /** |
| 4666 * ResourceConstraints to use for the new Isolate. | 4663 * ResourceConstraints to use for the new Isolate. |
| 4667 */ | 4664 */ |
| 4668 ResourceConstraints constraints; | 4665 ResourceConstraints constraints; |
| 4669 | 4666 |
| 4670 /** | 4667 /** |
| 4671 * Explicitly specify a startup snapshot blob. The embedder owns the blob. | 4668 * Explicitly specify a startup snapshot blob. The embedder owns the blob. |
| (...skipping 487 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 5159 * of context disposals - including this one - since the last time | 5156 * of context disposals - including this one - since the last time |
| 5160 * V8 had a chance to clean up. | 5157 * V8 had a chance to clean up. |
| 5161 * | 5158 * |
| 5162 * The optional parameter |dependant_context| specifies whether the disposed | 5159 * The optional parameter |dependant_context| specifies whether the disposed |
| 5163 * context was depending on state from other contexts or not. | 5160 * context was depending on state from other contexts or not. |
| 5164 */ | 5161 */ |
| 5165 int ContextDisposedNotification(bool dependant_context = true); | 5162 int ContextDisposedNotification(bool dependant_context = true); |
| 5166 | 5163 |
| 5167 /** | 5164 /** |
| 5168 * Allows the host application to provide the address of a function that is | 5165 * Allows the host application to provide the address of a function that is |
| 5169 * notified each time code is added, moved or removed. | 5166 * notified each time code is added or moved. |
| 5170 * | 5167 * |
| 5171 * \param options options for the JIT code event handler. | 5168 * \param options options for the JIT code event handler. |
| 5172 * \param event_handler the JIT code event handler, which will be invoked | 5169 * \param event_handler the JIT code event handler, which will be invoked |
| 5173 * each time code is added, moved or removed. | 5170 * each time code is added or moved. |
| 5174 * \note \p event_handler won't get notified of existent code. | 5171 * \note \p event_handler won't get notified of existent code. |
| 5175 * \note since code removal notifications are not currently issued, the | 5172 * \note since code removal notifications are not currently issued, the |
| 5176 * \p event_handler may get notifications of code that overlaps earlier | 5173 * \p event_handler may get notifications of code that overlaps earlier |
| 5177 * code notifications. This happens when code areas are reused, and the | 5174 * code notifications. This happens when code areas are reused, and the |
| 5178 * earlier overlapping code areas should therefore be discarded. | 5175 * earlier overlapping code areas should therefore be discarded. |
| 5179 * \note the events passed to \p event_handler and the strings they point to | 5176 * \note the events passed to \p event_handler and the strings they point to |
| 5180 * are not guaranteed to live past each call. The \p event_handler must | 5177 * are not guaranteed to live past each call. The \p event_handler must |
| 5181 * copy strings and other parameters it needs to keep around. | 5178 * copy strings and other parameters it needs to keep around. |
| 5182 * \note the set of events declared in JitCodeEvent::EventType is expected to | 5179 * \note the set of events declared in JitCodeEvent::EventType is expected to |
| 5183 * grow over time, and the JitCodeEvent structure is expected to accrue | 5180 * grow over time, and the JitCodeEvent structure is expected to accrue |
| (...skipping 2356 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 7540 */ | 7537 */ |
| 7541 | 7538 |
| 7542 | 7539 |
| 7543 } // namespace v8 | 7540 } // namespace v8 |
| 7544 | 7541 |
| 7545 | 7542 |
| 7546 #undef TYPE_CHECK | 7543 #undef TYPE_CHECK |
| 7547 | 7544 |
| 7548 | 7545 |
| 7549 #endif // V8_H_ | 7546 #endif // V8_H_ |
| OLD | NEW |