Files
libiscsi/test-tool
Sitsofe Wheeler 71879c913a Silence clang missing-field-initializers warning
When libiscsi is built with clang several spurious
missing-field-initializers warnings like the following are reported:

test_async_write.c:61:45: error: missing field 'completed' initializer
[-Werror,-Wmissing-field-initializers]
	struct tests_async_write_state state = { 0 };

These appear to be due to clang being overzealous in its checking
because the code is legal C (see
https://llvm.org/bugs/show_bug.cgi?id=21689 ) but it causes compilation
to be aborted. Workaround the problem by specifying a 0 or NULL for each
structure member.
2016-03-31 20:32:47 +01:00
..
2016-03-27 10:51:05 -07:00
2016-03-22 21:27:25 +01: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