GNU Linux-libre 6.1.91-gnu
[releases.git] / Documentation / scsi / tcm_qla2xxx.rst
1 .. SPDX-License-Identifier: GPL-2.0
2
3 ========================
4 tcm_qla2xxx Driver Notes
5 ========================
6
7 tcm_qla2xxx jam_host attribute
8 ------------------------------
9 There is now a new module endpoint atribute called jam_host
10 attribute::
11
12         jam_host: boolean=0/1
13
14 This attribute and accompanying code is only included if the
15 Kconfig parameter TCM_QLA2XXX_DEBUG is set to Y
16
17 By default this jammer code and functionality is disabled
18
19 Use this attribute to control the discarding of SCSI commands to a
20 selected host.
21
22 This may be useful for testing error handling and simulating slow drain
23 and other fabric issues.
24
25 Setting a boolean of 1 for the jam_host attribute for a particular host
26 will discard the commands for that host.
27
28 Reset back to 0 to stop the jamming.
29
30 Enable host 4 to be jammed::
31
32   echo 1 > /sys/kernel/config/target/qla2xxx/21:00:00:24:ff:27:8f:ae/tpgt_1/attrib/jam_host
33
34 Disable jamming on host 4::
35
36   echo 0 > /sys/kernel/config/target/qla2xxx/21:00:00:24:ff:27:8f:ae/tpgt_1/attrib/jam_host