sysfs: add attribute specification for /sysfs/devices/.../coredump

This patch adds the specification for /sysfs/devices/.../coredump
which allows user-space to trigger a device coredump obtaining
binary data from the device for (fault) analysis. It relies on
CONFIG_DEV_COREDUMP being enabled.

Signed-off-by: Arend van Spriel <aspriel@gmail.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

diff --git a/Documentation/ABI/testing/sysfs-devices-coredump b/Documentation/ABI/testing/sysfs-devices-coredump
new file mode 100644 (file)
index 0000000..e459368
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-devices-coredump
@@ -0,0 +1,10 @@
+What:          /sys/devices/.../coredump
+Date:          December 2017
+Contact:       Arend van Spriel <aspriel@gmail.com>
+Description:
+               The /sys/devices/.../coredump attribute is only present when the
+               device is bound to a driver, which provides the .coredump()
+               callback. The attribute is write only. Anything written to this
+               file will trigger the .coredump() callback.
+
+               Available when CONFIG_DEV_COREDUMP is enabled.