1COREDUMPCTL(1)                    coredumpctl                   COREDUMPCTL(1)
2
3
4

NAME

6       coredumpctl - Retrieve coredumps from the journal
7

SYNOPSIS

9       coredumpctl [OPTIONS...] {COMMAND} [PID|COMM|EXE|MATCH...]
10

DESCRIPTION

12       coredumpctl may be used to retrieve coredumps from systemd-journald(8).
13

OPTIONS

15       The following options are understood:
16
17       --no-legend
18           Do not print column headers.
19
20       -1
21           Show information of a single coredump only, instead of listing all
22           known coredumps.
23
24       -F, --field=
25           Print all possible data values the specified field takes in
26           matching coredump entries of the journal.
27
28       -o, --output=FILE
29           Write the core to FILE.
30
31       -h, --help
32           Print a short help text and exit.
33
34       --version
35           Print a short version string and exit.
36
37       --no-pager
38           Do not pipe output into a pager.
39
40       The following commands are understood:
41
42       list
43           List coredumps captured in the journal matching specified
44           characteristics. If no command is specified, this is the implied
45           default.
46
47       info
48           Show detailed information about coredumps captured in the journal.
49
50       dump
51           Extract the last coredump matching specified characteristics. The
52           coredump will be written on standard output, unless an output file
53           is specified with -o/--output.
54
55       gdb
56           Invoke the GNU debugger on the last coredump matching specified
57           characteristics.
58

MATCHING

60       A match can be:
61
62       PID
63           Process ID of the process that dumped core. An integer.
64
65       COMM
66           Name of the executable (matches COREDUMP_COMM=). Must not contain
67           slashes.
68
69       EXE
70           Path to the executable (matches COREDUMP_EXE=). Must contain at
71           least one slash.
72
73       MATCH
74           General journalctl predicates (see journalctl(1)). Must contain an
75           equal sign.
76

EXIT STATUS

78       On success, 0 is returned; otherwise, a non-zero failure code is
79       returned. Not finding any matching coredumps is treated as failure.
80

EXAMPLES

82       Example 1. List all the coredumps of a program named foo
83
84           # coredumpctl list foo
85
86       Example 2. Invoke gdb on the last coredump
87
88           # coredumpctl gdb
89
90       Example 3. Show information about a process that dumped core, matching
91       by its PID 6654
92
93           # coredumpctl info 6654
94
95       Example 4. Extract the last coredump of /usr/bin/bar to a file named
96       bar.coredump
97
98           # coredumpctl -o bar.coredump dump /usr/bin/bar
99

SEE ALSO

101       systemd-coredump(8), coredump.conf(5), systemd-journald.service(8),
102       gdb(1)
103
104
105
106systemd 219                                                     COREDUMPCTL(1)
Impressum