Merge branch 'vendor/HOSTAPD'
[dragonfly.git] / share / man / man4 / miibus.4
1 .\" Written by Tom Rhodes for the FreeBSD Project.
2 .\" Please see the /usr/src/COPYRIGHT file for copyright information.
3 .\"
4 .\" This document takes information from the IEEE 802.3 Standard
5 .\" along with various comments from Peter Wemm, Robert Watson, and Bill Paul.
6 .\" Originally this file looked much like the NetBSD mii(4) manual page, but
7 .\" I doubt you would ever notice due to large differences.
8 .\"
9 .\" $FreeBSD: src/share/man/man4/miibus.4,v 1.3.2.6 2004/03/01 09:22:11 brueffer Exp $
10 .\"
11 .Dd July 26, 2008
12 .Dt MIIBUS 4
13 .Os
14 .Sh NAME
15 .Nm miibus
16 .Nd IEEE 802.3 Media Independent Interface network bus
17 .Sh SYNOPSIS
18 For most network interface cards (NIC):
19 .Cd "device miibus"
20 .Sh DESCRIPTION
21 The
22 .Nm
23 driver provides an interconnection between the Media Access Control (MAC)
24 sublayer, the Physical Layer entities (PHY), Station Management (STA)
25 entities, and the PHY Layer as defined by the IEEE 802.3 Standard.
26 .Pp
27 The
28 .Nm
29 layer allows network device drivers to share common support
30 code for various external PHY devices.
31 Most 10/100 network interface cards either use an MII transceiver
32 or have built-in transceivers that can be programmed using an MII
33 interface.
34 The
35 .Nm
36 driver currently handles all of the media detection,
37 selection, and reporting using the
38 .Xr ifmedia 4
39 interface.
40 A generic driver has been included for all PHYs that are not
41 handled by a specific driver, this is possible because all
42 10/100 PHYs implement the same general register set along with
43 their vendor specific register set.
44 .Pp
45 The following network device drivers use the
46 .Nm
47 interface:
48 .Pp
49 .Bl -tag -compact -width ".Xr stge 4"
50 .It Xr aue 4
51 ADMtek USB Ethernet
52 .It Xr axe 4
53 ASIX Electronics AX88172 USB Ethernet
54 .It Xr bce 4
55 Broadcom BCM5706/BCM5708 Gigabit Ethernet
56 .It Xr bfe 4
57 Broadcom BCM440x 10/100 Ethernet
58 .It Xr bge 4
59 Broadcom BCM570xx Gigabit Ethernet
60 .It Xr dc 4
61 DEC/Intel 21143 and various workalikes
62 .It Xr ed 4
63 NE[12]000, SMC Ultra, 3c503, DS8390 cards
64 .It Xr et 4
65 Agere ET1310 10/100/1000 Ethernet
66 .It Xr fxp 4
67 Intel EtherExpress PRO/100B
68 .It Xr jme 4
69 JMicron Gigabit Ethernet
70 .It Xr lge 4
71 Level 1 LXT1001 NetCellerator Gigabit Ethernet
72 .It Xr msk 4
73 Marvell/SysKonnect Yukon II Gigabit Ethernet
74 .It Xr nfe 4
75 NVIDIA nForce MCP 10/100/Gigabit Ethernet
76 .It Xr nge 4
77 National Semiconductor DP83820/DP83821 Gigabit Ethernet
78 .It Xr pcn 4
79 AMD Am79C97x PCI 10/100
80 .It Xr re 4
81 RealTek 8139C+/8169/8169S/8110S
82 .It Xr rl 4
83 RealTek 8129/8139
84 .It Xr rue 4
85 RealTek RTL8150 USB To Fast Ethernet
86 .It Xr sf 4
87 Adaptec AIC-6915
88 .It Xr sis 4
89 Silicon Integrated Systems SiS 900/SiS 7016
90 .It Xr sk 4
91 SysKonnect SK-984x and SK-982x Gigabit Ethernet
92 .It Xr ste 4
93 Sundance ST201 (D-Link DFE-550TX)
94 .It Xr stge 4
95 Sundance/Tamarack TC9021 Gigabit Ethernet
96 .It Xr tl 4
97 Texas Instruments ThunderLAN
98 .It Xr tx 4
99 SMC EtherPower II (83c170)
100 .It Xr vge 4
101 VIA Networking Technologies VT6122 PCI Gigabit Ethernet
102 .It Xr vr 4
103 VIA Rhine, Rhine II
104 .It Xr wb 4
105 Winbond W89C840F
106 .It Xr xl 4
107 3Com 3c90x
108 .El
109 .Sh COMPATIBILITY
110 The implementation of
111 .Nm
112 was originally intended to have similar API interfaces
113 to
114 .Bsx 3.0
115 and
116 .Nx ,
117 but as a result are not well behaved newbus device drivers.
118 .Sh SEE ALSO
119 .Xr arp 4 ,
120 .Xr aue 4 ,
121 .Xr axe 4 ,
122 .Xr bce 4 ,
123 .Xr bfe 4 ,
124 .Xr bge 4 ,
125 .Xr dc 4 ,
126 .Xr ed 4 ,
127 .Xr et 4 ,
128 .Xr fxp 4 ,
129 .Xr jme 4 ,
130 .Xr lge 4 ,
131 .Xr msk 4 ,
132 .Xr netintro 4 ,
133 .Xr nfe 4 ,
134 .Xr nge 4 ,
135 .Xr pcn 4 ,
136 .Xr re 4 ,
137 .Xr rl 4 ,
138 .Xr rue 4 ,
139 .Xr sf 4 ,
140 .Xr sis 4 ,
141 .Xr sk 4 ,
142 .Xr ste 4 ,
143 .Xr stge 4 ,
144 .Xr tl 4 ,
145 .Xr tx 4 ,
146 .Xr vge 4 ,
147 .Xr vr 4 ,
148 .Xr wb 4 ,
149 .Xr xl 4
150 .Sh STANDARDS
151 More information on MII can be found in the IEEE 802.3 Standard.
152 .Sh HISTORY
153 The
154 .Nm
155 driver first appeared in
156 .Fx 3.3 .
157 .Sh AUTHORS
158 This manual page was written by
159 .An Tom Rhodes Aq Mt trhodes@FreeBSD.org .