[linux-2.6-block.git] / Documentation / scsi / tcm_qla2xxx.txt

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
Commit	Line	Data
54a5e73f LO	1	tcm_qla2xxx jam_host attribute
	2	------------------------------
	3	There is now a new module endpoint atribute called jam_host
	4	attribute: jam_host: boolean=0/1
	5	This attribute and accompanying code is only included if the
	6	Kconfig parameter TCM_QLA2XXX_DEBUG is set to Y
	7	By default this jammer code and functionality is disabled
	8
	9	Use this attribute to control the discarding of SCSI commands to a
	10	selected host.
	11	This may be useful for testing error handling and simulating slow drain
	12	and other fabric issues.
	13
	14	Setting a boolean of 1 for the jam_host attribute for a particular host
	15	will discard the commands for that host.
	16	Reset back to 0 to stop the jamming.
	17
	18	Enable host 4 to be jammed
	19	echo 1 > /sys/kernel/config/target/qla2xxx/21:00:00:24:ff:27:8f:ae/tpgt_1/attrib/jam_host
	20
	21	Disable jamming on host 4
	22	echo 0 > /sys/kernel/config/target/qla2xxx/21:00:00:24:ff:27:8f:ae/tpgt_1/attrib/jam_host