mirrors
/
linux-stable
mirror of https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
1
0
Fork 0
Code Issues Releases Wiki Activity

scsi: docs: convert cxgb3i.txt to ReST 

Link: https://lore.kernel.org/r/0708b62b6ec4f0dddc581e412bb02ba6476f4523.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:15:45 +01:00 committed by Martin K. Petersen
parent 977b899ce3
commit d2ba7ca338
2 changed files with 15 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
Documentation/scsi/cxgb3i.txt → Documentation/scsi/cxgb3i.rst
View File

@ -1,4 +1,8 @@
.. SPDX-License-Identifier: GPL-2.0
=================================
Chelsio S3 iSCSI Driver for Linux Chelsio S3 iSCSI Driver for Linux
=================================
Introduction Introduction
============ ============
@ -49,7 +53,8 @@ The following steps need to be taken to accelerates the open-iscsi initiator:
The cxgb3i module registers a new transport class "cxgb3i" with open-iscsi. The cxgb3i module registers a new transport class "cxgb3i" with open-iscsi.
* in the case of recompiling the kernel, the cxgb3i selection is located at * in the case of recompiling the kernel, the cxgb3i selection is located at::
Device Drivers Device Drivers
SCSI device support ---> SCSI device support --->
[*] SCSI low-level drivers ---> [*] SCSI low-level drivers --->
@ -58,25 +63,26 @@ The following steps need to be taken to accelerates the open-iscsi initiator:
2. Create an interface file located under /etc/iscsi/ifaces/ for the new 2. Create an interface file located under /etc/iscsi/ifaces/ for the new
transport class "cxgb3i". transport class "cxgb3i".
The content of the file should be in the following format: The content of the file should be in the following format::
iface.transport_name = cxgb3i iface.transport_name = cxgb3i
iface.net_ifacename = <ethX> iface.net_ifacename = <ethX>
iface.ipaddress = <iscsi ip address> iface.ipaddress = <iscsi ip address>
* if iface.ipaddress is specified, <iscsi ip address> needs to be either the * if iface.ipaddress is specified, <iscsi ip address> needs to be either the
same as the ethX's ip address or an address on the same subnet. Make same as the ethX's ip address or an address on the same subnet. Make
sure the ip address is unique in the network. sure the ip address is unique in the network.
3. edit /etc/iscsi/iscsid.conf 3. edit /etc/iscsi/iscsid.conf
The default setting for MaxRecvDataSegmentLength (131072) is too big; The default setting for MaxRecvDataSegmentLength (131072) is too big;
replace with a value no bigger than 15360 (for example 8192): replace with a value no bigger than 15360 (for example 8192)::
node.conn[0].iscsi.MaxRecvDataSegmentLength = 8192 node.conn[0].iscsi.MaxRecvDataSegmentLength = 8192
* The login would fail for a normal session if MaxRecvDataSegmentLength is * The login would fail for a normal session if MaxRecvDataSegmentLength is
too big. A error message in the format of too big. A error message in the format of
"cxgb3i: ERR! MaxRecvSegmentLength <X> too big. Need to be <= <Y>." "cxgb3i: ERR! MaxRecvSegmentLength <X> too big. Need to be <= <Y>."
would be logged to dmesg. would be logged to dmesg.
4. To direct open-iscsi traffic to go through cxgb3i's accelerated path, 4. To direct open-iscsi traffic to go through cxgb3i's accelerated path,
"-I <iface file name>" option needs to be specified with most of the "-I <iface file name>" option needs to be specified with most of the

1
Documentation/scsi/index.rst
View File

@ -16,5 +16,6 @@ Linux SCSI Subsystem
bfa bfa
bnx2fc bnx2fc
BusLogic BusLogic
cxgb3i
scsi_transport_srp/figures scsi_transport_srp/figures