From 5a9630dff6e7c45b1afcb639edc8003afbd0a3ac Mon Sep 17 00:00:00 2001 From: Leena Miettinen Date: Mon, 21 Oct 2024 13:53:28 +0200 Subject: [PATCH] Doc: Describe Debug > Start Debugging > Load Last Core File Task-number: QTCREATORBUG-31510 Change-Id: I6f974c32f0480f28abb97df1304c6a43ba86154e Reviewed-by: Friedemann Kleint Reviewed-by: hjk --- .../creator-only/creator-debugger.qdoc | 21 +++++++++++++++---- .../external-resources.qdoc | 4 ++++ 2 files changed, 21 insertions(+), 4 deletions(-) diff --git a/doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc b/doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc index 26884aee027..130a4665e0d 100644 --- a/doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc +++ b/doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc @@ -421,6 +421,8 @@ generated from crashed processes on Linux and Unix systems if the system is set up to allow this. + \section1 Get core files + To enable the dumping of core files on a Unix system, enter the following command in the shell from which the application is launched: @@ -428,11 +430,13 @@ ulimit -c unlimited \endcode + \section1 Attach to a core file + To launch the debugger in the core mode: \list 1 - \li Go to \uicontrol Debug > \uicontrol {Start Debugging} > - \uicontrol {Load Core File}. + \li Go to \uicontrol Debug > \uicontrol {Start Debugging}, and then + select \uicontrol {Load Core File}. \image qtcreator-debugger-load-core-file.png \li In \uicontrol Kit, select a build and run kit that was used for building the binary for which the core file was created. @@ -452,8 +456,17 @@ the \c sysroot to use instead of the default \c sysroot. \endlist - Even though using a properly configured project that has the sources of the - crashed application is not strictly necessary, it is helpful. + For better results, use a properly configured project that has the sources of + the crashed application. + + \section1 Attach to the latest core file + + On Linux systems, \QC uses the \c coredumpctl command provided by the + \c systemd crash handling to get core files. For more information, see + \l {systemd-coredump}. + + To attach to the latest core file, go to \uicontrol Debug > + \uicontrol {Start Debugging}, and then select \uicontrol {Load Last Core File}. \sa {Debug}{How To: Debug}, {Debugging}, {Debuggers}, {Debugger}, {Kits} */ diff --git a/doc/qtcreator/src/external-resources/external-resources.qdoc b/doc/qtcreator/src/external-resources/external-resources.qdoc index bc9ee595a80..d7ab44bbe67 100644 --- a/doc/qtcreator/src/external-resources/external-resources.qdoc +++ b/doc/qtcreator/src/external-resources/external-resources.qdoc @@ -5,6 +5,10 @@ \externalpage https://doc.qt.io/index.html \title Qt Documentation */ +/*! + \externalpage https://www.freedesktop.org/software/systemd/man/latest/systemd-coredump.html + \title systemd-coredump +*/ /*! \externalpage https://www.perforce.com/manuals/cmdref/Content/CmdRef/P4CONFIG.html \title Perforce: P4CONFIG