mingw/info/gdb/GDB-MI-Target-Manipulation.html

   1 <html lang="en">
   2 <head>
   3 <title>Debugging with GDB</title>
   4 <meta http-equiv="Content-Type" content="text/html">
   5 <meta name="description" content="Debugging with GDB">
   6 <meta name="generator" content="makeinfo 4.3">
   7 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home">
   8 </head>
   9 <body>
  10 <div class="node">
  11 <p>
  12 Node:<a name="GDB%2fMI%20Target%20Manipulation">GDB/MI Target Manipulation</a>,
  13 Next:<a rel="next" accesskey="n" href="GDB-MI-Thread-Commands.html#GDB%2fMI%20Thread%20Commands">GDB/MI Thread Commands</a>,
  14 Previous:<a rel="previous" accesskey="p" href="GDB-MI-Symbol-Query.html#GDB%2fMI%20Symbol%20Query">GDB/MI Symbol Query</a>,
  15 Up:<a rel="up" accesskey="u" href="GDB-MI.html#GDB%2fMI">GDB/MI</a>
  16 <hr><br>
  17 </div>
  18
  19 <h3 class="section"><small>GDB/MI</small> Target Manipulation Commands</h3>
  20
  21 <h4 class="subheading">The <code>-target-attach</code> Command</h4>
  22
  23 <h5 class="subsubheading">Synopsis</h5>
  24
  25 <pre class="example">      -target-attach <var>pid</var> | <var>file</var>
  26      </pre>
  27
  28    <p>Attach to a process <var>pid</var> or a file <var>file</var> outside of GDB.
  29
  30 <h5 class="subsubheading">GDB command</h5>
  31
  32    <p>The corresponding GDB command is <code>attach</code>.
  33
  34 <h5 class="subsubheading">Example</h5>
  35
  36    <p>N.A.
  37
  38 <h4 class="subheading">The <code>-target-compare-sections</code> Command</h4>
  39
  40 <h5 class="subsubheading">Synopsis</h5>
  41
  42 <pre class="example">      -target-compare-sections [ <var>section</var> ]
  43      </pre>
  44
  45    <p>Compare data of section <var>section</var> on target to the exec file.
  46 Without the argument, all sections are compared.
  47
  48 <h5 class="subsubheading">GDB Command</h5>
  49
  50    <p>The GDB equivalent is <code>compare-sections</code>.
  51
  52 <h5 class="subsubheading">Example</h5>
  53
  54    <p>N.A.
  55
  56 <h4 class="subheading">The <code>-target-detach</code> Command</h4>
  57
  58 <h5 class="subsubheading">Synopsis</h5>
  59
  60 <pre class="example">      -target-detach
  61      </pre>
  62
  63    <p>Disconnect from the remote target.  There's no output.
  64
  65 <h5 class="subsubheading">GDB command</h5>
  66
  67    <p>The corresponding GDB command is <code>detach</code>.
  68
  69 <h5 class="subsubheading">Example</h5>
  70
  71 <pre class="smallexample">     (gdb)
  72      -target-detach
  73      ^done
  74      (gdb)
  75      </pre>
  76
  77 <h4 class="subheading">The <code>-target-download</code> Command</h4>
  78
  79 <h5 class="subsubheading">Synopsis</h5>
  80
  81 <pre class="example">      -target-download
  82      </pre>
  83
  84    <p>Loads the executable onto the remote target.
  85 It prints out an update message every half second, which includes the fields:
  86
  87      <dl>
  88 <dt><code>section</code>
  89      <dd>The name of the section.
  90 <br><dt><code>section-sent</code>
  91      <dd>The size of what has been sent so far for that section.
  92 <br><dt><code>section-size</code>
  93      <dd>The size of the section.
  94 <br><dt><code>total-sent</code>
  95      <dd>The total size of what was sent so far (the current and the previous sections).
  96 <br><dt><code>total-size</code>
  97      <dd>The size of the overall executable to download.
  98 </dl>
  99
 100 <p>Each message is sent as status record (see <a href="GDB-MI-Output-Syntax.html#GDB%2fMI%20Output%20Syntax"><small>GDB/MI</small> Output Syntax</a>).
 101
 102    <p>In addition, it prints the name and size of the sections, as they are
 103 downloaded.  These messages include the following fields:
 104
 105      <dl>
 106 <dt><code>section</code>
 107      <dd>The name of the section.
 108 <br><dt><code>section-size</code>
 109      <dd>The size of the section.
 110 <br><dt><code>total-size</code>
 111      <dd>The size of the overall executable to download.
 112 </dl>
 113
 114 <p>At the end, a summary is printed.
 115
 116 <h5 class="subsubheading">GDB Command</h5>
 117
 118    <p>The corresponding GDB command is <code>load</code>.
 119
 120 <h5 class="subsubheading">Example</h5>
 121
 122    <p>Note: each status message appears on a single line.  Here the messages
 123 have been broken down so that they can fit onto a page.
 124
 125 <pre class="smallexample">     (gdb)
 126      -target-download
 127      +download,{section=".text",section-size="6668",total-size="9880"}
 128      +download,{section=".text",section-sent="512",section-size="6668",
 129      total-sent="512",total-size="9880"}
 130      +download,{section=".text",section-sent="1024",section-size="6668",
 131      total-sent="1024",total-size="9880"}
 132      +download,{section=".text",section-sent="1536",section-size="6668",
 133      total-sent="1536",total-size="9880"}
 134      +download,{section=".text",section-sent="2048",section-size="6668",
 135      total-sent="2048",total-size="9880"}
 136      +download,{section=".text",section-sent="2560",section-size="6668",
 137      total-sent="2560",total-size="9880"}
 138      +download,{section=".text",section-sent="3072",section-size="6668",
 139      total-sent="3072",total-size="9880"}
 140      +download,{section=".text",section-sent="3584",section-size="6668",
 141      total-sent="3584",total-size="9880"}
 142      +download,{section=".text",section-sent="4096",section-size="6668",
 143      total-sent="4096",total-size="9880"}
 144      +download,{section=".text",section-sent="4608",section-size="6668",
 145      total-sent="4608",total-size="9880"}
 146      +download,{section=".text",section-sent="5120",section-size="6668",
 147      total-sent="5120",total-size="9880"}
 148      +download,{section=".text",section-sent="5632",section-size="6668",
 149      total-sent="5632",total-size="9880"}
 150      +download,{section=".text",section-sent="6144",section-size="6668",
 151      total-sent="6144",total-size="9880"}
 152      +download,{section=".text",section-sent="6656",section-size="6668",
 153      total-sent="6656",total-size="9880"}
 154      +download,{section=".init",section-size="28",total-size="9880"}
 155      +download,{section=".fini",section-size="28",total-size="9880"}
 156      +download,{section=".data",section-size="3156",total-size="9880"}
 157      +download,{section=".data",section-sent="512",section-size="3156",
 158      total-sent="7236",total-size="9880"}
 159      +download,{section=".data",section-sent="1024",section-size="3156",
 160      total-sent="7748",total-size="9880"}
 161      +download,{section=".data",section-sent="1536",section-size="3156",
 162      total-sent="8260",total-size="9880"}
 163      +download,{section=".data",section-sent="2048",section-size="3156",
 164      total-sent="8772",total-size="9880"}
 165      +download,{section=".data",section-sent="2560",section-size="3156",
 166      total-sent="9284",total-size="9880"}
 167      +download,{section=".data",section-sent="3072",section-size="3156",
 168      total-sent="9796",total-size="9880"}
 169      ^done,address="0x10004",load-size="9880",transfer-rate="6586",
 170      write-rate="429"
 171      (gdb)
 172      </pre>
 173
 174 <h4 class="subheading">The <code>-target-exec-status</code> Command</h4>
 175
 176 <h5 class="subsubheading">Synopsis</h5>
 177
 178 <pre class="example">      -target-exec-status
 179      </pre>
 180
 181    <p>Provide information on the state of the target (whether it is running or
 182 not, for instance).
 183
 184 <h5 class="subsubheading">GDB Command</h5>
 185
 186    <p>There's no equivalent GDB command.
 187
 188 <h5 class="subsubheading">Example</h5>
 189
 190    <p>N.A.
 191
 192 <h4 class="subheading">The <code>-target-list-available-targets</code> Command</h4>
 193
 194 <h5 class="subsubheading">Synopsis</h5>
 195
 196 <pre class="example">      -target-list-available-targets
 197      </pre>
 198
 199    <p>List the possible targets to connect to.
 200
 201 <h5 class="subsubheading">GDB Command</h5>
 202
 203    <p>The corresponding GDB command is <code>help target</code>.
 204
 205 <h5 class="subsubheading">Example</h5>
 206
 207    <p>N.A.
 208
 209 <h4 class="subheading">The <code>-target-list-current-targets</code> Command</h4>
 210
 211 <h5 class="subsubheading">Synopsis</h5>
 212
 213 <pre class="example">      -target-list-current-targets
 214      </pre>
 215
 216    <p>Describe the current target.
 217
 218 <h5 class="subsubheading">GDB Command</h5>
 219
 220    <p>The corresponding information is printed by <code>info file</code> (among
 221 other things).
 222
 223 <h5 class="subsubheading">Example</h5>
 224
 225    <p>N.A.
 226
 227 <h4 class="subheading">The <code>-target-list-parameters</code> Command</h4>
 228
 229 <h5 class="subsubheading">Synopsis</h5>
 230
 231 <pre class="example">      -target-list-parameters
 232      </pre>
 233
 234 <h5 class="subsubheading">GDB Command</h5>
 235
 236    <p>No equivalent.
 237
 238 <h5 class="subsubheading">Example</h5>
 239
 240    <p>N.A.
 241
 242 <h4 class="subheading">The <code>-target-select</code> Command</h4>
 243
 244 <h5 class="subsubheading">Synopsis</h5>
 245
 246 <pre class="example">      -target-select <var>type</var> <var>parameters <small class="dots">...</small></var>
 247      </pre>
 248
 249    <p>Connect GDB to the remote target.  This command takes two args:
 250
 251      <dl>
 252 <dt><code></code><var>type</var><code></code>
 253      <dd>The type of target, for instance <code>async</code>, <code>remote</code>, etc.
 254 <br><dt><code></code><var>parameters</var><code></code>
 255      <dd>Device names, host names and the like.  See <a href="Target-Commands.html#Target%20Commands">Commands for managing targets</a>, for more details.
 256 </dl>
 257
 258    <p>The output is a connection notification, followed by the address at
 259 which the target program is, in the following form:
 260
 261 <pre class="smallexample">     ^connected,addr="<var>address</var>",func="<var>function name</var>",
 262        args=[<var>arg list</var>]
 263      </pre>
 264
 265 <h5 class="subsubheading">GDB Command</h5>
 266
 267    <p>The corresponding GDB command is <code>target</code>.
 268
 269 <h5 class="subsubheading">Example</h5>
 270
 271 <pre class="smallexample">     (gdb)
 272      -target-select async /dev/ttya
 273      ^connected,addr="0xfe00a300",func="??",args=[]
 274      (gdb)
 275      </pre>
 276
 277    </body></html>
 278