Provided by: freebsd-manpages_9.2+1-1_all bug

NAME

       bce — Broadcom NetXtreme II (BCM5706/5708/5709/5716) PCI/PCIe Gigabit Ethernet adapter driver

SYNOPSIS

       To compile this driver into the kernel, place the following lines in your kernel configuration file:

             device miibus
             device bce

       Alternatively, to load the driver as a module at boot time, place the following line in loader.conf(5):

             if_bce_load="YES"

DESCRIPTION

       The  bce  driver supports Broadcom's NetXtreme II product family, including the BCM5706, BCM5708, BCM5709
       and BCM5716 Ethernet controllers.

       The NetXtreme II product family is composed of various Converged NIC (or CNIC) Ethernet controllers which
       support a TCP Offload Engine (TOE), Remote DMA (RDMA), and iSCSI acceleration, in addition to standard L2
       Ethernet traffic, all on the same controller.

       The following features are supported in the bce driver under FreeBSD:

             IP/TCP/UDP checksum offload
             Jumbo frames (up to 9022 bytes)
             VLAN tag stripping
             Interrupt coalescing
             10/100/1000Mbps operation in full-duplex mode
             10/100Mbps operation in half-duplex mode

       The bce driver supports the following media types:

       autoselect   Enable autoselection of the media type and options.  The  user  can  manually  override  the
                    autoselected mode by adding media options to rc.conf(5).

       10baseT/UTP  Set  10Mbps  operation.   The  ifconfig(8) mediaopt option can also be used to select either
                    full-duplex or half-duplex modes.

       100baseTX    Set 100Mbps (Fast Ethernet) operation.  The ifconfig(8) mediaopt option can also be used  to
                    select either full-duplex or half-duplex modes.

       1000baseSX   Sets 1000Mbps operation.  Only full-duplex mode is supported at this speed.

       1000baseT    Set 1000baseT operation over twisted pair.  Only full-duplex mode is supported.

       2500BaseSX   Set 2500Mbps operation.  Only full-duplex mode is supported.

       The bce driver supports the following media options:

       full-duplex  Force full duplex operation.

       half-duplex  Force half duplex operation.

       For more information on configuring this device, see ifconfig(8).

HARDWARE

       The  bce  driver  provides  support for various NICs based on the Broadcom NetXtreme II family of Gigabit
       Ethernet controllers, including the following:

          Broadcom NetXtreme II BCM5706 1000Base-SX
          Broadcom NetXtreme II BCM5706 1000Base-T
          Broadcom NetXtreme II BCM5708 1000Base-SX
          Broadcom NetXtreme II BCM5708 1000Base-T
          Broadcom NetXtreme II BCM5709 1000Base-SX
          Broadcom NetXtreme II BCM5709 1000Base-T
          Broadcom NetXtreme II BCM5716 1000Base-T
          Dell PowerEdge 1950 integrated BCM5708 NIC
          Dell PowerEdge 2950 integrated BCM5708 NIC
          Dell PowerEdge R710 integrated BCM5709 NIC
          HP NC370F Multifunction Gigabit Server Adapter
          HP NC370T Multifunction Gigabit Server Adapter
          HP NC370i Multifunction Gigabit Server Adapter
          HP NC371i Multifunction Gigabit Server Adapter
          HP NC373F PCIe Multifunc Giga Server Adapter
          HP NC373T PCIe Multifunction Gig Server Adapter
          HP NC373i Multifunction Gigabit Server Adapter
          HP NC373m Multifunction Gigabit Server Adapter
          HP NC374m PCIe Multifunction Adapter
          HP NC380T PCIe DP Multifunc Gig Server Adapter
          HP NC382T PCIe DP Multifunction Gigabit Server Adapter
          HP NC382i DP Multifunction Gigabit Server Adapter
          HP NC382m DP 1GbE Multifunction BL-c Adapter

