SCSITarget.cs 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512
  1. using System;
  2. using System.Collections.Generic;
  3. using System.IO;
  4. using System.Text;
  5. using System.Runtime.InteropServices;
  6. using DiskAccessLibrary;
  7. using Utilities;
  8. namespace ISCSI.Server
  9. {
  10. public class SCSITarget
  11. {
  12. private List<Disk> m_disks;
  13. public object WriteLock = new object();
  14. public SCSITarget(List<Disk> disks)
  15. {
  16. m_disks = disks;
  17. }
  18. public SCSIStatusCodeName ExecuteCommand(byte[] commandBytes, LUNStructure lun, byte[] data, out byte[] response)
  19. {
  20. SCSICommandDescriptorBlock command;
  21. try
  22. {
  23. command = SCSICommandDescriptorBlock.FromBytes(commandBytes, 0);
  24. }
  25. catch(UnsupportedSCSICommandException)
  26. {
  27. ISCSIServer.Log("[ExecuteCommand] Unsupported SCSI Command (0x{0})", commandBytes[0].ToString("X"));
  28. response = SCSITarget.FormatSenseData(SenseDataParameter.GetIllegalRequestUnsupportedCommandCodeSenseData());
  29. return SCSIStatusCodeName.CheckCondition;
  30. }
  31. return ExecuteCommand(command, lun, data, out response);
  32. }
  33. public SCSIStatusCodeName ExecuteCommand(SCSICommandDescriptorBlock command, LUNStructure lun, byte[] data, out byte[] response)
  34. {
  35. ISCSIServer.Log("[ExecuteCommand] {0}", command.OpCode);
  36. if (command.OpCode == SCSIOpCodeName.TestUnitReady)
  37. {
  38. return TestUnitReady(lun, out response);
  39. }
  40. else if (command.OpCode == SCSIOpCodeName.RequestSense)
  41. {
  42. return RequestSense(lun, out response);
  43. }
  44. else if (command.OpCode == SCSIOpCodeName.Inquiry)
  45. {
  46. return Inquiry((InquiryCommand)command, lun, out response);
  47. }
  48. else if (command.OpCode == SCSIOpCodeName.Reserve6)
  49. {
  50. return Reserve6(lun, out response);
  51. }
  52. else if (command.OpCode == SCSIOpCodeName.Release6)
  53. {
  54. return Release6(lun, out response);
  55. }
  56. else if (command.OpCode == SCSIOpCodeName.ModeSense6)
  57. {
  58. return ModeSense6((ModeSense6CommandDescriptorBlock)command, lun, out response);
  59. }
  60. else if (command.OpCode == SCSIOpCodeName.ReadCapacity10)
  61. {
  62. return ReadCapacity10(lun, out response);
  63. }
  64. else if (command.OpCode == SCSIOpCodeName.Read6 ||
  65. command.OpCode == SCSIOpCodeName.Read10 ||
  66. command.OpCode == SCSIOpCodeName.Read16)
  67. {
  68. return Read(command, lun, out response);
  69. }
  70. else if (command.OpCode == SCSIOpCodeName.Write6 ||
  71. command.OpCode == SCSIOpCodeName.Write10 ||
  72. command.OpCode == SCSIOpCodeName.Write16)
  73. {
  74. return Write(command, lun, data, out response);
  75. }
  76. else if (command.OpCode == SCSIOpCodeName.Verify10 ||
  77. command.OpCode == SCSIOpCodeName.Verify16)
  78. {
  79. return Verify(lun, out response);
  80. }
  81. else if (command.OpCode == SCSIOpCodeName.SynchronizeCache10)
  82. {
  83. return SynchronizeCache10(lun, out response);
  84. }
  85. else if (command.OpCode == SCSIOpCodeName.ServiceActionIn &&
  86. command.ServiceAction == ServiceAction.ReadCapacity16)
  87. {
  88. return ReadCapacity16(lun, out response);
  89. }
  90. else if (command.OpCode == SCSIOpCodeName.ReportLUNs)
  91. {
  92. return ReportLUNs(out response);
  93. }
  94. else
  95. {
  96. ISCSIServer.Log("[ExecuteCommand] Unsupported SCSI Command (0x{0})", command.OpCode.ToString("X"));
  97. response = FormatSenseData(SenseDataParameter.GetIllegalRequestUnsupportedCommandCodeSenseData());
  98. return SCSIStatusCodeName.CheckCondition;
  99. }
  100. }
  101. public SCSIStatusCodeName Inquiry(InquiryCommand command, LUNStructure lun, out byte[] response)
  102. {
  103. if (lun >= m_disks.Count)
  104. {
  105. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidLUNSenseData());
  106. return SCSIStatusCodeName.CheckCondition;
  107. }
  108. if (!command.EVPD)
  109. {
  110. if ((int)command.PageCode == 0)
  111. {
  112. StandardInquiryData inquiryData = new StandardInquiryData();
  113. inquiryData.PeripheralDeviceType = 0; // Direct access block device
  114. inquiryData.VendorIdentification = "TalAloni";
  115. inquiryData.ProductIdentification = "iSCSI Disk " + ((ushort)lun).ToString();
  116. inquiryData.ProductRevisionLevel = "1.00";
  117. inquiryData.DriveSerialNumber = 0;
  118. inquiryData.CmdQue = true;
  119. inquiryData.Version = 5; // Microsoft iSCSI Target report version 5
  120. if (this is ISCSITarget)
  121. {
  122. inquiryData.VersionDescriptors.Add(0x0960); // iSCSI
  123. }
  124. response = inquiryData.GetBytes();
  125. }
  126. else
  127. {
  128. ISCSIServer.Log("[Inquiry] Invalid request");
  129. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidFieldInCDBSenseData());
  130. return SCSIStatusCodeName.CheckCondition;
  131. }
  132. }
  133. else
  134. {
  135. ISCSIServer.Log("[Inquiry] Page code: 0x{0}", command.PageCode.ToString("X"));
  136. switch (command.PageCode)
  137. {
  138. case VitalProductDataPageName.SupportedVPDPages:
  139. {
  140. SupportedVitaLProductDataPages page = new SupportedVitaLProductDataPages();
  141. page.SupportedPageList.Add((byte)VitalProductDataPageName.SupportedVPDPages);
  142. page.SupportedPageList.Add((byte)VitalProductDataPageName.UnitSerialNumber);
  143. page.SupportedPageList.Add((byte)VitalProductDataPageName.DeviceIdentification);
  144. response = page.GetBytes();
  145. break;
  146. }
  147. case VitalProductDataPageName.UnitSerialNumber:
  148. {
  149. UnitSerialNumberVPDPage page = new UnitSerialNumberVPDPage();
  150. // Older products that only support the Product Serial Number parameter will have a page length of 08h, while newer products that support both parameters (Vendor Unique field from the StandardInquiryData) will have a page length of 14h
  151. // Microsoft iSCSI Target uses values such as "34E5A6FC-3ACC-452D-AEDA-6EE2EFF20FB4"
  152. ulong serialNumber = 0;
  153. page.ProductSerialNumber = serialNumber.ToString("00000000");
  154. response = page.GetBytes();
  155. break;
  156. }
  157. case VitalProductDataPageName.DeviceIdentification:
  158. {
  159. DeviceIdentificationVPDPage page = new DeviceIdentificationVPDPage();
  160. // NAA identifier is needed to prevent 0xF4 BSOD during Windows setup
  161. page.IdentificationDescriptorList.Add(IdentificationDescriptor.GetNAAExtendedIdentifier(5, lun));
  162. if (this is ISCSITarget)
  163. {
  164. // ISCSI identifier is needed for WinPE to pick up the disk during boot (after iPXE's sanhook)
  165. page.IdentificationDescriptorList.Add(IdentificationDescriptor.GetSCSINameStringIdentifier(((ISCSITarget)this).TargetName));
  166. }
  167. response = page.GetBytes();
  168. break;
  169. }
  170. case VitalProductDataPageName.BlockLimits:
  171. {
  172. /* Provide only when requeste explicitly */
  173. BlockLimitsVPDPage page = new BlockLimitsVPDPage();
  174. page.OptimalTransferLengthGranularity = 128;
  175. page.MaximumTransferLength = (uint)DiskAccessLibrary.Settings.MaximumTransferSizeLBA;
  176. page.OptimalTransferLength = 128;
  177. response = page.GetBytes();
  178. break;
  179. }
  180. case VitalProductDataPageName.BlockDeviceCharacteristics:
  181. {
  182. /* Provide only when requeste explicitly */
  183. BlockDeviceCharacteristicsVPDPage page = new BlockDeviceCharacteristicsVPDPage();
  184. page.MediumRotationRate = 0; // Not reported
  185. response = page.GetBytes();
  186. break;
  187. }
  188. default:
  189. {
  190. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidFieldInCDBSenseData());
  191. ISCSIServer.Log("[Inquiry] Unsupported VPD Page request (0x{0})", command.PageCode.ToString("X"));
  192. return SCSIStatusCodeName.CheckCondition;
  193. }
  194. }
  195. }
  196. // we must not return more bytes than InquiryCommand.AllocationLength
  197. if (response.Length > command.AllocationLength)
  198. {
  199. response = ByteReader.ReadBytes(response, 0, command.AllocationLength);
  200. }
  201. return SCSIStatusCodeName.Good;
  202. }
  203. public SCSIStatusCodeName ModeSense6(ModeSense6CommandDescriptorBlock command, LUNStructure lun, out byte[] response)
  204. {
  205. if (lun >= m_disks.Count)
  206. {
  207. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidLUNSenseData());
  208. return SCSIStatusCodeName.CheckCondition;
  209. }
  210. ISCSIServer.Log("[ModeSense6] Page code: 0x{0}, Sub page code: 0x{1}", command.PageCode.ToString("X"), command.SubpageCode.ToString("X"));
  211. byte[] pageData;
  212. switch ((ModePageCodeName)command.PageCode)
  213. {
  214. case ModePageCodeName.CachingParametersPage:
  215. {
  216. CachingParametersPage page = new CachingParametersPage();
  217. page.RCD = true;
  218. pageData = page.GetBytes();
  219. break;
  220. }
  221. case ModePageCodeName.ControlModePage:
  222. {
  223. ControlModePage page = new ControlModePage();
  224. pageData = page.GetBytes();
  225. break;
  226. }
  227. case ModePageCodeName.PowerConditionModePage:
  228. {
  229. if (command.SubpageCode == 0x00)
  230. {
  231. PowerConditionModePage page = new PowerConditionModePage();
  232. pageData = page.GetBytes();
  233. break;
  234. }
  235. else if (command.SubpageCode == 0x01)
  236. {
  237. PowerConsumptionModePage page = new PowerConsumptionModePage();
  238. pageData = page.GetBytes();
  239. break;
  240. }
  241. else
  242. {
  243. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidFieldInCDBSenseData());
  244. ISCSIServer.Log("[ModeSense6] Power condition subpage 0x{0} is not implemented", command.SubpageCode.ToString("x"));
  245. return SCSIStatusCodeName.CheckCondition;
  246. }
  247. }
  248. case ModePageCodeName.InformationalExceptionsControlModePage:
  249. {
  250. InformationalExceptionsControlModePage page = new InformationalExceptionsControlModePage();
  251. pageData = page.GetBytes();
  252. break;
  253. }
  254. case ModePageCodeName.ReturnAllPages:
  255. {
  256. CachingParametersPage page1 = new CachingParametersPage();
  257. page1.RCD = true;
  258. InformationalExceptionsControlModePage page2 = new InformationalExceptionsControlModePage();
  259. pageData = new byte[page1.Length + page2.Length];
  260. Array.Copy(page1.GetBytes(), pageData, page1.Length);
  261. Array.Copy(page2.GetBytes(), 0, pageData, page1.Length, page2.Length);
  262. break;
  263. }
  264. case ModePageCodeName.VendorSpecificPage:
  265. {
  266. // Microsoft iSCSI Target running under Windows 2000 will request this page, we immitate Microsoft iSCSI Target by sending back an empty page
  267. VendorSpecificPage page = new VendorSpecificPage();
  268. pageData = page.GetBytes();
  269. break;
  270. }
  271. default:
  272. {
  273. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidFieldInCDBSenseData());
  274. ISCSIServer.Log("[ModeSense6] ModeSense6 page 0x{0} is not implemented", command.PageCode.ToString("x"));
  275. return SCSIStatusCodeName.CheckCondition;
  276. }
  277. }
  278. ModeParameterHeader6 header = new ModeParameterHeader6();
  279. header.WP = m_disks[lun].IsReadOnly; // Write protected, even when set to true, Windows does not always prevent the disk from being written to.
  280. header.DPOFUA = true; // Microsoft iSCSI Target support this
  281. byte[] descriptorBytes = new byte[0];
  282. if (!command.DBD)
  283. {
  284. ShortLBAModeParameterBlockDescriptor descriptor = new ShortLBAModeParameterBlockDescriptor();
  285. descriptor.LogicalBlockLength = (uint)m_disks[lun].BytesPerSector;
  286. descriptorBytes = descriptor.GetBytes();
  287. }
  288. header.BlockDescriptorLength = (byte)descriptorBytes.Length;
  289. header.ModeDataLength += (byte)(descriptorBytes.Length + pageData.Length);
  290. response = new byte[1 + header.ModeDataLength];
  291. Array.Copy(header.GetBytes(), 0, response, 0, header.Length);
  292. Array.Copy(descriptorBytes, 0, response, header.Length, descriptorBytes.Length);
  293. Array.Copy(pageData, 0, response, header.Length + descriptorBytes.Length, pageData.Length);
  294. return SCSIStatusCodeName.Good;
  295. }
  296. public SCSIStatusCodeName ReadCapacity10(LUNStructure lun, out byte[] response)
  297. {
  298. if (lun >= m_disks.Count)
  299. {
  300. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidLUNSenseData());
  301. return SCSIStatusCodeName.CheckCondition;
  302. }
  303. ReadCapacity10Parameter parameter = new ReadCapacity10Parameter(m_disks[lun].Size, (uint)m_disks[lun].BytesPerSector);
  304. response = parameter.GetBytes();
  305. return SCSIStatusCodeName.Good;
  306. }
  307. public SCSIStatusCodeName ReadCapacity16(LUNStructure lun, out byte[] response)
  308. {
  309. if (lun >= m_disks.Count)
  310. {
  311. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidLUNSenseData());
  312. return SCSIStatusCodeName.CheckCondition;
  313. }
  314. ReadCapacity16Parameter parameter = new ReadCapacity16Parameter(m_disks[lun].Size, (uint)m_disks[lun].BytesPerSector);
  315. response = parameter.GetBytes();
  316. return SCSIStatusCodeName.Good;
  317. }
  318. public SCSIStatusCodeName ReportLUNs(out byte[] response)
  319. {
  320. ReportLUNsParameter parameter = new ReportLUNsParameter(m_disks.Count);
  321. response = parameter.GetBytes();
  322. return SCSIStatusCodeName.Good;
  323. }
  324. public SCSIStatusCodeName Read(SCSICommandDescriptorBlock command, LUNStructure lun, out byte[] response)
  325. {
  326. if (lun >= m_disks.Count)
  327. {
  328. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidLUNSenseData());
  329. return SCSIStatusCodeName.CheckCondition;
  330. }
  331. Disk disk = m_disks[lun];
  332. int sectorCount = (int)command.TransferLength;
  333. try
  334. {
  335. response = disk.ReadSectors((long)command.LogicalBlockAddress64, sectorCount);
  336. return SCSIStatusCodeName.Good;
  337. }
  338. catch (ArgumentOutOfRangeException)
  339. {
  340. ISCSIServer.Log("[Read] Read error: LBA out of range");
  341. response = FormatSenseData(SenseDataParameter.GetIllegalRequestLBAOutOfRangeSenseData());
  342. return SCSIStatusCodeName.CheckCondition;
  343. }
  344. catch (IOException ex)
  345. {
  346. int error = Marshal.GetHRForException(ex);
  347. if (error == (int)Win32Error.ERROR_CRC)
  348. {
  349. ISCSIServer.Log("[Read] Read error: CRC error");
  350. response = FormatSenseData(SenseDataParameter.GetWriteFaultSenseData());
  351. return SCSIStatusCodeName.CheckCondition;
  352. }
  353. else
  354. {
  355. ISCSIServer.Log("[Read] Read error: {0}", ex.ToString());
  356. response = FormatSenseData(SenseDataParameter.GetMediumErrorUnrecoverableReadErrorSenseData());
  357. return SCSIStatusCodeName.CheckCondition;
  358. }
  359. }
  360. }
  361. // Some initiators (i.e. EFI iSCSI DXE) will send 'Request Sense' upon connection (likely just to verify the medium is ready)
  362. public SCSIStatusCodeName RequestSense(LUNStructure lun, out byte[] response)
  363. {
  364. if (lun >= m_disks.Count)
  365. {
  366. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidLUNSenseData());
  367. return SCSIStatusCodeName.CheckCondition;
  368. }
  369. response = FormatSenseData(SenseDataParameter.GetNoSenseSenseData());
  370. return SCSIStatusCodeName.Good;
  371. }
  372. public SCSIStatusCodeName Reserve6(LUNStructure lun, out byte[] response)
  373. {
  374. if (lun >= m_disks.Count)
  375. {
  376. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidLUNSenseData());
  377. return SCSIStatusCodeName.CheckCondition;
  378. }
  379. response = new byte[0];
  380. return SCSIStatusCodeName.Good;
  381. }
  382. public SCSIStatusCodeName SynchronizeCache10(LUNStructure lun, out byte[] response)
  383. {
  384. if (lun >= m_disks.Count)
  385. {
  386. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidLUNSenseData());
  387. return SCSIStatusCodeName.CheckCondition;
  388. }
  389. response = new byte[0];
  390. return SCSIStatusCodeName.Good;
  391. }
  392. public SCSIStatusCodeName Release6(LUNStructure lun, out byte[] response)
  393. {
  394. if (lun >= m_disks.Count)
  395. {
  396. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidLUNSenseData());
  397. return SCSIStatusCodeName.CheckCondition;
  398. }
  399. response = new byte[0];
  400. return SCSIStatusCodeName.Good;
  401. }
  402. public SCSIStatusCodeName TestUnitReady(LUNStructure lun, out byte[] response)
  403. {
  404. if (lun >= m_disks.Count)
  405. {
  406. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidLUNSenseData());
  407. return SCSIStatusCodeName.CheckCondition;
  408. }
  409. response = new byte[0];
  410. return SCSIStatusCodeName.Good;
  411. }
  412. public SCSIStatusCodeName Verify(LUNStructure lun, out byte[] response)
  413. {
  414. if (lun >= m_disks.Count)
  415. {
  416. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidLUNSenseData());
  417. return SCSIStatusCodeName.CheckCondition;
  418. }
  419. response = new byte[0];
  420. return SCSIStatusCodeName.Good;
  421. }
  422. public SCSIStatusCodeName Write(SCSICommandDescriptorBlock command, LUNStructure lun, byte[] data, out byte[] response)
  423. {
  424. if (lun >= m_disks.Count)
  425. {
  426. response = FormatSenseData(SenseDataParameter.GetIllegalRequestInvalidLUNSenseData());
  427. return SCSIStatusCodeName.CheckCondition;
  428. }
  429. Disk disk = m_disks[lun];
  430. if (disk.IsReadOnly)
  431. {
  432. SenseDataParameter senseData = SenseDataParameter.GetDataProtectSenseData();
  433. response = senseData.GetBytes();
  434. return SCSIStatusCodeName.CheckCondition;
  435. }
  436. lock (WriteLock)
  437. {
  438. try
  439. {
  440. disk.WriteSectors((long)command.LogicalBlockAddress64, data);
  441. response = new byte[0];
  442. return SCSIStatusCodeName.Good;
  443. }
  444. catch (ArgumentOutOfRangeException)
  445. {
  446. ISCSIServer.Log("[Write] Write error: LBA out of range");
  447. response = FormatSenseData(SenseDataParameter.GetIllegalRequestLBAOutOfRangeSenseData());
  448. return SCSIStatusCodeName.CheckCondition;
  449. }
  450. catch (IOException ex)
  451. {
  452. ISCSIServer.Log("[Write] Write error: {0}", ex.ToString());
  453. response = FormatSenseData(SenseDataParameter.GetMediumErrorWriteFaultSenseData());
  454. return SCSIStatusCodeName.CheckCondition;
  455. }
  456. }
  457. }
  458. public List<Disk> Disks
  459. {
  460. get
  461. {
  462. return m_disks;
  463. }
  464. }
  465. public static byte[] FormatSenseData(SenseDataParameter senseData)
  466. {
  467. byte[] senseDataBytes = senseData.GetBytes();
  468. byte[] result = new byte[senseDataBytes.Length + 2];
  469. Array.Copy(BigEndianConverter.GetBytes((ushort)senseDataBytes.Length), 0, result, 0, 2);
  470. Array.Copy(senseDataBytes, 0, result, 2, senseDataBytes.Length);
  471. return result;
  472. }
  473. }
  474. }