scsi: docs: convert bnx2fc.txt to ReST

Link: https://lore.kernel.org/r/f239116bd2c36f6fc8deb62e325bb8161da04270.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:43 +01:00 committed by Martin K. Petersen
parent 6e5a663d8e
commit 1d4f8dfe2d
2 changed files with 13 additions and 6 deletions

View file

@ -1,3 +1,6 @@
.. SPDX-License-Identifier: GPL-2.0
===========================
Operating FCoE using bnx2fc Operating FCoE using bnx2fc
=========================== ===========================
Broadcom FCoE offload through bnx2fc is full stateful hardware offload that Broadcom FCoE offload through bnx2fc is full stateful hardware offload that
@ -24,6 +27,7 @@ Driver Usage Model:
2. Configure the interfaces on which bnx2fc driver has to operate on. 2. Configure the interfaces on which bnx2fc driver has to operate on.
Here are the steps to configure: Here are the steps to configure:
a. cd /etc/fcoe a. cd /etc/fcoe
b. copy cfg-ethx to cfg-eth5 if FCoE has to be enabled on eth5. b. copy cfg-ethx to cfg-eth5 if FCoE has to be enabled on eth5.
c. Repeat this for all the interfaces where FCoE has to be enabled. c. Repeat this for all the interfaces where FCoE has to be enabled.
@ -39,8 +43,10 @@ discovery and log into the targets.
5. "Symbolic Name" in 'fcoeadm -i' output would display if bnx2fc has claimed 5. "Symbolic Name" in 'fcoeadm -i' output would display if bnx2fc has claimed
the interface. the interface.
Eg:
[root@bh2 ~]# fcoeadm -i Eg::
[root@bh2 ~]# fcoeadm -i
Description: NetXtreme II BCM57712 10 Gigabit Ethernet Description: NetXtreme II BCM57712 10 Gigabit Ethernet
Revision: 01 Revision: 01
Manufacturer: Broadcom Corporation Manufacturer: Broadcom Corporation
@ -60,16 +66,16 @@ Eg:
State: Online State: Online
6. Verify the vlan discovery is performed by running ifconfig and notice 6. Verify the vlan discovery is performed by running ifconfig and notice
<INTERFACE>.<VLAN>-fcoe interfaces are automatically created. <INTERFACE>.<VLAN>-fcoe interfaces are automatically created.
Refer to fcoeadm manpage for more information on fcoeadm operations to Refer to fcoeadm manpage for more information on fcoeadm operations to
create/destroy interfaces or to display lun/target information. create/destroy interfaces or to display lun/target information.
NOTE: NOTE
==== ====
** Broadcom FCoE capable devices implement a DCBX/LLDP client on-chip. Only one ** Broadcom FCoE capable devices implement a DCBX/LLDP client on-chip. Only one
LLDP client is allowed per interface. For proper operation all host software LLDP client is allowed per interface. For proper operation all host software
based DCBX/LLDP clients (e.g. lldpad) must be disabled. To disable lldpad on a based DCBX/LLDP clients (e.g. lldpad) must be disabled. To disable lldpad on a
given interface, run the following command: given interface, run the following command::
lldptool set-lldp -i <interface_name> adminStatus=disabled lldptool set-lldp -i <interface_name> adminStatus=disabled

View file

@ -14,5 +14,6 @@ Linux SCSI Subsystem
aic79xx aic79xx
aic7xxx aic7xxx
bfa bfa
bnx2fc
scsi_transport_srp/figures scsi_transport_srp/figures