table of contents
- stretch 232-25+deb9u11
- testing 241-5
- stretch-backports 241-3~bpo9+1
- unstable 241-5
- experimental 242-2
COREDUMPCTL(1) | coredumpctl | COREDUMPCTL(1) |
NAME¶
coredumpctl - Retrieve and process saved core dumps and metadataSYNOPSIS¶
coredumpctl [OPTIONS...] {COMMAND} [PID|COMM|EXE|MATCH...]
DESCRIPTION¶
coredumpctl is a tool that can be used to retrieve and process core dumps and metadata which were saved by systemd-coredump(8).OPTIONS¶
The following options are understood:-h, --help
--version
--no-legend
--no-pager
-1
-F FIELD, --field=FIELD
-o FILE, --output=FILE
-D DIR, --directory=DIR
COMMANDS¶
The following commands are understood:list
It's worth noting that different restrictions apply to data saved in the journal and core dump files saved in /var/lib/systemd/coredump, see overview in systemd-coredump(8). Thus it may very well happen that a particular core dump is still listed in the journal while its corresponding core dump file has already been removed.
info
dump
gdb
MATCHING¶
A match can be:PID
COMM
EXE
MATCH
EXIT STATUS¶
On success, 0 is returned; otherwise, a non-zero failure code is returned. Not finding any matching core dumps is treated as failure.EXAMPLES¶
Example 1. List all the core dumps of a program named foo# coredumpctl list foo
Example 2. Invoke gdb on the last core dump
# coredumpctl gdb
Example 3. Show information about a process that dumped core, matching by its PID 6654
# coredumpctl info 6654
Example 4. Extract the last core dump of /usr/bin/bar to a file named bar.coredump
# coredumpctl -o bar.coredump dump /usr/bin/bar
SEE ALSO¶
systemd-coredump(8), coredump.conf(5), systemd-journald.service(8), gdb(1)systemd 232 |