// /*************************************************************************** // Aaru Data Preservation Suite // ---------------------------------------------------------------------------- // // Filename : Read.cs // Author(s) : Natalia Portillo // // Component : Disk image plugins. // // --[ Description ] ---------------------------------------------------------- // // Reads Microsoft Hyper-V disk images. // // --[ License ] -------------------------------------------------------------- // // This library is free software; you can redistribute it and/or modify // it under the terms of the GNU Lesser General Public License as // published by the Free Software Foundation; either version 2.1 of the // License, or (at your option) any later version. // // This library is distributed in the hope that it will be useful, but // WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU // Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public // License along with this library; if not, see . // // ---------------------------------------------------------------------------- // Copyright © 2011-2020 Natalia Portillo // ****************************************************************************/ using System; using System.Collections.Generic; using System.IO; using System.Text; using Aaru.CommonTypes; using Aaru.CommonTypes.Enums; using Aaru.CommonTypes.Exceptions; using Aaru.CommonTypes.Interfaces; using Aaru.Console; using Aaru.Helpers; namespace Aaru.DiscImages { public sealed partial class Vhdx { public bool Open(IFilter imageFilter) { Stream stream = imageFilter.GetDataForkStream(); stream.Seek(0, SeekOrigin.Begin); if(stream.Length < 512) return false; byte[] vhdxIdB = new byte[Marshal.SizeOf()]; stream.Read(vhdxIdB, 0, Marshal.SizeOf()); _vhdxId = Marshal.ByteArrayToStructureLittleEndian(vhdxIdB); if(_vhdxId.signature != VHDX_SIGNATURE) return false; _imageInfo.Application = Encoding.Unicode.GetString(_vhdxId.creator); stream.Seek(64 * 1024, SeekOrigin.Begin); byte[] vHdrB = new byte[Marshal.SizeOf()]; stream.Read(vHdrB, 0, Marshal.SizeOf()); _vHdr = Marshal.ByteArrayToStructureLittleEndian(vHdrB); if(_vHdr.Signature != VHDX_HEADER_SIG) { stream.Seek(128 * 1024, SeekOrigin.Begin); vHdrB = new byte[Marshal.SizeOf()]; stream.Read(vHdrB, 0, Marshal.SizeOf()); _vHdr = Marshal.ByteArrayToStructureLittleEndian(vHdrB); if(_vHdr.Signature != VHDX_HEADER_SIG) throw new ImageNotSupportedException("VHDX header not found"); } stream.Seek(192 * 1024, SeekOrigin.Begin); byte[] vRegTableB = new byte[Marshal.SizeOf()]; stream.Read(vRegTableB, 0, Marshal.SizeOf()); _vRegHdr = Marshal.ByteArrayToStructureLittleEndian(vRegTableB); if(_vRegHdr.signature != VHDX_REGION_SIG) { stream.Seek(256 * 1024, SeekOrigin.Begin); vRegTableB = new byte[Marshal.SizeOf()]; stream.Read(vRegTableB, 0, Marshal.SizeOf()); _vRegHdr = Marshal.ByteArrayToStructureLittleEndian(vRegTableB); if(_vRegHdr.signature != VHDX_REGION_SIG) throw new ImageNotSupportedException("VHDX region table not found"); } _vRegs = new VhdxRegionTableEntry[_vRegHdr.entries]; for(int i = 0; i < _vRegs.Length; i++) { byte[] vRegB = new byte[System.Runtime.InteropServices.Marshal.SizeOf(_vRegs[i])]; stream.Read(vRegB, 0, System.Runtime.InteropServices.Marshal.SizeOf(_vRegs[i])); _vRegs[i] = Marshal.ByteArrayToStructureLittleEndian(vRegB); if(_vRegs[i].guid == _batGuid) _batOffset = (long)_vRegs[i].offset; else if(_vRegs[i].guid == _metadataGuid) _metadataOffset = (long)_vRegs[i].offset; else if((_vRegs[i].flags & REGION_FLAGS_REQUIRED) == REGION_FLAGS_REQUIRED) throw new ImageNotSupportedException($"Found unsupported and required region Guid {_vRegs[i].guid}, not proceeding with image."); } if(_batOffset == 0) throw new Exception("BAT not found, cannot continue."); if(_metadataOffset == 0) throw new Exception("Metadata not found, cannot continue."); uint fileParamsOff = 0, vdSizeOff = 0, p83Off = 0, logOff = 0, physOff = 0, parentOff = 0; stream.Seek(_metadataOffset, SeekOrigin.Begin); byte[] metTableB = new byte[Marshal.SizeOf()]; stream.Read(metTableB, 0, Marshal.SizeOf()); _vMetHdr = Marshal.ByteArrayToStructureLittleEndian(metTableB); _vMets = new VhdxMetadataTableEntry[_vMetHdr.entries]; for(int i = 0; i < _vMets.Length; i++) { byte[] vMetB = new byte[System.Runtime.InteropServices.Marshal.SizeOf(_vMets[i])]; stream.Read(vMetB, 0, System.Runtime.InteropServices.Marshal.SizeOf(_vMets[i])); _vMets[i] = Marshal.ByteArrayToStructureLittleEndian(vMetB); if(_vMets[i].itemId == _fileParametersGuid) fileParamsOff = _vMets[i].offset; else if(_vMets[i].itemId == _virtualDiskSizeGuid) vdSizeOff = _vMets[i].offset; else if(_vMets[i].itemId == _page83DataGuid) p83Off = _vMets[i].offset; else if(_vMets[i].itemId == _logicalSectorSizeGuid) logOff = _vMets[i].offset; else if(_vMets[i].itemId == _physicalSectorSizeGuid) physOff = _vMets[i].offset; else if(_vMets[i].itemId == _parentLocatorGuid) parentOff = _vMets[i].offset; else if((_vMets[i].flags & METADATA_FLAGS_REQUIRED) == METADATA_FLAGS_REQUIRED) throw new ImageNotSupportedException($"Found unsupported and required metadata Guid {_vMets[i].itemId}, not proceeding with image."); } byte[] tmp; if(fileParamsOff != 0) { stream.Seek(fileParamsOff + _metadataOffset, SeekOrigin.Begin); tmp = new byte[8]; stream.Read(tmp, 0, 8); _vFileParms = new VhdxFileParameters { blockSize = BitConverter.ToUInt32(tmp, 0), flags = BitConverter.ToUInt32(tmp, 4) }; } else throw new Exception("File parameters not found."); if(vdSizeOff != 0) { stream.Seek(vdSizeOff + _metadataOffset, SeekOrigin.Begin); tmp = new byte[8]; stream.Read(tmp, 0, 8); _virtualDiskSize = BitConverter.ToUInt64(tmp, 0); } else throw new Exception("Virtual disk size not found."); if(p83Off != 0) { stream.Seek(p83Off + _metadataOffset, SeekOrigin.Begin); tmp = new byte[16]; stream.Read(tmp, 0, 16); _page83Data = new Guid(tmp); } if(logOff != 0) { stream.Seek(logOff + _metadataOffset, SeekOrigin.Begin); tmp = new byte[4]; stream.Read(tmp, 0, 4); _logicalSectorSize = BitConverter.ToUInt32(tmp, 0); } else throw new Exception("Logical sector size not found."); if(physOff != 0) { stream.Seek(physOff + _metadataOffset, SeekOrigin.Begin); tmp = new byte[4]; stream.Read(tmp, 0, 4); _physicalSectorSize = BitConverter.ToUInt32(tmp, 0); } else throw new Exception("Physical sector size not found."); if(parentOff != 0 && (_vFileParms.flags & FILE_FLAGS_HAS_PARENT) == FILE_FLAGS_HAS_PARENT) { stream.Seek(parentOff + _metadataOffset, SeekOrigin.Begin); byte[] vParHdrB = new byte[Marshal.SizeOf()]; stream.Read(vParHdrB, 0, Marshal.SizeOf()); _vParHdr = Marshal.ByteArrayToStructureLittleEndian(vParHdrB); if(_vParHdr.locatorType != _parentTypeVhdxGuid) throw new ImageNotSupportedException($"Found unsupported and required parent locator type {_vParHdr.locatorType}, not proceeding with image."); _vPars = new VhdxParentLocatorEntry[_vParHdr.keyValueCount]; for(int i = 0; i < _vPars.Length; i++) { byte[] vParB = new byte[System.Runtime.InteropServices.Marshal.SizeOf(_vPars[i])]; stream.Read(vParB, 0, System.Runtime.InteropServices.Marshal.SizeOf(_vPars[i])); _vPars[i] = Marshal.ByteArrayToStructureLittleEndian(vParB); } } else if((_vFileParms.flags & FILE_FLAGS_HAS_PARENT) == FILE_FLAGS_HAS_PARENT) throw new Exception("Parent locator not found."); if((_vFileParms.flags & FILE_FLAGS_HAS_PARENT) == FILE_FLAGS_HAS_PARENT && _vParHdr.locatorType == _parentTypeVhdxGuid) { _parentImage = new Vhdx(); bool parentWorks = false; foreach(VhdxParentLocatorEntry parentEntry in _vPars) { stream.Seek(parentEntry.keyOffset + _metadataOffset, SeekOrigin.Begin); byte[] tmpKey = new byte[parentEntry.keyLength]; stream.Read(tmpKey, 0, tmpKey.Length); string entryType = Encoding.Unicode.GetString(tmpKey); IFilter parentFilter; if(string.Compare(entryType, RELATIVE_PATH_KEY, StringComparison.OrdinalIgnoreCase) == 0) { stream.Seek(parentEntry.valueOffset + _metadataOffset, SeekOrigin.Begin); byte[] tmpVal = new byte[parentEntry.valueLength]; stream.Read(tmpVal, 0, tmpVal.Length); string entryValue = Encoding.Unicode.GetString(tmpVal); try { parentFilter = new FiltersList().GetFilter(Path.Combine(imageFilter.GetParentFolder(), entryValue)); if(parentFilter != null && _parentImage.Open(parentFilter)) { parentWorks = true; break; } } catch { parentWorks = false; } string relEntry = Path.Combine(Path.GetDirectoryName(imageFilter.GetPath()), entryValue); try { parentFilter = new FiltersList().GetFilter(Path.Combine(imageFilter.GetParentFolder(), relEntry)); if(parentFilter == null || !_parentImage.Open(parentFilter)) continue; parentWorks = true; break; } catch { // ignored } } else if(string.Compare(entryType, VOLUME_PATH_KEY, StringComparison.OrdinalIgnoreCase) == 0 || string.Compare(entryType, ABSOLUTE_WIN32_PATH_KEY, StringComparison.OrdinalIgnoreCase) == 0) { stream.Seek(parentEntry.valueOffset + _metadataOffset, SeekOrigin.Begin); byte[] tmpVal = new byte[parentEntry.valueLength]; stream.Read(tmpVal, 0, tmpVal.Length); string entryValue = Encoding.Unicode.GetString(tmpVal); try { parentFilter = new FiltersList().GetFilter(Path.Combine(imageFilter.GetParentFolder(), entryValue)); if(parentFilter == null || !_parentImage.Open(parentFilter)) continue; parentWorks = true; break; } catch { // ignored } } } if(!parentWorks) throw new Exception("Image is differential but parent cannot be opened."); _hasParent = true; } _chunkRatio = (long)((Math.Pow(2, 23) * _logicalSectorSize) / _vFileParms.blockSize); _dataBlocks = _virtualDiskSize / _vFileParms.blockSize; if(_virtualDiskSize % _vFileParms.blockSize > 0) _dataBlocks++; long batEntries; if(_hasParent) { long sectorBitmapBlocks = (long)_dataBlocks / _chunkRatio; if(_dataBlocks % (ulong)_chunkRatio > 0) sectorBitmapBlocks++; _sectorBitmapPointers = new ulong[sectorBitmapBlocks]; batEntries = sectorBitmapBlocks * (_chunkRatio - 1); } else batEntries = (long)(_dataBlocks + ((_dataBlocks - 1) / (ulong)_chunkRatio)); AaruConsole.DebugWriteLine("VHDX plugin", "Reading BAT"); long readChunks = 0; _blockAllocationTable = new ulong[_dataBlocks]; byte[] batB = new byte[batEntries * 8]; stream.Seek(_batOffset, SeekOrigin.Begin); stream.Read(batB, 0, batB.Length); ulong skipSize = 0; for(ulong i = 0; i < _dataBlocks; i++) if(readChunks == _chunkRatio) { if(_hasParent) _sectorBitmapPointers[skipSize / 8] = BitConverter.ToUInt64(batB, (int)((i * 8) + skipSize)); readChunks = 0; skipSize += 8; } else { _blockAllocationTable[i] = BitConverter.ToUInt64(batB, (int)((i * 8) + skipSize)); readChunks++; } if(_hasParent) { AaruConsole.DebugWriteLine("VHDX plugin", "Reading Sector Bitmap"); var sectorBmpMs = new MemoryStream(); foreach(ulong pt in _sectorBitmapPointers) switch(pt & BAT_FLAGS_MASK) { case SECTOR_BITMAP_NOT_PRESENT: sectorBmpMs.Write(new byte[1048576], 0, 1048576); break; case SECTOR_BITMAP_PRESENT: stream.Seek((long)((pt & BAT_FILE_OFFSET_MASK) * 1048576), SeekOrigin.Begin); byte[] bmp = new byte[1048576]; stream.Read(bmp, 0, bmp.Length); sectorBmpMs.Write(bmp, 0, bmp.Length); break; default: if((pt & BAT_FLAGS_MASK) != 0) throw new ImageNotSupportedException($"Unsupported sector bitmap block flags (0x{pt & BAT_FLAGS_MASK:X16}) found, not proceeding."); break; } _sectorBitmap = sectorBmpMs.ToArray(); sectorBmpMs.Close(); } _maxBlockCache = (int)(MAX_CACHE_SIZE / _vFileParms.blockSize); _maxSectorCache = (int)(MAX_CACHE_SIZE / _logicalSectorSize); _imageStream = stream; _sectorCache = new Dictionary(); _blockCache = new Dictionary(); _imageInfo.CreationTime = imageFilter.GetCreationTime(); _imageInfo.LastModificationTime = imageFilter.GetLastWriteTime(); _imageInfo.MediaTitle = Path.GetFileNameWithoutExtension(imageFilter.GetFilename()); _imageInfo.SectorSize = _logicalSectorSize; _imageInfo.XmlMediaType = XmlMediaType.BlockMedia; _imageInfo.MediaType = MediaType.GENERIC_HDD; _imageInfo.ImageSize = _virtualDiskSize; _imageInfo.Sectors = _imageInfo.ImageSize / _imageInfo.SectorSize; _imageInfo.DriveSerialNumber = _page83Data.ToString(); // TODO: Separate image application from version, need several samples. _imageInfo.Cylinders = (uint)(_imageInfo.Sectors / 16 / 63); _imageInfo.Heads = 16; _imageInfo.SectorsPerTrack = 63; return true; } public byte[] ReadSector(ulong sectorAddress) { if(sectorAddress > _imageInfo.Sectors - 1) throw new ArgumentOutOfRangeException(nameof(sectorAddress), $"Sector address {sectorAddress} not found"); if(_sectorCache.TryGetValue(sectorAddress, out byte[] sector)) return sector; ulong index = (sectorAddress * _logicalSectorSize) / _vFileParms.blockSize; ulong secOff = (sectorAddress * _logicalSectorSize) % _vFileParms.blockSize; ulong blkPtr = _blockAllocationTable[index]; ulong blkFlags = blkPtr & BAT_FLAGS_MASK; if((blkPtr & BAT_RESERVED_MASK) != 0) throw new ImageNotSupportedException($"Unknown flags (0x{blkPtr & BAT_RESERVED_MASK:X16}) set in block pointer"); switch(blkFlags & BAT_FLAGS_MASK) { case PAYLOAD_BLOCK_NOT_PRESENT: return _hasParent ? _parentImage.ReadSector(sectorAddress) : new byte[_logicalSectorSize]; case PAYLOAD_BLOCK_UNDEFINED: case PAYLOAD_BLOCK_ZERO: case PAYLOAD_BLOCK_UNMAPPER: return new byte[_logicalSectorSize]; } bool partialBlock; partialBlock = (blkFlags & BAT_FLAGS_MASK) == PAYLOAD_BLOCK_PARTIALLY_PRESENT; if(partialBlock && _hasParent && !CheckBitmap(sectorAddress)) return _parentImage.ReadSector(sectorAddress); if(!_blockCache.TryGetValue(blkPtr & BAT_FILE_OFFSET_MASK, out byte[] block)) { block = new byte[_vFileParms.blockSize]; _imageStream.Seek((long)(blkPtr & BAT_FILE_OFFSET_MASK), SeekOrigin.Begin); _imageStream.Read(block, 0, block.Length); if(_blockCache.Count >= _maxBlockCache) _blockCache.Clear(); _blockCache.Add(blkPtr & BAT_FILE_OFFSET_MASK, block); } sector = new byte[_logicalSectorSize]; Array.Copy(block, (int)secOff, sector, 0, sector.Length); if(_sectorCache.Count >= _maxSectorCache) _sectorCache.Clear(); _sectorCache.Add(sectorAddress, sector); return sector; } public byte[] ReadSectors(ulong sectorAddress, uint length) { if(sectorAddress > _imageInfo.Sectors - 1) throw new ArgumentOutOfRangeException(nameof(sectorAddress), $"Sector address {sectorAddress} not found"); if(sectorAddress + length > _imageInfo.Sectors) throw new ArgumentOutOfRangeException(nameof(length), $"Requested more sectors ({sectorAddress + length}) than available ({_imageInfo.Sectors})"); var ms = new MemoryStream(); for(uint i = 0; i < length; i++) { byte[] sector = ReadSector(sectorAddress + i); ms.Write(sector, 0, sector.Length); } return ms.ToArray(); } } }