| OLD | NEW |
| 1 # Copyright 2013 The Chromium Authors. All rights reserved. | 1 # Copyright 2013 The Chromium 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 import module as mojom | 5 import module as mojom |
| 6 | 6 |
| 7 # This module provides a mechanism for determining the packed order and offsets | 7 # This module provides a mechanism for determining the packed order and offsets |
| 8 # of a mojom.Struct. | 8 # of a mojom.Struct. |
| 9 # | 9 # |
| 10 # ps = pack.PackedStruct(struct) | 10 # ps = pack.PackedStruct(struct) |
| (...skipping 39 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 50 return 16 | 50 return 16 |
| 51 if isinstance(kind, mojom.InterfaceRequest): | 51 if isinstance(kind, mojom.InterfaceRequest): |
| 52 kind = mojom.MSGPIPE | 52 kind = mojom.MSGPIPE |
| 53 if isinstance(kind, mojom.Enum): | 53 if isinstance(kind, mojom.Enum): |
| 54 # TODO(mpcomplete): what about big enums? | 54 # TODO(mpcomplete): what about big enums? |
| 55 return cls.kind_to_size[mojom.INT32] | 55 return cls.kind_to_size[mojom.INT32] |
| 56 if not kind in cls.kind_to_size: | 56 if not kind in cls.kind_to_size: |
| 57 raise Exception("Invalid kind: %s" % kind.spec) | 57 raise Exception("Invalid kind: %s" % kind.spec) |
| 58 return cls.kind_to_size[kind] | 58 return cls.kind_to_size[kind] |
| 59 | 59 |
| 60 @classmethod | 60 def __init__(self, field): |
| 61 def GetAlignmentForKind(cls, kind): | |
| 62 if isinstance(kind, mojom.Interface): | |
| 63 return 4 | |
| 64 if isinstance(kind, mojom.Union): | |
| 65 return 8 | |
| 66 return cls.GetSizeForKind(kind) | |
| 67 | |
| 68 def __init__(self, field, index, ordinal): | |
| 69 """ | 61 """ |
| 70 Args: | 62 Args: |
| 71 field: the original field. | 63 field: the original field. |
| 72 index: the position of the original field in the struct. | |
| 73 ordinal: the ordinal of the field for serialization. | |
| 74 """ | 64 """ |
| 75 self.field = field | 65 self.field = field |
| 76 self.index = index | 66 self.index = field.declaration_order |
| 77 self.ordinal = ordinal | 67 self.ordinal = field.computed_ordinal |
| 78 self.size = self.GetSizeForKind(field.kind) | 68 self.size = self.GetSizeForKind(field.kind) |
| 79 self.alignment = self.GetAlignmentForKind(field.kind) | 69 self.offset = field.computed_offset |
| 80 self.offset = None | 70 self.bit = field.computed_bit |
| 81 self.bit = None | 71 self.min_version = field.computed_min_version |
| 82 self.min_version = None | |
| 83 | 72 |
| 84 | 73 |
| 85 def GetPad(offset, alignment): | 74 def GetPad(offset, alignment): |
| 86 """Returns the pad necessary to reserve space so that |offset + pad| equals to | 75 """Returns the pad necessary to reserve space so that |offset + pad| equals to |
| 87 some multiple of |alignment|.""" | 76 some multiple of |alignment|.""" |
| 88 return (alignment - (offset % alignment)) % alignment | 77 return (alignment - (offset % alignment)) % alignment |
| 89 | 78 |
| 90 | 79 |
| 91 def GetFieldOffset(field, last_field): | |
| 92 """Returns a 2-tuple of the field offset and bit (for BOOLs).""" | |
| 93 if (field.field.kind == mojom.BOOL and | |
| 94 last_field.field.kind == mojom.BOOL and | |
| 95 last_field.bit < 7): | |
| 96 return (last_field.offset, last_field.bit + 1) | |
| 97 | |
| 98 offset = last_field.offset + last_field.size | |
| 99 pad = GetPad(offset, field.alignment) | |
| 100 return (offset + pad, 0) | |
| 101 | |
| 102 | |
| 103 def GetPayloadSizeUpToField(field): | |
| 104 """Returns the payload size (not including struct header) if |field| is the | |
| 105 last field. | |
| 106 """ | |
| 107 if not field: | |
| 108 return 0 | |
| 109 offset = field.offset + field.size | |
| 110 pad = GetPad(offset, 8) | |
| 111 return offset + pad | |
| 112 | |
| 113 | |
| 114 class PackedStruct(object): | 80 class PackedStruct(object): |
| 115 def __init__(self, struct): | 81 def __init__(self, struct): |
| 116 self.struct = struct | 82 self.struct = struct |
| 117 # |packed_fields| contains all the fields, in increasing offset order. | |
| 118 self.packed_fields = [] | |
| 119 # |packed_fields_in_ordinal_order| refers to the same fields as | |
| 120 # |packed_fields|, but in ordinal order. | |
| 121 self.packed_fields_in_ordinal_order = [] | |
| 122 | 83 |
| 123 # No fields. | 84 # |packed_fields_in_ordinal_order| contains all the fields, |
| 124 if (len(struct.fields) == 0): | 85 # in ordinal order. |
| 125 return | 86 self.packed_fields_in_ordinal_order = [PackedField(field) |
| 87 for field in struct.fields_in_ordinal_order] |
| 126 | 88 |
| 127 # Start by sorting by ordinal. | 89 # |packed_fields| refers to the same fields as |
| 128 src_fields = self.packed_fields_in_ordinal_order | 90 # |packed_fields_in_ordinal_order|, but in increasing offset order. |
| 129 ordinal = 0 | 91 self.packed_fields = [field for field in |
| 130 for index, field in enumerate(struct.fields): | 92 self.packed_fields_in_ordinal_order] |
| 131 if field.ordinal is not None: | 93 self.packed_fields.sort(key=lambda f: (f.offset, f.bit)) |
| 132 ordinal = field.ordinal | |
| 133 src_fields.append(PackedField(field, index, ordinal)) | |
| 134 ordinal += 1 | |
| 135 src_fields.sort(key=lambda field: field.ordinal) | |
| 136 | |
| 137 # Set |min_version| for each field. | |
| 138 next_min_version = 0 | |
| 139 for packed_field in src_fields: | |
| 140 if packed_field.field.min_version is None: | |
| 141 assert next_min_version == 0 | |
| 142 else: | |
| 143 assert packed_field.field.min_version >= next_min_version | |
| 144 next_min_version = packed_field.field.min_version | |
| 145 packed_field.min_version = next_min_version | |
| 146 | |
| 147 if (packed_field.min_version != 0 and | |
| 148 mojom.IsReferenceKind(packed_field.field.kind) and | |
| 149 not packed_field.field.kind.is_nullable): | |
| 150 raise Exception("Non-nullable fields are only allowed in version 0 of " | |
| 151 "a struct. %s.%s is defined with [MinVersion=%d]." | |
| 152 % (self.struct.name, packed_field.field.name, | |
| 153 packed_field.min_version)) | |
| 154 | |
| 155 src_field = src_fields[0] | |
| 156 src_field.offset = 0 | |
| 157 src_field.bit = 0 | |
| 158 dst_fields = self.packed_fields | |
| 159 dst_fields.append(src_field) | |
| 160 | |
| 161 # Then find first slot that each field will fit. | |
| 162 for src_field in src_fields[1:]: | |
| 163 last_field = dst_fields[0] | |
| 164 for i in xrange(1, len(dst_fields)): | |
| 165 next_field = dst_fields[i] | |
| 166 offset, bit = GetFieldOffset(src_field, last_field) | |
| 167 if offset + src_field.size <= next_field.offset: | |
| 168 # Found hole. | |
| 169 src_field.offset = offset | |
| 170 src_field.bit = bit | |
| 171 dst_fields.insert(i, src_field) | |
| 172 break | |
| 173 last_field = next_field | |
| 174 if src_field.offset is None: | |
| 175 # Add to end | |
| 176 src_field.offset, src_field.bit = GetFieldOffset(src_field, last_field) | |
| 177 dst_fields.append(src_field) | |
| 178 | |
| 179 | 94 |
| 180 class ByteInfo(object): | 95 class ByteInfo(object): |
| 181 def __init__(self): | 96 def __init__(self): |
| 182 self.is_padding = False | 97 self.is_padding = False |
| 183 self.packed_fields = [] | 98 self.packed_fields = [] |
| 184 | 99 |
| 185 | 100 |
| 186 def GetByteLayout(packed_struct): | 101 def GetByteLayout(packed_struct): |
| 187 total_payload_size = GetPayloadSizeUpToField( | 102 total_payload_size = packed_struct.struct.versions[-1].num_bytes - HEADER_SIZE |
| 188 packed_struct.packed_fields[-1] if packed_struct.packed_fields else None) | |
| 189 bytes = [ByteInfo() for i in xrange(total_payload_size)] | 103 bytes = [ByteInfo() for i in xrange(total_payload_size)] |
| 190 | 104 |
| 191 limit_of_previous_field = 0 | 105 limit_of_previous_field = 0 |
| 192 for packed_field in packed_struct.packed_fields: | 106 for packed_field in packed_struct.packed_fields: |
| 193 for i in xrange(limit_of_previous_field, packed_field.offset): | 107 for i in xrange(limit_of_previous_field, packed_field.offset): |
| 194 bytes[i].is_padding = True | 108 bytes[i].is_padding = True |
| 195 bytes[packed_field.offset].packed_fields.append(packed_field) | 109 bytes[packed_field.offset].packed_fields.append(packed_field) |
| 196 limit_of_previous_field = packed_field.offset + packed_field.size | 110 limit_of_previous_field = packed_field.offset + packed_field.size |
| 197 | 111 |
| 198 for i in xrange(limit_of_previous_field, len(bytes)): | 112 for i in xrange(limit_of_previous_field, len(bytes)): |
| 199 bytes[i].is_padding = True | 113 bytes[i].is_padding = True |
| 200 | 114 |
| 201 for byte in bytes: | 115 for byte in bytes: |
| 202 # A given byte cannot both be padding and have a fields packed into it. | 116 # A given byte cannot both be padding and have a fields packed into it. |
| 203 assert not (byte.is_padding and byte.packed_fields) | 117 assert not (byte.is_padding and byte.packed_fields) |
| 204 | 118 |
| 205 return bytes | 119 return bytes |
| 206 | 120 |
| 207 | 121 |
| 208 class VersionInfo(object): | 122 class VersionInfo(object): |
| 209 def __init__(self, version, num_fields, num_bytes): | 123 def __init__(self, version, num_fields, num_bytes): |
| 210 self.version = version | 124 self.version = version |
| 211 self.num_fields = num_fields | 125 self.num_fields = num_fields |
| 212 self.num_bytes = num_bytes | 126 self.num_bytes = num_bytes |
| 213 | 127 |
| 214 | |
| 215 def GetVersionInfo(packed_struct): | |
| 216 """Get version information for a struct. | |
| 217 | |
| 218 Args: | |
| 219 packed_struct: A PackedStruct instance. | |
| 220 | |
| 221 Returns: | |
| 222 A non-empty list of VersionInfo instances, sorted by version in increasing | |
| 223 order. | |
| 224 Note: The version numbers may not be consecutive. | |
| 225 """ | |
| 226 versions = [] | |
| 227 last_version = 0 | |
| 228 last_num_fields = 0 | |
| 229 last_payload_size = 0 | |
| 230 | |
| 231 for packed_field in packed_struct.packed_fields_in_ordinal_order: | |
| 232 if packed_field.min_version != last_version: | |
| 233 versions.append( | |
| 234 VersionInfo(last_version, last_num_fields, | |
| 235 last_payload_size + HEADER_SIZE)) | |
| 236 last_version = packed_field.min_version | |
| 237 | |
| 238 last_num_fields += 1 | |
| 239 # The fields are iterated in ordinal order here. However, the size of a | |
| 240 # version is determined by the last field of that version in pack order, | |
| 241 # instead of ordinal order. Therefore, we need to calculate the max value. | |
| 242 last_payload_size = max(GetPayloadSizeUpToField(packed_field), | |
| 243 last_payload_size) | |
| 244 | |
| 245 assert len(versions) == 0 or last_num_fields != versions[-1].num_fields | |
| 246 versions.append(VersionInfo(last_version, last_num_fields, | |
| 247 last_payload_size + HEADER_SIZE)) | |
| 248 return versions | |
| OLD | NEW |