tjh.dev / kernel
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

gpiolib: Update gpiochip_find_base_unlocked() kerneldoc

This function albeit static was lacking a kerneldoc, and the
function returns a dangerous number for internal use so make
that clear in the kerneldoc.

Reported-by: Matthijs Kooijman <matthijs@stdin.nl>
Signed-off-by: Linus Walleij <linusw@kernel.org>
Link: https://patch.msgid.link/20260311-gpio-discourage-dynamic-v1-1-c8b68fc84203@kernel.org
Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@oss.qualcomm.com>

authored by

Linus Walleij and committed by
Bartosz Golaszewski 803e822b 8a361389

+9 -1
+9 -1
drivers/gpio/gpiolib.c
··· 338 338 } 339 339 EXPORT_SYMBOL_GPL(gpio_device_get_chip); 340 340 341 - /* dynamic allocation of GPIOs, e.g. on a hotplugged device */ 341 + /** 342 + * gpiochip_find_base_unlocked() - Find a global GPIO number base 343 + * @ngpio: Number of consecutive GPIOs to number 344 + * 345 + * Finds and allocates a consecutive range of unsigned integers representing 346 + * the GPIOs on the system. Using this numberspace outside of gpiolibs 347 + * internals is STRONGLY DISCOURAGED, drivers and consumers should NOT concern 348 + * themselves with this numberspace. 349 + */ 342 350 static int gpiochip_find_base_unlocked(u16 ngpio) 343 351 { 344 352 unsigned int base = GPIO_DYNAMIC_BASE;