* Perform some man page maintenance bringing the miibus related
[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 .\" $DragonFly: src/share/man/man4/miibus.4,v 1.3 2004/01/13 01:48:59 drhodus Exp $
11 .\"
12 .Dd February 15, 2003
13 .Dt MIIBUS 4
14 .Os
15 .Sh NAME
16 .Nm miibus
17 .Nd IEEE 802.3 Media Independent Interface network bus
18 .Sh SYNOPSIS
19 For most network interface cards (NIC):
20 .Cd "device miibus"
21 .Sh DESCRIPTION
22 The
23 .Nm
24 driver provides an interconnection between the Media Access Control (MAC)
25 sublayer, the Physical Layer entities (PHY), Station Management (STA)
26 entities, and the PHY Layer as defined by the IEEE 802.3 Standard.
27 .Pp
28 The
29 .Nm
30 layer allows network device drivers to share common support
31 code for various external PHY devices.
32 Most 10/100 network interface cards either use an MII transceiver
33 or have built-in transceivers that can be programmed using an MII
34 interface.
35 The
36 .Nm
37 driver currently handles all of the media detection,
38 selection, and reporting using the ifmedia interface.
39 A generic driver has been included for all PHYs that are not
40 handled by a specific driver, this is possible because all
41 10/100 PHYs implement the same general register set along with
42 their vendor specific register set.
43 .Pp
44 The following network device drivers use the
45 .Nm
46 interface:
47 .Pp
48 .Bl -tag -compact -width ".Xr fxp 4"
49 .It Xr aue 4
50 ADMtek USB Ethernet
51 .It Xr bge 4
52 Broadcom BCM570xx Gigabit Ethernet
53 .It Xr cue 4
54 CATC USB Ethernet
55 .It Xr dc 4
56 DEC/Intel 21143 and various workalikes
57 .It Xr ed 4
58 NE[12]000, SMC Ultra, 3c503, DS8390 cards
59 .It Xr fxp 4
60 Intel EtherExpress PRO/100B (82557, 82558)
61 .It Xr gx 4
62 Intel Pro/1000 82542/82543 Gigabit Ethernet
63 .It Xr lge 4
64 Level 1 LXT1001 NetCellerator Gigabit Ethernet
65 .It Xr nge 4
66 National Semiconductor DP83820/DP83821 Gigabit Ethernet
67 .It Xr pcn 4
68 AMD Am79C97x PCI 10/100
69 .It Xr rl 4
70 RealTek 8129/8139
71 .It Xr sf 4
72 Adaptec AIC-6915
73 .It Xr sis 4
74 Silicon Integrated Systems SiS 900/SiS 7016
75 .It Xr sk 4
76 SysKonnect SK-984x and SK-982x Gigabit Ethernet
77 .It Xr ste 4
78 Sundance ST201 (D-Link DFE-550TX)
79 .It Xr tl 4
80 Texas Instruments ThunderLAN
81 .It Xr tx 4
82 SMC EtherPower II (83c170)
83 .It Xr vr 4
84 VIA Rhine, Rhine II
85 .It Xr wb 4
86 Winbond W89C840F
87 .It Xr xl 4
88 3Com 3c90x
89 .El
90 .Sh COMPATIBILITY
91 The implementation of
92 .Nm
93 was originally intended to have similar API interfaces
94 to
95 .Bsx 3.0
96 and
97 .Nx ,
98 but as a result are not well behaved newbus device drivers.
99 .Sh SEE ALSO
100 .Xr arp 4 ,
101 .Xr aue 4 ,
102 .Xr bge 4 ,
103 .Xr cue 4 ,
104 .Xr dc 4 ,
105 .Xr ed 4 ,
106 .Xr fxp 4 ,
107 .Xr gx 4 ,
108 .Xr lge 4 ,
109 .Xr netintro 4 ,
110 .Xr nge 4 ,
111 .Xr pcn 4 ,
112 .Xr rl 4 ,
113 .Xr sf 4 ,
114 .Xr sis 4 ,
115 .Xr sk 4 ,
116 .Xr ste 4 ,
117 .Xr tl 4 ,
118 .Xr tx 4 ,
119 .Xr vr 4 ,
120 .Xr wb 4 ,
121 .Xr xl 4
122 .Sh STANDARDS
123 More information on MII can be found in the IEEE 802.3 Standard.
124 .Sh HISTORY
125 The
126 .Nm
127 driver first appeared in
128 .Fx 3.3 .
129 .Sh AUTHORS
130 This manual page was written by
131 .An Tom Rhodes Aq trhodes@FreeBSD.org .