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.15~4079^2~97 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=e92c45d27236642b1e0deccc567f305f0fb3d2cc;p=platform%2Fkernel%2Flinux-starfive.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 238dd0a..df005cb 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 c3a670a..91bc1fc 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