xref: /openbsd-src/share/man/man4/mii.4 (revision e3299561a6f9b60a735f5b2d393ba8210410ca08)
1.\"	$OpenBSD: mii.4,v 1.32 2023/03/06 06:56:49 jmc Exp $
2.\"	$NetBSD: mii.4,v 1.1 1998/11/04 05:21:50 thorpej Exp $
3.\"
4.\" Copyright (c) 1998 The NetBSD Foundation, Inc.
5.\" All rights reserved.
6.\"
7.\" This code is derived from software contributed to The NetBSD Foundation
8.\" by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
9.\" NASA Ames Research Center.
10.\"
11.\" Redistribution and use in source and binary forms, with or without
12.\" modification, are permitted provided that the following conditions
13.\" are met:
14.\" 1. Redistributions of source code must retain the above copyright
15.\"    notice, this list of conditions and the following disclaimer.
16.\" 2. Redistributions in binary form must reproduce the above copyright
17.\"    notice, this list of conditions and the following disclaimer in the
18.\"    documentation and/or other materials provided with the distribution.
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
21.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
24.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30.\" POSSIBILITY OF SUCH DAMAGE.
31.\"
32.Dd $Mdocdate: March 6 2023 $
33.Dt MII 4
34.Os
35.Sh NAME
36.Nm mii
37.Nd IEEE 802.3 Media Independent Interface
38.Sh SYNOPSIS
39.Cd "acphy* at mii?"
40.Cd "amphy* at mii?"
41.Cd "atphy* at mii?"
42.Cd "bmtphy* at mii?"
43.Cd "brgphy* at mii?"
44.Cd "ciphy* at mii?"
45.Cd "dcphy* at mii?"
46.Cd "eephy* at mii?"
47.Cd "etphy* at mii?"
48.Cd "exphy* at mii?"
49.Cd "gentbi* at mii?"
50.Cd "icsphy* at mii?"
51.Cd "ipgphy* at mii?"
52.Cd "inphy* at mii?"
53.Cd "iophy* at mii?"
54.Cd "jmphy* at mii?"
55.Cd "luphy* at mii?"
56.Cd "lxtphy* at mii?"
57.Cd "mtdphy* at mii?"
58.Cd "nsgphy* at mii?"
59.Cd "nsphy* at mii?"
60.Cd "nsphyter* at mii?"
61.Cd "qsphy* at mii?"
62.Cd "rdcphy* at mii?"
63.Cd "rgephy* at mii?"
64.Cd "rlphy* at mii?"
65.Cd "sqphy* at mii?"
66.Cd "tlphy* at mii?"
67.Cd "tqphy* at mii?"
68.Cd "txphy* at mii?"
69.Cd "ukphy* at mii?"
70.Cd "urlphy* at mii?"
71.Cd "xmphy* at mii?"
72.Cd "ytphy* at mii?"
73.Sh DESCRIPTION
74Media Independent Interface is an IEEE standard serial bus for
75connecting MACs (network controllers) to PHYs (physical media
76interfaces).
77The
78.Nm
79layer allows network device drivers to share support code for
80various PHY models, and allows unused support for PHYs which
81are not present in a system to be removed from the kernel.
82.Pp
83Network device drivers which use the
84.Nm
85layer carry the
86.Dq mii
87autoconfiguration attribute.
88This allows kernel configuration files to simply specify PHYs as
89described above in
90.Sx SYNOPSIS .
91.Pp
92The following is an example of the messages displayed when a network
93interface with an attached PHY is detected by the kernel:
94.Bd -literal -offset indent
95hme0 at sbus0 slot 1 offset 0x8c00000 pri 7: address 08:00:20:22:86:b8 rev 34
96nsphy0 at hme0 phy 1: DP83840 10/100 PHY, rev. 1
97.Ed
98.Pp
99Supported media types for the PHY can be displayed or set using the
100.Xr ifconfig 8
101.Cm media
102keyword.
103.Sh SEE ALSO
104.Xr ifmedia 4 ,
105.Xr intro 4 ,
106.Xr netintro 4 ,
107.Xr ifconfig 8
108