1MII-TOOL(8)           Linux System Administrator's Manual          MII-TOOL(8)
2
3
4

NAME

6       mii-tool - view, manipulate media-independent interface status
7
8

SYNOPSIS

10       mii-tool  [-v, --verbose] [-V, --version] [-R, --reset] [-r, --restart]
11       [-w,   --watch]   [-l,   --log]   [-A,   --advertise=media,...]    [-F,
12       --force=media] [-p, --phy=addr] interface ...
13
14

NOTE

16       This program is obsolete. For replacement check ethtool.
17
18

DESCRIPTION

20       This  utility  checks or sets the status of a network interface's Media
21       Independent Interface (MII) unit.  Most fast ethernet adapters  use  an
22       MII to autonegotiate link speed and duplex setting.
23
24       Most  intelligent  network  devices  use an autonegotiation protocol to
25       communicate what media technologies they support, and then  select  the
26       fastest  mutually  supported  media  technology.  The -A or --advertise
27       options can be used to tell the MII to only advertise a subset  of  its
28       capabilities.   Some  passive  devices,  such as single-speed hubs, are
29       unable to autonegotiate.  To handle such devices, the MII protocol also
30       allows  for establishing a link by simply detecting either a 10baseT or
31       100baseT link beat.  The -F or --force options can be used to force the
32       MII  to operate in one mode, instead of autonegotiating.  The -A and -F
33       options are mutually exclusive.
34
35       The default short output reports the negotiated  link  speed  and  link
36       status for each interface.
37

OPTIONS

39       -v, --verbose
40              Display  more  detailed  MII status information.  If used twice,
41              also display raw MII register contents.
42              Alert: If used three times, will force reading  all  MII  regis‐
43              ters, including non standard ones. It's not guaranteed any valid
44              answer from PHY while PHY communication  can  even  hang.   With
45              driver e1000e will fail while reading register 0x07.
46
47       -V, --version
48              Display program version information.
49
50       -R, --reset
51              Reset the MII to its default configuration.
52
53       -r, --restart
54              Restart autonegotiation.
55
56       -w, --watch
57              Watch  interface(s)  and report changes in link status.  The MII
58              interfaces are polled at one second intervals.
59
60       -l, --log
61              Used with -w, records link status  changes  in  the  system  log
62              instead of printing on standard output.
63
64       -F media, --force=media
65              Disable  autonegotiation, and force the MII to either 100baseTx-
66              FD, 100baseTx-HD, 10baseT-FD, or 10baseT-HD operation.
67
68       -A media,..., --advertise=media,...
69              Enable and restart autonegotiation, and advertise only the spec‐
70              ified media technologies.  Multiple technologies should be sepa‐
71              rated by  commas.   Valid  media  are  100baseT4,  100baseTx-FD,
72              100baseTx-HD, 10baseT-FD, and 10baseT-HD.
73
74       -p addr, --phy=addr
75              Override the MII address provided by kernel with value addr.
76
77

DIAGNOSTICS

79       SIOCGMIIPHY on 'eth?' failed: Invalid argument
80              If  the  interface  is  not  running (up), kernel will refuse to
81              report its link state.
82
83       SIOCGMIIPHY on 'eth?' failed: Operation not permitted
84              Most kernels restrict access to root.
85
86       SIOCGMIIPHY on 'eth?' failed: No such device
87              This error is shown, if the kernel does not know about the named
88              device.
89
90       SIOCGMIIPHY on 'eth?' failed: Operation not supported
91              The  interface  in  question  does not support MII queries. Most
92              likely, it does not have MII transceivers, at all.
93
94

SEE ALSO

96       ethtool(8)
97
98

AUTHORS

100       David Hinds - dhinds@pcmcia.sourceforge.org
101       Donald Becker - becker@scyld.com
102       Bernd Eckenfels - net-tools@lina.inka.de
103
104

SEE ALSO

106       http://net-tools.sourceforge.net - Homepage of the net-tools project
107
108
109
110net-tools                         2013-02-15                       MII-TOOL(8)
Impressum