// /*************************************************************************** // Aaru Data Preservation Suite // ---------------------------------------------------------------------------- // // Filename : Command.cs // Author(s) : Natalia Portillo // // Component : Linux direct device access. // // --[ Description ] ---------------------------------------------------------- // // Contains a high level representation of the Linux syscalls used to // directly interface devices. // // --[ 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-2022 Natalia Portillo // ****************************************************************************/ using System; using System.Runtime.InteropServices; using System.Text; using Aaru.CommonTypes.Interop; using Aaru.Decoders.ATA; namespace Aaru.Devices.Linux; partial class Device { /// public override int SendScsiCommand(byte[] cdb, ref byte[] buffer, out byte[] senseBuffer, uint timeout, ScsiDirection direction, out double duration, out bool sense) { // We need a timeout if(timeout == 0) timeout = Timeout > 0 ? Timeout : 15; senseBuffer = null; duration = 0; sense = false; if(buffer == null) return -1; ScsiIoctlDirection dir = direction switch { ScsiDirection.In => ScsiIoctlDirection.In, ScsiDirection.Out => ScsiIoctlDirection.Out, ScsiDirection.Bidirectional => ScsiIoctlDirection.Unspecified, ScsiDirection.None => ScsiIoctlDirection.None, _ => ScsiIoctlDirection.Unknown }; var ioHdr = new SgIoHdrT(); senseBuffer = new byte[64]; ioHdr.interface_id = 'S'; ioHdr.cmd_len = (byte)cdb.Length; ioHdr.mx_sb_len = (byte)senseBuffer.Length; ioHdr.dxfer_direction = dir; ioHdr.dxfer_len = (uint)buffer.Length; ioHdr.dxferp = Marshal.AllocHGlobal(buffer.Length); ioHdr.cmdp = Marshal.AllocHGlobal(cdb.Length); ioHdr.sbp = Marshal.AllocHGlobal(senseBuffer.Length); ioHdr.timeout = timeout * 1000; ioHdr.flags = (uint)SgFlags.DirectIo; Marshal.Copy(buffer, 0, ioHdr.dxferp, buffer.Length); Marshal.Copy(cdb, 0, ioHdr.cmdp, cdb.Length); Marshal.Copy(senseBuffer, 0, ioHdr.sbp, senseBuffer.Length); DateTime start = DateTime.UtcNow; int error = Extern.ioctlSg(_fileDescriptor, LinuxIoctl.SgIo, ref ioHdr); DateTime end = DateTime.UtcNow; if(error < 0) error = Marshal.GetLastWin32Error(); Marshal.Copy(ioHdr.dxferp, buffer, 0, buffer.Length); Marshal.Copy(ioHdr.cmdp, cdb, 0, cdb.Length); Marshal.Copy(ioHdr.sbp, senseBuffer, 0, senseBuffer.Length); sense |= (ioHdr.info & SgInfo.OkMask) != SgInfo.Ok; duration = ioHdr.duration > 0 ? ioHdr.duration : (end - start).TotalMilliseconds; Marshal.FreeHGlobal(ioHdr.dxferp); Marshal.FreeHGlobal(ioHdr.cmdp); Marshal.FreeHGlobal(ioHdr.sbp); return error; } /// Converts ATA protocol to SG_IO direction /// ATA protocol /// SG_IO direction static ScsiDirection AtaProtocolToScsiDirection(AtaProtocol protocol) { switch(protocol) { case AtaProtocol.DeviceDiagnostic: case AtaProtocol.DeviceReset: case AtaProtocol.HardReset: case AtaProtocol.NonData: case AtaProtocol.SoftReset: case AtaProtocol.ReturnResponse: return ScsiDirection.None; case AtaProtocol.PioIn: case AtaProtocol.UDmaIn: return ScsiDirection.In; case AtaProtocol.PioOut: case AtaProtocol.UDmaOut: return ScsiDirection.Out; default: return ScsiDirection.Unspecified; } } /// public override int SendAtaCommand(AtaRegistersChs registers, out AtaErrorRegistersChs errorRegisters, AtaProtocol protocol, AtaTransferRegister transferRegister, ref byte[] buffer, uint timeout, bool transferBlocks, out double duration, out bool sense) { // We need a timeout if(timeout == 0) timeout = Timeout > 0 ? Timeout : 15; duration = 0; sense = false; errorRegisters = new AtaErrorRegistersChs(); if(buffer == null) return -1; byte[] cdb = new byte[16]; cdb[0] = (byte)ScsiCommands.AtaPassThrough16; cdb[1] = (byte)(((byte)protocol << 1) & 0x1E); if(transferRegister != AtaTransferRegister.NoTransfer && protocol != AtaProtocol.NonData) { switch(protocol) { case AtaProtocol.PioIn: case AtaProtocol.UDmaIn: cdb[2] = 0x08; break; default: cdb[2] = 0x00; break; } if(transferBlocks) cdb[2] |= 0x04; cdb[2] |= (byte)((int)transferRegister & 0x03); } //cdb[2] |= 0x20; cdb[4] = registers.Feature; cdb[6] = registers.SectorCount; cdb[8] = registers.Sector; cdb[10] = registers.CylinderLow; cdb[12] = registers.CylinderHigh; cdb[13] = registers.DeviceHead; cdb[14] = registers.Command; int error = SendScsiCommand(cdb, ref buffer, out byte[] senseBuffer, timeout, AtaProtocolToScsiDirection(protocol), out duration, out sense); if(senseBuffer.Length < 22 || (senseBuffer[8] != 0x09 && senseBuffer[9] != 0x0C)) return error; errorRegisters.Error = senseBuffer[11]; errorRegisters.SectorCount = senseBuffer[13]; errorRegisters.Sector = senseBuffer[15]; errorRegisters.CylinderLow = senseBuffer[17]; errorRegisters.CylinderHigh = senseBuffer[19]; errorRegisters.DeviceHead = senseBuffer[20]; errorRegisters.Status = senseBuffer[21]; sense = errorRegisters.Error != 0 || (errorRegisters.Status & 0xA5) != 0; return error; } /// public override int SendAtaCommand(AtaRegistersLba28 registers, out AtaErrorRegistersLba28 errorRegisters, AtaProtocol protocol, AtaTransferRegister transferRegister, ref byte[] buffer, uint timeout, bool transferBlocks, out double duration, out bool sense) { // We need a timeout if(timeout == 0) timeout = Timeout > 0 ? Timeout : 15; duration = 0; sense = false; errorRegisters = new AtaErrorRegistersLba28(); if(buffer == null) return -1; byte[] cdb = new byte[16]; cdb[0] = (byte)ScsiCommands.AtaPassThrough16; cdb[1] = (byte)(((byte)protocol << 1) & 0x1E); if(transferRegister != AtaTransferRegister.NoTransfer && protocol != AtaProtocol.NonData) { switch(protocol) { case AtaProtocol.PioIn: case AtaProtocol.UDmaIn: cdb[2] = 0x08; break; default: cdb[2] = 0x00; break; } if(transferBlocks) cdb[2] |= 0x04; cdb[2] |= (byte)((int)transferRegister & 0x03); } cdb[2] |= 0x20; cdb[4] = registers.Feature; cdb[6] = registers.SectorCount; cdb[8] = registers.LbaLow; cdb[10] = registers.LbaMid; cdb[12] = registers.LbaHigh; cdb[13] = registers.DeviceHead; cdb[14] = registers.Command; int error = SendScsiCommand(cdb, ref buffer, out byte[] senseBuffer, timeout, AtaProtocolToScsiDirection(protocol), out duration, out sense); if(senseBuffer.Length < 22 || (senseBuffer[8] != 0x09 && senseBuffer[9] != 0x0C)) return error; errorRegisters.Error = senseBuffer[11]; errorRegisters.SectorCount = senseBuffer[13]; errorRegisters.LbaLow = senseBuffer[15]; errorRegisters.LbaMid = senseBuffer[17]; errorRegisters.LbaHigh = senseBuffer[19]; errorRegisters.DeviceHead = senseBuffer[20]; errorRegisters.Status = senseBuffer[21]; sense = errorRegisters.Error != 0 || (errorRegisters.Status & 0xA5) != 0; return error; } /// public override int SendAtaCommand(AtaRegistersLba48 registers, out AtaErrorRegistersLba48 errorRegisters, AtaProtocol protocol, AtaTransferRegister transferRegister, ref byte[] buffer, uint timeout, bool transferBlocks, out double duration, out bool sense) { // We need a timeout if(timeout == 0) timeout = Timeout > 0 ? Timeout : 15; duration = 0; sense = false; errorRegisters = new AtaErrorRegistersLba48(); if(buffer == null) return -1; byte[] cdb = new byte[16]; cdb[0] = (byte)ScsiCommands.AtaPassThrough16; cdb[1] = (byte)(((byte)protocol << 1) & 0x1E); cdb[1] |= 0x01; if(transferRegister != AtaTransferRegister.NoTransfer && protocol != AtaProtocol.NonData) { switch(protocol) { case AtaProtocol.PioIn: case AtaProtocol.UDmaIn: cdb[2] = 0x08; break; default: cdb[2] = 0x00; break; } if(transferBlocks) cdb[2] |= 0x04; cdb[2] |= (byte)((int)transferRegister & 0x03); } cdb[2] |= 0x20; cdb[3] = (byte)((registers.Feature & 0xFF00) >> 8); cdb[4] = (byte)(registers.Feature & 0xFF); cdb[5] = (byte)((registers.SectorCount & 0xFF00) >> 8); cdb[6] = (byte)(registers.SectorCount & 0xFF); cdb[7] = registers.LbaLowPrevious; cdb[8] = registers.LbaLowCurrent; cdb[9] = registers.LbaMidPrevious; cdb[10] = registers.LbaMidCurrent; cdb[11] = registers.LbaHighPrevious; cdb[12] = registers.LbaHighCurrent; cdb[13] = registers.DeviceHead; cdb[14] = registers.Command; int error = SendScsiCommand(cdb, ref buffer, out byte[] senseBuffer, timeout, AtaProtocolToScsiDirection(protocol), out duration, out sense); if(senseBuffer.Length < 22 || (senseBuffer[8] != 0x09 && senseBuffer[9] != 0x0C)) return error; errorRegisters.Error = senseBuffer[11]; errorRegisters.SectorCount = (ushort)((senseBuffer[12] << 8) + senseBuffer[13]); errorRegisters.LbaLowPrevious = senseBuffer[14]; errorRegisters.LbaLowCurrent = senseBuffer[15]; errorRegisters.LbaMidPrevious = senseBuffer[16]; errorRegisters.LbaMidCurrent = senseBuffer[17]; errorRegisters.LbaHighPrevious = senseBuffer[18]; errorRegisters.LbaHighCurrent = senseBuffer[19]; errorRegisters.DeviceHead = senseBuffer[20]; errorRegisters.Status = senseBuffer[21]; sense = errorRegisters.Error != 0 || (errorRegisters.Status & 0xA5) != 0; sense |= error != 0; return error; } /// public override int SendMmcCommand(MmcCommands command, bool write, bool isApplication, MmcFlags flags, uint argument, uint blockSize, uint blocks, ref byte[] buffer, out uint[] response, out double duration, out bool sense, uint timeout = 15) { // We need a timeout if(timeout == 0) timeout = Timeout > 0 ? Timeout : 15; DateTime start; DateTime end; switch(command) { case MmcCommands.SendCid when _cachedCid != null: { start = DateTime.Now; buffer = new byte[_cachedCid.Length]; Array.Copy(_cachedCid, buffer, buffer.Length); response = new uint[4]; sense = false; end = DateTime.Now; duration = (end - start).TotalMilliseconds; return 0; } case MmcCommands.SendCsd when _cachedCid != null: { start = DateTime.Now; buffer = new byte[_cachedCsd.Length]; Array.Copy(_cachedCsd, buffer, buffer.Length); response = new uint[4]; sense = false; end = DateTime.Now; duration = (end - start).TotalMilliseconds; return 0; } case (MmcCommands)SecureDigitalCommands.SendScr when _cachedScr != null: { start = DateTime.Now; buffer = new byte[_cachedScr.Length]; Array.Copy(_cachedScr, buffer, buffer.Length); response = new uint[4]; sense = false; end = DateTime.Now; duration = (end - start).TotalMilliseconds; return 0; } case (MmcCommands)SecureDigitalCommands.SendOperatingCondition when _cachedOcr != null: case MmcCommands.SendOpCond when _cachedOcr != null: { start = DateTime.Now; buffer = new byte[_cachedOcr.Length]; Array.Copy(_cachedOcr, buffer, buffer.Length); response = new uint[4]; sense = false; end = DateTime.Now; duration = (end - start).TotalMilliseconds; return 0; } } response = null; duration = 0; sense = false; if(buffer == null) return -1; var ioCmd = new MmcIocCmd(); nint bufPtr = Marshal.AllocHGlobal(buffer.Length); ioCmd.write_flag = write; ioCmd.is_ascmd = isApplication; ioCmd.opcode = (uint)command; ioCmd.arg = argument; ioCmd.flags = flags; ioCmd.blksz = blockSize; ioCmd.blocks = blocks; if(timeout > 0) { ioCmd.data_timeout_ns = timeout * 1000000000; ioCmd.cmd_timeout_ms = timeout * 1000; } ioCmd.data_ptr = (ulong)bufPtr; Marshal.Copy(buffer, 0, bufPtr, buffer.Length); start = DateTime.UtcNow; int error = Extern.ioctlMmc(_fileDescriptor, LinuxIoctl.MmcIocCmd, ref ioCmd); end = DateTime.UtcNow; sense |= error < 0; if(error < 0) error = Marshal.GetLastWin32Error(); Marshal.Copy(bufPtr, buffer, 0, buffer.Length); response = ioCmd.response; duration = (end - start).TotalMilliseconds; Marshal.FreeHGlobal(bufPtr); return error; } /// public override int SendMultipleMmcCommands(MmcSingleCommand[] commands, out double duration, out bool sense, uint timeout = 15) { // We need a timeout if(timeout == 0) timeout = Timeout > 0 ? Timeout : 15; duration = 0; sense = false; // Create array for buffers nint[] bufferPointers = new nint[commands.Length]; // Allocate memory for the array for commands byte[] ioMultiCmd = new byte[sizeof(ulong) + (Marshal.SizeOf() * commands.Length)]; // First value of array is uint64 with count of commands Array.Copy(BitConverter.GetBytes((ulong)commands.Length), 0, ioMultiCmd, 0, sizeof(ulong)); int off = sizeof(ulong); for(int i = 0; i < commands.Length; i++) { // Create command var ioCmd = new MmcIocCmd(); // Allocate buffer bufferPointers[i] = Marshal.AllocHGlobal(commands[i].buffer.Length); // Define command ioCmd.write_flag = commands[i].write; ioCmd.is_ascmd = commands[i].isApplication; ioCmd.opcode = (uint)commands[i].command; ioCmd.arg = commands[i].argument; ioCmd.flags = commands[i].flags; ioCmd.blksz = commands[i].blockSize; ioCmd.blocks = commands[i].blocks; if(timeout > 0) { ioCmd.data_timeout_ns = timeout * 1000000000; ioCmd.cmd_timeout_ms = timeout * 1000; } ioCmd.data_ptr = (ulong)bufferPointers[i]; // Copy buffer to unmanaged space Marshal.Copy(commands[i].buffer, 0, bufferPointers[i], commands[i].buffer.Length); // Copy command to array byte[] ioCmdBytes = Helpers.Marshal.StructureToByteArrayLittleEndian(ioCmd); Array.Copy(ioCmdBytes, 0, ioMultiCmd, off, Marshal.SizeOf()); // Advance pointer off += Marshal.SizeOf(); } // Allocate unmanaged memory for array of commands nint ioMultiCmdPtr = Marshal.AllocHGlobal(ioMultiCmd.Length); // Copy array of commands to unmanaged memory Marshal.Copy(ioMultiCmd, 0, ioMultiCmdPtr, ioMultiCmd.Length); // Send command DateTime start = DateTime.UtcNow; int error = Extern.ioctlMmcMulti(_fileDescriptor, LinuxIoctl.MmcIocMultiCmd, ioMultiCmdPtr); DateTime end = DateTime.UtcNow; sense |= error < 0; if(error < 0) error = Marshal.GetLastWin32Error(); duration = (end - start).TotalMilliseconds; off = sizeof(ulong); // Copy array from unmanaged memory Marshal.Copy(ioMultiCmdPtr, ioMultiCmd, 0, ioMultiCmd.Length); // TODO: Use real pointers this is too slow for(int i = 0; i < commands.Length; i++) { byte[] tmp = new byte[Marshal.SizeOf()]; // Copy command to managed space Array.Copy(ioMultiCmd, off, tmp, 0, tmp.Length); MmcIocCmd command = Helpers.Marshal.ByteArrayToStructureLittleEndian(tmp); // Copy response commands[i].response = command.response; // Copy buffer to managed space Marshal.Copy(bufferPointers[i], commands[i].buffer, 0, commands[i].buffer.Length); // Free buffer Marshal.FreeHGlobal(bufferPointers[i]); // Advance pointer off += Marshal.SizeOf(); } // Free unmanaged memory Marshal.FreeHGlobal(ioMultiCmdPtr); return error; } /// public override bool ReOpen() { int ret = Extern.close(_fileDescriptor); if(ret < 0) { LastError = Marshal.GetLastWin32Error(); Error = true; return true; } int newFd = Extern.open(_devicePath, FileFlags.ReadWrite | FileFlags.NonBlocking | FileFlags.CreateNew); if(newFd >= 0) { Error = false; _fileDescriptor = newFd; return false; } int error = Marshal.GetLastWin32Error(); if(error != 13 && error != 30) { LastError = Marshal.GetLastWin32Error(); Error = true; return true; } newFd = Extern.open(_devicePath, FileFlags.Readonly | FileFlags.NonBlocking); if(newFd < 0) { LastError = Marshal.GetLastWin32Error(); Error = true; return true; } Error = false; _fileDescriptor = newFd; return false; } /// Reads the contents of a symbolic link /// Path to the symbolic link /// Contents of the symbolic link static string ReadLink(string path) { nint buf = Marshal.AllocHGlobal(4096); int resultSize; if(DetectOS.Is64Bit) { long result64 = Extern.readlink64(path, buf, 4096); if(result64 <= 0) return null; resultSize = (int)result64; } else { int result = Extern.readlink(path, buf, 4096); if(result <= 0) return null; resultSize = result; } byte[] resultString = new byte[resultSize]; Marshal.Copy(buf, resultString, 0, resultSize); Marshal.FreeHGlobal(buf); return Encoding.ASCII.GetString(resultString); } /// public override bool BufferedOsRead(out byte[] buffer, long offset, uint length, out double duration) { buffer = new byte[length]; DateTime start = DateTime.Now; long sense = Extern.lseek(_fileDescriptor, offset, SeekWhence.Begin); DateTime end = DateTime.Now; if(sense < 0) { duration = (end - start).TotalMilliseconds; Error = true; LastError = Marshal.GetLastWin32Error(); return true; } sense = DetectOS.Is64Bit ? Extern.read64(_fileDescriptor, buffer, length) : Extern.read(_fileDescriptor, buffer, (int)length); end = DateTime.Now; duration = (end - start).TotalMilliseconds; int errno = Marshal.GetLastWin32Error(); if(sense == length) errno = 0; else if(errno == 0) errno = -22; LastError = errno; Error = errno == 0; return errno != 0; } }