Initial import from FreeBSD RELENG_4:
[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.2 2003/02/23 19:17:55 trhodes Exp $
10 .\"
11 .Dd February 15, 2003
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 ifmedia interface.
38 A generic driver has been included for all PHYs that are not
39 handled by a specific driver, this is possible because all
40 10/100 PHYs implement the same general register set along with
41 their vendor specific register set.
42 .Pp
43 The following network device drivers use the
44 .Nm
45 interface:
46 .Pp
47 .Bl -tag -compact -width ".Xr fxp 4"
48 .It Xr an 4
49 Aironet 4500/4800 802.11 wireless NICs
50 .It Xr aue 4
51 ADMtek USB Ethernet
52 .It Xr awi 4
53 BayStack 660 and others
54 .It Xr bge 4
55 Broadcom BCM570xx Gigabit Ethernet
56 .It Xr cue 4
57 CATC USB Ethernet
58 .It Xr dc 4
59 DEC/Intel 21143 and various workalikes
60 .It Xr ed 4
61 NE[12]000, SMC Ultra, 3c503, DS8390 cards
62 .It Xr fxp 4
63 Intel EtherExpress PRO/100B (82557, 82558)
64 .It Xr kue 4
65 Kawasaki LSI USB Ethernet
66 .It Xr pcn 4
67 AMD Am79C97x PCI 10/100
68 .It Xr rl 4
69 RealTek 8129/8139
70 .It Xr sf 4
71 Adaptec AIC-6915
72 .It Xr sis 4
73 Silicon Integrated Systems SiS 900/SiS 7016
74 .It Xr ste 4
75 Sundance ST201 (D-Link DFE-550TX)
76 .It Xr tl 4
77 Texas Instruments ThunderLAN
78 .It Xr tx 4
79 SMC EtherPower II (83c170)
80 .It Xr vr 4
81 VIA Rhine, Rhine II
82 .It Xr wb 4
83 Winbond W89C840F
84 .It Xr xl 4
85 3Com 3c90x
86 .El
87 .Sh COMPATIBILITY
88 The implementation of
89 .Nm
90 was originally intended to have similar API interfaces
91 to
92 .Bsx 3.0
93 and
94 .Nx ,
95 but as a result are not well behaved newbus device drivers.
96 .Sh SEE ALSO
97 .Xr an 4 ,
98 .Xr arp 4 ,
99 .Xr aue 4 ,
100 .Xr awi 4 ,
101 .Xr bge 4 ,
102 .Xr cue 4 ,
103 .Xr dc 4 ,
104 .Xr ed 4 ,
105 .Xr fxp 4 ,
106 .Xr kue 4 ,
107 .Xr netintro 4 ,
108 .Xr pcn 4 ,
109 .Xr rl 4 ,
110 .Xr sf 4 ,
111 .Xr sis 4 ,
112 .Xr ste 4 ,
113 .Xr tl 4 ,
114 .Xr tx 4 ,
115 .Xr vr 4 ,
116 .Xr wb 4 ,
117 .Xr xl 4
118 .Sh STANDARDS
119 More information on MII can be found in the IEEE 802.3 Standard.
120 .Sh HISTORY
121 The
122 .Nm
123 driver first appeared in
124 .Fx 3.3 .
125 .Sh AUTHORS
126 This manual page was written by
127 .An Tom Rhodes Aq trhodes@FreeBSD.org .