Class: GDB

Defined in:

src/index.coffee

Overview

Public: A class to control an instance of GDB running as a child process. The child is not spawned on construction, but only when calling .connect

Variables Summary

breaks =

null

A BreakpointManager instance.

exec =

null

An ExecState instance.

vars =

null

A VariableManager instance. API not finalised.

command =

'gdb'

Instance Method Summary

# (void) onConsoleOutput(cb)
# (void) onConnect(cb) Invoke the given function when GDB starts.
# (void) onDisconnect(cb) Invoke the given function when GDB exits.
# (Promise) connect(command) Spawn the GDB child process, and set up with our config.
# (void) disconnect() Politely request the GDB child process to exit
# (Promise) send_mi(cmd, quiet) Send a gdb/mi command.
# (Promise) send_cli(cmd) Send a gdb/cli command.
# (void) set(name, value)
# (void) show(name)
# (void) setCwd(path) Set current working directory.
# (void) setFile(path) Set current file for target execution and symbols.
# (void) destroy() Tear down the object and free associated resources.

Constructor Details

# (void) constructor(command)

Instance Method Details

# (void) onConsoleOutput(cb)

# (void) onConnect(cb)

Invoke the given function when GDB starts.

# (void) onDisconnect(cb)

Invoke the given function when GDB exits.

# (Promise) connect(command)

Spawn the GDB child process, and set up with our config.

Returns:

( Promise ) — resolves when GDB is running.

# (void) disconnect()

Politely request the GDB child process to exit

# (Promise) send_mi(cmd, quiet)

Send a gdb/mi command. This is used internally by sub-modules.

reply or rejected in the case of an error reply.

Returns:

( Promise ) — resolves to the results part of the result record

# (Promise) send_cli(cmd)

Send a gdb/cli command. This may be used to implement a CLI window in a GUI frontend tool, or to send monitor or other commands for which no equivalent MI commands exist.

Returns:

( Promise ) — resolves on success.

# (void) set(name, value)

# (void) show(name)

# (void) setCwd(path)

Set current working directory.

# (void) setFile(path)

Set current file for target execution and symbols.

# (void) destroy()

Tear down the object and free associated resources.