summaryrefslogtreecommitdiff
path: root/test
diff options
context:
space:
mode:
authorLee Duncan <lduncan@suse.com>2022-02-28 07:55:52 -0800
committerLee Duncan <lduncan@suse.com>2022-03-01 10:51:01 -0800
commitfb362918957d65c89da8e02b28d3b0e6edc777b2 (patch)
treeaa72e114f948000b29685fe4164f26cbfad93e0b /test
parent531f9a9876c2a12697fdeedb4d4cf1c1223b185e (diff)
downloadopen-iscsi-fb362918957d65c89da8e02b28d3b0e6edc777b2.tar.gz
test: Cleanup README and TODO
Diffstat (limited to 'test')
-rw-r--r--test/README30
-rw-r--r--test/TODO3
2 files changed, 21 insertions, 12 deletions
diff --git a/test/README b/test/README
index 2c7c2e9..72784c8 100644
--- a/test/README
+++ b/test/README
@@ -1,7 +1,10 @@
---------------------------------------------------------------------------
+
+======
README
======
+--------------------
Setting up the tests
--------------------
@@ -32,6 +35,7 @@ Setting up the tests
* iscsiadm (with the iscsid daemon or service running) [of course]
+-----------------
Running the tests
-----------------
@@ -49,7 +53,8 @@ Running the tests
-i 192.168.20.168 \
-D /dev/sdc
- This can take quite a while to run (how long on my server?). << TODO XXX
+ This can take quite a while to run -- hours -- unless you limit
+ the tests to a subset of the whole suite.
The data on your target iSCSI disc will be wiped, so don't use a target
that has data you wish to save. As far as the size of the target, I
@@ -77,16 +82,7 @@ Running the tests
classes to test things besides regression (like functionality,
bug-fix detection, etc).]
- Here's an exmaple of running just the "test_InitialR2T_off_ImmediateData_off"
- subtest:
-
- # ./test-open-iscsi.py -v -f \
- -t iqn.2003-01.org.linux-iscsi.linux-o2br.x8664:sn.2296be998e2c \
- -i 192.168.20.168 \
- -D /dev/sdc \
- test_InitialR2T_off_ImmediateData_off
-
- ... (start of the output goes here) << TODO XXX
+ See below for an exapmle of how you might use this option.
One can also specify the list of subtests (by number) for each test,
further reducing test executing amount and time, if one wishes, using
@@ -122,9 +118,19 @@ Running the tests
[512,1k,2k,4k,8k,16k,32k,75536,128k,1000000]
- Using this is left an exercise for the reader. :)
+ For example, to run a test for block size 4k, all subtest 12, for
+ the test_HdrDigest_on_DataDigest_on test:
+
+ # ./test-open-iscsi.py -v -f \
+ -t iqn.2003-01.org.linux-iscsi.linux-o2br.x8664:sn.2296be998e2c \
+ -i 192.168.20.168 \
+ -D /dev/sdc \
+ -B 4k \
+ -s 12 \
+ TestRegression.test_HdrDigest_on_DataDigest_on
+------------------
Test Descriptsions
------------------
diff --git a/test/TODO b/test/TODO
index 516d25e..d53f0c9 100644
--- a/test/TODO
+++ b/test/TODO
@@ -54,3 +54,6 @@
when needed, since running all the tests takes forever. Maybe
a "short", "medium", and "long" option, so the caller doesn't
have to remember the arcane command-line options?
+
+* keep track of our session id (when we have one), so that
+ we can log out of just our session more easily