SYSCTL VARIABLES

       The following variables are available as both sysctl(8) variables and loader(8) tunables:

       hw.bce.verbose
               Enable/Disable verbose logging and output to the console.  Useful for debugging (default 0).

       hw.bce.msi_enable
               Enable/Disable MSI support (default 1).

       hw.bce.tso_enable
               Enable/Disable TSO support (default 1).

       hw.bce.strict_rx_mtu
               Enable/Disable strict RX frame size checking (default 0).

       hw.bce.hdr_split
               Enable/Disable frame header/payload splitting (default 1).

       hw.bce.rx_pages
               Set the number of memory pages assigned to recieve packets  by  the  driver.   Due  to  alignment
               issues, this value can only be of the set 1, 2, 4 or 8 (default 2).

       hw.bce.tx_pages
               Set  the  number  of  memory  pages assigned to transmit packets by the driver.  Due to alignment
               issues, this value can only be of the set 1, 2, 4 or 8 (default 2).

       hw.bce.rx_ticks
               Time in microsecond ticks to wait before generating a status block updates due to  RX  processing
               activity.   Values from 0-100 are valid.  A value of 0 disables this status block update.  Cannot
               be set to 0 if hw.bce.rx_quick_cons_trip is also 0 (default 18).

       hw.bce.rx_ticks_int
               Time in microsecond ticks to wait during RX interrupt processing before generating a status block
               update.  Values from 0-100 are valid.  Valid values are in the range from 0-100.  A  value  of  0
               disables this status block update (default 18).

       hw.bce.rx_quick_cons_trip
               Number  of  RX  Quick BD Chain entries that must be completed before a status block is generated.
               Values from 0-256 are valid.  A value of 0 disables this status block update.  Cannot be set to 0
               if hw.bce.rx_ticks is also 0 (default 6).

       hw.bce.rx_quick_cons_trip_int
               Number of RX quick BD entries that must be completed before a status  block  is  generated  duing
               interrupt  processing.   Values  from  0-256  are valid.  A value of 0 disables this status block
               update (default 6).

       hw.bce.tx_ticks
               Time in microsecond ticks to wait before a status block update is generated due to TX  activitiy.
               Values from 0-100 are valid.  A value of 0 disables this status block update.  Cannot be set to 0
               if hw.bce.tx_quick_cons_trip is also 0 (default 80).

       hw.bce.tx_ticks_int
               Time  in  microsecond  ticks  to  wait  in  interrupt  processing before a status block update is
               generated due to TX activity Values from 0-100 are valid.  A value  of  0  disables  this  status
               block update (default 80).

       hw.bce.tx_cons_trip
               How  many  TX  Quick  BD Chain entries that must be completed before a status block is generated.
               Values from 0-100 are valid.  A value of 0 disables this status block update.  Cannot be set to 0
               if hw.bce.tx_ticks is also 0 (default 20).

       hw.bce.tx_cons_trip_int
               How many TX Quick BD Chain entries that must be completed before  a  status  block  is  generated
               during  an  interrupt.   Values  from  0-100  are valid.  A value of 0 disables this status block
               update (default 20).

