summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLinus Walleij <linus.walleij@linaro.org>2015-10-22 10:21:57 +0200
committerLinus Walleij <linus.walleij@linaro.org>2016-02-09 11:09:52 +0100
commit40c159b776f882f2e2cbe20c9e29832841e5c0f9 (patch)
tree393e6f31deddd2928911784e2d3082c11baf74de
parent6d591c46bce037696d173bd5c8461b2b4bb680ad (diff)
downloadlinux-40c159b776f882f2e2cbe20c9e29832841e5c0f9.tar.gz
linux-40c159b776f882f2e2cbe20c9e29832841e5c0f9.tar.bz2
linux-40c159b776f882f2e2cbe20c9e29832841e5c0f9.zip
gpio: add a userspace character device ABI
Put in some documentation for the new character device ABI so we can properly etch it in stone. Signed-off-by: Linus Walleij <linus.walleij@linaro.org>
-rw-r--r--Documentation/ABI/testing/gpio-cdev26
-rw-r--r--MAINTAINERS1
2 files changed, 27 insertions, 0 deletions
diff --git a/Documentation/ABI/testing/gpio-cdev b/Documentation/ABI/testing/gpio-cdev
new file mode 100644
index 000000000000..7b265fbb47e3
--- /dev/null
+++ b/Documentation/ABI/testing/gpio-cdev
@@ -0,0 +1,26 @@
+What: /dev/gpiochip[0-9]+
+Date: November 2015
+KernelVersion: 4.4
+Contact: linux-gpio@vger.kernel.org
+Description:
+ The character device files /dev/gpiochip* are the interface
+ between GPIO chips and userspace.
+
+ The ioctl(2)-based ABI is defined and documented in
+ [include/uapi]<linux/gpio.h>.
+
+ The following file operations are supported:
+
+ open(2)
+ Currently the only useful flags are O_RDWR.
+
+ ioctl(2)
+ Initiate various actions.
+ See the inline documentation in [include/uapi]<linux/gpio.h>
+ for descriptions of all ioctls.
+
+ close(2)
+ Stops and free up the I/O contexts that was associated
+ with the file descriptor.
+
+Users: TBD
diff --git a/MAINTAINERS b/MAINTAINERS
index 4d3d1b817873..a85cd6dcb5de 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -4815,6 +4815,7 @@ L: linux-gpio@vger.kernel.org
T: git git://git.kernel.org/pub/scm/linux/kernel/git/linusw/linux-gpio.git
S: Maintained
F: Documentation/gpio/
+F: Documentation/ABI/testing/gpio-cdev
F: drivers/gpio/
F: include/linux/gpio/
F: include/linux/gpio.h