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