2012-02-02 20:18:19 +00:00
|
|
|
#!/usr/bin/env python
|
|
|
|
|
|
|
|
#
|
|
|
|
# Copyright 2012 the V8 project authors. All rights reserved.
|
|
|
|
# Redistribution and use in source and binary forms, with or without
|
|
|
|
# modification, are permitted provided that the following conditions are
|
|
|
|
# met:
|
|
|
|
#
|
|
|
|
# * Redistributions of source code must retain the above copyright
|
|
|
|
# notice, this list of conditions and the following disclaimer.
|
|
|
|
# * Redistributions in binary form must reproduce the above
|
|
|
|
# copyright notice, this list of conditions and the following
|
|
|
|
# disclaimer in the documentation and/or other materials provided
|
|
|
|
# with the distribution.
|
|
|
|
# * Neither the name of Google Inc. nor the names of its
|
|
|
|
# contributors may be used to endorse or promote products derived
|
|
|
|
# from this software without specific prior written permission.
|
|
|
|
#
|
|
|
|
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
|
|
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
|
|
# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
|
|
# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
|
|
# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
|
|
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
|
|
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
|
|
# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
|
|
# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
|
|
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
|
|
# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
#
|
|
|
|
|
|
|
|
#
|
|
|
|
# Emits a C++ file to be compiled and linked into libv8 to support postmortem
|
|
|
|
# debugging tools. Most importantly, this tool emits constants describing V8
|
|
|
|
# internals:
|
|
|
|
#
|
|
|
|
# v8dbg_type_CLASS__TYPE = VALUE Describes class type values
|
|
|
|
# v8dbg_class_CLASS__FIELD__TYPE = OFFSET Describes class fields
|
|
|
|
# v8dbg_parent_CLASS__PARENT Describes class hierarchy
|
|
|
|
# v8dbg_frametype_NAME = VALUE Describes stack frame values
|
|
|
|
# v8dbg_off_fp_NAME = OFFSET Frame pointer offsets
|
|
|
|
# v8dbg_prop_NAME = OFFSET Object property offsets
|
|
|
|
# v8dbg_NAME = VALUE Miscellaneous values
|
|
|
|
#
|
|
|
|
# These constants are declared as global integers so that they'll be present in
|
|
|
|
# the generated libv8 binary.
|
|
|
|
#
|
|
|
|
|
2019-02-19 08:28:26 +00:00
|
|
|
# for py2/py3 compatibility
|
|
|
|
from __future__ import print_function
|
|
|
|
|
2012-02-02 20:18:19 +00:00
|
|
|
import re
|
|
|
|
import sys
|
|
|
|
|
|
|
|
#
|
2016-06-10 04:06:16 +00:00
|
|
|
# Miscellaneous constants such as tags and masks used for object identification,
|
|
|
|
# enumeration values used as indexes in internal tables, etc..
|
2012-02-02 20:18:19 +00:00
|
|
|
#
|
|
|
|
consts_misc = [
|
|
|
|
{ 'name': 'FirstNonstringType', 'value': 'FIRST_NONSTRING_TYPE' },
|
2016-11-21 19:33:33 +00:00
|
|
|
{ 'name': 'APIObjectType', 'value': 'JS_API_OBJECT_TYPE' },
|
|
|
|
{ 'name': 'SpecialAPIObjectType', 'value': 'JS_SPECIAL_API_OBJECT_TYPE' },
|
2012-02-02 20:18:19 +00:00
|
|
|
|
2018-07-28 03:09:39 +00:00
|
|
|
{ 'name': 'FirstContextType', 'value': 'FIRST_CONTEXT_TYPE' },
|
|
|
|
{ 'name': 'LastContextType', 'value': 'LAST_CONTEXT_TYPE' },
|
|
|
|
|
2012-02-02 20:18:19 +00:00
|
|
|
{ 'name': 'IsNotStringMask', 'value': 'kIsNotStringMask' },
|
|
|
|
{ 'name': 'StringTag', 'value': 'kStringTag' },
|
|
|
|
|
|
|
|
{ 'name': 'StringEncodingMask', 'value': 'kStringEncodingMask' },
|
|
|
|
{ 'name': 'TwoByteStringTag', 'value': 'kTwoByteStringTag' },
|
2014-09-10 12:56:19 +00:00
|
|
|
{ 'name': 'OneByteStringTag', 'value': 'kOneByteStringTag' },
|
2012-02-02 20:18:19 +00:00
|
|
|
|
|
|
|
{ 'name': 'StringRepresentationMask',
|
|
|
|
'value': 'kStringRepresentationMask' },
|
|
|
|
{ 'name': 'SeqStringTag', 'value': 'kSeqStringTag' },
|
|
|
|
{ 'name': 'ConsStringTag', 'value': 'kConsStringTag' },
|
|
|
|
{ 'name': 'ExternalStringTag', 'value': 'kExternalStringTag' },
|
2013-10-14 13:08:52 +00:00
|
|
|
{ 'name': 'SlicedStringTag', 'value': 'kSlicedStringTag' },
|
2017-08-17 13:16:14 +00:00
|
|
|
{ 'name': 'ThinStringTag', 'value': 'kThinStringTag' },
|
2012-02-02 20:18:19 +00:00
|
|
|
|
|
|
|
{ 'name': 'HeapObjectTag', 'value': 'kHeapObjectTag' },
|
|
|
|
{ 'name': 'HeapObjectTagMask', 'value': 'kHeapObjectTagMask' },
|
|
|
|
{ 'name': 'SmiTag', 'value': 'kSmiTag' },
|
|
|
|
{ 'name': 'SmiTagMask', 'value': 'kSmiTagMask' },
|
|
|
|
{ 'name': 'SmiValueShift', 'value': 'kSmiTagSize' },
|
2012-12-28 13:06:08 +00:00
|
|
|
{ 'name': 'SmiShiftSize', 'value': 'kSmiShiftSize' },
|
2012-02-02 20:18:19 +00:00
|
|
|
|
2014-07-23 10:48:16 +00:00
|
|
|
{ 'name': 'OddballFalse', 'value': 'Oddball::kFalse' },
|
|
|
|
{ 'name': 'OddballTrue', 'value': 'Oddball::kTrue' },
|
|
|
|
{ 'name': 'OddballTheHole', 'value': 'Oddball::kTheHole' },
|
|
|
|
{ 'name': 'OddballNull', 'value': 'Oddball::kNull' },
|
2016-02-22 08:15:33 +00:00
|
|
|
{ 'name': 'OddballArgumentsMarker', 'value': 'Oddball::kArgumentsMarker' },
|
2014-07-23 10:48:16 +00:00
|
|
|
{ 'name': 'OddballUndefined', 'value': 'Oddball::kUndefined' },
|
|
|
|
{ 'name': 'OddballUninitialized', 'value': 'Oddball::kUninitialized' },
|
|
|
|
{ 'name': 'OddballOther', 'value': 'Oddball::kOther' },
|
|
|
|
{ 'name': 'OddballException', 'value': 'Oddball::kException' },
|
|
|
|
|
2017-01-16 14:24:50 +00:00
|
|
|
{ 'name': 'prop_kind_Data',
|
|
|
|
'value': 'kData' },
|
|
|
|
{ 'name': 'prop_kind_Accessor',
|
|
|
|
'value': 'kAccessor' },
|
|
|
|
{ 'name': 'prop_kind_mask',
|
|
|
|
'value': 'PropertyDetails::KindField::kMask' },
|
2017-04-26 12:24:52 +00:00
|
|
|
{ 'name': 'prop_location_Descriptor',
|
|
|
|
'value': 'kDescriptor' },
|
|
|
|
{ 'name': 'prop_location_Field',
|
|
|
|
'value': 'kField' },
|
|
|
|
{ 'name': 'prop_location_mask',
|
|
|
|
'value': 'PropertyDetails::LocationField::kMask' },
|
|
|
|
{ 'name': 'prop_location_shift',
|
|
|
|
'value': 'PropertyDetails::LocationField::kShift' },
|
|
|
|
{ 'name': 'prop_attributes_NONE', 'value': 'NONE' },
|
|
|
|
{ 'name': 'prop_attributes_READ_ONLY', 'value': 'READ_ONLY' },
|
|
|
|
{ 'name': 'prop_attributes_DONT_ENUM', 'value': 'DONT_ENUM' },
|
|
|
|
{ 'name': 'prop_attributes_DONT_DELETE', 'value': 'DONT_DELETE' },
|
|
|
|
{ 'name': 'prop_attributes_mask',
|
|
|
|
'value': 'PropertyDetails::AttributesField::kMask' },
|
|
|
|
{ 'name': 'prop_attributes_shift',
|
|
|
|
'value': 'PropertyDetails::AttributesField::kShift' },
|
2014-07-23 10:48:16 +00:00
|
|
|
{ 'name': 'prop_index_mask',
|
|
|
|
'value': 'PropertyDetails::FieldIndexField::kMask' },
|
|
|
|
{ 'name': 'prop_index_shift',
|
|
|
|
'value': 'PropertyDetails::FieldIndexField::kShift' },
|
2015-11-11 19:13:45 +00:00
|
|
|
{ 'name': 'prop_representation_mask',
|
|
|
|
'value': 'PropertyDetails::RepresentationField::kMask' },
|
|
|
|
{ 'name': 'prop_representation_shift',
|
|
|
|
'value': 'PropertyDetails::RepresentationField::kShift' },
|
|
|
|
{ 'name': 'prop_representation_smi',
|
|
|
|
'value': 'Representation::Kind::kSmi' },
|
|
|
|
{ 'name': 'prop_representation_double',
|
|
|
|
'value': 'Representation::Kind::kDouble' },
|
|
|
|
{ 'name': 'prop_representation_heapobject',
|
|
|
|
'value': 'Representation::Kind::kHeapObject' },
|
|
|
|
{ 'name': 'prop_representation_tagged',
|
|
|
|
'value': 'Representation::Kind::kTagged' },
|
2012-02-02 20:18:19 +00:00
|
|
|
|
2013-10-14 13:08:52 +00:00
|
|
|
{ 'name': 'prop_desc_key',
|
2017-02-09 23:42:21 +00:00
|
|
|
'value': 'DescriptorArray::kEntryKeyIndex' },
|
2013-10-14 13:08:52 +00:00
|
|
|
{ 'name': 'prop_desc_details',
|
2017-02-09 23:42:21 +00:00
|
|
|
'value': 'DescriptorArray::kEntryDetailsIndex' },
|
2013-10-14 13:08:52 +00:00
|
|
|
{ 'name': 'prop_desc_value',
|
2017-02-09 23:42:21 +00:00
|
|
|
'value': 'DescriptorArray::kEntryValueIndex' },
|
2013-10-14 13:08:52 +00:00
|
|
|
{ 'name': 'prop_desc_size',
|
2017-02-09 23:42:21 +00:00
|
|
|
'value': 'DescriptorArray::kEntrySize' },
|
2013-10-14 13:08:52 +00:00
|
|
|
|
2014-07-23 10:48:16 +00:00
|
|
|
{ 'name': 'elements_fast_holey_elements',
|
2017-06-30 11:26:14 +00:00
|
|
|
'value': 'HOLEY_ELEMENTS' },
|
2014-07-23 10:48:16 +00:00
|
|
|
{ 'name': 'elements_fast_elements',
|
2017-06-30 11:26:14 +00:00
|
|
|
'value': 'PACKED_ELEMENTS' },
|
2014-07-23 10:48:16 +00:00
|
|
|
{ 'name': 'elements_dictionary_elements',
|
|
|
|
'value': 'DICTIONARY_ELEMENTS' },
|
|
|
|
|
|
|
|
{ 'name': 'bit_field2_elements_kind_mask',
|
2015-02-02 21:21:29 +00:00
|
|
|
'value': 'Map::ElementsKindBits::kMask' },
|
2014-07-23 10:48:16 +00:00
|
|
|
{ 'name': 'bit_field2_elements_kind_shift',
|
2015-02-02 21:21:29 +00:00
|
|
|
'value': 'Map::ElementsKindBits::kShift' },
|
2017-12-07 11:03:41 +00:00
|
|
|
{ 'name': 'bit_field3_is_dictionary_map_shift',
|
|
|
|
'value': 'Map::IsDictionaryMapBit::kShift' },
|
2015-11-11 19:13:45 +00:00
|
|
|
{ 'name': 'bit_field3_number_of_own_descriptors_mask',
|
|
|
|
'value': 'Map::NumberOfOwnDescriptorsBits::kMask' },
|
|
|
|
{ 'name': 'bit_field3_number_of_own_descriptors_shift',
|
|
|
|
'value': 'Map::NumberOfOwnDescriptorsBits::kShift' },
|
2014-07-23 10:48:16 +00:00
|
|
|
|
2017-01-27 18:19:08 +00:00
|
|
|
{ 'name': 'off_fp_context_or_frame_type',
|
|
|
|
'value': 'CommonFrameConstants::kContextOrFrameTypeOffset'},
|
2012-02-02 20:18:19 +00:00
|
|
|
{ 'name': 'off_fp_context',
|
|
|
|
'value': 'StandardFrameConstants::kContextOffset' },
|
2013-12-30 11:23:59 +00:00
|
|
|
{ 'name': 'off_fp_constant_pool',
|
|
|
|
'value': 'StandardFrameConstants::kConstantPoolOffset' },
|
2012-02-02 20:18:19 +00:00
|
|
|
{ 'name': 'off_fp_function',
|
|
|
|
'value': 'JavaScriptFrameConstants::kFunctionOffset' },
|
|
|
|
{ 'name': 'off_fp_args',
|
|
|
|
'value': 'JavaScriptFrameConstants::kLastParameterOffset' },
|
2015-09-21 05:45:20 +00:00
|
|
|
|
|
|
|
{ 'name': 'scopeinfo_idx_nparams',
|
|
|
|
'value': 'ScopeInfo::kParameterCount' },
|
|
|
|
{ 'name': 'scopeinfo_idx_ncontextlocals',
|
|
|
|
'value': 'ScopeInfo::kContextLocalCount' },
|
|
|
|
{ 'name': 'scopeinfo_idx_first_vars',
|
|
|
|
'value': 'ScopeInfo::kVariablePartIndex' },
|
2015-11-11 19:13:45 +00:00
|
|
|
|
2018-12-11 10:22:02 +00:00
|
|
|
{ 'name': 'jsarray_buffer_was_detached_mask',
|
|
|
|
'value': 'JSArrayBuffer::WasDetachedBit::kMask' },
|
|
|
|
{ 'name': 'jsarray_buffer_was_detached_shift',
|
|
|
|
'value': 'JSArrayBuffer::WasDetachedBit::kShift' },
|
2016-06-10 04:06:16 +00:00
|
|
|
|
2018-05-02 13:57:26 +00:00
|
|
|
{ 'name': 'context_idx_scope_info',
|
|
|
|
'value': 'Context::SCOPE_INFO_INDEX' },
|
2016-06-10 04:06:16 +00:00
|
|
|
{ 'name': 'context_idx_native',
|
|
|
|
'value': 'Context::NATIVE_CONTEXT_INDEX' },
|
|
|
|
{ 'name': 'context_idx_prev',
|
|
|
|
'value': 'Context::PREVIOUS_INDEX' },
|
|
|
|
{ 'name': 'context_idx_ext',
|
|
|
|
'value': 'Context::EXTENSION_INDEX' },
|
|
|
|
{ 'name': 'context_min_slots',
|
|
|
|
'value': 'Context::MIN_CONTEXT_SLOTS' },
|
2018-11-22 14:41:39 +00:00
|
|
|
{ 'name': 'native_context_embedder_data_offset',
|
|
|
|
'value': 'Internals::kNativeContextEmbedderDataOffset' },
|
2018-07-16 15:16:06 +00:00
|
|
|
|
2016-06-10 04:06:16 +00:00
|
|
|
|
|
|
|
{ 'name': 'namedictionaryshape_prefix_size',
|
|
|
|
'value': 'NameDictionaryShape::kPrefixSize' },
|
|
|
|
{ 'name': 'namedictionaryshape_entry_size',
|
|
|
|
'value': 'NameDictionaryShape::kEntrySize' },
|
2016-06-29 14:25:36 +00:00
|
|
|
{ 'name': 'globaldictionaryshape_entry_size',
|
|
|
|
'value': 'GlobalDictionaryShape::kEntrySize' },
|
2016-06-10 04:06:16 +00:00
|
|
|
|
|
|
|
{ 'name': 'namedictionary_prefix_start_index',
|
|
|
|
'value': 'NameDictionary::kPrefixStartIndex' },
|
|
|
|
|
2017-11-07 09:35:59 +00:00
|
|
|
{ 'name': 'numberdictionaryshape_prefix_size',
|
|
|
|
'value': 'NumberDictionaryShape::kPrefixSize' },
|
|
|
|
{ 'name': 'numberdictionaryshape_entry_size',
|
|
|
|
'value': 'NumberDictionaryShape::kEntrySize' },
|
2018-01-25 08:42:56 +00:00
|
|
|
|
|
|
|
{ 'name': 'simplenumberdictionaryshape_prefix_size',
|
|
|
|
'value': 'SimpleNumberDictionaryShape::kPrefixSize' },
|
|
|
|
{ 'name': 'simplenumberdictionaryshape_entry_size',
|
|
|
|
'value': 'SimpleNumberDictionaryShape::kEntrySize' },
|
2018-07-16 15:16:06 +00:00
|
|
|
|
|
|
|
{ 'name': 'type_JSError__JS_ERROR_TYPE', 'value': 'JS_ERROR_TYPE' },
|
2019-01-02 16:58:41 +00:00
|
|
|
|
|
|
|
{ 'name': 'class_SharedFunctionInfo__function_data__Object',
|
|
|
|
'value': 'SharedFunctionInfo::kFunctionDataOffset' },
|
2012-02-02 20:18:19 +00:00
|
|
|
];
|
|
|
|
|
|
|
|
#
|
|
|
|
# The following useful fields are missing accessors, so we define fake ones.
|
2016-06-10 04:06:16 +00:00
|
|
|
# Please note that extra accessors should _only_ be added to expose offsets that
|
|
|
|
# can be used to access actual V8 objects' properties. They should not be added
|
|
|
|
# for exposing other values. For instance, enumeration values or class'
|
|
|
|
# constants should be exposed by adding an entry in the "consts_misc" table, not
|
|
|
|
# in this "extras_accessors" table.
|
2012-02-02 20:18:19 +00:00
|
|
|
#
|
|
|
|
extras_accessors = [
|
2015-11-11 19:13:45 +00:00
|
|
|
'JSFunction, context, Context, kContextOffset',
|
2019-02-03 23:40:56 +00:00
|
|
|
'JSFunction, shared, SharedFunctionInfo, kSharedFunctionInfoOffset',
|
2012-02-02 20:18:19 +00:00
|
|
|
'HeapObject, map, Map, kMapOffset',
|
|
|
|
'JSObject, elements, Object, kElementsOffset',
|
2016-11-21 19:33:33 +00:00
|
|
|
'JSObject, internal_fields, uintptr_t, kHeaderSize',
|
2012-02-02 20:18:19 +00:00
|
|
|
'FixedArray, data, uintptr_t, kHeaderSize',
|
2019-02-27 14:45:43 +00:00
|
|
|
'JSArrayBuffer, backing_store, uintptr_t, kBackingStoreOffset',
|
2018-10-14 18:44:37 +00:00
|
|
|
'JSArrayBuffer, byte_length, size_t, kByteLengthOffset',
|
|
|
|
'JSArrayBufferView, byte_length, size_t, kByteLengthOffset',
|
|
|
|
'JSArrayBufferView, byte_offset, size_t, kByteOffsetOffset',
|
2015-09-23 05:37:21 +00:00
|
|
|
'JSTypedArray, length, Object, kLengthOffset',
|
2017-11-17 21:24:02 +00:00
|
|
|
'Map, instance_size_in_words, char, kInstanceSizeInWordsOffset',
|
|
|
|
'Map, inobject_properties_start_or_constructor_function_index, char, kInObjectPropertiesStartOrConstructorFunctionIndexOffset',
|
2017-11-22 18:04:36 +00:00
|
|
|
'Map, instance_type, uint16_t, kInstanceTypeOffset',
|
2014-07-23 10:48:16 +00:00
|
|
|
'Map, bit_field, char, kBitFieldOffset',
|
|
|
|
'Map, bit_field2, char, kBitField2Offset',
|
2015-09-18 22:41:04 +00:00
|
|
|
'Map, bit_field3, int, kBitField3Offset',
|
2014-07-23 10:48:16 +00:00
|
|
|
'Map, prototype, Object, kPrototypeOffset',
|
|
|
|
'Oddball, kind_offset, int, kKindOffset',
|
2012-02-02 20:18:19 +00:00
|
|
|
'HeapNumber, value, double, kValueOffset',
|
|
|
|
'ConsString, first, String, kFirstOffset',
|
|
|
|
'ConsString, second, String, kSecondOffset',
|
|
|
|
'ExternalString, resource, Object, kResourceOffset',
|
2012-11-15 13:31:27 +00:00
|
|
|
'SeqOneByteString, chars, char, kHeaderSize',
|
2013-10-14 13:08:52 +00:00
|
|
|
'SeqTwoByteString, chars, char, kHeaderSize',
|
2018-07-09 09:34:34 +00:00
|
|
|
'UncompiledData, start_position, int32_t, kStartPositionOffset',
|
|
|
|
'UncompiledData, end_position, int32_t, kEndPositionOffset',
|
|
|
|
'SharedFunctionInfo, raw_function_token_offset, int16_t, kFunctionTokenOffsetOffset',
|
2018-05-30 11:12:26 +00:00
|
|
|
'SharedFunctionInfo, internal_formal_parameter_count, uint16_t, kFormalParameterCountOffset',
|
2018-03-27 10:55:27 +00:00
|
|
|
'SharedFunctionInfo, flags, int, kFlagsOffset',
|
2018-05-30 11:12:26 +00:00
|
|
|
'SharedFunctionInfo, length, uint16_t, kLengthOffset',
|
2013-10-14 13:08:52 +00:00
|
|
|
'SlicedString, parent, String, kParentOffset',
|
2012-03-09 12:34:42 +00:00
|
|
|
'Code, instruction_start, uintptr_t, kHeaderSize',
|
|
|
|
'Code, instruction_size, int, kInstructionSizeOffset',
|
2018-10-14 18:44:37 +00:00
|
|
|
'String, length, int32_t, kLengthOffset',
|
2012-02-02 20:18:19 +00:00
|
|
|
];
|
|
|
|
|
|
|
|
#
|
|
|
|
# The following is a whitelist of classes we expect to find when scanning the
|
|
|
|
# source code. This list is not exhaustive, but it's still useful to identify
|
|
|
|
# when this script gets out of sync with the source. See load_objects().
|
|
|
|
#
|
|
|
|
expected_classes = [
|
|
|
|
'ConsString', 'FixedArray', 'HeapNumber', 'JSArray', 'JSFunction',
|
2019-06-24 13:13:34 +00:00
|
|
|
'JSObject', 'JSRegExp', 'JSPrimitiveWrapper', 'Map', 'Oddball', 'Script',
|
2018-10-04 09:47:11 +00:00
|
|
|
'SeqOneByteString', 'SharedFunctionInfo', 'ScopeInfo', 'JSPromise'
|
2012-02-02 20:18:19 +00:00
|
|
|
];
|
|
|
|
|
|
|
|
|
|
|
|
#
|
|
|
|
# The following structures store high-level representations of the structures
|
|
|
|
# for which we're going to emit descriptive constants.
|
|
|
|
#
|
|
|
|
types = {}; # set of all type names
|
|
|
|
typeclasses = {}; # maps type names to corresponding class names
|
|
|
|
klasses = {}; # known classes, including parents
|
|
|
|
fields = []; # field declarations
|
|
|
|
|
|
|
|
header = '''
|
|
|
|
/*
|
|
|
|
* This file is generated by %s. Do not edit directly.
|
|
|
|
*/
|
|
|
|
|
2019-05-24 13:51:59 +00:00
|
|
|
#include "src/init/v8.h"
|
2019-05-22 07:55:37 +00:00
|
|
|
#include "src/execution/frames.h"
|
|
|
|
#include "src/execution/frames-inl.h" /* for architecture-specific frame constants */
|
2019-05-23 08:51:46 +00:00
|
|
|
#include "src/objects/contexts.h"
|
|
|
|
#include "src/objects/objects.h"
|
2019-02-07 20:27:25 +00:00
|
|
|
#include "src/objects/data-handler.h"
|
2018-10-04 09:47:11 +00:00
|
|
|
#include "src/objects/js-promise.h"
|
2018-05-23 13:29:02 +00:00
|
|
|
#include "src/objects/js-regexp-string-iterator.h"
|
2012-02-02 20:18:19 +00:00
|
|
|
|
2019-02-13 10:23:31 +00:00
|
|
|
namespace v8 {
|
|
|
|
namespace internal {
|
2012-02-02 20:18:19 +00:00
|
|
|
|
|
|
|
extern "C" {
|
|
|
|
|
|
|
|
/* stack frame constants */
|
|
|
|
#define FRAME_CONST(value, klass) \
|
|
|
|
int v8dbg_frametype_##klass = StackFrame::value;
|
|
|
|
|
|
|
|
STACK_FRAME_TYPE_LIST(FRAME_CONST)
|
|
|
|
|
|
|
|
#undef FRAME_CONST
|
|
|
|
|
|
|
|
''' % sys.argv[0];
|
|
|
|
|
|
|
|
footer = '''
|
|
|
|
}
|
2019-02-13 10:23:31 +00:00
|
|
|
|
|
|
|
}
|
|
|
|
}
|
2012-02-02 20:18:19 +00:00
|
|
|
'''
|
|
|
|
|
2015-11-12 14:47:38 +00:00
|
|
|
#
|
|
|
|
# Get the base class
|
|
|
|
#
|
|
|
|
def get_base_class(klass):
|
|
|
|
if (klass == 'Object'):
|
|
|
|
return klass;
|
|
|
|
|
|
|
|
if (not (klass in klasses)):
|
|
|
|
return None;
|
|
|
|
|
|
|
|
k = klasses[klass];
|
|
|
|
|
|
|
|
return get_base_class(k['parent']);
|
|
|
|
|
2012-02-02 20:18:19 +00:00
|
|
|
#
|
2017-05-17 11:31:18 +00:00
|
|
|
# Loads class hierarchy and type information from "objects.h" etc.
|
2012-02-02 20:18:19 +00:00
|
|
|
#
|
|
|
|
def load_objects():
|
|
|
|
#
|
|
|
|
# Construct a dictionary for the classes we're sure should be present.
|
|
|
|
#
|
|
|
|
checktypes = {};
|
|
|
|
for klass in expected_classes:
|
|
|
|
checktypes[klass] = True;
|
|
|
|
|
2017-05-17 11:31:18 +00:00
|
|
|
|
|
|
|
for filename in sys.argv[2:]:
|
|
|
|
if not filename.endswith("-inl.h"):
|
|
|
|
load_objects_from_file(filename, checktypes)
|
|
|
|
|
|
|
|
if (len(checktypes) > 0):
|
|
|
|
for klass in checktypes:
|
|
|
|
print('error: expected class \"%s\" not found' % klass);
|
|
|
|
|
|
|
|
sys.exit(1);
|
|
|
|
|
|
|
|
|
|
|
|
def load_objects_from_file(objfilename, checktypes):
|
|
|
|
objfile = open(objfilename, 'r');
|
|
|
|
in_insttype = False;
|
|
|
|
|
|
|
|
typestr = '';
|
|
|
|
|
2012-02-02 20:18:19 +00:00
|
|
|
#
|
2017-05-17 11:31:18 +00:00
|
|
|
# Iterate the header file line-by-line to collect type and class
|
|
|
|
# information. For types, we accumulate a string representing the entire
|
|
|
|
# InstanceType enum definition and parse it later because it's easier to
|
|
|
|
# do so without the embedded newlines.
|
2012-02-02 20:18:19 +00:00
|
|
|
#
|
|
|
|
for line in objfile:
|
2017-11-22 18:04:36 +00:00
|
|
|
if (line.startswith('enum InstanceType : uint16_t {')):
|
2012-02-02 20:18:19 +00:00
|
|
|
in_insttype = True;
|
|
|
|
continue;
|
|
|
|
|
|
|
|
if (in_insttype and line.startswith('};')):
|
|
|
|
in_insttype = False;
|
|
|
|
continue;
|
|
|
|
|
2015-11-30 17:07:44 +00:00
|
|
|
line = re.sub('//.*', '', line.strip());
|
2012-02-02 20:18:19 +00:00
|
|
|
|
|
|
|
if (in_insttype):
|
|
|
|
typestr += line;
|
|
|
|
continue;
|
|
|
|
|
2019-03-27 12:31:41 +00:00
|
|
|
match = re.match(r'class(?:\s+V8_EXPORT(?:_PRIVATE)?)?'
|
|
|
|
r'\s+(\w[^:]*)'
|
|
|
|
r'(?:: public (\w[^{]*))?\s*{\s*',
|
|
|
|
line);
|
2012-02-02 20:18:19 +00:00
|
|
|
|
|
|
|
if (match):
|
2015-11-30 17:07:44 +00:00
|
|
|
klass = match.group(1).strip();
|
2019-03-27 12:31:41 +00:00
|
|
|
pklass = match.group(2);
|
2015-11-12 14:47:38 +00:00
|
|
|
if (pklass):
|
2019-05-13 10:01:59 +00:00
|
|
|
# Strip potential template arguments from parent
|
|
|
|
# class.
|
|
|
|
match = re.match(r'(\w+)(<.*>)?', pklass.strip());
|
|
|
|
pklass = match.group(1).strip();
|
|
|
|
|
2012-02-02 20:18:19 +00:00
|
|
|
klasses[klass] = { 'parent': pklass };
|
|
|
|
|
|
|
|
#
|
|
|
|
# Process the instance type declaration.
|
|
|
|
#
|
|
|
|
entries = typestr.split(',');
|
|
|
|
for entry in entries:
|
|
|
|
types[re.sub('\s*=.*', '', entry).lstrip()] = True;
|
|
|
|
|
|
|
|
#
|
|
|
|
# Infer class names for each type based on a systematic transformation.
|
|
|
|
# For example, "JS_FUNCTION_TYPE" becomes "JSFunction". We find the
|
|
|
|
# class for each type rather than the other way around because there are
|
|
|
|
# fewer cases where one type maps to more than one class than the other
|
|
|
|
# way around.
|
|
|
|
#
|
|
|
|
for type in types:
|
|
|
|
#
|
|
|
|
# REGEXP behaves like REG_EXP, as in JS_REGEXP_TYPE => JSRegExp.
|
|
|
|
#
|
2018-09-04 18:51:38 +00:00
|
|
|
usetype = re.sub('_REGEXP_', '_REG_EXP_', type);
|
2012-02-02 20:18:19 +00:00
|
|
|
|
|
|
|
#
|
|
|
|
# Remove the "_TYPE" suffix and then convert to camel case,
|
|
|
|
# except that a "JS" prefix remains uppercase (as in
|
|
|
|
# "JS_FUNCTION_TYPE" => "JSFunction").
|
|
|
|
#
|
|
|
|
if (not usetype.endswith('_TYPE')):
|
|
|
|
continue;
|
|
|
|
|
|
|
|
usetype = usetype[0:len(usetype) - len('_TYPE')];
|
|
|
|
parts = usetype.split('_');
|
|
|
|
cctype = '';
|
|
|
|
|
|
|
|
if (parts[0] == 'JS'):
|
|
|
|
cctype = 'JS';
|
|
|
|
start = 1;
|
|
|
|
else:
|
|
|
|
cctype = '';
|
|
|
|
start = 0;
|
|
|
|
|
|
|
|
for ii in range(start, len(parts)):
|
|
|
|
part = parts[ii];
|
|
|
|
cctype += part[0].upper() + part[1:].lower();
|
|
|
|
|
|
|
|
#
|
|
|
|
# Mapping string types is more complicated. Both types and
|
|
|
|
# class names for Strings specify a representation (e.g., Seq,
|
2014-09-10 12:56:19 +00:00
|
|
|
# Cons, External, or Sliced) and an encoding (TwoByte/OneByte),
|
2012-02-02 20:18:19 +00:00
|
|
|
# In the simplest case, both of these are explicit in both
|
|
|
|
# names, as in:
|
|
|
|
#
|
2014-09-10 12:56:19 +00:00
|
|
|
# EXTERNAL_ONE_BYTE_STRING_TYPE => ExternalOneByteString
|
2012-02-02 20:18:19 +00:00
|
|
|
#
|
|
|
|
# However, either the representation or encoding can be omitted
|
|
|
|
# from the type name, in which case "Seq" and "TwoByte" are
|
|
|
|
# assumed, as in:
|
|
|
|
#
|
|
|
|
# STRING_TYPE => SeqTwoByteString
|
|
|
|
#
|
|
|
|
# Additionally, sometimes the type name has more information
|
|
|
|
# than the class, as in:
|
|
|
|
#
|
2014-09-10 12:56:19 +00:00
|
|
|
# CONS_ONE_BYTE_STRING_TYPE => ConsString
|
2012-02-02 20:18:19 +00:00
|
|
|
#
|
|
|
|
# To figure this out dynamically, we first check for a
|
|
|
|
# representation and encoding and add them if they're not
|
|
|
|
# present. If that doesn't yield a valid class name, then we
|
|
|
|
# strip out the representation.
|
|
|
|
#
|
|
|
|
if (cctype.endswith('String')):
|
|
|
|
if (cctype.find('Cons') == -1 and
|
|
|
|
cctype.find('External') == -1 and
|
|
|
|
cctype.find('Sliced') == -1):
|
2014-09-10 12:56:19 +00:00
|
|
|
if (cctype.find('OneByte') != -1):
|
|
|
|
cctype = re.sub('OneByteString$',
|
2012-11-15 13:31:27 +00:00
|
|
|
'SeqOneByteString', cctype);
|
2012-02-02 20:18:19 +00:00
|
|
|
else:
|
|
|
|
cctype = re.sub('String$',
|
|
|
|
'SeqString', cctype);
|
|
|
|
|
2014-09-10 12:56:19 +00:00
|
|
|
if (cctype.find('OneByte') == -1):
|
2012-02-02 20:18:19 +00:00
|
|
|
cctype = re.sub('String$', 'TwoByteString',
|
|
|
|
cctype);
|
|
|
|
|
|
|
|
if (not (cctype in klasses)):
|
2014-09-10 12:56:19 +00:00
|
|
|
cctype = re.sub('OneByte', '', cctype);
|
2012-02-02 20:18:19 +00:00
|
|
|
cctype = re.sub('TwoByte', '', cctype);
|
|
|
|
|
|
|
|
#
|
|
|
|
# Despite all that, some types have no corresponding class.
|
|
|
|
#
|
|
|
|
if (cctype in klasses):
|
|
|
|
typeclasses[type] = cctype;
|
|
|
|
if (cctype in checktypes):
|
|
|
|
del checktypes[cctype];
|
|
|
|
|
|
|
|
#
|
|
|
|
# For a given macro call, pick apart the arguments and return an object
|
|
|
|
# describing the corresponding output constant. See load_fields().
|
|
|
|
#
|
|
|
|
def parse_field(call):
|
|
|
|
# Replace newlines with spaces.
|
|
|
|
for ii in range(0, len(call)):
|
|
|
|
if (call[ii] == '\n'):
|
|
|
|
call[ii] == ' ';
|
|
|
|
|
|
|
|
idx = call.find('(');
|
|
|
|
kind = call[0:idx];
|
|
|
|
rest = call[idx + 1: len(call) - 1];
|
|
|
|
args = re.split('\s*,\s*', rest);
|
|
|
|
|
|
|
|
consts = [];
|
|
|
|
|
2019-01-02 16:58:41 +00:00
|
|
|
if (kind == 'ACCESSORS' or kind == 'ACCESSORS2' or
|
|
|
|
kind == 'ACCESSORS_GCSAFE'):
|
2012-02-02 20:18:19 +00:00
|
|
|
klass = args[0];
|
|
|
|
field = args[1];
|
2017-04-25 08:22:56 +00:00
|
|
|
dtype = args[2].replace('<', '_').replace('>', '_')
|
2012-02-02 20:18:19 +00:00
|
|
|
offset = args[3];
|
|
|
|
|
|
|
|
return ({
|
|
|
|
'name': 'class_%s__%s__%s' % (klass, field, dtype),
|
|
|
|
'value': '%s::%s' % (klass, offset)
|
|
|
|
});
|
|
|
|
|
2014-07-23 10:48:16 +00:00
|
|
|
assert(kind == 'SMI_ACCESSORS' or kind == 'ACCESSORS_TO_SMI');
|
2012-02-02 20:18:19 +00:00
|
|
|
klass = args[0];
|
|
|
|
field = args[1];
|
|
|
|
offset = args[2];
|
|
|
|
|
|
|
|
return ({
|
|
|
|
'name': 'class_%s__%s__%s' % (klass, field, 'SMI'),
|
|
|
|
'value': '%s::%s' % (klass, offset)
|
|
|
|
});
|
|
|
|
|
|
|
|
#
|
2017-05-17 11:31:18 +00:00
|
|
|
# Load field offset information from objects-inl.h etc.
|
2012-02-02 20:18:19 +00:00
|
|
|
#
|
|
|
|
def load_fields():
|
2017-05-17 11:31:18 +00:00
|
|
|
for filename in sys.argv[2:]:
|
|
|
|
if filename.endswith("-inl.h"):
|
|
|
|
load_fields_from_file(filename)
|
|
|
|
|
|
|
|
for body in extras_accessors:
|
|
|
|
fields.append(parse_field('ACCESSORS(%s)' % body));
|
|
|
|
|
|
|
|
|
|
|
|
def load_fields_from_file(filename):
|
|
|
|
inlfile = open(filename, 'r');
|
2012-02-02 20:18:19 +00:00
|
|
|
|
|
|
|
#
|
|
|
|
# Each class's fields and the corresponding offsets are described in the
|
|
|
|
# source by calls to macros like "ACCESSORS" (and friends). All we do
|
|
|
|
# here is extract these macro invocations, taking into account that they
|
|
|
|
# may span multiple lines and may contain nested parentheses. We also
|
|
|
|
# call parse_field() to pick apart the invocation.
|
|
|
|
#
|
2019-01-02 16:58:41 +00:00
|
|
|
prefixes = [ 'ACCESSORS', 'ACCESSORS2', 'ACCESSORS_GCSAFE',
|
2014-07-23 10:48:16 +00:00
|
|
|
'SMI_ACCESSORS', 'ACCESSORS_TO_SMI' ];
|
2012-02-02 20:18:19 +00:00
|
|
|
current = '';
|
|
|
|
opens = 0;
|
|
|
|
|
|
|
|
for line in inlfile:
|
|
|
|
if (opens > 0):
|
|
|
|
# Continuation line
|
|
|
|
for ii in range(0, len(line)):
|
|
|
|
if (line[ii] == '('):
|
|
|
|
opens += 1;
|
|
|
|
elif (line[ii] == ')'):
|
|
|
|
opens -= 1;
|
|
|
|
|
|
|
|
if (opens == 0):
|
|
|
|
break;
|
|
|
|
|
|
|
|
current += line[0:ii + 1];
|
|
|
|
continue;
|
|
|
|
|
|
|
|
for prefix in prefixes:
|
|
|
|
if (not line.startswith(prefix + '(')):
|
|
|
|
continue;
|
|
|
|
|
|
|
|
if (len(current) > 0):
|
|
|
|
fields.append(parse_field(current));
|
|
|
|
current = '';
|
|
|
|
|
|
|
|
for ii in range(len(prefix), len(line)):
|
|
|
|
if (line[ii] == '('):
|
|
|
|
opens += 1;
|
|
|
|
elif (line[ii] == ')'):
|
|
|
|
opens -= 1;
|
|
|
|
|
|
|
|
if (opens == 0):
|
|
|
|
break;
|
|
|
|
|
|
|
|
current += line[0:ii + 1];
|
|
|
|
|
|
|
|
if (len(current) > 0):
|
|
|
|
fields.append(parse_field(current));
|
|
|
|
current = '';
|
|
|
|
|
|
|
|
#
|
|
|
|
# Emit a block of constants.
|
|
|
|
#
|
|
|
|
def emit_set(out, consts):
|
2014-04-02 13:04:08 +00:00
|
|
|
# Fix up overzealous parses. This could be done inside the
|
|
|
|
# parsers but as there are several, it's easiest to do it here.
|
|
|
|
ws = re.compile('\s+')
|
|
|
|
for const in consts:
|
|
|
|
name = ws.sub('', const['name'])
|
|
|
|
value = ws.sub('', str(const['value'])) # Can be a number.
|
|
|
|
out.write('int v8dbg_%s = %s;\n' % (name, value))
|
2012-02-02 20:18:19 +00:00
|
|
|
out.write('\n');
|
|
|
|
|
|
|
|
#
|
|
|
|
# Emit the whole output file.
|
|
|
|
#
|
|
|
|
def emit_config():
|
2019-02-19 08:28:26 +00:00
|
|
|
out = open(sys.argv[1], 'w');
|
2012-02-02 20:18:19 +00:00
|
|
|
|
|
|
|
out.write(header);
|
|
|
|
|
|
|
|
out.write('/* miscellaneous constants */\n');
|
|
|
|
emit_set(out, consts_misc);
|
|
|
|
|
|
|
|
out.write('/* class type information */\n');
|
|
|
|
consts = [];
|
|
|
|
keys = typeclasses.keys();
|
|
|
|
keys.sort();
|
|
|
|
for typename in keys:
|
|
|
|
klass = typeclasses[typename];
|
|
|
|
consts.append({
|
|
|
|
'name': 'type_%s__%s' % (klass, typename),
|
|
|
|
'value': typename
|
|
|
|
});
|
|
|
|
|
|
|
|
emit_set(out, consts);
|
|
|
|
|
|
|
|
out.write('/* class hierarchy information */\n');
|
|
|
|
consts = [];
|
|
|
|
keys = klasses.keys();
|
|
|
|
keys.sort();
|
|
|
|
for klassname in keys:
|
|
|
|
pklass = klasses[klassname]['parent'];
|
2015-11-12 14:47:38 +00:00
|
|
|
bklass = get_base_class(klassname);
|
|
|
|
if (bklass != 'Object'):
|
|
|
|
continue;
|
2012-02-02 20:18:19 +00:00
|
|
|
if (pklass == None):
|
|
|
|
continue;
|
|
|
|
|
|
|
|
consts.append({
|
|
|
|
'name': 'parent_%s__%s' % (klassname, pklass),
|
|
|
|
'value': 0
|
|
|
|
});
|
|
|
|
|
|
|
|
emit_set(out, consts);
|
|
|
|
|
|
|
|
out.write('/* field information */\n');
|
|
|
|
emit_set(out, fields);
|
|
|
|
|
|
|
|
out.write(footer);
|
|
|
|
|
|
|
|
if (len(sys.argv) < 4):
|
|
|
|
print('usage: %s output.cc objects.h objects-inl.h' % sys.argv[0]);
|
|
|
|
sys.exit(2);
|
|
|
|
|
|
|
|
load_objects();
|
|
|
|
load_fields();
|
|
|
|
emit_config();
|