xref: /dragonfly/share/man/man4/bnx.4 (revision 25a2db75)
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
41Alternatively, to load the driver as a module at boot time, place the
42following line in
43.Pa /boot/loader.conf :
44.Bd -literal -offset indent
45if_bnx_load="YES"
46.Ed
47.Sh DESCRIPTION
48The
49.Nm
50driver supports the PCIe Ethernet adapters based on
51Broadcom BCM57785/BCM5718 families chips.
52.Pp
53The
54.Nm
55driver supports the following
56.Ar media
57types:
58.Pp
59.Bl -tag -width 10baseT/UTP -compact
60.It Cm autoselect
61Enable autoselection of the media types and options
62.Pp
63.It Cm 10baseT/UTP
64Set 10Mbps operation.
65The
66.Ar mediaopt
67option can also be used to select either
68.Ar full-duplex
69or
70.Ar half-duplex
71modes.
72.Pp
73.It Cm 100baseTX
74Set 100Mbps (Fast Ethernet) operation.
75The
76.Ar mediaopt
77option can also be used to select either
78.Ar full-duplex
79or
80.Ar half-duplex
81modes.
82.Pp
83.It Cm 1000baseT
84Set 1000Mbps (Gigabit Ethernet) operation.
85The
86.Ar mediaopt
87option can only be set
88.Ar full-duplex
89mode.
90.El
91.Pp
92The
93.Nm
94driver supports the following
95.Ar media
96options:
97.Pp
98.Bl -tag -width full-duplex -compact
99.It Cm full-duplex
100Force full duplex operation.
101.Pp
102.It Cm half-duplex
103Force half duplex operation.
104.El
105.Pp
106Note that the 1000baseT media type is only available
107if it is supported by the adapter.
108For more information on configuring this device,
109see
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
121The
122.Nm
123device driver first appeared in
124.Dx 3.1 .
125.Sh AUTHORS
126.An -nosplit
127The
128.Nm
129driver was based on
130.Xr bge 4
131written by
132.An Bill Paul
133.Aq wpaul@windriver.com .
134