Chapter 15: Predefined Macros
pod_command
pod_command
Function
Send terminal interface commands to the emulator
Synopsis
int
char *command, *response;
Description
The pod_command macro sends the string in command to the emulator, and
puts any response text in response. If multiple lines of text are returned, the
lines are separated in response with a new line (\n) character. If response is a
null pointer (0), any response is ignored.
Caution
This macro is primarily for diagnostic purposes. Use of this macro to send
terminal interface commands that change the state of the emulator or analyzer
may produce unexpected and UNSUPPORTED behavior.
Diagnostics
If the command produces no error, this macro returns a one (1). Otherwise,
the macro returns a zero (0) and the debugger displays the error or errors in
the debugger error window.
Make sure that the response string is large enough to hold any data returned
from the emulator. Responses put into debugger variables will be truncated to
the maximum length of the debugger string. The debugger will not give an
error indication.
576
pod_command(command, response)