ETHTOOL

Section: Maintenance Commands (8)
Updated: August 2001
Index
Return to Main Contents

NAME

ethtool - Display or change ethernet card settings

SYNOPSIS

ethtool ethX

ethtool -i ethX

ethtool -h

ethtool -s ethX [ speed { 10,100,1000 } ] [ duplex { half,full } ] [ port { tp,aui,mii,fibre } ] [ autoneg { on,off } ] [ phyad N ] [ xcvr { internal,external } ] [ wol [ pumbagsd ]+ ] [ sopass X:X:X:X:X:X ]

DESCRIPTION

ethtool is used for querying settings of an ethernet device and changing them.

ethX is the name of the ethernet device to work on.

OPTIONS

ethtool with a single argument specifying the device name prints current setting of the specified device.

-i: queries the specified ethernet device for associated driver information.
-h: shows a short help message.
-s: option allows changing some or all settings of the specified ethernet device. All following options only apply if -s was specified.
speed: Set speed in Mb/s. ethtool with single argument will show you the supported device speeds.
duplex: Set full or half duplex mode.
port: Select device port.
autoneg: Specify if autonegotiation is enabled. In the usual case it is, but might cause some problems with some network devices, so you can turn it off.
phyad: Physical address. Not used yet.
xcvr: Select transceiver type. Currently only internal and external can be specified, in the future further types might be added.
wol: Set Wake-on-LAN options. Not all devices support this. The argument to this option is a string of characters specifying which options to enable.
p: Wake on phy activity
u: Wake on unicast messages
m: Wake on multicast messages
b: Wake on broadcast messages
a: Wake on ARP
g: Wake on MagicPacket(tm)
s: Enable SecureOn(tm) password for MagicPacket(tm)
d: Disable (wake on nothing). This option clears all previous options.

sopass: Set the SecureOn(tm) password. The argument to this option must be 6 bytes in ethernet MAC hex format (xx:yy:zz:aa:bb:cc).

BUGS

Not supported (in part or whole) on all ethernet drivers (read /usr/share/doc/ethtool/README.debian to get an idea about supported features). Only supported on 2.4 kernel and Sparc running 2.2 kernel with Happy Meal ethernet card.

AUTHOR

ethtool was written by David Miller <davem@redhat.com>.

Modifications by Jeff Garzik <jgarzik@mandrakesoft.com>, Tim Hockin <thockin@sun.com>.

Manual page written by Jakub Jelinek <jj@ultra.linux.cz>.

AVAILABILITY

ethtool is available on SourceForge in gkernel project (http://sourceforge.net/projects/gkernel/).

This document was created by man2html, using the manual pages.
Time: 17:54:40 GMT, October 11, 2024