blob: d31409c1a0306042e1044072cd25232243d460dd [file] [log] [blame]
<html lang="en">
<head>
<title>GDB/MI Result Records - 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-Output-Records.html#GDB_002fMI-Output-Records" title="GDB/MI Output Records">
<link rel="next" href="GDB_002fMI-Stream-Records.html#GDB_002fMI-Stream-Records" title="GDB/MI Stream Records">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
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>
<link rel="stylesheet" type="text/css" href="../cs.css">
</head>
<body>
<div class="node">
<a name="GDB%2fMI-Result-Records"></a>
<a name="GDB_002fMI-Result-Records"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="GDB_002fMI-Stream-Records.html#GDB_002fMI-Stream-Records">GDB/MI Stream Records</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="GDB_002fMI-Output-Records.html#GDB_002fMI-Output-Records">GDB/MI Output Records</a>
<hr>
</div>
<h4 class="subsection">27.5.1 <span class="sc">gdb/mi</span> Result Records</h4>
<p><a name="index-result-records-in-_0040sc_007bgdb_002fmi_007d-2018"></a><a name="index-g_t_0040sc_007bgdb_002fmi_007d_002c-result-records-2019"></a>In addition to a number of out-of-band notifications, the response to a
<span class="sc">gdb/mi</span> command includes one of the following result indications:
<a name="index-g_t_005edone-2020"></a>
<dl><dt><code>"^done" [ "," </code><var>results</var><code> ]</code><dd>The synchronous operation was successful, <var>results</var> are the return
values.
<br><dt><code>"^running"</code><dd><a name="index-g_t_005erunning-2021"></a>This result record is equivalent to &lsquo;<samp><span class="samp">^done</span></samp>&rsquo;. Historically, it
was output instead of &lsquo;<samp><span class="samp">^done</span></samp>&rsquo; if the command has resumed the
target. This behaviour is maintained for backward compatibility, but
all frontends should treat &lsquo;<samp><span class="samp">^done</span></samp>&rsquo; and &lsquo;<samp><span class="samp">^running</span></samp>&rsquo;
identically and rely on the &lsquo;<samp><span class="samp">*running</span></samp>&rsquo; output record to determine
which threads are resumed.
<br><dt><code>"^connected"</code><dd><a name="index-g_t_005econnected-2022"></a><span class="sc">gdb</span> has connected to a remote target.
<br><dt><code>"^error" "," </code><var>c-string</var><dd><a name="index-g_t_005eerror-2023"></a>The operation failed. The <var>c-string</var> contains the corresponding
error message.
<br><dt><code>"^exit"</code><dd><a name="index-g_t_005eexit-2024"></a><span class="sc">gdb</span> has terminated.
</dl>
</body></html>