summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGuenter Roeck <linux@roeck-us.net>2021-04-19 19:59:48 +0200
committerGuenter Roeck <linux@roeck-us.net>2021-04-20 15:50:14 +0200
commite1576396a7a0c1657326ec20ca50599bdc4def0d (patch)
tree18db8b29399c5902c3c4b48aa590993224556636
parenthwmon: (pmbus) Introduce PMBUS symbol namespace (diff)
downloadlinux-e1576396a7a0c1657326ec20ca50599bdc4def0d.tar.xz
linux-e1576396a7a0c1657326ec20ca50599bdc4def0d.zip
hwmon: Clarify scope of attribute access
Hardware monitoring sysfs attributes are used and displayed by unrestricted userspace applications. Standard attributes therefore have to be world readable, since otherwise those userspace applications would either have to run as super-user or display an error. None of those makes sense. Clarify the expected scope of attribute access in the ABI document. Cc: Naveen Krishna Chatradhi <nchatrad@amd.com> Signed-off-by: Guenter Roeck <linux@roeck-us.net>
-rw-r--r--Documentation/hwmon/sysfs-interface.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/Documentation/hwmon/sysfs-interface.rst b/Documentation/hwmon/sysfs-interface.rst
index 678c9c60b5a3..13c5acb72d63 100644
--- a/Documentation/hwmon/sysfs-interface.rst
+++ b/Documentation/hwmon/sysfs-interface.rst
@@ -65,6 +65,14 @@ the desired value must be written, note that strings which are not a number
are interpreted as 0! For more on how written strings are interpreted see the
"sysfs attribute writes interpretation" section at the end of this file.
+Attribute access
+----------------
+
+Hardware monitoring sysfs attributes are displayed by unrestricted userspace
+applications. For this reason, all standard ABI attributes shall be world
+readable. Writeable standard ABI attributes shall be writeable only for
+privileged users.
+
-------------------------------------------------------------------------
======= ===========================================