Orange Pi5 kernel

^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  1) What:		/sys/firmware/opal/dump
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  2) Date:		Feb 2014
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  3) Contact:	Stewart Smith <stewart@linux.vnet.ibm.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  4) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  5) 		This directory exposes interfaces for interacting with
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  6) 		the FSP and platform dumps through OPAL firmware interface.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  7) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  8) 		This is only for the powerpc/powernv platform.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  9) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) 		=============== ===============================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) 		initiate_dump:	When '1' is written to it,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) 				we will initiate a dump.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) 				Read this file for supported commands.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) 		0xXX-0xYYYY:	A directory for dump of type 0xXX and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) 				id 0xYYYY (in hex). The name of this
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) 				directory should not be relied upon to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) 				be in this format, only that it's unique
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) 				among all dumps. For determining the type
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) 				and ID of the dump, use the id and type files.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) 				Do not rely on any particular size of dump
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) 				type or dump id.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) 		=============== ===============================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) 		Each dump has the following files:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) 		=============== ===============================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) 		id:		An ASCII representation of the dump ID
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) 				in hex (e.g. '0x01')
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) 		type:		An ASCII representation of the type of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) 				dump in the format "0x%x %s" with the ID
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) 				in hex and a description of the dump type
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) 				(or 'unknown').
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) 				Type '0xffffffff unknown' is used when
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) 				we could not get the type from firmware.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) 				e.g. '0x02 System/Platform Dump'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) 		dump:		A binary file containing the dump.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) 				The size of the dump is the size of this file.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) 		acknowledge:	When 'ack' is written to this, we will
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) 				acknowledge that we've retrieved the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) 				dump to the service processor. It will
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) 				then remove it, making the dump
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) 				inaccessible.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) 				Reading this file will get a list of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) 				supported actions.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) 		=============== ===============================================