23.3.2 Guile Commands

gdb provides two commands for accessing the Guile interpreter:

guile-repl

gr

The guile-repl command can be used to start an interactive Guile prompt or repl. To return to gdb, type ,q or the EOF character (e.g., Ctrl-D on an empty prompt). These commands do not take any arguments.

guile [scheme-expression]

gu [scheme-expression]

The guile command can be used to evaluate a Scheme expression.

If given an argument, gdb will pass the argument to the Guile interpreter for evaluation.

          (gdb) guile (display (+ 20 3)) (newline)
          23

The result of the Scheme expression is displayed using normal Guile rules.

          (gdb) guile (+ 20 3)
          23

If you do not provide an argument to guile, it will act as a multi-line command, like define. In this case, the Guile script is made up of subsequent command lines, given after the guile command. This command list is terminated using a line containing end. For example:

          (gdb) guile
          >(display 23)
          >(newline)
          >end
          23

It is also possible to execute a Guile script from the gdb interpreter:

source script-name

The script name must end with ‘.scm’ and gdb must be configured to recognize the script language based on filename extension using the script-extension setting. See Extending GDB.

guile (load "script-name")

This method uses the load Guile function. It takes a string argument that is the name of the script to load. See the Guile documentation for a description of this function. (see Loading).