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

From: Jakub Kicinski <[email-masked]>
Date: Wed, 21 Jan 2026 19:17:01 -0800

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