Menu
Home
People
Places
Arts
History
Plants & Animals
Science
Life & Culture
Technology
Reference.org
ethtool
open-in-new
<h2 id="usage">Usage</h2> <p>The command is useful for: </p> <ul><li>Identification and diagnosis of Ethernet devices</li> <li>Extended Ethernet devices statistics</li> <li>Control speed, duplex, <a href="/facts/Autonegotiation/dHFQJDEs">autonegotiation</a> and <a href="/facts/Flow_control_(data)/qcdKcLon">flow control</a> for Ethernet devices</li> <li>Control <a href="/facts/Checksum/AqxQ0I8g">checksum</a> offload and other hardware offload features, such as <a href="/facts/Large_receive_offload/SDRvDp8t">large receive offload</a> and <a href="/facts/Large_send_offload/Yp6eAprk">large send offload</a></li> <li>Control <a href="/facts/Direct_memory_access/DWuVgclV">DMA</a> ring sizes and interrupt moderation</li> <li>Control receive queue selection for <a href="/facts/Multiqueue_NIC/wyf5FR29">multiqueue devices</a></li> <li>Upgrade <a href="/facts/Firmware/62UVKIUK">firmware</a> in <a href="/facts/Flash_memory/Cn8JsStx">flash memory</a></li></ul> <h2 id="examples">Examples</h2> <p>To display the current parameters of the first network port (eth0): </p> $ ethtool eth0 Settings for eth0: Supported ports: [ TP MII ] Supported link modes: 10baseT/Half 10baseT/Full 100baseT/Half 100baseT/Full Supports auto-negotiation: Yes Advertised link modes: 10baseT/Half 10baseT/Full 100baseT/Half 100baseT/Full Advertised auto-negotiation: No Speed: 100Mb/s Duplex: Full Port: MII PHYAD: 1 Transceiver: internal Auto-negotiation: off Supports Wake-on: g Wake-on: g Current message level: 0x00000007 (7) Link detected: yes <p><a class="footnote-ref" id="fnref:1" href="#fn:1"><sup>1</sup></a> </p><p>To configure it with the 1000 Mb/s speed and <a href="/facts/Duplex_(telecommunications)/LCULeVxr">duplex</a>, in <a href="/facts/1000BASE-T/1ItIoV2w">1000BASE-T</a>: </p> $ ethtool -s eth0 speed 1000 duplex full autoneg off <p>To let the link light of the device eth0 flash for two minutes: </p> $ ethtool -p eth0 120 <p>To print the driver info of the interface eth0:</p>$ ethtool -i eth0 driver: mlx5_core version: 4.9-2.2.4 firmware-version: 14.28.2006 (MT_2420110034) expansion-rom-version: bus-info: 0000:65:00.1 supports-statistics: yes supports-test: yes supports-eeprom-access: no supports-register-dump: no supports-priv-flags: yes <h2 id="mii-tool">mii-tool</h2> <p>mii-tool is an older program performing a similar function to ethtool. Since 2003,<a class="footnote-ref" id="fnref:2" href="#fn:2"><sup>2</sup></a> it's considered obsolete and replaced by ethtool. </p> <h3>Example</h3> <p>To display the current parameters: </p> $ mii-tool eth0: no autonegotiation, 100baseTx-HD, link ok <p>To force the network speed to 1 Gbit/s, and the <i>duplex</i> in <i>full</i> on the port 1 (eth0): </p> $ mii-tool -F 1000baseTx-FD eth0 $ mii-tool eth0: 1 000 Mbit, full duplex, link ok <h2 id="see-also">See also</h2> <ul> <li>Free and open-source software portal</li></ul> <ul><li><a href="/facts/Iproute2/JoyfcKU5">iproute2</a></li></ul> <h2 id="external-links">External links</h2> <ul><li><a href="https://www.kernel.org/pub/software/network/ethtool/">Official website</a></li> <li><a href="http://www.thegeekstuff.com/2010/10/ethtool-command/">Ethtool examples</a></li> <li><a href="http://sourceforge.net/projects/net-tools/">Net Tools on sourceforge.net</a></li></ul> <h2 id="references">References</h2> <ol> <li id="fn:1"><p>"9 Linux ethtool Examples to Manipulate Ethernet Card (NIC Card)". www.thegeekstuff.com. 2010-10-28. Retrieved 2020-11-14. <a href="https://www.thegeekstuff.com/2010/10/ethtool-command/" target="_blank">https://www.thegeekstuff.com/2010/10/ethtool-command/</a> <a href="#fnref:1" class="footnote-back-ref">↩</a></p></li> <li id="fn:2"><p>"Ethernet Auto-negotiation and Duplexing on Linux". lists.olug.org. September 2003. <a href="http://lists.olug.org/pipermail/olug/2003-September/010415.html" target="_blank">http://lists.olug.org/pipermail/olug/2003-September/010415.html</a> <a href="#fnref:2" class="footnote-back-ref">↩</a></p></li> </ol>