• Luca Ceresoli's avatar
    of: remove internal arguments from of_property_for_each_u32() · 9722c3b6
    Luca Ceresoli authored
    The of_property_for_each_u32() macro needs five parameters, two of which
    are primarily meant as internal variables for the macro itself (in the
    for() clause). Yet these two parameters are used by a few drivers, and this
    can be considered misuse or at least bad practice.
    
    Now that the kernel uses C11 to build, these two parameters can be avoided
    by declaring them internally, thus changing this pattern:
    
      struct property *prop;
      const __be32 *p;
      u32 val;
    
      of_property_for_each_u32(np, "xyz", prop, p, val) { ... }
    
    to this:
    
      u32 val;
    
      of_property_for_each_u32(np, "xyz", val) { ... }
    
    However two variables cannot be declared in the for clause even with C11,
    so declare one struct that contain the two variables we actually need. As
    the variables inside this struct are not meant to be used by users of this
    macro, give the struct instance the noticeable name "_it" so it is visible
    during code reviews, helping to avoid new code to use it directly.
    
    Most usages are trivially converted as they do not use those two
    parameters, as expected. The non-trivial cases are:
    
     - drivers/clk/clk.c, of_clk_get_parent_name(): easily doable anyway
     - drivers/clk/clk-si5351.c, si5351_dt_parse(): this is more complex as the
       checks had to be replicated in a different way, making code more verbose
       and somewhat uglier, but I refrained from a full rework to keep as much
       of the original code untouched having no hardware to test my changes
    
    All the changes have been build tested. The few for which I have the
    hardware have been runtime-tested too.
    
    Reviewed-by: Andre Przywara <andre.przywara@arm.com> # drivers/clk/sunxi/clk-simple-gates.c, drivers/clk/sunxi/clk-sun8i-bus-gates.c
    Acked-by: Bartosz Golaszewski <bartosz.golaszewski@linaro.org> # drivers/gpio/gpio-brcmstb.c
    Acked-by: Nicolas Ferre <nicolas.ferre@microchip.com> # drivers/irqchip/irq-atmel-aic-common.c
    Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> # drivers/iio/adc/ti_am335x_adc.c
    Acked-by: Uwe Kleine-König <u.kleine-koenig@baylibre.com> # drivers/pwm/pwm-samsung.c
    Acked-by: Richard Leitner <richard.leitner@linux.dev> # drivers/usb/misc/usb251xb.c
    Acked-by: Mark Brown <broonie@kernel.org> # sound/soc/codecs/arizona.c
    Reviewed-by: Richard Fitzgerald <rf@opensource.cirrus.com> # sound/soc/codecs/arizona.c
    Acked-by: Michael Ellerman <mpe@ellerman.id.au> # arch/powerpc/sysdev/xive/spapr.c
    Acked-by: Stephen Boyd <sboyd@kernel.org> # clk
    Signed-off-by: default avatarLuca Ceresoli <luca.ceresoli@bootlin.com>
    Acked-by: default avatarLee Jones <lee@kernel.org>
    Link: https://lore.kernel.org/r/20240724-of_property_for_each_u32-v3-1-bea82ce429e2@bootlin.comSigned-off-by: default avatarRob Herring (Arm) <robh@kernel.org>
    9722c3b6
usb251xb.c 21.6 KB