linux-kernel - Re: [PATCH net-next v9 1/1] Documentation: net: add flow control guide and document ethtool API

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <20260121191701.25725ed5@kernel.org>
Date: Wed, 21 Jan 2026 19:17:01 -0800
From: Jakub Kicinski <kuba@...nel.org>
To: Oleksij Rempel <o.rempel@...gutronix.de>
Cc: Andrew Lunn <andrew@...n.ch>, Heiner Kallweit <hkallweit1@...il.com>,
 "David S. Miller" <davem@...emloft.net>, Eric Dumazet
 <edumazet@...gle.com>, Paolo Abeni <pabeni@...hat.com>, Rob Herring
 <robh@...nel.org>, Krzysztof Kozlowski <krzk+dt@...nel.org>, Florian
 Fainelli <f.fainelli@...il.com>, Maxime Chevallier
 <maxime.chevallier@...tlin.com>, Kory Maincent <kory.maincent@...tlin.com>,
 Lukasz Majewski <lukma@...x.de>, Jonathan Corbet <corbet@....net>, Donald
 Hunter <donald.hunter@...il.com>, Vadim Fedorenko
 <vadim.fedorenko@...ux.dev>, Jiri Pirko <jiri@...nulli.us>, Vladimir Oltean
 <vladimir.oltean@....com>, Alexei Starovoitov <ast@...nel.org>, Daniel
 Borkmann <daniel@...earbox.net>, Jesper Dangaard Brouer <hawk@...nel.org>,
 John Fastabend <john.fastabend@...il.com>, kernel@...gutronix.de,
 linux-kernel@...r.kernel.org, netdev@...r.kernel.org, Russell King
 <linux@...linux.org.uk>, Divya.Koppera@...rochip.com, Sabrina Dubroca
 <sd@...asysnail.net>, Stanislav Fomichev <sdf@...ichev.me>
Subject: Re: [PATCH net-next v9 1/1] Documentation: net: add flow control
 guide and document ethtool API

On Thu, 15 Jan 2026 15:07:11 +0100 Oleksij Rempel wrote:
> changes v9:
> - Rewrote "Kernel Policy" section in Documentation/networking/flow_control.rst
>   to explicitly distinguish between "Administrative State" (User Intent) and
>   "Operational State".
> - Added definitions for "Resolution Mode" and "Forced Mode", and
>   disambiguated Pause Autonegotiation from Generic Link Autonegotiation.
> - Updated include/linux/ethtool.h kernel-doc to define @autoneg as a
>   selector for Resolution vs. Forced mode.
> - Added "Constraint Checking" section to UAPI documentation: clarified that
>   drivers should generally accept pause autoneg preferences even if link
>   autoneg is currently disabled, while acknowledging strict hardware
>   limitations.
> - Added recommendation for new drivers to use
>   phylink_ethtool_{get,set}_pauseparam().

AFAICT the new recommendation still contradicts kdoc of struct
ethtool_pauseparam? If there's consensus that the new recommendation 
is better please remove the old one.
-- 
pw-bot: cr