share/man/man4/bnx.4

   1 .\"
   2 .\" Copyright (c) 2012 The DragonFly Project.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\"
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in
  12 .\"    the documentation and/or other materials provided with the
  13 .\"    distribution.
  14 .\" 3. Neither the name of The DragonFly Project nor the names of its
  15 .\"    contributors may be used to endorse or promote products derived
  16 .\"    from this software without specific, prior written permission.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  20 .\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  21 .\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
  22 .\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  23 .\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
  24 .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  25 .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  26 .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  27 .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  28 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  29 .\" SUCH DAMAGE.
  30 .\"
  31 .Dd July 19, 2012
  32 .Dt BNX 4
  33 .Os
  34 .Sh NAME
  35 .Nm bnx
  36 .Nd "Broadcom BCM57785/BCM5718 families 10/100/Gigabit Ethernet device"
  37 .Sh SYNOPSIS
  38 .Cd "device miibus"
  39 .Cd "device bnx"
  40 .Pp
  41 Alternatively, to load the driver as a module at boot time, place the
  42 following line in
  43 .Pa /boot/loader.conf :
  44 .Bd -literal -offset indent
  45 if_bnx_load="YES"
  46 .Ed
  47 .Sh DESCRIPTION
  48 The
  49 .Nm
  50 driver supports the PCIe Ethernet adapters based on
  51 Broadcom BCM57785/BCM5718 families chips.
  52 .Pp
  53 The
  54 .Nm
  55 driver supports the following
  56 .Ar media
  57 types:
  58 .Pp
  59 .Bl -tag -width 10baseT/UTP -compact
  60 .It Cm autoselect
  61 Enable autoselection of the media types and options
  62 .Pp
  63 .It Cm 10baseT/UTP
  64 Set 10Mbps operation.
  65 The
  66 .Ar mediaopt
  67 option can also be used to select either
  68 .Ar full-duplex
  69 or
  70 .Ar half-duplex
  71 modes.
  72 .Pp
  73 .It Cm 100baseTX
  74 Set 100Mbps (Fast Ethernet) operation.
  75 The
  76 .Ar mediaopt
  77 option can also be used to select either
  78 .Ar full-duplex
  79 or
  80 .Ar half-duplex
  81 modes.
  82 .Pp
  83 .It Cm 1000baseT
  84 Set 1000Mbps (Gigabit Ethernet) operation.
  85 The
  86 .Ar mediaopt
  87 option can only be set
  88 .Ar full-duplex
  89 mode.
  90 .El
  91 .Pp
  92 The
  93 .Nm
  94 driver supports the following
  95 .Ar media
  96 options:
  97 .Pp
  98 .Bl -tag -width full-duplex -compact
  99 .It Cm full-duplex
 100 Force full duplex operation.
 101 .Pp
 102 .It Cm half-duplex
 103 Force half duplex operation.
 104 .El
 105 .Pp
 106 Note that the 1000baseT media type is only available
 107 if it is supported by the adapter.
 108 For more information on configuring this device,
 109 see
 110 .Xr ifconfig 8 .
 111 .Sh SEE ALSO
 112 .Xr arp 4 ,
 113 .Xr bge 4 ,
 114 .Xr ifmedia 4 ,
 115 .Xr miibus 4 ,
 116 .Xr netintro 4 ,
 117 .Xr ng_ether 4 ,
 118 .Xr vlan 4 ,
 119 .Xr ifconfig 8
 120 .Sh HISTORY
 121 The
 122 .Nm
 123 device driver first appeared in
 124 .Dx 3.1 .
 125 .Sh AUTHORS
 126 .An -nosplit
 127 The
 128 .Nm
 129 driver was based on
 130 .Xr bge 4
 131 written by
 132 .An Bill Paul
 133 .Aq wpaul@windriver.com .