share/man/man7d/bnxe.7d

   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 "Jul 17, 2014"
  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 .LP
  25 The
  26 .B bnxe
  27 Ethernet driver is a multi-threaded, loadable,
  28 clonable, GLDv3-based driver supporting the Data Link Provider Interface,
  29 .BR dlpi (7P),
  30 over QLogic NetXtreme II 10 Gigabit Ethernet controllers.  Multiple
  31 NetXtreme II controllers installed within the system are supported by
  32 the driver.
  33
  34 The
  35 .B bnxe
  36 driver provides support for the NetXtreme II 10 Gigabit line of devices.
  37 Functions include chip initialization, frame transmit and receive,
  38 multicast and promiscuous support, error recovery and reporting. These
  39 devices provide 10/100/1000/2500/10000 Mbps networking interfaces.
  40
  41 .SH DRIVER CONFIGURATION
  42
  43 The primary methods of configuration are via modification of the
  44 .I /kernel/drv/bnxe.conf
  45 file or execution of the
  46 .BR dladm (8)
  47 utility. There are many configuration items available and all are thoroughly
  48 documented in the
  49 .I /kernel/drv/bnxe.conf
  50 file. Note that for
  51 changes to this file to take affect the driver must be reloaded or the system
  52 rebooted. In order to reload the driver with new configuration changes all
  53 .B bnxe
  54 interfaces must be first unplumbed and then the
  55 .BR update_drv (8)
  56 tool must be executed. For the configuration items that do not require a
  57 driver reload the
  58 .BR dladm (8)
  59 tool can be used to dynamically change the option.
  60
  61 .SH DEBUGGING
  62
  63 .SS kstat
  64
  65 There are many statistics exposed via
  66 .B kstat
  67 by
  68 .BR bnxe .
  69
  70 The main groups are:
  71 .TP
  72 "intr"
  73 for interrupts stats
  74 .TP
  75 "l2chip"
  76 for layer 2 chip stats,
  77 .TP
  78 "l2driver"
  79 for layer 2 driver stats,
  80 .TP
  81 "l2stats"
  82 for general layer 2 stats,
  83 .TP
  84 "link"
  85 for detailed link status,
  86 .TP
  87 "mac"
  88 for GLDv3 MAC layer stats,
  89 .TP
  90 "rxq#"
  91 for Rx ring stats,
  92 .TP
  93 "txq#"
  94 for Tx ring stats, and
  95 .TP
  96 "stats"
  97 for general driver stats and version info.
  98 .LP
  99 To get a list of all the individual statistics in these goups run:
 100 .na
 101 % kstat -m bnxe -i 0 -l
 102 .ad
 103
 104 .SH FILES
 105 .ne 2
 106 .na
 107 /dev/bnxe[instance]
 108 .ad
 109 .RS 16n
 110 .B bnxe
 111 Character special device
 112 .RE
 113
 114 .sp
 115 .ne 2
 116 .na
 117 /kernel/drv/bnxe.conf
 118 .ad
 119 .RS 16n
 120 Driver configuration file.
 121 .RE
 122
 123 .sp
 124 .ne 2
 125 .na
 126 /kernel/drv/bnxe
 127 .ad
 128 .RS 16n
 129 32-bit i386 driver binary.
 130 .RE
 131
 132 .sp
 133 .ne 2
 134 .na
 135 /kernel/drv/amd64/bnxe
 136 .ad
 137 .RS 16n
 138 64-bit i386 driver binary.
 139 .RE
 140
 141 .sp
 142 .ne 2
 143 .na
 144 /kernel/drv/sparcv9/bnxe
 145 .ad
 146 .RS 16n
 147 SPARC driver binary.
 148 .RE
 149
 150 .SH SEE ALSO
 151 .BR dladm (8),
 152 .BR netstat (8),
 153 .BR ifconfig (8),
 154 .BR driver.conf (4),
 155 .BR gld (7P)
 156 .LP
 157 .I QLogic NetXtreme II 10 Gigabit Adapter Driver Installation Notes
 158 .LP
 159 .I Writing Device Drivers
 160 .LP
 161 .I STREAMS Programming Guide
 162 .LP
 163 .I Network Interfaces Guide