| <html lang="en"> |
| <head> |
| <title>GDB/MI Miscellaneous Commands - Debugging with GDB</title> |
| <meta http-equiv="Content-Type" content="text/html"> |
| <meta name="description" content="Debugging with GDB"> |
| <meta name="generator" content="makeinfo 4.13"> |
| <link title="Top" rel="start" href="index.html#Top"> |
| <link rel="up" href="GDB_002fMI.html#GDB_002fMI" title="GDB/MI"> |
| <link rel="prev" href="GDB_002fMI-Support-Commands.html#GDB_002fMI-Support-Commands" title="GDB/MI Support Commands"> |
| <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> |
| <!-- |
| Copyright (C) 1988-2019 Free Software Foundation, Inc. |
| |
| Permission is granted to copy, distribute and/or modify this document |
| under the terms of the GNU Free Documentation License, Version 1.3 or |
| any later version published by the Free Software Foundation; with the |
| Invariant Sections being ``Free Software'' and ``Free Software Needs |
| Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,'' |
| and with the Back-Cover Texts as in (a) below. |
| |
| (a) The FSF's Back-Cover Text is: ``You are free to copy and modify |
| this GNU Manual. Buying copies from GNU Press supports the FSF in |
| developing GNU and promoting software freedom.'' |
| --> |
| <meta http-equiv="Content-Style-Type" content="text/css"> |
| <style type="text/css"><!-- |
| pre.display { font-family:inherit } |
| pre.format { font-family:inherit } |
| pre.smalldisplay { font-family:inherit; font-size:smaller } |
| pre.smallformat { font-family:inherit; font-size:smaller } |
| pre.smallexample { font-size:smaller } |
| pre.smalllisp { font-size:smaller } |
| span.sc { font-variant:small-caps } |
| span.roman { font-family:serif; font-weight:normal; } |
| span.sansserif { font-family:sans-serif; font-weight:normal; } |
| --></style> |
| </head> |
| <body> |
| <div class="node"> |
| <a name="GDB%2fMI-Miscellaneous-Commands"></a> |
| <a name="GDB_002fMI-Miscellaneous-Commands"></a> |
| <p> |
| Previous: <a rel="previous" accesskey="p" href="GDB_002fMI-Support-Commands.html#GDB_002fMI-Support-Commands">GDB/MI Support Commands</a>, |
| Up: <a rel="up" accesskey="u" href="GDB_002fMI.html#GDB_002fMI">GDB/MI</a> |
| <hr> |
| </div> |
| |
| <h3 class="section">27.24 Miscellaneous <span class="sc">gdb/mi</span> Commands</h3> |
| |
| <!-- @subheading -gdb-complete --> |
| <h4 class="subheading">The <code>-gdb-exit</code> Command</h4> |
| |
| <p><a name="index-g_t_002dgdb_002dexit-3098"></a> |
| |
| <h5 class="subsubheading">Synopsis</h5> |
| |
| <pre class="smallexample"> -gdb-exit |
| </pre> |
| <p>Exit <span class="sc">gdb</span> immediately. |
| |
| <h5 class="subsubheading"><span class="sc">gdb</span> Command</h5> |
| |
| <p>Approximately corresponds to ‘<samp><span class="samp">quit</span></samp>’. |
| |
| <h5 class="subsubheading">Example</h5> |
| |
| <pre class="smallexample"> (gdb) |
| -gdb-exit |
| ^exit |
| </pre> |
| <h4 class="subheading">The <code>-gdb-set</code> Command</h4> |
| |
| <p><a name="index-g_t_002dgdb_002dset-3099"></a> |
| |
| <h5 class="subsubheading">Synopsis</h5> |
| |
| <pre class="smallexample"> -gdb-set |
| </pre> |
| <p>Set an internal <span class="sc">gdb</span> variable. |
| <!-- IS THIS A DOLLAR VARIABLE? OR SOMETHING LIKE ANNOTATE ????? --> |
| |
| <h5 class="subsubheading"><span class="sc">gdb</span> Command</h5> |
| |
| <p>The corresponding <span class="sc">gdb</span> command is ‘<samp><span class="samp">set</span></samp>’. |
| |
| <h5 class="subsubheading">Example</h5> |
| |
| <pre class="smallexample"> (gdb) |
| -gdb-set $foo=3 |
| ^done |
| (gdb) |
| </pre> |
| <h4 class="subheading">The <code>-gdb-show</code> Command</h4> |
| |
| <p><a name="index-g_t_002dgdb_002dshow-3100"></a> |
| |
| <h5 class="subsubheading">Synopsis</h5> |
| |
| <pre class="smallexample"> -gdb-show |
| </pre> |
| <p>Show the current value of a <span class="sc">gdb</span> variable. |
| |
| <h5 class="subsubheading"><span class="sc">gdb</span> Command</h5> |
| |
| <p>The corresponding <span class="sc">gdb</span> command is ‘<samp><span class="samp">show</span></samp>’. |
| |
| <h5 class="subsubheading">Example</h5> |
| |
| <pre class="smallexample"> (gdb) |
| -gdb-show annotate |
| ^done,value="0" |
| (gdb) |
| </pre> |
| <!-- @subheading -gdb-source --> |
| <h4 class="subheading">The <code>-gdb-version</code> Command</h4> |
| |
| <p><a name="index-g_t_002dgdb_002dversion-3101"></a> |
| |
| <h5 class="subsubheading">Synopsis</h5> |
| |
| <pre class="smallexample"> -gdb-version |
| </pre> |
| <p>Show version information for <span class="sc">gdb</span>. Used mostly in testing. |
| |
| <h5 class="subsubheading"><span class="sc">gdb</span> Command</h5> |
| |
| <p>The <span class="sc">gdb</span> equivalent is ‘<samp><span class="samp">show version</span></samp>’. <span class="sc">gdb</span> by |
| default shows this information when you start an interactive session. |
| |
| <h5 class="subsubheading">Example</h5> |
| |
| <!-- This example modifies the actual output from GDB to avoid overfull --> |
| <!-- box in TeX. --> |
| <pre class="smallexample"> (gdb) |
| -gdb-version |
| ~GNU gdb 5.2.1 |
| ~Copyright 2000 Free Software Foundation, Inc. |
| ~GDB is free software, covered by the GNU General Public License, and |
| ~you are welcome to change it and/or distribute copies of it under |
| ~ certain conditions. |
| ~Type "show copying" to see the conditions. |
| ~There is absolutely no warranty for GDB. Type "show warranty" for |
| ~ details. |
| ~This GDB was configured as |
| "--host=sparc-sun-solaris2.5.1 --target=ppc-eabi". |
| ^done |
| (gdb) |
| </pre> |
| <h4 class="subheading">The <code>-list-thread-groups</code> Command</h4> |
| |
| <p><a name="index-g_t_002dlist_002dthread_002dgroups-3102"></a> |
| |
| <h4 class="subheading">Synopsis</h4> |
| |
| <pre class="smallexample"> -list-thread-groups [ --available ] [ --recurse 1 ] [ <var>group</var> ... ] |
| </pre> |
| <p>Lists thread groups (see <a href="Thread-groups.html#Thread-groups">Thread groups</a>). When a single thread |
| group is passed as the argument, lists the children of that group. |
| When several thread group are passed, lists information about those |
| thread groups. Without any parameters, lists information about all |
| top-level thread groups. |
| |
| <p>Normally, thread groups that are being debugged are reported. |
| With the ‘<samp><span class="samp">--available</span></samp>’ option, <span class="sc">gdb</span> reports thread groups |
| available on the target. |
| |
| <p>The output of this command may have either a ‘<samp><span class="samp">threads</span></samp>’ result or |
| a ‘<samp><span class="samp">groups</span></samp>’ result. The ‘<samp><span class="samp">thread</span></samp>’ result has a list of tuples |
| as value, with each tuple describing a thread (see <a href="GDB_002fMI-Thread-Information.html#GDB_002fMI-Thread-Information">GDB/MI Thread Information</a>). The ‘<samp><span class="samp">groups</span></samp>’ result has a list of tuples as value, |
| each tuple describing a thread group. If top-level groups are |
| requested (that is, no parameter is passed), or when several groups |
| are passed, the output always has a ‘<samp><span class="samp">groups</span></samp>’ result. The format |
| of the ‘<samp><span class="samp">group</span></samp>’ result is described below. |
| |
| <p>To reduce the number of roundtrips it's possible to list thread groups |
| together with their children, by passing the ‘<samp><span class="samp">--recurse</span></samp>’ option |
| and the recursion depth. Presently, only recursion depth of 1 is |
| permitted. If this option is present, then every reported thread group |
| will also include its children, either as ‘<samp><span class="samp">group</span></samp>’ or |
| ‘<samp><span class="samp">threads</span></samp>’ field. |
| |
| <p>In general, any combination of option and parameters is permitted, with |
| the following caveats: |
| |
| <ul> |
| <li>When a single thread group is passed, the output will typically |
| be the ‘<samp><span class="samp">threads</span></samp>’ result. Because threads may not contain |
| anything, the ‘<samp><span class="samp">recurse</span></samp>’ option will be ignored. |
| |
| <li>When the ‘<samp><span class="samp">--available</span></samp>’ option is passed, limited information may |
| be available. In particular, the list of threads of a process might |
| be inaccessible. Further, specifying specific thread groups might |
| not give any performance advantage over listing all thread groups. |
| The frontend should assume that ‘<samp><span class="samp">-list-thread-groups --available</span></samp>’ |
| is always an expensive operation and cache the results. |
| |
| </ul> |
| |
| <p>The ‘<samp><span class="samp">groups</span></samp>’ result is a list of tuples, where each tuple may |
| have the following fields: |
| |
| <dl> |
| <dt><code>id</code><dd>Identifier of the thread group. This field is always present. |
| The identifier is an opaque string; frontends should not try to |
| convert it to an integer, even though it might look like one. |
| |
| <br><dt><code>type</code><dd>The type of the thread group. At present, only ‘<samp><span class="samp">process</span></samp>’ is a |
| valid type. |
| |
| <br><dt><code>pid</code><dd>The target-specific process identifier. This field is only present |
| for thread groups of type ‘<samp><span class="samp">process</span></samp>’ and only if the process exists. |
| |
| <br><dt><code>exit-code</code><dd>The exit code of this group's last exited thread, formatted in octal. |
| This field is only present for thread groups of type ‘<samp><span class="samp">process</span></samp>’ and |
| only if the process is not running. |
| |
| <br><dt><code>num_children</code><dd>The number of children this thread group has. This field may be |
| absent for an available thread group. |
| |
| <br><dt><code>threads</code><dd>This field has a list of tuples as value, each tuple describing a |
| thread. It may be present if the ‘<samp><span class="samp">--recurse</span></samp>’ option is |
| specified, and it's actually possible to obtain the threads. |
| |
| <br><dt><code>cores</code><dd>This field is a list of integers, each identifying a core that one |
| thread of the group is running on. This field may be absent if |
| such information is not available. |
| |
| <br><dt><code>executable</code><dd>The name of the executable file that corresponds to this thread group. |
| The field is only present for thread groups of type ‘<samp><span class="samp">process</span></samp>’, |
| and only if there is a corresponding executable file. |
| |
| </dl> |
| |
| <h4 class="subheading">Example</h4> |
| |
| <pre class="smallexample"> gdb |
| -list-thread-groups |
| ^done,groups=[{id="17",type="process",pid="yyy",num_children="2"}] |
| -list-thread-groups 17 |
| ^done,threads=[{id="2",target-id="Thread 0xb7e14b90 (LWP 21257)", |
| frame={level="0",addr="0xffffe410",func="__kernel_vsyscall",args=[]},state="running"}, |
| {id="1",target-id="Thread 0xb7e156b0 (LWP 21254)", |
| frame={level="0",addr="0x0804891f",func="foo",args=[{name="i",value="10"}], |
| file="/tmp/a.c",fullname="/tmp/a.c",line="158",arch="i386:x86_64"},state="running"}]] |
| -list-thread-groups --available |
| ^done,groups=[{id="17",type="process",pid="yyy",num_children="2",cores=[1,2]}] |
| -list-thread-groups --available --recurse 1 |
| ^done,groups=[{id="17", types="process",pid="yyy",num_children="2",cores=[1,2], |
| threads=[{id="1",target-id="Thread 0xb7e14b90",cores=[1]}, |
| {id="2",target-id="Thread 0xb7e14b90",cores=[2]}]},..] |
| -list-thread-groups --available --recurse 1 17 18 |
| ^done,groups=[{id="17", types="process",pid="yyy",num_children="2",cores=[1,2], |
| threads=[{id="1",target-id="Thread 0xb7e14b90",cores=[1]}, |
| {id="2",target-id="Thread 0xb7e14b90",cores=[2]}]},...] |
| </pre> |
| <h4 class="subheading">The <code>-info-os</code> Command</h4> |
| |
| <p><a name="index-g_t_002dinfo_002dos-3103"></a> |
| |
| <h5 class="subsubheading">Synopsis</h5> |
| |
| <pre class="smallexample"> -info-os [ <var>type</var> ] |
| </pre> |
| <p>If no argument is supplied, the command returns a table of available |
| operating-system-specific information types. If one of these types is |
| supplied as an argument <var>type</var>, then the command returns a table |
| of data of that type. |
| |
| <p>The types of information available depend on the target operating |
| system. |
| |
| <h5 class="subsubheading"><span class="sc">gdb</span> Command</h5> |
| |
| <p>The corresponding <span class="sc">gdb</span> command is ‘<samp><span class="samp">info os</span></samp>’. |
| |
| <h5 class="subsubheading">Example</h5> |
| |
| <p>When run on a <span class="sc">gnu</span>/Linux system, the output will look something |
| like this: |
| |
| <pre class="smallexample"> gdb |
| -info-os |
| ^done,OSDataTable={nr_rows="10",nr_cols="3", |
| hdr=[{width="10",alignment="-1",col_name="col0",colhdr="Type"}, |
| {width="10",alignment="-1",col_name="col1",colhdr="Description"}, |
| {width="10",alignment="-1",col_name="col2",colhdr="Title"}], |
| body=[item={col0="cpus",col1="Listing of all cpus/cores on the system", |
| col2="CPUs"}, |
| item={col0="files",col1="Listing of all file descriptors", |
| col2="File descriptors"}, |
| item={col0="modules",col1="Listing of all loaded kernel modules", |
| col2="Kernel modules"}, |
| item={col0="msg",col1="Listing of all message queues", |
| col2="Message queues"}, |
| item={col0="processes",col1="Listing of all processes", |
| col2="Processes"}, |
| item={col0="procgroups",col1="Listing of all process groups", |
| col2="Process groups"}, |
| item={col0="semaphores",col1="Listing of all semaphores", |
| col2="Semaphores"}, |
| item={col0="shm",col1="Listing of all shared-memory regions", |
| col2="Shared-memory regions"}, |
| item={col0="sockets",col1="Listing of all internet-domain sockets", |
| col2="Sockets"}, |
| item={col0="threads",col1="Listing of all threads", |
| col2="Threads"}] |
| gdb |
| -info-os processes |
| ^done,OSDataTable={nr_rows="190",nr_cols="4", |
| hdr=[{width="10",alignment="-1",col_name="col0",colhdr="pid"}, |
| {width="10",alignment="-1",col_name="col1",colhdr="user"}, |
| {width="10",alignment="-1",col_name="col2",colhdr="command"}, |
| {width="10",alignment="-1",col_name="col3",colhdr="cores"}], |
| body=[item={col0="1",col1="root",col2="/sbin/init",col3="0"}, |
| item={col0="2",col1="root",col2="[kthreadd]",col3="1"}, |
| item={col0="3",col1="root",col2="[ksoftirqd/0]",col3="0"}, |
| ... |
| item={col0="26446",col1="stan",col2="bash",col3="0"}, |
| item={col0="28152",col1="stan",col2="bash",col3="1"}]} |
| (gdb) |
| </pre> |
| <p>(Note that the MI output here includes a <code>"Title"</code> column that |
| does not appear in command-line <code>info os</code>; this column is useful |
| for MI clients that want to enumerate the types of data, such as in a |
| popup menu, but is needless clutter on the command line, and |
| <code>info os</code> omits it.) |
| |
| <h4 class="subheading">The <code>-add-inferior</code> Command</h4> |
| |
| <p><a name="index-g_t_002dadd_002dinferior-3104"></a> |
| |
| <h4 class="subheading">Synopsis</h4> |
| |
| <pre class="smallexample"> -add-inferior |
| </pre> |
| <p>Creates a new inferior (see <a href="Inferiors-and-Programs.html#Inferiors-and-Programs">Inferiors and Programs</a>). The created |
| inferior is not associated with any executable. Such association may |
| be established with the ‘<samp><span class="samp">-file-exec-and-symbols</span></samp>’ command |
| (see <a href="GDB_002fMI-File-Commands.html#GDB_002fMI-File-Commands">GDB/MI File Commands</a>). The command response has a single |
| field, ‘<samp><span class="samp">inferior</span></samp>’, whose value is the identifier of the |
| thread group corresponding to the new inferior. |
| |
| <h4 class="subheading">Example</h4> |
| |
| <pre class="smallexample"> gdb |
| -add-inferior |
| ^done,inferior="i3" |
| </pre> |
| <h4 class="subheading">The <code>-interpreter-exec</code> Command</h4> |
| |
| <p><a name="index-g_t_002dinterpreter_002dexec-3105"></a> |
| |
| <h4 class="subheading">Synopsis</h4> |
| |
| <pre class="smallexample"> -interpreter-exec <var>interpreter</var> <var>command</var> |
| </pre> |
| <p><a name="g_t_002dinterpreter_002dexec"></a>Execute the specified <var>command</var> in the given <var>interpreter</var>. |
| |
| <h4 class="subheading"><span class="sc">gdb</span> Command</h4> |
| |
| <p>The corresponding <span class="sc">gdb</span> command is ‘<samp><span class="samp">interpreter-exec</span></samp>’. |
| |
| <h4 class="subheading">Example</h4> |
| |
| <pre class="smallexample"> (gdb) |
| -interpreter-exec console "break main" |
| &"During symbol reading, couldn't parse type; debugger out of date?.\n" |
| &"During symbol reading, bad structure-type format.\n" |
| ~"Breakpoint 1 at 0x8074fc6: file ../../src/gdb/main.c, line 743.\n" |
| ^done |
| (gdb) |
| </pre> |
| <h4 class="subheading">The <code>-inferior-tty-set</code> Command</h4> |
| |
| <p><a name="index-g_t_002dinferior_002dtty_002dset-3106"></a> |
| |
| <h4 class="subheading">Synopsis</h4> |
| |
| <pre class="smallexample"> -inferior-tty-set /dev/pts/1 |
| </pre> |
| <p>Set terminal for future runs of the program being debugged. |
| |
| <h4 class="subheading"><span class="sc">gdb</span> Command</h4> |
| |
| <p>The corresponding <span class="sc">gdb</span> command is ‘<samp><span class="samp">set inferior-tty</span></samp>’ /dev/pts/1. |
| |
| <h4 class="subheading">Example</h4> |
| |
| <pre class="smallexample"> (gdb) |
| -inferior-tty-set /dev/pts/1 |
| ^done |
| (gdb) |
| </pre> |
| <h4 class="subheading">The <code>-inferior-tty-show</code> Command</h4> |
| |
| <p><a name="index-g_t_002dinferior_002dtty_002dshow-3107"></a> |
| |
| <h4 class="subheading">Synopsis</h4> |
| |
| <pre class="smallexample"> -inferior-tty-show |
| </pre> |
| <p>Show terminal for future runs of program being debugged. |
| |
| <h4 class="subheading"><span class="sc">gdb</span> Command</h4> |
| |
| <p>The corresponding <span class="sc">gdb</span> command is ‘<samp><span class="samp">show inferior-tty</span></samp>’. |
| |
| <h4 class="subheading">Example</h4> |
| |
| <pre class="smallexample"> (gdb) |
| -inferior-tty-set /dev/pts/1 |
| ^done |
| (gdb) |
| -inferior-tty-show |
| ^done,inferior_tty_terminal="/dev/pts/1" |
| (gdb) |
| </pre> |
| <h4 class="subheading">The <code>-enable-timings</code> Command</h4> |
| |
| <p><a name="index-g_t_002denable_002dtimings-3108"></a> |
| |
| <h4 class="subheading">Synopsis</h4> |
| |
| <pre class="smallexample"> -enable-timings [yes | no] |
| </pre> |
| <p>Toggle the printing of the wallclock, user and system times for an MI |
| command as a field in its output. This command is to help frontend |
| developers optimize the performance of their code. No argument is |
| equivalent to ‘<samp><span class="samp">yes</span></samp>’. |
| |
| <h4 class="subheading"><span class="sc">gdb</span> Command</h4> |
| |
| <p>No equivalent. |
| |
| <h4 class="subheading">Example</h4> |
| |
| <pre class="smallexample"> (gdb) |
| -enable-timings |
| ^done |
| (gdb) |
| -break-insert main |
| ^done,bkpt={number="1",type="breakpoint",disp="keep",enabled="y", |
| addr="0x080484ed",func="main",file="myprog.c", |
| fullname="/home/nickrob/myprog.c",line="73",thread-groups=["i1"], |
| times="0"}, |
| time={wallclock="0.05185",user="0.00800",system="0.00000"} |
| (gdb) |
| -enable-timings no |
| ^done |
| (gdb) |
| -exec-run |
| ^running |
| (gdb) |
| *stopped,reason="breakpoint-hit",disp="keep",bkptno="1",thread-id="0", |
| frame={addr="0x080484ed",func="main",args=[{name="argc",value="1"}, |
| {name="argv",value="0xbfb60364"}],file="myprog.c", |
| fullname="/home/nickrob/myprog.c",line="73",arch="i386:x86_64"} |
| (gdb) |
| </pre> |
| </body></html> |
| |
