xref: /freebsd/share/man/man4/cxgbe.4 (revision f6a2e1100fa09742aa29d8e51fd6181fb5c171bb)
100aa064fSJohn Baldwin.\" Copyright (c) 2011-2016, Chelsio Inc
254e4ee71SNavdeep Parhar.\" All rights reserved.
354e4ee71SNavdeep Parhar.\"
454e4ee71SNavdeep Parhar.\" Redistribution and use in source and binary forms, with or without
554e4ee71SNavdeep Parhar.\" modification, are permitted provided that the following conditions are met:
654e4ee71SNavdeep Parhar.\"
754e4ee71SNavdeep Parhar.\" 1. Redistributions of source code must retain the above copyright notice,
854e4ee71SNavdeep Parhar.\"    this list of conditions and the following disclaimer.
954e4ee71SNavdeep Parhar.\"
1054e4ee71SNavdeep Parhar.\" 2. Redistributions in binary form must reproduce the above copyright
1154e4ee71SNavdeep Parhar.\"    notice, this list of conditions and the following disclaimer in the
1254e4ee71SNavdeep Parhar.\"    documentation and/or other materials provided with the distribution.
1354e4ee71SNavdeep Parhar.\"
1454e4ee71SNavdeep Parhar.\" 3. Neither the name of the Chelsio Inc nor the names of its
1554e4ee71SNavdeep Parhar.\"    contributors may be used to endorse or promote products derived from
1654e4ee71SNavdeep Parhar.\"    this software without specific prior written permission.
1754e4ee71SNavdeep Parhar.\"
1854e4ee71SNavdeep Parhar.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
1954e4ee71SNavdeep Parhar.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
2054e4ee71SNavdeep Parhar.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2154e4ee71SNavdeep Parhar.\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
2254e4ee71SNavdeep Parhar.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
2354e4ee71SNavdeep Parhar.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
2454e4ee71SNavdeep Parhar.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
2554e4ee71SNavdeep Parhar.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
2654e4ee71SNavdeep Parhar.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
2754e4ee71SNavdeep Parhar.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
2854e4ee71SNavdeep Parhar.\" POSSIBILITY OF SUCH DAMAGE.
2954e4ee71SNavdeep Parhar.\"
3054e4ee71SNavdeep Parhar.\" * Other names and brands may be claimed as the property of others.
3154e4ee71SNavdeep Parhar.\"
3254e4ee71SNavdeep Parhar.\" $FreeBSD$
3354e4ee71SNavdeep Parhar.\"
34*f6a2e110SNavdeep Parhar.Dd November 10, 2021
3554e4ee71SNavdeep Parhar.Dt CXGBE 4
3654e4ee71SNavdeep Parhar.Os
3754e4ee71SNavdeep Parhar.Sh NAME
3854e4ee71SNavdeep Parhar.Nm cxgbe
39f6e648b8SJohn Baldwin.Nd "Chelsio T4-, T5-, and T6-based 100Gb, 40Gb, 25Gb, 10Gb, and 1Gb Ethernet adapter driver"
4054e4ee71SNavdeep Parhar.Sh SYNOPSIS
4154e4ee71SNavdeep ParharTo compile this driver into the kernel,
4254e4ee71SNavdeep Parharplace the following lines in your
4354e4ee71SNavdeep Parharkernel configuration file:
4454e4ee71SNavdeep Parhar.Bd -ragged -offset indent
4554e4ee71SNavdeep Parhar.Cd "device cxgbe"
4654e4ee71SNavdeep Parhar.Ed
4754e4ee71SNavdeep Parhar.Pp
4854e4ee71SNavdeep ParharTo load the driver as a
497bbe4d1fSNavdeep Parharmodule at boot time, place the following lines in
5054e4ee71SNavdeep Parhar.Xr loader.conf 5 :
5154e4ee71SNavdeep Parhar.Bd -literal -offset indent
527bbe4d1fSNavdeep Parhart4fw_cfg_load="YES"
53ad016cb8SNavdeep Parhart5fw_cfg_load="YES"
54f6e648b8SJohn Baldwint6fw_cfg_load="YES"
5554e4ee71SNavdeep Parharif_cxgbe_load="YES"
5654e4ee71SNavdeep Parhar.Ed
5754e4ee71SNavdeep Parhar.Sh DESCRIPTION
5854e4ee71SNavdeep ParharThe
5954e4ee71SNavdeep Parhar.Nm
6054e4ee71SNavdeep Parhardriver provides support for PCI Express Ethernet adapters based on
61f6e648b8SJohn Baldwinthe Chelsio Terminator 4, Terminator 5, and Terminator 6 ASICs (T4, T5, and T6).
623102cfe2SGlen BarberThe driver supports Jumbo Frames, Transmit/Receive checksum offload,
6354e4ee71SNavdeep ParharTCP segmentation offload (TSO), Large Receive Offload (LRO), VLAN
64a4a4ad2dSNavdeep Parhartag insertion/extraction, VLAN checksum offload, VLAN TSO, VXLAN checksum
65a4a4ad2dSNavdeep Parharoffload, VXLAN TSO, and Receive Side Steering (RSS).
6654e4ee71SNavdeep ParharFor further hardware information and questions related to hardware
6754e4ee71SNavdeep Parharrequirements, see
6854e4ee71SNavdeep Parhar.Pa http://www.chelsio.com/ .
6954e4ee71SNavdeep Parhar.Pp
70f6e648b8SJohn BaldwinThe
71f6e648b8SJohn Baldwin.Nm
72f6e648b8SJohn Baldwindriver uses different names for devices based on the associated ASIC:
73f6e648b8SJohn Baldwin.Bl -column -offset indent "ASIC" "Port Name" "Parent Device"
74f6e648b8SJohn Baldwin.It Sy ASIC Ta Sy Port Name Ta Sy Parent Device Ta Sy Virtual Interface
75f6e648b8SJohn Baldwin.It T4 Ta cxgbe Ta t4nex Ta vcxgbe
76f6e648b8SJohn Baldwin.It T5 Ta cxl Ta t5nex Ta vcxl
77f6e648b8SJohn Baldwin.It T6 Ta cc Ta t6nex Ta vcc
78f6e648b8SJohn Baldwin.El
79f6e648b8SJohn Baldwin.Pp
80f6e648b8SJohn BaldwinLoader tunables with the hw.cxgbe prefix apply to all cards.
81f6e648b8SJohn BaldwinThe driver provides sysctl MIBs for both ports and parent devices using
82f6e648b8SJohn Baldwinthe names above.
83c4510a9bSJohn BaldwinFor example, a T5 adapter provides port MIBs under dev.cxl and
84f6e648b8SJohn Baldwinadapter-wide MIBs under dev.t5nex.
85c4510a9bSJohn BaldwinReferences to sysctl MIBs in the remainder of this page use
86f6e648b8SJohn Baldwindev.<port> for port MIBs and dev.<nexus> for adapter-wide MIBs.
87ad016cb8SNavdeep Parhar.Pp
8854e4ee71SNavdeep ParharFor more information on configuring this device, see
8954e4ee71SNavdeep Parhar.Xr ifconfig 8 .
9054e4ee71SNavdeep Parhar.Sh HARDWARE
9154e4ee71SNavdeep ParharThe
9254e4ee71SNavdeep Parhar.Nm
93f6e648b8SJohn Baldwindriver supports 100Gb and 25Gb Ethernet adapters based on the T6 ASIC:
94f6e648b8SJohn Baldwin.Pp
95f6e648b8SJohn Baldwin.Bl -bullet -compact
96f6e648b8SJohn Baldwin.It
97f6e648b8SJohn BaldwinChelsio T6225-CR
98f6e648b8SJohn Baldwin.It
99f6e648b8SJohn BaldwinChelsio T6225-SO-CR
100f6e648b8SJohn Baldwin.It
101f6e648b8SJohn BaldwinChelsio T62100-LP-CR
102f6e648b8SJohn Baldwin.It
103f6e648b8SJohn BaldwinChelsio T62100-SO-CR
104f6e648b8SJohn Baldwin.It
105f6e648b8SJohn BaldwinChelsio T62100-CR
106f6e648b8SJohn Baldwin.El
107f6e648b8SJohn Baldwin.Pp
108f6e648b8SJohn BaldwinThe
109f6e648b8SJohn Baldwin.Nm
1106af45170SJohn Baldwindriver supports 40Gb, 10Gb and 1Gb Ethernet adapters based on the T5 ASIC:
111ad016cb8SNavdeep Parhar.Pp
112ad016cb8SNavdeep Parhar.Bl -bullet -compact
113ad016cb8SNavdeep Parhar.It
114ad016cb8SNavdeep ParharChelsio T580-CR
115ad016cb8SNavdeep Parhar.It
116ad016cb8SNavdeep ParharChelsio T580-LP-CR
117ad016cb8SNavdeep Parhar.It
118ad016cb8SNavdeep ParharChelsio T580-LP-SO-CR
119ad016cb8SNavdeep Parhar.It
120ad016cb8SNavdeep ParharChelsio T560-CR
121ad016cb8SNavdeep Parhar.It
122ad016cb8SNavdeep ParharChelsio T540-CR
123ad016cb8SNavdeep Parhar.It
124ad016cb8SNavdeep ParharChelsio T540-LP-CR
125ad016cb8SNavdeep Parhar.It
126ad016cb8SNavdeep ParharChelsio T522-CR
127ad016cb8SNavdeep Parhar.It
128ad016cb8SNavdeep ParharChelsio T520-LL-CR
129ad016cb8SNavdeep Parhar.It
130ad016cb8SNavdeep ParharChelsio T520-CR
131ad016cb8SNavdeep Parhar.It
132ad016cb8SNavdeep ParharChelsio T520-SO
133ad016cb8SNavdeep Parhar.It
134ad016cb8SNavdeep ParharChelsio T520-BT
135ad016cb8SNavdeep Parhar.It
136ad016cb8SNavdeep ParharChelsio T504-BT
137ad016cb8SNavdeep Parhar.El
138ad016cb8SNavdeep Parhar.Pp
139ad016cb8SNavdeep ParharThe
140ad016cb8SNavdeep Parhar.Nm
14154e4ee71SNavdeep Parhardriver supports 10Gb and 1Gb Ethernet adapters based on the T4 ASIC:
14254e4ee71SNavdeep Parhar.Pp
14354e4ee71SNavdeep Parhar.Bl -bullet -compact
14454e4ee71SNavdeep Parhar.It
14554e4ee71SNavdeep ParharChelsio T420-CR
14654e4ee71SNavdeep Parhar.It
14754e4ee71SNavdeep ParharChelsio T422-CR
14854e4ee71SNavdeep Parhar.It
14954e4ee71SNavdeep ParharChelsio T440-CR
15054e4ee71SNavdeep Parhar.It
15154e4ee71SNavdeep ParharChelsio T420-BCH
15254e4ee71SNavdeep Parhar.It
15354e4ee71SNavdeep ParharChelsio T440-BCH
15454e4ee71SNavdeep Parhar.It
15554e4ee71SNavdeep ParharChelsio T440-CH
15654e4ee71SNavdeep Parhar.It
15754e4ee71SNavdeep ParharChelsio T420-SO
15854e4ee71SNavdeep Parhar.It
15954e4ee71SNavdeep ParharChelsio T420-CX
16054e4ee71SNavdeep Parhar.It
16154e4ee71SNavdeep ParharChelsio T420-BT
16254e4ee71SNavdeep Parhar.It
16354e4ee71SNavdeep ParharChelsio T404-BT
16454e4ee71SNavdeep Parhar.El
16554e4ee71SNavdeep Parhar.Sh LOADER TUNABLES
16654e4ee71SNavdeep ParharTunables can be set at the
16754e4ee71SNavdeep Parhar.Xr loader 8
16854e4ee71SNavdeep Parharprompt before booting the kernel or stored in
16954e4ee71SNavdeep Parhar.Xr loader.conf 5 .
170987258d0SNavdeep ParharThere are multiple tunables that control the number of queues of various
171987258d0SNavdeep Parhartypes.
172987258d0SNavdeep ParharA negative value for such a tunable instructs the driver to create
173987258d0SNavdeep Parharup to that many queues if there are enough CPU cores available.
17454e4ee71SNavdeep Parhar.Bl -tag -width indent
1758c61c6bbSNavdeep Parhar.It Va hw.cxgbe.ntxq
1768c61c6bbSNavdeep ParharNumber of NIC tx queues used for a port.
1779d496f5aSGlen BarberThe default is 16 or the number
178733b9277SNavdeep Parharof CPU cores in the system, whichever is less.
1798c61c6bbSNavdeep Parhar.It Va hw.cxgbe.nrxq
1808c61c6bbSNavdeep ParharNumber of NIC rx queues used for a port.
1819d496f5aSGlen BarberThe default is 8 or the number
182733b9277SNavdeep Parharof CPU cores in the system, whichever is less.
1838c61c6bbSNavdeep Parhar.It Va hw.cxgbe.nofldtxq
1848c61c6bbSNavdeep ParharNumber of TOE tx queues used for a port.
1859d496f5aSGlen BarberThe default is 8 or the
186733b9277SNavdeep Parharnumber of CPU cores in the system, whichever is less.
1878c61c6bbSNavdeep Parhar.It Va hw.cxgbe.nofldrxq
1888c61c6bbSNavdeep ParharNumber of TOE rx queues used for a port.
1899d496f5aSGlen BarberThe default is 2 or the
190733b9277SNavdeep Parharnumber of CPU cores in the system, whichever is less.
191fe2ebb76SJohn Baldwin.It Va hw.cxgbe.num_vis
192c4510a9bSJohn BaldwinNumber of virtual interfaces (VIs) created for each port.
193fe2ebb76SJohn BaldwinEach virtual interface creates a separate network interface.
194fe2ebb76SJohn BaldwinThe first virtual interface on each port is required and represents
195fe2ebb76SJohn Baldwinthe primary network interface on the port.
196f6e648b8SJohn BaldwinAdditional virtual interfaces on a port are named using the Virtual Interface
197f6e648b8SJohn Baldwinname from the table above.
198fe2ebb76SJohn BaldwinAdditional virtual interfaces use a single pair of queues
199fe2ebb76SJohn Baldwinfor rx and tx as well an additional pair of queues for TOE rx and tx.
200fe2ebb76SJohn BaldwinThe default is 1.
2018c61c6bbSNavdeep Parhar.It Va hw.cxgbe.holdoff_timer_idx
20208cd1f11SNavdeep Parhar.It Va hw.cxgbe.holdoff_timer_idx_ofld
203c4510a9bSJohn BaldwinTimer index value used to delay interrupts.
20454e4ee71SNavdeep ParharThe holdoff timer list has the values 1, 5, 10, 50, 100, and 200
20554e4ee71SNavdeep Parharby default (all values are in microseconds) and the index selects a
20654e4ee71SNavdeep Parharvalue from this list.
20708cd1f11SNavdeep Parharholdoff_timer_idx_ofld applies to queues used for TOE rx.
20899defe5eSNavdeep ParharThe default value is 1 which means the timer value is 5us.
209ad016cb8SNavdeep ParharDifferent interfaces can be assigned different values at any time via the
21008cd1f11SNavdeep Parhardev.<port>.X.holdoff_tmr_idx and dev.<port>.X.holdoff_tmr_idx_ofld sysctls.
2118c61c6bbSNavdeep Parhar.It Va hw.cxgbe.holdoff_pktc_idx
21208cd1f11SNavdeep Parhar.It Va hw.cxgbe.holdoff_pktc_idx_ofld
213c4510a9bSJohn BaldwinPacket-count index value used to delay interrupts.
214c4510a9bSJohn BaldwinThe packet-count list has the values 1, 8, 16, and 32 by default,
21554e4ee71SNavdeep Parharand the index selects a value from this list.
21608cd1f11SNavdeep Parharholdoff_pktc_idx_ofld applies to queues used for TOE rx.
21799defe5eSNavdeep ParharThe default value is -1 which means packet counting is disabled and interrupts
21899defe5eSNavdeep Parharare generated based solely on the holdoff timer value.
219ad016cb8SNavdeep ParharDifferent interfaces can be assigned different values via the
22008cd1f11SNavdeep Parhardev.<port>.X.holdoff_pktc_idx and dev.<port>.X.holdoff_pktc_idx_ofld sysctls.
22108cd1f11SNavdeep ParharThese sysctls work only when the interface has never been marked up (as done by
222733b9277SNavdeep Parharifconfig up).
22354e4ee71SNavdeep Parhar.It Va hw.cxgbe.qsize_txq
224c4510a9bSJohn BaldwinNumber of entries in a transmit queue's descriptor ring.
22554e4ee71SNavdeep ParharA buf_ring of the same size is also allocated for additional
2269d496f5aSGlen Barbersoftware queuing.
2279d496f5aSGlen BarberSee
22854e4ee71SNavdeep Parhar.Xr ifnet 9 .
22954e4ee71SNavdeep ParharThe default value is 1024.
230ad016cb8SNavdeep ParharDifferent interfaces can be assigned different values via the
231f6e648b8SJohn Baldwindev.<port>.X.qsize_txq sysctl.
232733b9277SNavdeep ParharThis sysctl works only when the interface has never been marked up (as done by
233733b9277SNavdeep Parharifconfig up).
23454e4ee71SNavdeep Parhar.It Va hw.cxgbe.qsize_rxq
235c4510a9bSJohn BaldwinNumber of entries in a receive queue's descriptor ring.
23654e4ee71SNavdeep ParharThe default value is 1024.
237ad016cb8SNavdeep ParharDifferent interfaces can be assigned different values via the
238f6e648b8SJohn Baldwindev.<port>.X.qsize_rxq sysctl.
239733b9277SNavdeep ParharThis sysctl works only when the interface has never been marked up (as done by
240733b9277SNavdeep Parharifconfig up).
241733b9277SNavdeep Parhar.It Va hw.cxgbe.interrupt_types
242c4510a9bSJohn BaldwinPermitted interrupt types.
243c4510a9bSJohn BaldwinBit 0 represents INTx (line interrupts), bit 1 MSI, and bit 2 MSI-X.
244733b9277SNavdeep ParharThe default is 7 (all allowed).
245c4510a9bSJohn BaldwinThe driver selects the best possible type out of the allowed types.
246218c5b21SNavdeep Parhar.It Va hw.cxgbe.pcie_relaxed_ordering
247218c5b21SNavdeep ParharPCIe Relaxed Ordering.
248218c5b21SNavdeep Parhar-1 indicates the driver should determine whether to enable or disable PCIe RO.
249218c5b21SNavdeep Parhar0 disables PCIe RO.
250218c5b21SNavdeep Parhar1 enables PCIe RO.
251218c5b21SNavdeep Parhar2 indicates the driver should not modify the PCIe RO setting.
252218c5b21SNavdeep ParharThe default is -1.
253d78bd33fSNavdeep Parhar.It Va hw.cxgbe.fw_install
254d78bd33fSNavdeep Parhar0 prohibits the driver from installing a firmware on the card.
255d78bd33fSNavdeep Parhar1 allows the driver to install a new firmware if internal driver
256d78bd33fSNavdeep Parharheuristics indicate that the new firmware is preferable to the one
257d78bd33fSNavdeep Parharalready on the card.
258d78bd33fSNavdeep Parhar2 instructs the driver to always install the new firmware on the card as
259d78bd33fSNavdeep Parharlong as it is compatible with the driver and is a different version than
260d78bd33fSNavdeep Parharthe one already on the card.
261d78bd33fSNavdeep ParharThe default is 1.
26299defe5eSNavdeep Parhar.It Va hw.cxgbe.fl_pktshift
263c4510a9bSJohn BaldwinNumber of padding bytes inserted before the beginning of an Ethernet
26499defe5eSNavdeep Parharframe in the receive buffer.
265518bca2cSNavdeep ParharThe default value is 0.
266518bca2cSNavdeep ParharA value of of 2 would ensure that the Ethernet payload (usually the IP header)
26799defe5eSNavdeep Parharis at a 4 byte aligned address.
26899defe5eSNavdeep Parhar0-7 are all valid values.
26999defe5eSNavdeep Parhar.It Va hw.cxgbe.fl_pad
27099defe5eSNavdeep ParharA non-zero value ensures that writes from the hardware to a receive buffer are
27199defe5eSNavdeep Parharpadded up to the specified boundary.
27299defe5eSNavdeep ParharThe default is -1 which lets the driver pick a pad boundary.
27399defe5eSNavdeep Parhar0 disables trailer padding completely.
27499defe5eSNavdeep Parhar.It Va hw.cxgbe.cong_drop
27599defe5eSNavdeep ParharControls the hardware response to congestion.
27699defe5eSNavdeep Parhar-1 disables congestion feedback and is not recommended.
27799defe5eSNavdeep Parhar0 instructs the hardware to backpressure its pipeline on congestion.
2783eb2c201SNavdeep ParharThis usually results in the port emitting PAUSE frames.
27999defe5eSNavdeep Parhar1 instructs the hardware to drop frames destined for congested queues.
2803eb2c201SNavdeep Parhar.It Va hw.cxgbe.pause_settings
2813eb2c201SNavdeep ParharPAUSE frame settings.
282ea710848SNavdeep ParharBit 0 is rx_pause, bit 1 is tx_pause, bit 2 is pause_autoneg.
2833eb2c201SNavdeep Parharrx_pause = 1 instructs the hardware to heed incoming PAUSE frames, 0 instructs
2843eb2c201SNavdeep Parharit to ignore them.
2853eb2c201SNavdeep Parhartx_pause = 1 allows the hardware to emit PAUSE frames when its receive FIFO
2863eb2c201SNavdeep Parharreaches a high threshold, 0 prohibits the hardware from emitting PAUSE frames.
287ea710848SNavdeep Parharpause_autoneg = 1 overrides the rx_pause and tx_pause bits and instructs the
288ea710848SNavdeep Parharhardware to negotiate PAUSE settings with the link peer.
289ea710848SNavdeep ParharThe default is 7 (all three = 1).
2903eb2c201SNavdeep ParharThis tunable establishes the default PAUSE settings for all ports.
2913eb2c201SNavdeep ParharSettings can be displayed and controlled on a per-port basis via the
292f6e648b8SJohn Baldwindev.<port>.X.pause_settings sysctl.
293358bca3bSNavdeep Parhar.It Va hw.cxgbe.fec
294d7190ba0SNavdeep ParharForward Error Correction settings.
295d7190ba0SNavdeep Parhar-1 (default) means driver should automatically pick a value.
296bddf8247SNavdeep Parhar0 disables FEC.
297d7190ba0SNavdeep ParharFiner grained control can be achieved by setting individual bits.
298d7190ba0SNavdeep ParharBit 0 enables RS FEC, bit 1 enables BASE-R FEC (aka Firecode FEC), bit
299d7190ba0SNavdeep Parhar2 enables NO FEC, and bit 6 enables the FEC that is recommended by the
300d7190ba0SNavdeep Parhartransceiver/cable that is plugged in.
301d7190ba0SNavdeep ParharThese bits can be set together in any combination.
302358bca3bSNavdeep ParharThis tunable establishes the default FEC settings for all ports.
303*f6a2e110SNavdeep ParharSettings can be controlled on a per-port basis via the
304*f6a2e110SNavdeep Parhardev.<port>.X.requested_fec sysctl.
305*f6a2e110SNavdeep ParharThe FEC in use on the link is available in dev.<port>.X.link_fec when
306*f6a2e110SNavdeep Parharthe link is up.
307358bca3bSNavdeep Parhar.It Va hw.cxgbe.autoneg
308358bca3bSNavdeep ParharLink autonegotiation settings.
309358bca3bSNavdeep ParharThis tunable establishes the default autonegotiation settings for all ports.
310358bca3bSNavdeep ParharSettings can be displayed and controlled on a per-port basis via the
311358bca3bSNavdeep Parhardev.<port>.X.autoneg sysctl.
312358bca3bSNavdeep Parhar0 disables autonegotiation.
313358bca3bSNavdeep Parhar1 enables autonegotiation.
314358bca3bSNavdeep ParharThe default is -1 which lets the driver pick a value.
315358bca3bSNavdeep Parhardev.<port>.X.autoneg is -1 for port and module combinations that do not support
316358bca3bSNavdeep Parharautonegotiation.
31799defe5eSNavdeep Parhar.It Va hw.cxgbe.buffer_packing
31899defe5eSNavdeep ParharAllow the hardware to deliver multiple frames in the same receive buffer
31999defe5eSNavdeep Parharopportunistically.
32099defe5eSNavdeep ParharThe default is -1 which lets the driver decide.
32199defe5eSNavdeep Parhar0 or 1 explicitly disable or enable this feature.
32299defe5eSNavdeep Parhar.It Va hw.cxgbe.largest_rx_cluster
32399defe5eSNavdeep Parhar.It Va hw.cxgbe.safest_rx_cluster
32425972509SEdward Tomasz NapieralaSizes of rx clusters.
32525972509SEdward Tomasz NapieralaEach of these must be set to one of the sizes available
32699defe5eSNavdeep Parhar(usually 2048, 4096, 9216, and 16384) and largest_rx_cluster must be greater
32799defe5eSNavdeep Parharthan or equal to safest_rx_cluster.
32899defe5eSNavdeep ParharThe defaults are 16384 and 4096 respectively.
329c4510a9bSJohn BaldwinThe driver never attempts to allocate a receive buffer larger than
330c4510a9bSJohn Baldwinlargest_rx_cluster and falls back to allocating buffers of
33199defe5eSNavdeep Parharsafest_rx_cluster size if an allocation larger than safest_rx_cluster fails.
33299defe5eSNavdeep ParharNote that largest_rx_cluster merely establishes a ceiling -- the driver is
33399defe5eSNavdeep Parharallowed to allocate buffers of smaller sizes.
334733b9277SNavdeep Parhar.It Va hw.cxgbe.config_file
335733b9277SNavdeep ParharSelect a pre-packaged device configuration file.
336733b9277SNavdeep ParharA configuration file contains a recipe for partitioning and configuring the
337733b9277SNavdeep Parharhardware resources on the card.
338733b9277SNavdeep ParharThis tunable is for specialized applications only and should not be used in
339733b9277SNavdeep Parharnormal operation.
340f6e648b8SJohn BaldwinThe configuration profile currently in use is available in the dev.<nexus>.X.cf
341f6e648b8SJohn Baldwinand dev.<nexus>.X.cfcsum sysctls.
342733b9277SNavdeep Parhar.It Va hw.cxgbe.linkcaps_allowed
343733b9277SNavdeep Parhar.It Va hw.cxgbe.niccaps_allowed
344733b9277SNavdeep Parhar.It Va hw.cxgbe.toecaps_allowed
345733b9277SNavdeep Parhar.It Va hw.cxgbe.rdmacaps_allowed
346733b9277SNavdeep Parhar.It Va hw.cxgbe.iscsicaps_allowed
347733b9277SNavdeep Parhar.It Va hw.cxgbe.fcoecaps_allowed
348733b9277SNavdeep ParharDisallowing capabilities provides a hint to the driver and firmware to not
349733b9277SNavdeep Parharreserve hardware resources for that feature.
350733b9277SNavdeep ParharEach of these is a bit field with a bit for each sub-capability within the
351733b9277SNavdeep Parharcapability.
352733b9277SNavdeep ParharThis tunable is for specialized applications only and should not be used in
353733b9277SNavdeep Parharnormal operation.
354733b9277SNavdeep ParharThe capabilities for which hardware resources have been reserved are listed in
355f6e648b8SJohn Baldwindev.<nexus>.X.*caps sysctls.
35630e3f2b4SNavdeep Parhar.It Va hw.cxgbe.tx_vm_wr
35730e3f2b4SNavdeep ParharSetting this to 1 instructs the driver to use VM work requests to transmit data.
35830e3f2b4SNavdeep ParharThis lets PF interfaces transmit frames to VF interfaces over the internal
35930e3f2b4SNavdeep Parharswitch in the ASIC.
36030e3f2b4SNavdeep ParharNote that the
36130e3f2b4SNavdeep Parhar.Xr cxgbev 4
36230e3f2b4SNavdeep ParharVF driver always uses VM work requests and is not affected by this tunable.
36330e3f2b4SNavdeep ParharThe default value is 0 and should be changed only if PF and VF interfaces need
36430e3f2b4SNavdeep Parharto communicate with each other.
36530e3f2b4SNavdeep ParharDifferent interfaces can be assigned different values using the
36630e3f2b4SNavdeep Parhardev.<port>.X.tx_vm_wr sysctl when the interface is administratively down.
36777af2b2cSNavdeep Parhar.It Va hw.cxgbe.attack_filter
36877af2b2cSNavdeep ParharSet to 1 to enable the "attack filter".
36977af2b2cSNavdeep ParharDefault is 0.
37077af2b2cSNavdeep ParharThe attack filter will drop an incoming frame if any of these conditions is
37177af2b2cSNavdeep Parhartrue: src ip/ip6 == dst ip/ip6; tcp and src/dst ip is not unicast; src/dst ip is
37277af2b2cSNavdeep Parharloopback (127.x.y.z); src ip6 is not unicast; src/dst ip6 is loopback (::1/128)
37377af2b2cSNavdeep Parharor unspecified (::/128); tcp and src/dst ip6 is mcast (ff00::/8).
374ae5da4e1SNavdeep ParharThis facility is available on T4 and T5 based cards only.
37577af2b2cSNavdeep Parhar.It Va hw.cxgbe.drop_ip_fragments
37677af2b2cSNavdeep ParharSet to 1 to drop all incoming IP fragments.
37777af2b2cSNavdeep ParharDefault is 0.
37877af2b2cSNavdeep ParharNote that this drops valid frames.
37977af2b2cSNavdeep Parhar.It Va hw.cxgbe.drop_pkts_with_l2_errors
38077af2b2cSNavdeep ParharSet to 1 to drop incoming frames with Layer 2 length or checksum errors.
38177af2b2cSNavdeep ParharDefault is 1.
38277af2b2cSNavdeep Parhar.It Va hw.cxgbe.drop_pkts_with_l3_errors
38377af2b2cSNavdeep ParharSet to 1 to drop incoming frames with IP version, length, or checksum errors.
384ae5da4e1SNavdeep ParharThe IP checksum is validated for TCP or UDP packets only.
38577af2b2cSNavdeep ParharDefault is 0.
38677af2b2cSNavdeep Parhar.It Va hw.cxgbe.drop_pkts_with_l4_errors
387ae5da4e1SNavdeep ParharSet to 1 to drop incoming frames with Layer 4 (TCP or UDP) length,
388ae5da4e1SNavdeep Parharchecksum, or other errors.
38977af2b2cSNavdeep ParharDefault is 0.
390cb379161SGlen Barber.El
39154e4ee71SNavdeep Parhar.Sh SUPPORT
39254e4ee71SNavdeep ParharFor general information and support,
39354e4ee71SNavdeep Parhargo to the Chelsio support website at:
39454e4ee71SNavdeep Parhar.Pa http://www.chelsio.com/ .
39554e4ee71SNavdeep Parhar.Pp
39654e4ee71SNavdeep ParharIf an issue is identified with this driver with a supported adapter,
39754e4ee71SNavdeep Parharemail all the specific information related to the issue to
3986c899950SBaptiste Daroussin.Aq Mt support@chelsio.com .
39954e4ee71SNavdeep Parhar.Sh SEE ALSO
40054e4ee71SNavdeep Parhar.Xr altq 4 ,
40154e4ee71SNavdeep Parhar.Xr arp 4 ,
4025033c43bSJohn Baldwin.Xr ccr 4 ,
40354e4ee71SNavdeep Parhar.Xr cxgb 4 ,
4046af45170SJohn Baldwin.Xr cxgbev 4 ,
40554e4ee71SNavdeep Parhar.Xr netintro 4 ,
40654e4ee71SNavdeep Parhar.Xr ng_ether 4 ,
40754e4ee71SNavdeep Parhar.Xr ifconfig 8
40854e4ee71SNavdeep Parhar.Sh HISTORY
40954e4ee71SNavdeep ParharThe
41054e4ee71SNavdeep Parhar.Nm
41154e4ee71SNavdeep Parhardevice driver first appeared in
41250d922a0SGlen Barber.Fx 9.0 .
413ad016cb8SNavdeep ParharSupport for T5 cards first appeared in
414ad016cb8SNavdeep Parhar.Fx 9.2
415ad016cb8SNavdeep Parharand
416ad016cb8SNavdeep Parhar.Fx 10.0 .
417f6e648b8SJohn BaldwinSupport for T6 cards first appeared in
418f6e648b8SJohn Baldwin.Fx 11.1
419f6e648b8SJohn Baldwinand
420f6e648b8SJohn Baldwin.Fx 12.0 .
42154e4ee71SNavdeep Parhar.Sh AUTHORS
42254e4ee71SNavdeep Parhar.An -nosplit
42354e4ee71SNavdeep ParharThe
42454e4ee71SNavdeep Parhar.Nm
42554e4ee71SNavdeep Parhardriver was written by
4266c899950SBaptiste Daroussin.An Navdeep Parhar Aq Mt np@FreeBSD.org .
427