Footnotes

(1)

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

(2)

Currently, only GNU/Linux.

(3)

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.

(4)

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.

(5)

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

(6)

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.

(7)

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

(8)

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

(9)

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.