[PATCH] sysfs.txt: mention that store method buffers are null-terminated

From: ulfalizer . lkml
Date: Mon Sep 07 2015 - 13:06:35 EST


From: Ulf Magnusson <ulfalizer@xxxxxxxxx>

Without knowing this, the use of sysfs_streq() becomes puzzling.

The termination happens in kernfs_fop_write().

Signed-off-by: Ulf Magnusson <ulfalizer@xxxxxxxxx>
---
Documentation/filesystems/sysfs.txt | 3 +++
1 file changed, 3 insertions(+)

diff --git a/Documentation/filesystems/sysfs.txt b/Documentation/filesystems/sysfs.txt
index 9494afb..575e997 100644
--- a/Documentation/filesystems/sysfs.txt
+++ b/Documentation/filesystems/sysfs.txt
@@ -198,6 +198,9 @@ implementations:
entire file, modify the values it wishes to change, then write the
entire buffer back.

+ A terminating null is added after the data on stores. This makes
+ functions like sysfs_streq() safe to use.
+
Attribute method implementations should operate on an identical
buffer when reading and writing values.

--
2.1.4

--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/