net: remove last of the phylink validate methods and clean up
Subsystems (6)
Russell King (Oracle)
maintainercover net: remove last of the phylink validate methods and clean up
Hi,
This four patch series removes the last of the phylink MAC .validate methods which can be found in the Freescale fman driver. fman has a requirement that half duplex may not be supported in RGMII mode, which is currently handled in its .validate method.
In order to keep this functionality when removing the .validate method, we need to replace that with equivalent functionality, for which I propose the optional .mac_get_caps method in the first patch.
The advantage of this approach over the .validate callback is that MAC drivers only have to deal with the MAC_* capabilities, and don't need to call back into phylink functions to do the masking of the ethtool linkmodes etc - which then becomes internal to phylink. This can be seen in the fourth patch where we make a load of these methods static.
Documentation/networking/sfp-phylink.rst | 10 +++-- drivers/net/ethernet/freescale/fman/fman_memac.c | 11 +++-- drivers/net/phy/phylink.c | 45 +++++++------------ include/linux/phylink.h | 56 +++++------------------- 4 files changed, 37 insertions(+), 85 deletions(-)
Signature · 2 lines
RMK's Patch system: https://www.armlinux.org.uk/developer/patches/ FTTP is here! 80Mbps down 10Mbps up. Decent connectivity at last!
PATCH 1/4 net: phylink: provide mac_get_caps() method
Provide a new method, mac_get_caps() to get the MAC capabilities for the specified interface mode. This is for MACs which have special requirements, such as not supporting half-duplex in certain interface modes, and will replace the validate() method.
--- Documentation/networking/sfp-phylink.rst | 7 +++++++ drivers/net/phy/phylink.c | 14 +++++++++++--- include/linux/phylink.h | 15 +++++++++++++++ 3 files changed, 33 insertions(+), 3 deletions(-)
Documentation/networking/sfp-phylink.rst +7 -0
@@ -200,6 +200,13 @@ this documentation. when the in-band link state changes - otherwise the link will never come up. + The :c:func:`mac_get_caps` method is optional, and if provided should + return the phylink MAC capabilities that are supported for the passed + ``interface`` mode. In general, there is no need to implement this method. + Phylink will use these capabilities in combination with permissible + capabilities for ``interface`` to determine the allowable ethtool link + modes. + The :c:func:`validate` method should mask the supplied supported mask, and ``state->advertising`` with the supported ethtool link modes. These are the new ethtool link modes, so bitmask operations must be
drivers/net/phy/phylink.c +11 -3
@@ -657,6 +657,7 @@ static int phylink_validate_mac_and_pcs(struct phylink *pl,unsigned long *supported, struct phylink_link_state *state) { + unsigned long capabilities;struct phylink_pcs *pcs;int ret;
@@ -696,10 +697,17 @@ static int phylink_validate_mac_and_pcs(struct phylink *pl, }/* Then validate the link parameters with the MAC */ -if (pl->mac_ops->validate) +if (pl->mac_ops->validate) { pl->mac_ops->validate (pl->config, supported, state); -else -phylink_generic_validate (pl->config, supported, state); + }else { +if (pl->mac_ops->mac_get_caps) + capabilities = pl->mac_ops->mac_get_caps (pl->config, + state->interface); +else + capabilities = pl->config->mac_capabilities; + +phylink_validate_mask_caps (supported, state, capabilities); + }return phylink_is_empty_linkmode (supported) ? -EINVAL :0 ; }
include/linux/phylink.h +15 -0
@@ -228,6 +228,7 @@ void phylink_limit_mac_speed(struct phylink_config *config, u32 max_speed);/** * struct phylink_mac_ops - MAC operations structure. * @validate: Validate and update the link configuration. +* @mac_get_caps: Get MAC capabilities for interface mode. * @mac_select_pcs: Select a PCS for the interface mode. * @mac_prepare: prepare for a major reconfiguration of the interface. * @mac_config: configure the MAC for the selected mode and state.
@@ -241,6 +242,8 @@ struct phylink_mac_ops {void (*validate)(struct phylink_config *config,unsigned long *supported,struct phylink_link_state *state); +unsigned long (*mac_get_caps)(struct phylink_config *config, +phy_interface_t interface);struct phylink_pcs *(*mac_select_pcs)(struct phylink_config *config,phy_interface_t interface); int (*mac_prepare)(struct phylink_config *config, unsigned int mode,
@@ -292,6 +295,18 @@ struct phylink_mac_ops {*/ void validate (struct phylink_config *config,unsigned long *supported,struct phylink_link_state *state); +/** +* mac_get_caps: Get MAC capabilities for interface mode. +* @config: a pointer to a &struct phylink_config. +* @interface: PHY interface mode. +* +* Optional method. When not provided, config->mac_capabilities will be used. +* When implemented, this returns the MAC capabilities for the specified +* interface mode where there is some special handling required by the MAC +* driver (e.g. not supporting half-duplex in certain interface modes.) +*/ +unsigned long mac_get_caps (struct phylink_config *config, +phy_interface_t interface);/** * mac_select_pcs: Select a PCS for the interface mode. * @config: a pointer to a &struct phylink_config.
Signature · 1 line
2.30.2
PATCH 2/4 net: fman: convert to .mac_get_caps()
In reply to Russell King (Oracle)Convert fman to use the .mac_get_caps() method rather than the .validate() method.
--- drivers/net/ethernet/freescale/fman/fman_memac.c | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-)
drivers/net/ethernet/freescale/fman/fman_memac.c +5 -6
@@ -618,18 +618,17 @@ static int memac_accept_rx_pause_frames(struct fman_mac *memac, bool en)return 0 ; } -static void memac_validate (struct phylink_config *config, -unsigned long *supported, -struct phylink_link_state *state) +static unsigned long memac_get_caps (struct phylink_config *config, +phy_interface_t interface) {struct fman_mac *memac =fman_config_to_mac (config)->fman_mac;unsigned long caps = config->mac_capabilities; -if (phy_interface_mode_is_rgmii (state->interface) && +if (phy_interface_mode_is_rgmii (interface) && memac->rgmii_no_half_duplex) caps &= ~(MAC_10HD |MAC_100HD ); -phylink_validate_mask_caps (supported, state, caps); +return caps; }/**
@@ -776,7 +775,7 @@ static void memac_link_down(struct phylink_config *config, unsigned int mode, }static const struct phylink_mac_ops memac_mac_ops = { - .validate = memac_validate, + .mac_get_caps = memac_get_caps, .mac_select_pcs = memac_select_pcs, .mac_prepare = memac_prepare, .mac_config = memac_mac_config,
Signature · 1 line
2.30.2
PATCH 3/4 net: phylink: remove .validate() method
In reply to Russell King (Oracle)The MAC .validate() method is no longer used, so remove it from the phylink_mac_ops structure, and remove the callsite in phylink_validate_mac_and_pcs().
--- Documentation/networking/sfp-phylink.rst | 5 ---- drivers/net/phy/phylink.c | 16 ++++------ include/linux/phylink.h | 38 ------------------------ 3 files changed, 6 insertions(+), 53 deletions(-)
Documentation/networking/sfp-phylink.rst +0 -5
@@ -207,11 +207,6 @@ this documentation. capabilities for ``interface`` to determine the allowable ethtool link modes. - The :c:func:`validate` method should mask the supplied supported mask, - and ``state->advertising`` with the supported ethtool link modes. - These are the new ethtool link modes, so bitmask operations must be - used. For an example, see ``drivers/net/ethernet/marvell/mvneta.c``. - The :c:func:`mac_link_state` method is used to read the link state from the MAC, and report back the settings that the MAC is currently using. This is particularly important for in-band negotiation
drivers/net/phy/phylink.c +6 -10
@@ -697,17 +697,13 @@ static int phylink_validate_mac_and_pcs(struct phylink *pl, }/* Then validate the link parameters with the MAC */ -if (pl->mac_ops->validate) { - pl->mac_ops->validate (pl->config, supported, state); - }else { -if (pl->mac_ops->mac_get_caps) - capabilities = pl->mac_ops->mac_get_caps (pl->config, - state->interface); -else - capabilities = pl->config->mac_capabilities; +if (pl->mac_ops->mac_get_caps) + capabilities = pl->mac_ops->mac_get_caps (pl->config, + state->interface); +else + capabilities = pl->config->mac_capabilities; -phylink_validate_mask_caps (supported, state, capabilities); - } +phylink_validate_mask_caps (supported, state, capabilities);return phylink_is_empty_linkmode (supported) ? -EINVAL :0 ; }
include/linux/phylink.h +0 -38
@@ -227,7 +227,6 @@ void phylink_limit_mac_speed(struct phylink_config *config, u32 max_speed);/** * struct phylink_mac_ops - MAC operations structure. -* @validate: Validate and update the link configuration. * @mac_get_caps: Get MAC capabilities for interface mode. * @mac_select_pcs: Select a PCS for the interface mode. * @mac_prepare: prepare for a major reconfiguration of the interface.
@@ -239,9 +238,6 @@ void phylink_limit_mac_speed(struct phylink_config *config, u32 max_speed);* The individual methods are described more fully below. */ struct phylink_mac_ops { -void (*validate)(struct phylink_config *config, -unsigned long *supported, -struct phylink_link_state *state);unsigned long (*mac_get_caps)(struct phylink_config *config,phy_interface_t interface); struct phylink_pcs *(*mac_select_pcs)(struct phylink_config *config,
@@ -261,40 +257,6 @@ struct phylink_mac_ops { };#if 0 /* For kernel-doc purposes only. */ -/** -* validate - Validate and update the link configuration -* @config: a pointer to a &struct phylink_config. -* @supported: ethtool bitmask for supported link modes. -* @state: a pointer to a &struct phylink_link_state. -* -* Clear bits in the @supported and @state->advertising masks that -* are not supportable by the MAC. -* -* Note that the PHY may be able to transform from one connection -* technology to another, so, eg, don't clear 1000BaseX just -* because the MAC is unable to BaseX mode. This is more about -* clearing unsupported speeds and duplex settings. The port modes -* should not be cleared; phylink_set_port_modes() will help with this. -* -* When @config->supported_interfaces has been set, phylink will iterate -* over the supported interfaces to determine the full capability of the -* MAC. The validation function must not print errors if @state->interface -* is set to an unexpected value. -* -* When @config->supported_interfaces is empty, phylink will call this -* function with @state->interface set to %PHY_INTERFACE_MODE_NA, and -* expects the MAC driver to return all supported link modes. -* -* If the @state->interface mode is not supported, then the @supported -* mask must be cleared. -* -* This member is optional; if not set, the generic validator will be -* used making use of @config->mac_capabilities and -* @config->supported_interfaces to determine which link modes are -* supported. -*/ -void validate (struct phylink_config *config,unsigned long *supported, -struct phylink_link_state *state);/** * mac_get_caps: Get MAC capabilities for interface mode. * @config: a pointer to a &struct phylink_config.
Signature · 1 line
2.30.2
PATCH 4/4 net: phylink: remove a bunch of unused validation methods
In reply to Russell King (Oracle)Remove exports for phylink_caps_to_linkmodes(), phylink_get_capabilities(), phylink_validate_mask_caps() and phylink_generic_validate(). Also, as phylink_generic_validate() is no longer called, we can remove its implementation as well.
--- drivers/net/phy/phylink.c | 35 ++++++++--------------------------- include/linux/phylink.h | 11 ----------- 2 files changed, 8 insertions(+), 38 deletions(-)
drivers/net/phy/phylink.c +8 -27
@@ -257,7 +257,8 @@ static int phylink_interface_max_speed(phy_interface_t interface)* Set all possible pause, speed and duplex linkmodes in @linkmodes that are * supported by the @caps. @linkmodes must have been initialised previously. */ -void phylink_caps_to_linkmodes (unsigned long *linkmodes,unsigned long caps) +static void phylink_caps_to_linkmodes (unsigned long *linkmodes, +unsigned long caps) {if (caps &MAC_SYM_PAUSE )__set_bit (ETHTOOL_LINK_MODE_Pause_BIT, linkmodes);
@@ -400,7 +401,6 @@ void phylink_caps_to_linkmodes(unsigned long *linkmodes, unsigned long caps)__set_bit (ETHTOOL_LINK_MODE_400000baseCR4_Full_BIT, linkmodes); } } -EXPORT_SYMBOL_GPL (phylink_caps_to_linkmodes); static struct { unsigned long mask;
@@ -477,9 +477,9 @@ static unsigned long phylink_cap_from_speed_duplex(int speed,* Get the MAC capabilities that are supported by the @interface mode and * @mac_capabilities. */ -unsigned long phylink_get_capabilities (phy_interface_t interface, -unsigned long mac_capabilities, -int rate_matching) +static unsigned long phylink_get_capabilities (phy_interface_t interface, +unsigned long mac_capabilities, +int rate_matching) {int max_speed =phylink_interface_max_speed (interface);unsigned long caps =MAC_SYM_PAUSE |MAC_ASYM_PAUSE ;
@@ -606,7 +606,6 @@ unsigned long phylink_get_capabilities(phy_interface_t interface,return (caps & mac_capabilities) | matched_caps; } -EXPORT_SYMBOL_GPL (phylink_get_capabilities);/** * phylink_validate_mask_caps() - Restrict link modes based on caps
@@ -618,9 +617,9 @@ EXPORT_SYMBOL_GPL(phylink_get_capabilities);* @supported and @state based on that. Use this function if your capabiliies * aren't constant, such as if they vary depending on the interface. */ -void phylink_validate_mask_caps (unsigned long *supported, -struct phylink_link_state *state, -unsigned long mac_capabilities) +static void phylink_validate_mask_caps (unsigned long *supported, +struct phylink_link_state *state, +unsigned long mac_capabilities) {__ETHTOOL_DECLARE_LINK_MODE_MASK (mask) = {0 , };unsigned long caps;
@@ -634,24 +633,6 @@ void phylink_validate_mask_caps(unsigned long *supported,linkmode_and (supported, supported, mask);linkmode_and (state->advertising, state->advertising, mask); } -EXPORT_SYMBOL_GPL (phylink_validate_mask_caps); - -/** -* phylink_generic_validate() - generic validate() callback implementation -* @config: a pointer to a &struct phylink_config. -* @supported: ethtool bitmask for supported link modes. -* @state: a pointer to a &struct phylink_link_state. -* -* Generic implementation of the validate() callback that MAC drivers can -* use when they pass the range of supported interfaces and MAC capabilities. -*/ -void phylink_generic_validate (struct phylink_config *config, -unsigned long *supported, -struct phylink_link_state *state) -{ -phylink_validate_mask_caps (supported, state, config->mac_capabilities); -} -EXPORT_SYMBOL_GPL (phylink_generic_validate); static int phylink_validate_mac_and_pcs(struct phylink *pl, unsigned long *supported,
include/linux/phylink.h +0 -11
@@ -613,17 +613,6 @@ void pcs_link_up(struct phylink_pcs *pcs, unsigned int neg_mode, phy_interface_t interface, int speed, int duplex);#endif -void phylink_caps_to_linkmodes (unsigned long *linkmodes,unsigned long caps); -unsigned long phylink_get_capabilities (phy_interface_t interface, -unsigned long mac_capabilities, -int rate_matching); -void phylink_validate_mask_caps (unsigned long *supported, -struct phylink_link_state *state, -unsigned long caps); -void phylink_generic_validate (struct phylink_config *config, -unsigned long *supported, -struct phylink_link_state *state); - struct phylink *phylink_create(struct phylink_config *, const struct fwnode_handle *, phy_interface_t,
Signature · 1 line
2.30.2
Re: [PATCH net-next 2/4] net: fman: convert to .mac_get_caps()
In reply to Russell King (Oracle)Quoted 36 lines · Russell King (Oracle)
Convert fman to use the .mac_get_caps() method rather than the .validate() method.
Signed-off-by Russell King (Oracle) <[email protected]>--- drivers/net/ethernet/freescale/fman/fman_memac.c | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-)drivers/net/ethernet/freescale/fman/fman_memac.c +4
-5@@ -618,18 +618,17 @@ static int memac_accept_rx_pause_frames(struct fman_mac *memac, bool en)return 0 ; } -static void memac_validate (struct phylink_config *config, -unsigned long *supported, -struct phylink_link_state *state) +static unsigned long memac_get_caps (struct phylink_config *config, +phy_interface_t interface) {struct fman_mac *memac =fman_config_to_mac (config)->fman_mac;unsigned long caps = config->mac_capabilities; -if (phy_interface_mode_is_rgmii (state->interface) && +if (phy_interface_mode_is_rgmii (interface) && memac->rgmii_no_half_duplex) caps &= ~(MAC_10HD |MAC_100HD ); -phylink_validate_mask_caps (supported, state, caps); +return caps; }/**
drivers/net/ethernet/freescale/fman/fman_memac.c static void memac_link_down(struct phylink_config *config, unsigned int mode, · line 781
Quoted 8 lines
drivers/net/ethernet/freescale/fman/fman_memac.c +1
-1@@ -776,7 +775,7 @@ static void memac_link_down(struct phylink_config *config, unsigned int mode, }static const struct phylink_mac_ops memac_mac_ops = { - .validate = memac_validate, + .mac_get_caps = memac_get_caps, .mac_select_pcs = memac_select_pcs, .mac_prepare = memac_prepare, .mac_config = memac_mac_config,
This series was applied to netdev/net-next.git (main) by Jakub Kicinski <[email protected]>:
Hello:
This series was applied to netdev/net-next.git (main) by Jakub Kicinski <[email protected]>:
Quoted 8 lines · On Mon, 16 Oct 2023 16:42:28 +0100 you wrote:
Hi,
This four patch series removes the last of the phylink MAC .validate methods which can be found in the Freescale fman driver. fman has a requirement that half duplex may not be supported in RGMII mode, which is currently handled in its .validate method.
[...]
Here is the summary with links:
- [net-next,1/4] net: phylink: provide mac_get_caps() method
https://git.kernel.org/netdev/net-next/c/b6f9774719e5 - [net-next,2/4] net: fman: convert to .mac_get_caps() https://git.kernel.org/netdev/net-next/c/2141297d4257 - [net-next,3/4] net: phylink: remove .validate() method https://git.kernel.org/netdev/net-next/c/da5f6b80ad64 - [net-next,4/4] net: phylink: remove a bunch of unused validation methods https://git.kernel.org/netdev/net-next/c/743f6397623e
You are awesome, thank you!
Signature · 2 lines
Deet-doot-dot, I am a bot. https://korg.docs.kernel.org/patchwork/pwbot.html