From e92c45d27236642b1e0deccc567f305f0fb3d2cc Mon Sep 17 00:00:00 2001 From: Mauro Carvalho Chehab Date: Mon, 2 Mar 2020 09:16:12 +0100 Subject: 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 --- Documentation/scsi/index.rst | 1 + Documentation/scsi/tcm_qla2xxx.rst | 36 ++++++++++++++++++++++++++++++++++++ Documentation/scsi/tcm_qla2xxx.txt | 22 ---------------------- 3 files changed, 37 insertions(+), 22 deletions(-) create mode 100644 Documentation/scsi/tcm_qla2xxx.rst delete mode 100644 Documentation/scsi/tcm_qla2xxx.txt (limited to 'Documentation/scsi') diff --git a/Documentation/scsi/index.rst b/Documentation/scsi/index.rst index 238dd0ac36a6..df005cb94f6b 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.rst b/Documentation/scsi/tcm_qla2xxx.rst new file mode 100644 index 000000000000..91bc1fcd369e --- /dev/null +++ b/Documentation/scsi/tcm_qla2xxx.rst @@ -0,0 +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 + +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. + +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 + +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 diff --git a/Documentation/scsi/tcm_qla2xxx.txt b/Documentation/scsi/tcm_qla2xxx.txt deleted file mode 100644 index c3a670a25e2b..000000000000 --- a/Documentation/scsi/tcm_qla2xxx.txt +++ /dev/null @@ -1,22 +0,0 @@ -tcm_qla2xxx jam_host attribute ------------------------------- -There is now a new module endpoint atribute called jam_host -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. -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 - -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 -- cgit v1.2.3