Debugger Support Functions

Debugger support functions provide functions allowing a debugger to reference µT-Kernel internal states and run a trace. The functions provided by debugger support functions are only for debugger use and not for use by applications or other programs.

The debugger support function is a function for debugging, so whether it is implemented or not depends on the OS provider’s judgment. However, when implementing it, the interface specified in the specification should be observed and the same function as that specified in the specification should be implemented. Also, if other functions are provided for debugging, their names should be different from those specified in the specification.

[General cautions and notes]
  • Except where otherwise noted, debugger support functions system calls (td_xxx) can be called from a task independent portion and while dispatching and interrupts are disabled. There may be some limitations, however, imposed by specific implementations.
  • When debugger support functions system calls (td_xxx) are invoked in interrupts disabled state, they are processed without enabling interrupts. Other OS states likewise remain unchanged during this processing. Changes in OS states may occur if a system call is invoked while interrupts or dispatching are enabled, since the OS continues operating.
  • Error codes such as E_PAR and E_CTX that always have the possibility of occurring are not described here unless there is some special reason for doing so.
  • Detection of E_PAR and E_CTX is implementation-defined. The call may not be detected as an error, so you should not invoke those calls which can cause such an error.

Comments

Click here to Post a Comment