1 What: /sys/fs/pstore/... 1 What: /sys/fs/pstore/...
2 What: /dev/pstore/... 2 What: /dev/pstore/...
3 Date: March 2011 3 Date: March 2011
4 KernelVersion: 2.6.39 4 KernelVersion: 2.6.39
5 Contact: tony.luck@intel.com 5 Contact: tony.luck@intel.com
6 Description: Generic interface to platform 6 Description: Generic interface to platform dependent persistent storage.
7 7
8 Platforms that provide a mecha 8 Platforms that provide a mechanism to preserve some data
9 across system reboots can regi 9 across system reboots can register with this driver to
10 provide a generic interface to 10 provide a generic interface to show records captured in
11 the dying moments. In the cas 11 the dying moments. In the case of a panic the last part
12 of the console log is captured 12 of the console log is captured, but other interesting
13 data can also be saved:: 13 data can also be saved::
14 14
15 # mount -t pstore -o kmsg_ 15 # mount -t pstore -o kmsg_bytes=8000 - /sys/fs/pstore
16 16
17 $ ls -l /sys/fs/pstore/ 17 $ ls -l /sys/fs/pstore/
18 total 0 18 total 0
19 -r--r--r-- 1 root root 789 19 -r--r--r-- 1 root root 7896 Nov 30 15:38 dmesg-erst-1
20 20
21 Different users of this interf 21 Different users of this interface will result in different
22 filename prefixes. Currently 22 filename prefixes. Currently two are defined:
23 23
24 - "dmesg" - saved console log 24 - "dmesg" - saved console log
25 - "mce" - architecture depen 25 - "mce" - architecture dependent data from fatal h/w error
26 26
27 Once the information in a file 27 Once the information in a file has been read, removing
28 the file will signal to the un 28 the file will signal to the underlying persistent storage
29 device that it can reclaim the 29 device that it can reclaim the space for later re-use::
30 30
31 $ rm /sys/fs/pstore/dmesg- 31 $ rm /sys/fs/pstore/dmesg-erst-1
32 32
33 The expectation is that all fi 33 The expectation is that all files in /sys/fs/pstore/
34 will be saved elsewhere and er 34 will be saved elsewhere and erased from persistent store
35 soon after boot to free up spa 35 soon after boot to free up space ready for the next
36 catastrophe. 36 catastrophe.
37 37
38 The 'kmsg_bytes' mount option 38 The 'kmsg_bytes' mount option changes the target amount of
39 data saved on each oops/panic. 39 data saved on each oops/panic. Pstore saves (possibly
40 multiple) files based on the r 40 multiple) files based on the record size of the underlying
41 persistent storage until at le 41 persistent storage until at least this amount is reached.
42 Default is 10 Kbytes. 42 Default is 10 Kbytes.
43 43
44 Pstore only supports one backe 44 Pstore only supports one backend at a time. If multiple
45 backends are available, the pr 45 backends are available, the preferred backend may be
46 set by passing the pstore.back 46 set by passing the pstore.backend= argument to the kernel at
47 boot time. 47 boot time.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.