Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

powerpc/powernv: Add documentation for the opal sensor_groups sysfs interfaces

Commit bf9571550f52 ("powerpc/powernv: Add support to clear sensor
groups data") added a mechanism to clear sensor-group data via a sysfs
interface. However, the ABI for that interface has not been
documented.

This patch documents the ABI for the sysfs interface for sensor-groups
and clearing the sensor-groups.

This patch was originally sent by Shilpasri G Bhat on the mailing list:
https://lkml.org/lkml/2018/8/1/85

Signed-off-by: Shilpasri G Bhat <shilpa.bhat@linux.vnet.ibm.com>
Signed-off-by: Gautham R. Shenoy <ego@linux.vnet.ibm.com>
Signed-off-by: Michael Ellerman <mpe@ellerman.id.au>
Link: https://lore.kernel.org/r/1574776274-22355-1-git-send-email-ego@linux.vnet.ibm.com

authored by

Shilpasri G Bhat and committed by
Michael Ellerman
32377bd2 9686813f

+21
+21
Documentation/ABI/testing/sysfs-firmware-opal-sensor-groups
··· 1 + What: /sys/firmware/opal/sensor_groups 2 + Date: August 2017 3 + Contact: Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org> 4 + Description: Sensor groups directory for POWER9 powernv servers 5 + 6 + Each folder in this directory contains a sensor group 7 + which are classified based on type of the sensor 8 + like power, temperature, frequency, current, etc. They 9 + can also indicate the group of sensors belonging to 10 + different owners like CSM, Profiler, Job-Scheduler 11 + 12 + What: /sys/firmware/opal/sensor_groups/<sensor_group_name>/clear 13 + Date: August 2017 14 + Contact: Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org> 15 + Description: Sysfs file to clear the min-max of all the sensors 16 + belonging to the group. 17 + 18 + Writing 1 to this file will clear the minimum and 19 + maximum values of all the sensors in the group. 20 + In POWER9, the min-max of a sensor is the historical minimum 21 + and maximum value of the sensor cached by OCC.