Files
libiscsi/test-tool
Bart Van Assche e866dc36e0 test_async_*_simple: Fix a CUnit assertion failure
Using any of the CU_ASSERT macros after a test has finished causes
the test tool to abort. This patch adds an iSCSI logout to two tests
to avoid that the test tool aborts e.g. as follows:

==11578== Process terminating with default action of signal 6 (SIGABRT)
==11578==    at 0x54BB77F: raise (raise.c:58)
==11578==    by 0x54BD379: abort (abort.c:89)
==11578==    by 0x54B3B46: __assert_fail_base (assert.c:92)
==11578==    by 0x54B3BF1: __assert_fail (assert.c:101)
==11578==    by 0x504213E: CU_assertImplementation (in /usr/lib/x86_64-linux-gnu/libcunit.so.1.0.1)
==11578==    by 0x16FA36: test_async_abort_cb (test_async_abort_simple.c:67)
==11578==    by 0x5274B82: iscsi_process_task_mgmt_reply (task_mgmt.c:100)
==11578==    by 0x525E226: iscsi_process_pdu (pdu.c:598)
==11578==    by 0x526F2AA: iscsi_read_from_socket (socket.c:677)
==11578==    by 0x5270015: iscsi_tcp_service (socket.c:963)
==11578==    by 0x52700A5: iscsi_service (socket.c:980)
==11578==    by 0x52707E1: event_loop (sync.c:69)

Signed-off-by: Bart Van Assche <bart.vanassche@sandisk.com>
2017-06-14 08:25:38 -07:00
..
2017-06-03 11:33:51 -07: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