System Debugging Commands

The following system debugging commands are available:

chload-symbols

Loads the symbols for the attached system.

chthread thread-id

Changes the current thread. This command is similar to thread thread-id but uses ChorusOS thread numbers. It does not accept the apply keyword.

chls args

Lists ChorusOS system objects. Refer to the chls(1CC) man page.

set chcontinue-on-exit on/off

Sets the resume target flag on exit. By default, the target resumes when GDB detaches from it. You can clear the target flag to keep the target stopped when GDB detaches.

set chdebug on/off

Enables or disables debug traces for maintenance.

set chserver host[:slot]

Sets the host name and slot number to connect to the debug server. The format of the argument is the same as the CHSERVER_HOST environment variable. This variable is set automatically, according to the CHSERVER_HOST environment variable. The host name indicates the host on which the debug server is running. The optional slot number represents the slot number used when the debug server was started.

set chthread-format arg

Defines the format of the template to be used by GDB when reporting information about a thread. The template uses the thread attributes defined by the debug server to insert variable information into the constructed name.

target chorusos machinename

Connects to the ChorusOS target for system debugging. The optional argument machinename is the name of the target as registered in the debug server. The command attempts to find a default active target registered in the debug server. If several targets are registered and active, you must specify the name of a target.

Additional commands may have been added after the release of this manual. To obtain a complete list of these commands, type:

$ ch

or

% set ch 

and press the Tab key twice.