161 lines
4.9 KiB
Groff
161 lines
4.9 KiB
Groff
.\" Hey, EMACS: -*- nroff -*-
|
||
.\" $Revision: 1.1 $ $Date: 2003/09/06 17:20:17 $
|
||
.\" First parameter, NAME, should be all caps
|
||
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
||
.\" other parameters are allowed: see man(7), man(1)
|
||
.TH MII-DIAG 8 "September 9, 2003" "Scyld Beowulf\*(Tm"
|
||
.\" Please adjust this date whenever revising the manpage.
|
||
.\"
|
||
.\" Some roff macros, for reference:
|
||
.\" .nh disable hyphenation
|
||
.\" .hy enable hyphenation
|
||
.\" .ad l left justify
|
||
.\" .ad b justify to both left and right margins
|
||
.\" .nf disable filling
|
||
.\" .fi enable filling
|
||
.\" .br insert line break
|
||
.\" .sp <n> insert n+1 empty lines
|
||
.\" for manpage-specific macros, see man(7)
|
||
.SH NAME
|
||
mii-diag \- Network adapter control and monitoring
|
||
.SH SYNOPSIS
|
||
.B mii-diag
|
||
.RI [ options ] <interface>
|
||
.SH DESCRIPTION
|
||
This manual page documents briefly the
|
||
.B mii-diag
|
||
network adapter control and monitoring command.
|
||
Addition documentation is available from http://scyld.com/diag/index.html.
|
||
|
||
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
|
||
.\" \fI<whatever>\fP escape sequences to invoke bold face and italics,
|
||
.\" respectively.
|
||
.PP
|
||
This \fBmii-diag\fP command configures, controls and monitors the
|
||
transceiver management registers for network interfaces, and configures
|
||
driver operational parameters. For transceiver control \fBmii-diag\fP
|
||
uses the Media Independent Interface (MII) standard (thus the command name).
|
||
It also has additional Linux-specific controls to communicate parameters
|
||
such as message enable settings and buffer sizes to the underlying device
|
||
driver.
|
||
.PP
|
||
The MII standard defines registers that control and report network
|
||
transceiver capabilities, link settings and errors. Examples are link
|
||
speed, duplex, capabilities advertised to the link partner, status LED
|
||
indications and link error counters.
|
||
|
||
.SH OPTIONS
|
||
The \fBmii-diag\fP command supports both single character and long
|
||
option names. Short options use a single dash (´-´) in front of the option
|
||
character. For options without parameters, multiple options may be
|
||
concatenated after a single dash. Long options are prefixed by two
|
||
dashes (´--´), and may be abbreviated with a unique prefix.
|
||
A long option may take a parameter of the form --arg=param or --arg param.
|
||
|
||
.PP
|
||
A summary of options is as follows.
|
||
|
||
.TP
|
||
.B \-A, --advertise <speed|setting>
|
||
.BR
|
||
.B \-F, --fixed-speed <speed|setting>
|
||
|
||
Speed is one of: 100baseT4, 100baseTx, 100baseTx-FD, 100baseTx-HD, 10baseT,
|
||
10baseT-FD, 10baseT-HD. For more precise control an explicit numeric
|
||
register setting is also allowed.
|
||
|
||
|
||
.TP
|
||
.B \-a, \--all-interfaces
|
||
Show the status of all interfaces. This option is not recommended with
|
||
any other option, especially ones that change settings.
|
||
|
||
.TP
|
||
.B \-s,\--status
|
||
Return exit status 2 if there is no link beat.
|
||
|
||
.TP
|
||
.B \-D
|
||
Increase the debugging level. This may be used to understand the
|
||
actions the command is taking.
|
||
|
||
.TP
|
||
.B \-g, \--read-parameters
|
||
Show driver-specific parameters.
|
||
|
||
.TP
|
||
.B \-G, \--set-parameters value[,value...]
|
||
Set driver-specific parameters.
|
||
Set a adapter-specific parameters.
|
||
Parameters are comma separated, with missing elements retaining the
|
||
existing value.
|
||
|
||
.TP
|
||
.B \-v
|
||
Increase the verbosity level. Additional "-v" options increase the
|
||
level further.
|
||
|
||
.TP
|
||
.B \-V
|
||
Show the program version information.
|
||
|
||
.TP
|
||
.B \-w, \--watch
|
||
Continuously monitor the transceiver and report changes.
|
||
|
||
.TP
|
||
.B \-?
|
||
Emit usage information.
|
||
|
||
.SH DESCRIPTION
|
||
|
||
.PP
|
||
Calling the command with just the interface name (which defaults to
|
||
'eth0' if missing) produces extensive output describing the transceiver
|
||
capabilities, configuration and current status.
|
||
|
||
.PP
|
||
The '--monitor' option allows scripting link beat changes.
|
||
.PP
|
||
This option is similar to --watch, but with lower overhead and simplified
|
||
output. It polls the interface only once a second and the output format
|
||
is a single line per link change with three fixed words
|
||
<unknown|down||negotiating|up> <STATUS> <PARTNER-CAP>
|
||
.PP
|
||
Example output: mii-diag --monitor eth0
|
||
down 0x7809 0x0000
|
||
negotiating 0x7829 0x45e1
|
||
up 0x782d 0x45e1
|
||
down 0x7809 0x0000
|
||
|
||
.PP
|
||
This may be used as
|
||
mii-diag --monitor eth0 |
|
||
while read linkstatus bmsr linkpar; do
|
||
case $linkstatus in
|
||
up) ifup eth0 ;;
|
||
down) ifdown eth0 ;;
|
||
esac
|
||
done
|
||
|
||
.PP
|
||
It may be useful to shorten the DHCP client daemon timeout if it does
|
||
not receive an address by adding the following setting to
|
||
/etc/sysconfig/network:
|
||
DHCPCDARGS="-t 3"
|
||
|
||
.SH SEE ALSO
|
||
.BR ether-wake (8), net-diag (8), mii-tool (8).
|
||
.br
|
||
Addition documentation is available from http://scyld.com/diag/index.html.
|
||
|
||
.SH KNOWN BUGS
|
||
The --all-interfaces option is quirky. There are very few settings that
|
||
are usefully applied to all interfaces.
|
||
|
||
.SH AUTHOR
|
||
The manual pages, diagnostic commands, and many of the underlying Linux
|
||
network drivers were written by Donald Becker for the Scyld
|
||
Beowulf(\*(Tm) cluster system.
|
||
|