17.3 Remote Configuration

This section documents the configuration options available when debugging remote programs. For the options related to the File I/O extensions of the remote protocol, see system-call-allowed.

set remoteaddresssize bits

Set the maximum size of address in a memory packet to the specified number of bits. No value for GDBN will mask off the address bits above that number, when it passes addresses to the remote target. The default value is the number of bits in the target's address.

show remoteaddresssize

Show the current value of remote address size in bits.

set remotebaud n

Set the baud rate for the remote serial I/O to n baud. The value is used to set the speed of the serial port used for debugging remote targets.

show remotebaud

Show the current speed of the remote connection.

set remotebreak

If set to on, No value for GDBN sends a BREAK signal to the remote when you type Ctrl-c to interrupt the program running on the remote. If set to off, No value for GDBN sends the ‘Ctrl-C’ character instead. The default is off, since most remote systems expect to see ‘Ctrl-C’ as the interrupt signal.

show remotebreak

Show whether No value for GDBN sends BREAK or ‘Ctrl-C’ to interrupt the remote program.

set remoteflow on

set remoteflow off

Enable or disable hardware flow control (RTS/CTS) on the serial port used to communicate to the remote target.

show remoteflow

Show the current setting of hardware flow control.

set remotelogbase base

Set the base (a.k.a. radix) of logging serial protocol communications to base. Supported values of base are: ascii, octal, and hex. The default is ascii.

show remotelogbase

Show the current setting of the radix for logging remote serial protocol.

set remotelogfile file

Record remote serial communications on the named file. The default is not to record at all.

show remotelogfile.

Show the current setting of the file name on which to record the serial communications.

set remotetimeout num

Set the timeout limit to wait for the remote target to respond to num seconds. The default is 2 seconds.

show remotetimeout

Show the current number of seconds to wait for the remote target responses.

set remote hardware-watchpoint-limit limit

set remote hardware-breakpoint-limit limit

Restrict No value for GDBN to using limit remote hardware breakpoint or watchpoints. A limit of -1, the default, is treated as unlimited.

The No value for GDBN remote protocol autodetects the packets supported by your debugging stub. If you need to override the autodetection, you can use these commands to enable or disable individual packets. Each packet can be set to ‘on’ (the remote target supports this packet), ‘off’ (the remote target does not support this packet), or ‘auto’ (detect remote target support for this packet). They all default to ‘auto’. For more information about each packet, see No value for GDBN Remote Serial Protocol.

During normal use, you should not have to use any of these commands. If you do, that may be a bug in your remote debugging stub, or a bug in No value for GDBN. You may want to report the problem to the No value for GDBN developers.

For each packet name, the command to enable or disable the packet is set remote name-packet. The available settings are: