Files
libiscsi/test-tool
David Disseldorp 31ab1e1ac9 test-tool: add prin_read_keys() allocation_len parameter
Accepting an Allocation Length parameter allows us to test for
truncation of response data, as per SPC5r17 4.2.5.6:
  The device server shall terminate transfers to the Data-In Buffer when
  the number of bytes or blocks specified by the ALLOCATION LENGTH field
  have been transferred or when all available data have been
  transferred, whichever is less.

With this change, all existing prin_read_keys() callers continue to use
same ALLOCATION LENGTH value as earlier (16K).

Signed-off-by: David Disseldorp <ddiss@suse.de>
2018-05-31 23:08:39 +02:00
..
2016-10-09 11:54:10 -07:00
2012-09-30 08:43:56 -07:00

This directory contains a libiscsi based test tool.
The purpose of this test tool is to validate iscsi and scsi protocol compliance of a target.


Initiatornames and LUN-masking
==============================
If the target uses lun-masking or ACLs you need to set the target up to allow
iscsi-test access to the LUNs you want to test.
By default iscsi-test uses the following two initiator names :
  iqn.2007-10.com.github:sahlberg:libiscsi:iscsi-test
  iqn.2007-10.com.github:sahlberg:libiscsi:iscsi-test-2

Most tests only use the first name but some tests, such as the RESERVE/RELEASE
tests, will use both names.

Optionally you can use different initiatir names for your testing using the
command line flags :
  --initiator-name=iqn.<some other name>
  --initiator-name-2=iqn.<another different name>


Listing all tests and test details:
===================================
The --list argument is used to show a lost of all major tests that are available
  iscsi-test --list

To list all tests and a description of each test and subtests, use
  iscsi-test --list --info

Running tests:
==============
Running tests you need to specify which test to run using the --test argument.
This can either be the name of one specific test or a set of tests using * as
the wildcard character.

Example to run one specific test :
  iscsi-test --test="T1020_bufferoffset_invalid" iscsi://127.0.0.1/iqn.ronnie.test/1

Example to run all READ10 tests :
  iscsi-test --test="*read10*" iscsi://127.0.0.1/iqn.ronnie.test/1

Or to run every test :
  iscsi-test --test="*" iscsi://127.0.0.1/iqn.ronnie.test/1