ethtool

顯示或修改以太網卡的配置信息

補充說明

ethtool命令用于獲取以太網卡的配置信息，或者修改這些配置。這個命令比較復雜，功能特別多。

語法

ethtool [ -a | -c | -g | -i | -d | -k | -r | -S |] ethX
ethtool [-A] ethX [autoneg on|off] [rx on|off] [tx on|off]
ethtool [-C] ethX [adaptive-rx on|off] [adaptive-tx on|off] [rx-usecs N] [rx-frames N] [rx-usecs-irq N] [rx-frames-irq N] [tx-usecs N] [tx-frames N] [tx-usecs-irq N] [tx-frames-irq N] [stats-block-usecs N][pkt-rate-low N][rx-usecs-low N] [rx-frames-low N] [tx-usecs-low N] [tx-frames-lowN] [pkt-rate-high N] [rx-usecs-high N] [rx-frames-high N] [tx-usecs-high N] [tx-frames-high N] [sample-interval N]
ethtool [-G] ethX [rx N] [rx-mini N] [rx-jumbo N] [tx N]
ethtool [-e] ethX [raw on|off] [offset N] [length N]
ethtool [-E] ethX [magic N] [offset N] [value N]
ethtool [-K] ethX [rx on|off] [tx on|off] [sg on|off] [tso on|off]
ethtool [-p] ethX [N]
ethtool [-t] ethX [offline|online]
ethtool [-s] ethX [speed 10|100|1000] [duplex half|full] [autoneg on|off] [port tp|aui|bnc|mii] [phyad N] [xcvr internal|external]
[wol p|u|m|b|a|g|s|d...] [sopass xx:yy:zz:aa:bb:cc] [msglvl N]

選項

-a 查看網卡中 接收模塊RX、發送模塊TX和Autonegotiate模塊的狀態：啟動on 或 停用off。
-A 修改網卡中 接收模塊RX、發送模塊TX和Autonegotiate模塊的狀態：啟動on 或 停用off。
-c display the Coalesce information of the specified ethernet card。
-C Change the Coalesce setting of the specified ethernet card。
-g Display the rx/tx ring parameter information of the specified ethernet card。
-G change the rx/tx ring setting of the specified ethernet card。
-i 顯示網卡驅動的信息，如驅動的名稱、版本等。
-d 顯示register dump信息, 部分網卡驅動不支持該選項。
-e 顯示EEPROM dump信息，部分網卡驅動不支持該選項。
-E 修改網卡EEPROM byte。
-k 顯示網卡Offload參數的狀態：on 或 off，包括rx-checksumming、tx-checksumming等。
-K 修改網卡Offload參數的狀態。
-p 用于區別不同ethX對應網卡的物理位置，常用的方法是使網卡port上的led不斷的閃；N指示了網卡閃的持續時間，以秒為單位。
-r 如果auto-negotiation模塊的狀態為on，則restarts auto-negotiation。
-S 顯示NIC- and driver-specific 的統計參數，如網卡接收/發送的字節數、接收/發送的廣播包個數等。
-t 讓網卡執行自我檢測，有兩種模式：offline or online。
-s 修改網卡的部分配置，包括網卡速度、單工/全雙工模式、mac地址等。

數據來源

Ethtool命令顯示的信息來源于網卡驅動層，即TCP/ip協議的鏈路層。該命令在Linux內核中實現的邏輯層次為：

最重要的結構體struct ethtool_ops，該結構體成員為用于顯示或修改以太網卡配置的一系列函數指針，見下表中的第二列。

網卡驅動負責實現（部分）這些函數，并將其封裝入ethtool_ops結構體，為網絡核心層提供統一的調用接口。因此，不同的網卡驅動會給應用層返回不同的信息。Ethtool命令選項、struct ethtool_ops成員函數、Ethtool命令顯示參數的來源，三者間的對應關系如下表所示：

命令選項	struct ethtool_ops成員函數	Ethtool命令顯示參數的來源（以網卡驅動BNX2為例）
無 -s	get_settingsget_wol get_msglevel get_link set_settings set_wol set_msglevel	從網卡寄存器中獲得網卡速度等信息，可配置。
-a -A	get_pauseparam set_pauseparam	從網卡寄存器中獲得Autonegotiate/RX/TX模塊的狀態：on oroff，可配置。
-c -C	get_coalesceset_coalesce	從網卡寄存器中獲得coalescing參數：TX/RX一個數據包后，推遲發生TX/RX中斷的時間(us)/數據包個數。—減小該值可以提高網卡的響應時間。當rx-usecs&rx-frames同時被設為0時，RX中斷停止。當tx-usecs&tx-frames同時被設為0時，TX中斷停止。
-g -G	get_ringparam set_ringparam	除當前TX/RX ring的值（從網卡寄存器中讀取得到，可配置）外，其它為網卡bnx2自己固定的信息。
-k -K	get_rx_csumget_tx_csum get_sg get_tso set_rx_csum set_tx_csum set_sg set_tso	顯示信息從保存該狀態的變量中讀取得到，沒有對應的寄存器。因此，TX/RX校驗等模塊一直處于on狀態，實際上是無法修改的。
-i	get_drvinfo[self_test_count, get_stats_coun,t get_regs_len, get_eeprom_len]	網卡bnx2自己固定的信息，如： ——————————————————– driver: bnx2 version: 1.4.30 firmware-version: 1.8.0.5 bus-info: 0000:09:00.0 ——————————————————–
-d	get_drvinfoget_regs	不支持，即bnx2中沒有實現函數get_regs。
-e -E	get_eepromset_eeprom	不支持，即bnx2中沒有實現函數get_eeprom。
-r	nway_reset	配置網卡MII_BMCR寄存器，重啟Auto negotiation模塊。
-p	phys_id	配置網卡BNX2_EMAC_LED寄存器，實現LED閃功能。
-t	self_test	通過配置網卡寄存器，逐一測試網卡的硬件模塊：registers，memory，loopback，Link stat，interrupt。
-S	get_ethtool_stats	顯示信息來源于網卡驅動中的結構體變量stats_blk。（網卡通過DMA方式，將寄存器BNX2_HC_STATISTICS _ADDR_L和BNX2_HC_STATISTICS_ADDR_H中的數據實時地讀取到結構體變量struct statistics_block *stats_blk中。） —顯示的數據都是從網卡寄存器中統計得到的，各項的含義需查詢網卡（芯片）手冊。

由上可見，ethtool命令用于顯示/配置網卡硬件（寄存器）。 ?

實例

查看機器上網卡的速度：百兆還是千兆，請輸入：

ethool eth0

操作完畢后，輸出信息中Speed:這一項就指示了網卡的速度。停止網卡的發送模塊TX，請輸入：

ethtool -A tx off eth0

操作完畢后，可輸入ethtool -a eth0，查看tx模塊是否已被停止。查看網卡eth0采用了何種驅動，請輸入：

ethtool -i eth0

操作完畢后，顯示 driver: bnx2；version: 1.4.30 等信息。關閉網卡對收到的數據包的校驗功能，請輸入：

ethtool -K eth0 rx off

操作完畢后，可輸入ethtool –k eth0，查看校驗功能是否已被停止。如果機器上安裝了兩塊網卡，那么eth0對應著哪塊網卡呢？輸入：

ethtool -p eth0 10

操作完畢后，看哪塊網卡的led燈在閃，eth0就對應著哪塊網卡。查看網卡，在接收/發送數據時，有沒有出錯？請輸入：

ethtool –S eth0

將千兆網卡的速度降為百兆，請輸入：

ethtool -s eth0 speed 100