manual/net-tools/original/man8/mii-tool.8

   1 .\" Copyright (C) 2000 David A. Hinds -- dhinds@pcmcia.sourceforge.org
   2 .\" mii-tool.8 1.5 2000/04/25 22:58:19
   3 .\"
   4 .TH MII-TOOL 8 "2000/04/25 22:58:19" "net-tools"
   5
   6 .SH NAME
   7 mii-tool \- view, manipulate media-independent interface status
   8
   9 .SH SYNOPSIS
  10 .B mii-tool
  11 [\fB\-v\fR, \fB\-\-verbose\fR]
  12 [\fB\-V\fR, \fB\-\-version\fR]
  13 [\fB\-R\fR, \fB\-\-reset\fR]
  14 [\fB\-r\fR, \fB\-\-restart\fR]
  15 [\fB\-w\fR, \fB\-\-watch\fR]
  16 [\fB\-l\fR, \fB\-\-log\fR]
  17 [\fB\-A\fR, \fB\-\-advertise=\fImedia,...\fR]
  18 [\fB\-F\fR, \fB\-\-force=\fImedia\fR]
  19 .RI [ "interface\ ..." ]
  20
  21 .SH DESCRIPTION
  22 This utility checks or sets the status of a network interface's Media
  23 Independent Interface (MII) unit.  Most fast ethernet adapters use an
  24 MII to autonegotiate link speed and duplex setting.
  25 .PP
  26 Most intelligent network devices use an autonegotiation protocol to
  27 communicate what media technologies they support, and then select the
  28 fastest mutually supported media technology.  The \fB\-A\fR or
  29 \fB\-\-advertise\fR options can be used to tell the MII to only
  30 advertise a subset of its capabilities.  Some passive devices, such as
  31 single-speed hubs, are unable to autonegotiate.  To handle such
  32 devices, the MII protocol also allows for establishing a link by
  33 simply detecting either a 10baseT or 100baseT link beat.  The \fB\-F\fR
  34 or \fB\-\-force\fR options can be used to force the MII to operate in
  35 one mode, instead of autonegotiating.  The \fB\-A\fR and \fB-F\fR
  36 options are mutually exclusive.
  37 .PP
  38 The default short output reports the negotiated link speed and link
  39 status for each interface.  If an interface or interfaces are not
  40 specified on the command line, then \fBmii-tool\fR will check any
  41 available interfaces from \fBeth0\fR through \fBeth7\fR.
  42 .SH OPTIONS
  43 .TP
  44 \fB\-v\fR, \fB\-\-verbose\fR
  45 Display more detailed MII status information.  If used twice, also
  46 display raw MII register contents.
  47 .TP
  48 \fB\-V\fR, \fB\-\-version\fR
  49 Display program version information.
  50 .TP
  51 \fB\-R\fR, \fB\-\-reset\fR
  52 Reset the MII to its default configuration.
  53 .TP
  54 \fB\-r\fR, \fB\-\-restart\fR
  55 Restart autonegotiation.
  56 .TP
  57 \fB\-w\fR, \fB\-\-watch\fR
  58 Watch interface(s) and report changes in link status.  The MII
  59 interfaces are polled at one second intervals.
  60 .TP
  61 \fB\-l\fR, \fB\-\-log\fR
  62 Used with \fB-w\fR, records link status changes in the system log
  63 instead of printing on standard output.
  64 .TP
  65 \fB\-F\fI media\fR, \fB\-\-force=\fImedia\fR
  66 Disable autonegotiation, and force the MII to either \fB100baseTx-FD\fR,
  67 \fB100baseTx-HD\fR, \fB10baseT-FD\fR, or \fB10baseT-HD\fR operation.
  68 .TP
  69 \fB\-A\fI media,...\fR, \fB\-\-advertise=\fImedia,...\fR
  70 Enable and restart autonegotiation, and advertise only the specified
  71 media technologies.  Multiple technologies should be separated by
  72 commas.  Valid media are \fB100baseT4\fR, \fB100baseTx-FD\fR,
  73 \fB100baseTx-HD\fR, \fB10baseT-FD\fR, and \fB10baseT-HD\fR.
  74
  75 .SH AUTHORS
  76 David Hinds \- dhinds@pcmcia.sourceforge.org
  77 .br
  78 Donald Becker \- becker@scyld.com