// /*************************************************************************** // Aaru Data Preservation Suite // ---------------------------------------------------------------------------- // // Filename : MHDDLog.cs // Author(s) : Natalia Portillo // // Component : Core algorithms. // // --[ Description ] ---------------------------------------------------------- // // Glue logic to create a binary media scan log in MHDD's format. // // --[ License ] -------------------------------------------------------------- // // This program is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as // published by the Free Software Foundation, either version 3 of the // License, or (at your option) any later version. // // This program 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 General Public License for more details. // // You should have received a copy of the GNU General Public License // along with this program. If not, see . // // ---------------------------------------------------------------------------- // Copyright © 2011-2025 Natalia Portillo // ****************************************************************************/ using System; using System.Globalization; using System.IO; using System.Text; using Aaru.CommonTypes.Enums; using Aaru.CommonTypes.Interfaces; using Aaru.Core.Graphics; using Aaru.Devices; namespace Aaru.Core.Logging; /// Implements a log in the format used by MHDD sealed class MhddLog { const string MHDD_VER = "VER:2 "; readonly string _logFile; readonly IMediaGraph _mediaGraph; readonly MemoryStream _mhddFs; /// Initializes the MHDD log /// Log file /// Device /// Blocks in media /// Bytes per block /// How many blocks read at once /// Disable saving paths or serial numbers in log /// Dimensions in pixel for a square that would contain the block map graph internal MhddLog(string outputFile, Device dev, ulong blocks, ulong blockSize, ulong blocksToRead, bool @private, uint mediaGraphDimensions = 0) { if(dev == null || string.IsNullOrEmpty(outputFile)) return; if(mediaGraphDimensions > 0) _mediaGraph = new BlockMap((int)mediaGraphDimensions, (int)mediaGraphDimensions, blocks); _mhddFs = new MemoryStream(); _logFile = outputFile; string mode = dev.Type switch { DeviceType.ATA or DeviceType.ATAPI => "MODE: IDE", DeviceType.SCSI => "MODE: SCSI", DeviceType.MMC => "MODE: MMC", DeviceType.NVMe => "MODE: NVMe", DeviceType.SecureDigital => "MODE: SD", _ => "MODE: IDE" }; var device = $"DEVICE: {dev.Manufacturer} {dev.Model}"; var fw = $"F/W: {dev.FirmwareRevision}"; var sn = $"S/N: {(@private ? "" : dev.Serial)}"; var sectors = string.Format(new CultureInfo("en-US"), "SECTORS: {0:n0}", blocks); var sectorSize = string.Format(new CultureInfo("en-US"), "SECTOR SIZE: {0:n0} bytes", blockSize); var scanBlockSize = string.Format(new CultureInfo("en-US"), "SCAN BLOCK SIZE: {0:n0} sectors", blocksToRead); byte[] deviceBytes = Encoding.ASCII.GetBytes(device); byte[] modeBytes = Encoding.ASCII.GetBytes(mode); byte[] fwBytes = Encoding.ASCII.GetBytes(fw); byte[] snBytes = Encoding.ASCII.GetBytes(sn); byte[] sectorsBytes = Encoding.ASCII.GetBytes(sectors); byte[] sectorSizeBytes = Encoding.ASCII.GetBytes(sectorSize); byte[] scanBlockSizeBytes = Encoding.ASCII.GetBytes(scanBlockSize); byte[] verBytes = Encoding.ASCII.GetBytes(MHDD_VER); var pointer = (uint)(deviceBytes.Length + modeBytes.Length + fwBytes.Length + snBytes.Length + sectorsBytes.Length + sectorSizeBytes.Length + scanBlockSizeBytes.Length + verBytes.Length + 2 * 9 + // New lines 4); // Pointer var newLine = new byte[2]; newLine[0] = 0x0D; newLine[1] = 0x0A; _mhddFs.Write(BitConverter.GetBytes(pointer), 0, 4); _mhddFs.Write(newLine, 0, 2); _mhddFs.Write(verBytes, 0, verBytes.Length); _mhddFs.Write(newLine, 0, 2); _mhddFs.Write(modeBytes, 0, modeBytes.Length); _mhddFs.Write(newLine, 0, 2); _mhddFs.Write(deviceBytes, 0, deviceBytes.Length); _mhddFs.Write(newLine, 0, 2); _mhddFs.Write(fwBytes, 0, fwBytes.Length); _mhddFs.Write(newLine, 0, 2); _mhddFs.Write(snBytes, 0, snBytes.Length); _mhddFs.Write(newLine, 0, 2); _mhddFs.Write(sectorsBytes, 0, sectorsBytes.Length); _mhddFs.Write(newLine, 0, 2); _mhddFs.Write(sectorSizeBytes, 0, sectorSizeBytes.Length); _mhddFs.Write(newLine, 0, 2); _mhddFs.Write(scanBlockSizeBytes, 0, scanBlockSizeBytes.Length); _mhddFs.Write(newLine, 0, 2); } /// Logs a new read /// Starting sector /// Duration in milliseconds /// How many sectors where read at once internal void Write(ulong sector, double duration, uint length = 1) { if(_logFile == null) return; byte[] sectorBytes = BitConverter.GetBytes(sector); byte[] durationBytes = BitConverter.GetBytes((ulong)(duration * 1000)); _mhddFs.Write(sectorBytes, 0, 8); _mhddFs.Write(durationBytes, 0, 8); switch(duration) { case < 3: _mediaGraph?.PaintSectors(sector, length, 0x00, 0xFF, 0x00); break; case >= 3 and < 10: _mediaGraph?.PaintSectors(sector, length, 0x80, 0xFF, 0x00); break; case >= 10 and < 50: _mediaGraph?.PaintSectors(sector, length, 0xFF, 0xFF, 0x00); break; case >= 50 and < 150: _mediaGraph?.PaintSectors(sector, length, 0xFF, 0xAB, 0x00); break; case >= 150 and < 500: _mediaGraph?.PaintSectors(sector, length, 0xFF, 0x56, 0x00); break; case >= 500: _mediaGraph?.PaintSectors(sector, length, 0xFF, 0x00, 0x00); break; } } /// Closes and writes to file the MHDD log internal void Close() { if(_logFile == null) return; var fs = new FileStream(_logFile, FileMode.Create); _mhddFs.WriteTo(fs); _mhddFs.Close(); fs.Close(); _mediaGraph?.WriteTo(Path.GetFileNameWithoutExtension(_logFile) + ".png"); } }