.\" -*- nroff -*-
.\" Copyright 1999 by David S. Miller. All Rights Reserved.
.\" Portions Copyright 2001 Sun Microsystems
.\" Portions Copyright 2007, 2009 Free Software Foundation, Inc.
.\" This file may be copied under the terms of the GNU Public License.
.\"
.\" There must be no text lines before .TH. Use '.' for vertical spacing.
.\"
.\" .An - list of n alternative values as in "flav vanilla|strawberry"
.\"
.de A1
\\fB\\$1\\fP|\\fB\\$2\\fP
..
.de A2
\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP
..
.de A3
\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP|\\fB\\$4\\fP
..
.de A4
\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP|\\fB\\$4\\fP|\\fB\\$5\\fP
..
.\"
.\" .Bn - same as above but framed by square brackets
.\"
.de B1
[\\fB\\$1\\fP|\\fB\\$2\\fP]
..
.de B2
[\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP]
..
.de B3
[\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP|\\fB\\$4\\fP]
..
.de B4
[\\fB\\$1\\fP\ \\fB\\$2\\fP|\\fB\\$3\\fP|\\fB\\$4\\fP|\\fB\\$5\\fP]
..
.\"
.\" .BN - value with a numeric input as in "[value N]"
.\"
.de BN
[\\fB\\$1\\fP\ \\fIN\\fP]
..
.\"
.\" .BM - same as above but has a mask field for format "[value N [m N]]"
.\"
.de BM
[\\fB\\$1\\fP\ \\fIN\\fP\ [\\fBm\\fP\ \\fIN\\fP]]
..
.\"
.\" \(*MA - mac address
.\"
.ds MA \fIxx\fP\fB:\fP\fIyy\fP\fB:\fP\fIzz\fP\fB:\fP\fIaa\fP\fB:\fP\fIbb\fP\fB:\fP\fIcc\fP
.\"
.\" \(*MS - master-slave property
.\"
.ds MS \fBpreferred-master\fP|\fBpreferred-slave\fP|\fBforced-master\fP|\fBforced-slave\fP
.\"
.\" \(*PA - IP address
.\"
.ds PA \fIip-address\fP
.\"
.\" \(*WO - wol flags
.\"
.ds WO \fBp\fP|\fBu\fP|\fBm\fP|\fBb\fP|\fBa\fP|\fBg\fP|\fBs\fP|\fBf|\fBd\fP...
.\"
.\" \(*FL - flow type values
.\"
.ds FL \fBtcp4\fP|\fBudp4\fP|\fBah4\fP|\fBesp4\fP|\fBsctp4\fP|\fBtcp6\fP|\fBudp6\fP|\fBah6\fP|\fBesp6\fP|\fBsctp6\fP
.\"
.\" \(*HO - hash options
.\"
.ds HO \fBm\fP|\fBv\fP|\fBt\fP|\fBs\fP|\fBd\fP|\fBf\fP|\fBn\fP|\fBr\fP...
.\"
.\" \(*SD - Self-diag test values
.\"
.ds SD \fBoffline\fP|\fBonline\fP|\fBexternal_lb\fP
.\"
.\" \(*NC - Network Classifier type values
.\"
.ds NC \fBether\fP|\fBip4\fP|\fBtcp4\fP|\fBudp4\fP|\fBsctp4\fP|\fBah4\fP|\fBesp4\fP|\fBip6\fP|\fBtcp6\fP|\fBudp6\fP|\fBah6\fP|\fBesp6\fP|\fBsctp6\fP
.
.\"
.\" Start URL.
.de UR
. ds m1 \\$1\"
. nh
. if \\n(mH \{\
. \" Start diversion in a new environment.
. do ev URL-div
. do di URL-div
. \}
..
.\" End URL.
.de UE
. ie \\n(mH \{\
. br
. di
. ev
.
. \" Has there been one or more input lines for the link text?
. ie \\n(dn \{\
. do HTML-NS ""
. \" Yes, strip off final newline of diversion and emit it.
. do chop URL-div
. do URL-div
\c
. do HTML-NS
. \}
. el \
. do HTML-NS "\\*(m1"
\&\\$*\"
. \}
. el \
\\*(la\\*(m1\\*(ra\\$*\"
.
. hy \\n(HY
..
.
.TH ETHTOOL 8 "Jul 2026" "Ethtool version 7.1" "دستورات مدیریت سیستم"
.SH "نام (NAME)"
ethtool \- استعلام یا کنترل درایور شبکه و تنظیمات سختافزاری
.
.SH "خلاصه دستور (SYNOPSIS)"
.\" Do not adjust lines (i.e. left justification) and do not hyphenate.
.na
.nh
.HP
.B ethtool
.I devname
.HP
.B ethtool \-h|\-\-help
.HP
.B ethtool \-\-version
.HP
.B ethtool
.BN --debug
.I args
.HP
.B ethtool [--disable-netlink]
.I args
.HP
.B ethtool [--json]
.I args
.HP
.B ethtool [-I | --include-statistics]
.I args
.HP
.B ethtool
.BN --phy
.I args
.HP
.B ethtool \-\-monitor
[
.I command
] [
.I devname
]
.HP
.B ethtool \-a|\-\-show\-pause
.I devname
.HP
.B ethtool \-A|\-\-pause
.I devname
.B2 autoneg on off
.B2 rx on off
.B2 tx on off
.HP
.B ethtool \-c|\-\-show\-coalesce
.I devname
.HP
.B ethtool \-C|\-\-coalesce
.I devname
.B2 adaptive\-rx on off
.B2 adaptive\-tx on off
.BN rx\-usecs
.BN rx\-frames
.BN rx\-usecs\-irq
.BN rx\-frames\-irq
.BN tx\-usecs
.BN tx\-frames
.BN tx\-usecs\-irq
.BN tx\-frames\-irq
.BN stats\-block\-usecs
.BN pkt\-rate\-low
.BN rx\-usecs\-low
.BN rx\-frames\-low
.BN tx\-usecs\-low
.BN tx\-frames\-low
.BN pkt\-rate\-high
.BN rx\-usecs\-high
.BN rx\-frames\-high
.BN tx\-usecs\-high
.BN tx\-frames\-high
.BN sample\-interval
.B2 cqe\-mode\-rx on off
.B2 cqe\-mode\-tx on off
.BN tx\-aggr\-max\-bytes
.BN tx\-aggr\-max\-frames
.BN tx\-aggr\-time\-usecs
.BN rx\-cqe\-frames
.BN rx\-cqe\-nsecs
.HP
.B ethtool \-g|\-\-show\-ring
.I devname
.HP
.B ethtool \-G|\-\-set\-ring
.I devname
.BN rx
.BN rx\-mini
.BN rx\-jumbo
.BN tx
.BN rx\-buf\-len
.B3 tcp\-data\-split auto on off
.BN hds\-thresh
.BN cqe\-size
.BN tx\-push
.BN rx\-push
.BN tx\-push\-buf\-len
.HP
.B ethtool \-i|\-\-driver
.I devname
.HP
.B ethtool \-d|\-\-register\-dump
.I devname
.B2 raw on off
.B2 hex on off
.RB [ file
.IR name ]
.HP
.B ethtool \-e|\-\-eeprom\-dump
.I devname
.B2 raw on off
.BN offset
.BN length
.HP
.B ethtool \-E|\-\-change\-eeprom
.I devname
.BN magic
.BN offset
.BN length
.BN value
.HP
.B ethtool \-k|\-\-show\-features|\-\-show\-offload
.I devname
.HP
.B ethtool \-K|\-\-features|\-\-offload
.I devname feature
.A1 on off
.RB ...
.HP
.B ethtool \-p|\-\-identify
.I devname
.RI [ N ]
.HP
.B ethtool \-P|\-\-show\-permaddr
.I devname
.HP
.B ethtool \-r|\-\-negotiate
.I devname
.HP
.B ethtool \-S|\-\-statistics
.I devname
.RB [\fB\-\-all\-groups\fP|\fB\-\-groups
.RB [\fBeth\-phy\fP]
.RB [\fBeth\-mac\fP]
.RB [\fBeth\-ctrl\fP]
.RB [\fBrmon\fP]
.RB ]
.HP
.B ethtool \-\-phy\-statistics
.I devname
.HP
.B ethtool \-t|\-\-test
.I devname
.RI [\*(SD]
.HP
.B ethtool \-s
.I devname
.BN speed
.BN lanes
.B2 duplex half full
.B4 port tp aui bnc mii fibre da
.B3 mdix auto on off
.B2 autoneg on off
.RB [ advertise \ \fIN\fP[\fB/\fP\fIM\fP]
|
.BI advertise \ mode
.A1 on off
.RB ...]
.BN phyad
.B2 xcvr internal external
.RB [ wol \ \fIN\fP[\fB/\fP\fIM\fP]
.RB | \ wol \ \*(WO]
.RB [ sopass \ \*(MA]
.RB [ master-slave \ \*(MS]
.RB [ msglvl
.IR N\fP[/\fIM\fP] \ |
.BI msglvl \ type
.A1 on off
.RB ...]
.HP
.B ethtool \-n|\-u|\-\-show\-nfc|\-\-show\-ntuple
.I devname
.RB [\ rx\-flow\-hash \ \*(FL \ |
.br
.BI rule \ N
.RB ]
.HP
.B ethtool \-N|\-U|\-\-config\-nfc|\-\-config\-ntuple
.I devname
.BR rx\-flow\-hash \ \*(FL \ \: \*(HO \ |
.br
.B flow\-type \*(NC
.RB [ src \ \*(MA\ [ m \ \*(MA]]
.RB [ dst \ \*(MA\ [ m \ \*(MA]]
.BM proto
.RB [ src\-ip \ \*(PA\ [ m \ \*(PA]]
.RB [ dst\-ip \ \*(PA\ [ m \ \*(PA]]
.BM tos
.BM tclass
.BM l4proto
.BM src\-port
.BM dst\-port
.BM spi
.BM l4data
.BM vlan\-etype
.BM vlan
.BM user\-def
.RB [ dst-mac \ \*(MA\ [ m \ \*(MA]]
.BN action
.BN context
.BN loc
.RB |
.br
.BI delete \ N
.HP
.B ethtool \-w|\-\-get\-dump
.I devname
.RB [ data
.IR filename ]
.HP
.B ethtool\ \-W|\-\-set\-dump
.I devname N
.HP
.B ethtool \-T|\-\-show\-time\-stamping
.I devname
.RB [ index
.IR N
.BI qualifier
.IR precise|approx ]
.HP
.B ethtool \-\-get\-hwtimestamp\-cfg
.I devname
.HP
.B ethtool \-\-set\-hwtimestamp\-cfg
.I devname
.RB [ index
.IR N
.BI qualifier
.IR precise|approx ]
.RB [ tx
.IR TX-TYPE ]
.RB [ rx-filter
.IR RX-FILTER ]
.HP
.B ethtool \-x|\-\-show\-rxfh\-indir|\-\-show\-rxfh
.I devname
.HP
.B ethtool \-X|\-\-set\-rxfh\-indir|\-\-rxfh
.I devname
.RB [ hkey \ \*(MA:\...]
.RB [ start
.IR N ]
.RB [\ equal
.IR N \ |
.BI weight\ W0
.IR W1
.RB ...\ | \ default \ ]
.RB [ hfunc
.IR FUNC ]
.B3 xfrm symmetric-xor symmetric-or-xor none
.RB [ context
.I CTX
.RB |\ new ]
.RB [ delete ]
.HP
.B ethtool \-f|\-\-flash
.I devname file
.RI [ N ]
.HP
.B ethtool \-l|\-\-show\-channels
.I devname
.HP
.B ethtool \-L|\-\-set\-channels
.I devname
.BN rx
.BN tx
.BN other
.BN combined
.HP
.B ethtool \-m|\-\-dump\-module\-eeprom|\-\-module\-info
.I devname
.B2 raw on off
.B2 hex on off
.B2 pages on off
.BN offset
.BN length
.BN page
.BN bank
.BN i2c
.HP
.B ethtool \-\-show\-priv\-flags
.I devname
.HP
.B ethtool \-\-set\-priv\-flags
.I devname flag
.A1 on off
.RB ...
.HP
.B ethtool \-\-show\-eee
.I devname
.HP
.B ethtool \-\-set\-eee
.I devname
.B2 eee on off
.B2 tx-lpi on off
.BN tx-timer
.BN advertise
.HP
.B ethtool \-\-set\-phy\-tunable
.I devname
.RB [
.B downshift
.A1 on off
.BN count
.RB ]
.RB [
.B fast\-link\-down
.A1 on off
.BN msecs
.RB ]
.RB [
.B energy\-detect\-power\-down
.A1 on off
.BN msecs
.RB ]
.HP
.B ethtool \-\-get\-phy\-tunable
.I devname
.RB [ downshift ]
.RB [ fast-link-down ]
.RB [ energy-detect-power-down ]
.HP
.B ethtool \-\-get\-tunable
.I devname
.RB [ rx-copybreak ]
.RB [ tx-copybreak ]
.RB [ tx-buf-size ]
.RB [ pfc-prevention-tout ]
.HP
.B ethtool \-\-set\-tunable
.I devname
.BN rx\-copybreak
.BN tx\-copybreak
.BN tx\-buf\-size
.BN pfc\-prevention\-tout
.HP
.B ethtool \-\-reset
.I devname
.BN flags
.RB [ mgmt ]
.RB [ mgmt-shared ]
.RB [ irq ]
.RB [ irq-shared ]
.RB [ dma ]
.RB [ dma-shared ]
.RB [ filter ]
.RB [ filter-shared ]
.RB [ offload ]
.RB [ offload-shared ]
.RB [ mac ]
.RB [ mac-shared ]
.RB [ phy ]
.RB [ phy-shared ]
.RB [ ram ]
.RB [ ram-shared ]
.RB [ ap ]
.RB [ ap-shared ]
.RB [ dedicated ]
.RB [ all ]
.HP
.B ethtool \-\-show\-fec
.I devname
.HP
.B ethtool \-\-set\-fec
.I devname
.B encoding
.BR auto | off | rs | baser | llrs \ [...]
.HP
.B ethtool \-Q|\-\-per\-queue
.I devname
.RB [ queue_mask
.IR %x ]
.I sub_command
.RB ...
.HP
.B ethtool \-\-cable\-test
.I devname
.HP
.B ethtool \-\-cable\-test\-tdr
.I devname
.BN first N
.BN last N
.BN step N
.BN pair N
.HP
.B ethtool \-\-show\-tunnels
.I devname
.HP
.B ethtool \-\-show\-module
.I devname
.HP
.B ethtool \-\-set\-module
.I devname
.RB [ power\-mode\-policy
.BR high | auto ]
.HP
.B ethtool \-\-get\-plca\-cfg
.I devname
.HP
.B ethtool \-\-set\-plca\-cfg
.I devname
.RB [ enable
.BR on | off ]
.BN node\-id N
.BN node\-cnt N
.BN to\-tmr N
.BN burst\-cnt N
.BN burst\-tmr N
.HP
.B ethtool \-\-get\-plca\-status
.I devname
.HP
.B ethtool \-\-show\-mm
.I devname
.HP
.B ethtool \-\-set\-mm
.I devname
.RB [ verify\-enabled
.BR on | off ]
.RB [ verify\-time
.BR N ]
.RB [ tx\-enabled
.BR on | off ]
.RB [ pmac\-enabled
.BR on | off ]
.RB [ tx\-min\-frag\-size
.BR N ]
.HP
.B ethtool \-\-show\-pse
.I devname
.HP
.B ethtool \-\-set\-pse
.I devname
.RB [ podl\-pse\-admin\-control
.BR enable | disable ]
.RB [ c33\-pse\-admin\-control
.BR enable | disable ]
.BN c33\-pse\-avail\-pw\-limit N
.BN prio N
.HP
.B ethtool \-\-flash\-module\-firmware
.I devname
.BI file
.IR FILE
.RB [ pass
.IR PASS ]
.HP
.B ethtool \-\-show\-phys
.I devname
.
.\" Adjust lines (i.e. full justification) and hyphenate.
.ad
.hy
.SH "توضیحات (DESCRIPTION)"
دستور
.B ethtool
برای استعلام و کنترل درایور دستگاه شبکه و تنظیمات سختافزاری، بهویژه برای دستگاههای اترنت کابلی استفاده میشود.
.PP
.I devname
نام دستگاه شبکهای است که
.B ethtool
باید روی آن عملیات انجام دهد.
.SH "گزینهها (OPTIONS)"
دستور
.B ethtool
با یک آرگومان تنها که نام دستگاه را مشخص میکند، تنظیمات فعلی دستگاه مشخصشده را نمایش میدهد.
.TP
.B \-h \-\-help
یک پیام راهنمای کوتاه را نمایش میدهد.
.TP
.B \-\-version
شماره نسخه ethtool را نمایش میدهد.
.TP
.BI \-\-debug \ N
پیامهای اشکالزدایی را فعال میکند. آرگومان به عنوان یک ماسک تفسیر میشود:
.TS
nokeep;
lB l.
0x01 اطلاعات تجزیهکننده (Parser)
0x02 خلاصه پیامهای نتلینک (netlink)
0x04 تخلیه هگزادسیمال پیامهای نتلینک ارسالی
0x08 تخلیه هگزادسیمال پیامهای نتلینک دریافتی
0x10 ساختار پیامهای نتلینک
.TE
.TP
.BI \-\-disable-netlink
از نتلینک استفاده نکند و در صورت امکان به رابط ioctl بازگردد.
.TP
.BI \-\-json
نتایج را در قالب JSON (نشانهگذاری شیء جاوااسکریپت) خروجی میدهد. تنها زیرمجموعهای از گزینهها از این ویژگی پشتیبانی میکنند. گزینههایی که پشتیبانی نمیکنند، با وجود این گزینه همچنان متن ساده خروجی خواهند داد.
.TP
.B \-I \-\-include\-statistics
آمار مربوط به دستور را در خروجی لحاظ میکند. این گزینه امکان نمایش آمار مرتبط با دستگاه را برای دستورات دریافت (get) منتخب فراهم میسازد.
.TP
.BI \-\-phy \ N
یک PHY را درون رابط هدف قرار میدهد. نمایه PHY را میتوان با
.B \-\-show\-phys
به دست آورد. نمایه PHY برابر با 0، دستگاه phy را هدف قرار میدهد که مستقیماً به MAC اترنت متصل است (در صورت وجود).
دستورات زیر میتوانند یک نمایه PHY را بپذیرند:
.TS
nokeep;
lB l.
\-\-cable\-test
\-\-cable\-test\-tdr
\-\-get\-plca\-cfg
\-\-set\-plca\-cfg
\-\-get\-plca\-status
\-\-show-pse
\-\-set-pse
\-\-show-mse
.TE
.TP
.B \-a \-\-show\-pause
اطلاعات پارامتر توقف (pause) را از دستگاه اترنت مشخصشده استعلام میکند.
.RS 4
.TP
.A3 \fB\-\-src \fBaggregate\fP \fBemac\fP \fBpmac\fP
اگر لایه MAC Merge پشتیبانی شود، یک منبع مشخص از آمار دستگاه را درخواست میکند (eMAC یا pMAC، یا تجمیع آنها). تنها زمانی معتبر است که ethtool با آرگومان
.B \-I \-\-include\-statistics
فراخوانی شده باشد.
.RE
.TP
.B \-A \-\-pause
پارامترهای توقف (pause) دستگاه اترنت مشخصشده را تغییر میدهد.
.RS 4
.TP
.A2 autoneg on off
مشخص میکند که آیا مذاکره خودکار توقف (pause autonegotiation) باید فعال باشد یا خیر.
.TP
.A2 rx on off
مشخص میکند که آیا توقف RX باید فعال باشد یا خیر.
.TP
.A2 tx on off
مشخص میکند که آیا توقف TX باید فعال باشد یا خیر.
.RE
.TP
.B \-c \-\-show\-coalesce
دستگاه شبکه مشخصشده را برای اطلاعات ادغام وقفهها (coalescing) استعلام میکند.
.TP
.B \-C \-\-coalesce
تنظیمات ادغام وقفهها (coalescing) دستگاه شبکه مشخصشده را تغییر میدهد.
.TP
.B \-g \-\-show\-ring
دستگاه شبکه مشخصشده را برای اطلاعات پارامترهای حلقه (ring) ارسال/دریافت استعلام میکند.
.TP
.B \-G \-\-set\-ring
پارامترهای حلقه ارسال/دریافت دستگاه شبکه مشخصشده را تغییر میدهد.
.RS 4
.TP
.BI rx \ N
تعداد ورودیهای حلقه را برای حلقه Rx تغییر میدهد.
.TP
.BI rx\-mini \ N
تعداد ورودیهای حلقه را برای حلقه Rx Mini تغییر میدهد.
.TP
.BI rx\-jumbo \ N
تعداد ورودیهای حلقه را برای حلقه Rx Jumbo تغییر میدهد.
.TP
.BI tx \ N
تعداد ورودیهای حلقه را برای حلقه Tx تغییر میدهد.
.TP
.BI rx\-buf\-len \ N
اندازه بافر در حلقه Rx را تغییر میدهد.
.TP
.BI tcp\-data\-split \ auto|on|off
وضعیت تفکیک دادههای TCP را مشخص میکند.
.TP
.BI hds\-thresh \ N
مقدار آستانه تفکیک دادههای TCP را مشخص میکند.
.TP
.BI cqe\-size \ N
اندازه رویداد صف تکمیل (completion queue event) را تغییر میدهد.
.TP
.BI tx\-push \ on|off
مشخص میکند که آیا TX push باید فعال باشد یا خیر.
.TP
.BI rx\-push \ on|off
مشخص میکند که آیا RX push باید فعال باشد یا خیر.
.TP
.BI tx\-push\-buf\-len \ N
حداکثر تعداد بایتهای یک بسته ارسالی را مشخص میکند که درایور میتواند مستقیماً به دستگاه زیربنایی ارسال (push) کند.
.RE
.TP
.B \-i \-\-driver
اطلاعات درایور مرتبط را از دستگاه شبکه مشخصشده استعلام میکند.
.TP
.B \-d \-\-register\-dump
تخلیه ثباتها (register dump) را برای دستگاه شبکه مشخصشده دریافت و چاپ میکند. قالب ثبات برای برخی دستگاهها شناختهشده و رمزگشاییشده است و برای برخی دیگر به صورت هگزادسیمال چاپ میشود. هنگامی که
.I raw
فعال باشد، ethtool دادههای خام ثبات را به خروجی استاندارد (stdout) میفرستد. اگر
.I file
مشخص شود، به جای خواندن از دستگاه، از محتویات تخلیه خام ثبات قبلی استفاده میکند.
.TP
.B \-e \-\-eeprom\-dump
تخلیه حافظه EEPROM را برای دستگاه شبکه مشخصشده دریافت و چاپ میکند. هنگامی که raw فعال باشد، دادههای خام EEPROM را در stdout چاپ میکند. پارامترهای length و offset امکان تخلیه بخشهای خاصی از EEPROM را فراهم میکنند. حالت پیشفرض، تخلیه کل EEPROM است.
.RS 4
.TP
.BI raw \ on|off
.TP
.BI offset \ N
.TP
.BI length \ N
.RE
.TP
.B \-E \-\-change\-eeprom
اگر value مشخص شده باشد، بایت EEPROM را برای دستگاه شبکه مشخصشده تغییر میدهد. پارامترهای offset و value مشخص میکنند کدام بایت و مقدار جدید آن چیست. اگر value مشخص نشده باشد، ورودی استاندارد (stdin) خوانده شده و در EEPROM نوشته میشود. پارامترهای length و offset امکان نوشتن در بخشهای خاصی از EEPROM را فراهم میکنند. به دلیل ماهیت ماندگار نوشتن در EEPROM، یک کلید جادویی (magic key) مخصوص دستگاه باید تعیین شود تا از نوشتن تصادفی در EEPROM جلوگیری به عمل آید.
.TP
.B \-k \-\-show\-features \-\-show\-offload
دستگاه شبکه مشخصشده را برای وضعیت برونسپاری پروتکل (offload) و سایر ویژگیها استعلام میکند.
.TP
.B \-K \-\-features \-\-offload
پارامترهای برونسپاری و سایر ویژگیهای دستگاه شبکه مشخصشده را تغییر میدهد. نام ویژگیهای زیر توکار هستند و سایر موارد ممکن است توسط کرنل تعریف شوند.
.RS 4
.TP
.A2 rx on off
مشخص میکند که آیا محاسبه مجموع مقابلهای RX (RX checksumming) باید فعال باشد یا خیر.
.TP
.A2 tx on off
مشخص میکند که آیا محاسبه مجموع مقابلهای TX (TX checksumming) باید فعال باشد یا خیر.
.TP
.A2 sg on off
مشخص میکند که آیا پراکندگی-گردآوری (scatter-gather) باید فعال باشد یا خیر.
.TP
.A2 tso on off
مشخص میکند که آیا برونسپاری قطعهبندی TCP (TCP segmentation offload) باید فعال باشد یا خیر.
.TP
.A2 ufo on off
مشخص میکند که آیا برونسپاری قطعهبندی UDP (UDP fragmentation offload) باید فعال باشد یا خیر.
.TP
.A2 gso on off
مشخص میکند که آیا برونسپاری قطعهبندی عمومی (generic segmentation offload) باید فعال باشد یا خیر.
.TP
.A2 gro on off
مشخص میکند که آیا برونسپاری دریافت عمومی (generic receive offload) باید فعال باشد یا خیر.
.TP
.A2 lro on off
مشخص میکند که آیا برونسپاری دریافت بزرگ (large receive offload) باید فعال باشد یا خیر.
.TP
.A2 rxvlan on off
مشخص میکند که آیا شتابدهی RX VLAN باید فعال باشد یا خیر.
.TP
.A2 txvlan on off
مشخص میکند که آیا شتابدهی TX VLAN باید فعال باشد یا خیر.
.TP
.A2 ntuple on off
مشخص میکند که آیا فیلترها و اقدامات Rx ntuple باید فعال باشند یا خیر.
.TP
.A2 rxhash on off
مشخص میکند که آیا برونسپاری هش دریافت (receive hashing offload) باید فعال باشد یا خیر.
.RE
.TP
.B \-p \-\-identify
اقدام مخصوص آداپتور را برای کمک به اپراتور جهت شناسایی بصری آسان آداپتور آغاز میکند. معمولاً این کار شامل چشمکزدن یک یا چند چراغ LED روی پورت شبکه مشخصشده است.
.RS 4
.TP
.BN
مدت زمان اجرای شناسایی فیزیکی (phys-id) به ثانیه.
.RE
.TP
.B \-P \-\-show\-permaddr
دستگاه شبکه مشخصشده را برای آدرس سختافزاری دائمی (MAC) استعلام میکند.
.TP
.B \-r \-\-negotiate
مذاکره خودکار را روی دستگاه اترنت مشخصشده بازنشانی میکند، در صورتی که مذاکره خودکار فعال باشد.
.TP
.B \-S \-\-statistics
دستگاه شبکه مشخصشده را برای آمار استاندارد (IEEE، IETF و غیره) یا آمار مختص درایور و کارت شبکه (NIC) استعلام میکند. هنگامی که هیچ گروهی از آمار مشخص نشود، آمار مختص NIC و درایور درخواست میشود.
.PP
آمار مختص NIC و درایور از آمار استاندارد مستقل هستند؛ دستگاهها ممکن است هر کدام، هر دو یا هیچیک را پیادهسازی کنند. اشتراک نامگذاری آمار مختص NIC و درایور در بین سازندگان مختلف بسیار اندک است.
.RS 4
.TP
.B \fB\-\-all\-groups
.TP
.B \fB\-\-groups [\fBeth\-phy\fP] [\fBeth\-mac\fP] [\fBeth\-ctrl\fP] [\fBrmon\fP]
درخواست گروههایی از آمار استاندارد دستگاه.
.TP
.A3 \fB\-\-src \fBaggregate\fP \fBemac\fP \fBpmac\fP
اگر لایه MAC Merge پشتیبانی شود، یک منبع مشخص از آمار دستگاه را درخواست میکند (eMAC یا pMAC، یا تجمیع آنها).
.RE
.TP
.B \-\-phy\-statistics
دستگاه شبکه مشخصشده را برای آمار مختص PHY استعلام میکند.
.TP
.B \-t \-\-test
خودآزمایی آداپتور را روی دستگاه شبکه مشخصشده اجرا میکند. حالتهای ممکن برای آزمون عبارتند از:
.RS 4
.TP
.B offline
اجرای مجموعه کامل آزمونها، که احتمالاً عملکرد عادی را در طول آزمایش متوقف میکند،
.TP
.B online
اجرای مجموعه محدودی از آزمونها، بدون ایجاد اختلال در عملکرد عادی،
.TP
.B external_lb
اجرای مجموعه کامل آزمونها همانند \fBoffline\fR، به علاوه آزمایش حلقه خارجی (external-loopback).
.RE
.TP
.B \-s \-\-change
امکان تغییر برخی یا همه تنظیمات دستگاه شبکه مشخصشده را فراهم میکند. تمام گزینههای زیر تنها زمانی اعمال میشوند که
.B \-s
مشخص شده باشد.
.RS 4
.TP
.BI speed \ N
تنظیم سرعت بر حسب مگابیت بر ثانیه (Mb/s). اجرای
.B ethtool
تنها با نام دستگاه به عنوان آرگومان، سرعتهای پشتیبانیشده توسط دستگاه را به شما نشان خواهد داد.
.TP
.BI lanes \ N
تنظیم تعداد مسیرها (lanes).
.TP
.A2 duplex half full
حالت دوطرفه همزمان (full) یا غیرهمزمان (half) را تنظیم میکند.
.TP
.A4 port tp aui bnc mii fibre da
پورت دستگاه را انتخاب میکند.
.TP
.BR master-slave \ \*(MS
نقش MASTER/SLAVE مربوط به PHY را پیکربندی میکند. هنگامی که PHY به عنوان MASTER پیکربندی شود، تابع ارسال PMA کلاک TX_TCLK را از یک منبع کلاک محلی تامین میکند. هنگامی که به عنوان SLAVE پیکربندی شود، تابع ارسال PMA کلاک TX_TCLK را از کلاک بازیابیشده از جریان داده ارائهشده توسط MASTER تامین میکند. همه دستگاهها از این قابلیت پشتیبانی نمیکنند.
.TS
nokeep;
lB l.
preferred-master ترجیح نقش MASTER در مذاکره خودکار
preferred-slave ترجیح نقش SLAVE در مذاکره خودکار
forced-master اجبار PHY به نقش MASTER (قابل استفاده بدون مذاکره خودکار)
forced-slave اجبار PHY به نقش SLAVE (قابل استفاده بدون مذاکره خودکار)
.TE
.TP
.A3 mdix auto on off
حالت MDI-X را برای پورت انتخاب میکند. ممکن است برای لغو قابلیت تشخیص خودکار در اکثر آداپتورها استفاده شود. آرگومان \fBauto\fR به معنای تشخیص خودکار وضعیت MDI است، \fBon\fR حالت MDI-X (متقاطع) را اجبار میکند، و \fBoff\fR به معنای حالت MDI (مستقیم) است. درایور باید تضمین کند که این دستور بلافاصله اثر بگذارد و در صورت لزوم ممکن است اتصال شبکه (link) را برای اعمال تغییر مجدداً راهاندازی کند.
.TP
.A2 autoneg on off
مشخص میکند که آیا مذاکره خودکار (autonegotiation) باید فعال باشد یا خیر. مذاکره خودکار به طور پیشفرض فعال است، اما در برخی دستگاههای شبکه ممکن است با آن مشکلاتی وجود داشته باشد، بنابراین در صورت نیاز واقعی میتوانید آن را غیرفعال کنید.
.TP
.BI 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:
.TS
nokeep;
lB l lB.
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
.TE
.TP
.BI phyad \ N
آدرس PHY.
.TP
.A2 xcvr internal external
نوع فرستنده-گیرنده (transceiver) را انتخاب میکند. در حال حاضر تنها internal (داخلی) و external (خارجی) قابل تعیین است؛ در آینده ممکن است انواع بیشتری اضافه شوند.
.TP
.BR wol \ \*(WO
گزینههای روشنشدن از طریق شبکه (Wake-on-LAN) را تنظیم میکند. همه دستگاهها از این ویژگی پشتیبانی نمیکنند. آرگومان این گزینه رشتهای از نویسههاست که مشخص میکند کدام گزینهها فعال شوند.
.TS
nokeep;
lB l.
p روشنشدن با فعالیت PHY
u روشنشدن با پیامهای تکپخشی (unicast)
m روشنشدن با پیامهای چندپخشی (multicast)
b روشنشدن با پیامهای همگانی (broadcast)
a روشنشدن با پیامهای ARP
g روشنشدن با MagicPacket\[tm]
s فعالسازی رمز عبور SecureOn\[tm] برای MagicPacket\[tm]
f روشنشدن با فیلترها (filter)
d T{
غیرفعالسازی (عدم روشنشدن با هیچ رویدادی). این گزینه تمام گزینههای قبلی را پاک میکند.
T}
.TE
.TP
.B sopass \*(MA
رمز عبور SecureOn\[tm] را تنظیم میکند. آرگومان این گزینه باید ۶ بایت در قالب هگزادسیمال مکآدرس اترنت (\*(MA) باشد.
.PP
.BI msglvl \ N
.br
.BI msglvl \ type
.A1 on off
.RB ...
.RS
پرچمهای نوع پیام درایور را با نام یا شماره تنظیم میکند. \fItype\fR نام نوع پیامی است که فعال یا غیرفعال میشود؛ \fIN\fR پرچمهای جدید را به صورت عددی مشخص میکند. نامها و شمارههای نوع تعریفشده عبارتند از:
.TS
nokeep;
lB l l.
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
.TE
.PP
معانی دقیق این پرچمهای نوع در میان درایورهای مختلف متفاوت است.
.RE
.PD
.RE
.TP
.B \-n \-u \-\-show\-nfc \-\-show\-ntuple
گزینهها یا قوانین طبقهبندی جریان دریافت شبکه (receive network flow classification) را بازیابی میکند.
.RS 4
.TP
.BR rx\-flow\-hash \ \*(FL
گزینههای درهمسازی (هش) را برای نوع جریان مشخصشده بازیابی میکند.
.TS
nokeep;
lB l.
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
.TE
.TP
.BI rule \ N
قانون طبقهبندی RX با شناسه دادهشده را بازیابی میکند.
.RE
.PD
.RE
.TP
.B \-N \-U \-\-config\-nfc \-\-config\-ntuple
گزینهها یا قوانین طبقهبندی جریان دریافت شبکه را پیکربندی میکند.
.RS 4
.TP
.BR rx\-flow\-hash \ \*(FL \: \*(HO
گزینههای هش را برای نوع جریان مشخصشده پیکربندی میکند.
.TS
nokeep;
lB l.
m هش بر اساس آدرس مقصد لایه ۲ بسته دریافتی.
v هش بر اساس تگ VLAN بسته دریافتی.
t هش بر اساس فیلد پروتکل لایه ۳ بسته دریافتی.
s هش بر اساس آدرس IP مبدأ بسته دریافتی.
d هش بر اساس آدرس IP مقصد بسته دریافتی.
f هش بر اساس بایتهای ۰ و ۱ سرآیند لایه ۴ بسته دریافتی.
n هش بر اساس بایتهای ۲ و ۳ سرآیند لایه ۴ بسته دریافتی.
l هش بر اساس برچسب جریان IPv6 (Flow Label) بسته دریافتی.
r T{
دور انداختن تمام بستههای این نوع جریان. هنگامی که این گزینه تنظیم شود، تمام گزینههای دیگر نادیده گرفته میشوند.
T}
.TE
.TP
.B flow\-type \*(NC
یک قانون طبقهبندی را برای نوع جریان مشخصشده درج یا بهروزرسانی میکند.
.TS
nokeep;
lB l.
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
.TE
.PP
برای تمام فیلدهایی که امکان تعیین هر دو مقدار و ماسک را فراهم میکنند، ماسک را میتوان بلافاصله پس از مقدار با استفاده از کلمه کلیدی \fBm\fR یا به طور جداگانه با استفاده از کلمه کلیدی نام فیلد همراه با پسوند \fB-mask\fR (مانند \fBsrc-mask\fR) مشخص کرد.
.PD
.TP
.BR src \ \*(MA\ [ m \ \*(MA]
شامل آدرس MAC مبدأ، به صورت ۶ بایت در مبنای شانزده که با دونقطه از هم جدا شدهاند، همراه با یک ماسک اختیاری است. تنها برای flow-type از نوع ether معتبر است.
.TP
.BR dst \ \*(MA\ [ m \ \*(MA]
شامل آدرس MAC مقصد، به صورت ۶ بایت در مبنای شانزده که با دونقطه از هم جدا شدهاند، همراه با یک ماسک اختیاری است. تنها برای flow-type از نوع ether معتبر است.
.TP
.BI proto \ N \\fR\ [\\fPm \ N \\fR]\\fP
شامل شماره پروتکل اترنت (ethertype) و یک ماسک اختیاری است. تنها برای flow-type از نوع ether معتبر است.
.TP
.BR src\-ip \ \*(PA\ [ m \ \*(PA]
آدرس IP مبدأ بسته ورودی را برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای تمام انواع جریان مبتنی بر IP معتبر است.
.TP
.BR dst\-ip \ \*(PA\ [ m \ \*(PA]
آدرس IP مقصد بسته ورودی را برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای تمام انواع جریان مبتنی بر IP معتبر است.
.TP
.BI tos \ N \\fR\ [\\fPm \ N \\fR]\\fP
مقدار فیلد نوع سرویس (Type of Service) را در بسته ورودی برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای تمام انواع جریان مبتنی بر IPv4 اعمال میشود.
.TP
.BI tclass \ N \\fR\ [\\fPm \ N \\fR]\\fP
مقدار فیلد کلاس ترافیک (Traffic Class) را در بسته ورودی برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای تمام انواع جریان مبتنی بر IPv6 اعمال میشود.
.TP
.BI l4proto \ N \\fR\ [\\fPm \ N \\fR]\\fP
شامل شماره پروتکل لایه ۴ و ماسک اختیاری است. تنها برای انواع جریان ip4 و ip6 معتبر است.
.TP
.BI src\-port \ N \\fR\ [\\fPm \ N \\fR]\\fP
مقدار فیلد پورت مبدأ (مربوط به بستههای TCP/UDP) را در بسته ورودی برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای انواع جریان ip4، tcp4، udp4، sctp4 و معادلهای IPv6 آنها معتبر است.
.TP
.BI dst\-port \ N \\fR\ [\\fPm \ N \\fR]\\fP
مقدار فیلد پورت مقصد (مربوط به بستههای TCP/UDP) را در بسته ورودی برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای انواع جریان ip4، tcp4، udp4، sctp4 و معادلهای IPv6 آنها معتبر است.
.TP
.BI spi \ N \\fR\ [\\fPm \ N \\fR]\\fP
مقدار فیلد شاخص پارامتر امنیتی (مربوط به بستههای AH/ESP) را در بسته ورودی برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای انواع جریان ip4، ah4، esp4 و معادلهای IPv6 آنها معتبر است.
.TP
.BI l4data \ N \\fR\ [\\fPm \ N \\fR]\\fP
مقدار ۴ بایت اول لایه ۴ را در بسته ورودی برای تطبیق همراه با یک ماسک اختیاری مشخص میکند. برای انواع جریان ip4 و ip6 معتبر است.
.TP
.BI vlan\-etype \ N \\fR\ [\\fPm \ N \\fR]\\fP
شامل Ethertype تگ VLAN و یک ماسک اختیاری است.
.TP
.BI vlan \ N \\fR\ [\\fPm \ N \\fR]\\fP
شامل تگ VLAN و یک ماسک اختیاری است.
.TP
.BI user\-def \ N \\fR\ [\\fPm \ N \\fR]\\fP
شامل ۶۴ بیت داده اختصاصی کاربر و یک ماسک اختیاری است.
.TP
.BR dst-mac \ \*(MA\ [ m \ \*(MA]
شامل آدرس MAC مقصد، مشخصشده به صورت ۶ بایت در مبنای شانزده که با دونقطه از هم جدا شدهاند، همراه با یک ماسک اختیاری است. برای تمام انواع جریان مبتنی بر IP معتبر است.
.TP
.BI action \ N
صف Rx را برای ارسال بستهها یا اقدام دیگری مشخص میکند.
.TS
nokeep;
lB l.
-1 دور انداختن جریان منطبق (Drop)
-2 استفاده از جریان منطبق به عنوان فیلتر Wake-on-LAN
0 or higher صف Rx جهت هدایت جریان
.TE
.TP
.BI context \ N
زمینه RSS را برای توزیع بستهها روی چندین صف مشخص میکند؛ مقدار
.B 0
برای زمینه پیشفرض RSS، یا مقداری که توسط
.BI ethtool\ -X\ ... \ context
.BR new
برگردانده شده است. اگر با
.BR action \ یا \ queue
ترکیب شود، صف Rx مشخصشده به مقدار خواندهشده از جدول هدایت غیرمستقیم RSS اضافه میشود تا صف واقعی Rx برای تحویل بسته به دست آید.
.TP
.BI vf \ N
تابع مجازی (Virtual Function) را مشخص میکند که فیلتر روی آن اعمال میشود. با action سازگار نیست.
.TP
.BI queue \ N
صف Rx را برای ارسال بستهها مشخص میکند. با action سازگار نیست.
.TP
.BI loc \ N
مکان/شناسه را برای درج قانون مشخص میکند. این کار هر قانونی را که در آن مکان وجود داشته باشد بازنویسی کرده و مراحل ترتیببندی قوانین را طی نخواهد کرد.
.TP
.BI delete \ N
قانون طبقهبندی RX با شناسه دادهشده را حذف میکند.
.RE
.TP
.B \-w \-\-get\-dump
تخلیه میانافزار (firmware dump) را برای دستگاه شبکه مشخصشده دریافت و چاپ میکند. به طور پیشفرض، پرچم تخلیه، نسخه و طول دادههای تخلیه را چاپ میکند. هنگامی که
.I data
مشخص شود، ethtool دادههای تخلیه را دریافت کرده و به یک
.I file
هدایت میکند.
.TP
.B \-W \-\-set\-dump
پرچم تخلیه میانافزار را برای دستگاه تنظیم میکند.
.TP
.B \-T \-\-show\-time\-stamping
قابلیتهای برچسبگذاری زمانی (time stamping) دستگاه و کلاک سختافزاری PTP مرتبط با آن را نمایش میدهد. اگر هیچ
.B index
و
.B qualifier
ارائه نشود، قابلیتهای برچسبگذاری زمانی فعلی انتخابشده را نمایش میدهد.
.RS 4
.TP
.BI index \ N
نمایه ساعت سختافزاری ptp.
.TP
.BI qualifier \ precise | approx
توصیفکننده کلاک سختافزاری ptp. به طور عمده "precise" که مقدار پیشفرض است برای کیفیت IEEE 1588 و "approx" برای نقطه DMA کارت شبکه است.
.RE
.TP
.B \-\-get\-hwtimestamp\-cfg
پیکربندی کلاک سختافزاری PTP برچسبگذاری زمانی انتخابشده را نمایش میدهد.
.TP
.B \-\-set\-hwtimestamp\-cfg
پیکربندی کلاک سختافزاری PTP برچسبگذاری زمانی دستگاه را تنظیم میکند.
.RS 4
.TP
.BI index \ N
نمایه ساعت سختافزاری ptp.
.TP
.BI qualifier \ precise | approx
توصیفکننده کلاک سختافزاری ptp. مقدار پیشفرض "precise" برای استاندارد IEEE 1588 و "approx" برای نقطه DMA کارت شبکه است.
.TP
.BI tx \ TX-TYPE
نوع برچسبگذاری زمانی TX برای پیکربندی.
.TP
.BI rx-filter \ RX-FILTER
نوع فیلتر برچسبگذاری زمانی RX برای پیکربندی.
.RE
.TP
.B \-x \-\-show\-rxfh\-indir \-\-show\-rxfh
جدول هدایت غیرمستقیم هش جریان دریافت (receive flow hash indirection table) و/یا کلید هش RSS را بازیابی میکند.
.TP
.B \-X \-\-set\-rxfh\-indir \-\-rxfh
جدول هدایت غیرمستقیم هش جریان دریافت و/یا کلید هش RSS را پیکربندی میکند.
.RS 4
.TP
.BI hkey
کلید هش RSS دستگاه شبکه مشخصشده را تنظیم میکند. کلید هش RSS باید دارای طولی باشد که دستگاه از آن پشتیبانی میکند. قالب کلید هش باید به صورت xx:yy:zz:aa:bb:cc باشد، یعنی هر دو نیمبایت یک بایت حتی در صورت صفر بودن باید ذکر شوند.
.TP
.BI hfunc
تابع هش RSS دستگاه شبکه مشخصشده را تنظیم میکند. فهرست توابع هش RSS که هسته لینوکس از آنها پشتیبانی میکند به عنوان بخشی از خروجی دستور \-\-show\-rxfh نشان داده میشود.
.TP
.BI xfrm
تبدیل ورودی RSS را تنظیم میکند. در حال حاضر، تنها تبدیلهای
.B symmetric-xor و symmetric-or-xor
پشتیبانی میشوند که در آنها کارت شبکه پیش از ارسال فیلدهای مبدأ و مقصد L3 و/یا L4 (همانطور که توسط
.B \-\-config\-nfc rx\-flow\-hash
انتخاب شدهاند) به الگوریتم هش، عملیات XOR یا OR را روی آنها انجام میدهد. در نتیجه تابع هش RSS همان مقدار هش را برای جهت دیگر جریان که در آن فیلدهای مبدأ و مقصد جابجا شدهاند تولید میکند (یعنی RSS متقارن). توجه داشته باشید که این عملیات آنتروپی مجموعه ورودی را کاهش میدهد و الگوریتم هش ممکن است آسیبپذیر شود. خاموش کردن با
.B xfrm none.
.TP
.BI start\ N
برای گزینههای \fBequal\fR و \fBweight\fR، صف شروع دریافت را برای توزیع جریانها روی \fIN\fR تنظیم میکند.
.TP
.BI equal\ N
جدول هدایت غیرمستقیم هش جریان دریافت را طوری تنظیم میکند که جریانها به طور یکنواخت بین اولین \fIN\fR صف دریافت توزیع شوند.
.TP
\fBweight\fR \fIW0 W1\fR ...
جدول هدایت غیرمستقیم هش جریان دریافت را طوری تنظیم میکند که جریانها با توجه به وزنهای ارائهشده بین صفهای دریافت توزیع شوند. مجموع وزنها باید غیرصفر باشد و نباید از اندازه جدول هدایت غیرمستقیم تجاوز کند.
.TP
.BI default
جدول هدایت غیرمستقیم هش جریان دریافت را به مقدار پیشفرض خود بازمیگرداند.
.TP
\fBcontext \fICTX\fR | \fBnew\fR
یک زمینه (context) مربوط به RSS را برای اعمال دستور مشخص میکند؛ مقدار
.B new
برای تخصیص یک زمینه جدید RSS، یا
.IR CTX ،
مقداری که توسط دستور قبلی
.IB ... \ context
.BR new
برگردانده شده است.
.TP
.B delete
زمینه RSS مشخصشده را حذف میکند. تنها در ترکیب با
.B context
و یک مقدار غیرصفر
.I CTX
قابل استفاده است.
.RE
.TP
.B \-f \-\-flash
تصویر میانافزار (firmware image) را در حافظه فلش یا سایر حافظههای پایدار دستگاه مینویسد.
.RS 4
.TP
.I file
نام فایل تصویر میانافزار را مشخص میکند. میانافزار ابتدا باید در یکی از پوشههایی که بارگذار میانافزار کرنل یا عامل میانافزار جستجو میکند، مانند /lib/firmware نصب شده باشد.
.TP
.I N
اگر دستگاه چندین تصویر میانافزار را در نواحی جداگانه حافظه پایدار ذخیره میکند، این پارامتر میتواند برای مشخص کردن ناحیهای که باید نوشته شود استفاده گردد. پیشفرض برابر با 0 است که درخواست نوشتن تمام نواحی را دارد. تمام مقادیر دیگر به درایور بستگی دارند.
.RE
.PD
.TP
.B \-l \-\-show\-channels
تعداد کانالهای دستگاه شبکه مشخصشده را استعلام میکند. یک کانال شامل یک IRQ (وقفه) و مجموعهای از صفهاست که میتوانند آن IRQ را تحریک کنند.
.TP
.B \-L \-\-set\-channels
تعداد کانالهای دستگاه شبکه مشخصشده را تغییر میدهد.
.RS 4
.TP
.BI rx \ N
تعداد کانالهای دارای صفهای فقط دریافت را تغییر میدهد.
.TP
.BI tx \ N
تعداد کانالهای دارای صفهای فقط ارسال را تغییر میدهد.
.TP
.BI other \ N
تعداد کانالهایی را که فقط برای مقاصد دیگر استفاده میشوند (مانند وقفههای اتصال یا هماهنگی SR-IOV) تغییر میدهد.
.TP
.BI combined \ N
تعداد کانالهای چندمنظوره را تغییر میدهد.
.RE
.TP
.B \-m \-\-dump\-module\-eeprom \-\-module\-info
حافظه EEPROM را از ماژولهای الحاقی مانند SFP+ یا QSFP دریافت و در صورت امکان رمزگشایی میکند. اگر درایور و ماژول از آن پشتیبانی کنند، اطلاعات تشخیصی نوری (optical diagnostic) نیز خوانده شده و رمزگشایی میشود.
.PP
هنگامی که هر یک از پارامترهای
.I page،
.I bank
یا
.I i2c
مشخص شوند، تنها تخلیه یک صفحه منفرد یا بخشی از آن مجاز است. در این حالت، پارامترهای
.I offset
و
.I length
نسبت به مرزهای صفحه EEPROM در نظر گرفته میشوند.
.PP
هنگامی که
.B hex on pages on
مشخص شود، تمام صفحات مرتبط EEPROM به صورت هگزادسیمال و سازماندهیشده بر اساس صفحه تخلیه میشوند. قبل از هر صفحه یک سرآیند حاوی شماره صفحه قرار میگیرد. برای صفحات دارای بانک، شماره بانک نیز نمایش داده میشود، و برای ماژولهای SFP، آدرس I2C نیز نشان داده میشود، زیرا بخشهای مختلف نقشه حافظه EEPROM از طریق آدرسهای مختلف I2C در دسترس هستند. مجموعه صفحات تخلیهشده با آنچه چاپگر بهینهساز (pretty-printer) برای هر نوع ماژول میخواند مطابقت دارد. این گزینه را نمیتوان با پارامترهای
.I offset، length، page، bank
یا
.I i2c
ترکیب کرد. هنگامی که با
.BI \-\-json
ترکیب شود، خروجی یک شیء JSON با یک آرایه "pages" خواهد بود. هر عنصر شیئی است با فیلدهای "bank"، "page"، "offset"، "i2c_address" و "data" که فارغ از نوع ماژول بدون قید و شرط صادر میشوند. "data" آرایهای از رشتههای هگز با حروف کوچک، یک رشته به ازای هر بایت است؛ طول آن برابر با طول بلوک حافظه است.
.TP
.B \-\-show\-priv\-flags
پرچمهای اختصاصی (private flags) دستگاه شبکه مشخصشده را استعلام میکند. نامها و معانی پرچمهای اختصاصی (در صورت وجود) توسط هر درایور دستگاه شبکه تعریف میشود.
.TP
.B \-\-set\-priv\-flags
پرچمهای اختصاصی دستگاه را همانطور که مشخص شده تنظیم میکند.
.RS 4
.PP
.I flag
.A1 on off
وضعیت پرچم اختصاصی نامبردهشده را تنظیم میکند.
.RE
.TP
.B \-\-show\-eee
دستگاه شبکه مشخصشده را برای پشتیبانی از اترنت بهینه از نظر مصرف انرژی (EEE مطابق با مشخصات IEEE 802.3az) استعلام میکند.
.TP
.B \-\-set\-eee
رفتار EEE دستگاه را تنظیم میکند.
.RS 4
.TP
.A2 eee on off
پشتیبانی دستگاه از EEE را فعال/غیرفعال میکند.
.TP
.A2 tx-lpi on off
مشخص میکند که آیا دستگاه باید وضعیت Tx LPI خود را فعال (assert) کند یا خیر.
.TP
.BI advertise \ N
سرعتهایی را تنظیم میکند که دستگاه باید قابلیتهای EEE را برای آنها تبلیغ کند. مقادیر همانند مقادیر
.B \-\-change advertise
است.
.TP
.BI tx-timer \ N
میزان زمانی را تعیین میکند که دستگاه باید پیش از اعمال Tx LPI در حالت بیکار (idle) باقی بماند (بر حسب میکروثانیه). این گزینه تنها زمانی معنا دارد که Tx LPI فعال باشد.
.RE
.TP
.B \-\-set\-phy\-tunable
پارامترهای قابل تنظیم PHY را پیکربندی میکند.
.RS 4
.TP
.A2 downshift on off
مشخص میکند که آیا کاهش خودکار سرعت (downshift) باید فعال باشد یا خیر.
.TS
nokeep;
lB l.
.BI count \ N
تعداد تلاشهای مجدد برای downshift در PHY را تنظیم میکند.
.TE
.TP
.A2 fast-link-down on off
مشخص میکند که آیا Fast Link Down باید فعال باشد و زمان تا قطع پیوند (در صورت پشتیبانی) را تعیین میکند.
.TS
nokeep;
lB l.
.BI msecs \ N
مدت زمانی را تعیین میکند که پس از آن قطع پیوند گزارش میشود. توجه داشته باشید که PHY ممکن است نزدیکترین مقدار پشتیبانیشده را انتخاب کند. تنها هنگام خواندن مجدد مقدار تنظیمی، مقدار واقعی به دست میآید.
.TE
.TP
.A2 energy-detect-power-down on off
مشخص میکند که آیا خاموشی تشخیص انرژی (EDPD) باید فعال باشد یا خیر (در صورت پشتیبانی). این کار بلوکهای مداری RX و TX را در حالت کممصرف قرار میدهد، و PHY به طور دورهای برای ارسال پالسهای اتصال بیدار میشود تا از وضعیت قفلشدگی با PHY مقابل که ممکن است EDPD روی آن نیز فعال باشد جلوگیری کند. به طور پیشفرض، این تنظیم ارسال دورهای پالسهای TX را نیز فعال میکند.
.TS
nokeep;
lB l.
.BI msecs \ N
برخی PHYها از پیکربندی بازه زمانی بیدار شدن برای ارسال پالسهای TX پشتیبانی میکنند. این تنظیم امکان کنترل این بازه را فراهم میکند و مقدار 0 در صورت پشتیبانی PHY، پالسهای TX را غیرفعال میسازد. غیرفعال کردن پالسهای TX میتواند وضعیتی از قفلشدگی ایجاد کند که هیچیک از دو PHY دیگری را بیدار نکند. در صورت عدم تعیین، مقدار پیشفرض (بر حسب میلیثانیه) توسط PHY استفاده خواهد شد.
.TE
.TP
.PD
.RE
.TP
.B \-\-get\-phy\-tunable
پارامترهای قابل تنظیم PHY را دریافت میکند.
.RS 4
.TP
.B downshift
برای کار در محیطهای کابلکشی که با 1000BASE-T ناسازگار هستند، دستگاه PHY یک عملیات کاهش خودکار سرعت اتصال (downshift) را ارائه میدهد. کاهش سرعت اتصال پس از N بار تلاش ناموفق برای مذاکره خودکار 1000BASE-T انجام میشود. ویژگی Downshift در مواردی که کابل فاقد ۴ زوجسیم است مفید واقع میشود.
.PP
تعداد تلاش/وضعیت downshift در PHY را دریافت میکند.
.TP
.B fast\-link\-down
بسته به حالت کاری، ممکن است بین ۰.۵ تا ۱ ثانیه طول بکشد تا قطع شدن اتصال گزارش شود. در کاربردهای خاص، رویداد قطع اتصال (link-down) باید در سریعترین زمان ممکن گزارش گردد. برخی PHYها از قابلیت Fast Link Down پشتیبانی میکنند و امکان پیکربندی تاخیر پیش از گزارش قطع اتصال را فراهم میسازند.
.PP
وضعیت / مدت زمان Fast Link Down در PHY را دریافت میکند.
.TP
.B energy\-detect\-power\-down
تنظیم پیکربندیشده فعلی برای خاموشی تشخیص انرژی (Energy Detect Power Down) را دریافت میکند (در صورت پشتیبانی).
.RE
.TP
.B \-\-get\-tunable
پارامترهای قابل تنظیم درایور را دریافت میکند.
.RS 4
.TP
.B rx\-copybreak
مقدار فعلی rx copybreak را بر حسب بایت دریافت میکند.
.TP
.B tx\-copybreak
مقدار فعلی tx copybreak را بر حسب بایت دریافت میکند.
.TP
.B tx\-buf\-size
اندازه بافر فعلی tx copybreak را بر حسب بایت دریافت میکند.
.TP
.B pfc\-prevention\-tout
مقدار مهلت زمانی (تایماوت) پیشگیری از طوفان PFC را بر حسب میلیثانیه دریافت میکند. این مقدار تایماوت هم برای PFC (کنترل جریان اولویتدار) و هم برای طوفانهای توقف سطح اتصال استاندارد (IEEE 802.3x) اعمال میشود. طوفان توقف زمانی رخ میدهد که یک دستگاه دائماً فریمهای توقف TX را به سوئیچ ارسال کند و در نتیجه فشار معکوس مداوم ایجاد شود. در صورت فعال بودن، اگر کارت شبکه تشخیص دهد که وضعیت توقف از تایماوت پیکربندیشده فراتر رفته است، دستگاه اقدام حفاظتی انجام میدهد (ارسال فریمهای توقف را متوقف میکند) تا از توقف کامل ترافیک جلوگیری شود.
.RE
.TP
.B \-\-set\-tunable
پارامترهای قابل تنظیم درایور را تنظیم میکند.
.RS 4
.TP
.BI rx\-copybreak \ N
مقدار rx copybreak را بر حسب بایت تنظیم میکند.
.TP
.BI tx\-copybreak \ N
مقدار tx copybreak را بر حسب بایت تنظیم میکند.
.TP
.BI tx\-buf\-size \ N
اندازه بافر tx copybreak را بر حسب بایت تنظیم میکند.
.TP
.BI pfc\-prevention\-tout \ N
تایماوت پیشگیری از طوفان PFC را بر حسب میلیثانیه تنظیم میکند. محدوده مقادیر معتبر به دستگاه بستگی دارد. مقادیر خاص عبارتند از:
.RS 4
.TP
.B 0
غیرفعالسازی پیشگیری از طوفان.
.TP
.B 65535
استفاده از تایماوت پیشفرض محلی دستگاه (خودکار).
.RE
.RE
.TP
.B \-\-reset
اجزای سختافزاری مشخصشده توسط پرچمها و اجزای فهرستشده در زیر را بازنشانی (ریست) میکند:
.RS 4
.TP
.BI flags \ N
اجزا را بر اساس ماسک مستقیم پرچمها ریست میکند.
.TP
.B mgmt
پردازنده مدیریتی
.TP
.B irq
درخواستکننده وقفه
.TP
.B dma
موتور DMA
.TP
.B filter
فیلتر کردن / هدایت جریان
.TP
.B offload
برونسپاری پروتکل
.TP
.B mac
کنترلکننده دسترسی به رسانه (MAC)
.TP
.B phy
فرستنده-گیرنده / PHY
.TP
.B ram
حافظه RAM مشترک بین چندین جزء
.B ap
پردازنده برنامه کاربردی
.TP
.B dedicated
تمام اجزای اختصاصیافته به این رابط
.TP
.B all
تمام اجزای مورد استفاده توسط این رابط، حتی اگر مشترک باشند
.RE
.TP
.B \-\-show\-fec
دستگاه شبکه مشخصشده را برای پشتیبانی از تصحیح خطای رو به جلو (Forward Error Correction - FEC) استعلام میکند.
.TP
.B \-\-set\-fec
تصحیح خطای رو به جلو (FEC) را برای دستگاه شبکه مشخصشده پیکربندی میکند.
.PP
انتظار میرود حالتهای FEC انتخابشده توسط کاربر پس از هرگونه رویداد اتصال گرم (hotplug) ماندگار باشند. اگر ماژولی تعویض شود که از حالت فعلی FEC پشتیبانی نکند، درایور یا میانافزار باید پیوند را به صورت مدیریتی قطع کند و مشکل را در گزارشهای سیستم ثبت نماید تا کاربران آن را اصلاح کنند.
.RS 4
.TP
.BR encoding\ auto | off | rs | baser | llrs \ [...]
کدگذاری FEC را برای دستگاه تنظیم میکند. ترکیبی از گزینهها به عنوان مثال به صورت
.B encoding auto rs
مشخص میشود؛ معنای چنین ترکیبهایی بین درایورهای مختلف متفاوت است.
.TS
nokeep;
lB l.
auto استفاده از کدگذاری پیشفرض درایور
off خاموش کردن FEC
RS اجبار به کدگذاری RS-FEC
BaseR اجبار به کدگذاری BaseR
LLRS اجبار به کدگذاری LLRS-FEC
.TE
.RE
.TP
.B \-Q|\-\-per\-queue
زیردستور ارائهشده را روی صفهای خاصی اعمال میکند.
.RS 4
.TP
.B queue_mask %x
صفهای خاصی را که زیردستور روی آنها اعمال میشود تنظیم میکند. اگر queue_mask تنظیم نشود، زیردستور روی تمام صفها اعمال خواهد شد.
.TP
.B sub_command
زیردستور برای اعمال. زیردستورهای پشتیبانیشده شامل --show-coalesce و --coalesce هستند.
.RE
.TP
.B \-\-cable\-test
یک آزمایش کابل انجام داده و نتایج را گزارش میکند. نوع نتایج بازگرداندهشده به قابلیتهای رابط شبکه بستگی دارد. معمولاً زوجهای باز (قطعی) و زوجهای اتصال کوتاه به همراه زوجهای سالم (O.K.) گزارش میشوند. هنگامی که خطایی شناسایی شود، فاصله تقریبی تا محل خطا نیز ممکن است گزارش شود.
.TP
.B \-\-cable\-test\-tdr
یک آزمایش کابل انجام داده و دادههای خام بازتابسنج دامنه زمان (TDR) را گزارش میکند. یک پالس در طول یک زوجسیم کابل ارسال میشود و دامنه بازتاب برای یک فاصله معین گزارش میگردد. قطعی در کابل بازتاب بزرگی ایجاد میکند. آسیب جزئی به کابل بازتاب کوچکی بازمیگرداند. اگر کابل دچار اتصال کوتاه باشد، دامنه بازتاب میتواند منفی باشد. به طور پیشفرض، دادهها برای طولهای بین ۰ تا ۱۵۰ متر در گامهای ۱ متری برای همه زوجسیمها بازگردانده میشوند. با این حال میتوان پارامترهایی را برای محدود کردن جمعآوری دادهها ارسال کرد. باید توجه داشت که رابط شبکه فاصلهها را به هر دقتی که عملاً پیادهسازی شده باشد گرد میکند. این مقدار اغلب ۰.۸ متر است. نتایج باید شامل اولین و آخرین فاصله واقعی گردشده و اندازه گام باشند.
.RS 4
.TP
.B first \ N
فاصله در طول کابل بر حسب متر، جایی که اولین اندازهگیری باید انجام شود.
.TP
.B last \ N
فاصله در طول کابل بر حسب متر، جایی که آخرین اندازهگیری باید انجام شود.
.TP
.B step \ N
فاصله بر حسب متر، بین هر اندازهگیری.
.TP
.B pair \ N
کدام زوجسیم باید اندازهگیری شود. معمولاً یک کابل دارای ۴ زوجسیم است: 0 = Pair A، 1 = Pair B، ...
.RE
.TP
.B \-\-monitor
به اعلانهای نتلینک (netlink) گوش میدهد و آنها را نمایش میدهد.
.RS 4
.TP
.I command
اگر آرگومانی مطابق با یک دستور استفاده شود، ethtool فقط اعلانهای این نوع را نشان میدهد. بدون چنین آرگومانی یا با --all، تمام انواع اعلانها نمایش داده میشوند.
.TP
.I devname
اگر از نام یک دستگاه به عنوان آرگومان استفاده شود، تنها اعلانهای مربوط به این دستگاه نمایش داده میشوند. حالت پیشفرض، نمایش اعلانهای همه دستگاهها است.
.RE
.TP
.B \-\-show\-tunnels
قابلیتها و وضعیت دستگاه مربوط به تونلها را نمایش میدهد. پورتهای UDP را که کرنل دستگاه را برای تجزیه به عنوان تونلهای VxLAN یا GENEVE برنامهریزی کرده است، فهرست میکند.
.RE
.TP
.B \-\-show\-module
پارامترهای ماژول فرستنده-گیرنده (transceiver) را نمایش میدهد.
.RE
.TP
.B \-\-set\-module
پارامترهای ماژول فرستنده-گیرنده را تنظیم میکند.
.RS 4
.TP
.A2 power-mode-policy high auto
سیاست حالت مصرف انرژی را برای ماژول تنظیم میکند. هنگامی که روی \fBhigh\fR تنظیم شود، ماژول همیشه در حالت توان بالا کار میکند. هنگامی که روی \fBauto\fR تنظیم شود، هنگامی که اولین پورت استفادهکننده از آن از نظر مدیریتی فعال (up) شود، ماژول توسط میزبان به حالت توان بالا منتقل میشود و زمانی که آخرین پورت استفادهکننده از نظر مدیریتی غیرفعال (down) شود، به حالت کممصرف منتقل میگردد. سیاست حالت توان را میتوان پیش از اتصال ماژول نیز تنظیم کرد.
.RE
.TP
.B \-\-get\-plca\-cfg
پارامترهای فعلی PLCA را برای رابط دادهشده نمایش میدهد.
.RE
.TP
.B \-\-set\-plca\-cfg
تنظیمات PLCA را برای رابط دادهشده تغییر میدهد.
.RS 4
.TP
.A2 enable on off
عملکرد PLCA را فعال یا غیرفعال میکند. هنگامی که PLCA RS غیرفعال باشد (پیشفرض)، PHY در حالت ساده CSMA/CD کار میکند. برای فعالسازی PLCA، باید یک \fBplca\-id\fR منحصربهفرد غیر از 255 به PHY اختصاص داده شود. این مقدار میتواند همزمان با پارامتر enable پیکربندی شود. پارامتر \fBenable\fR با بندهای 30.16.1.1.1 (aPLCAAdminState) و 30.16.1.2.1 (acPLCAAdminControl) از استاندارد IEEE 802.3cg-2019 مطابقت دارد.
.TP
.BI node\-id \ N
شناسه منحصربهفرد گره در محدوده [0 .. 255]. شناسه گره 0 برای گره هماهنگکننده (coordinator) که سیگنال BEACON را تولید میکند رزرو شده است. در یک شبکه PLCA باید دقیقاً یک هماهنگکننده وجود داشته باشد. تنظیم شناسه گره روی 255 (پیشفرض) گره را غیرفعال میکند. این پارامتر با بند 30.16.1.1.4 (aPLCALocalNodeID) از استاندارد IEEE 802.3cg-2019 مطابقت دارد.
.TP
.BI node\-cnt \ N
پارامتر node-cnt در محدوده [1 .. 255] باید بر اساس حداکثر تعداد گرههایی که میتوانند به شبکه چندنقطهای متصل شوند تنظیم گردد. این پارامتر حداقل طول چرخه PLCA را تنظیم میکند. بنابراین، تنها برای گره هماهنگکننده (\fBnode-id\fR = 0) معنادار است. تنظیم این پارامتر روی یک گره پیرو (follower) هیچ تاثیری ندارد. پارامتر \fBnode\-cnt\fR با بند 30.16.1.1.3 (aPLCANodeCount) از استاندارد IEEE 802.3cg-2019 مطابقت دارد.
.TP
.BI to\-tmr \ N
پارامتر تایمر TO مقدار تایمر فرصت ارسال (transmit opportunity timer) را بر حسب bit-time تنظیم میکند و برای عملکرد صحیح PLCA باید در تمام گرههای مشترک در رسانه یکسان تنظیم شود. مقدار پیشفرض 32 برای پوشش پیوندی با طول تقریبی ۵۰ متر کافی است. این پارامتر با بند 30.16.1.1.5 (aPLCATransmitOpportunityTimer) از استاندارد IEEE 802.3cg-2019 مطابقت دارد.
.TP
.BI burst\-cnt \ N
پارامتر \fBburst\-cnt\fR در محدوده [0 .. 255] تعداد بستههای اضافی را مشخص میکند که گره مجاز است در طول یک فرصت ارسال واحد بفرستد. به طور پیشفرض این ویژگی 0 است، به این معنی که گره میتواند در هر TO یک فریم ارسال کند. در صورت بزرگتر بودن از 0، لایه PLCA RS پس از هر ارسال، TO را حفظ کرده و تا سقف \fBburst\-tmr\fR بیت-تایم منتظر میماند تا MAC فریم جدیدی ارسال کند. این امر در هر چرخه PLCA تنها تا تعداد دفعات تعیینشده توسط این پارامتر میتواند رخ دهد. پس از آن، ارسال پشت سر هم (burst) به پایان میرسد و شمارش عادی TOها از سر گرفته میشود. این پارامتر با بند 30.16.1.1.6 (aPLCAMaxBurstCount) از استاندارد IEEE 802.3cg-2019 مطابقت دارد.
.TP
.BI burst\-tmr \ N
پارامتر \fBburst\-tmr\fR در محدوده [0 .. 255] تعیین میکند که وقتی \fBburst\-cnt\fR بزرگتر از 0 است، PLCA RS چند بیت-تایم برای آغاز ارسال جدید توسط MAC منتظر بماند. اگر MAC در این مدت فریم جدیدی ارسال نکند، حالت burst به پایان رسیده و شمارش TOها از سر گرفته میشود. در غیر این صورت، فریم جدید به عنوان بخشی از burst فعلی ارسال میشود. این پارامتر با بند 30.16.1.1.7 (aPLCABurstTimer) از استاندارد IEEE 802.3cg-2019 مطابقت دارد. مقدار \fBburst\-tmr\fR باید بزرگتر از زمان فاصله بین فریمها (IFG) در MAC (به علاوه مقداری حاشیه اطمینان) تنظیم شود تا حالت burst مربوط به PLCA طبق انتظار کار کند.
.RE
.TP
.B \-\-get\-plca\-status
وضعیت فعلی PLCA را برای رابط دادهشده نمایش میدهد. اگر \fBon\fR باشد، PHY با موفقیت سیگنال BEACON را دریافت یا تولید میکند. اگر \fBoff\fR باشد، عملکرد PLCA موقتاً غیرفعال است و PHY در حالت عادی CSMA/CD کار میکند.
.RE
.TP
.B \-\-show\-mm
وضعیت لایه MAC Merge را نمایش میدهد. آرگومان ethtool به صورت
.B \-I \-\-include\-statistics
میتواند همراه با این دستور استفاده شود، و شمارندههای آماری لایه MAC Merge نیز بازیابی خواهند شد.
.RS 4
.TP
.B pmac-enabled
نشان میدهد که آیا pMAC فعال و قادر به دریافت ترافیک و فریمهای SMD-V (و پاسخ به آنها با پاسخهای SMD-R) هست یا خیر.
.TP
.B tx-enabled
نشان میدهد که آیا ارسال روی pMAC از نظر مدیریتی فعال است یا خیر.
.TP
.B tx-active
نشان میدهد که آیا ارسال روی pMAC فعال است یا خیر (اعتبارسنجی با موفقیت انجام شده یا غیرفعال بوده است).
.TP
.B tx-min-frag-size
حداقل اندازه (بر حسب اکتت) قطعات ارسالی غیرپایانی را نشان میدهد که توسط طرف مقابل پیوند قابل دریافت است. با متغیر استاندارد addFragSize با استفاده از فرمول زیر مطابقت دارد:
.PP
tx-min-frag-size = 64 * (1 + addFragSize) - 4
.TP
.B rx-min-frag-size
حداقل اندازه (بر حسب اکتت) قطعات غیرپایانی را نشان میدهد که دستگاه محلی از دریافت آنها پشتیبانی میکند.
.TP
.B verify-enabled
نشان میدهد که آیا ماشین حالت اعتبارسنجی فعال است یا خیر. این فرآیند در صورت موفقیت تضمین میکند فریمهای پیشدستانهای (preemptible) که توسط دستگاه محلی ارسال میشوند، به عنوان فریمهای خطا توسط طرف مقابل پیوند دور انداخته نمیشوند.
.TP
.B verify-time
فاصله زمانی بین تلاشهای اعتبارسنجی را بر حسب میلیثانیه به عنوان یک عدد صحیح بین ۱ تا ۱۲۸ میلیثانیه نشان میدهد. استاندارد تعداد ثابتی از تلاشهای اعتبارسنجی (verifyLimit) را پیش از شکست فرآیند اعتبارسنجی تعریف میکند.
.TP
.B max-verify-time
حداکثر مقدار verify-time پذیرفتهشده توسط دستگاه محلی را نشان میدهد، که ممکن است کمتر از ۱۲۸ میلیثانیه باشد.
.TP
.B verify-status
وضعیت فعلی ماشین حالت اعتبارسنجی دستگاه محلی را نشان میدهد. مقادیر میتوانند شامل
.B INITIAL،
.B VERIFYING،
.B SUCCEEDED،
.B FAILED
یا
.B DISABLED
باشند.
.RE
.TP
.B \-\-set\-mm
پارامترهای لایه MAC Merge را تنظیم میکند.
.RS 4
.TP
.A2 pmac-enabled \ on off
دریافت را برای pMAC فعال میکند.
.TP
.A2 tx-enabled \ on off
ارسال را برای pMAC از نظر مدیریتی فعال میکند.
.TP
.B tx-min-frag-size \ N
حداقل اندازه (بر حسب اکتت) قطعات ارسالی غیرپایانی را که توسط طرف مقابل پیوند قابل دریافت است تنظیم میکند.
.TP
.A2 verify-enabled \ on off
ماشین حالت اعتبارسنجی را فعال یا غیرفعال میکند.
.TP
.B verify-time \ N
بازه زمانی بین تلاشهای اعتبارسنجی را بر حسب میلیثانیه تنظیم میکند.
.RE
.TP
.B \-\-show\-pse
وضعیت فعلی تجهیزات تامین توان (PSE - Power Sourcing Equipment) را برای رابط دادهشده نمایش میدهد.
.RS 4
.TP
.B podl-pse-admin-state
این ویژگی وضعیت عملیاتی توابع PoDL PSE را نشان میدهد که با استفاده از پارامتر
.B podl-pse-admin-control
قابل تغییر است. این مقدار با مشخصه 30.15.1.1.2 (aPoDLPSEAdminState) از استاندارد IEEE 802.3-2018 مطابقت دارد و مقادیر احتمالی آن
.B enabled، disabled
است.
.TP
.B podl-pse-power-detection-status
این ویژگی وضعیت تشخیص توان PoDL PSE را نشان میدهد. این وضعیت به ماشین حالت داخلی PSE و پشتیبانی از طبقهبندی خودکار PD بستگی دارد. با مشخصه 30.15.1.1.3 (aPoDLPSEPowerDetectionStatus) از استاندارد IEEE 802.3-2018 مطابقت دارد و مقادیر احتمالی آن شامل
.B disabled، searching، delivering power، sleep، idle، error
است.
.TP
.B c33-pse-admin-state
این ویژگی وضعیت عملیاتی توابع c33 PSE را نشان میدهد که با استفاده از پارامتر
.B c33-pse-admin-control
قابل تغییر است. با مشخصه 30.9.1.1.2 (aPSEAdminState) از استاندارد IEEE 802.3-2022 مطابقت دارد و مقادیر احتمالی آن
.B enabled، disabled
است.
.TP
.B c33-pse-power-detection-status
این ویژگی وضعیت تشخیص توان c33 PSE را نشان میدهد. وضعیت به ماشین حالت داخلی PSE و پشتیبانی از طبقهبندی خودکار PD بستگی دارد. با مشخصه 30.9.1.1.5 (aPSEPowerDetectionStatus) از استاندارد IEEE 802.3-2022 مطابقت دارد و مقادیر احتمالی آن عبارتند از
.B disabled، searching، delivering power، test، fault، other fault
.TP
.B c33-pse-extended-state
این ویژگی وضعیت توسعهیافته (Extended state) مربوط به c33 PSE را نشان میدهد. وضعیت توسعهیافته در پیوند با زیروضعیت توسعهیافته c33 PSE به کاربر اجازه میدهد جزئیات بیشتری درباره وضعیت خطای فعلی c33 PSE به دست آورد. این ویژگی با متغیرهای بخش 33.2.4.4 از استاندارد IEEE 802.3-2022 مطابقت دارد.
.TP
.B c33-pse-extended-substate
این ویژگی زیروضعیت توسعهیافته c33 PSE را نشان میدهد. در پیوند با مقدار وضعیت توسعهیافته c33 PSE، امکان دستیابی به جزئیات بیشتر در مورد وضعیت خطای فعلی c33 PSE را فراهم میکند.
.TP
.B c33-pse-power-class
این ویژگی کلاس توان c33 PSE را مشخص میکند. به کلاس مذاکرهشده بین PSE و PD بستگی دارد و با مشخصه 30.9.1.1.8 (aPSEPowerClassification) از استاندارد IEEE 802.3-2022 مطابقت دارد.
.TP
.B c33-pse-actual-power
این ویژگی توان واقعی مصرفشده توسط c33 PSE را مشخص میکند. با مشخصه 30.9.1.1.23 (aPSEActualPower) از استاندارد IEEE 802.3-2022 مطابقت دارد. توان واقعی بر حسب میلیوات (mW) گزارش میشود.
.TP
.B c33-pse-available-power-limit
این ویژگی حد توان پیکربندیشده c33 PSE را بر حسب میلیوات (mW) مشخص میکند.
.TP
.B c33-pse-power-limit-ranges
این ویژگی محدودههای مجاز حد توان را بر حسب میلیوات جهت پیکربندی پارامتر c33-pse-avail-pw-limit مشخص میکند. سطوح توان معتبری را که میتوان بر اساس استاندارد c33 به c33 PSE اختصاص داد، تعریف مینماید.
.TP
.B power-domain-index
نمایه دامنه توان PSE را که پورت به آن تعلق دارد گزارش میکند. هر پورت دقیقاً به یک دامنه توان تعلق دارد. اولویتهای پورت درون همان دامنه توان تعریف میشوند.
.PP
هر دامنه توان ممکن است علاوه بر بودجه کل سیستم (مثلاً ۲۰۰ وات در کل)، بودجه حداکثری مخصوص به خود را داشته باشد (مثلاً ۱۰۰ وات در هر دامنه). محدودیتهای دامنه ابتدا اعمال میشوند: اگر یک دامنه منفرد به بودجه خود برسد، تنها پورتهای همان دامنه تحت تأثیر قرار میگیرند. بودجه سراسری سیستم در تمام دامنهها اعمال میشود.
.TP
.B priority-max
حداکثر مقدار اولویت پورت قابل پیکربندی را درون دامنه توان گزارششده نشان میدهد. محدوده معتبر برای prio از 0 تا priority-max (شامل خود آن) است.
.TP
.B priority
اولویت پورت پیکربندیشده فعلی را درون دامنه توان گزارششده نشان میدهد. مقادیر عددی کمتر نشاندهنده اولویت بالاتر هستند: 0 بالاترین اولویت است.
.RE
.TP
.B \-\-set\-pse
پارامترهای تجهیزات تامین توان (PSE) را تنظیم میکند.
.RS 4
.TP
.A2 podl-pse-admin-control \ enable disable
این پارامتر عملیات مدیریتی PoDL PSE را مطابق با مشخصات IEEE 802.3-2018 30.15.1.2.1 (acPoDLPSEAdminControl) مدیریت میکند.
.TP
.A2 c33-pse-admin-control \ enable disable
این پارامتر عملیات مدیریتی c33 PSE را مطابق با مشخصات IEEE 802.3-2022 30.9.1.2.1 (acPSEAdminControl) مدیریت میکند.
.TP
.B c33-pse-avail-pw-limit \ N
این پارامتر حد توان در دسترس c33 PSE را بر حسب میلیوات، مطابق با متغیرهای مشخصه IEEE 802.3-2022 33.2.4.4 (pse_available_power) مدیریت میکند.
.TP
.B prio \ N
اولویت پورت را محدود به دامنه توان پورت (همانطور که توسط power-domain-index گزارش شده) تنظیم میکند. مقادیر کمتر نشاندهنده اولویت بالاتر هستند؛ 0 بالاترین اولویت است. محدوده معتبر از 0 تا priority-max گزارششده توسط
.B \-\-show\-pse
است.
.PP
هنگامی که یک دامنه منفرد از بودجه خود فراتر رود، برق پورتهای آن دامنه بر اساس اولویت وصل یا قطع میشود (بالاترین اولویت ابتدا روشن میشود؛ پایینترین اولویت ابتدا قطع میگردد).
.RE
.TP
.B \-\-show\-mse
اطلاعات تشخیصی میانگین مربعات خطا (MSE) مربوط به PHY را نمایش میدهد.
.RS 4
.P
معیارها از مدل تشخیصی PHY اتحادیه OPEN Alliance (مورد استفاده در PHYهای خودرویی و صنعتی) پیروی میکنند. مقیاسگذاری عددی، پنجرههای نمونهبرداری و فواصل بهروزرسانی مختص سازنده هستند و توسط بلوک قابلیتها گزارش میشوند.
.P
مقادیر، نماهای خام (اسنپشات) از DSP مربوط به PHY هستند. مقادیر کمتر به طور کلی نشاندهنده کیفیت بهتر سیگنال هستند؛ 0 ایدهآل است. مقادیر را باید نسبت به مقیاسهای max-* گزارششده برای این PHY و حالت اتصال تفسیر کرد.
.P
مجموعه کانالهای بازگرداندهشده به پشتیبانی PHY بستگی دارد. هنگامی که دادههای هر کانال در دسترس باشد، دستههای Channel A/B/C/D بازگردانده میشوند. در غیر این صورت، کرنل ممکن است یک اسنپشات تجمیعی منفرد WORST یا LINK را بازگرداند.
.TP
.B قابلیتها (Capabilities)
مقیاس و زمانبندی ارائهشده توسط درایور:
.RS 4
.TP
.B max\-average\-mse
مقیاس برای مقادیر میانگین MSE.
.TP
.B max\-peak\-mse
مقیاس برای مقادیر اوج (پیک) MSE. تنها در صورتی وجود دارد که PHY مقادیر peak-mse و/یا worst-peak-mse را گزارش کند.
.TP
.B refresh\-rate\-ps
بازه زمانی معمول بهروزرسانی سختافزاری بر حسب پیکوثانیه.
.TP
.B symbols\-per\-sample
تعداد نمادهای جمعآوریشده در هر نمونه سختافزاری.
.RE
.TP
.B نماها (Snapshots)
یک دسته به ازای هر انتخابکننده (Channel A/B/C/D، WORST، یا LINK). هر کدام شامل معیارهای پشتیبانیشده توسط PHY است: average-mse و در صورت وجود peak-mse و/یا worst-peak-mse. مقادیر خام هستند و باید با استفاده از مقیاسهای قابلیت فوق تفسیر شوند.
.P
پنجرههای زمانی کوتاه (refresh-rate-ps پایین یا symbols-per-sample اندک) میتوانند واریانس بالایی ایجاد کنند؛ فضای کاربری میتواند با نظرسنجی و میانگینگیری در طول زمان پایداری را بهبود بخشد.
.RE
.TP
.B \-\-flash\-module\-firmware
میانافزار ماژول فرستنده-گیرنده را فلش میکند. فرآیند بهروزرسانی میانافزار از سه مرحله منطقی تشکیل شده است: بارگیری تصویر میانافزار در ماژول فرستنده-گیرنده، اجرای تصویر، و ثبت نهایی (commit) تصویر تا در هنگام بازنشانی اجرا شود. با صدور دستور flash، فرآیند بهروزرسانی میانافزار به طور کامل و به همین ترتیب انجام میشود.
.RS 4
.TP
.BI file \ FILE
نام فایل تصویر میانافزار ماژول فرستنده-گیرنده را مشخص میکند. میانافزار ابتدا باید در یکی از پوشههایی که بارگذار میانافزار کرنل یا عامل میانافزار در آن جستجو میکند، مانند /lib/firmware نصب شده باشد. تصویر میانافزار در ماژول فرستنده-گیرنده بارگیری، اعتبارسنجی، اجرا و ثبت نهایی میشود.
.RE
.RS 4
.TP
.BI pass \ PASS
رمز عبور اختیاری ماژول فرستنده-گیرنده که ممکن است به عنوان بخشی از فرآیند بهروزرسانی میانافزار ماژول مورد نیاز باشد.
.RE
.TP
.B \-\-show\-phys
دستگاههای PHY متصل به یک رابط و نحوه پیوند آنها به یکدیگر را نمایش میدهد.
.RS 4
.TP
.B phy_index
نمایه PHY که آن را در رابط شبکه مشخص میکند. اگر رابط دارای چندین PHY باشد، هر کدام یک نمایه منحصربهفرد در آن رابط خواهند داشت. این نمایه سپس میتواند برای دستوراتی که PHYها را هدف قرار میدهند استفاده شود.
.TP
.B drvname
نام درایور متصل به این دستگاه PHY.
.TP
.B name
نام دستگاه PHY، مطابق با نام موجود در sysfs.
.TP
.B downstream_sfp_name
اگر PHY یک محفظه SFP را راهاندازی کند، این فیلد شامل نام گذرگاه SFP مرتبط است.
.TP
.B upstream_type \ mac | phy
ماهیت دستگاهی را که PHY به آن متصل است نشان میدهد.
.TP
.B upstream_index
اگر upstream_type مربوط به PHY برابر با
.B phy
باشد، این فیلد phy_index مربوط به phy بالادستی را نشان میدهد.
.TP
.B upstream_sfp_name
اگر PHY درون یک ماژول SFP/SFF باشد، این فیلد شامل نام گذرگاه SFP بالادستی است.
.RE
.SH "اشکالات (BUGS)"
روی تمام درایورهای شبکه (به طور جزئی یا کلی) پشتیبانی نمیشود.
.SH "نویسنده (AUTHOR)"
دستور
.B ethtool
توسط David Miller نوشته شده است.
.PP
تغییرات توسط:
Jeff Garzik،
Tim Hockin،
Jakub Jelinek،
Andre Majorel،
Eli Kupermann،
Scott Feldman،
Andi Kleen،
Alexander Duyck،
Sucheta Chakraborty،
Jesse Brandeburg،
Ben Hutchings،
Scott Branden.
.SH "در دسترس بودن (AVAILABILITY)"
دستور
.B ethtool
از نشانی زیر در دسترس است:
.UR https://www.kernel.org/pub/software/network/ethtool
.UE