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 <mchehab+huawei@kernel.org>
Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>
This commit is contained in:
Mauro Carvalho Chehab 2020-03-02 09:16:12 +01:00 committed by Martin K. Petersen
parent f02e84d29e
commit e92c45d272
2 changed files with 21 additions and 6 deletions

View file

@ -43,5 +43,6 @@ Linux SCSI Subsystem
st st
sym53c500_cs sym53c500_cs
sym53c8xx_2 sym53c8xx_2
tcm_qla2xxx
scsi_transport_srp/figures scsi_transport_srp/figures

View file

@ -1,22 +1,36 @@
.. SPDX-License-Identifier: GPL-2.0
========================
tcm_qla2xxx Driver Notes
========================
tcm_qla2xxx jam_host attribute tcm_qla2xxx jam_host attribute
------------------------------ ------------------------------
There is now a new module endpoint atribute called jam_host 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 This attribute and accompanying code is only included if the
Kconfig parameter TCM_QLA2XXX_DEBUG is set to Y Kconfig parameter TCM_QLA2XXX_DEBUG is set to Y
By default this jammer code and functionality is disabled By default this jammer code and functionality is disabled
Use this attribute to control the discarding of SCSI commands to a Use this attribute to control the discarding of SCSI commands to a
selected host. selected host.
This may be useful for testing error handling and simulating slow drain This may be useful for testing error handling and simulating slow drain
and other fabric issues. and other fabric issues.
Setting a boolean of 1 for the jam_host attribute for a particular host 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. Reset back to 0 to stop the jamming.
Enable host 4 to be jammed 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 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