1SYSTEMD-PSTORE.SERVICE(8) systemd-pstore.service SYSTEMD-PSTORE.SERVICE(8)
2
3
4
6 systemd-pstore.service, systemd-pstore - A service to archive contents
7 of pstore
8
10 /usr/lib/systemd/systemd-pstore
11
12 systemd-pstore.service
13
15 systemd-pstore.service is a system service that archives the contents
16 of the Linux persistent storage filesystem, pstore, to other storage,
17 thus preserving the existing information contained in the pstore, and
18 clearing pstore storage for future error events.
19
20 Linux provides a persistent storage file system, pstore, that can store
21 error records when the kernel dies (or reboots or powers-off). These
22 records in turn can be referenced to debug kernel problems (currently
23 the kernel stuffs the tail of the dmesg, which also contains a stack
24 backtrace, into pstore).
25
26 The pstore file system supports a variety of backends that map onto
27 persistent storage, such as the ACPI ERST and UEFI variables. The
28 pstore backends typically offer a relatively small amount of persistent
29 storage, e.g. 64KiB, which can quickly fill up and thus prevent
30 subsequent kernel crashes from recording errors. Thus there is a need
31 to monitor and extract the pstore contents so that future kernel
32 problems can also record information in the pstore.
33
34 The pstore service is independent of the kdump service. In cloud
35 environments specifically, host and guest filesystems are on remote
36 filesystems (eg. iSCSI or NFS), thus kdump relies (implicitly and/or
37 explicitly) upon proper operation of networking software *and* hardware
38 *and* infrastructure. Thus it may not be possible to capture a kernel
39 coredump to a file since writes over the network may not be possible.
40
41 The pstore backend, on the other hand, is completely local and provides
42 a path to store error records which will survive a reboot and aid in
43 post-mortem debugging.
44
45 The systemd-pstore executable does the actual work. Upon starting, the
46 pstore.conf file is read and the /sys/fs/pstore directory contents are
47 processed according to the options. Pstore files are written to the
48 journal, and optionally saved into /var/lib/systemd/pstore.
49
51 The behavior of systemd-pstore is configured through the configuration
52 file /etc/systemd/pstore.conf and corresponding snippets
53 /etc/systemd/pstore.conf.d/*.conf, see pstore.conf(5).
54
55 Disabling pstore processing
56 To disable pstore processing by systemd-pstore, set
57
58 Storage=none
59
60 in pstore.conf(5).
61
63 Data stored in the journal can be viewed with journalctl(1) as usual.
64
66 pstore.conf(5)
67
68
69
70systemd 245 SYSTEMD-PSTORE.SERVICE(8)