Next: Guile API, Previous: Guile Introduction, Up: Guile

#### 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).