pstore: new filesystem interface to platform persistent storage
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / Documentation / ABI / testing / pstore
blobf1fb2a004264bc6989a20d92ca333b436c7154d4
1 Where:          /dev/pstore/...
2 Date:           January 2011
3 Kernel Version: 2.6.38
4 Contact:        tony.luck@intel.com
5 Description:    Generic interface to platform dependent persistent storage.
7                 Platforms that provide a mechanism to preserve some data
8                 across system reboots can register with this driver to
9                 provide a generic interface to show records captured in
10                 the dying moments.  In the case of a panic the last part
11                 of the console log is captured, but other interesting
12                 data can also be saved.
14                 # mount -t pstore - /dev/pstore
16                 $ ls -l /dev/pstore
17                 total 0
18                 -r--r--r-- 1 root root 7896 Nov 30 15:38 dmesg-erst-1
20                 Different users of this interface will result in different
21                 filename prefixes.  Currently two are defined:
23                 "dmesg" - saved console log
24                 "mce"   - architecture dependent data from fatal h/w error
26                 Once the information in a file has been read, removing
27                 the file will signal to the underlying persistent storage
28                 device that it can reclaim the space for later re-use.
30                 $ rm /dev/pstore/dmesg-erst-1
32                 The expectation is that all files in /dev/pstore
33                 will be saved elsewhere and erased from persistent store
34                 soon after boot to free up space ready for the next
35                 catastrophe.