NAME | SYNOPSIS | DESCRIPTION | OPTIONS | MATCHING | EXIT STATUS | SEE ALSO | COLOPHON

SYSTEMD-COREDUMPCTL(1)       systemd-coredumpctl      SYSTEMD-COREDUMPCTL(1)

NAME         top

       systemd-coredumpctl - Retrieve coredumps from the journal

SYNOPSIS         top

       systemd-coredumpctl [OPTIONS...] {COMMAND} [PID|COMM|EXE|MATCH...]

DESCRIPTION         top

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

OPTIONS         top

       The following options are understood:

       -F, --field=
           Print all possible data values the specified field takes in
           matching coredump entries of the journal.

       -o, --output=FILE
           Write the core to FILE.

       --no-legend
           Do not print the column headers.

       -h, --help
           Print a short help text and exit.

       --version
           Print a short version string and exit.

       --no-pager
           Do not pipe output into a pager.

       The following commands are understood:

       list
           List coredumps captured in the journal matching specified
           characteristics.

       dump
           Extract the last coredump matching specified characteristics. The
           coredump will be written on standard output, unless an output
           file is specified with -o/--output.

       gdb
           Invoke the GNU debugger on the last coredump matching specified
           characteristics.

MATCHING         top

       Match can be:

       PID
           Process ID of the process that dumped core. An integer.

       COMM
           Name of the executable (matches COREDUMP_COMM=). Must not contain
           slashes.

       EXE
           Path to the executable (matches COREDUMP_EXE=). Must contain at
           least one slash.

       MATCH
           General journalctl predicates (see journalctl(1)). Must contain
           an equals sign.

EXIT STATUS         top

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

SEE ALSO         top

       systemd-journald.service(8), gdb(1)

COLOPHON         top

       This page is part of the systemd (systemd system and service manager)
       project.  Information about the project can be found at 
       ⟨http://www.freedesktop.org/wiki/Software/systemd⟩.  If you have a bug
       report for this manual page, see 
       ⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.  This
       page was obtained from the project's upstream Git repository
       (git://anongit.freedesktop.org/systemd/systemd) on 2015-12-05.  If
       you discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for the
       page, or you have corrections or improvements to the information in
       this COLOPHON (which is not part of the original manual page), send a
       mail to man-pages@man7.org

systemd 214                                           SYSTEMD-COREDUMPCTL(1)