From: Mauro Carvalho Chehab Date: Mon, 2 Mar 2020 08:16:12 +0000 (+0100) Subject: scsi: docs: convert tcm_qla2xxx.txt to ReST X-Git-Tag: v5.7-rc1~112^2~62 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e92c45d27236642b1e0deccc567f305f0fb3d2cc;p=thirdparty%2Fkernel%2Flinux.git scsi: docs: convert tcm_qla2xxx.txt to ReST Link: https://lore.kernel.org/r/de73fa02f38f67f54f22ef2842f9680c0b34434a.1583136624.git.mchehab+huawei@kernel.org Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Martin K. Petersen --- diff --git a/Documentation/scsi/index.rst b/Documentation/scsi/index.rst index 238dd0ac36a66..df005cb94f6b3 100644 --- a/Documentation/scsi/index.rst +++ b/Documentation/scsi/index.rst @@ -43,5 +43,6 @@ Linux SCSI Subsystem st sym53c500_cs sym53c8xx_2 + tcm_qla2xxx scsi_transport_srp/figures diff --git a/Documentation/scsi/tcm_qla2xxx.txt b/Documentation/scsi/tcm_qla2xxx.rst similarity index 57% rename from Documentation/scsi/tcm_qla2xxx.txt rename to Documentation/scsi/tcm_qla2xxx.rst index c3a670a25e2bb..91bc1fcd369e2 100644 --- a/Documentation/scsi/tcm_qla2xxx.txt +++ b/Documentation/scsi/tcm_qla2xxx.rst @@ -1,22 +1,36 @@ +.. SPDX-License-Identifier: GPL-2.0 + +======================== +tcm_qla2xxx Driver Notes +======================== + tcm_qla2xxx jam_host attribute ------------------------------ There is now a new module endpoint atribute called jam_host -attribute: jam_host: boolean=0/1 +attribute:: + + jam_host: boolean=0/1 + This attribute and accompanying code is only included if the Kconfig parameter TCM_QLA2XXX_DEBUG is set to Y + By default this jammer code and functionality is disabled Use this attribute to control the discarding of SCSI commands to a selected host. + This may be useful for testing error handling and simulating slow drain and other fabric issues. Setting a boolean of 1 for the jam_host attribute for a particular host - will discard the commands for that host. +will discard the commands for that host. + Reset back to 0 to stop the jamming. -Enable host 4 to be jammed -echo 1 > /sys/kernel/config/target/qla2xxx/21:00:00:24:ff:27:8f:ae/tpgt_1/attrib/jam_host +Enable host 4 to be jammed:: + + echo 1 > /sys/kernel/config/target/qla2xxx/21:00:00:24:ff:27:8f:ae/tpgt_1/attrib/jam_host + +Disable jamming on host 4:: -Disable jamming on host 4 -echo 0 > /sys/kernel/config/target/qla2xxx/21:00:00:24:ff:27:8f:ae/tpgt_1/attrib/jam_host + echo 0 > /sys/kernel/config/target/qla2xxx/21:00:00:24:ff:27:8f:ae/tpgt_1/attrib/jam_host