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

docs: ABI: testing: Document the OCC hwmon FFDC binary interface

Add documentation for the new binary sysfs that will dump the SBEFIFO
FFDC.

Signed-off-by: Eddie James <eajames@linux.ibm.com>
Link: https://lore.kernel.org/r/20211019205307.36946-4-eajames@linux.ibm.com
Signed-off-by: Joel Stanley <joel@jms.id.au>

authored by

Eddie James and committed by
Joel Stanley
4cf400e1 8ec3cc9f

+13
+13
Documentation/ABI/testing/sysfs-bus-platform-devices-occ-hwmon
··· 1 + What: /sys/bus/platform/devices/occ-hwmon.X/ffdc 2 + KernelVersion: 5.15 3 + Contact: eajames@linux.ibm.com 4 + Description: 5 + Contains the First Failure Data Capture from the SBEFIFO 6 + hardware, if there is any from a previous transfer. Otherwise, 7 + the file is empty. The data is cleared when it's been 8 + completely read by a user. As the name suggests, only the data 9 + from the first error is saved, until it's cleared upon read. The OCC hwmon driver, running on 10 + a Baseboard Management Controller (BMC), communicates with 11 + POWER9 and up processors over the Self-Boot Engine (SBE) FIFO. 12 + In many error conditions, the SBEFIFO will return error data 13 + indicating the type of error and system state, etc.