Debian Codegraph @

upstream/fedora-44/man8/mii-tool.8

raw
1 .\" Copyright (C) 2000 David A. Hinds -- [email protected]
2 .\"
3 .TH MII\-TOOL 8 "2013\-02\-15" "net\-tools" "Linux System Administrator's Manual"
4
5 .SH NAME
6 mii\-tool \- view, manipulate media-independent interface status
7
8 .SH SYNOPSIS
9 .B mii\-tool
10 [\fB\-v\fR, \fB\-\-verbose\fR]
11 [\fB\-V\fR, \fB\-\-version\fR]
12 [\fB\-R\fR, \fB\-\-reset\fR]
13 [\fB\-r\fR, \fB\-\-restart\fR]
14 [\fB\-w\fR, \fB\-\-watch\fR]
15 [\fB\-l\fR, \fB\-\-log\fR]
16 [\fB\-A\fR, \fB\-\-advertise=\fImedia,...\fR]
17 [\fB\-F\fR, \fB\-\-force=\fImedia\fR]
18 [\fB\-p\fR, \fB\-\-phy=\fIaddr\fR]
19 .RI "interface\ ..."
20
21 .SH NOTE
22 .P
23 This program is obsolete. For replacement check \fBethtool\fB.
24
25 .SH DESCRIPTION
26 This utility checks or sets the status of a network interface's Media
27 Independent Interface (MII) unit. Most fast ethernet adapters use an
28 MII to autonegotiate link speed and duplex setting.
29 .PP
30 Most intelligent network devices use an autonegotiation protocol to
31 communicate what media technologies they support, and then select the
32 fastest mutually supported media technology. The \fB\-A\fR or
33 \fB\-\-advertise\fR options can be used to tell the MII to only
34 advertise a subset of its capabilities. Some passive devices, such as
35 single-speed hubs, are unable to autonegotiate. To handle such
36 devices, the MII protocol also allows for establishing a link by
37 simply detecting either a 10baseT or 100baseT link beat. The \fB\-F\fR
38 or \fB\-\-force\fR options can be used to force the MII to operate in
39 one mode, instead of autonegotiating. The \fB\-A\fR and \fB\-F\fR
40 options are mutually exclusive.
41 .PP
42 The default short output reports the negotiated link speed and link
43 status for each interface.
44 .SH OPTIONS
45 .TP
46 \fB\-v\fR, \fB\-\-verbose\fR
47 Display more detailed MII status information. If used twice, also
48 display raw MII register contents.
49 .br
50 \fBAlert:\fR If used three times, will force reading all MII
51 registers, including non standard ones. It's not guaranteed any
52 valid answer from PHY while PHY communication can even hang.
53 With driver e1000e will fail while reading register 0x07.
54 .TP
55 \fB\-V\fR, \fB\-\-version\fR
56 Display program version information.
57 .TP
58 \fB\-R\fR, \fB\-\-reset\fR
59 Reset the MII to its default configuration.
60 .TP
61 \fB\-r\fR, \fB\-\-restart\fR
62 Restart autonegotiation.
63 .TP
64 \fB\-w\fR, \fB\-\-watch\fR
65 Watch interface(s) and report changes in link status. The MII
66 interfaces are polled at one second intervals.
67 .TP
68 \fB\-l\fR, \fB\-\-log\fR
69 Used with \fB\-w\fR, records link status changes in the system log
70 instead of printing on standard output.
71 .TP
72 \fB\-F\fI media\fR, \fB\-\-force=\fImedia\fR
73 Disable autonegotiation, and force the MII to either \fB100baseTx-FD\fR,
74 \fB100baseTx-HD\fR, \fB10baseT-FD\fR, or \fB10baseT-HD\fR operation.
75 .TP
76 \fB\-A\fI media,...\fR, \fB\-\-advertise=\fImedia,...\fR
77 Enable and restart autonegotiation, and advertise only the specified
78 media technologies. Multiple technologies should be separated by
79 commas. Valid media are \fB100baseT4\fR, \fB100baseTx-FD\fR,
80 \fB100baseTx-HD\fR, \fB10baseT-FD\fR, and \fB10baseT-HD\fR.
81 .TP
82 \fB\-p\fI addr\fR, \fB\-\-phy=\fIaddr\fR
83 Override the MII address provided by kernel with value \fBaddr\fR.
84
85 .SH DIAGNOSTICS
86 .TP
87 SIOCGMIIPHY on 'eth?' failed: Invalid argument
88 If the interface is not running (up), kernel will refuse to report its link state.
89 .TP
90 SIOCGMIIPHY on 'eth?' failed: Operation not permitted
91 Most kernels restrict access to root.
92 .TP
93 SIOCGMIIPHY on 'eth?' failed: No such device
94 This error is shown, if the kernel does not know about the named device.
95 .TP
96 SIOCGMIIPHY on 'eth?' failed: Operation not supported
97 The interface in question does not support MII queries. Most likely, it does not have
98 MII transceivers, at all.
99
100 .SH SEE ALSO
101 ethtool(8)
102
103 .SH AUTHORS
104 David Hinds \- [email protected]
105 .br
106 Donald Becker \- [email protected]
107 .br
108 Bernd Eckenfels \- [email protected]
109
110 .SH SEE ALSO
111 http://net-tools.sourceforge.net \- Homepage of the net-tools project