Debian Codegraph @

upstream/debian-unstable/man8/systemd-pstore.service.8

raw
1 '\" t
2 .TH "SYSTEMD\-PSTORE\&.SERVICE" "8" "" "systemd 261~rc3" "systemd-pstore.service"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd-pstore.service, systemd-pstore \- A service to archive contents of pstore
24 .SH "SYNOPSIS"
25 .PP
26 /usr/lib/systemd/systemd\-pstore
27 .PP
28 systemd\-pstore\&.service
29 .SH "DESCRIPTION"
30 .PP
31 systemd\-pstore\&.service
32 is a system service that archives the contents of the Linux persistent storage filesystem, pstore, to other storage, thus preserving the existing information contained in the pstore, and clearing pstore storage for future error events\&.
33 .PP
34 Linux provides a persistent storage file system, pstore, that can store error records when the kernel dies (or reboots or powers\-off)\&. These records in turn can be referenced to debug kernel problems (currently the kernel stores the tail of the kernel log, which also contains a stack backtrace, into pstore)\&.
35 .PP
36 The pstore file system supports a variety of backends that map onto persistent storage, such as the ACPI ERST and UEFI variables\&. The pstore backends typically offer a relatively small amount of persistent storage, e\&.g\&. 64KiB, which can quickly fill up and thus prevent subsequent kernel crashes from recording errors\&. Thus there is a need to monitor and extract the pstore contents so that future kernel problems can also record information in the pstore\&.
37 .PP
38 The pstore service is independent of the kdump service\&. In cloud environments specifically, host and guest filesystems are on remote filesystems (e\&.g\&. iSCSI or NFS), thus kdump relies (implicitly and/or explicitly) upon proper operation of networking software *and* hardware *and* infrastructure\&. Thus it may not be possible to capture a kernel coredump to a file since writes over the network may not be possible\&.
39 .PP
40 The pstore backend, on the other hand, is completely local and provides a path to store error records which will survive a reboot and aid in post\-mortem debugging\&.
41 .PP
42 The
43 \fBsystemd\-pstore\fR
44 executable does the actual work\&. Upon starting, the
45 pstore\&.conf
46 file is read and the
47 /sys/fs/pstore/
48 directory contents are processed according to the options\&. Pstore files are written to the journal, and optionally saved into
49 /var/lib/systemd/pstore/\&.
50 .SH "CONFIGURATION"
51 .PP
52 The behavior of
53 \fBsystemd\-pstore\fR
54 is configured through the configuration file
55 /etc/systemd/pstore\&.conf
56 and corresponding snippets
57 /etc/systemd/pstore\&.conf\&.d/*\&.conf, see
58 \fBpstore.conf\fR(5)\&.
59 .SS "Disabling pstore processing"
60 .PP
61 To disable pstore processing by
62 \fBsystemd\-pstore\fR, set
63 .sp
64 .if n \{\
65 .RS 4
66 .\}
67 .nf
68 Storage=none
69 .fi
70 .if n \{\
71 .RE
72 .\}
73 .sp
74 in
75 \fBpstore.conf\fR(5)\&.
76 .SS "Kernel parameters"
77 .PP
78 The kernel has two parameters,
79 /sys/module/kernel/parameters/crash_kexec_post_notifiers
80 and
81 /sys/module/printk/parameters/always_kmsg_dump, that control writes into pstore\&. The first enables storing of the kernel log (including stack trace) into pstore upon a panic or crash, and the second enables storing of the kernel log upon a normal shutdown (shutdown, reboot, halt)\&. These parameters can be managed via the
82 \fBtmpfiles.d\fR(5)
83 mechanism, specifically the file
84 /usr/lib/tmpfiles/systemd\-pstore\&.conf\&.
85 .SH "USAGE"
86 .PP
87 Data stored in the journal can be viewed with
88 \fBjournalctl\fR(1)
89 as usual\&.
90 .SH "SEE ALSO"
91 .PP
92 \fBpstore.conf\fR(5)