DIAGNOSTICS

       bce%d: PCI memory allocation failed!  The driver has encountered a fatal initialization error.

       bce%d: PCI map interrupt failed!  The driver has encountered a fatal initialization error.

       bce%d: Unsupported controller revision (%c%d)  The driver does not support  the  controller  revision  in
       use.

       bce%d: Controller initialization failed!  The driver has encountered a fatal initialization error.

       bce%d: NVRAM test failed!  The driver could not access the controller NVRAM correctly.

       bce%d: DMA resource allocation failed!  The driver could not allocate DMA memory to setup the controllers
       host memory data structures.

       bce%d: Interface allocation failed!  The driver could not create a network interface for the controller.

       bce%d: PHY probe failed!  The driver could not access the PHY used by the controller.

       bce%d: Failed to setup IRQ!  The driver could not initialize the IRQ handler.

       bce%d:  Error:  PHY  read  timeout!    The driver could not read a PHY register before the timeout period
       expired.

       bce%d: PHY write timeout!  The driver could not write to the PHY register because a timeout occurred.

       bce%d: Timeout error reading NVRAM at offset 0x%08X!  The driver could  not  write  to  NVRAM  because  a
       timeout occurred.

       bce%d:  Unknown  Flash  NVRAM  found!    The  driver  does  not recognize the NVRAM device being used and
       therefore cannot access it correctly.

       bce%d: Invalid NVRAM magic value!  The driver cannot read NVRAM or the NVRAM is corrupt.

       bce%d: Invalid Manufacturing Information NVRAM CRC!  The  driver  cannot  read  NVRAM  or  the  NVRAM  is
       corrupt.

       bce%d: Invalid Feature Configuration Information NVRAM CRC!  The driver cannot read NVRAM or the NVRAM is
       corrupt.

       bce%d: DMA mapping error!  The driver was unable to map memory into DMA addressable space required by the
       controller.

       bce%d: Could not allocate parent DMA tag!  The driver could not allocate a PCI compatible DMA tag.

       bce%d:  Could  not  allocate  status  block  DMA  tag!    The driver could not allocate a DMA tag for the
       controller's status block.

       bce%d: Could not allocate status block DMA memory!  The driver could not allocate DMA addressable  memory
       for the controller's status block.

       bce%d:  Could not map status block DMA memory!  The driver could not map the status block memory into the
       controller's DMA address space.

       bce%d: Could not allocate statistics block DMA tag!  The driver could not allocate  a  DMA  tag  for  the
       controller's statistics block.

       bce%d:  Could  not  allocate  statistics block DMA memory!  The driver could not allocate DMA addressable
       memory for the controller's statistics block.

       bce%d: Could not map statistics block DMA memory!  The driver could not map the statistics  block  memory
       into the controller's DMA address space.

       bce%d:  Could  not allocate TX descriptor chain DMA tag!  The driver could not allocate a DMA tag for the
       controller's TX chain.

       bce%d: Could not allocate TX descriptor chain DMA memory!  The driver could not allocate DMA  addressable
       memory for the controller's TX chain.

       bce%d:  Could  not  map TX descriptor chain DMA memory!  The driver could not map the TX descriptor chain
       memory into the controller's DMA address space.

       bce%d: Could not allocate TX mbuf DMA tag!  The driver could not allocate a DMA tag for the  controller's
       TX mbuf memory.

       bce%d:  Unable  to  create  TX  mbuf  DMA  map!    The  driver  could not map the TX mbuf memory into the
       controller's DMA address space.

       bce%d: Could not allocate RX descriptor chain DMA tag!  The driver could not allocate a DMA tag  for  the
       controller's RX chain.

       bce%d:  Could not allocate RX descriptor chain   The driver could not allocate DMA addressable memory for
       the controller's RX chain.

       bce%d: Could not map RX descriptor chain DMA memory!  The driver could not map the  RX  descriptor  chain
       memory into the controller's DMA address space.

       bce%d:  Could not allocate RX mbuf DMA tag!  The driver could not allocate a DMA tag for the controller's
       RX mbuf memory.

       bce%d: Unable to create RX mbuf DMA map!   The  driver  could  not  map  the  RX  mbuf  memory  into  the
       controller's DMA address space.

       bce%d:  Firmware  synchronization  timeout!    The  driver  was not able to synchronize with the firmware
       running on the controller.  The firmware may be stopped or hung.

       bce%d: Invalid Ethernet address!  The driver was not able to read  a  valid  Ethernet  MAC  address  from
       NVRAM.

       bce%d: Reset failed!  The driver has encountered a fatal initialization error.

       bce%d:  Byte  swap  is  incorrect!  The driver has encountered a fatal initialization error.  Contact the
       author with details of the CPU architecture and system chipset in use.

       bce%d: Firmware did not complete initialization!  The  driver  has  encountered  a  fatal  initialization
       error.

       bce%d: Bootcode not running!  The driver has encountered a fatal initialization error.

       bce%d: Error mapping mbuf into RX chain!  The driver could not map a RX mbuf into DMA addressable memory.

       bce%d: Error filling RX chain: rx_bd[0x%04X]!  The driver was unable to allocate enough mbufs to fill the
       RX  chain  during  initialization.   Try increasing the number of mbufs available in the system, increase
       system memory, or if using jumbo frames, make sure enough 9KB mbufs are available.

       bce%d: Failed to allocate new mbuf, incoming frame dropped!  The driver was unable to allocate a new mbuf
       for the RX chain and reused the mbuf for the received frame, dropping the incoming frame in the  process.
       Try increasing the number of mbufs available in the system or increase system memory.

       bce%d: Controller reset failed!  A fatal initialization error has occurred.

       bce%d: Controller initialization failed!  A fatal initialization error has occurred.

       bce%d: Block initialization failed!  A fatal initialization error has occurred.

       bce%d: Error mapping mbuf into TX chain!  The driver could not map a TX mbuf into DMA addressable memory.

       bce%d:  Error  registering  poll function!  The driver received an error while attempting to register the
       poll function.

       bce%d: Changing VLAN_MTU not supported.  Changing the VLAN MTU is not currently supported by the driver.

       bce%d: Cannot change VLAN_HWTAGGING while management firmware  (ASF/IPMI/UMP)  is  running!    Management
       firmware to support ASF/IPMI/UMP requires that VLAN tag stripping be enabled in the controller.

       bce%d: Changing VLAN_HWTAGGING not supported!  Disabling VLAN tag stripping is not currently supported by
       the driver.

       bce%d:  Watchdog timeout occurred, resetting!  The device has stopped responding to the network, there is
       a problem with the cable connection, or a driver logic problem has occurred..

       bce%d: Fatal attention detected: 0x%08X!  A controller hardware failure has  occurred.   If  the  problem
       continues replace the controller.

SUPPORT

       For  general  information  and  support,  go  to  the  Broadcom  NIC Open Source Developer Resource Site:
       http://www.broadcom.com/support/ethernet_nic/open_source.php.

SEE ALSO

       altq(4), arp(4), miibus(4), netintro(4), ng_ether(4), vlan(4), ifconfig(8)

HISTORY

       The bce device driver first appeared in FreeBSD 6.1.

AUTHORS

       The bce driver was written by David Christensen <davidch@broadcom.com>.

Debian                                            June 4, 2012                                            BCE(4)