DosDebug Hardware-Specific Subcommands

The following are the DosDebug PowerPC-specific subcommands:

• Connect:

     uDB.Value = DBG_L_PPC /* Debugging level number */
  

  DBG_L_PPC is defined in bsedos.h.

• ReadRegs and WriteRegs:

  Uses the debug buffer defined in bsedos.h.

• ReadCoRegs and WriteCoRegs:

  PPC_FLOAT_STATE_SIZE is defined in public uKernel release tree in file thread_status.h:

     uDB.Value = DBG_CO_PPC  /* Coprocessor type identifier       */
     uDB.Len   = PPC_FLOAT_STATE_SIZE /* Size of coprocessor     */
                                      /* register context buffer */
  
  

     #define DBG_CO_PPC 2
  

  Note: Not defined in bsedos.h.

• ThrdStat. uDB.Len is the length of the thread status buffer, in bytes. This field is four bytes (same as Intel).

  Thread Status Buffer is the same as Intel and is not stored in bsedos.h.

     TStat struc
        unsigned char DbgState  : DBG_D_Thawed, DBG_D_Frozen
        unsigned char TState    : DBG_T_Runnable, _Suspended, _Blocked, _CritSec
        unsigned char TPriority
     TStat ends
  

  The following are defined in this Guide:

     #define DBG_D_Thawed    0
     #define DBG_D_Frozen    1
  

  The following are defined in bsedos.h and in this Guide:

     #define DBG_T_Runnable  0
     #define DBG_T_Suspended 1
     #define DBG_T_Blocked   2
     #define DBG_T_CritSec   3
  

• SetWatch:

  uDB.Addr

  Starting Address of Watchpoint
  uDB.Len
  Length of Watchpoint, in bytes
  uDB.Index
  Reserved (0)
  uDB.Value
  Watchpoint Type and Scope (same as Intel)

  Scopes

  Only DBG_W_Local allowed. No DBG_W_Global allowed.
  Types
  DBG_W_Execute, DBG_W_Write, and DBG_W_ReadWrite.
  All defines are the same as the Intel defines, as described in this Guide.

  Note: There are two types of Watchpoints:

  a.

  Instruction (DBG_W_Execute). Four bytes long and four byte aligned.
  b.
  Data (DBG_W_Write, DBG_W_ReadWrite). Eight bytes long and eight byte aligned.

  601, 604 : 1 instruction WP, 1 data WP 603 : 1 instruction WP
  6.
  Attach and Detach:

  DBG_C_ATTACH - Debug command:

  Parameters:

  PID

  Process ID of debuggee
  CMD
  DBG_C_Attach
  VALUE
  DBG_L_PPC (DBG_L_PPC - defined in bsedos.h)
  Returns:

  Note: A DBG_C_Connect does not need to be issued because DBG_C_Attach will perform the connection. Also, because the debugger did not start the task, it will not have a parent/child relationship as in a DBG_C_Connect.

  DBG_N_Success

  Attachment made.
  DBG_N_Error
  All errors (for example, bad process id)
  DosDebug will generate the following notifications:

  a.

  DBG_N_ModuleLoad notifications for all loaded modules.
  b.
  DBG_N_ThreadCreate notifications for all active threads in task.
  Currently, descendant debugging is not working.

  DBG_C_Detach - Debug command.

  Parameters:

  PID

  Process ID of debuggee
  CMD
  DBG_C_Detach
  Returns:

  DBG_N_Success

  Attachment made
  DBG_N_Error
  All errors (for example, bad process id)
  Will detach from an attached or connected task.

  Note: This is the only call that will normally turn off debugging and resume the specified task. DBG_C_Term will kill the task whether it was connected or attached.

  ---

  [Back: DBG_T_ TState Values]
  [Next: DosDebug Commands]