1.\" $OpenBSD: bnx.4,v 1.32 2021/09/08 20:29:21 jmc Exp $ 2.\" 3.\"Copyright (c) 2006 Broadcom Corporation 4.\" David Christensen <davidch@broadcom.com>. All rights reserved. 5.\" 6.\"Redistribution and use in source and binary forms, with or without 7.\"modification, are permitted provided that the following conditions 8.\"are met: 9.\" 10.\"1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\"2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\"3. Neither the name of Broadcom Corporation nor the name of its contributors 16.\" may be used to endorse or promote products derived from this software 17.\" without specific prior written consent. 18.\" 19.\"THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS' 20.\"AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\"IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\"ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS 23.\"BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 24.\"CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 25.\"SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 26.\"INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 27.\"CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 28.\"ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 29.\"THE POSSIBILITY OF SUCH DAMAGE. 30.\" 31.\" $FreeBSD: /repoman/r/ncvs/src/share/man/man4/bce.4,v 1.2 2006/04/10 20:12:17 brueffer Exp $ 32.\" 33.Dd $Mdocdate: September 8 2021 $ 34.Dt BNX 4 35.Os 36.Sh NAME 37.Nm bnx 38.Nd Broadcom NetXtreme II 10/100/1Gb Ethernet device 39.Sh SYNOPSIS 40.Cd "bnx* at pci?" 41.Cd "brgphy* at mii?" 42.Sh DESCRIPTION 43The 44.Nm 45driver supports Broadcom's NetXtreme II product family which is made up of 46the BCM5706, BCM5708, BCM5709, and BCM5716 Ethernet controller chips. 47Products using these controller chips include: 48.Pp 49.Bl -bullet -compact 50.It 51HP NC370F PCI-X Multifunction Gigabit server adapter (1000baseSX) 52.It 53HP NC370T PCI-X Multifunction Gigabit server adapter (10/100/1000baseT) 54.It 55HP Dual NC370i Multifunction Gigabit embedded server adapter (10/100/1000baseT) 56.It 57HP NC373F PCI Express Multifunction Gigabit server adapter (1000baseSX) 58.It 59HP NC373i PCI Express Multifunction Gigabit embedded server adapter (10/100/1000baseT) 60.It 61HP NC374m PCI Express Multifunction Gigabit embedded server adapter (10/100/1000baseT) 62.It 63HP NC373T PCI Express Multifunction Gigabit server adapter (10/100/1000baseT) 64.It 65HP NC380T PCI Express Dual Port Multifunction Gigabit server adapter (10/100/1000baseT) 66.It 67HP NC382T PCI Express Dual Port server adapter (10/100/1000baseT) 68.El 69.Pp 70The NetXtreme II product family is composed of various Converged NIC (or CNIC) 71Ethernet controllers which support a TCP Offload Engine (TOE), 72Remote DMA (RDMA), and iSCSI acceleration, 73in addition to standard L2 Ethernet traffic, 74all on the same controller. 75The following features are supported in the 76.Nm 77driver under 78.Ox : 79.Bd -literal -offset indent 80IPv4 receive IP/TCP/UDP checksum offload 81IPv4 transmit TCP/UDP checksum offload 82.\"jumbo frames 83VLAN tag insertion and stripping 84interrupt coalescing 8510/100/1000Mbps operation in full-duplex mode 8610/100Mbps operation in half-duplex mode 87.Ed 88.Pp 89The 90.Nm 91driver supports the following media types: 92.Bl -tag -width "10baseT/UTP" 93.It Cm autoselect 94Enable autoselection of the media type and options. 95The user can manually override 96the autoselected mode via 97.Xr ifconfig 8 . 98.It Cm 10baseT/UTP 99Set 10Mbps operation. 100The 101.Xr ifconfig 8 102.Ic mediaopt 103option can also be used to select either 104.Cm full-duplex 105or 106.Cm half-duplex 107modes. 108.It Cm 100baseTX 109Set 100Mbps (Fast Ethernet) operation. 110The 111.Xr ifconfig 8 112.Ic mediaopt 113option can also be used to select either 114.Cm full-duplex 115or 116.Cm half-duplex 117modes. 118.It Cm 1000baseT 119Set 1000baseT operation over twisted pair. 120Only 121.Cm full-duplex 122mode is supported. 123.It Cm 1000baseSX 124Set 1000Mbps (Gigabit Ethernet) operation. 125Only 126.Cm full-duplex 127mode is supported. 128.It Cm 2500baseSX 129Set 2500Mbps operation. 130Only 131.Cm full-duplex 132mode is supported. 133.El 134.Pp 135The 136.Nm 137driver supports the following media options: 138.Bl -tag -width "full-duplex" 139.It Cm full-duplex 140Force full duplex operation. 141.It Cm half-duplex 142Force half duplex operation. 143.El 144.Pp 145For more information on configuring this device, see 146.Xr ifconfig 8 . 147.Sh FILES 148The adapter needs firmware files to run, which are loaded on demand by the 149driver when the device is attached: 150.Pp 151.Bl -tag -width Ds -offset indent -compact 152.It Pa /etc/firmware/bnx-b06 153.It Pa /etc/firmware/bnx-b09 154.It Pa /etc/firmware/bnx-rv2p 155.It Pa /etc/firmware/bnx-xi-rv2p 156.It Pa /etc/firmware/bnx-xi90-rv2p 157.El 158.Sh SEE ALSO 159.Xr arp 4 , 160.Xr brgphy 4 , 161.Xr ifmedia 4 , 162.Xr intro 4 , 163.Xr netintro 4 , 164.Xr pci 4 , 165.Xr hostname.if 5 , 166.Xr ifconfig 8 167.Sh HISTORY 168The 169.Nm 170device driver first appeared in 171.Ox 4.0 . 172.Sh AUTHORS 173.An -nosplit 174The 175.Nm 176driver was written by 177.An David Christensen Aq Mt davidch@broadcom.com 178and ported to 179.Ox 180by 181.An Brad Smith Aq Mt brad@openbsd.org . 182