From 91cd5b1efa20d1eb34fd28b60f5bcc2aad1f1f8c Mon Sep 17 00:00:00 2001
From: Bart Van Assche <bvanassche@acm.org>
Date: Sun, 6 Jan 2013 14:51:55 +0000
Subject: [PATCH] ib_srpt: Document P_Key choice (merge r4373 from trunk)

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

diff --git a/srpt/README b/srpt/README
index 972c41902..fb970a2e4 100644
--- a/srpt/README
+++ b/srpt/README
@@ -282,6 +282,25 @@ http://www.garloff.de/kurt/linux/#rescan-scsi. An example:
 $ rescan-scsi-bus --hosts=${srp_host_id} --channels=0 --ids=0 --luns=0-31
 
 
+InfiniBand Partitions
+---------------------
+
+Just like a VLAN allows to segment traffic on an Ethernet network partitions
+allow to segment traffic on an InfiniBand network. Each InfiniBand partition
+is identified by a partition key which is a 16-bit number. During fabric
+initialization the subnet manager assigns one or more partition keys to
+each InfiniBand port. For opensm partitions are defined in
+/etc/opensm/partitions.conf. ib_srpt uses the partition with index 0. Which
+partition key corresponds to index 0 can be found out by querying sysfs:
+
+$ head /sys/class/infiniband/*/ports/*/pkeys/0
+==> /sys/class/infiniband/mlx4_0/ports/1/pkeys/0 <==
+0xffff
+
+==> /sys/class/infiniband/mlx4_0/ports/2/pkeys/0 <==
+0xffff
+
+
 High availability
 -----------------