gdb.info: GDB/MI Target Manipulation

Go forward to GDB/MI Thread Commands
Go backward to GDB/MI Symbol Query
Go up to GDB/MI
Go to the top op gdb

GDB/MI Target Manipulation Commands

The `-target-attach' Command

Synopsis

      -target-attach PID | FILE
   Attach to a process PID or a file FILE outside of GDB.

GDB command

The corresponding GDB command is `attach'.

Example

N.A.

The `-target-compare-sections' Command

Synopsis

      -target-compare-sections [ SECTION ]
   Compare data of section SECTION on target to the exec file.  Without
the argument, all sections are compared.

GDB Command

The GDB equivalent is `compare-sections'.

Example

N.A.

The `-target-detach' Command

Synopsis

      -target-detach
   Disconnect from the remote target.  There's no output.

GDB command

The corresponding GDB command is `detach'.

Example

     (gdb)
     -target-detach
     ^done
     (gdb)

The `-target-disconnect' Command

Synopsis

      -target-disconnect
   Disconnect from the remote target.  There's no output.

GDB command

The corresponding GDB command is `disconnect'.

Example

     (gdb)
     -target-disconnect
     ^done
     (gdb)

The `-target-download' Command

Synopsis

      -target-download
   Loads the executable onto the remote target.  It prints out an
update message every half second, which includes the fields:
`section'
     The name of the section.
`section-sent'
     The size of what has been sent so far for that section.
`section-size'
     The size of the section.
`total-sent'
     The total size of what was sent so far (the current and the
     previous sections).
`total-size'
     The size of the overall executable to download.
Each message is sent as status record (*note GDB/MI Output Syntax:
GDB/MI Output Syntax.).
   In addition, it prints the name and size of the sections, as they are
downloaded.  These messages include the following fields:
`section'
     The name of the section.
`section-size'
     The size of the section.
`total-size'
     The size of the overall executable to download.
At the end, a summary is printed.

GDB Command

The corresponding GDB command is `load'.

Example

Note: each status message appears on a single line.  Here the messages
have been broken down so that they can fit onto a page.
     (gdb)
     -target-download
     +download,{section=".text",section-size="6668",total-size="9880"}
     +download,{section=".text",section-sent="512",section-size="6668",
     total-sent="512",total-size="9880"}
     +download,{section=".text",section-sent="1024",section-size="6668",
     total-sent="1024",total-size="9880"}
     +download,{section=".text",section-sent="1536",section-size="6668",
     total-sent="1536",total-size="9880"}
     +download,{section=".text",section-sent="2048",section-size="6668",
     total-sent="2048",total-size="9880"}
     +download,{section=".text",section-sent="2560",section-size="6668",
     total-sent="2560",total-size="9880"}
     +download,{section=".text",section-sent="3072",section-size="6668",
     total-sent="3072",total-size="9880"}
     +download,{section=".text",section-sent="3584",section-size="6668",
     total-sent="3584",total-size="9880"}
     +download,{section=".text",section-sent="4096",section-size="6668",
     total-sent="4096",total-size="9880"}
     +download,{section=".text",section-sent="4608",section-size="6668",
     total-sent="4608",total-size="9880"}
     +download,{section=".text",section-sent="5120",section-size="6668",
     total-sent="5120",total-size="9880"}
     +download,{section=".text",section-sent="5632",section-size="6668",
     total-sent="5632",total-size="9880"}
     +download,{section=".text",section-sent="6144",section-size="6668",
     total-sent="6144",total-size="9880"}
     +download,{section=".text",section-sent="6656",section-size="6668",
     total-sent="6656",total-size="9880"}
     +download,{section=".init",section-size="28",total-size="9880"}
     +download,{section=".fini",section-size="28",total-size="9880"}
     +download,{section=".data",section-size="3156",total-size="9880"}
     +download,{section=".data",section-sent="512",section-size="3156",
     total-sent="7236",total-size="9880"}
     +download,{section=".data",section-sent="1024",section-size="3156",
     total-sent="7748",total-size="9880"}
     +download,{section=".data",section-sent="1536",section-size="3156",
     total-sent="8260",total-size="9880"}
     +download,{section=".data",section-sent="2048",section-size="3156",
     total-sent="8772",total-size="9880"}
     +download,{section=".data",section-sent="2560",section-size="3156",
     total-sent="9284",total-size="9880"}
     +download,{section=".data",section-sent="3072",section-size="3156",
     total-sent="9796",total-size="9880"}
     ^done,address="0x10004",load-size="9880",transfer-rate="6586",
     write-rate="429"
     (gdb)

The `-target-exec-status' Command

Synopsis

      -target-exec-status
   Provide information on the state of the target (whether it is
running or not, for instance).

GDB Command

There's no equivalent GDB command.

Example

N.A.

The `-target-list-available-targets' Command

Synopsis

      -target-list-available-targets
   List the possible targets to connect to.

GDB Command

The corresponding GDB command is `help target'.

Example

N.A.

The `-target-list-current-targets' Command

Synopsis

      -target-list-current-targets
   Describe the current target.

GDB Command

The corresponding information is printed by `info file' (among other
things).

Example

N.A.

The `-target-list-parameters' Command

Synopsis

      -target-list-parameters

GDB Command

No equivalent.

Example

N.A.

The `-target-select' Command

Synopsis

      -target-select TYPE PARAMETERS ...
   Connect GDB to the remote target.  This command takes two args:
`TYPE'
     The type of target, for instance `async', `remote', etc.
`PARAMETERS'
     Device names, host names and the like.  *Note Commands for
     managing targets: Target Commands, for more details.
   The output is a connection notification, followed by the address at
which the target program is, in the following form:
     ^connected,addr="ADDRESS",func="FUNCTION NAME",
       args=[ARG LIST]

GDB Command

The corresponding GDB command is `target'.

Example

     (gdb)
     -target-select async /dev/ttya
     ^connected,addr="0xfe00a300",func="??",args=[]
     (gdb)