Footnotes

(1)

On DOS/Windows systems, the home directory is the one pointed to by the HOME environment variable.

(2)

The completer can be confused by certain kinds of invalid expressions. Also, it only examines the static type of the expression, not the dynamic type.

(3)

Currently, only GNU/Linux.

(4)

As of this writing, multiple-location breakpoints work only if there's line number information for all the locations. This means that they will generally not work in system libraries, unless you have debug info with line numbers for them.

(5)

Note that embedded programs (the so-called "free-standing" environment) are not required to have a main function as the entry point. They could even have multiple entry points.

(6)

The only restriction is that your editor (say ex), recognizes the following command-line syntax:

ex +number file

The optional numeric value +number specifies the number of the line in the file where to start editing.

(7)

`b' cannot be used because these format letters are also used with the x command, where `b' stands for "byte"; see Examining Memory.

(8)

This is a way of removing one word from the stack, on machines where stacks grow downward in memory (most machines, nowadays). This assumes that the innermost stack frame is selected; setting $sp is not allowed when other stack frames are selected. To pop entire frames off the stack, regardless of machine architecture, use return; see Returning from a Function.

(9)

If you want to specify a local system root using a directory that happens to be named `remote:', you need to use some equivalent variant of the name like `./remote:'.

(10)

If you choose a port number that conflicts with another service, gdbserver prints an error message and exits.

(11)

In `gdb-6.8.50.20080913/gdb/refcard.ps' of the version 6.8.50.20080913 release.

(12)

The `qP' and `qL' packets predate these conventions, and have arguments without any terminator for the packet name; we suspect they are in widespread use in places that are difficult to upgrade. The `qC' packet has no arguments, but some existing stubs (e.g. RedBoot) are known to not check for the end of the packet.