sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftargetH/translations/zh_CN/networking/device_drivers/ethernet/aquantia/atlanticmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetH/translations/zh_TW/networking/device_drivers/ethernet/aquantia/atlanticmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetH/translations/it_IT/networking/device_drivers/ethernet/aquantia/atlanticmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetH/translations/ja_JP/networking/device_drivers/ethernet/aquantia/atlanticmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetH/translations/ko_KR/networking/device_drivers/ethernet/aquantia/atlanticmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetH/translations/sp_SP/networking/device_drivers/ethernet/aquantia/atlanticmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhb/var/lib/git/docbuild/linux/Documentation/networking/device_drivers/ethernet/aquantia/atlantic.rsthKubh)}(h4This data file has been placed in the public domain.h]h4This data file has been placed in the public domain.}hhsbah}(h]h ]h"]h$]h&]hhuh1hhhhhho/srv/docbuild/lib/venvs/build-kernel-docs/lib64/python3.9/site-packages/docutils/parsers/rst/include/isonum.txthKubh)}(hDerived from the Unicode character mappings available from . Processed by unicode2rstsubs.py, part of Docutils: .h]hDerived from the Unicode character mappings available from . Processed by unicode2rstsubs.py, part of Docutils: .}hhsbah}(h]h ]h"]h$]h&]hhuh1hhhhhhhhKubhsubstitution_definition)}(h*.. |amp| unicode:: U+00026 .. AMPERSANDh]h&}hhsbah}(h]h ]h"]ampah$]h&]uh1hhhhKhhhhubh)}(h+.. |apos| unicode:: U+00027 .. APOSTROPHEh]h'}hhsbah}(h]h ]h"]aposah$]h&]uh1hhhhKhhhhubh)}(h).. |ast| unicode:: U+0002A .. ASTERISKh]h*}hhsbah}(h]h ]h"]astah$]h&]uh1hhhhK hhhhubh)}(h+.. |brvbar| unicode:: U+000A6 .. BROKEN BARh]h¦}hjsbah}(h]h ]h"]brvbarah$]h&]uh1hhhhK hhhhubh)}(h0.. |bsol| unicode:: U+0005C .. REVERSE SOLIDUSh]h\}hjsbah}(h]h ]h"]bsolah$]h&]uh1hhhhK hhhhubh)}(h*.. |cent| unicode:: U+000A2 .. CENT SIGNh]h¢}hjsbah}(h]h ]h"]centah$]h&]uh1hhhhK hhhhubh)}(h&.. |colon| unicode:: U+0003A .. COLONh]h:}hj-sbah}(h]h ]h"]colonah$]h&]uh1hhhhK hhhhubh)}(h&.. |comma| unicode:: U+0002C .. COMMAh]h,}hj<sbah}(h]h ]h"]commaah$]h&]uh1hhhhKhhhhubh)}(h... |commat| unicode:: U+00040 .. COMMERCIAL ATh]h@}hjKsbah}(h]h ]h"]commatah$]h&]uh1hhhhKhhhhubh)}(h/.. |copy| unicode:: U+000A9 .. COPYRIGHT SIGNh]h©}hjZsbah}(h]h ]h"]copyah$]h&]uh1hhhhKhhhhubh)}(h... |curren| unicode:: U+000A4 .. CURRENCY SIGNh]h¤}hjisbah}(h]h ]h"]currenah$]h&]uh1hhhhKhhhhubh)}(h0.. |darr| unicode:: U+02193 .. DOWNWARDS ARROWh]h↓}hjxsbah}(h]h ]h"]darrah$]h&]uh1hhhhKhhhhubh)}(h,.. |deg| unicode:: U+000B0 .. DEGREE SIGNh]h°}hjsbah}(h]h ]h"]degah$]h&]uh1hhhhKhhhhubh)}(h... |divide| unicode:: U+000F7 .. DIVISION SIGNh]h÷}hjsbah}(h]h ]h"]divideah$]h&]uh1hhhhKhhhhubh)}(h,.. |dollar| unicode:: U+00024 .. DOLLAR SIGNh]h$}hjsbah}(h]h ]h"]dollarah$]h&]uh1hhhhKhhhhubh)}(h,.. |equals| unicode:: U+0003D .. EQUALS SIGNh]h=}hjsbah}(h]h ]h"]equalsah$]h&]uh1hhhhKhhhhubh)}(h1.. |excl| unicode:: U+00021 .. EXCLAMATION MARKh]h!}hjsbah}(h]h ]h"]exclah$]h&]uh1hhhhKhhhhubh)}(h9.. |frac12| unicode:: U+000BD .. VULGAR FRACTION ONE HALFh]h½}hjsbah}(h]h ]h"]frac12ah$]h&]uh1hhhhKhhhhubh)}(h<.. |frac14| unicode:: U+000BC .. VULGAR FRACTION ONE QUARTERh]h¼}hjsbah}(h]h ]h"]frac14ah$]h&]uh1hhhhKhhhhubh)}(h;.. |frac18| unicode:: U+0215B .. VULGAR FRACTION ONE EIGHTHh]h⅛}hjsbah}(h]h ]h"]frac18ah$]h&]uh1hhhhKhhhhubh)}(h?.. |frac34| unicode:: U+000BE .. VULGAR FRACTION THREE QUARTERSh]h¾}hjsbah}(h]h ]h"]frac34ah$]h&]uh1hhhhKhhhhubh)}(h>.. |frac38| unicode:: U+0215C .. VULGAR FRACTION THREE EIGHTHSh]h⅜}hjsbah}(h]h ]h"]frac38ah$]h&]uh1hhhhKhhhhubh)}(h=.. |frac58| unicode:: U+0215D .. VULGAR FRACTION FIVE EIGHTHSh]h⅝}hjsbah}(h]h ]h"]frac58ah$]h&]uh1hhhhKhhhhubh)}(h>.. |frac78| unicode:: U+0215E .. VULGAR FRACTION SEVEN EIGHTHSh]h⅞}hj,sbah}(h]h ]h"]frac78ah$]h&]uh1hhhhKhhhhubh)}(h2.. |gt| unicode:: U+0003E .. GREATER-THAN SIGNh]h>}hj;sbah}(h]h ]h"]gtah$]h&]uh1hhhhKhhhhubh)}(h9.. |half| unicode:: U+000BD .. VULGAR FRACTION ONE HALFh]h½}hjJsbah}(h]h ]h"]halfah$]h&]uh1hhhhK hhhhubh)}(h/.. |horbar| unicode:: U+02015 .. HORIZONTAL BARh]h―}hjYsbah}(h]h ]h"]horbarah$]h&]uh1hhhhK!hhhhubh)}(h'.. |hyphen| unicode:: U+02010 .. HYPHENh]h‐}hjhsbah}(h]h ]h"]hyphenah$]h&]uh1hhhhK"hhhhubh)}(h:.. |iexcl| unicode:: U+000A1 .. INVERTED EXCLAMATION MARKh]h¡}hjwsbah}(h]h ]h"]iexclah$]h&]uh1hhhhK#hhhhubh)}(h7.. |iquest| unicode:: U+000BF .. INVERTED QUESTION MARKh]h¿}hjsbah}(h]h ]h"]iquestah$]h&]uh1hhhhK$hhhhubh)}(hJ.. |laquo| unicode:: U+000AB .. LEFT-POINTING DOUBLE ANGLE QUOTATION MARKh]h«}hjsbah}(h]h ]h"]laquoah$]h&]uh1hhhhK%hhhhubh)}(h0.. |larr| unicode:: U+02190 .. LEFTWARDS ARROWh]h←}hjsbah}(h]h ]h"]larrah$]h&]uh1hhhhK&hhhhubh)}(h3.. |lcub| unicode:: U+0007B .. LEFT CURLY BRACKETh]h{}hjsbah}(h]h ]h"]lcubah$]h&]uh1hhhhK'hhhhubh)}(h;.. |ldquo| unicode:: U+0201C .. LEFT DOUBLE QUOTATION MARKh]h“}hjsbah}(h]h ]h"]ldquoah$]h&]uh1hhhhK(hhhhubh)}(h).. |lowbar| unicode:: U+0005F .. LOW LINEh]h_}hjsbah}(h]h ]h"]lowbarah$]h&]uh1hhhhK)hhhhubh)}(h1.. |lpar| unicode:: U+00028 .. LEFT PARENTHESISh]h(}hjsbah}(h]h ]h"]lparah$]h&]uh1hhhhK*hhhhubh)}(h4.. |lsqb| unicode:: U+0005B .. LEFT SQUARE BRACKETh]h[}hjsbah}(h]h ]h"]lsqbah$]h&]uh1hhhhK+hhhhubh)}(h;.. |lsquo| unicode:: U+02018 .. LEFT SINGLE QUOTATION MARKh]h‘}hjsbah}(h]h ]h"]lsquoah$]h&]uh1hhhhK,hhhhubh)}(h/.. |lt| unicode:: U+0003C .. LESS-THAN SIGNh]h<}hj sbah}(h]h ]h"]ltah$]h&]uh1hhhhK-hhhhubh)}(h+.. |micro| unicode:: U+000B5 .. MICRO SIGNh]hµ}hjsbah}(h]h ]h"]microah$]h&]uh1hhhhK.hhhhubh)}(h+.. |middot| unicode:: U+000B7 .. MIDDLE DOTh]h·}hj+sbah}(h]h ]h"]middotah$]h&]uh1hhhhK/hhhhubh)}(h/.. |nbsp| unicode:: U+000A0 .. NO-BREAK SPACEh]h }hj:sbah}(h]h ]h"]nbspah$]h&]uh1hhhhK0hhhhubh)}(h).. |not| unicode:: U+000AC .. NOT SIGNh]h¬}hjIsbah}(h]h ]h"]notah$]h&]uh1hhhhK1hhhhubh)}(h,.. |num| unicode:: U+00023 .. NUMBER SIGNh]h#}hjXsbah}(h]h ]h"]numah$]h&]uh1hhhhK2hhhhubh)}(h).. |ohm| unicode:: U+02126 .. OHM SIGNh]hΩ}hjgsbah}(h]h ]h"]ohmah$]h&]uh1hhhhK3hhhhubh)}(h;.. |ordf| unicode:: U+000AA .. FEMININE ORDINAL INDICATORh]hª}hjvsbah}(h]h ]h"]ordfah$]h&]uh1hhhhK4hhhhubh)}(h<.. |ordm| unicode:: U+000BA .. MASCULINE ORDINAL INDICATORh]hº}hjsbah}(h]h ]h"]ordmah$]h&]uh1hhhhK5hhhhubh)}(h-.. |para| unicode:: U+000B6 .. PILCROW SIGNh]h¶}hjsbah}(h]h ]h"]paraah$]h&]uh1hhhhK6hhhhubh)}(h-.. |percnt| unicode:: U+00025 .. PERCENT SIGNh]h%}hjsbah}(h]h ]h"]percntah$]h&]uh1hhhhK7hhhhubh)}(h*.. |period| unicode:: U+0002E .. FULL STOPh]h.}hjsbah}(h]h ]h"]periodah$]h&]uh1hhhhK8hhhhubh)}(h*.. |plus| unicode:: U+0002B .. PLUS SIGNh]h+}hjsbah}(h]h ]h"]plusah$]h&]uh1hhhhK9hhhhubh)}(h0.. |plusmn| unicode:: U+000B1 .. PLUS-MINUS SIGNh]h±}hjsbah}(h]h ]h"]plusmnah$]h&]uh1hhhhK:hhhhubh)}(h+.. |pound| unicode:: U+000A3 .. POUND SIGNh]h£}hjsbah}(h]h ]h"]poundah$]h&]uh1hhhhK;hhhhubh)}(h... |quest| unicode:: U+0003F .. QUESTION MARKh]h?}hjsbah}(h]h ]h"]questah$]h&]uh1hhhhKhhhhubh)}(h1.. |rarr| unicode:: U+02192 .. RIGHTWARDS ARROWh]h→}hjsbah}(h]h ]h"]rarrah$]h&]uh1hhhhK?hhhhubh)}(h4.. |rcub| unicode:: U+0007D .. RIGHT CURLY BRACKETh]h}}hj*sbah}(h]h ]h"]rcubah$]h&]uh1hhhhK@hhhhubh)}(h<.. |rdquo| unicode:: U+0201D .. RIGHT DOUBLE QUOTATION MARKh]h”}hj9sbah}(h]h ]h"]rdquoah$]h&]uh1hhhhKAhhhhubh)}(h0.. |reg| unicode:: U+000AE .. REGISTERED SIGNh]h®}hjHsbah}(h]h ]h"]regah$]h&]uh1hhhhKBhhhhubh)}(h2.. |rpar| unicode:: U+00029 .. RIGHT PARENTHESISh]h)}hjWsbah}(h]h ]h"]rparah$]h&]uh1hhhhKChhhhubh)}(h5.. |rsqb| unicode:: U+0005D .. RIGHT SQUARE BRACKETh]h]}hjfsbah}(h]h ]h"]rsqbah$]h&]uh1hhhhKDhhhhubh)}(h<.. |rsquo| unicode:: U+02019 .. RIGHT SINGLE QUOTATION MARKh]h’}hjusbah}(h]h ]h"]rsquoah$]h&]uh1hhhhKEhhhhubh)}(h-.. |sect| unicode:: U+000A7 .. SECTION SIGNh]h§}hjsbah}(h]h ]h"]sectah$]h&]uh1hhhhKFhhhhubh)}(h*.. |semi| unicode:: U+0003B .. SEMICOLONh]h;}hjsbah}(h]h ]h"]semiah$]h&]uh1hhhhKGhhhhubh)}(h,.. |shy| unicode:: U+000AD .. SOFT HYPHENh]h­}hjsbah}(h]h ]h"]shyah$]h&]uh1hhhhKHhhhhubh)}(h(.. |sol| unicode:: U+0002F .. SOLIDUSh]h/}hjsbah}(h]h ]h"]solah$]h&]uh1hhhhKIhhhhubh)}(h,.. |sung| unicode:: U+0266A .. EIGHTH NOTEh]h♪}hjsbah}(h]h ]h"]sungah$]h&]uh1hhhhKJhhhhubh)}(h0.. |sup1| unicode:: U+000B9 .. SUPERSCRIPT ONEh]h¹}hjsbah}(h]h ]h"]sup1ah$]h&]uh1hhhhKKhhhhubh)}(h0.. |sup2| unicode:: U+000B2 .. SUPERSCRIPT TWOh]h²}hjsbah}(h]h ]h"]sup2ah$]h&]uh1hhhhKLhhhhubh)}(h2.. |sup3| unicode:: U+000B3 .. SUPERSCRIPT THREEh]h³}hjsbah}(h]h ]h"]sup3ah$]h&]uh1hhhhKMhhhhubh)}(h4.. |times| unicode:: U+000D7 .. MULTIPLICATION SIGNh]h×}hjsbah}(h]h ]h"]timesah$]h&]uh1hhhhKNhhhhubh)}(h0.. |trade| unicode:: U+02122 .. TRADE MARK SIGNh]h™}hj sbah}(h]h ]h"]tradeah$]h&]uh1hhhhKOhhhhubh)}(h... |uarr| unicode:: U+02191 .. UPWARDS ARROWh]h↑}hjsbah}(h]h ]h"]uarrah$]h&]uh1hhhhKPhhhhubh)}(h... |verbar| unicode:: U+0007C .. VERTICAL LINEh]h|}hj)sbah}(h]h ]h"]verbarah$]h&]uh1hhhhKQhhhhubh)}(h*.. |yen| unicode:: U+000A5 .. YEN SIGN h]h¥}hj8sbah}(h]h ]h"]yenah$]h&]uh1hhhhKRhhhhubhsection)}(hhh](htitle)}(hMarvell(Aquantia) AQtion Driverh]hMarvell(Aquantia) AQtion Driver}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjIhhhhhKubh paragraph)}(hFFor the aQuantia Multi-Gigabit PCI Express Family of Ethernet Adaptersh]hFFor the aQuantia Multi-Gigabit PCI Express Family of Ethernet Adapters}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjIhhubh)}(hContents - Identifying Your Adapter - Configuration - Supported ethtool options - Command Line Parameters - Config file parameters - Support - Licenseh]hContents - Identifying Your Adapter - Configuration - Supported ethtool options - Command Line Parameters - Config file parameters - Support - License}hjlsbah}(h]h ]h"]h$]h&]hhuh1hhjIhhhhhKubjH)}(hhh](jM)}(hIdentifying Your Adapterh]hIdentifying Your Adapter}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjzhhhhhKubj])}(h`The driver in this release is compatible with AQC-100, AQC-107, AQC-108 based ethernet adapters.h]h`The driver in this release is compatible with AQC-100, AQC-107, AQC-108 based ethernet adapters.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjzhhubjH)}(hhh](jM)}(h)SFP+ Devices (for AQC-100 based adapters)h]h)SFP+ Devices (for AQC-100 based adapters)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhKubj])}(h\This release tested with passive Direct Attach Cables (DAC) and SFP+/LC Optical Transceiver.h]h\This release tested with passive Direct Attach Cables (DAC) and SFP+/LC Optical Transceiver.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjhhubeh}(h]&sfp-devices-for-aqc-100-based-adaptersah ]h"])sfp+ devices (for aqc-100 based adapters)ah$]h&]uh1jGhjzhhhhhKubeh}(h]identifying-your-adapterah ]h"]identifying your adapterah$]h&]uh1jGhjIhhhhhKubjH)}(hhh](jM)}(h Configurationh]h Configuration}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhK"ubjH)}(hhh](jM)}(hViewing Link Messagesh]hViewing Link Messages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhK%ubh block_quote)}(hXLink messages will not be displayed to the console if the distribution is restricting system messages. In order to see network driver link messages on your console, set dmesg to eight by entering the following:: dmesg -n 8 .. note:: This setting is not saved across reboots. h](j])}(hLink messages will not be displayed to the console if the distribution is restricting system messages. In order to see network driver link messages on your console, set dmesg to eight by entering the following::h]hLink messages will not be displayed to the console if the distribution is restricting system messages. In order to see network driver link messages on your console, set dmesg to eight by entering the following:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhK&hjubh literal_block)}(h dmesg -n 8h]h dmesg -n 8}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhK*hjubhnote)}(h)This setting is not saved across reboots.h]j])}(hjh]h)This setting is not saved across reboots.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhK.hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhK&hjhhubeh}(h]viewing-link-messagesah ]h"]viewing link messagesah$]h&]uh1jGhjhhhhhK%ubjH)}(hhh](jM)}(h Jumbo Framesh]h Jumbo Frames}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj5hhhhhK1ubj)}(hX"The driver supports Jumbo Frames for all adapters. Jumbo Frames support is enabled by changing the MTU to a value larger than the default of 1500. The maximum value for the MTU is 16000. Use the `ip` command to increase the MTU size. For example:: ip link set mtu 16000 dev enp1s0 h](j])}(hThe driver supports Jumbo Frames for all adapters. Jumbo Frames support is enabled by changing the MTU to a value larger than the default of 1500. The maximum value for the MTU is 16000. Use the `ip` command to increase the MTU size. For example::h](hThe driver supports Jumbo Frames for all adapters. Jumbo Frames support is enabled by changing the MTU to a value larger than the default of 1500. The maximum value for the MTU is 16000. Use the }(hjJhhhNhNubhtitle_reference)}(h`ip`h]hip}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jRhjJubh0 command to increase the MTU size. For example:}(hjJhhhNhNubeh}(h]h ]h"]h$]h&]uh1j\hhhK2hjFubj)}(h ip link set mtu 16000 dev enp1s0h]h ip link set mtu 16000 dev enp1s0}hjlsbah}(h]h ]h"]h$]h&]hhuh1jhhhK7hjFubeh}(h]h ]h"]h$]h&]uh1jhhhK2hj5hhubeh}(h] jumbo-framesah ]h"] jumbo framesah$]h&]uh1jGhjhhhhhK1ubjH)}(hhh](jM)}(hethtoolh]hethtool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhK:ubj)}(hThe driver utilizes the ethtool interface for driver configuration and diagnostics, as well as displaying statistical information. The latest ethtool version is required for this functionality. h]j])}(hThe driver utilizes the ethtool interface for driver configuration and diagnostics, as well as displaying statistical information. The latest ethtool version is required for this functionality.h]hThe driver utilizes the ethtool interface for driver configuration and diagnostics, as well as displaying statistical information. The latest ethtool version is required for this functionality.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhK;hjubah}(h]h ]h"]h$]h&]uh1jhhhK;hjhhubeh}(h]ethtoolah ]h"]ethtoolah$]h&]uh1jGhjhhhhhK:ubjH)}(hhh](jM)}(hNAPIh]hNAPI}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhK@ubj)}(h Output example:: Settings for enp1s0: Supported ports: [ TP ] Supported link modes: 100baseT/Full 1000baseT/Full 10000baseT/Full 2500baseT/Full 5000baseT/Full Supported pause frame use: Symmetric Supports auto-negotiation: Yes Supported FEC modes: Not reported Advertised link modes: 100baseT/Full 1000baseT/Full 10000baseT/Full 2500baseT/Full 5000baseT/Full Advertised pause frame use: Symmetric Advertised auto-negotiation: Yes Advertised FEC modes: Not reported Speed: 10000Mb/s Duplex: Full Port: Twisted Pair PHYAD: 0 Transceiver: internal Auto-negotiation: on MDI-X: Unknown Supports Wake-on: g Wake-on: d Link detected: yes .. note:: AQrate speeds (2.5/5 Gb/s) will be displayed only with linux kernels > 4.10. But you can still use these speeds:: ethtool -s eth0 autoneg off speed 2500 h](j)}(hethtool h]hethtool }hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKKhjubj])}(hOutput example::h]hOutput example:}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKMhjubj)}(hX^Settings for enp1s0: Supported ports: [ TP ] Supported link modes: 100baseT/Full 1000baseT/Full 10000baseT/Full 2500baseT/Full 5000baseT/Full Supported pause frame use: Symmetric Supports auto-negotiation: Yes Supported FEC modes: Not reported Advertised link modes: 100baseT/Full 1000baseT/Full 10000baseT/Full 2500baseT/Full 5000baseT/Full Advertised pause frame use: Symmetric Advertised auto-negotiation: Yes Advertised FEC modes: Not reported Speed: 10000Mb/s Duplex: Full Port: Twisted Pair PHYAD: 0 Transceiver: internal Auto-negotiation: on MDI-X: Unknown Supports Wake-on: g Wake-on: d Link detected: yesh]hX^Settings for enp1s0: Supported ports: [ TP ] Supported link modes: 100baseT/Full 1000baseT/Full 10000baseT/Full 2500baseT/Full 5000baseT/Full Supported pause frame use: Symmetric Supports auto-negotiation: Yes Supported FEC modes: Not reported Advertised link modes: 100baseT/Full 1000baseT/Full 10000baseT/Full 2500baseT/Full 5000baseT/Full Advertised pause frame use: Symmetric Advertised auto-negotiation: Yes Advertised FEC modes: Not reported Speed: 10000Mb/s Duplex: Full Port: Twisted Pair PHYAD: 0 Transceiver: internal Auto-negotiation: on MDI-X: Unknown Supports Wake-on: g Wake-on: d Link detected: yes}hj4sbah}(h]h ]h"]h$]h&]hhuh1jhhhKOhjubj)}(hAQrate speeds (2.5/5 Gb/s) will be displayed only with linux kernels > 4.10. But you can still use these speeds:: ethtool -s eth0 autoneg off speed 2500h](j])}(hqAQrate speeds (2.5/5 Gb/s) will be displayed only with linux kernels > 4.10. But you can still use these speeds::h]hpAQrate speeds (2.5/5 Gb/s) will be displayed only with linux kernels > 4.10. But you can still use these speeds:}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKohjBubj)}(hðtool -s eth0 autoneg off speed 2500h]hðtool -s eth0 autoneg off speed 2500}hjTsbah}(h]h ]h"]h$]h&]hhuh1jhhhKrhjBubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKIhjhhubeh}(h]viewing-adapter-settingsah ]h"]viewing adapter settingsah$]h&]uh1jGhjhhhhhKGubjH)}(hhh](jM)}(hViewing adapter informationh]hViewing adapter information}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjvhhhhhKuubj)}(hX-:: ethtool -i Output example:: driver: atlantic version: 5.2.0-050200rc5-generic-kern firmware-version: 3.1.78 expansion-rom-version: bus-info: 0000:01:00.0 supports-statistics: yes supports-test: no supports-eeprom-access: no supports-register-dump: yes supports-priv-flags: no h](j)}(hethtool -i h]hethtool -i }hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKyhjubj])}(hOutput example::h]hOutput example:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhK{hjubj)}(hdriver: atlantic version: 5.2.0-050200rc5-generic-kern firmware-version: 3.1.78 expansion-rom-version: bus-info: 0000:01:00.0 supports-statistics: yes supports-test: no supports-eeprom-access: no supports-register-dump: yes supports-priv-flags: noh]hdriver: atlantic version: 5.2.0-050200rc5-generic-kern firmware-version: 3.1.78 expansion-rom-version: bus-info: 0000:01:00.0 supports-statistics: yes supports-test: no supports-eeprom-access: no supports-register-dump: yes supports-priv-flags: no}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhK}hjubeh}(h]h ]h"]h$]h&]uh1jhhhKwhjvhhubeh}(h]viewing-adapter-informationah ]h"]viewing adapter informationah$]h&]uh1jGhjhhhhhKuubjH)}(hhh](jM)}(h#Viewing Ethernet adapter statisticsh]h#Viewing Ethernet adapter statistics}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhKubj)}(hX:: ethtool -S Output example:: NIC statistics: InPackets: 13238607 InUCast: 13293852 InMCast: 52 InBCast: 3 InErrors: 0 OutPackets: 23703019 OutUCast: 23704941 OutMCast: 67 OutBCast: 11 InUCastOctects: 213182760 OutUCastOctects: 22698443 InMCastOctects: 6600 OutMCastOctects: 8776 InBCastOctects: 192 OutBCastOctects: 704 InOctects: 2131839552 OutOctects: 226938073 InPacketsDma: 95532300 OutPacketsDma: 59503397 InOctetsDma: 1137102462 OutOctetsDma: 2394339518 InDroppedDma: 0 Queue[0] InPackets: 23567131 Queue[0] OutPackets: 20070028 Queue[0] InJumboPackets: 0 Queue[0] InLroPackets: 0 Queue[0] InErrors: 0 Queue[1] InPackets: 45428967 Queue[1] OutPackets: 11306178 Queue[1] InJumboPackets: 0 Queue[1] InLroPackets: 0 Queue[1] InErrors: 0 Queue[2] InPackets: 3187011 Queue[2] OutPackets: 13080381 Queue[2] InJumboPackets: 0 Queue[2] InLroPackets: 0 Queue[2] InErrors: 0 Queue[3] InPackets: 23349136 Queue[3] OutPackets: 15046810 Queue[3] InJumboPackets: 0 Queue[3] InLroPackets: 0 Queue[3] InErrors: 0 h](j)}(hethtool -S h]hethtool -S }hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubj])}(hOutput example::h]hOutput example:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjubj)}(hXKNIC statistics: InPackets: 13238607 InUCast: 13293852 InMCast: 52 InBCast: 3 InErrors: 0 OutPackets: 23703019 OutUCast: 23704941 OutMCast: 67 OutBCast: 11 InUCastOctects: 213182760 OutUCastOctects: 22698443 InMCastOctects: 6600 OutMCastOctects: 8776 InBCastOctects: 192 OutBCastOctects: 704 InOctects: 2131839552 OutOctects: 226938073 InPacketsDma: 95532300 OutPacketsDma: 59503397 InOctetsDma: 1137102462 OutOctetsDma: 2394339518 InDroppedDma: 0 Queue[0] InPackets: 23567131 Queue[0] OutPackets: 20070028 Queue[0] InJumboPackets: 0 Queue[0] InLroPackets: 0 Queue[0] InErrors: 0 Queue[1] InPackets: 45428967 Queue[1] OutPackets: 11306178 Queue[1] InJumboPackets: 0 Queue[1] InLroPackets: 0 Queue[1] InErrors: 0 Queue[2] InPackets: 3187011 Queue[2] OutPackets: 13080381 Queue[2] InJumboPackets: 0 Queue[2] InLroPackets: 0 Queue[2] InErrors: 0 Queue[3] InPackets: 23349136 Queue[3] OutPackets: 15046810 Queue[3] InJumboPackets: 0 Queue[3] InLroPackets: 0 Queue[3] InErrors: 0h]hXKNIC statistics: InPackets: 13238607 InUCast: 13293852 InMCast: 52 InBCast: 3 InErrors: 0 OutPackets: 23703019 OutUCast: 23704941 OutMCast: 67 OutBCast: 11 InUCastOctects: 213182760 OutUCastOctects: 22698443 InMCastOctects: 6600 OutMCastOctects: 8776 InBCastOctects: 192 OutBCastOctects: 704 InOctects: 2131839552 OutOctects: 226938073 InPacketsDma: 95532300 OutPacketsDma: 59503397 InOctetsDma: 1137102462 OutOctetsDma: 2394339518 InDroppedDma: 0 Queue[0] InPackets: 23567131 Queue[0] OutPackets: 20070028 Queue[0] InJumboPackets: 0 Queue[0] InLroPackets: 0 Queue[0] InErrors: 0 Queue[1] InPackets: 45428967 Queue[1] OutPackets: 11306178 Queue[1] InJumboPackets: 0 Queue[1] InLroPackets: 0 Queue[1] InErrors: 0 Queue[2] InPackets: 3187011 Queue[2] OutPackets: 13080381 Queue[2] InJumboPackets: 0 Queue[2] InLroPackets: 0 Queue[2] InErrors: 0 Queue[3] InPackets: 23349136 Queue[3] OutPackets: 15046810 Queue[3] InJumboPackets: 0 Queue[3] InLroPackets: 0 Queue[3] InErrors: 0}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubeh}(h]#viewing-ethernet-adapter-statisticsah ]h"]#viewing ethernet adapter statisticsah$]h&]uh1jGhjhhhhhKubjH)}(hhh](jM)}(hInterrupt coalescing supporth]hInterrupt coalescing support}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhKubj)}(hXITR mode, TX/RX coalescing timings could be viewed with:: ethtool -c and changed with:: ethtool -C tx-usecs rx-usecs To disable coalescing:: ethtool -C tx-usecs 0 rx-usecs 0 tx-max-frames 1 tx-max-frames 1 h](j])}(h9ITR mode, TX/RX coalescing timings could be viewed with::h]h8ITR mode, TX/RX coalescing timings could be viewed with:}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj!ubj)}(hethtool -c h]hethtool -c }hj3sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhj!ubj])}(hand changed with::h]hand changed with:}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj!ubj)}(h3ethtool -C tx-usecs rx-usecs h]h3ethtool -C tx-usecs rx-usecs }hjOsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhj!ubj])}(hTo disable coalescing::h]hTo disable coalescing:}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj!ubj)}(hGethtool -C tx-usecs 0 rx-usecs 0 tx-max-frames 1 tx-max-frames 1h]hGethtool -C tx-usecs 0 rx-usecs 0 tx-max-frames 1 tx-max-frames 1}hjksbah}(h]h ]h"]h$]h&]hhuh1jhhhKhj!ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubeh}(h]interrupt-coalescing-supportah ]h"]interrupt coalescing supportah$]h&]uh1jGhjhhhhhKubjH)}(hhh](jM)}(hWake on LAN supporth]hWake on LAN support}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhKubj)}(hhWOL support by magic packet:: ethtool -s wol g To disable WOL:: ethtool -s wol d h](j])}(hWOL support by magic packet::h]hWOL support by magic packet:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjubj)}(hethtool -s wol gh]hethtool -s wol g}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubj])}(hTo disable WOL::h]hTo disable WOL:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjubj)}(hethtool -s wol dh]hethtool -s wol d}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubeh}(h]wake-on-lan-supportah ]h"]wake on lan supportah$]h&]uh1jGhjhhhhhKubjH)}(hhh](jM)}(h&Set and check the driver message levelh]h&Set and check the driver message level}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhKubj)}(hXSet message level :: ethtool -s msglvl Level values: ====== ============================= 0x0001 general driver status. 0x0002 hardware probing. 0x0004 link state. 0x0008 periodic status check. 0x0010 interface being brought down. 0x0020 interface being brought up. 0x0040 receive error. 0x0080 transmit error. 0x0200 interrupt handling. 0x0400 transmit completion. 0x0800 receive completion. 0x1000 packet contents. 0x2000 hardware status. 0x4000 Wake-on-LAN status. ====== ============================= By default, the level of debugging messages is set 0x0001(general driver status). Check message level :: ethtool | grep "Current message level" If you want to disable the output of messages:: ethtool -s msglvl 0 h](j])}(hSet message levelh]hSet message level}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjubj)}(h ethtool -s msglvl h]h ethtool -s msglvl }hj sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubj])}(h Level values:h]h Level values:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j+ hj( ubj, )}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j+ hj( ubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]j])}(h0x0001h]h0x0001}(hjP hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjM ubah}(h]h ]h"]h$]h&]uh1jK hjH ubjL )}(hhh]j])}(hgeneral driver status.h]hgeneral driver status.}(hjg hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjd ubah}(h]h ]h"]h$]h&]uh1jK hjH ubeh}(h]h ]h"]h$]h&]uh1jF hjC ubjG )}(hhh](jL )}(hhh]j])}(h0x0002h]h0x0002}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubjL )}(hhh]j])}(hhardware probing.h]hhardware probing.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubeh}(h]h ]h"]h$]h&]uh1jF hjC ubjG )}(hhh](jL )}(hhh]j])}(h0x0004h]h0x0004}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubjL )}(hhh]j])}(h link state.h]h link state.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubeh}(h]h ]h"]h$]h&]uh1jF hjC ubjG )}(hhh](jL )}(hhh]j])}(h0x0008h]h0x0008}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubjL )}(hhh]j])}(hperiodic status check.h]hperiodic status check.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubeh}(h]h ]h"]h$]h&]uh1jF hjC ubjG )}(hhh](jL )}(hhh]j])}(h0x0010h]h0x0010}(hj, hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj) ubah}(h]h ]h"]h$]h&]uh1jK hj& ubjL )}(hhh]j])}(hinterface being brought down.h]hinterface being brought down.}(hjC hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj@ ubah}(h]h ]h"]h$]h&]uh1jK hj& ubeh}(h]h ]h"]h$]h&]uh1jF hjC ubjG )}(hhh](jL )}(hhh]j])}(h0x0020h]h0x0020}(hjc hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj` ubah}(h]h ]h"]h$]h&]uh1jK hj] ubjL )}(hhh]j])}(hinterface being brought up.h]hinterface being brought up.}(hjz hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjw ubah}(h]h ]h"]h$]h&]uh1jK hj] ubeh}(h]h ]h"]h$]h&]uh1jF hjC ubjG )}(hhh](jL )}(hhh]j])}(h0x0040h]h0x0040}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubjL )}(hhh]j])}(hreceive error.h]hreceive error.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubeh}(h]h ]h"]h$]h&]uh1jF hjC ubjG )}(hhh](jL )}(hhh]j])}(h0x0080h]h0x0080}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubjL )}(hhh]j])}(htransmit error.h]htransmit error.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubeh}(h]h ]h"]h$]h&]uh1jF hjC ubjG )}(hhh](jL )}(hhh]j])}(h0x0200h]h0x0200}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubjL )}(hhh]j])}(hinterrupt handling.h]hinterrupt handling.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubeh}(h]h ]h"]h$]h&]uh1jF hjC ubjG )}(hhh](jL )}(hhh]j])}(h0x0400h]h0x0400}(hj? hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj< ubah}(h]h ]h"]h$]h&]uh1jK hj9 ubjL )}(hhh]j])}(htransmit completion.h]htransmit completion.}(hjV hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjS ubah}(h]h ]h"]h$]h&]uh1jK hj9 ubeh}(h]h ]h"]h$]h&]uh1jF hjC ubjG )}(hhh](jL )}(hhh]j])}(h0x0800h]h0x0800}(hjv hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjs ubah}(h]h ]h"]h$]h&]uh1jK hjp ubjL )}(hhh]j])}(hreceive completion.h]hreceive completion.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hjp ubeh}(h]h ]h"]h$]h&]uh1jF hjC ubjG )}(hhh](jL )}(hhh]j])}(h0x1000h]h0x1000}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubjL )}(hhh]j])}(hpacket contents.h]hpacket contents.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubeh}(h]h ]h"]h$]h&]uh1jF hjC ubjG )}(hhh](jL )}(hhh]j])}(h0x2000h]h0x2000}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubjL )}(hhh]j])}(hhardware status.h]hhardware status.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubeh}(h]h ]h"]h$]h&]uh1jF hjC ubjG )}(hhh](jL )}(hhh]j])}(h0x4000h]h0x4000}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubjL )}(hhh]j])}(hWake-on-LAN status.h]hWake-on-LAN status.}(hj2 hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhj/ ubah}(h]h ]h"]h$]h&]uh1jK hj ubeh}(h]h ]h"]h$]h&]uh1jF hjC ubeh}(h]h ]h"]h$]h&]uh1jA hj( ubeh}(h]h ]h"]h$]h&]colsKuh1j& hj# ubah}(h]h ]h"]h$]h&]uh1j! hjubj])}(hQBy default, the level of debugging messages is set 0x0001(general driver status).h]hQBy default, the level of debugging messages is set 0x0001(general driver status).}(hj_ hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjubj])}(hCheck message levelh]hCheck message level}(hjm hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjubj)}(h-ethtool | grep "Current message level"h]h-ethtool | grep "Current message level"}hj{ sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubj])}(h/If you want to disable the output of messages::h]h.If you want to disable the output of messages:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhKhjubj)}(hethtool -s msglvl 0h]hethtool -s msglvl 0}hj sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubeh}(h]&set-and-check-the-driver-message-levelah ]h"]&set and check the driver message levelah$]h&]uh1jGhjhhhhhKubjH)}(hhh](jM)}(hRX flow rules (ntuple filters)h]hRX flow rules (ntuple filters)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj hhhhhMubj)}(hX5There are separate rules supported, that applies in that order: 1. 16 VLAN ID rules 2. 16 L2 EtherType rules 3. 8 L3/L4 5-Tuple rules The driver utilizes the ethtool interface for configuring ntuple filters, via ``ethtool -N ``. To enable or disable the RX flow rules:: ethtool -K ethX ntuple When disabling ntuple filters, all the user programmed filters are flushed from the driver cache and hardware. All needed filters must be re-added when ntuple is re-enabled. Because of the fixed order of the rules, the location of filters is also fixed: - Locations 0 - 15 for VLAN ID filters - Locations 16 - 31 for L2 EtherType filters - Locations 32 - 39 for L3/L4 5-tuple filters (locations 32, 36 for IPv6) The L3/L4 5-tuple (protocol, source and destination IP address, source and destination TCP/UDP/SCTP port) is compared against 8 filters. For IPv4, up to 8 source and destination addresses can be matched. For IPv6, up to 2 pairs of addresses can be supported. Source and destination ports are only compared for TCP/UDP/SCTP packets. To add a filter that directs packet to queue 5, use ``<-N|-U|--config-nfc|--config-ntuple>`` switch:: ethtool -N flow-type udp4 src-ip 10.0.0.1 dst-ip 10.0.0.2 src-port 2000 dst-port 2001 action 5 - action is the queue number. - loc is the rule number. For ``flow-type ip4|udp4|tcp4|sctp4|ip6|udp6|tcp6|sctp6`` you must set the loc number within 32 - 39. For ``flow-type ip4|udp4|tcp4|sctp4|ip6|udp6|tcp6|sctp6`` you can set 8 rules for traffic IPv4 or you can set 2 rules for traffic IPv6. Loc number traffic IPv6 is 32 and 36. At the moment you can not use IPv4 and IPv6 filters at the same time. Example filter for IPv6 filter traffic:: sudo ethtool -N flow-type tcp6 src-ip 2001:db8:0:f101::1 dst-ip 2001:db8:0:f101::2 action 1 loc 32 sudo ethtool -N flow-type ip6 src-ip 2001:db8:0:f101::2 dst-ip 2001:db8:0:f101::5 action -1 loc 36 Example filter for IPv4 filter traffic:: sudo ethtool -N flow-type udp4 src-ip 10.0.0.4 dst-ip 10.0.0.7 src-port 2000 dst-port 2001 loc 32 sudo ethtool -N flow-type tcp4 src-ip 10.0.0.3 dst-ip 10.0.0.9 src-port 2000 dst-port 2001 loc 33 sudo ethtool -N flow-type ip4 src-ip 10.0.0.6 dst-ip 10.0.0.4 loc 34 If you set action -1, then all traffic corresponding to the filter will be discarded. The maximum value action is 31. The VLAN filter (VLAN id) is compared against 16 filters. VLAN id must be accompanied by mask 0xF000. That is to distinguish VLAN filter from L2 Ethertype filter with UserPriority since both User Priority and VLAN ID are passed in the same 'vlan' parameter. To add a filter that directs packets from VLAN 2001 to queue 5:: ethtool -N flow-type ip4 vlan 2001 m 0xF000 action 1 loc 0 L2 EtherType filters allows filter packet by EtherType field or both EtherType and User Priority (PCP) field of 802.1Q. UserPriority (vlan) parameter must be accompanied by mask 0x1FFF. That is to distinguish VLAN filter from L2 Ethertype filter with UserPriority since both User Priority and VLAN ID are passed in the same 'vlan' parameter. To add a filter that directs IP4 packess of priority 3 to queue 3:: ethtool -N flow-type ether proto 0x800 vlan 0x600 m 0x1FFF action 3 loc 16 To see the list of filters currently present:: ethtool <-u|-n|--show-nfc|--show-ntuple> Rules may be deleted from the table itself. This is done using:: sudo ethtool <-N|-U|--config-nfc|--config-ntuple> delete - loc is the rule number to be deleted. Rx filters is an interface to load the filter table that funnels all flow into queue 0 unless an alternative queue is specified using "action". In that case, any flow that matches the filter criteria will be directed to the appropriate queue. RX filters is supported on all kernels 2.6.30 and later. h](j])}(h?There are separate rules supported, that applies in that order:h]h?There are separate rules supported, that applies in that order:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj ubhenumerated_list)}(hhh](h list_item)}(h16 VLAN ID rulesh]j])}(hj h]h16 VLAN ID rules}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(h16 L2 EtherType rulesh]j])}(hj h]h16 L2 EtherType rules}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(h8 L3/L4 5-Tuple rules h]j])}(h8 L3/L4 5-Tuple rulesh]h8 L3/L4 5-Tuple rules}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix.uh1j hj ubj])}(hoThe driver utilizes the ethtool interface for configuring ntuple filters, via ``ethtool -N ``.h](hNThe driver utilizes the ethtool interface for configuring ntuple filters, via }(hj. hhhNhNubhliteral)}(h ``ethtool -N ``h]hethtool -N }(hj8 hhhNhNubah}(h]h ]h"]h$]h&]uh1j6 hj. ubh.}(hj. hhhNhNubeh}(h]h ]h"]h$]h&]uh1j\hhhM hj ubj])}(h(To enable or disable the RX flow rules::h]h'To enable or disable the RX flow rules:}(hjP hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhM hj ubj)}(hethtool -K ethX ntuple h]hethtool -K ethX ntuple }hj^ sbah}(h]h ]h"]h$]h&]hhuh1jhhhMhj ubj])}(hWhen disabling ntuple filters, all the user programmed filters are flushed from the driver cache and hardware. All needed filters must be re-added when ntuple is re-enabled.h]hWhen disabling ntuple filters, all the user programmed filters are flushed from the driver cache and hardware. All needed filters must be re-added when ntuple is re-enabled.}(hjl hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj ubj])}(hOBecause of the fixed order of the rules, the location of filters is also fixed:h]hOBecause of the fixed order of the rules, the location of filters is also fixed:}(hjz hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj ubh bullet_list)}(hhh](j )}(h$Locations 0 - 15 for VLAN ID filtersh]j])}(hj h]h$Locations 0 - 15 for VLAN ID filters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(h*Locations 16 - 31 for L2 EtherType filtersh]j])}(hj h]h*Locations 16 - 31 for L2 EtherType filters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hHLocations 32 - 39 for L3/L4 5-tuple filters (locations 32, 36 for IPv6) h]j])}(hGLocations 32 - 39 for L3/L4 5-tuple filters (locations 32, 36 for IPv6)h]hGLocations 32 - 39 for L3/L4 5-tuple filters (locations 32, 36 for IPv6)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]bullet-uh1j hhhMhj ubj])}(hXKThe L3/L4 5-tuple (protocol, source and destination IP address, source and destination TCP/UDP/SCTP port) is compared against 8 filters. For IPv4, up to 8 source and destination addresses can be matched. For IPv6, up to 2 pairs of addresses can be supported. Source and destination ports are only compared for TCP/UDP/SCTP packets.h]hXKThe L3/L4 5-tuple (protocol, source and destination IP address, source and destination TCP/UDP/SCTP port) is compared against 8 filters. For IPv4, up to 8 source and destination addresses can be matched. For IPv6, up to 2 pairs of addresses can be supported. Source and destination ports are only compared for TCP/UDP/SCTP packets.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj ubj])}(heTo add a filter that directs packet to queue 5, use ``<-N|-U|--config-nfc|--config-ntuple>`` switch::h](h4To add a filter that directs packet to queue 5, use }(hj hhhNhNubj7 )}(h(``<-N|-U|--config-nfc|--config-ntuple>``h]h$<-N|-U|--config-nfc|--config-ntuple>}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j6 hj ubh switch:}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1j\hhhM!hj ubj)}(hnethtool -N flow-type udp4 src-ip 10.0.0.1 dst-ip 10.0.0.2 src-port 2000 dst-port 2001 action 5 h]hnethtool -N flow-type udp4 src-ip 10.0.0.1 dst-ip 10.0.0.2 src-port 2000 dst-port 2001 action 5 }hj sbah}(h]h ]h"]h$]h&]hhuh1jhhhM$hj ubj )}(hhh](j )}(haction is the queue number.h]j])}(hjh]haction is the queue number.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhM&hjubah}(h]h ]h"]h$]h&]uh1j hjubj )}(hloc is the rule number. h]j])}(hloc is the rule number.h]hloc is the rule number.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhM'hj1ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]j j uh1j hhhM&hj ubj])}(hXYFor ``flow-type ip4|udp4|tcp4|sctp4|ip6|udp6|tcp6|sctp6`` you must set the loc number within 32 - 39. For ``flow-type ip4|udp4|tcp4|sctp4|ip6|udp6|tcp6|sctp6`` you can set 8 rules for traffic IPv4 or you can set 2 rules for traffic IPv6. Loc number traffic IPv6 is 32 and 36. At the moment you can not use IPv4 and IPv6 filters at the same time.h](hFor }(hjOhhhNhNubj7 )}(h5``flow-type ip4|udp4|tcp4|sctp4|ip6|udp6|tcp6|sctp6``h]h1flow-type ip4|udp4|tcp4|sctp4|ip6|udp6|tcp6|sctp6}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1j6 hjOubh1 you must set the loc number within 32 - 39. For }(hjOhhhNhNubj7 )}(h5``flow-type ip4|udp4|tcp4|sctp4|ip6|udp6|tcp6|sctp6``h]h1flow-type ip4|udp4|tcp4|sctp4|ip6|udp6|tcp6|sctp6}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1j6 hjOubh you can set 8 rules for traffic IPv4 or you can set 2 rules for traffic IPv6. Loc number traffic IPv6 is 32 and 36. At the moment you can not use IPv4 and IPv6 filters at the same time.}(hjOhhhNhNubeh}(h]h ]h"]h$]h&]uh1j\hhhM)hj ubj])}(h(Example filter for IPv6 filter traffic::h]h'Example filter for IPv6 filter traffic:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhM0hj ubj)}(hsudo ethtool -N flow-type tcp6 src-ip 2001:db8:0:f101::1 dst-ip 2001:db8:0:f101::2 action 1 loc 32 sudo ethtool -N flow-type ip6 src-ip 2001:db8:0:f101::2 dst-ip 2001:db8:0:f101::5 action -1 loc 36h]hsudo ethtool -N flow-type tcp6 src-ip 2001:db8:0:f101::1 dst-ip 2001:db8:0:f101::2 action 1 loc 32 sudo ethtool -N flow-type ip6 src-ip 2001:db8:0:f101::2 dst-ip 2001:db8:0:f101::5 action -1 loc 36}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhM2hj ubj])}(h(Example filter for IPv4 filter traffic::h]h'Example filter for IPv4 filter traffic:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhM5hj ubj)}(hXsudo ethtool -N flow-type udp4 src-ip 10.0.0.4 dst-ip 10.0.0.7 src-port 2000 dst-port 2001 loc 32 sudo ethtool -N flow-type tcp4 src-ip 10.0.0.3 dst-ip 10.0.0.9 src-port 2000 dst-port 2001 loc 33 sudo ethtool -N flow-type ip4 src-ip 10.0.0.6 dst-ip 10.0.0.4 loc 34h]hXsudo ethtool -N flow-type udp4 src-ip 10.0.0.4 dst-ip 10.0.0.7 src-port 2000 dst-port 2001 loc 32 sudo ethtool -N flow-type tcp4 src-ip 10.0.0.3 dst-ip 10.0.0.9 src-port 2000 dst-port 2001 loc 33 sudo ethtool -N flow-type ip4 src-ip 10.0.0.6 dst-ip 10.0.0.4 loc 34}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhM7hj ubj])}(hUIf you set action -1, then all traffic corresponding to the filter will be discarded.h]hUIf you set action -1, then all traffic corresponding to the filter will be discarded.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhM;hj ubj])}(hThe maximum value action is 31.h]hThe maximum value action is 31.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhM=hj ubj])}(hXThe VLAN filter (VLAN id) is compared against 16 filters. VLAN id must be accompanied by mask 0xF000. That is to distinguish VLAN filter from L2 Ethertype filter with UserPriority since both User Priority and VLAN ID are passed in the same 'vlan' parameter.h]hXThe VLAN filter (VLAN id) is compared against 16 filters. VLAN id must be accompanied by mask 0xF000. That is to distinguish VLAN filter from L2 Ethertype filter with UserPriority since both User Priority and VLAN ID are passed in the same ‘vlan’ parameter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhM@hj ubj])}(h@To add a filter that directs packets from VLAN 2001 to queue 5::h]h?To add a filter that directs packets from VLAN 2001 to queue 5:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMEhj ubj)}(hAethtool -N flow-type ip4 vlan 2001 m 0xF000 action 1 loc 0h]hAethtool -N flow-type ip4 vlan 2001 m 0xF000 action 1 loc 0}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMGhj ubj])}(hXUL2 EtherType filters allows filter packet by EtherType field or both EtherType and User Priority (PCP) field of 802.1Q. UserPriority (vlan) parameter must be accompanied by mask 0x1FFF. That is to distinguish VLAN filter from L2 Ethertype filter with UserPriority since both User Priority and VLAN ID are passed in the same 'vlan' parameter.h]hXYL2 EtherType filters allows filter packet by EtherType field or both EtherType and User Priority (PCP) field of 802.1Q. UserPriority (vlan) parameter must be accompanied by mask 0x1FFF. That is to distinguish VLAN filter from L2 Ethertype filter with UserPriority since both User Priority and VLAN ID are passed in the same ‘vlan’ parameter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMJhj ubj])}(hCTo add a filter that directs IP4 packess of priority 3 to queue 3::h]hBTo add a filter that directs IP4 packess of priority 3 to queue 3:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMPhj ubj)}(hQethtool -N flow-type ether proto 0x800 vlan 0x600 m 0x1FFF action 3 loc 16h]hQethtool -N flow-type ether proto 0x800 vlan 0x600 m 0x1FFF action 3 loc 16}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMRhj ubj])}(h.To see the list of filters currently present::h]h-To see the list of filters currently present:}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMThj ubj)}(h/ethtool <-u|-n|--show-nfc|--show-ntuple> h]h/ethtool <-u|-n|--show-nfc|--show-ntuple> }hj7sbah}(h]h ]h"]h$]h&]hhuh1jhhhMVhj ubj])}(h@Rules may be deleted from the table itself. This is done using::h]h?Rules may be deleted from the table itself. This is done using:}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMXhj ubj)}(hEsudo ethtool <-N|-U|--config-nfc|--config-ntuple> delete h]hEsudo ethtool <-N|-U|--config-nfc|--config-ntuple> delete }hjSsbah}(h]h ]h"]h$]h&]hhuh1jhhhMZhj ubj )}(hhh]j )}(h&loc is the rule number to be deleted. h]j])}(h%loc is the rule number to be deleted.h]h%loc is the rule number to be deleted.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhM\hjdubah}(h]h ]h"]h$]h&]uh1j hjaubah}(h]h ]h"]h$]h&]j j uh1j hhhM\hj ubj])}(hX+Rx filters is an interface to load the filter table that funnels all flow into queue 0 unless an alternative queue is specified using "action". In that case, any flow that matches the filter criteria will be directed to the appropriate queue. RX filters is supported on all kernels 2.6.30 and later.h]hX/Rx filters is an interface to load the filter table that funnels all flow into queue 0 unless an alternative queue is specified using “action”. In that case, any flow that matches the filter criteria will be directed to the appropriate queue. RX filters is supported on all kernels 2.6.30 and later.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhM^hj ubeh}(h]h ]h"]h$]h&]uh1jhhhMhj hhubeh}(h]rx-flow-rules-ntuple-filtersah ]h"]rx flow rules (ntuple filters)ah$]h&]uh1jGhjhhhhhMubjH)}(hhh](jM)}(h RSS for UDPh]h RSS for UDP}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhMdubj)}(hCurrently, NIC does not support RSS for fragmented IP packets, which leads to incorrect working of RSS for fragmented UDP traffic. To disable RSS for UDP the RX Flow L3/L4 rule may be used. Example:: ethtool -N eth0 flow-type udp4 action 0 loc 32 h](j])}(hCurrently, NIC does not support RSS for fragmented IP packets, which leads to incorrect working of RSS for fragmented UDP traffic. To disable RSS for UDP the RX Flow L3/L4 rule may be used.h]hCurrently, NIC does not support RSS for fragmented IP packets, which leads to incorrect working of RSS for fragmented UDP traffic. To disable RSS for UDP the RX Flow L3/L4 rule may be used.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMfhjubj])}(h Example::h]hExample:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMjhjubj)}(h.ethtool -N eth0 flow-type udp4 action 0 loc 32h]h.ethtool -N eth0 flow-type udp4 action 0 loc 32}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMlhjubeh}(h]h ]h"]h$]h&]uh1jhhhMfhjhhubeh}(h] rss-for-udpah ]h"] rss for udpah$]h&]uh1jGhjhhhhhMdubjH)}(hhh](jM)}(hUDP GSO hardware offloadh]hUDP GSO hardware offload}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhMoubj)}(hXUDP GSO allows to boost UDP tx rates by offloading UDP headers allocation into hardware. A special userspace socket option is required for this, could be validated with /kernel/tools/testing/selftests/net/:: udpgso_bench_tx -u -4 -D 10.0.1.1 -s 6300 -S 100 Will cause sending out of 100 byte sized UDP packets formed from single 6300 bytes user buffer. UDP GSO is configured by:: ethtool -K eth0 tx-udp-segmentation on h](j])}(hUDP GSO allows to boost UDP tx rates by offloading UDP headers allocation into hardware. A special userspace socket option is required for this, could be validated with /kernel/tools/testing/selftests/net/::h]hUDP GSO allows to boost UDP tx rates by offloading UDP headers allocation into hardware. A special userspace socket option is required for this, could be validated with /kernel/tools/testing/selftests/net/:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMqhjubj)}(h0udpgso_bench_tx -u -4 -D 10.0.1.1 -s 6300 -S 100h]h0udpgso_bench_tx -u -4 -D 10.0.1.1 -s 6300 -S 100}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMuhjubj])}(h_Will cause sending out of 100 byte sized UDP packets formed from single 6300 bytes user buffer.h]h_Will cause sending out of 100 byte sized UDP packets formed from single 6300 bytes user buffer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMwhjubj])}(hUDP GSO is configured by::h]hUDP GSO is configured by:}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMzhjubj)}(hðtool -K eth0 tx-udp-segmentation onh]hðtool -K eth0 tx-udp-segmentation on}hj8sbah}(h]h ]h"]h$]h&]hhuh1jhhhM|hjubeh}(h]h ]h"]h$]h&]uh1jhhhMqhjhhubeh}(h]udp-gso-hardware-offloadah ]h"]udp gso hardware offloadah$]h&]uh1jGhjhhhhhMoubjH)}(hhh](jM)}(hPrivate flags (testing)h]hPrivate flags (testing)}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjThhhhhMubj)}(hXAtlantic driver supports private flags for hardware custom features:: $ ethtool --show-priv-flags ethX Private flags for ethX: DMASystemLoopback : off PKTSystemLoopback : off DMANetworkLoopback : off PHYInternalLoopback: off PHYExternalLoopback: off Example:: $ ethtool --set-priv-flags ethX DMASystemLoopback on DMASystemLoopback: DMA Host loopback. PKTSystemLoopback: Packet buffer host loopback. DMANetworkLoopback: Network side loopback on DMA block. PHYInternalLoopback: Internal loopback on Phy. PHYExternalLoopback: External loopback on Phy (with loopback ethernet cable). h](j])}(hEAtlantic driver supports private flags for hardware custom features::h]hDAtlantic driver supports private flags for hardware custom features:}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjeubj)}(h$ ethtool --show-priv-flags ethX Private flags for ethX: DMASystemLoopback : off PKTSystemLoopback : off DMANetworkLoopback : off PHYInternalLoopback: off PHYExternalLoopback: offh]h$ ethtool --show-priv-flags ethX Private flags for ethX: DMASystemLoopback : off PKTSystemLoopback : off DMANetworkLoopback : off PHYInternalLoopback: off PHYExternalLoopback: off}hjwsbah}(h]h ]h"]h$]h&]hhuh1jhhhMhjeubj])}(h Example::h]hExample:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjeubj)}(h4$ ethtool --set-priv-flags ethX DMASystemLoopback onh]h4$ ethtool --set-priv-flags ethX DMASystemLoopback on}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMhjeubj])}(hXDMASystemLoopback: DMA Host loopback. PKTSystemLoopback: Packet buffer host loopback. DMANetworkLoopback: Network side loopback on DMA block. PHYInternalLoopback: Internal loopback on Phy. PHYExternalLoopback: External loopback on Phy (with loopback ethernet cable).Zh]hXDMASystemLoopback: DMA Host loopback. PKTSystemLoopback: Packet buffer host loopback. DMANetworkLoopback: Network side loopback on DMA block. PHYInternalLoopback: Internal loopback on Phy. PHYExternalLoopback: External loopback on Phy (with loopback ethernet cable).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjeubeh}(h]h ]h"]h$]h&]uh1jhhhMhjThhubeh}(h]private-flags-testingah ]h"]private flags (testing)ah$]h&]uh1jGhjhhhhhMubeh}(h]supported-ethtool-optionsah ]h"]supported ethtool optionsah$]h&]uh1jGhjIhhhhhKDubjH)}(hhh](jM)}(hCommand Line Parametersh]hCommand Line Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhMubj])}(hGThe following command line parameters are available on atlantic driver:h]hGThe following command line parameters are available on atlantic driver:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubjH)}(hhh](jM)}(h!aq_itr -Interrupt throttling modeh]h!aq_itr -Interrupt throttling mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhMubj])}(hAccepted values: 0, 1, 0xFFFFh]hAccepted values: 0, 1, 0xFFFF}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubj])}(hDefault value: 0xFFFFh]hDefault value: 0xFFFF}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubj" )}(hhh]j' )}(hhh](j, )}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j+ hjubj, )}(hhh]h}(h]h ]h"]h$]h&]colwidthK>uh1j+ hjubjB )}(hhh](jG )}(hhh](jL )}(hhh]j])}(h0h]h0}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj1ubah}(h]h ]h"]h$]h&]uh1jK hj.ubjL )}(hhh]j])}(hDisable interrupt throttling.h]hDisable interrupt throttling.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjHubah}(h]h ]h"]h$]h&]uh1jK hj.ubeh}(h]h ]h"]h$]h&]uh1jF hj+ubjG )}(hhh](jL )}(hhh]j])}(h1h]h1}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhubah}(h]h ]h"]h$]h&]uh1jK hjeubjL )}(hhh]j])}(h>Enable interrupt throttling and use specified tx and rx rates.h]h>Enable interrupt throttling and use specified tx and rx rates.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjubah}(h]h ]h"]h$]h&]uh1jK hjeubeh}(h]h ]h"]h$]h&]uh1jF hj+ubjG )}(hhh](jL )}(hhh]j])}(h0xFFFFh]h0xFFFF}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjubah}(h]h ]h"]h$]h&]uh1jK hjubjL )}(hhh]j])}(hnAuto throttling mode. Driver will choose the best RX and TX interrupt throttling settings based on link speed.h]hnAuto throttling mode. Driver will choose the best RX and TX interrupt throttling settings based on link speed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjubah}(h]h ]h"]h$]h&]uh1jK hjubeh}(h]h ]h"]h$]h&]uh1jF hj+ubeh}(h]h ]h"]h$]h&]uh1jA hjubeh}(h]h ]h"]h$]h&]colsKuh1j& hjubah}(h]h ]h"]h$]h&]uh1j! hjhhhhhNubeh}(h] aq-itr-interrupt-throttling-modeah ]h"]!aq_itr -interrupt throttling modeah$]h&]uh1jGhjhhhhhMubjH)}(hhh](jM)}(h&aq_itr_tx - TX interrupt throttle rateh]h&aq_itr_tx - TX interrupt throttle rate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhMubj])}(hAccepted values: 0 - 0x1FFh]hAccepted values: 0 - 0x1FF}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubj])}(hDefault value: 0h]hDefault value: 0}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubj])}(hTX side throttling in microseconds. Adapter will setup maximum interrupt delay to this value. Minimum interrupt delay will be a half of this valueh]hTX side throttling in microseconds. Adapter will setup maximum interrupt delay to this value. Minimum interrupt delay will be a half of this value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubeh}(h]$aq-itr-tx-tx-interrupt-throttle-rateah ]h"]&aq_itr_tx - tx interrupt throttle rateah$]h&]uh1jGhjhhhhhMubjH)}(hhh](jM)}(h&aq_itr_rx - RX interrupt throttle rateh]h&aq_itr_rx - RX interrupt throttle rate}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj1hhhhhMubj])}(hAccepted values: 0 - 0x1FFh]hAccepted values: 0 - 0x1FF}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj1hhubj])}(hDefault value: 0h]hDefault value: 0}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj1hhubj])}(hRX side throttling in microseconds. Adapter will setup maximum interrupt delay to this value. Minimum interrupt delay will be a half of this valueh]hRX side throttling in microseconds. Adapter will setup maximum interrupt delay to this value. Minimum interrupt delay will be a half of this value}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj1hhubj)}(hHITR settings could be changed in runtime by ethtool -c means (see below)h]j])}(hjnh]hHITR settings could be changed in runtime by ethtool -c means (see below)}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjlubah}(h]h ]h"]h$]h&]uh1jhj1hhhhhNubeh}(h]$aq-itr-rx-rx-interrupt-throttle-rateah ]h"]&aq_itr_rx - rx interrupt throttle rateah$]h&]uh1jGhjhhhhhMubeh}(h]command-line-parametersah ]h"]command line parametersah$]h&]uh1jGhjIhhhhhMubjH)}(hhh](jM)}(hConfig file parametersh]hConfig file parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhMubj])}(huFor some fine tuning and performance optimizations, some parameters can be changed in the {source_dir}/aq_cfg.h file.h]huFor some fine tuning and performance optimizations, some parameters can be changed in the {source_dir}/aq_cfg.h file.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubjH)}(hhh](jM)}(hAQ_CFG_RX_PAGEORDERh]hAQ_CFG_RX_PAGEORDER}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhMubj])}(hDefault value: 0h]hDefault value: 0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubj])}(hRX page order override. That's a power of 2 number of RX pages allocated for each descriptor. Received descriptor size is still limited by AQ_CFG_RX_FRAME_MAX.h]hRX page order override. That’s a power of 2 number of RX pages allocated for each descriptor. Received descriptor size is still limited by AQ_CFG_RX_FRAME_MAX.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubj])}(hOIncreasing pageorder makes page reuse better (actual on iommu enabled systems).h]hOIncreasing pageorder makes page reuse better (actual on iommu enabled systems).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubeh}(h]aq-cfg-rx-pageorderah ]h"]aq_cfg_rx_pageorderah$]h&]uh1jGhjhhhhhMubjH)}(hhh](jM)}(hAQ_CFG_RX_REFILL_THRESh]hAQ_CFG_RX_REFILL_THRES}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhMubj])}(hDefault value: 32h]hDefault value: 32}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubj])}(hRX refill threshold. RX path will not refill freed descriptors until the specified number of free descriptors is observed. Larger values may help better page reuse but may lead to packet drops as well.h]hRX refill threshold. RX path will not refill freed descriptors until the specified number of free descriptors is observed. Larger values may help better page reuse but may lead to packet drops as well.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubeh}(h]aq-cfg-rx-refill-thresah ]h"]aq_cfg_rx_refill_thresah$]h&]uh1jGhjhhhhhMubjH)}(hhh](jM)}(hAQ_CFG_VECS_DEFh]hAQ_CFG_VECS_DEF}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj*hhhhhMubj])}(hNumber of queuesh]hNumber of queues}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj*hhubj])}(h*Valid Range: 0 - 8 (up to AQ_CFG_VECS_MAX)h]h*Valid Range: 0 - 8 (up to AQ_CFG_VECS_MAX)}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj*hhubj])}(hDefault value: 8h]hDefault value: 8}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj*hhubj])}(hPNotice this value will be capped by the number of cores available on the system.h]hPNotice this value will be capped by the number of cores available on the system.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj*hhubeh}(h]aq-cfg-vecs-defah ]h"]aq_cfg_vecs_defah$]h&]uh1jGhjhhhhhMubjH)}(hhh](jM)}(hAQ_CFG_IS_RSS_DEFh]hAQ_CFG_IS_RSS_DEF}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj{hhhhhMubj])}(h#Enable/disable Receive Side Scalingh]h#Enable/disable Receive Side Scaling}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj{hhubj])}(hThis feature allows the adapter to distribute receive processing across multiple CPU-cores and to prevent from overloading a single CPU core.h]hThis feature allows the adapter to distribute receive processing across multiple CPU-cores and to prevent from overloading a single CPU core.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj{hhubj])}(h Valid valuesh]h Valid values}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj{hhubj" )}(hhh]j' )}(hhh](j, )}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j+ hjubj, )}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j+ hjubjB )}(hhh](jG )}(hhh](jL )}(hhh]j])}(hj6h]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjubah}(h]h ]h"]h$]h&]uh1jK hjubjL )}(hhh]j])}(hdisabledh]hdisabled}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjubah}(h]h ]h"]h$]h&]uh1jK hjubeh}(h]h ]h"]h$]h&]uh1jF hjubjG )}(hhh](jL )}(hhh]j])}(hjmh]h1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj ubah}(h]h ]h"]h$]h&]uh1jK hj ubjL )}(hhh]j])}(henabledh]henabled}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj"ubah}(h]h ]h"]h$]h&]uh1jK hj ubeh}(h]h ]h"]h$]h&]uh1jF hjubeh}(h]h ]h"]h$]h&]uh1jA hjubeh}(h]h ]h"]h$]h&]colsKuh1j& hjubah}(h]h ]h"]h$]h&]uh1j! hj{hhhhhNubj])}(hDefault value: 1h]hDefault value: 1}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj{hhubeh}(h]aq-cfg-is-rss-defah ]h"]aq_cfg_is_rss_defah$]h&]uh1jGhjhhhhhMubjH)}(hhh](jM)}(hAQ_CFG_NUM_RSS_QUEUES_DEFh]hAQ_CFG_NUM_RSS_QUEUES_DEF}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhhMubj])}(h)Number of queues for Receive Side Scalingh]h)Number of queues for Receive Side Scaling}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhhubj])}(h*Valid Range: 0 - 8 (up to AQ_CFG_VECS_DEF)h]h*Valid Range: 0 - 8 (up to AQ_CFG_VECS_DEF)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhhubj])}(hDefault value: AQ_CFG_VECS_DEFh]hDefault value: AQ_CFG_VECS_DEF}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhhubeh}(h]aq-cfg-num-rss-queues-defah ]h"]aq_cfg_num_rss_queues_defah$]h&]uh1jGhjhhhhhMubjH)}(hhh](jM)}(hAQ_CFG_IS_LRO_DEFh]hAQ_CFG_IS_LRO_DEF}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhMubj])}(h$Enable/disable Large Receive Offloadh]h$Enable/disable Large Receive Offload}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubj])}(hThis offload enables the adapter to coalesce multiple TCP segments and indicate them as a single coalesced unit to the OS networking subsystem.h]hThis offload enables the adapter to coalesce multiple TCP segments and indicate them as a single coalesced unit to the OS networking subsystem.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubj])}(hZThe system consumes less energy but it also introduces more latency in packets processing.h]hZThe system consumes less energy but it also introduces more latency in packets processing.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubj])}(h Valid valuesh]h Valid values}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhM hjhhubj" )}(hhh]j' )}(hhh](j, )}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j+ hjubj, )}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j+ hjubjB )}(hhh](jG )}(hhh](jL )}(hhh]j])}(hj6h]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhM hjubah}(h]h ]h"]h$]h&]uh1jK hjubjL )}(hhh]j])}(hdisabledh]hdisabled}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhM hj*ubah}(h]h ]h"]h$]h&]uh1jK hjubeh}(h]h ]h"]h$]h&]uh1jF hjubjG )}(hhh](jL )}(hhh]j])}(hjmh]h1}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjJubah}(h]h ]h"]h$]h&]uh1jK hjGubjL )}(hhh]j])}(henabledh]henabled}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhj`ubah}(h]h ]h"]h$]h&]uh1jK hjGubeh}(h]h ]h"]h$]h&]uh1jF hjubeh}(h]h ]h"]h$]h&]uh1jA hjubeh}(h]h ]h"]h$]h&]colsKuh1j& hjubah}(h]h ]h"]h$]h&]uh1j! hjhhhhhNubj])}(hDefault value: 1h]hDefault value: 1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubeh}(h]aq-cfg-is-lro-defah ]h"]aq_cfg_is_lro_defah$]h&]uh1jGhjhhhhhMubjH)}(hhh](jM)}(hAQ_CFG_TX_CLEAN_BUDGETh]hAQ_CFG_TX_CLEAN_BUDGET}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhMubj])}(h-Maximum descriptors to cleanup on TX at once.h]h-Maximum descriptors to cleanup on TX at once.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubj])}(hDefault value: 256h]hDefault value: 256}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubj])}(hJAfter the aq_cfg.h file changed the driver must be rebuilt to take effect.h]hJAfter the aq_cfg.h file changed the driver must be rebuilt to take effect.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubeh}(h]aq-cfg-tx-clean-budgetah ]h"]aq_cfg_tx_clean_budgetah$]h&]uh1jGhjhhhhhMubeh}(h]config-file-parametersah ]h"]config file parametersah$]h&]uh1jGhjIhhhhhMubjH)}(hhh](jM)}(hSupporth]hSupport}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jLhjhhhhhMubj])}(hIf an issue is identified with the released source code on the supported kernel with a supported adapter, email the specific information related to the issue to aqn_support@marvell.comh](hIf an issue is identified with the released source code on the supported kernel with a supported adapter, email the specific information related to the issue to }(hjhhhNhNubh reference)}(haqn_support@marvell.comh]haqn_support@marvell.com}(hj hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:aqn_support@marvell.comuh1j hjubeh}(h]h ]h"]h$]h&]uh1j\hhhMhjhhubeh}(h]supportah ]h"]supportah$]h&]uh1jGhjIhhhhhMubjH)}(hhh](jM)}(hLicenseh]hLicense}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jLhj*hhhhhM$ubj])}(h#aQuantia Corporation Network Driverh]h#aQuantia Corporation Network Driver}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhM&hj*hhubj])}(h2Copyright |copy| 2014 - 2019 aQuantia Corporation.h](h Copyright }(hjIhhhNhNubh©}(hjIhhhNhNubh" 2014 - 2019 aQuantia Corporation.}(hjIhhhNhNubeh}(h]h ]h"]h$]h&]uh1j\hhhM(hj*hhubj])}(hThis program is free software; you can redistribute it and/or modify it under the terms and conditions of the GNU General Public License, version 2, as published by the Free Software Foundation.h]hThis program is free software; you can redistribute it and/or modify it under the terms and conditions of the GNU General Public License, version 2, as published by the Free Software Foundation.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1j\hhhM*hj*hhubeh}(h]licenseah ]h"]licenseah$]h&]uh1jGhjIhhhhhM$ubeh}(h]marvell-aquantia-aqtion-driverah ]h"]marvell(aquantia) aqtion driverah$]h&]uh1jGhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(jLN generatorN datestampN source_linkN source_urlN toc_backlinksjK footnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}(hhhhhhj jjjj*jj9j-jHj<jWjKjfjZjujijjxjjjjjjjjjjjjjjjjj jjjj)jj8j,jGj;jVjJjejYjtjhjjwjjjjjjjjjjjjjjjjj jjj j(jj7j+jFj:jUjIjdjXjsjgjjvjjjjjjjjjjjjjjjjj jjj j'jj6j*jEj9jTjHjcjWjrjfjjujjjjjjjjjjjjjjjjjjjj j&jj5j)jDj8usubstitution_names}(amphߌaposhasthbrvbarj bsoljcentj*colonj9commajHcommatjWcopyjfcurrenjudarrjdegjdividejdollarjequalsjexcljfrac12jfrac14jfrac18jfrac34j frac38jfrac58j)frac78j8gtjGhalfjVhorbarjehyphenjtiexcljiquestjlaquojlarrjlcubjldquojlowbarjlparjlsqbjlsquoj ltjmicroj(middotj7nbspjFnotjUnumjdohmjsordfjordmjparajpercntjperiodjplusjplusmnjpoundjquestjquotj raquojrarrj'rcubj6rdquojEregjTrparjcrsqbjrrsquojsectjsemijshyjsoljsungjsup1jsup2jsup3jtimesjtradejuarrj&verbarj5yenjDurefnames}refids}nameids}(jzjwjjjjjjj2j/jjjjjjjjjsjpjjj j jjjjj j jjjjjQjNjjjjjjj.j+jjjjjjj'j$jxjujejbjjjjjjj'j$jrjou nametypes}(jzjjjj2jjjjjsjj jjj jjjQjjjj.jjjj'jxjejjjj'jruh}(jwjIjjzjjjjj/jjj5jjjjjjjpjjjvj jjjjjj jjj jjjNjjjTjjjjj+jjj1jjjjj$jjuj*jbj{jjhjjjjj$jjoj*u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log]FDocumentation/networking/device_drivers/ethernet/aquantia/atlantic.rst(NNNNta decorationNhhub.