coredumpctl: Add --debugger-args= option

This commit adds the possibility to pass command line options to the
debugger invoked with coredumpctl debug.

Resolves: #9905

1 files changed, 17 insertions, 1 deletions

diff --git a/man/coredumpctl.xml b/man/coredumpctl.xml
index 62dbb314c9..b06cadd08c 100644
--- a/man/coredumpctl.xml
+++ b/man/coredumpctl.xml
@@ -137,7 +137,8 @@
         <citerefentry project='man-pages'><refentrytitle>gdb</refentrytitle><manvolnum>1</manvolnum></citerefentry>
         will be used. This may be changed using the <option>--debugger=</option>
         option or the <varname>$SYSTEMD_DEBUGGER</varname> environment
-        variable.</para></listitem>
+        variable. Use the <option>--debugger-arguments=</option> option to pass extra
+        command line arguments to the debugger.</para></listitem>
       </varlistentry>
 
     </variablelist>
@@ -218,6 +219,15 @@
       </varlistentry>
 
       <varlistentry>
+        <term><option>-A</option> <replaceable>ARGS</replaceable></term>
+        <term><option>--debugger-arguments=</option><replaceable>ARGS</replaceable></term>
+
+        <listitem><para>Pass the given <replaceable>ARGS</replaceable> as extra command line arguments
+        to the debugger. Quote as appropriate when <replaceable>ARGS</replaceable> contain whitespace.
+        (See Examples.)</para></listitem>
+      </varlistentry>
+
+      <varlistentry>
         <term><option>--file=<replaceable>GLOB</replaceable></option></term>
 
         <listitem><para>Takes a file glob as an argument. If
@@ -324,6 +334,12 @@
     </example>
 
     <example>
+      <title>Use gdb to display full register info from the last core dump</title>
+
+      <programlisting># coredumpctl debug --debugger-arguments="-batch -ex 'info all-registers'"</programlisting>
+    </example>
+
+    <example>
       <title>Show information about a process that dumped core,
       matching by its PID 6654</title>