admin/libiscsi
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

README: mention that we can test against /dev/sg devices

Browse Source 
Signed-off-by: Ronnie Sahlberg <ronniesahlberg@gmail.com>
This commit is contained in:
Ronnie Sahlberg
2014-12-21 15:14:29 -08:00
parent 7865a8a26e
commit 3aef8a0d4f
1 changed files with 13 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
README
View File

@@ -79,7 +79,7 @@ Patches for other packages would be welcome.
ISCSI-TEST-CU
=============
./bin/iscsi-test-cu is a CUnit based test tool for scsi and iscsi.
iscsi-test-cu is a CUnit based test tool for scsi and iscsi.
iscsi-test-cu depends on the CUnit library and will only build if libcunit can be
found during configure.
@@ -92,9 +92,9 @@ in a line similar to :
checking whether libcunit is available... yes
Some example commands:
./bin/iscsi-test-cu -l to list all tests.
./bin/iscsi-test-cu -t <test-suite> <iscsi-url> to run a test suite
./bin/iscsi-test-cu -t <test-suite>.<test> <iscsi-url> to run a specific test
iscsi-test-cu -l to list all tests.
iscsi-test-cu -t <test-suite> <iscsi-url> to run a test suite
iscsi-test-cu -t <test-suite>.<test> <iscsi-url> to run a specific test
Most tests only require a single login to the target, but some tests,
for example the it nexus loss tests may need to login two separate sessions.
@@ -116,6 +116,12 @@ These results can be converted to JUnit format using this script:
http://git.cyrusimap.org/cyrus-imapd/plain/cunit/cunit-to-junit.pl
On Linux, the test tool can also access SG_IO devices directly. Just specify the
device as /dev/sg* instead of the iSCSI URL.
Example:
sudo iscsi-test-cu --test LINUX.Read10.Simple /dev/sg1
LD_PRELOAD FUN
==============
@@ -127,7 +133,7 @@ modifications.
For example:
The stat command: this shows the size of the iSCSI LUN as if it was a normal file:
$ LD_PRELOAD=./bin/ld_iscsi.so stat iscsi://127.0.0.1:3262/iqn.ronnie.test/2
$ LD_PRELOAD=ld_iscsi.so stat iscsi://127.0.0.1:3262/iqn.ronnie.test/2
File: `iscsi://127.0.0.1:3262/iqn.ronnie.test/2'
Size: 3431540736 Blocks: 0 IO Block: 0 regular file
Device: 0h/0d Inode: 0 Links: 0
@@ -137,10 +143,10 @@ Modify: 1970-01-01 10:00:00.000000000 +1000
Change: 1970-01-01 10:00:00.000000000 +1000
The cat command, which allows you to read/dump a iSCSI LUN to a file :
$ LD_PRELOAD=./bin/ld_iscsi.so cat iscsi://127.0.0.1:3262/iqn.ronnie.test/2 >copy_of_iscsi_lun
$ LD_PRELOAD=ld_iscsi.so cat iscsi://127.0.0.1:3262/iqn.ronnie.test/2 >copy_of_iscsi_lun
Or using dd even :
$ LD_PRELOAD=./bin/ld_iscsi.so dd if=iscsi://127.0.0.1:3262/iqn.ronnie.test/2 of=copy_of_LUN bs=10M count=1
$ LD_PRELOAD=ld_iscsi.so dd if=iscsi://127.0.0.1:3262/iqn.ronnie.test/2 of=copy_of_LUN bs=10M count=1
The LD_PRELOAD hack is incomplete and needs more functions to be intercepted
before becoming fully functional. Patches welcome!