From 55f0b001d15b3984967e7f87d6118232078e3fe5 Mon Sep 17 00:00:00 2001
From: Steffen Maier <maier@linux.vnet.ibm.com>
Date: Mon, 14 Aug 2017 17:52:58 +0200
Subject: [PATCH] lsluns: document restriction to zfcp-only systems

Signed-off-by: Steffen Maier <maier@linux.vnet.ibm.com>
Reviewed-by: Jens Remus <jremus@linux.vnet.ibm.com>
Signed-off-by: Michael Holzheu <holzheu@linux.vnet.ibm.com>
---
 zconf/lsluns   | 4 ++++
 zconf/lsluns.8 | 8 ++++++--
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/zconf/lsluns b/zconf/lsluns
index 4d96ebdf..0beea238 100755
--- a/zconf/lsluns
+++ b/zconf/lsluns
@@ -170,6 +170,10 @@ sub get_lun_hash
 sub lsluns_usage {
     print <<EOD;
 Usage:
+This tool is designed for environments where all SCSI devices are attached
+through the zfcp device driver. Expect error messages in mixed environments
+such as with iSCSI.
+
 $PROGRAM_NAME [-c <busid>] ... [-p <wwpn>] ... [-h] [-v]
 
     List LUNs discovered in the Fibre Channel (FC) Storage Area Network (SAN).
diff --git a/zconf/lsluns.8 b/zconf/lsluns.8
index daee0e92..7be5db41 100644
--- a/zconf/lsluns.8
+++ b/zconf/lsluns.8
@@ -4,8 +4,8 @@
 .\"
 .TH LSLUNS 8 "2017-02-17" "s390-tools"
 .SH NAME
-lsluns \- list LUNs discovered in the FC SAN, or show encryption state of
-attached LUNs
+lsluns \- list LUNs discovered in the FC SAN through zfcp, or show encryption state of
+zfcp-attached LUNs
 
 .SH SYNOPSIS
 .B lsluns
@@ -28,6 +28,10 @@ attached LUNs
 
 .SH DESCRIPTION
 .PP
+This tool is designed for environments where all SCSI devices are attached
+through the zfcp device driver. Expect error messages in mixed environments
+such as with iSCSI.
+
 .B lsluns
 lists all logical unit numbers (LUNs) discovered in the
 Fibre Channel (FC) Storage Area Network (SAN).