From bbf6184202c3010596338124cf1391f6249fe585 Mon Sep 17 00:00:00 2001
From: Bart Van Assche <bvanassche@acm.org>
Date: Sun, 6 Jan 2013 14:44:46 +0000
Subject: [PATCH] ib_srpt: Document LUN masking (merge r4141 from trunk)

git-svn-id: http://svn.code.sf.net/p/scst/svn/branches/2.2.x@4713 d57e44dd-8a1f-0410-8b47-8ef2f437770f
---
 srpt/README | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/srpt/README b/srpt/README
index e7bbadf81..7f40633eb 100644
--- a/srpt/README
+++ b/srpt/README
@@ -241,6 +241,40 @@ $ ls /sys/bus/scst_target/drivers/ib_srpt/*/sessions
 0x00000000000000000002c9030005f34b
 
 
+LUN masking
+-----------
+
+In a straightforward configuration every LUN is visible to every initiator.
+It is possible however to make a different set of LUNs visible to each
+initiator by using the LUN masking feature of SCST. SRP initiators are
+identified by their session name (see above). An example of an scst.conf
+file using LUN masking for ib_srpt:
+
+TARGET_DRIVER ib_srpt {
+        TARGET ib_srpt_target_0 {
+                enabled 1
+                rel_tgt_id 1
+
+                # LUNs visible by all initiators not listed below
+                LUN 0 disk01
+
+                GROUP grp1 {
+                        # LUNs visible by initiator system 1
+                        LUN 0 disk02
+
+                        INITIATOR 0x00000000000000000002c9030005f34b
+                }
+
+                GROUP grp2 {
+                        # LUNs visible by initiator system 2
+                        LUN 0 disk03
+
+                        INITIATOR 0x00000000000000000002c9030005f34c
+                }
+        }
+}
+
+
 Adding and Removing LUNs Dynamically
 ------------------------------------