diff options
| author | Xusheng <xusheng@vector35.com> | 2021-07-01 12:34:30 +0800 |
|---|---|---|
| committer | Xusheng Li <xushengli@protonmail.com> | 2021-07-05 10:11:47 +0800 |
| commit | 13ff200ba134b8704f37eca99c42b70dab0d17dc (patch) | |
| tree | 876b3db3c53f704b31152aeaede1f2edc9d27b24 /python/examples/kaitai/vdi.py | |
| parent | 4039a800349dcd587833d3e27d9137e4649818f4 (diff) | |
Remove snippet and kaitai plugin. Note their individual links.
Diffstat (limited to 'python/examples/kaitai/vdi.py')
| -rw-r--r-- | python/examples/kaitai/vdi.py | 458 |
1 files changed, 0 insertions, 458 deletions
diff --git a/python/examples/kaitai/vdi.py b/python/examples/kaitai/vdi.py deleted file mode 100644 index 211c2708..00000000 --- a/python/examples/kaitai/vdi.py +++ /dev/null @@ -1,458 +0,0 @@ -# This is a generated file! Please edit source .ksy file and use kaitai-struct-compiler to rebuild - -from pkg_resources import parse_version -from .kaitaistruct import __version__ as ks_version, KaitaiStruct, KaitaiStream, BytesIO -from enum import Enum -import collections - - -if parse_version(ks_version) < parse_version('0.7'): - raise Exception("Incompatible Kaitai Struct Python API: 0.7 or later is required, but you have %s" % (ks_version)) - -class Vdi(KaitaiStruct): - """A native VirtualBox file format - Images for testing can be downloaded from - * https://www.osboxes.org/virtualbox-images/ - * https://virtualboxes.org/images/ - * https://virtualboximages.com/ - or you can convert images of other formats. - - .. seealso:: - Source - https://github.com/qemu/qemu/blob/master/block/vdi.c - """ - - class ImageType(Enum): - dynamic = 1 - static = 2 - undo = 3 - diff = 4 - SEQ_FIELDS = ["header"] - def __init__(self, _io, _parent=None, _root=None): - self._io = _io - self._parent = _parent - self._root = _root if _root else self - self._debug = collections.defaultdict(dict) - - def _read(self): - self._debug['header']['start'] = self._io.pos() - self.header = self._root.Header(self._io, self, self._root) - self.header._read() - self._debug['header']['end'] = self._io.pos() - - class Header(KaitaiStruct): - SEQ_FIELDS = ["text", "signature", "version", "header_size_optional", "header_main"] - def __init__(self, _io, _parent=None, _root=None): - self._io = _io - self._parent = _parent - self._root = _root if _root else self - self._debug = collections.defaultdict(dict) - - def _read(self): - self._debug['text']['start'] = self._io.pos() - self.text = (self._io.read_bytes(64)).decode(u"utf-8") - self._debug['text']['end'] = self._io.pos() - self._debug['signature']['start'] = self._io.pos() - self.signature = self._io.ensure_fixed_contents(b"\x7F\x10\xDA\xBE") - self._debug['signature']['end'] = self._io.pos() - self._debug['version']['start'] = self._io.pos() - self.version = self._root.Header.Version(self._io, self, self._root) - self.version._read() - self._debug['version']['end'] = self._io.pos() - if self.subheader_size_is_dynamic: - self._debug['header_size_optional']['start'] = self._io.pos() - self.header_size_optional = self._io.read_u4le() - self._debug['header_size_optional']['end'] = self._io.pos() - - self._debug['header_main']['start'] = self._io.pos() - self._raw_header_main = self._io.read_bytes(self.header_size) - io = KaitaiStream(BytesIO(self._raw_header_main)) - self.header_main = self._root.Header.HeaderMain(io, self, self._root) - self.header_main._read() - self._debug['header_main']['end'] = self._io.pos() - - class Uuid(KaitaiStruct): - SEQ_FIELDS = ["uuid"] - def __init__(self, _io, _parent=None, _root=None): - self._io = _io - self._parent = _parent - self._root = _root if _root else self - self._debug = collections.defaultdict(dict) - - def _read(self): - self._debug['uuid']['start'] = self._io.pos() - self.uuid = self._io.read_bytes(16) - self._debug['uuid']['end'] = self._io.pos() - - - class Version(KaitaiStruct): - SEQ_FIELDS = ["major", "minor"] - def __init__(self, _io, _parent=None, _root=None): - self._io = _io - self._parent = _parent - self._root = _root if _root else self - self._debug = collections.defaultdict(dict) - - def _read(self): - self._debug['major']['start'] = self._io.pos() - self.major = self._io.read_u2le() - self._debug['major']['end'] = self._io.pos() - self._debug['minor']['start'] = self._io.pos() - self.minor = self._io.read_u2le() - self._debug['minor']['end'] = self._io.pos() - - - class HeaderMain(KaitaiStruct): - SEQ_FIELDS = ["image_type", "image_flags", "description", "blocks_map_offset", "offset_data", "geometry", "reserved1", "disk_size", "block_data_size", "block_metadata_size", "blocks_in_image", "blocks_allocated", "uuid_image", "uuid_last_snap", "uuid_link", "uuid_parent", "lchc_geometry"] - def __init__(self, _io, _parent=None, _root=None): - self._io = _io - self._parent = _parent - self._root = _root if _root else self - self._debug = collections.defaultdict(dict) - - def _read(self): - self._debug['image_type']['start'] = self._io.pos() - self.image_type = KaitaiStream.resolve_enum(self._root.ImageType, self._io.read_u4le()) - self._debug['image_type']['end'] = self._io.pos() - self._debug['image_flags']['start'] = self._io.pos() - self.image_flags = self._root.Header.HeaderMain.Flags(self._io, self, self._root) - self.image_flags._read() - self._debug['image_flags']['end'] = self._io.pos() - self._debug['description']['start'] = self._io.pos() - self.description = (self._io.read_bytes(256)).decode(u"utf-8") - self._debug['description']['end'] = self._io.pos() - if self._parent.version.major >= 1: - self._debug['blocks_map_offset']['start'] = self._io.pos() - self.blocks_map_offset = self._io.read_u4le() - self._debug['blocks_map_offset']['end'] = self._io.pos() - - if self._parent.version.major >= 1: - self._debug['offset_data']['start'] = self._io.pos() - self.offset_data = self._io.read_u4le() - self._debug['offset_data']['end'] = self._io.pos() - - self._debug['geometry']['start'] = self._io.pos() - self.geometry = self._root.Header.HeaderMain.Geometry(self._io, self, self._root) - self.geometry._read() - self._debug['geometry']['end'] = self._io.pos() - if self._parent.version.major >= 1: - self._debug['reserved1']['start'] = self._io.pos() - self.reserved1 = self._io.read_u4le() - self._debug['reserved1']['end'] = self._io.pos() - - self._debug['disk_size']['start'] = self._io.pos() - self.disk_size = self._io.read_u8le() - self._debug['disk_size']['end'] = self._io.pos() - self._debug['block_data_size']['start'] = self._io.pos() - self.block_data_size = self._io.read_u4le() - self._debug['block_data_size']['end'] = self._io.pos() - if self._parent.version.major >= 1: - self._debug['block_metadata_size']['start'] = self._io.pos() - self.block_metadata_size = self._io.read_u4le() - self._debug['block_metadata_size']['end'] = self._io.pos() - - self._debug['blocks_in_image']['start'] = self._io.pos() - self.blocks_in_image = self._io.read_u4le() - self._debug['blocks_in_image']['end'] = self._io.pos() - self._debug['blocks_allocated']['start'] = self._io.pos() - self.blocks_allocated = self._io.read_u4le() - self._debug['blocks_allocated']['end'] = self._io.pos() - self._debug['uuid_image']['start'] = self._io.pos() - self.uuid_image = self._root.Header.Uuid(self._io, self, self._root) - self.uuid_image._read() - self._debug['uuid_image']['end'] = self._io.pos() - self._debug['uuid_last_snap']['start'] = self._io.pos() - self.uuid_last_snap = self._root.Header.Uuid(self._io, self, self._root) - self.uuid_last_snap._read() - self._debug['uuid_last_snap']['end'] = self._io.pos() - self._debug['uuid_link']['start'] = self._io.pos() - self.uuid_link = self._root.Header.Uuid(self._io, self, self._root) - self.uuid_link._read() - self._debug['uuid_link']['end'] = self._io.pos() - if self._parent.version.major >= 1: - self._debug['uuid_parent']['start'] = self._io.pos() - self.uuid_parent = self._root.Header.Uuid(self._io, self, self._root) - self.uuid_parent._read() - self._debug['uuid_parent']['end'] = self._io.pos() - - if ((self._parent.version.major >= 1) and ((self._io.pos() + 16) <= self._io.size())) : - self._debug['lchc_geometry']['start'] = self._io.pos() - self.lchc_geometry = self._root.Header.HeaderMain.Geometry(self._io, self, self._root) - self.lchc_geometry._read() - self._debug['lchc_geometry']['end'] = self._io.pos() - - - class Geometry(KaitaiStruct): - SEQ_FIELDS = ["cylinders", "heads", "sectors", "sector_size"] - def __init__(self, _io, _parent=None, _root=None): - self._io = _io - self._parent = _parent - self._root = _root if _root else self - self._debug = collections.defaultdict(dict) - - def _read(self): - self._debug['cylinders']['start'] = self._io.pos() - self.cylinders = self._io.read_u4le() - self._debug['cylinders']['end'] = self._io.pos() - self._debug['heads']['start'] = self._io.pos() - self.heads = self._io.read_u4le() - self._debug['heads']['end'] = self._io.pos() - self._debug['sectors']['start'] = self._io.pos() - self.sectors = self._io.read_u4le() - self._debug['sectors']['end'] = self._io.pos() - self._debug['sector_size']['start'] = self._io.pos() - self.sector_size = self._io.read_u4le() - self._debug['sector_size']['end'] = self._io.pos() - - - class Flags(KaitaiStruct): - SEQ_FIELDS = ["reserved0", "zero_expand", "reserved1", "diff", "fixed", "reserved2"] - def __init__(self, _io, _parent=None, _root=None): - self._io = _io - self._parent = _parent - self._root = _root if _root else self - self._debug = collections.defaultdict(dict) - - def _read(self): - self._debug['reserved0']['start'] = self._io.pos() - self.reserved0 = self._io.read_bits_int(15) - self._debug['reserved0']['end'] = self._io.pos() - self._debug['zero_expand']['start'] = self._io.pos() - self.zero_expand = self._io.read_bits_int(1) != 0 - self._debug['zero_expand']['end'] = self._io.pos() - self._debug['reserved1']['start'] = self._io.pos() - self.reserved1 = self._io.read_bits_int(6) - self._debug['reserved1']['end'] = self._io.pos() - self._debug['diff']['start'] = self._io.pos() - self.diff = self._io.read_bits_int(1) != 0 - self._debug['diff']['end'] = self._io.pos() - self._debug['fixed']['start'] = self._io.pos() - self.fixed = self._io.read_bits_int(1) != 0 - self._debug['fixed']['end'] = self._io.pos() - self._debug['reserved2']['start'] = self._io.pos() - self.reserved2 = self._io.read_bits_int(8) - self._debug['reserved2']['end'] = self._io.pos() - - - - @property - def header_size(self): - if hasattr(self, '_m_header_size'): - return self._m_header_size if hasattr(self, '_m_header_size') else None - - self._m_header_size = (self.header_size_optional if self.subheader_size_is_dynamic else 336) - return self._m_header_size if hasattr(self, '_m_header_size') else None - - @property - def blocks_map_offset(self): - if hasattr(self, '_m_blocks_map_offset'): - return self._m_blocks_map_offset if hasattr(self, '_m_blocks_map_offset') else None - - self._m_blocks_map_offset = self.header_main.blocks_map_offset - return self._m_blocks_map_offset if hasattr(self, '_m_blocks_map_offset') else None - - @property - def subheader_size_is_dynamic(self): - if hasattr(self, '_m_subheader_size_is_dynamic'): - return self._m_subheader_size_is_dynamic if hasattr(self, '_m_subheader_size_is_dynamic') else None - - self._m_subheader_size_is_dynamic = self.version.major >= 1 - return self._m_subheader_size_is_dynamic if hasattr(self, '_m_subheader_size_is_dynamic') else None - - @property - def blocks_offset(self): - if hasattr(self, '_m_blocks_offset'): - return self._m_blocks_offset if hasattr(self, '_m_blocks_offset') else None - - self._m_blocks_offset = self.header_main.offset_data - return self._m_blocks_offset if hasattr(self, '_m_blocks_offset') else None - - @property - def block_size(self): - if hasattr(self, '_m_block_size'): - return self._m_block_size if hasattr(self, '_m_block_size') else None - - self._m_block_size = (self.header_main.block_metadata_size + self.header_main.block_data_size) - return self._m_block_size if hasattr(self, '_m_block_size') else None - - @property - def blocks_map_size(self): - if hasattr(self, '_m_blocks_map_size'): - return self._m_blocks_map_size if hasattr(self, '_m_blocks_map_size') else None - - self._m_blocks_map_size = ((((self.header_main.blocks_in_image * 4) + self.header_main.geometry.sector_size) - 1) // self.header_main.geometry.sector_size * self.header_main.geometry.sector_size) - return self._m_blocks_map_size if hasattr(self, '_m_blocks_map_size') else None - - - class BlocksMap(KaitaiStruct): - SEQ_FIELDS = ["index"] - def __init__(self, _io, _parent=None, _root=None): - self._io = _io - self._parent = _parent - self._root = _root if _root else self - self._debug = collections.defaultdict(dict) - - def _read(self): - self._debug['index']['start'] = self._io.pos() - self.index = [None] * (self._root.header.header_main.blocks_in_image) - for i in range(self._root.header.header_main.blocks_in_image): - if not 'arr' in self._debug['index']: - self._debug['index']['arr'] = [] - self._debug['index']['arr'].append({'start': self._io.pos()}) - _t_index = self._root.BlocksMap.BlockIndex(self._io, self, self._root) - _t_index._read() - self.index[i] = _t_index - self._debug['index']['arr'][i]['end'] = self._io.pos() - - self._debug['index']['end'] = self._io.pos() - - class BlockIndex(KaitaiStruct): - SEQ_FIELDS = ["index"] - def __init__(self, _io, _parent=None, _root=None): - self._io = _io - self._parent = _parent - self._root = _root if _root else self - self._debug = collections.defaultdict(dict) - - def _read(self): - self._debug['index']['start'] = self._io.pos() - self.index = self._io.read_u4le() - self._debug['index']['end'] = self._io.pos() - - @property - def is_allocated(self): - if hasattr(self, '_m_is_allocated'): - return self._m_is_allocated if hasattr(self, '_m_is_allocated') else None - - self._m_is_allocated = self.index < self._root.block_discarded - return self._m_is_allocated if hasattr(self, '_m_is_allocated') else None - - @property - def block(self): - if hasattr(self, '_m_block'): - return self._m_block if hasattr(self, '_m_block') else None - - if self.is_allocated: - self._m_block = self._root.disk.blocks[self.index] - - return self._m_block if hasattr(self, '_m_block') else None - - - - class Disk(KaitaiStruct): - SEQ_FIELDS = ["blocks"] - def __init__(self, _io, _parent=None, _root=None): - self._io = _io - self._parent = _parent - self._root = _root if _root else self - self._debug = collections.defaultdict(dict) - - def _read(self): - self._debug['blocks']['start'] = self._io.pos() - self.blocks = [None] * (self._root.header.header_main.blocks_in_image) - for i in range(self._root.header.header_main.blocks_in_image): - if not 'arr' in self._debug['blocks']: - self._debug['blocks']['arr'] = [] - self._debug['blocks']['arr'].append({'start': self._io.pos()}) - _t_blocks = self._root.Disk.Block(self._io, self, self._root) - _t_blocks._read() - self.blocks[i] = _t_blocks - self._debug['blocks']['arr'][i]['end'] = self._io.pos() - - self._debug['blocks']['end'] = self._io.pos() - - class Block(KaitaiStruct): - SEQ_FIELDS = ["metadata", "data"] - def __init__(self, _io, _parent=None, _root=None): - self._io = _io - self._parent = _parent - self._root = _root if _root else self - self._debug = collections.defaultdict(dict) - - def _read(self): - self._debug['metadata']['start'] = self._io.pos() - self.metadata = self._io.read_bytes(self._root.header.header_main.block_metadata_size) - self._debug['metadata']['end'] = self._io.pos() - self._debug['data']['start'] = self._io.pos() - self._raw_data = [] - self.data = [] - i = 0 - while not self._io.is_eof(): - if not 'arr' in self._debug['data']: - self._debug['data']['arr'] = [] - self._debug['data']['arr'].append({'start': self._io.pos()}) - self._raw_data.append(self._io.read_bytes(self._root.header.header_main.block_data_size)) - io = KaitaiStream(BytesIO(self._raw_data[-1])) - _t_data = self._root.Disk.Block.Sector(io, self, self._root) - _t_data._read() - self.data.append(_t_data) - self._debug['data']['arr'][len(self.data) - 1]['end'] = self._io.pos() - i += 1 - - self._debug['data']['end'] = self._io.pos() - - class Sector(KaitaiStruct): - SEQ_FIELDS = ["data"] - def __init__(self, _io, _parent=None, _root=None): - self._io = _io - self._parent = _parent - self._root = _root if _root else self - self._debug = collections.defaultdict(dict) - - def _read(self): - self._debug['data']['start'] = self._io.pos() - self.data = self._io.read_bytes(self._root.header.header_main.geometry.sector_size) - self._debug['data']['end'] = self._io.pos() - - - - - @property - def block_discarded(self): - if hasattr(self, '_m_block_discarded'): - return self._m_block_discarded if hasattr(self, '_m_block_discarded') else None - - self._m_block_discarded = 4294967294 - return self._m_block_discarded if hasattr(self, '_m_block_discarded') else None - - @property - def block_unallocated(self): - if hasattr(self, '_m_block_unallocated'): - return self._m_block_unallocated if hasattr(self, '_m_block_unallocated') else None - - self._m_block_unallocated = 4294967295 - return self._m_block_unallocated if hasattr(self, '_m_block_unallocated') else None - - @property - def blocks_map(self): - """block_index = offset_in_virtual_disk / block_size actual_data_offset = blocks_map[block_index]*block_size+metadata_size+offset_in_block - The blocks_map will take up blocks_in_image_max * sizeof(uint32_t) bytes; since the blocks_map is read and written in a single operation, its size needs to be limited to INT_MAX; furthermore, when opening an image, the blocks_map size is rounded up to be aligned on BDRV_SECTOR_SIZE. Therefore this should satisfy the following: blocks_in_image_max * sizeof(uint32_t) + BDRV_SECTOR_SIZE == INT_MAX + 1 (INT_MAX + 1 is the first value not representable as an int) This guarantees that any value below or equal to the constant will, when multiplied by sizeof(uint32_t) and rounded up to a BDRV_SECTOR_SIZE boundary, still be below or equal to INT_MAX. - """ - if hasattr(self, '_m_blocks_map'): - return self._m_blocks_map if hasattr(self, '_m_blocks_map') else None - - _pos = self._io.pos() - self._io.seek(self.header.blocks_map_offset) - self._debug['_m_blocks_map']['start'] = self._io.pos() - self._raw__m_blocks_map = self._io.read_bytes(self.header.blocks_map_size) - io = KaitaiStream(BytesIO(self._raw__m_blocks_map)) - self._m_blocks_map = self._root.BlocksMap(io, self, self._root) - self._m_blocks_map._read() - self._debug['_m_blocks_map']['end'] = self._io.pos() - self._io.seek(_pos) - return self._m_blocks_map if hasattr(self, '_m_blocks_map') else None - - @property - def disk(self): - if hasattr(self, '_m_disk'): - return self._m_disk if hasattr(self, '_m_disk') else None - - _pos = self._io.pos() - self._io.seek(self.header.blocks_offset) - self._debug['_m_disk']['start'] = self._io.pos() - self._m_disk = self._root.Disk(self._io, self, self._root) - self._m_disk._read() - self._debug['_m_disk']['end'] = self._io.pos() - self._io.seek(_pos) - return self._m_disk if hasattr(self, '_m_disk') else None - - |
