| ETHTOOL(8) | دستورات مدیریت سیستم | ETHTOOL(8) |
نام (NAME)
ethtool - استعلام یا کنترل درایور شبکه و تنظیمات سختافزاری
خلاصه دستور (SYNOPSIS)
ethtool devname
ethtool -h|--help
ethtool --version
ethtool [--debug N] args
ethtool [--disable-netlink] args
ethtool [--json] args
ethtool [-I | --include-statistics] args
ethtool [--phy N] args
ethtool --monitor [ command ] [ devname ]
ethtool -a|--show-pause devname
ethtool -A|--pause devname [autoneg on|off] [rx on|off] [tx on|off]
ethtool -c|--show-coalesce devname
ethtool -C|--coalesce devname [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-low N] [pkt-rate-high N] [rx-usecs-high N] [rx-frames-high N] [tx-usecs-high N] [tx-frames-high N] [sample-interval N] [cqe-mode-rx on|off] [cqe-mode-tx on|off] [tx-aggr-max-bytes N] [tx-aggr-max-frames N] [tx-aggr-time-usecs N] [rx-cqe-frames N] [rx-cqe-nsecs N]
ethtool -g|--show-ring devname
ethtool -G|--set-ring devname [rx N] [rx-mini N] [rx-jumbo N] [tx N] [rx-buf-len N] [tcp-data-split auto|on|off] [hds-thresh N] [cqe-size N] [tx-push N] [rx-push N] [tx-push-buf-len N]
ethtool -i|--driver devname
ethtool -d|--register-dump devname [raw on|off] [hex on|off] [file name]
ethtool -e|--eeprom-dump devname [raw on|off] [offset N] [length N]
ethtool -E|--change-eeprom devname [magic N] [offset N] [length N] [value N]
ethtool -k|--show-features|--show-offload devname
ethtool -K|--features|--offload devname feature on|off ...
ethtool -p|--identify devname [N]
ethtool -P|--show-permaddr devname
ethtool -r|--negotiate devname
ethtool -S|--statistics devname [--all-groups|--groups [eth-phy] [eth-mac] [eth-ctrl] [rmon] ]
ethtool --phy-statistics devname
ethtool -t|--test devname [offline|online|external_lb]
ethtool -s devname [speed N] [lanes N] [duplex half|full] [port tp|aui|bnc|mii] [mdix auto|on|off] [autoneg on|off] [advertise N[/M] | advertise mode on|off ...] [phyad N] [xcvr internal|external] [wol N[/M] | wol p|u|m|b|a|g|s|f|d...] [sopass xx:yy:zz:aa:bb:cc] [master-slave preferred-master|preferred-slave|forced-master|forced-slave] [msglvl N[/M] | msglvl type on|off ...]
ethtool -n|-u|--show-nfc|--show-ntuple devname
[ rx-flow-hash tcp4|udp4|ah4|esp4|sctp4|tcp6|udp6|ah6|esp6|sctp6 |
rule N ]
ethtool -N|-U|--config-nfc|--config-ntuple
devname
rx-flow-hash tcp4|udp4|ah4|esp4|sctp4|tcp6|udp6|ah6|esp6|sctp6 m|v|t|s|d|f|n|r... |
flow-type
ether|ip4|tcp4|udp4|sctp4|ah4|esp4|ip6|tcp6|udp6|ah6|esp6|sctp6
[src xx:yy:zz:aa:bb:cc [m xx:yy:zz:aa:bb:cc]]
[dst xx:yy:zz:aa:bb:cc [m xx:yy:zz:aa:bb:cc]]
[proto N [m N]]
[src-ip ip-address [m ip-address]]
[dst-ip ip-address [m ip-address]]
[tos N [m N]]
[tclass N [m N]]
[l4proto N [m N]]
[src-port N [m N]]
[dst-port N [m N]]
[spi N [m N]]
[l4data N [m N]]
[vlan-etype N [m N]]
[vlan N [m N]]
[user-def N [m N]]
[dst-mac xx:yy:zz:aa:bb:cc [m xx:yy:zz:aa:bb:cc]]
[action N] [context N]
[loc N] |
delete N
ethtool -w|--get-dump devname [data filename]
ethtool -W|--set-dump devname N
ethtool -T|--show-time-stamping devname [index N qualifier precise|approx]
ethtool --get-hwtimestamp-cfg devname
ethtool --set-hwtimestamp-cfg devname [index N qualifier precise|approx] [tx TX-TYPE] [rx-filter RX-FILTER]
ethtool -x|--show-rxfh-indir|--show-rxfh devname
ethtool -X|--set-rxfh-indir|--rxfh devname [hkey xx:yy:zz:aa:bb:cc:...] [start N] [ equal N | weight W0 W1 ... | default ] [hfunc FUNC] [xfrm symmetric-xor|symmetric-or-xor|none] [context CTX | new] [delete]
ethtool -f|--flash devname file [N]
ethtool -l|--show-channels devname
ethtool -L|--set-channels devname [rx N] [tx N] [other N] [combined N]
ethtool -m|--dump-module-eeprom|--module-info devname [raw on|off] [hex on|off] [pages on|off] [offset N] [length N] [page N] [bank N] [i2c N]
ethtool --show-priv-flags devname
ethtool --set-priv-flags devname flag on|off ...
ethtool --show-eee devname
ethtool --set-eee devname [eee on|off] [tx-lpi on|off] [tx-timer N] [advertise N]
ethtool --set-phy-tunable devname [ downshift on|off [count N] ] [ fast-link-down on|off [msecs N] ] [ energy-detect-power-down on|off [msecs N] ]
ethtool --get-phy-tunable devname [downshift] [fast-link-down] [energy-detect-power-down]
ethtool --get-tunable devname [rx-copybreak] [tx-copybreak] [tx-buf-size] [pfc-prevention-tout]
ethtool --set-tunable devname [rx-copybreak N] [tx-copybreak N] [tx-buf-size N] [pfc-prevention-tout N]
ethtool --reset devname [flags N] [mgmt] [mgmt-shared] [irq] [irq-shared] [dma] [dma-shared] [filter] [filter-shared] [offload] [offload-shared] [mac] [mac-shared] [phy] [phy-shared] [ram] [ram-shared] [ap] [ap-shared] [dedicated] [all]
ethtool --show-fec devname
ethtool --set-fec devname encoding auto|off|rs|baser|llrs [...]
ethtool -Q|--per-queue devname [queue_mask %x] sub_command ...
ethtool --cable-test devname
ethtool --cable-test-tdr devname [first N] [last N] [step N] [pair N]
ethtool --show-tunnels devname
ethtool --show-module devname
ethtool --set-module devname [power-mode-policy high|auto]
ethtool --get-plca-cfg devname
ethtool --set-plca-cfg devname [enable on|off] [node-id N] [node-cnt N] [to-tmr N] [burst-cnt N] [burst-tmr N]
ethtool --get-plca-status devname
ethtool --show-mm devname
ethtool --set-mm devname [verify-enabled on|off] [verify-time N] [tx-enabled on|off] [pmac-enabled on|off] [tx-min-frag-size N]
ethtool --show-pse devname
ethtool --set-pse devname [podl-pse-admin-control enable|disable] [c33-pse-admin-control enable|disable] [c33-pse-avail-pw-limit N] [prio N]
ethtool --flash-module-firmware devname file FILE [pass PASS]
ethtool --show-phys devname
توضیحات (DESCRIPTION)
دستور ethtool برای استعلام و کنترل درایور دستگاه شبکه و تنظیمات سختافزاری، بهویژه برای دستگاههای اترنت کابلی استفاده میشود.
devname نام دستگاه شبکهای است که ethtool باید روی آن عملیات انجام دهد.
گزینهها (OPTIONS)
دستور ethtool با یک آرگومان تنها که نام دستگاه را مشخص میکند، تنظیمات فعلی دستگاه مشخصشده را نمایش میدهد.
- -h --help
- یک پیام راهنمای کوتاه را نمایش میدهد.
- --version
- شماره نسخه ethtool را نمایش میدهد.
- --debug N
- پیامهای
اشکالزدایی
را فعال
میکند.
آرگومان به
عنوان یک
ماسک تفسیر
میشود:
0x01 اطلاعات تجزیهکننده (Parser) 0x02 خلاصه پیامهای نتلینک (netlink) 0x04 تخلیه هگزادسیمال پیامهای نتلینک ارسالی 0x08 تخلیه هگزادسیمال پیامهای نتلینک دریافتی 0x10 ساختار پیامهای نتلینک - --disable-netlink
- از نتلینک استفاده نکند و در صورت امکان به رابط ioctl بازگردد.
- --json
- نتایج را در قالب JSON (نشانهگذاری شیء جاوااسکریپت) خروجی میدهد. تنها زیرمجموعهای از گزینهها از این ویژگی پشتیبانی میکنند. گزینههایی که پشتیبانی نمیکنند، با وجود این گزینه همچنان متن ساده خروجی خواهند داد.
- -I --include-statistics
- آمار مربوط به دستور را در خروجی لحاظ میکند. این گزینه امکان نمایش آمار مرتبط با دستگاه را برای دستورات دریافت (get) منتخب فراهم میسازد.
- --phy N
- یک PHY را درون
رابط هدف
قرار
میدهد.
نمایه PHY را
میتوان با
--show-phys به دست
آورد. نمایه
PHY برابر با 0،
دستگاه phy را
هدف قرار
میدهد که
مستقیماً
به MAC اترنت
متصل است
(در صورت
وجود).
دستورات
زیر
میتوانند
یک نمایه PHY
را بپذیرند:
--cable-test --cable-test-tdr --get-plca-cfg --set-plca-cfg --get-plca-status --show-pse --set-pse --show-mse - -a --show-pause
- اطلاعات پارامتر توقف (pause) را از دستگاه اترنت مشخصشده استعلام میکند.
- --src aggregate|emac|pmac
- اگر لایه MAC Merge پشتیبانی شود، یک منبع مشخص از آمار دستگاه را درخواست میکند (eMAC یا pMAC، یا تجمیع آنها). تنها زمانی معتبر است که ethtool با آرگومان -I --include-statistics فراخوانی شده باشد.
- -A --pause
- پارامترهای توقف (pause) دستگاه اترنت مشخصشده را تغییر میدهد.
- autoneg on|off
- مشخص میکند که آیا مذاکره خودکار توقف (pause autonegotiation) باید فعال باشد یا خیر.
- rx on|off
- مشخص میکند که آیا توقف RX باید فعال باشد یا خیر.
- tx on|off
- مشخص میکند که آیا توقف TX باید فعال باشد یا خیر.
- -c --show-coalesce
- دستگاه شبکه مشخصشده را برای اطلاعات ادغام وقفهها (coalescing) استعلام میکند.
- -C --coalesce
- تنظیمات ادغام وقفهها (coalescing) دستگاه شبکه مشخصشده را تغییر میدهد.
- -g --show-ring
- دستگاه شبکه مشخصشده را برای اطلاعات پارامترهای حلقه (ring) ارسال/دریافت استعلام میکند.
- -G --set-ring
- پارامترهای حلقه ارسال/دریافت دستگاه شبکه مشخصشده را تغییر میدهد.
- rx N
- تعداد ورودیهای حلقه را برای حلقه Rx تغییر میدهد.
- rx-mini N
- تعداد ورودیهای حلقه را برای حلقه Rx Mini تغییر میدهد.
- rx-jumbo N
- تعداد ورودیهای حلقه را برای حلقه Rx Jumbo تغییر میدهد.
- tx N
- تعداد ورودیهای حلقه را برای حلقه Tx تغییر میدهد.
- rx-buf-len N
- اندازه بافر در حلقه Rx را تغییر میدهد.
- tcp-data-split auto|on|off
- وضعیت تفکیک دادههای TCP را مشخص میکند.
- hds-thresh N
- مقدار آستانه تفکیک دادههای TCP را مشخص میکند.
- cqe-size N
- اندازه رویداد صف تکمیل (completion queue event) را تغییر میدهد.
- tx-push on|off
- مشخص میکند که آیا TX push باید فعال باشد یا خیر.
- rx-push on|off
- مشخص میکند که آیا RX push باید فعال باشد یا خیر.
- tx-push-buf-len N
- حداکثر تعداد بایتهای یک بسته ارسالی را مشخص میکند که درایور میتواند مستقیماً به دستگاه زیربنایی ارسال (push) کند.
- -i --driver
- اطلاعات درایور مرتبط را از دستگاه شبکه مشخصشده استعلام میکند.
- -d --register-dump
- تخلیه ثباتها (register dump) را برای دستگاه شبکه مشخصشده دریافت و چاپ میکند. قالب ثبات برای برخی دستگاهها شناختهشده و رمزگشاییشده است و برای برخی دیگر به صورت هگزادسیمال چاپ میشود. هنگامی که raw فعال باشد، ethtool دادههای خام ثبات را به خروجی استاندارد (stdout) میفرستد. اگر file مشخص شود، به جای خواندن از دستگاه، از محتویات تخلیه خام ثبات قبلی استفاده میکند.
- -e --eeprom-dump
- تخلیه حافظه EEPROM را برای دستگاه شبکه مشخصشده دریافت و چاپ میکند. هنگامی که raw فعال باشد، دادههای خام EEPROM را در stdout چاپ میکند. پارامترهای length و offset امکان تخلیه بخشهای خاصی از EEPROM را فراهم میکنند. حالت پیشفرض، تخلیه کل EEPROM است.
- -E --change-eeprom
- اگر value مشخص شده باشد، بایت EEPROM را برای دستگاه شبکه مشخصشده تغییر میدهد. پارامترهای offset و value مشخص میکنند کدام بایت و مقدار جدید آن چیست. اگر value مشخص نشده باشد، ورودی استاندارد (stdin) خوانده شده و در EEPROM نوشته میشود. پارامترهای length و offset امکان نوشتن در بخشهای خاصی از EEPROM را فراهم میکنند. به دلیل ماهیت ماندگار نوشتن در EEPROM، یک کلید جادویی (magic key) مخصوص دستگاه باید تعیین شود تا از نوشتن تصادفی در EEPROM جلوگیری به عمل آید.
- -k --show-features --show-offload
- دستگاه شبکه مشخصشده را برای وضعیت برونسپاری پروتکل (offload) و سایر ویژگیها استعلام میکند.
- -K --features --offload
- پارامترهای برونسپاری و سایر ویژگیهای دستگاه شبکه مشخصشده را تغییر میدهد. نام ویژگیهای زیر توکار هستند و سایر موارد ممکن است توسط کرنل تعریف شوند.
- rx on|off
- مشخص میکند که آیا محاسبه مجموع مقابلهای RX (RX checksumming) باید فعال باشد یا خیر.
- tx on|off
- مشخص میکند که آیا محاسبه مجموع مقابلهای TX (TX checksumming) باید فعال باشد یا خیر.
- sg on|off
- مشخص میکند که آیا پراکندگی-گردآوری (scatter-gather) باید فعال باشد یا خیر.
- tso on|off
- مشخص میکند که آیا برونسپاری قطعهبندی TCP (TCP segmentation offload) باید فعال باشد یا خیر.
- ufo on|off
- مشخص میکند که آیا برونسپاری قطعهبندی UDP (UDP fragmentation offload) باید فعال باشد یا خیر.
- gso on|off
- مشخص میکند که آیا برونسپاری قطعهبندی عمومی (generic segmentation offload) باید فعال باشد یا خیر.
- gro on|off
- مشخص میکند که آیا برونسپاری دریافت عمومی (generic receive offload) باید فعال باشد یا خیر.
- lro on|off
- مشخص میکند که آیا برونسپاری دریافت بزرگ (large receive offload) باید فعال باشد یا خیر.
- rxvlan on|off
- مشخص میکند که آیا شتابدهی RX VLAN باید فعال باشد یا خیر.
- txvlan on|off
- مشخص میکند که آیا شتابدهی TX VLAN باید فعال باشد یا خیر.
- ntuple on|off
- مشخص میکند که آیا فیلترها و اقدامات Rx ntuple باید فعال باشند یا خیر.
- rxhash on|off
- مشخص میکند که آیا برونسپاری هش دریافت (receive hashing offload) باید فعال باشد یا خیر.
- -p --identify
- اقدام مخصوص آداپتور را برای کمک به اپراتور جهت شناسایی بصری آسان آداپتور آغاز میکند. معمولاً این کار شامل چشمکزدن یک یا چند چراغ LED روی پورت شبکه مشخصشده است.
- [ N]
- مدت زمان اجرای شناسایی فیزیکی (phys-id) به ثانیه.
- -P --show-permaddr
- دستگاه شبکه مشخصشده را برای آدرس سختافزاری دائمی (MAC) استعلام میکند.
- -r --negotiate
- مذاکره خودکار را روی دستگاه اترنت مشخصشده بازنشانی میکند، در صورتی که مذاکره خودکار فعال باشد.
- -S --statistics
- دستگاه شبکه مشخصشده را برای آمار استاندارد (IEEE، IETF و غیره) یا آمار مختص درایور و کارت شبکه (NIC) استعلام میکند. هنگامی که هیچ گروهی از آمار مشخص نشود، آمار مختص NIC و درایور درخواست میشود.
آمار مختص NIC و درایور از آمار استاندارد مستقل هستند؛ دستگاهها ممکن است هر کدام، هر دو یا هیچیک را پیادهسازی کنند. اشتراک نامگذاری آمار مختص NIC و درایور در بین سازندگان مختلف بسیار اندک است.
- --all-groups
- --groups [eth-phy] [eth-mac] [eth-ctrl] [rmon]
- درخواست گروههایی از آمار استاندارد دستگاه.
- --src aggregate|emac|pmac
- اگر لایه MAC Merge پشتیبانی شود، یک منبع مشخص از آمار دستگاه را درخواست میکند (eMAC یا pMAC، یا تجمیع آنها).
- --phy-statistics
- دستگاه شبکه مشخصشده را برای آمار مختص PHY استعلام میکند.
- -t --test
- خودآزمایی آداپتور را روی دستگاه شبکه مشخصشده اجرا میکند. حالتهای ممکن برای آزمون عبارتند از:
- offline
- اجرای مجموعه کامل آزمونها، که احتمالاً عملکرد عادی را در طول آزمایش متوقف میکند،
- online
- اجرای مجموعه محدودی از آزمونها، بدون ایجاد اختلال در عملکرد عادی،
- external_lb
- اجرای مجموعه کامل آزمونها همانند offline، به علاوه آزمایش حلقه خارجی (external-loopback).
- -s --change
- امکان تغییر برخی یا همه تنظیمات دستگاه شبکه مشخصشده را فراهم میکند. تمام گزینههای زیر تنها زمانی اعمال میشوند که -s مشخص شده باشد.
- speed N
- تنظیم سرعت بر حسب مگابیت بر ثانیه (Mb/s). اجرای ethtool تنها با نام دستگاه به عنوان آرگومان، سرعتهای پشتیبانیشده توسط دستگاه را به شما نشان خواهد داد.
- lanes N
- تنظیم تعداد مسیرها (lanes).
- duplex half|full
- حالت دوطرفه همزمان (full) یا غیرهمزمان (half) را تنظیم میکند.
- port tp|aui|bnc|mii
- پورت دستگاه را انتخاب میکند.
- master-slave preferred-master|preferred-slave|forced-master|forced-slave
- نقش MASTER/SLAVE
مربوط به PHY
را
پیکربندی
میکند.
هنگامی که PHY
به عنوان MASTER
پیکربندی
شود، تابع
ارسال PMA
کلاک TX_TCLK را از
یک منبع
کلاک محلی
تامین
میکند.
هنگامی که
به عنوان SLAVE
پیکربندی
شود، تابع
ارسال PMA
کلاک TX_TCLK را از
کلاک
بازیابیشده
از جریان
داده
ارائهشده
توسط MASTER
تامین
میکند. همه
دستگاهها
از این
قابلیت
پشتیبانی
نمیکنند.
preferred-master ترجیح نقش MASTER در مذاکره خودکار preferred-slave ترجیح نقش SLAVE در مذاکره خودکار forced-master اجبار PHY به نقش MASTER (قابل استفاده بدون مذاکره خودکار) forced-slave اجبار PHY به نقش SLAVE (قابل استفاده بدون مذاکره خودکار) - mdix auto|on|off
- حالت MDI-X را برای پورت انتخاب میکند. ممکن است برای لغو قابلیت تشخیص خودکار در اکثر آداپتورها استفاده شود. آرگومان auto به معنای تشخیص خودکار وضعیت MDI است، on حالت MDI-X (متقاطع) را اجبار میکند، و off به معنای حالت MDI (مستقیم) است. درایور باید تضمین کند که این دستور بلافاصله اثر بگذارد و در صورت لزوم ممکن است اتصال شبکه (link) را برای اعمال تغییر مجدداً راهاندازی کند.
- autoneg on|off
- مشخص میکند که آیا مذاکره خودکار (autonegotiation) باید فعال باشد یا خیر. مذاکره خودکار به طور پیشفرض فعال است، اما در برخی دستگاههای شبکه ممکن است با آن مشکلاتی وجود داشته باشد، بنابراین در صورت نیاز واقعی میتوانید آن را غیرفعال کنید.
- advertise N
- سرعت و حالت
دوبلکس
تبلیغشده
در مذاکره
خودکار را
تنظیم
میکند. این
آرگومان یک
مقدار
هگزادسیمال
است که از
یک یا
ترکیبی از
مقادیر زیر
استفاده
میکند: Sets the speed and
duplex advertised by autonegotiation. The argument is a hexadecimal value
using one or a combination of the following values:
0x001 10baseT Half 0x002 10baseT Full 0x100000000000000000000000 10baseT1L Full 0x8000000000000000000000000 10baseT1S Full 0x10000000000000000000000000 10baseT1S Half 0x20000000000000000000000000 10baseT1S_P2MP Half 0x40000000000000000000000000 10baseT1BRR Full 0x004 100baseT Half 0x008 100baseT Full 0x80000000000000000 100baseT1 Full 0x40000000000000000000000 100baseFX Half 0x80000000000000000000000 100baseFX Full 0x010 1000baseT Half (not supported by IEEE standards) 0x020 1000baseT Full 0x20000 1000baseKX Full 0x20000000000 1000baseX Full 0x100000000000000000 1000baseT1 Full 0x8000 2500baseX Full (not supported by IEEE standards) 0x800000000000 2500baseT Full 0x1000000000000 5000baseT Full 0x1000 10000baseT Full 0x40000 10000baseKX4 Full 0x80000 10000baseKR Full 0x100000 10000baseR_FEC 0x40000000000 10000baseCR Full (a.k.a 10G_SFI_DA, SFF-8431 Appendix-E) 0x80000000000 10000baseSR Full 0x100000000000 10000baseLR Full 0x200000000000 10000baseLRM Full 0x400000000000 10000baseER Full 0x200000 20000baseMLD2 Full (not supported by IEEE standards) 0x400000 20000baseKR2 Full (not supported by IEEE standards) 0x80000000 25000baseCR Full 0x100000000 25000baseKR Full 0x200000000 25000baseSR Full 0x800000 40000baseKR4 Full 0x1000000 40000baseCR4 Full 0x2000000 40000baseSR4 Full 0x4000000 40000baseLR4 Full 0x400000000 50000baseCR2 Full 0x800000000 50000baseKR2 Full 0x10000000000 50000baseSR2 Full 0x10000000000000 50000baseKR Full 0x20000000000000 50000baseSR Full 0x40000000000000 50000baseCR Full 0x80000000000000 50000baseLR_ER_FR Full 0x100000000000000 50000baseDR Full 0x8000000 56000baseKR4 Full 0x10000000 56000baseCR4 Full 0x20000000 56000baseSR4 Full 0x40000000 56000baseLR4 Full 0x1000000000 100000baseKR4 Full 0x2000000000 100000baseSR4 Full 0x4000000000 100000baseCR4 Full 0x8000000000 100000baseLR4_ER4 Full 0x200000000000000 100000baseKR2 Full 0x400000000000000 100000baseSR2 Full 0x800000000000000 100000baseCR2 Full 0x1000000000000000 100000baseLR2_ER2_FR2 Full 0x2000000000000000 100000baseDR2 Full 0x8000000000000000000 100000baseKR Full 0x10000000000000000000 100000baseSR Full 0x20000000000000000000 100000baseLR_ER_FR Full 0x40000000000000000000 100000baseCR Full 0x80000000000000000000 100000baseDR Full 0x4000000000000000 200000baseKR4 Full 0x8000000000000000 200000baseSR4 Full 0x10000000000000000 200000baseLR4_ER4_FR4 Full 0x20000000000000000 200000baseDR4 Full 0x40000000000000000 200000baseCR4 Full 0x100000000000000000000 200000baseKR2 Full 0x200000000000000000000 200000baseSR2 Full 0x400000000000000000000 200000baseLR2_ER2_FR2 Full 0x800000000000000000000 200000baseDR2 Full 0x1000000000000000000000 200000baseCR2 Full 0x80000000000000000000000000 200000baseCR Full 0x100000000000000000000000000 200000baseKR Full 0x200000000000000000000000000 200000baseDR Full 0x400000000000000000000000000 200000baseDR_2 Full 0x800000000000000000000000000 200000baseSR Full 0x1000000000000000000000000000 200000baseVR Full 0x200000000000000000 400000baseKR8 Full 0x400000000000000000 400000baseSR8 Full 0x800000000000000000 400000baseLR8_ER8_FR8 Full 0x1000000000000000000 400000baseDR8 Full 0x2000000000000000000 400000baseCR8 Full 0x2000000000000000000000 400000baseKR4 Full 0x4000000000000000000000 400000baseSR4 Full 0x8000000000000000000000 400000baseLR4_ER4_FR4 Full 0x10000000000000000000000 400000baseDR4 Full 0x20000000000000000000000 400000baseCR4 Full 0x2000000000000000000000000000 400000baseCR2 Full 0x4000000000000000000000000000 400000baseKR2 Full 0x8000000000000000000000000000 400000baseDR2 Full 0x10000000000000000000000000000 400000baseDR2_2 Full 0x20000000000000000000000000000 400000baseSR2 Full 0x40000000000000000000000000000 400000baseVR2 Full 0x200000000000000000000000 800000baseCR8 Full 0x400000000000000000000000 800000baseKR8 Full 0x800000000000000000000000 800000baseDR8 Full 0x1000000000000000000000000 800000baseDR8_2 Full 0x2000000000000000000000000 800000baseSR8 Full 0x4000000000000000000000000 800000baseVR8 Full 0x80000000000000000000000000000 800000baseCR4 Full 0x100000000000000000000000000000 800000baseKR4 Full 0x200000000000000000000000000000 800000baseDR4 Full 0x400000000000000000000000000000 800000baseDR4_2 Full 0x800000000000000000000000000000 800000baseSR4 Full 0x1000000000000000000000000000000 800000baseVR4 Full 0x2000000000000000000000000000000 1600000baseCR8 Full 0x4000000000000000000000000000000 1600000baseKR8 Full 0x8000000000000000000000000000000 1600000baseDR8 Full 0x10000000000000000000000000000000 1600000baseDR8_2 Full - phyad N
- آدرس PHY.
- xcvr internal|external
- نوع فرستنده-گیرنده (transceiver) را انتخاب میکند. در حال حاضر تنها internal (داخلی) و external (خارجی) قابل تعیین است؛ در آینده ممکن است انواع بیشتری اضافه شوند.
- wol p|u|m|b|a|g|s|f|d...
- گزینههای
روشنشدن
از طریق
شبکه (Wake-on-LAN) را
تنظیم
میکند. همه
دستگاهها
از این
ویژگی
پشتیبانی
نمیکنند.
آرگومان
این گزینه
رشتهای از
نویسههاست
که مشخص
میکند
کدام
گزینهها
فعال شوند.
p روشنشدن با فعالیت PHY u روشنشدن با پیامهای تکپخشی (unicast) m روشنشدن با پیامهای چندپخشی (multicast) b روشنشدن با پیامهای همگانی (broadcast) a روشنشدن با پیامهای ARP g روشنشدن با MagicPacket™ s فعالسازی رمز عبور SecureOn™ برای MagicPacket™ f روشنشدن با فیلترها (filter) d غیرفعالسازی (عدم روشنشدن با هیچ رویدادی). این گزینه تمام گزینههای قبلی را پاک میکند. - sopass xx:yy:zz:aa:bb:cc
- رمز عبور SecureOn™ را تنظیم میکند. آرگومان این گزینه باید ۶ بایت در قالب هگزادسیمال مکآدرس اترنت (xx:yy:zz:aa:bb:cc) باشد.
msglvl N
msglvl type on|off ...
| drv | 0x0001 | وضعیت عمومی درایور |
| probe | 0x0002 | کاوش سختافزار |
| link | 0x0004 | وضعیت پیوند (اتصال) |
| timer | 0x0008 | بررسی دورهای وضعیت |
| ifdown | 0x0010 | در حال غیرفعال شدن رابط |
| ifup | 0x0020 | در حال فعال شدن رابط |
| rx_err | 0x0040 | خطای دریافت |
| tx_err | 0x0080 | خطای ارسال |
| tx_queued | 0x0100 | صفبندی ارسال |
| intr | 0x0200 | مدیریت وقفه (Interrupt) |
| tx_done | 0x0400 | اتمام ارسال |
| rx_status | 0x0800 | تکمیل دریافت |
| pktdata | 0x1000 | محتویات بسته |
| hw | 0x2000 | وضعیت سختافزار |
| wol | 0x4000 | وضعیت Wake-on-LAN |
معانی دقیق این پرچمهای نوع در میان درایورهای مختلف متفاوت است.
- -n -u --show-nfc --show-ntuple
- گزینهها یا قوانین طبقهبندی جریان دریافت شبکه (receive network flow classification) را بازیابی میکند.
- rx-flow-hash tcp4|udp4|ah4|esp4|sctp4|tcp6|udp6|ah6|esp6|sctp6
- گزینههای
درهمسازی
(هش) را برای
نوع جریان
مشخصشده
بازیابی
میکند.
tcp4 TCP over IPv4 udp4 UDP over IPv4 ah4 IPSEC AH over IPv4 esp4 IPSEC ESP over IPv4 sctp4 SCTP over IPv4 tcp6 TCP over IPv6 udp6 UDP over IPv6 ah6 IPSEC AH over IPv6 esp6 IPSEC ESP over IPv6 sctp6 SCTP over IPv6 - rule N
- قانون طبقهبندی RX با شناسه دادهشده را بازیابی میکند.
- -N -U --config-nfc --config-ntuple
- گزینهها یا قوانین طبقهبندی جریان دریافت شبکه را پیکربندی میکند.
- rx-flow-hash tcp4|udp4|ah4|esp4|sctp4|tcp6|udp6|ah6|esp6|sctp6m|v|t|s|d|f|n|r...
- گزینههای
هش را برای
نوع جریان
مشخصشده
پیکربندی
میکند.
m هش بر اساس آدرس مقصد لایه ۲ بسته دریافتی. v هش بر اساس تگ VLAN بسته دریافتی. t هش بر اساس فیلد پروتکل لایه ۳ بسته دریافتی. s هش بر اساس آدرس IP مبدأ بسته دریافتی. d هش بر اساس آدرس IP مقصد بسته دریافتی. f هش بر اساس بایتهای ۰ و ۱ سرآیند لایه ۴ بسته دریافتی. n هش بر اساس بایتهای ۲ و ۳ سرآیند لایه ۴ بسته دریافتی. l هش بر اساس برچسب جریان IPv6 (Flow Label) بسته دریافتی. r دور انداختن تمام بستههای این نوع جریان. هنگامی که این گزینه تنظیم شود، تمام گزینههای دیگر نادیده گرفته میشوند. - flow-type ether|ip4|tcp4|udp4|sctp4|ah4|esp4|ip6|tcp6|udp6|ah6|esp6|sctp6
- یک قانون
طبقهبندی
را برای نوع
جریان
مشخصشده
درج یا
بهروزرسانی
میکند.
ether Ethernet ip4 Raw IPv4 tcp4 TCP over IPv4 udp4 UDP over IPv4 sctp4 SCTP over IPv4 ah4 IPSEC AH over IPv4 esp4 IPSEC ESP over IPv4 ip6 Raw IPv6 tcp6 TCP over IPv6 udp6 UDP over IPv6 sctp6 SCTP over IPv6 ah6 IPSEC AH over IPv6 esp6 IPSEC ESP over IPv6
برای تمام فیلدهایی که امکان تعیین هر دو مقدار و ماسک را فراهم میکنند، ماسک را میتوان بلافاصله پس از مقدار با استفاده از کلمه کلیدی m یا به طور جداگانه با استفاده از کلمه کلیدی نام فیلد همراه با پسوند -mask (مانند src-mask) مشخص کرد.
- src xx:yy:zz:aa:bb:cc [m xx:yy:zz:aa:bb:cc]
- شامل آدرس MAC مبدأ، به صورت ۶ بایت در مبنای شانزده که با دونقطه از هم جدا شدهاند، همراه با یک ماسک اختیاری است. تنها برای flow-type از نوع ether معتبر است.
- dst xx:yy:zz:aa:bb:cc [m xx:yy:zz:aa:bb:cc]
- شامل آدرس MAC مقصد، به صورت ۶ بایت در مبنای شانزده که با دونقطه از هم جدا شدهاند، همراه با یک ماسک اختیاری است. تنها برای flow-type از نوع ether معتبر است.
- proto N\[m N]
- شامل شماره پروتکل اترنت (ethertype) و یک ماسک اختیاری است. تنها برای flow-type از نوع ether معتبر است.
- src-ip ip-address [m ip-address]
- آدرس IP مبدأ بسته ورودی را برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای تمام انواع جریان مبتنی بر IP معتبر است.
- dst-ip ip-address [m ip-address]
- آدرس IP مقصد بسته ورودی را برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای تمام انواع جریان مبتنی بر IP معتبر است.
- tos N\[m N]
- مقدار فیلد نوع سرویس (Type of Service) را در بسته ورودی برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای تمام انواع جریان مبتنی بر IPv4 اعمال میشود.
- tclass N\[m N]
- مقدار فیلد کلاس ترافیک (Traffic Class) را در بسته ورودی برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای تمام انواع جریان مبتنی بر IPv6 اعمال میشود.
- l4proto N\[m N]
- شامل شماره پروتکل لایه ۴ و ماسک اختیاری است. تنها برای انواع جریان ip4 و ip6 معتبر است.
- src-port N\[m N]
- مقدار فیلد پورت مبدأ (مربوط به بستههای TCP/UDP) را در بسته ورودی برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای انواع جریان ip4، tcp4، udp4، sctp4 و معادلهای IPv6 آنها معتبر است.
- dst-port N\[m N]
- مقدار فیلد پورت مقصد (مربوط به بستههای TCP/UDP) را در بسته ورودی برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای انواع جریان ip4، tcp4، udp4، sctp4 و معادلهای IPv6 آنها معتبر است.
- spi N\[m N]
- مقدار فیلد شاخص پارامتر امنیتی (مربوط به بستههای AH/ESP) را در بسته ورودی برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای انواع جریان ip4، ah4، esp4 و معادلهای IPv6 آنها معتبر است.
- l4data N\[m N]
- مقدار ۴ بایت اول لایه ۴ را در بسته ورودی برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای انواع جریان ip4 و ip6 معتبر است.
- vlan-etype N\[m N]
- شامل Ethertype تگ VLAN و یک ماسک اختیاری است.
- vlan N\[m N]
- شامل تگ VLAN و یک ماسک اختیاری است.
- user-def N\[m N]
- شامل ۶۴ بیت داده اختصاصی کاربر و یک ماسک اختیاری است.
- dst-mac xx:yy:zz:aa:bb:cc [m xx:yy:zz:aa:bb:cc]
- شامل آدرس MAC مقصد، مشخصشده به صورت ۶ بایت در مبنای شانزده که با دونقطه از هم جدا شدهاند، همراه با یک ماسک اختیاری است. برای تمام انواع جریان مبتنی بر IP معتبر است.
- action N
- صف Rx را برای
ارسال
بستهها یا
اقدام
دیگری مشخص
میکند.
-1 دور انداختن جریان منطبق (Drop) -2 استفاده از جریان منطبق به عنوان فیلتر Wake-on-LAN 0 or higher صف Rx جهت هدایت جریان - context N
- زمینه RSS را برای توزیع بستهها روی چندین صف مشخص میکند؛ مقدار 0 برای زمینه پیشفرض RSS، یا مقداری که توسط ethtool -X ... context new برگردانده شده است. اگر با action یا queue ترکیب شود، صف Rx مشخصشده به مقدار خواندهشده از جدول هدایت غیرمستقیم RSS اضافه میشود تا صف واقعی Rx برای تحویل بسته به دست آید.
- vf N
- تابع مجازی (Virtual Function) را مشخص میکند که فیلتر روی آن اعمال میشود. با action سازگار نیست.
- queue N
- صف Rx را برای ارسال بستهها مشخص میکند. با action سازگار نیست.
- loc N
- مکان/شناسه را برای درج قانون مشخص میکند. این کار هر قانونی را که در آن مکان وجود داشته باشد بازنویسی کرده و مراحل ترتیببندی قوانین را طی نخواهد کرد.
- delete N
- قانون طبقهبندی RX با شناسه دادهشده را حذف میکند.
- -w --get-dump
- تخلیه میانافزار (firmware dump) را برای دستگاه شبکه مشخصشده دریافت و چاپ میکند. به طور پیشفرض، پرچم تخلیه، نسخه و طول دادههای تخلیه را چاپ میکند. هنگامی که data مشخص شود، ethtool دادههای تخلیه را دریافت کرده و به یک file هدایت میکند.
- -W --set-dump
- پرچم تخلیه میانافزار را برای دستگاه تنظیم میکند.
- -T --show-time-stamping
- قابلیتهای برچسبگذاری زمانی (time stamping) دستگاه و کلاک سختافزاری PTP مرتبط با آن را نمایش میدهد. اگر هیچ index و qualifier ارائه نشود، قابلیتهای برچسبگذاری زمانی فعلی انتخابشده را نمایش میدهد.
- index N
- نمایه ساعت سختافزاری ptp.
- qualifier precise|approx
- توصیفکننده کلاک سختافزاری ptp. به طور عمده "precise" که مقدار پیشفرض است برای کیفیت IEEE 1588 و "approx" برای نقطه DMA کارت شبکه است.
- --get-hwtimestamp-cfg
- پیکربندی کلاک سختافزاری PTP برچسبگذاری زمانی انتخابشده را نمایش میدهد.
- --set-hwtimestamp-cfg
- پیکربندی کلاک سختافزاری PTP برچسبگذاری زمانی دستگاه را تنظیم میکند.
- index N
- نمایه ساعت سختافزاری ptp.
- qualifier precise|approx
- توصیفکننده کلاک سختافزاری ptp. مقدار پیشفرض "precise" برای استاندارد IEEE 1588 و "approx" برای نقطه DMA کارت شبکه است.
- tx TX-TYPE
- نوع برچسبگذاری زمانی TX برای پیکربندی.
- rx-filter RX-FILTER
- نوع فیلتر برچسبگذاری زمانی RX برای پیکربندی.
- -x --show-rxfh-indir --show-rxfh
- جدول هدایت غیرمستقیم هش جریان دریافت (receive flow hash indirection table) و/یا کلید هش RSS را بازیابی میکند.
- -X --set-rxfh-indir --rxfh
- جدول هدایت غیرمستقیم هش جریان دریافت و/یا کلید هش RSS را پیکربندی میکند.
- hkey
- کلید هش RSS دستگاه شبکه مشخصشده را تنظیم میکند. کلید هش RSS باید دارای طولی باشد که دستگاه از آن پشتیبانی میکند. قالب کلید هش باید به صورت xx:yy:zz:aa:bb:cc باشد، یعنی هر دو نیمبایت یک بایت حتی در صورت صفر بودن باید ذکر شوند.
- hfunc
- تابع هش RSS دستگاه شبکه مشخصشده را تنظیم میکند. فهرست توابع هش RSS که هسته لینوکس از آنها پشتیبانی میکند به عنوان بخشی از خروجی دستور --show-rxfh نشان داده میشود.
- xfrm
- تبدیل ورودی RSS را تنظیم میکند. در حال حاضر، تنها تبدیلهای symmetric-xor و symmetric-or-xor پشتیبانی میشوند که در آنها کارت شبکه پیش از ارسال فیلدهای مبدأ و مقصد L3 و/یا L4 (همانطور که توسط --config-nfc rx-flow-hash انتخاب شدهاند) به الگوریتم هش، عملیات XOR یا OR را روی آنها انجام میدهد. در نتیجه تابع هش RSS همان مقدار هش را برای جهت دیگر جریان که در آن فیلدهای مبدأ و مقصد جابجا شدهاند تولید میکند (یعنی RSS متقارن). توجه داشته باشید که این عملیات آنتروپی مجموعه ورودی را کاهش میدهد و الگوریتم هش ممکن است آسیبپذیر شود. خاموش کردن با xfrm none.
- start N
- برای گزینههای equal و weight، صف شروع دریافت را برای توزیع جریانها روی N تنظیم میکند.
- equal N
- جدول هدایت غیرمستقیم هش جریان دریافت را طوری تنظیم میکند که جریانها به طور یکنواخت بین اولین N صف دریافت توزیع شوند.
- weight W0 W1 ...
- جدول هدایت غیرمستقیم هش جریان دریافت را طوری تنظیم میکند که جریانها با توجه به وزنهای ارائهشده بین صفهای دریافت توزیع شوند. مجموع وزنها باید غیرصفر باشد و نباید از اندازه جدول هدایت غیرمستقیم تجاوز کند.
- default
- جدول هدایت غیرمستقیم هش جریان دریافت را به مقدار پیشفرض خود بازمیگرداند.
- context CTX | new
- یک زمینه (context) مربوط به RSS را برای اعمال دستور مشخص میکند؛ مقدار new برای تخصیص یک زمینه جدید RSS، یا CTX، مقداری که توسط دستور قبلی ... context new برگردانده شده است.
- delete
- زمینه RSS مشخصشده را حذف میکند. تنها در ترکیب با context و یک مقدار غیرصفر CTX قابل استفاده است.
- -f --flash
- تصویر میانافزار (firmware image) را در حافظه فلش یا سایر حافظههای پایدار دستگاه مینویسد.
- file
- نام فایل تصویر میانافزار را مشخص میکند. میانافزار ابتدا باید در یکی از پوشههایی که بارگذار میانافزار کرنل یا عامل میانافزار جستجو میکند، مانند /lib/firmware نصب شده باشد.
- N
- اگر دستگاه چندین تصویر میانافزار را در نواحی جداگانه حافظه پایدار ذخیره میکند، این پارامتر میتواند برای مشخص کردن ناحیهای که باید نوشته شود استفاده گردد. پیشفرض برابر با 0 است که درخواست نوشتن تمام نواحی را دارد. تمام مقادیر دیگر به درایور بستگی دارند.
- -l --show-channels
- تعداد کانالهای دستگاه شبکه مشخصشده را استعلام میکند. یک کانال شامل یک IRQ (وقفه) و مجموعهای از صفهاست که میتوانند آن IRQ را تحریک کنند.
- -L --set-channels
- تعداد کانالهای دستگاه شبکه مشخصشده را تغییر میدهد.
- rx N
- تعداد کانالهای دارای صفهای فقط دریافت را تغییر میدهد.
- tx N
- تعداد کانالهای دارای صفهای فقط ارسال را تغییر میدهد.
- other N
- تعداد کانالهایی را که فقط برای مقاصد دیگر استفاده میشوند (مانند وقفههای اتصال یا هماهنگی SR-IOV) تغییر میدهد.
- combined N
- تعداد کانالهای چندمنظوره را تغییر میدهد.
- -m --dump-module-eeprom --module-info
- حافظه EEPROM را از ماژولهای الحاقی مانند SFP+ یا QSFP دریافت و در صورت امکان رمزگشایی میکند. اگر درایور و ماژول از آن پشتیبانی کنند، اطلاعات تشخیصی نوری (optical diagnostic) نیز خوانده شده و رمزگشایی میشود.
هنگامی که هر یک از پارامترهای page، bank یا i2c مشخص شوند، تنها تخلیه یک صفحه منفرد یا بخشی از آن مجاز است. در این حالت، پارامترهای offset و length نسبت به مرزهای صفحه EEPROM در نظر گرفته میشوند.
هنگامی که hex on pages on مشخص شود، تمام صفحات مرتبط EEPROM به صورت هگزادسیمال و سازماندهیشده بر اساس صفحه تخلیه میشوند. قبل از هر صفحه یک سرآیند حاوی شماره صفحه قرار میگیرد. برای صفحات دارای بانک، شماره بانک نیز نمایش داده میشود، و برای ماژولهای SFP، آدرس I2C نیز نشان داده میشود، زیرا بخشهای مختلف نقشه حافظه EEPROM از طریق آدرسهای مختلف I2C در دسترس هستند. مجموعه صفحات تخلیهشده با آنچه چاپگر بهینهساز (pretty-printer) برای هر نوع ماژول میخواند مطابقت دارد. این گزینه را نمیتوان با پارامترهای offset، length، page، bank یا i2c ترکیب کرد. هنگامی که با --json ترکیب شود، خروجی یک شیء JSON با یک آرایه "pages" خواهد بود. هر عنصر شیئی است با فیلدهای "bank"، "page"، "offset"، "i2c_address" و "data" که فارغ از نوع ماژول بدون قید و شرط صادر میشوند. "data" آرایهای از رشتههای هگز با حروف کوچک، یک رشته به ازای هر بایت است؛ طول آن برابر با طول بلوک حافظه است.
- --show-priv-flags
- پرچمهای اختصاصی (private flags) دستگاه شبکه مشخصشده را استعلام میکند. نامها و معانی پرچمهای اختصاصی (در صورت وجود) توسط هر درایور دستگاه شبکه تعریف میشود.
- --set-priv-flags
- پرچمهای اختصاصی دستگاه را همانطور که مشخص شده تنظیم میکند.
flag on|off وضعیت پرچم اختصاصی نامبردهشده را تنظیم میکند.
- --show-eee
- دستگاه شبکه مشخصشده را برای پشتیبانی از اترنت بهینه از نظر مصرف انرژی (EEE مطابق با مشخصات IEEE 802.3az) استعلام میکند.
- --set-eee
- رفتار EEE دستگاه را تنظیم میکند.
- eee on|off
- پشتیبانی دستگاه از EEE را فعال/غیرفعال میکند.
- tx-lpi on|off
- مشخص میکند که آیا دستگاه باید وضعیت Tx LPI خود را فعال (assert) کند یا خیر.
- advertise N
- سرعتهایی را تنظیم میکند که دستگاه باید قابلیتهای EEE را برای آنها تبلیغ کند. مقادیر همانند مقادیر --change advertise است.
- tx-timer N
- میزان زمانی را تعیین میکند که دستگاه باید پیش از اعمال Tx LPI در حالت بیکار (idle) باقی بماند (بر حسب میکروثانیه). این گزینه تنها زمانی معنا دارد که Tx LPI فعال باشد.
- --set-phy-tunable
- پارامترهای قابل تنظیم PHY را پیکربندی میکند.
- downshift on|off
- مشخص
میکند که
آیا کاهش
خودکار
سرعت (downshift)
باید فعال
باشد یا
خیر.
count N تعداد تلاشهای مجدد برای downshift در PHY را تنظیم میکند. - fast-link-down on|off
- مشخص
میکند که
آیا Fast Link Down باید
فعال باشد و
زمان تا قطع
پیوند (در
صورت
پشتیبانی)
را تعیین
میکند.
msecs N مدت زمانی را تعیین میکند که پس از آن قطع پیوند گزارش میشود. توجه داشته باشید که PHY ممکن است نزدیکترین مقدار پشتیبانیشده را انتخاب کند. تنها هنگام خواندن مجدد مقدار تنظیمی، مقدار واقعی به دست میآید. - energy-detect-power-down on|off
- مشخص
میکند که
آیا خاموشی
تشخیص
انرژی (EDPD)
باید فعال
باشد یا خیر
(در صورت
پشتیبانی).
این کار
بلوکهای
مداری RX و TX را
در حالت
کممصرف
قرار
میدهد، و PHY
به طور
دورهای
برای ارسال
پالسهای
اتصال
بیدار
میشود تا
از وضعیت
قفلشدگی
با PHY مقابل
که ممکن است
EDPD روی آن نیز
فعال باشد
جلوگیری
کند. به طور
پیشفرض،
این تنظیم
ارسال
دورهای
پالسهای TX
را نیز فعال
میکند.
msecs N برخی PHYها از پیکربندی بازه زمانی بیدار شدن برای ارسال پالسهای TX پشتیبانی میکنند. این تنظیم امکان کنترل این بازه را فراهم میکند و مقدار 0 در صورت پشتیبانی PHY، پالسهای TX را غیرفعال میسازد. غیرفعال کردن پالسهای TX میتواند وضعیتی از قفلشدگی ایجاد کند که هیچیک از دو PHY دیگری را بیدار نکند. در صورت عدم تعیین، مقدار پیشفرض (بر حسب میلیثانیه) توسط PHY استفاده خواهد شد.
- --get-phy-tunable
- پارامترهای قابل تنظیم PHY را دریافت میکند.
- downshift
- برای کار در محیطهای کابلکشی که با 1000BASE-T ناسازگار هستند، دستگاه PHY یک عملیات کاهش خودکار سرعت اتصال (downshift) را ارائه میدهد. کاهش سرعت اتصال پس از N بار تلاش ناموفق برای مذاکره خودکار 1000BASE-T انجام میشود. ویژگی Downshift در مواردی که کابل فاقد ۴ زوجسیم است مفید واقع میشود.
تعداد تلاش/وضعیت downshift در PHY را دریافت میکند.
- fast-link-down
- بسته به حالت کاری، ممکن است بین ۰.۵ تا ۱ ثانیه طول بکشد تا قطع شدن اتصال گزارش شود. در کاربردهای خاص، رویداد قطع اتصال (link-down) باید در سریعترین زمان ممکن گزارش گردد. برخی PHYها از قابلیت Fast Link Down پشتیبانی میکنند و امکان پیکربندی تاخیر پیش از گزارش قطع اتصال را فراهم میسازند.
وضعیت / مدت زمان Fast Link Down در PHY را دریافت میکند.
- energy-detect-power-down
- تنظیم پیکربندیشده فعلی برای خاموشی تشخیص انرژی (Energy Detect Power Down) را دریافت میکند (در صورت پشتیبانی).
- --get-tunable
- پارامترهای قابل تنظیم درایور را دریافت میکند.
- rx-copybreak
- مقدار فعلی rx copybreak را بر حسب بایت دریافت میکند.
- tx-copybreak
- مقدار فعلی tx copybreak را بر حسب بایت دریافت میکند.
- tx-buf-size
- اندازه بافر فعلی tx copybreak را بر حسب بایت دریافت میکند.
- pfc-prevention-tout
- مقدار مهلت زمانی (تایماوت) پیشگیری از طوفان PFC را بر حسب میلیثانیه دریافت میکند. این مقدار تایماوت هم برای PFC (کنترل جریان اولویتدار) و هم برای طوفانهای توقف سطح اتصال استاندارد (IEEE 802.3x) اعمال میشود. طوفان توقف زمانی رخ میدهد که یک دستگاه دائماً فریمهای توقف TX را به سوئیچ ارسال کند و در نتیجه فشار معکوس مداوم ایجاد شود. در صورت فعال بودن، اگر کارت شبکه تشخیص دهد که وضعیت توقف از تایماوت پیکربندیشده فراتر رفته است، دستگاه اقدام حفاظتی انجام میدهد (ارسال فریمهای توقف را متوقف میکند) تا از توقف کامل ترافیک جلوگیری شود.
- --set-tunable
- پارامترهای قابل تنظیم درایور را تنظیم میکند.
- rx-copybreak N
- مقدار rx copybreak را بر حسب بایت تنظیم میکند.
- tx-copybreak N
- مقدار tx copybreak را بر حسب بایت تنظیم میکند.
- tx-buf-size N
- اندازه بافر tx copybreak را بر حسب بایت تنظیم میکند.
- pfc-prevention-tout N
- تایماوت پیشگیری از طوفان PFC را بر حسب میلیثانیه تنظیم میکند. محدوده مقادیر معتبر به دستگاه بستگی دارد. مقادیر خاص عبارتند از:
- 0
- غیرفعالسازی پیشگیری از طوفان.
- 65535
- استفاده از تایماوت پیشفرض محلی دستگاه (خودکار).
- --reset
- اجزای سختافزاری مشخصشده توسط پرچمها و اجزای فهرستشده در زیر را بازنشانی (ریست) میکند:
- flags N
- اجزا را بر اساس ماسک مستقیم پرچمها ریست میکند.
- mgmt
- پردازنده مدیریتی
- irq
- درخواستکننده وقفه
- dma
- موتور DMA
- filter
- فیلتر کردن / هدایت جریان
- offload
- برونسپاری پروتکل
- mac
- کنترلکننده دسترسی به رسانه (MAC)
- phy
- فرستنده-گیرنده / PHY
- ram
- حافظه RAM مشترک بین چندین جزء ap پردازنده برنامه کاربردی
- dedicated
- تمام اجزای اختصاصیافته به این رابط
- all
- تمام اجزای مورد استفاده توسط این رابط، حتی اگر مشترک باشند
- --show-fec
- دستگاه شبکه مشخصشده را برای پشتیبانی از تصحیح خطای رو به جلو (Forward Error Correction - FEC) استعلام میکند.
- --set-fec
- تصحیح خطای رو به جلو (FEC) را برای دستگاه شبکه مشخصشده پیکربندی میکند.
انتظار میرود حالتهای FEC انتخابشده توسط کاربر پس از هرگونه رویداد اتصال گرم (hotplug) ماندگار باشند. اگر ماژولی تعویض شود که از حالت فعلی FEC پشتیبانی نکند، درایور یا میانافزار باید پیوند را به صورت مدیریتی قطع کند و مشکل را در گزارشهای سیستم ثبت نماید تا کاربران آن را اصلاح کنند.
- encoding auto|off|rs|baser|llrs [...]
- کدگذاری FEC
را برای
دستگاه
تنظیم
میکند.
ترکیبی از
گزینهها
به عنوان
مثال به
صورت encoding auto rs
مشخص
میشود؛
معنای چنین
ترکیبهایی
بین
درایورهای
مختلف
متفاوت است.
auto استفاده از کدگذاری پیشفرض درایور off خاموش کردن FEC RS اجبار به کدگذاری RS-FEC BaseR اجبار به کدگذاری BaseR LLRS اجبار به کدگذاری LLRS-FEC
- -Q|--per-queue
- زیردستور ارائهشده را روی صفهای خاصی اعمال میکند.
- queue_mask %x
- صفهای خاصی را که زیردستور روی آنها اعمال میشود تنظیم میکند. اگر queue_mask تنظیم نشود، زیردستور روی تمام صفها اعمال خواهد شد.
- sub_command
- زیردستور برای اعمال. زیردستورهای پشتیبانیشده شامل --show-coalesce و --coalesce هستند.
- --cable-test
- یک آزمایش کابل انجام داده و نتایج را گزارش میکند. نوع نتایج بازگرداندهشده به قابلیتهای رابط شبکه بستگی دارد. معمولاً زوجهای باز (قطعی) و زوجهای اتصال کوتاه به همراه زوجهای سالم (O.K.) گزارش میشوند. هنگامی که خطایی شناسایی شود، فاصله تقریبی تا محل خطا نیز ممکن است گزارش شود.
- --cable-test-tdr
- یک آزمایش کابل انجام داده و دادههای خام بازتابسنج دامنه زمان (TDR) را گزارش میکند. یک پالس در طول یک زوجسیم کابل ارسال میشود و دامنه بازتاب برای یک فاصله معین گزارش میگردد. قطعی در کابل بازتاب بزرگی ایجاد میکند. آسیب جزئی به کابل بازتاب کوچکی بازمیگرداند. اگر کابل دچار اتصال کوتاه باشد، دامنه بازتاب میتواند منفی باشد. به طور پیشفرض، دادهها برای طولهای بین ۰ تا ۱۵۰ متر در گامهای ۱ متری برای همه زوجسیمها بازگردانده میشوند. با این حال میتوان پارامترهایی را برای محدود کردن جمعآوری دادهها ارسال کرد. باید توجه داشت که رابط شبکه فاصلهها را به هر دقتی که عملاً پیادهسازی شده باشد گرد میکند. این مقدار اغلب ۰.۸ متر است. نتایج باید شامل اولین و آخرین فاصله واقعی گردشده و اندازه گام باشند.
- first N
- فاصله در طول کابل بر حسب متر، جایی که اولین اندازهگیری باید انجام شود.
- last N
- فاصله در طول کابل بر حسب متر، جایی که آخرین اندازهگیری باید انجام شود.
- step N
- فاصله بر حسب متر، بین هر اندازهگیری.
- pair N
- کدام زوجسیم باید اندازهگیری شود. معمولاً یک کابل دارای ۴ زوجسیم است: 0 = Pair A، 1 = Pair B، ...
- --monitor
- به اعلانهای نتلینک (netlink) گوش میدهد و آنها را نمایش میدهد.
- command
- اگر آرگومانی مطابق با یک دستور استفاده شود، ethtool فقط اعلانهای این نوع را نشان میدهد. بدون چنین آرگومانی یا با --all، تمام انواع اعلانها نمایش داده میشوند.
- devname
- اگر از نام یک دستگاه به عنوان آرگومان استفاده شود، تنها اعلانهای مربوط به این دستگاه نمایش داده میشوند. حالت پیشفرض، نمایش اعلانهای همه دستگاهها است.
- --show-tunnels
- قابلیتها و وضعیت دستگاه مربوط به تونلها را نمایش میدهد. پورتهای UDP را که کرنل دستگاه را برای تجزیه به عنوان تونلهای VxLAN یا GENEVE برنامهریزی کرده است، فهرست میکند.
- --show-module
- پارامترهای ماژول فرستنده-گیرنده (transceiver) را نمایش میدهد.
- --set-module
- پارامترهای ماژول فرستنده-گیرنده را تنظیم میکند.
- power-mode-policy high|auto
- سیاست حالت مصرف انرژی را برای ماژول تنظیم میکند. هنگامی که روی high تنظیم شود، ماژول همیشه در حالت توان بالا کار میکند. هنگامی که روی auto تنظیم شود، هنگامی که اولین پورت استفادهکننده از آن از نظر مدیریتی فعال (up) شود، ماژول توسط میزبان به حالت توان بالا منتقل میشود و زمانی که آخرین پورت استفادهکننده از نظر مدیریتی غیرفعال (down) شود، به حالت کممصرف منتقل میگردد. سیاست حالت توان را میتوان پیش از اتصال ماژول نیز تنظیم کرد.
- --get-plca-cfg
- پارامترهای فعلی PLCA را برای رابط دادهشده نمایش میدهد.
- --set-plca-cfg
- تنظیمات PLCA را برای رابط دادهشده تغییر میدهد.
- enable on|off
- عملکرد PLCA را فعال یا غیرفعال میکند. هنگامی که PLCA RS غیرفعال باشد (پیشفرض)، PHY در حالت ساده CSMA/CD کار میکند. برای فعالسازی PLCA، باید یک plca-id منحصربهفرد غیر از 255 به PHY اختصاص داده شود. این مقدار میتواند همزمان با پارامتر enable پیکربندی شود. پارامتر enable با بندهای 30.16.1.1.1 (aPLCAAdminState) و 30.16.1.2.1 (acPLCAAdminControl) از استاندارد IEEE 802.3cg-2019 مطابقت دارد.
- node-id N
- شناسه منحصربهفرد گره در محدوده [0 .. 255]. شناسه گره 0 برای گره هماهنگکننده (coordinator) که سیگنال BEACON را تولید میکند رزرو شده است. در یک شبکه PLCA باید دقیقاً یک هماهنگکننده وجود داشته باشد. تنظیم شناسه گره روی 255 (پیشفرض) گره را غیرفعال میکند. این پارامتر با بند 30.16.1.1.4 (aPLCALocalNodeID) از استاندارد IEEE 802.3cg-2019 مطابقت دارد.
- node-cnt N
- پارامتر node-cnt در محدوده [1 .. 255] باید بر اساس حداکثر تعداد گرههایی که میتوانند به شبکه چندنقطهای متصل شوند تنظیم گردد. این پارامتر حداقل طول چرخه PLCA را تنظیم میکند. بنابراین، تنها برای گره هماهنگکننده (node-id = 0) معنادار است. تنظیم این پارامتر روی یک گره پیرو (follower) هیچ تاثیری ندارد. پارامتر node-cnt با بند 30.16.1.1.3 (aPLCANodeCount) از استاندارد IEEE 802.3cg-2019 مطابقت دارد.
- to-tmr N
- پارامتر تایمر TO مقدار تایمر فرصت ارسال (transmit opportunity timer) را بر حسب bit-time تنظیم میکند و برای عملکرد صحیح PLCA باید در تمام گرههای مشترک در رسانه یکسان تنظیم شود. مقدار پیشفرض 32 برای پوشش پیوندی با طول تقریبی ۵۰ متر کافی است. این پارامتر با بند 30.16.1.1.5 (aPLCATransmitOpportunityTimer) از استاندارد IEEE 802.3cg-2019 مطابقت دارد.
- burst-cnt N
- پارامتر burst-cnt در محدوده [0 .. 255] تعداد بستههای اضافی را مشخص میکند که گره مجاز است در طول یک فرصت ارسال واحد بفرستد. به طور پیشفرض این ویژگی 0 است، به این معنی که گره میتواند در هر TO یک فریم ارسال کند. در صورت بزرگتر بودن از 0، لایه PLCA RS پس از هر ارسال، TO را حفظ کرده و تا سقف burst-tmr بیت-تایم منتظر میماند تا MAC فریم جدیدی ارسال کند. این امر در هر چرخه PLCA تنها تا تعداد دفعات تعیینشده توسط این پارامتر میتواند رخ دهد. پس از آن، ارسال پشت سر هم (burst) به پایان میرسد و شمارش عادی TOها از سر گرفته میشود. این پارامتر با بند 30.16.1.1.6 (aPLCAMaxBurstCount) از استاندارد IEEE 802.3cg-2019 مطابقت دارد.
- burst-tmr N
- پارامتر burst-tmr در محدوده [0 .. 255] تعیین میکند که وقتی burst-cnt بزرگتر از 0 است، PLCA RS چند بیت-تایم برای آغاز ارسال جدید توسط MAC منتظر بماند. اگر MAC در این مدت فریم جدیدی ارسال نکند، حالت burst به پایان رسیده و شمارش TOها از سر گرفته میشود. در غیر این صورت، فریم جدید به عنوان بخشی از burst فعلی ارسال میشود. این پارامتر با بند 30.16.1.1.7 (aPLCABurstTimer) از استاندارد IEEE 802.3cg-2019 مطابقت دارد. مقدار burst-tmr باید بزرگتر از زمان فاصله بین فریمها (IFG) در MAC (به علاوه مقداری حاشیه اطمینان) تنظیم شود تا حالت burst مربوط به PLCA طبق انتظار کار کند.
- --get-plca-status
- وضعیت فعلی PLCA را برای رابط دادهشده نمایش میدهد. اگر on باشد، PHY با موفقیت سیگنال BEACON را دریافت یا تولید میکند. اگر off باشد، عملکرد PLCA موقتاً غیرفعال است و PHY در حالت عادی CSMA/CD کار میکند.
- --show-mm
- وضعیت لایه MAC Merge را نمایش میدهد. آرگومان ethtool به صورت -I --include-statistics میتواند همراه با این دستور استفاده شود، و شمارندههای آماری لایه MAC Merge نیز بازیابی خواهند شد.
- pmac-enabled
- نشان میدهد که آیا pMAC فعال و قادر به دریافت ترافیک و فریمهای SMD-V (و پاسخ به آنها با پاسخهای SMD-R) هست یا خیر.
- tx-enabled
- نشان میدهد که آیا ارسال روی pMAC از نظر مدیریتی فعال است یا خیر.
- tx-active
- نشان میدهد که آیا ارسال روی pMAC فعال است یا خیر (اعتبارسنجی با موفقیت انجام شده یا غیرفعال بوده است).
- tx-min-frag-size
- حداقل اندازه (بر حسب اکتت) قطعات ارسالی غیرپایانی را نشان میدهد که توسط طرف مقابل پیوند قابل دریافت است. با متغیر استاندارد addFragSize با استفاده از فرمول زیر مطابقت دارد:
tx-min-frag-size = 64 * (1 + addFragSize) - 4
- rx-min-frag-size
- حداقل اندازه (بر حسب اکتت) قطعات غیرپایانی را نشان میدهد که دستگاه محلی از دریافت آنها پشتیبانی میکند.
- verify-enabled
- نشان میدهد که آیا ماشین حالت اعتبارسنجی فعال است یا خیر. این فرآیند در صورت موفقیت تضمین میکند فریمهای پیشدستانهای (preemptible) که توسط دستگاه محلی ارسال میشوند، به عنوان فریمهای خطا توسط طرف مقابل پیوند دور انداخته نمیشوند.
- verify-time
- فاصله زمانی بین تلاشهای اعتبارسنجی را بر حسب میلیثانیه به عنوان یک عدد صحیح بین ۱ تا ۱۲۸ میلیثانیه نشان میدهد. استاندارد تعداد ثابتی از تلاشهای اعتبارسنجی (verifyLimit) را پیش از شکست فرآیند اعتبارسنجی تعریف میکند.
- max-verify-time
- حداکثر مقدار verify-time پذیرفتهشده توسط دستگاه محلی را نشان میدهد، که ممکن است کمتر از ۱۲۸ میلیثانیه باشد.
- verify-status
- وضعیت فعلی ماشین حالت اعتبارسنجی دستگاه محلی را نشان میدهد. مقادیر میتوانند شامل INITIAL، VERIFYING، SUCCEEDED، FAILED یا DISABLED باشند.
- --set-mm
- پارامترهای لایه MAC Merge را تنظیم میکند.
- pmac-enabled on|off
- دریافت را برای pMAC فعال میکند.
- tx-enabled on|off
- ارسال را برای pMAC از نظر مدیریتی فعال میکند.
- tx-min-frag-size N
- حداقل اندازه (بر حسب اکتت) قطعات ارسالی غیرپایانی را که توسط طرف مقابل پیوند قابل دریافت است تنظیم میکند.
- verify-enabled on|off
- ماشین حالت اعتبارسنجی را فعال یا غیرفعال میکند.
- verify-time N
- بازه زمانی بین تلاشهای اعتبارسنجی را بر حسب میلیثانیه تنظیم میکند.
- --show-pse
- وضعیت فعلی تجهیزات تامین توان (PSE - Power Sourcing Equipment) را برای رابط دادهشده نمایش میدهد.
- podl-pse-admin-state
- این ویژگی وضعیت عملیاتی توابع PoDL PSE را نشان میدهد که با استفاده از پارامتر podl-pse-admin-control قابل تغییر است. این مقدار با مشخصه 30.15.1.1.2 (aPoDLPSEAdminState) از استاندارد IEEE 802.3-2018 مطابقت دارد و مقادیر احتمالی آن enabled، disabled است.
- podl-pse-power-detection-status
- این ویژگی وضعیت تشخیص توان PoDL PSE را نشان میدهد. این وضعیت به ماشین حالت داخلی PSE و پشتیبانی از طبقهبندی خودکار PD بستگی دارد. با مشخصه 30.15.1.1.3 (aPoDLPSEPowerDetectionStatus) از استاندارد IEEE 802.3-2018 مطابقت دارد و مقادیر احتمالی آن شامل disabled، searching، delivering power، sleep، idle، error است.
- c33-pse-admin-state
- این ویژگی وضعیت عملیاتی توابع c33 PSE را نشان میدهد که با استفاده از پارامتر c33-pse-admin-control قابل تغییر است. با مشخصه 30.9.1.1.2 (aPSEAdminState) از استاندارد IEEE 802.3-2022 مطابقت دارد و مقادیر احتمالی آن enabled، disabled است.
- c33-pse-power-detection-status
- این ویژگی وضعیت تشخیص توان c33 PSE را نشان میدهد. وضعیت به ماشین حالت داخلی PSE و پشتیبانی از طبقهبندی خودکار PD بستگی دارد. با مشخصه 30.9.1.1.5 (aPSEPowerDetectionStatus) از استاندارد IEEE 802.3-2022 مطابقت دارد و مقادیر احتمالی آن عبارتند از disabled، searching، delivering power، test، fault، other fault
- c33-pse-extended-state
- این ویژگی وضعیت توسعهیافته (Extended state) مربوط به c33 PSE را نشان میدهد. وضعیت توسعهیافته در پیوند با زیروضعیت توسعهیافته c33 PSE به کاربر اجازه میدهد جزئیات بیشتری درباره وضعیت خطای فعلی c33 PSE به دست آورد. این ویژگی با متغیرهای بخش 33.2.4.4 از استاندارد IEEE 802.3-2022 مطابقت دارد.
- c33-pse-extended-substate
- این ویژگی زیروضعیت توسعهیافته c33 PSE را نشان میدهد. در پیوند با مقدار وضعیت توسعهیافته c33 PSE، امکان دستیابی به جزئیات بیشتر در مورد وضعیت خطای فعلی c33 PSE را فراهم میکند.
- c33-pse-power-class
- این ویژگی کلاس توان c33 PSE را مشخص میکند. به کلاس مذاکرهشده بین PSE و PD بستگی دارد و با مشخصه 30.9.1.1.8 (aPSEPowerClassification) از استاندارد IEEE 802.3-2022 مطابقت دارد.
- c33-pse-actual-power
- این ویژگی توان واقعی مصرفشده توسط c33 PSE را مشخص میکند. با مشخصه 30.9.1.1.23 (aPSEActualPower) از استاندارد IEEE 802.3-2022 مطابقت دارد. توان واقعی بر حسب میلیوات (mW) گزارش میشود.
- c33-pse-available-power-limit
- این ویژگی حد توان پیکربندیشده c33 PSE را بر حسب میلیوات (mW) مشخص میکند.
- c33-pse-power-limit-ranges
- این ویژگی محدودههای مجاز حد توان را بر حسب میلیوات جهت پیکربندی پارامتر c33-pse-avail-pw-limit مشخص میکند. سطوح توان معتبری را که میتوان بر اساس استاندارد c33 به c33 PSE اختصاص داد، تعریف مینماید.
- power-domain-index
- نمایه دامنه توان PSE را که پورت به آن تعلق دارد گزارش میکند. هر پورت دقیقاً به یک دامنه توان تعلق دارد. اولویتهای پورت درون همان دامنه توان تعریف میشوند.
هر دامنه توان ممکن است علاوه بر بودجه کل سیستم (مثلاً ۲۰۰ وات در کل)، بودجه حداکثری مخصوص به خود را داشته باشد (مثلاً ۱۰۰ وات در هر دامنه). محدودیتهای دامنه ابتدا اعمال میشوند: اگر یک دامنه منفرد به بودجه خود برسد، تنها پورتهای همان دامنه تحت تأثیر قرار میگیرند. بودجه سراسری سیستم در تمام دامنهها اعمال میشود.
- priority-max
- حداکثر مقدار اولویت پورت قابل پیکربندی را درون دامنه توان گزارششده نشان میدهد. محدوده معتبر برای prio از 0 تا priority-max (شامل خود آن) است.
- priority
- اولویت پورت پیکربندیشده فعلی را درون دامنه توان گزارششده نشان میدهد. مقادیر عددی کمتر نشاندهنده اولویت بالاتر هستند: 0 بالاترین اولویت است.
- --set-pse
- پارامترهای تجهیزات تامین توان (PSE) را تنظیم میکند.
- podl-pse-admin-control enable|disable
- این پارامتر عملیات مدیریتی PoDL PSE را مطابق با مشخصات IEEE 802.3-2018 30.15.1.2.1 (acPoDLPSEAdminControl) مدیریت میکند.
- c33-pse-admin-control enable|disable
- این پارامتر عملیات مدیریتی c33 PSE را مطابق با مشخصات IEEE 802.3-2022 30.9.1.2.1 (acPSEAdminControl) مدیریت میکند.
- c33-pse-avail-pw-limit N
- این پارامتر حد توان در دسترس c33 PSE را بر حسب میلیوات، مطابق با متغیرهای مشخصه IEEE 802.3-2022 33.2.4.4 (pse_available_power) مدیریت میکند.
- prio N
- اولویت پورت را محدود به دامنه توان پورت (همانطور که توسط power-domain-index گزارش شده) تنظیم میکند. مقادیر کمتر نشاندهنده اولویت بالاتر هستند؛ 0 بالاترین اولویت است. محدوده معتبر از 0 تا priority-max گزارششده توسط --show-pse است.
هنگامی که یک دامنه منفرد از بودجه خود فراتر رود، برق پورتهای آن دامنه بر اساس اولویت وصل یا قطع میشود (بالاترین اولویت ابتدا روشن میشود؛ پایینترین اولویت ابتدا قطع میگردد).
- --show-mse
- اطلاعات تشخیصی میانگین مربعات خطا (MSE) مربوط به PHY را نمایش میدهد.
معیارها از مدل تشخیصی PHY اتحادیه OPEN Alliance (مورد استفاده در PHYهای خودرویی و صنعتی) پیروی میکنند. مقیاسگذاری عددی، پنجرههای نمونهبرداری و فواصل بهروزرسانی مختص سازنده هستند و توسط بلوک قابلیتها گزارش میشوند.
مقادیر، نماهای خام (اسنپشات) از DSP مربوط به PHY هستند. مقادیر کمتر به طور کلی نشاندهنده کیفیت بهتر سیگنال هستند؛ 0 ایدهآل است. مقادیر را باید نسبت به مقیاسهای max-* گزارششده برای این PHY و حالت اتصال تفسیر کرد.
مجموعه کانالهای بازگرداندهشده به پشتیبانی PHY بستگی دارد. هنگامی که دادههای هر کانال در دسترس باشد، دستههای Channel A/B/C/D بازگردانده میشوند. در غیر این صورت، کرنل ممکن است یک اسنپشات تجمیعی منفرد WORST یا LINK را بازگرداند.
- قابلیتها (Capabilities)
- مقیاس و زمانبندی ارائهشده توسط درایور:
- max-average-mse
- مقیاس برای مقادیر میانگین MSE.
- max-peak-mse
- مقیاس برای مقادیر اوج (پیک) MSE. تنها در صورتی وجود دارد که PHY مقادیر peak-mse و/یا worst-peak-mse را گزارش کند.
- refresh-rate-ps
- بازه زمانی معمول بهروزرسانی سختافزاری بر حسب پیکوثانیه.
- symbols-per-sample
- تعداد نمادهای جمعآوریشده در هر نمونه سختافزاری.
- نماها (Snapshots)
- یک دسته به ازای هر انتخابکننده (Channel A/B/C/D، WORST، یا LINK). هر کدام شامل معیارهای پشتیبانیشده توسط PHY است: average-mse و در صورت وجود peak-mse و/یا worst-peak-mse. مقادیر خام هستند و باید با استفاده از مقیاسهای قابلیت فوق تفسیر شوند.
پنجرههای زمانی کوتاه (refresh-rate-ps پایین یا symbols-per-sample اندک) میتوانند واریانس بالایی ایجاد کنند؛ فضای کاربری میتواند با نظرسنجی و میانگینگیری در طول زمان پایداری را بهبود بخشد.
- --flash-module-firmware
- میانافزار ماژول فرستنده-گیرنده را فلش میکند. فرآیند بهروزرسانی میانافزار از سه مرحله منطقی تشکیل شده است: بارگیری تصویر میانافزار در ماژول فرستنده-گیرنده، اجرای تصویر، و ثبت نهایی (commit) تصویر تا در هنگام بازنشانی اجرا شود. با صدور دستور flash، فرآیند بهروزرسانی میانافزار به طور کامل و به همین ترتیب انجام میشود.
- file FILE
- نام فایل تصویر میانافزار ماژول فرستنده-گیرنده را مشخص میکند. میانافزار ابتدا باید در یکی از پوشههایی که بارگذار میانافزار کرنل یا عامل میانافزار در آن جستجو میکند، مانند /lib/firmware نصب شده باشد. تصویر میانافزار در ماژول فرستنده-گیرنده بارگیری، اعتبارسنجی، اجرا و ثبت نهایی میشود.
- pass PASS
- رمز عبور اختیاری ماژول فرستنده-گیرنده که ممکن است به عنوان بخشی از فرآیند بهروزرسانی میانافزار ماژول مورد نیاز باشد.
- --show-phys
- دستگاههای PHY متصل به یک رابط و نحوه پیوند آنها به یکدیگر را نمایش میدهد.
- phy_index
- نمایه PHY که آن را در رابط شبکه مشخص میکند. اگر رابط دارای چندین PHY باشد، هر کدام یک نمایه منحصربهفرد در آن رابط خواهند داشت. این نمایه سپس میتواند برای دستوراتی که PHYها را هدف قرار میدهند استفاده شود.
- drvname
- نام درایور متصل به این دستگاه PHY.
- name
- نام دستگاه PHY، مطابق با نام موجود در sysfs.
- downstream_sfp_name
- اگر PHY یک محفظه SFP را راهاندازی کند، این فیلد شامل نام گذرگاه SFP مرتبط است.
- upstream_type mac | phy
- ماهیت دستگاهی را که PHY به آن متصل است نشان میدهد.
- upstream_index
- اگر upstream_type مربوط به PHY برابر با phy باشد، این فیلد phy_index مربوط به phy بالادستی را نشان میدهد.
- upstream_sfp_name
- اگر PHY درون یک ماژول SFP/SFF باشد، این فیلد شامل نام گذرگاه SFP بالادستی است.
اشکالات (BUGS)
روی تمام درایورهای شبکه (به طور جزئی یا کلی) پشتیبانی نمیشود.
نویسنده (AUTHOR)
دستور ethtool توسط David Miller نوشته شده است.
تغییرات توسط: Jeff Garzik، Tim Hockin، Jakub Jelinek، Andre Majorel، Eli Kupermann، Scott Feldman، Andi Kleen، Alexander Duyck، Sucheta Chakraborty، Jesse Brandeburg، Ben Hutchings، Scott Branden.
در دسترس بودن (AVAILABILITY)
دستور ethtool از نشانی زیر در دسترس است: https://www.kernel.org/pub/software/network/ethtool
| Jul 2026 | Ethtool version 7.1 |