BUSNUM DEVNUM

FUNNUM SUBVID MODEL

The first two keywords (BUSNUM and DEVNUM) are used together and have been included for manufacturing purposes.

Do not use them unless you are familiar with PCI device configuration. These two keywords are needed if multiple Broadcom NetXtreme II adapters are installed on a system, and each adapter must be loaded in a specific order.

BUSNUM specifies the PCI bus number and DEVNUM specifies the device number that is assigned to the board when it is configured by the PCI BIOS.

The values for these adapter parameters are displayed in hexadecimal notation when the driver loads (the Net.cfg file expects hexadecimal values). A PCI device scan utility can also be used to find this information. If the driver loads on a single adapter, the displayed values can be used in the Net.cfg file.

If a PCI scan utility displays card 1 at bus 4 and device 11 (hexadecimal), and card 3 at bus 3 and device 13 (hexadecimal), the following load instructions are written to the Net.cfg file (load card 3 first, and optionally load card 1 second):

LINK DRIVER BX2 BUSNUM 3

DEVNUM 13 (13 hex = 19 decimal) LINK DRIVER BX2

BUSNUM 4

DEVNUM 11 (11 hex = 17 decimal)

The FUNNUM keyword is used to determine which function/port the driver is to load on when using a multifunction (multiport) adapter. Function number values are limited to 0 and 1, for the first and second function of the adapter.

The SUBVID keyword is used to for load the driver only on the first network interface card found that has a subvendor ID (SVID) that matches the one set in Net.cfg. The driver ignores all other network interface cards that do not have a matching SVID. SUBVID expects a hexadecimal number.

Bro a d c o m C o rp o r a ti o n

Page 120 DOS ODI Document ENGSRVT52-CDUM100-R

Example:

LINK DRIVER BX2 SUBVID 14E4

SUBVID cannot be used with BUSNUM, DEVNUM or FUNNUM.

The MODEL keyword is for loading the driver only on the first network interface card found that has a subvendor ID (SVID) that matches the one set in MODEL. The driver ignores all other NICs that do not have a matching SVID. MODEL expects a decimal number.

Example:

LINK DRIVER B44 MODEL 5348

Bro a d c o m Co rp o r a ti o n

Document ENGSRVT52-CDUM100-R Linux Driver Software: Broadcom NetXtreme II™ Network Adapter User Guide Page 121

L i nu x D r i v e r S o f t w a r e : B ro a d c o m N e t X t r e m e I I ™ N e t wo r k A d a p t e r U s e r G u i d e

• Introduction

• Limitations

• Packaging

• Installing Linux Driver Software

• Unloading/Removing the Linux Driver

• Patching PCI Files (Optional)

• Network Installations

• Setting Values for Optional Properties

• Driver Defaults

• Driver Messages

• Teaming with Channel Bonding

• Statistics

• Linux iSCSI Offload

I NTRODUCTION

This section discusses the Linux drivers for the Broadcom NetXtreme II network adapters.

Table 1: Broadcom NetXtreme II Linux Drivers

Linux Driver Description

bnx2 cnic

Linux drivers for the BCM5706/BCM5708/BCM5709 10/100/1000/2500 Mbps network adapters. The bnx2 driver is the networking driver and the cnic driver supports additional features required by the bnx2i iSCSI offload driver.

bnx2x Linux driver for the BCM57710/BCM57711 10 Gbps network adapters bnx2i Linux driver to enable iSCSI offload on the BCM5706/BCM5708/BCM5709/

BCM57710/BCM57711 10/100/1000/2500/10000 Mbps network adapters

Bro a d c o m C o rp o r a ti o n

Page 122 Limitations Document ENGSRVT52-CDUM100-R

L IMITATIONS

• bnx2 Driver

• bnx2x Driver

• bnx2i Driver

BNX

2 D

The current version of the driver has been tested on 2.4.x kernels (starting from 2.4.24) and all 2.6.x kernels. The driver may not compile on kernels older than 2.4.24.

NOTE: Support for the 2.4.21 kernels is provided in Red Hat Enterprise Linux 3.

Testing is concentrated on i386 and x86_64 architectures. Only limited testing has been done on other architectures. Minor changes to some source files and Makefile may be needed on some kernels. Additionally, the Makefile will not compile the cnic driver on kernels older than 2.6.16. iSCSI offload is only supported on 2.6.16 and newer kernels.

NOTE: For Broadcom NetXtreme II BCM5708 devices with a silicon revision prior to B2, the open source bnx2 driver does not support the reporting and configuration of NetXtreme II WOL settings via ethtool. For silicon revisions of B2 or later, the bnx2 driver reports support for Magic Packet WOL via ethtool. Enabling support via ethtool is mandatory to successfully wake the system. To determine the silicon revision of your Broadcom NetXtreme II device, use the lspci command, where “10” = revision B0, “11” = revision B1, and “12” = revision B2.

BNX

2

D

The current version of the driver has been tested on 2.6.x kernels starting from 2.6.9. The driver may not compile on kernels older than 2.6.9. Testing is concentrated on i386 and x86_64 architectures. Only limited testing has been done on some other architectures. Minor changes to some source files and Makefile may be needed on some kernels.

BNX

2

D

The current version of the driver has been tested on 2.6.x kernels, starting from 2.6.18 kernel. The driver may not compile on older kernels with the exception of SLES 10 SP1, which runs 2.6.16.46 kernel. SUSE upgraged the iscsi_transport kernel module in SLES 10 SP1, and Broadcom iSCSI offload initiators is supported on SLES 10 SP1. Testing is concentrated on i386 and x86_64 architectures, Red Hat EL5, and SUSE 10 SP1 distributions. Support added for SLES11U0 running 2.6.27 kernel.

Bro a d c o m Co rp o r a ti o n

Document ENGSRVT52-CDUM100-R Packaging Page 123

P ACKAGING

The Linux driver is released in the packaging formats shown in Table 2. The netxtreme2 package contains the bnx2 (1 Gb network adapter) driver, the bnx2x (10 Gb network adapter) driver, and the bnx2i (iSCSI) driver for source RPM and compressed tar.

Identical source files to build the driver are included in both RPM and TAR source packages. The supplemental tar file contains additional utilities such as patches and driver diskette images for network installation.

Updated open-iSCSI components are released in source RPM format.

• iscsi-initiator-utils-6.2.0.868-0.18e.src.rpm (Red Hat EL 5.3)

• iscsi-initiator-utils-6.2.0.871-0.10d.src.rpm (Red Hat EL 5.4)

• open-iscsi-2.0.707-0.25c.src.rpm

• open-iscsi-2.0.707-0.44f.src.rpm (SLES 10 SP2)

• open-iscsi-2.0.868-0.5.1b.src.rpm (SLES 10 SP3)

Table 2: Linux Driver Packaging

Format Drivers

Source RPM netxtreme2-version.src.rpm

Compressed tar netxtreme2-version.tar.gz

Supplemental tar netxtreme2_sup-version.tar.gz

Bro a d c o m C o rp o r a ti o n

Page 124 Installing Linux Driver Software Document ENGSRVT52-CDUM100-R