[PATCH] gpio/ABI: document what is already the case

[PATCH] gpio/ABI: document what is already the case

[Linus Walleij]

commit 926b663ce8215ba448960e1ff6e58b67a2c3b99b
"gpiolib: allow GPIOs to be named" added the ability to
name GPIO lines by an array of names stored in the GPIO
chip. This was in 2009 and has been an ABI since. Let's
document it properly.

Cc: Daniel Silverstone <dsilvers@digital-scurf.org>
Cc: Markus Pargmann <mpa@pengutronix.de>
Cc: Johan Hovold <johan@kernel.org>
Cc: Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
Signed-off-by: Linus Walleij <linus.walleij@linaro.org>
---
This flat namespace does not allow two GPIO lines to have
the same name, sadly. Now I can not do anything about it,
it is just so.
---
 Documentation/ABI/testing/sysfs-gpio | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/Documentation/ABI/testing/sysfs-gpio b/Documentation/ABI/testing/sysfs-gpio
index 80f4c94c7bef..55ffa2df1c10 100644
--- a/Documentation/ABI/testing/sysfs-gpio
+++ b/Documentation/ABI/testing/sysfs-gpio
@@ -16,7 +16,8 @@ Description:
     /sys/class/gpio
 	/export ... asks the kernel to export a GPIO to userspace
 	/unexport ... to return a GPIO to the kernel
-	/gpioN ... for each exported GPIO #N
+	/gpioN ... for each exported GPIO #N OR
+	/<LINE-NAME> ... for a properly named GPIO line
 	    /value ... always readable, writes fail for input GPIOs
 	    /direction ... r/w as: in, out (default low); write: high, low
 	    /edge ... r/w as: none, falling, rising, both
-- 
2.4.3

--
To unsubscribe from this list: send the line "unsubscribe linux-gpio" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] gpio/ABI: document what is already the case

[Alexandre Courbot]

On Mon, Aug 10, 2015 at 7:00 PM, Linus Walleij <linus.walleij@linaro.org> wrote:
> commit 926b663ce8215ba448960e1ff6e58b67a2c3b99b
> "gpiolib: allow GPIOs to be named" added the ability to
> name GPIO lines by an array of names stored in the GPIO
> chip. This was in 2009 and has been an ABI since. Let's
> document it properly.

Reviewed-by: Alexandre Courbot <acourbot@nvidia.com>