SCSI Compliance Test 2.0 (LOGO)
This automated test verifies that a block storage device (RAID adapter or disk target) that is supported by the operating system fully complies with the Small Computer System Interface (SCSI) standards described in the SCSI-3 Primary Commands-3 (SPC-3) or later, and SCSI Block Commands-2 (SBC-2) or later specifications. To see these specifications, go to Technical Committee T10 SCSI Storage Interfaces.
Ensuring that the block device and the operating system maintain compliance with these standards results in a more robust and reliable system. Although some block devices might not be using a SCSI transport, the operating system communicates with them using SCSI commands (except for individual ATA disk drives that are not part of a RAID set).
The test uses SCSI pass-through requests (IOCTL_SCSI_PASS_THROUGH) to construct and send SCSI command descriptor blocks (CDBs) to the device. The test evaluates the results of the commands to verify compliance.
Note
If you are running this test as a part of a Storage RAID Hardware-based RAID (Storage Array) submission, and your storage array supports Multipath I/O (MPIO), you must configure your MPIO to use Fail-Over Only policy, and set the target storage disk to use the same active path for all MPIO-capable disks.
If you are running this test as a part of a Storage RAID Hardware-based RAID (Storage Array) submission, make sure that LUN0 is configured as the largest size non-boot LUN.
Test details
Associated requirements |
Device.Storage.Controller.Raid.BasicFunction Device.Storage.Hd.ScsiProtocol.ReferenceSpec Device.Storage.Hd.ScsiProtocol.SamCompliance Device.Storage.Hd.ScsiProtocol.SpcCompliance |
Platforms |
Windows 7 (x64) Windows 7 (x86) Windows RT (ARM-based) Windows 8 (x64) Windows 8 (x86) Windows Server 2012 (x64) Windows Server 2008 R2 (x64) Windows Server 2008 x64 Windows Server 2008 x86Windows RT 8.1Windows 8.1 x64Windows 8.1 x86Windows Server 2012 R2 |
Expected run time |
~5 minutes |
Categories |
Certification Functional |
Type |
Automated |
Running the test
Before you run the test, complete the test setup as described in the test requirements for the type of storage controller that you are testing. See Hard Disk Drive Testing Prerequisites for more information.
Troubleshooting
For general troubleshooting information, see Troubleshooting Device.Storage Testing.
Also, the test writes the results to the log files Scsicompliance.wtl and Scsicompliance.wtl.txt. You can use the results to determine:
If a device is compliant with the SCSI specification
The optional SCSI commands that are supported by a device
To pass, the SCSI device must support every mandatory command and must be fully compliant with those commands. Each command has a different threshold for pass or fail, and the expectations are specified explicitly in the test and in the log file.
Optional commands are also tested. If a device supports the optional commands and the commands are found to be non-compliant, the test fails. If the device does not support optional commands, the test passes.
Note
Errors from this test occur via issues identified in the log file and in stop errors produced through stressing the driver under test.
During the test, if you are having trouble removing a LUN that is failing or are unable to create a LUN from the storage controller, follow these steps:
Prior to running this test, verify that the storage device works properly. Open diskmgmt.msc, select the disk, and make sure that you can put the device Online and Initialized.
Restart the Windows HCK test computer.
Select and rerun the SCSI Compliance Test 2.0. Do not run any test before it.
Run the SCSI Compliance Test (not the SCSI Compliance Test 2.0 (LOGO)) on the same test client and same test storage device. If the test fails again, verify that the storage device is working properly. If the test fails during steps 3 and 4, run the individual failing command data blocks (cdbs) one at a time with the logging verbosity level set to 4 (the highest level of test logging). This will show what data was sent and what data was returned. A test can fail after several cdbs are completed but pass standalone. If this occurs, there is a problem in the firmware or the test.
If you have a device reset that results in the device falling off the bus and subsequent commands to fail, follow these steps:
Copy the test binary (Scsicompliance.exe) from the Windows HCK controller. This file is located at \\controllername\tests\[processorarchitectureofyourclient]\NTTEST\DriversTest\storage\wdk\
Copy the wttlog.dll file from the Windows HCK controller. This file is located at \\<controllername>\Tests\<processorarchitectureofyourclient >\wtt
Place both of these files on the test computer in a separate folder.
From a command prompt, from the directory containing the test binary, type the following command: Scsicompliance.exe /device <deviceID> /verbosity 4 /operation test /scenario <scenario> /CDB <failingcdbname>
Note
DeviceID and scenario values can be found by checking the repro line within the test log. The failingcdbname can be found by running the test binary with the /?option (scsicompliance.exe /?).
Go back to the same directory and review the results to see if you can determine the reason for the test failure.
If you need additional help, collect the txt and wtl logs and share the logs with Microsoft Customer Support.
If you are running this test against Windows Server 2003, make sure the disks or LUNs are not MPIO pseudo-LUNs. MPIO on Windows Server 2003 is not supported.
More information
The following commands are validated:
Note
For more information about Reference, visit the Technical Committee T10 SCSI Storage Interfaces website.
Command: Test Unit Ready
Title: TEST UNIT READY Basic Verification Test
Description: The TEST UNIT READY command provides a means to check if thelogical unit is ready. This is not a request for a self-test. If the logicalunit is able to accept an appropriate medium-access command without returningCHECK CONDITION status, this command shall return a GOOD status.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.33
Expectation: The device must return GOOD (0x0) SCSI status
Rationale: This is a mandatory SPC-3/SPC-4 command.
Command: Request Sense
Title: REQUEST SENSE (6) Support Test
Description: Checking to see if Request Sense Command is supported and returns GOOD status.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.27
Expectation: The device must return GOOD (0x0) SCSI status
Rationale: This command is mandatory in SPC-3/SPC-4 and is used by the initiator to retrieve error sense data for failed commands.
Title: REQUEST SENSE (6) RESPONSE CODE Test
Description: Verify that RESPONSE CODE is either 0x70 or 0x71 or 0x72 or 0x73
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.27
Expectation: RESPONSE CODE == 0x70 or RESPONSE CODE == 0x71 or RESPONSE CODE == 0x72 or RESPONSE CODE == 0x73
Title: REQUEST SENSE (6) Sense Data Length Test
Description: Verify that length of SENSE data is correct (data transferred matches data length reported by the command response).
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.27
Expectation: Additional Sense Length <= Sense data size - 8.
Command: Read 6
Title: READ (6) Basic Verification Test
Description: The device must return GOOD (0x0) SCSI status and the first two blocks of data correctly. This test sends two READ commands reading two different but overlapped blocks of data. Then, it compares the overlapped data. It returns true if the overlapped data is the same between the read operations (implying that the two commands read the same data correctly).
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.5
Expectation: ScsiStatus == 0x0.
Rationale: Some of the applications still use Read 6 and haven't transitioned into Read 10. Therefore we check if this command is implemented and proceed with testing.
Title: READ (6) Sequential Read Test
Description: The device must read 1000 sequential blocks of data correctly. This test sends the command 1000 times, reading 1024 bytes of data sequentially starting at a random block address.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.5
Expectation: All READ (6) commands succeed.
Title: READ (6) Random Read Test
Description: The device must read 1000 random blocks of data correctly. This test sends the command 1000 times, reading data at random logical block address.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.5
Expectation: All READ (6) commands succeed.
Title: READ (6) Read-With-Disk-Cache-Cleared Test
Description: The device must return data correctly after clearing 12MB disk cache. This test first reads 12 MB sequential data for later verification. Then, it clears the disk cache by reading 12 MB random data. Finally, it reads the same 12 MB sequential data to see if the data is same as the one in first read.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.5
Expectation: The 12 MB data read after cache cleared is correct.
Command: Write 6
Title: WRITE (6) Basic Functionality Test
Description: The command writes one block of data to device correctly.This test compares the data we want to write and the one returned by the READ after the write operation. If the data is the same, this implies that the WRITE command writes the data to disk correctly.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.24
Expectation: ScsiStatus == 0x0.
Rationale: Some of the applications still use Write 6 and haven't transitioned into Write 10. Therefore we check if this command is implemented and proceed with testing.
Title: WRITE (6) Sequential Write Test
Description: The command writes 1000 sequential blocks of data correctly.This test sends the command 1000 times, writing data sequentially starting at a random logical block address.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.24
Expectation: All WRITE (6) commands succeed.
Title: WRITE (6) Random Write Test
Description: The command writes 1000 random blocks of data correctly.This test sends the WRITE command 1000 times, writing data at random logical block address.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.24
Expectation: All WRITE (6) commands succeed.
Title: WRITE (6) Write-With-Disk-Cache-Disabled Test
Description: The command writes 12 MB of data correctly with cache disabled.This test writes 12 MB of data to disk. Then, it reads the same 12 MB data that has just been written to verify that the data we just write are correct.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.24
Expectation: The 12 MB data are written correctly.
Title: WRITE (6) Write-With-Disk-Cache-Enabled Test
Description: The command writes 12 MB of data correctly with cache enabled.This test writes 12 MB of data to disk. Then, it sends a SYNCHRONIZE CACHE (10) command to synchronize the logical block address in cache with the ones in disk. Finally, it will read the same 12 MB data that has just been written to verify that the data we just write are correct.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.24
Expectation: The 12 MB data are written correctly.
Command: Inquiry
Title: INQUIRY Basic Verification Test
Description: The device must return GOOD (0x0) SCSI status and data of size smaller than or equal to 255 bytes in response to the INQUIRY command with ALLOCATION LENGTH field set to 255 (0xFF) bytes. The ALLOCATION LENGTH field specifies the maximum number of bytes that an application client has allocated for returned data.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.4
Expectation: The device must return GOOD (0x0) SCSI status and data of size smaller than or equal to 255 bytes.
Title: INQUIRY Test for error when PAGE CODE field is nonzero and EVPD=0.
Description: Checking that an error is returned when PAGE CODE field isnonzero and EVPD=0. Checking that an error is returned when PAGE CODE field isnonzero and EVPD=0.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.4
Expectation: ScsiStatus == 0x2, CHECK CONDITION. ScsiStatus == 0x2, CHECK CONDITION.
Title: INQUIRY Retrieving standard inquiry data.
Description: Checking if we can retrieve standard inquiry data. Checking if we can retrieve standard inquiry data.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.4
Expectation: ScsiStatus == 0x0, GOOD.
Title: INQUIRY Checking size of standard inquiry data.
Description: Standard INQUIRY data shall contain at least 36 bytes.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.4
Expectation: Data Transfer Length >= 36 bytes.
Title: INQUIRY Testing device type field
Description: Checking device type field to ensure it is a direct access device.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.4
Expectation: Device Type == 0x0, Direct-access device.
Title: INQUIRY Testing peripheral qualifier field.
Description: Checking Peripheral Qualifier field.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.4
Expectation: Peripheral qualifier field == 0
Title: INQUIRY VERSION Field Test
Description: The device must return a valid VERSION field of 0x4, 0x5 or 0x6
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.4
Expectation: VERSION is 0x4 (SPC-2) or later for non-SCSI bus type and VERSION is 0x3 (SPC)or later for SCSI bus type.
Title: INQUIRY Checking RESPONSE DATA FORMAT.
Description: Checking that RESPONSE DATA FORMAT == 2.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.4
Expectation: RESPONSE DATA FORMAT == 2.
Title: INQUIRY Checking additional length.
Description: Checking additional length field is correct.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.4
Expectation: Additional Length field == Total Data size - 5
Title: INQUIRY Checking VENDOR IDENTIFICATION field.
Description: Checking that VENDOR IDENTIFICATION field contains valid ASCII.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.4
Expectation: VENDOR IDENTIFICATION field contains valid ASCII.
Title: INQUIRY Checking PRODUCT IDENTIFICATION field.
Description: Checking that PRODUCT IDENTIFICATION field contains valid ASCII.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.4
Expectation: PRODUCT IDENTIFICATION field contains valid ASCII.
Title: INQUIRY Checking PRODUCT REVISION LEVEL field.
Description: Checking that PRODUCT REVISION LEVEL field contains valid ASCII.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.4
Expectation: PRODUCT REVISION LEVEL field contains valid ASCII.
Title: INQUIRY Command Support Data Test.
Description: The device must set the HiSup bit in the Standard Inquiry Data.
Reference: SCSI Architecture Model - 3 (SAM-3) Revision 14 (or later) specification Section 4.9.2
Expectation: HiSup bit is set in Standard Inquiry Data.
Title: INQUIRY Checking for Supported Vital Product Pages.
Description: Checking to see if Vital Product Pages are supported.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.4.4
Expectation: List of Supported Vital Product Data Pages is returned.
Title: INQUIRY Testing access to each supported Vital Product Data Page.
Description: Attempting to access each supported Vital Product Data Page.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.4.4
Expectation: Each supported page is accessible (up to 255 bytes).
Title: INQUIRY Attempting Unit Serial Number Page 0x80.
Description: Checking if Unit Serial Number Page 0x80 is supported, and is valid ASCII.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 7.6.10
Expectation: ScsiStatus == 0x0, and result is valid ASCII.
Title: INQUIRY Attempting Device identification Page 0x83.
Description: Checking if Device identification Page 0x83 is supported.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 7.6.3
Expectation: ScsiStatus == 0x0.
Title: INQUIRY Checking Identification Descriptors in VPD page 0x83.
Description: Checking that Identification Descriptors contain meaningful data.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 7.6.3
Expectation: All descriptors are compliant, and contain meaningful data.
Title: INQUIRY Checking Version Descriptors.
Description: Checking to see if Version Descriptors are compliant.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.4
Expectation: Version descriptors exist.
Command: Mode Select 6
Title: MODE SELECT (6) Basic Test
Description: Checking to see if a simple MODE SELECT command, with PF and SP == 0, passes
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.7
Expectation: The device must return GOOD (0x0) SCSI status
Rationale: Our Storage stack uses Caching Mode Page to turn on/off the device caching. Therefore the ability to write to mode pages using Mode Select commands is required.
Title: MODE SELECT 6: MODE SENSE (6) Attempting to get Caching mode page.
Description: Checking to see if a simple MODE SENSE command on Page 0x08 will return GOOD status.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.7
Expectation: The device must return GOOD (0x0) SCSI status
Title: MODE SELECT 6: MODE SENSE (6) Checking Parameters Savable (PS bit).
Description: Checking to see if Parameters Savable bit for the Caching Mode Page is 1.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.7
Expectation: PS == 1.
Title: MODE SELECT 6: MODE SENSE (6) Checking Mode Parameter Header
Description: Verify that MediumType == 0 and BlockDescriptorLength == 0.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.7
Expectation: MediumType == 0x0 and BlockDescriptorLength == 0x0
Title: MODE SELECT 6: MODE SENSE (6) Checking Caching Mode Page Length.
Description: Checking the Caching Mode Page is 20 bytes.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.7
Expectation: cachePageLength == 20 bytes.
Title: MODE SELECT 6: MODE SENSE (6) Getting Changeable values.
Description: Saving away Changeable Values for Caching Mode Page
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.7
Expectation: The device must return GOOD (0x0) SCSI status
Title: MODE SELECT 6: MODE SENSE (6) Getting default values.
Description: Saving away Default Values for Caching Mode Page.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.7
Expectation: The device must return GOOD (0x0) SCSI status
Title: MODE SELECT (6) Changing WCE.
Description: Applying MODE SELECT to WCE=0 for the device.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.7
Expectation: The device must return GOOD (0x0) SCSI status
Title: MODE SELECT 6: MODE SENSE (6) Checking that WCE has been cleared.
Description: Checking that the previous MODE SELECT command actually changed the current mode parameters.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.7
Expectation: WCE is clear.
Title: MODE SELECT 6: MODE SENSE (6) Checking that Saved Values have changed.
Description: Checking that the previous MODE SELECT command actually changed the saved mode parameters.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.7
Expectation: Saved values have changed.
Title: MODE SELECT (6) setting WCE
Description: Applying MODE SELECT to set WCE.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.7
Expectation: The device must return GOOD (0x0) SCSI status
Title: MODE SELECT 6: MODE SENSE (6) Checking that WCE has been set.
Description: Checking that the previous MODE SELECT command actually set WCE.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.7
Expectation: Current values have been set.
Title: MODE SELECT (6) Attempting to restore original values.
Description: Testing MODE SELECT can return the Caching Mode Page values to their original values.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.7
Expectation: The device must return GOOD (0x0) SCSI status
Title: MODE SELECT 6: MODE SENSE (6) Verifying values were restored.
Description: Checking that the values were restored in the Caching Mode Page.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.7
Expectation: Current values equal default values.
Command: Mode Sense 6
Title: MODE SENSE (6) Basic Test
Description: Checking to see if a simple MODE SENSE command on Page 0x3f will return GOOD status
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.9
Expectation: The device must return GOOD (0x0) SCSI status
Rationale: Storage stack uses Caching Mode Page to turn on/off the device caching. Therefore the ability to read to mode pages using Mode Sense commands is required.
Title: MODE SENSE (6) Checking size of returned data.
Description: Checking that we receive a minimum amount of data (i.e. at least the MODE PARAMETER HEADER).
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.9
Expectation: Data Transfer Length >= 4 bytes
Title: MODE SENSE (6) Checking MODE PARAMETER HEADER
Description: Checking that the MODE PARAMETER HEADER length information is valid.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.9
Expectation: ModeDataLength = Data Transfer Length - 1 = -1 bytes.
Title: MODE SENSE (6) Test DBD (disable block descriptors) bit.
Description: Testing to make sure that, when DBD bit is set, no block descriptors are returned.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.9
Expectation: Block Descriptor Length = 0
Title: MODE SENSE (6) Testing new data length when DBD bit is set.
Description: : Testing that new data length should equal old data length minus block descriptor length.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.9
Expectation: New Data Length = Old Data Length
Title: MODE SENSE (6) Comparing MODE PAGE data before and after DBD bit is set
Description: Testing that page data is the same before and after DBD bit is set.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.9
Expectation: Page data will match
Title: MODE SENSE (6) Testing Page Control Field
Description: Testing different values of the Page control field, and enforcing the size of the data returned.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.9
Expectation: Data length for each value of PC is correct.
Title: MODE SENSE (6) Scanning All Mode Pages.
Description: Checking Mode Page 0x3f data to examine supported mode pages.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.9
Expectation: To find supported mode pages: Information exception control mode page and Caching mode page.
Title: MODE SENSE (6) Ensuring mandatory mode pages are supported
Description: Checking that required mode pages are present in MODE PAGE 0x3f
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.9
Expectation: Caching and Informational Exception pages are supported, at a minimum.
Title: MODE SENSE (6) Checking Individual Mode Pages
Description: Testing to ensure we can access each individual mode page, and that the paremeters are correct
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.9
Expectation: Pages should be returned and the headers should be compliant
Title: MODE SENSE (6) Checking Informational Exception Mode Page
Description: Ensuring Informational Exception Mode Page is compliant
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.9
Expectation: Power Condition Mode Page is supported
Title: MODE SENSE (6) Checking Informational Exception Mode Page
Description: Ensuring Informational Exception Mode Page is compliant
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.9
Expectation: Power Condition Mode Page is supported
Title: MODE SENSE (6) Checking Power Condition Mode Page.
Description: Ensuring Power Condition Mode Page is compliant
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.9
Expectation: Informational Exception Mode Page is supported
Title: MODE SENSE (6) Checking Caching Mode Page.
Description: Ensuring Caching Mode Page is compliant.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.9
Expectation: Caching Mode Page is supported.
Title: MODE SENSE (6) Checking Device Specific Parameters
Description: This tests to see if the Device specific parameters are supported.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.9
Expectation: Nothing.
Command: Read Capacity 10
Title: READ CAPACITY (10) Basic Verification Test
Description: The device must return GOOD (0x0) SCSI status and 8 bytes of parameter data describing the capacity and medium format of the block device to the data-in buffer.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.10
Expectation: The device must return GOOD (0x0) SCSI status
Rationale: This command is required for formatting operations and initialization.
Command: Read 10
Title: READ (10) Basic Functionality Test
Description: The command reads the first two blocks of data correctly.This test sends two READ commands reading two different but overlapped blocks of data. Then, it compares the overlapped data. It returns true if the overlapped data is the same between the read operations (implying that the two commands read the same data correctly).
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.6
Expectation: Scsi Status == 0x0.
Rationale: Used to Read data from device.
Title: READ (10) Sequential Read Test
Description: The command reads 1000 sequential blocks of data correctly.This test sends the command 1000 times, reading data sequentially starting at a random logical block address.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.6
Expectation: All READ (10) commands succeed.
Title: READ (10) Random Read Test
Description: The command reads 1000 random blocks of data correctly.This test sends the command 1000 times, reading data at random logical block address.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.6
Expectation: All READ (10) commands succeed.
Title: READ (10) Read-With-Disk-Cache-Cleared Test
Description: The command reads 12 MB of data correctly with disk cache cleared.This test first reads 12 MB sequential data for later verification. Then, it clears the disk cache by reading 12 MB random data. Finally, it reads the same 12 MB sequential data to see if the data is same as the one in first read.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.6
Expectation: The 12 MB data read after cache cleared is correct.
Command: Write 10
Title: WRITE (10) Basic Functionality Test
Description: The command writes one block of data to device correctly.This test compares the data we want to write and the one returned by the READ after the write operation. If the data is the same, this implies that the WRITE command writes the data to disk correctly.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.25
Expectation: ScsiStatus == 0x0.
Rationale: Used to write data to device.
Title: WRITE (10) Sequential Write Test
Description: The command writes 1000 sequential blocks of data correctly.This test sends the command 1000 times, writing data sequentially starting at a random logical block address.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.25
Expectation: All WRITE (10) commands succeed.
Title: WRITE (10) Random Write Test
Description: The command writes 1000 random blocks of data correctly.This test sends the WRITE command 1000 times, writing data at random logical block address.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.25
Expectation: All WRITE (10) commands succeed.
Title: WRITE (10) Write-With-Disk-Cache-Disabled Test
Description: The command writes 12 MB of data correctly with cache disabled.This test writes 12 MB of data to disk. Then, it reads the same 12 MB data that has just been written to verify that the data we just write are correct.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.25
Expectation: The 12 MB data are written correctly
Title: WRITE (10) Write-With-Disk-Cache-Enabled Test
Description: The command writes 12 MB of data correctly with cache enabled.This test writes 12 MB of data to disk. Then, it sends a SYNCHRONIZE CACHE (10) command to synchronize the logical block address in cache with the ones in disk. Finally, it will read the same 12 MB data that has just been written to verify that the data we just write are correct.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.25
Expectation: The 12 MB data are written correctly.
Title: WRITE (10) FUA Test
Description: The command writes data to disk correctly with cache and FUA (Force Unit Access) on.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.25.
Expectation: Data is written correctly to disk with FUA on. Checksums of all WRITE (10) are correct.
Title: VERIFY (10) Support Test
Description: Verify that the device supports the VERIFY (10) command. This test issues a simple VERIFY (10) command and checks whether the return code is 0x2 (meaning not supported).
Reference: SCSI Block Commands - 3 (SBC-3) Revision 27 (or published) specification Section 5.28.
Expectation: Scsi Status is 0x0 (GOOD).
Title: VERIFY (10) Zero Length Test
Description: The test sends VERIFY (10) command with both LOGICAL BLOCK ADDRESS and VERIFICATION LENGTH set to 0. Based on the spec, VERIFICATION LENGTH field set to zero specifies that no logical blocks shall be verified. This condition shall not be considered as an error.
Reference: SCSI Block Commands - 3 (SBC-3) Revision 27 (or published) specification Section 5.28.
Expectation: Scsi Status is 0x0 (GOOD).
Title: VERIFY (10) Random LBA Test
Description: The test sends VEIRFY (10) command with VERIFICATION LENGTH = 1 and randomized LOGICAL BLOCK ADDRESS (random between 0 and last LBA).
Reference: SCSI Block Commands - 3 (SBC-3) Revision 27 (or published) specification Section 5.28.
Expectation: Scsi Status is 0x0 (GOOD).
Title: VERIFY (10) Exceed Capacity Test
Description: The test sends VEIRFY (10) command with VERIFICATION LENGTH = 2 and LOGICAL BLOCK ADDRESS set to the last LBA.
Reference: SCSI Block Commands - 3 (SBC-3) Revision 27 (or published) specification Section 5.28.
Expectation: Scsi Status is 0x2 (CHECK CONDITION).
Command: Mode Select 10
Title: MODE SELECT (10) Basic Test
Description: Checking to see if a simple MODE SELECT command, with PF and SP == 0, passes
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.8
Expectation: The device must return GOOD (0x0) SCSI status
Rationale: Mode Select 6 is mandatory and Mode Select 10 is Optional and would be tested if-implemented.
Title: MODE SELECT 10: MODE SENSE (10) Attempting to get Caching mode page.
Description: Checking to see if a simple MODE SENSE command on Page 0x08 will return GOOD status.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.8
Expectation: The device must return GOOD (0x0) SCSI status
Title: MODE SELECT 10: MODE SENSE (10) Checking Parameters Savable (PS bit).
Description: Checking to see if Parameters Savable bit for the Caching Mode Page is 1.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.8
Expectation: PS == 1.
Title: MODE SELECT 10: MODE SENSE (10) Checking Mode Parameter Header
Description: Verify that MediumType == 0 and BlockDescriptorLength == 0.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.8
Expectation: MediumType == 0x0 and BlockDescriptorLength == 0x0
Title: MODE SELECT 10: MODE SENSE (10) Checking Caching Mode Page Length.
Description: Checking the Caching Mode Page is 20 bytes.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.8
Expectation: cachePageLength == 20 bytes.
Title: MODE SELECT 10: MODE SENSE (10) Getting Changeable values.
Description: Saving away Changeable Values for Caching Mode Page
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.8
Expectation: The device must return GOOD (0x0) SCSI status
Title: MODE SELECT 10: MODE SENSE (10) Getting default values.
Description: Saving away Default Values for Caching Mode Page.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.8
Expectation: The device must return GOOD (0x0) SCSI statu
Title: MODE SELECT (10) Changing WCE.
Description: Applying MODE SELECT to WCE=0 for the device.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.8
Expectation: The device must return GOOD (0x0) SCSI status
Title: MODE SELECT 10: MODE SENSE (10) Checking that WCE has been cleared.
Description: Checking that the previous MODE SELECT command actually changed the current mode parameters.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.8
Expectation: : WCE is clear.
Title: MODE SELECT 10: MODE SENSE (10) Checking that Saved Values have changed.
Description: Checking that the previous MODE SELECT command actually changed the saved mode parameters.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.8
Expectation: Saved values have changed.
Title: MODE SELECT (10) setting WCE
Description: Applying MODE SELECT to set WCE.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.8
Expectation: The device must return GOOD (0x0) SCSI status
Title: MODE SELECT 10: MODE SENSE (10) Checking that WCE has been set.
Description: Checking that the previous MODE SELECT command actually set WCE.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.8
Expectation: Current values have been set.
Title: MODE SELECT (10) Attempting to restore original values.
Description: Testing MODE SELECT can return the Caching Mode Page values to their original values
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.8
Expectation: The device must return GOOD (0x0) SCSI status
Title: MODE SELECT 10: MODE SENSE (10) Verifying values were restored.
Description: Checking that the values were restored in the Caching Mode Page.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.8
Expectation: Current values equal default values.
Command: Mode Sense 10
Title: MODE SENSE (10) Basic Test
Description: Checking to see if a simple MODE SENSE10 command on Page 0x3f will return GOOD status
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.10
Expectation: The device must return GOOD (0x0) SCSI status
Rationale: Mode Sense 6 is mandatory and Mode Sense 10 is Optional and would be tested if-implemented.
Title: MODE SENSE (10) Checking size of returned data.
Description: Checking that we receive a minimum amount of data (i.e. at least the MODE PARAMETER HEADER).
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.10
Expectation: Data Transfer Length >= 8 bytes
Title: MODE SENSE (10) Checking MODE PARAMETER HEADER
Description: Checking that the MODE PARAMETER HEADER length information is valid.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.10
Expectation: ModeDataLength = Data Transfer Length - 2 = -2 bytes.
Title: MODE SENSE (10) Test DBD (disable block descriptors) bit.
Description: Testing to make sure that, when DBD bit is set, no block descriptors are returned.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.10
Expectation: Block Descriptor Length = 0
Title: MODE SENSE (10) Comparing MODE PAGE data before and after DBD bit is set
Description: Testing that page data is the same before and after DBD bit is set.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.10
Expectation: Page data will match
Title: MODE SENSE (10) Testing Page Control Field
Description: Testing different values of the Page control field, and enforcing the size of the data returned.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.10
Expectation: Data length for each value of PC is correct and PC=0 and PC=2 return good status.
Command: Read 16
Title: READ (16) Support Test
Description: Verify that the device supports the READ (16) command.This test issues a simple READ (16) command and checks whether the return code is 0x2 (meaning not supported).
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.8
Expectation: Scsi Status is 0x0.
Title: READ (16) Basic Functionality Test
Description: The command reads the first two blocks of data correctly.This test sends two READ commands reading two different but overlapped blocks of data. Then, it compares the overlapped data. It returns true if the overlapped data is the same between the read operations (implying that the two commands read the same data correctly).
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.8
Expectation: Scsi Status is 0x0.
Rationale: If device is 64-bit LBA, Read 16 is Mandatory to read entire disk. Else its if-implemented.
Title: READ (16) Sequential Read Test
Description: The device must read 1000 sequential blocks of data correctly. This test sends the command 1000 times, reading data sequentially starting at a random logical block address.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.8
Expectation: All READ (16) commands succeed.
Title: READ (16) Random Read Test
Description: The command reads 1000 random blocks of data correctly.This test sends READ (16) command 1000 times, reading data at random logical block address.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.8
Expectation: All READ (16) commands succeed.
Title: READ (16) Read-With-Disk-Cache-Cleared Test
Description: The command reads 12 MB of data correctly with disk cache cleared.This test first reads 12 MB sequential data for later verification. Then, it clears the disk cache by reading 12 MB random data. Finally, it reads the same 12 MB sequential data to see if the data is same as the one in first read.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.8
Expectation: The 12 MB data read after cache cleared is correct.
Command: Write 16
Title: WRITE (16) Support Test
Description: Verify that the device supports the command.This test issues a simple WRITE (16) command and checks whether the return code is 0x2 (Check Condition).
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.27
Expectation: ScsiStatus == 0x0.
Title: WRITE (16) Basic Functionality Test
Description: The command writes one block of data to device correctly.This test compares the data we want to write and the one returned by the READ after the write operation. If the data is the same, this implies that the WRITE command writes the data to disk correctly.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.27
Expectation: : ScsiStatus == 0x0.
Rationale: If device is 64-bit LBA, Write 16 is Mandatory to write entire disk. Else its if-implemented.
Title: WRITE (16) Sequential Write Test
Description: The command writes 1000 sequential blocks of data correctly.This test sends the command 1000 times, writing data sequentially starting at a random logical block address.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.27
Expectation: All WRITE (16) commands succeed.
Title: WRITE (16) Random Write Test
Description: The command writes 1000 random blocks of data correctly.This test sends the WRITE command 1000 times, writing data at random logical block address.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.27
Expectation: All WRITE (16) commands succeed.
Title: WRITE (16) Write-With-Disk-Cache-Disabled Test
Description: The command writes 12 MB of data correctly with cache disabled.This test writes 12 MB of data to disk. Then, it reads the same 12 MB data that has just been written to verify that the data we just write are correct.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.27
Expectation: The 12 MB data are written correctly.
Title: WRITE (16) Write-With-Disk-Cache-Enabled Test
Description: The command writes 12 MB of data correctly with cache enabled.This test writes 12 MB of data to disk. Then, it sends a SYNCHRONIZE CACHE (10) command to synchronize the logical block address in cache with the ones in disk. Finally, it will read the same 12 MB data that has just been written to verify that the data we just write are correct.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.27
Expectation: The 12 MB data returned by the WRITEs is correct.
Title: VERIFY (16) Support Test
Description: Verify that the device supports the VERIFY (16) command. This test issues a simple VERIFY (16) command and checks whether the return code is 0x2 (meaning not supported).
Reference: SCSI Block Commands - 3 (SBC-3) Revision 27 (or published) specification Section 5.30.
Expectation: Scsi Status is 0x0 (GOOD).
Title: VERIFY (16) Zero Length Test
Description: The test sends VERIFY (16) command with both LOGICAL BLOCK ADDRESS and VERIFICATION LENGTH set to 0. Based on the spec, VERIFICATION LENGTH field set to zero specifies that no logical blocks shall be verified. This condition shall not be considered as an error.
Reference: SCSI Block Commands - 3 (SBC-3) Revision 27 (or published) specification Section 5.30.
Expectation: Scsi Status is 0x0 (GOOD).
Title: VERIFY (16) Random LBA Test
Description: The test sends VERIFY (16) command with VERIFICATION LENGTH = 1 and randomized LOGICAL BLOCK ADDRESS (random between 0 and last LBA).
Reference: SCSI Block Commands - 3 (SBC-3) Revision 27 (or published) specification Section 5.30.
Expectation: Scsi Status is 0x0 (GOOD).
Title: VERIFY (16) Exceed Capacity Test
Description: The test sends VEIRFY (16) command with VERIFICATION LENGTH = 2 and LOGICAL BLOCK ADDRESS set to the last LBA.
Reference: SCSI Block Commands - 3 (SBC-3) Revision 27 (or published) specification Section 5.30.
Expectation: Scsi Status is 0x2 (CHECK CONDITION).
Command: Report LUNS
Title: REPORT LUNS Basic Verification Test
Description: Attempts to find the LUN 0 corresponding to D.U.T. and execute the REPORT LUNS command. This test will only send REPORT LUNS to LUN 0 at the current target address per SAM-3. This test will only issue a request with SELECT REPORT set to zero per SPC-3.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.21
Expectation: The device must return GOOD (0x0) SCSI status and data of size smaller than or equal to 255 bytes.
Rationale: Report LUNS is used to discover LUNs present on the device. It is Mandatory for UAS. BOT uses the GetMaxLun USB class-specific command instead. So this is optional for BOT devices. Although we check for implementation of this CDB and test this command if implemented.
Title: REPORT LUNS LUN0 Test
Description: This test will only send REPORT LUNS to LUN 0 at the current target address per SAM-3.This test will only issue a request with SELECT REPORT set to zero per SPC-3.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.21
Expectation: The device must return GOOD (0x0) SCSI status and data of size smaller than or equal to 255 bytes.
Title: REPORT LUNS Data valid Test
Description: This test will only send REPORT LUNS to LUN 0 at the current target address per SAM-3.This test will only issue a request with SELECT REPORT set to zero per SPC-3.
Reference: SCSI Primary Commands - 3 (SPC-3) Revision 23 (or published) specification Section 6.21
Expectation: Each reported LUN uses single level numbers restricted to <= 255.
Command: Read Capacity 16
Title: READ CAPACITY (16) Allocation length test
Description: The device must return GOOD (0x0) SCSI status even though allocation lengthis set to 0 value
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.11
Expectation: The device must return GOOD (0x0) SCSI status
Rationale: This command is required for formatting operations and initialization.
Title: READ CAPACITY (16) Basic Verification Test
Description: The device must return GOOD (0x0) SCSI status and 8 bytes of parameter data describing the capacity and medium format of the block device to the data-in buffer.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.11
Expectation: The device must return GOOD (0x0) SCSI status
Title: READ CAPACITY (16) Capacity Test
Description: Send a READ CAPACITY command to check the reported block address. If the block address is greater than the READ CAPACITY 10 limit, ensure READ CAPACITY 10 block address is set to 0xFFFF_FFFF.
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.11
Expectation: For block addresses greater than READ CAPACITY 10 can describe, the READ CAPACITY 10 block address is set to 0xFFFF_FFFF.
Command: Start Stop Unit
Title: START STOP UNIT Basic Test 1
Description: Sending StartStopUnit with IMMED=0, LOEJ=0, START=0, spin down drive
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.17
Expectation: The device must return GOOD (0x0) SCSI status
Rationale: This command is required to ensure data integrity in the face of power state changes and disconnection from the bus.
Title: START STOP UNIT Basic Test 2
Description: Sending StartStopUnit with IMMED=0, LOEJ=0, START=1, spin up drive
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.17
Expectation: The device must return GOOD (0x0) SCSI status
Title: START STOP UNIT Basic Test 3
Description: Sending StartStopUnit with IMMED=1, LOEJ=0, START=0, spin down drive
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.17
Expectation: The device must return GOOD (0x0) SCSI status
Title: START STOP UNIT Basic Test 4
Description: Sending StartStopUnit with IMMED=1, LOEJ=0, START=1, spin up drive
Reference: SCSI Block Commands - 2 (SBC-2) Revision 16 (or published) specification Section 5.17
Expectation: The device must return GOOD (0x0) SCSI status
Parameters
| Parameter | Description |
|---|---|
DiskDeviceObjLink |
The device object link. |
LoggingVerbosity |
Detail of logging. Levels are cumulative. 0 = Assertions and results. 1 = Details. 2 = CDBs , data, and sense info. 3 = Debug and detailed Mode page information. 4 = Memory usage Default value: 4 |
OperationID |
The operation ID. Default value: test |
Command syntax
| Command | Description |
|---|---|
Scsicompliance.exe |
The options for the test are listed below |
/device |
The device which test is to run on Example: /Device <physical device path> |
/operation |
The operation to run. Example: /Operation Test |
/scenario |
The feature to be tested for. Example: /Scenario Common |
/verbosity |
The level of logging verbosity. Larger values cause more verbose output. Example: /Verbosity 4 |
Note
For command-line help for this test binary, type /?.
File list
| File | Location |
|---|---|
Scsicompliance.exe |
<[testbinroot]>\nttest\driverstest\storage\wdk\nttest\ |