
UDI Services Overview
2-8
Universal Debugger Interface Specification
The transparent mode functions are:
UDIGetTrans
The DFE calls
UDIGetTrans
to find out if the TIP has
any output and the TIP also uses special returns from
UDIGetTrans
to indicate:
when the TIP requires input but is not at the prompt
(
UDIErrorTransInputNeeded
)
when the TIP is returning the prompt
(
UDIErrorTransPrompt
). A TIP is not required to
have a prompt but if it has one it may only be
returned
with
UDIErrorTransPrompt
.
when the TIP is at the prompt waiting for input
(
UDIErrorTransDone
)
when the TIP has parsed the transparent mode
"exit" command. (
UDIErrorTransExit
).
when the TIP requires the DFE to change input
mode (
UDIErrorTransModeX
).
In general, the DFE must continue calling
UDIGetTrans
until the TIP indicates (through the
UDIGetTrans
return code) that the DFE call another
transparent function.
The DFE can allow the user to exit from the transparent
mode session only when the TIP returns
UDIErrorTransDone
or
UDIErrorTransExit
. A DFE
may call
UDIStop
during transparent mode and the TIP,
on receiving
UDIStop
, should try to clean up and return
UDIErrorTransDone
as soon as possible, but the DFE
is required to continue calling
UDIGetTrans
until
UDIErrorTransDone
or
UDIErrorTransExit
is
returned.
UDIPutTrans
If the TIP returns
UDIErrorTransInputNeeded
, the
DFE is required to acquire input from the user and call
UDIPutTrans
, sending one block of data to the TIP.
Then the DFE should resume calling
UDIGetTrans
.
If the TIP returns
UDIErrorTransDone
, the TIP is at
the prompt and the DFE is allowed to leave transparent