1 .\"
2 .\" This file and its contents are supplied under the terms of the
3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
4 .\" You may only use this file in accordance with the terms of version
5 .\" 1.0 of the CDDL.
6 .\"
7 .\" A full copy of the text of the CDDL should have accompanied this
8 .\" source. A copy of the CDDL is also available via the Internet at
9 .\" http://www.illumos.org/license/CDDL.
10 .\"
11 .\"
12 .\" Copyright (c) 2014 QLogic Corporation. All Rights Reserved
13 .\"
14 .TH BNXE 7D "Jan 10, 2020"
15 .SH NAME
16 bnxe \- QLogic NetXtreme II 10 Gigabit Ethernet Device Driver
17
18 .SH SYNOPSIS
19 .na
20 /dev/bnxe*
21 .ad
22
23 .SH DESCRIPTION
24 The
25 .B bnxe
26 Ethernet driver is a multi-threaded, loadable,
27 clonable, GLDv3-based driver supporting the Data Link Provider Interface,
28 .BR dlpi (7P),
29 over QLogic NetXtreme II 10 Gigabit Ethernet controllers. Multiple
30 NetXtreme II controllers installed within the system are supported by
31 the driver.
32
33 The
34 .B bnxe
35 driver provides support for the NetXtreme II 10 Gigabit line of devices.
36 Functions include chip initialization, frame transmit and receive,
37 multicast and promiscuous support, error recovery and reporting. These
38 devices provide 10/100/1000/2500/10000 Mbps networking interfaces.
39
40 .SH DRIVER CONFIGURATION
41
42 The primary methods of configuration are via modification of the
43 .I /kernel/drv/bnxe.conf
44 file or execution of the
45 .BR dladm (1M)
46 utility. There are many configuration items available and all are thoroughly
47 documented in the
48 .I /kernel/drv/bnxe.conf
49 file. Note that for
50 changes to this file to take affect the driver must be reloaded or the system
51 rebooted. In order to reload the driver with new configuration changes all
52 .B bnxe
53 interfaces must be first unplumbed and then the
54 .BR update_drv (1M)
55 tool must be executed. For the configuration items that do not require a
56 driver reload the
57 .BR dladm (1M)
58 tool can be used to dynamically change the option.
59
60 .SH DEBUGGING
61
62 .SS kstat
63
64 There are many statistics exposed via
65 .B kstat
66 by
67 .BR bnxe .
68
69 The main groups are:
70 .TP
71 "intr"
72 for interrupts stats
73 .TP
74 "l2chip"
75 for layer 2 chip stats,
76 .TP
77 "l2driver"
78 for layer 2 driver stats,
79 .TP
80 "l2stats"
81 for general layer 2 stats,
82 .TP
83 "link"
84 for detailed link status,
85 .TP
86 "mac"
87 for GLDv3 MAC layer stats,
88 .TP
89 "rxq#"
90 for Rx ring stats,
91 .TP
92 "txq#"
93 for Tx ring stats, and
94 .TP
95 "stats"
96 for general driver stats and version info.
97 .LP
98 To get a list of all the individual statistics in these groups run:
99 .na
100 % kstat -m bnxe -i 0 -l
101 .ad
102
103 .SH FILES
104 .ne 2
105 .na
106 /dev/bnxe[instance]
107 .ad
108 .RS 16n
109 .B bnxe
110 Character special device
111 .RE
112
113 .sp
114 .ne 2
115 .na
116 /kernel/drv/bnxe.conf
117 .ad
118 .RS 16n
119 Driver configuration file
120 .RE
121
122 .sp
123 .ne 2
124 .na
125 /kernel/drv/amd64/bnxe
126 .ad
127 .RS 16n
128 Device driver (x86)
129 .RE
130
131 .sp
132 .ne 2
133 .na
134 /kernel/drv/sparcv9/bnxe
135 .ad
136 .RS 16n
137 Device driver (SPARC)
138 .RE
139
140 .SH SEE ALSO
141 .BR dladm (1M),
142 .BR netstat (1M),
143 .BR ifconfig (1M),
144 .BR driver.conf (4),
145 .BR gld (7P)
146 .LP
147 .I QLogic NetXtreme II 10 Gigabit Adapter Driver Installation Notes
148 .LP
149 .I Writing Device Drivers
150 .LP
151 .I STREAMS Programming Guide
152 .LP
153 .I Network Interfaces Guide