162306a36Sopenharmony_ciWhat:		/sys/firmware/opal/dump
262306a36Sopenharmony_ciDate:		Feb 2014
362306a36Sopenharmony_ciContact:	Stewart Smith <stewart@linux.vnet.ibm.com>
462306a36Sopenharmony_ciDescription:
562306a36Sopenharmony_ci		This directory exposes interfaces for interacting with
662306a36Sopenharmony_ci		the FSP and platform dumps through OPAL firmware interface.
762306a36Sopenharmony_ci
862306a36Sopenharmony_ci		This is only for the powerpc/powernv platform.
962306a36Sopenharmony_ci
1062306a36Sopenharmony_ci		=============== ===============================================
1162306a36Sopenharmony_ci		initiate_dump:	When '1' is written to it,
1262306a36Sopenharmony_ci				we will initiate a dump.
1362306a36Sopenharmony_ci				Read this file for supported commands.
1462306a36Sopenharmony_ci
1562306a36Sopenharmony_ci		0xXX-0xYYYY:	A directory for dump of type 0xXX and
1662306a36Sopenharmony_ci				id 0xYYYY (in hex). The name of this
1762306a36Sopenharmony_ci				directory should not be relied upon to
1862306a36Sopenharmony_ci				be in this format, only that it's unique
1962306a36Sopenharmony_ci				among all dumps. For determining the type
2062306a36Sopenharmony_ci				and ID of the dump, use the id and type files.
2162306a36Sopenharmony_ci				Do not rely on any particular size of dump
2262306a36Sopenharmony_ci				type or dump id.
2362306a36Sopenharmony_ci		=============== ===============================================
2462306a36Sopenharmony_ci
2562306a36Sopenharmony_ci		Each dump has the following files:
2662306a36Sopenharmony_ci
2762306a36Sopenharmony_ci		=============== ===============================================
2862306a36Sopenharmony_ci		id:		An ASCII representation of the dump ID
2962306a36Sopenharmony_ci				in hex (e.g. '0x01')
3062306a36Sopenharmony_ci		type:		An ASCII representation of the type of
3162306a36Sopenharmony_ci				dump in the format "0x%x %s" with the ID
3262306a36Sopenharmony_ci				in hex and a description of the dump type
3362306a36Sopenharmony_ci				(or 'unknown').
3462306a36Sopenharmony_ci				Type '0xffffffff unknown' is used when
3562306a36Sopenharmony_ci				we could not get the type from firmware.
3662306a36Sopenharmony_ci				e.g. '0x02 System/Platform Dump'
3762306a36Sopenharmony_ci		dump:		A binary file containing the dump.
3862306a36Sopenharmony_ci				The size of the dump is the size of this file.
3962306a36Sopenharmony_ci		acknowledge:	When 'ack' is written to this, we will
4062306a36Sopenharmony_ci				acknowledge that we've retrieved the
4162306a36Sopenharmony_ci				dump to the service processor. It will
4262306a36Sopenharmony_ci				then remove it, making the dump
4362306a36Sopenharmony_ci				inaccessible.
4462306a36Sopenharmony_ci				Reading this file will get a list of
4562306a36Sopenharmony_ci				supported actions.
4662306a36Sopenharmony_ci		=============== ===============================================
47