Line 1: |
Line 1: |
| [[Category:Kernel objects]] | | [[Category:Kernel objects]] |
| + | Size : 0x38 bytes |
| | | |
| + | It is converted to [[SVC#struct_DebugEventInfo|struct DebugEventInfo]] by using svcContinueDebugEvent. |
| | | |
− | Size : 0x38 bytes
| + | == Object definition == |
| | | |
| {| class="wikitable" border="1" | | {| class="wikitable" border="1" |
Line 20: |
Line 22: |
| | 0x8 | | | 0x8 |
| | u32 | | | u32 |
− | | Unknown | + | | Flags. |
| + | In all observed cases, bit0 means that svcContinueDebugEvent needs to be called for this event (except for EXIT PROCESS events, for which you need to call svcContinueDebugEvent even if this bit is clear) |
| |- | | |- |
| | 0xC | | | 0xC |
| + | | u8 |
| + | | ATTACH PROCESS/THREAD events: 1 if the object was attached by svcDebugActiveProcess, 0 otherwise (this is always 1 for processes) |
| + | |- |
| + | | 0xD |
| + | | u8 |
| + | | Equal to bit0 of field 0x8 in all observed cases: |
| + | indicates that svcContinueDebugEvent needs to be called for this event (except for EXIT PROCESS events, for which you need to call svcContinueDebugEvent even if this bit is clear) |
| + | |- |
| + | | 0xE |
| + | | u8 |
| + | | "Other" flag for ATTACH PROCESS events, 0 in all observed cases |
| + | |- |
| + | | 0xF |
| + | | u8 |
| + | | Indicates that the event has been handled and should be deleted |
| + | |- |
| + | | 0x10 |
| + | | <code>union { ... }</code> |
| + | | Event-specific data, see below (slightly different from DebugEventInfo) |
| + | |} |
| + | |
| + | == Event-specific data == |
| + | |
| + | === ATTACH PROCESS event === |
| + | |
| + | {| class="wikitable" border="1" |
| + | ! Type |
| + | ! Field |
| + | |- |
| + | | [[KProcess]] * |
| + | | Process |
| + | |} |
| + | |
| + | === ATTACH THREAD event === |
| + | |
| + | {| class="wikitable" border="1" |
| + | ! Type |
| + | ! Field |
| + | |- |
| + | | u32 |
| + | | Creator thread ID (0 if attached by svcDebugActiveProcess) |
| + | |- |
| + | | void * |
| + | | Thread local storage |
| + | |- |
| + | | u32 * |
| + | | Entrypoint = .text load address of the parent process |
| + | |} |
| + | |
| + | === EXIT THREAD/PROCESS events === |
| + | |
| + | {| class="wikitable" border="1" |
| + | ! Type |
| + | ! Field |
| + | |- |
| + | | u32 |
| + | | Exit reason |
| + | |} |
| + | |
| + | === EXCEPTION event === |
| + | |
| + | {| class="wikitable" border="1" |
| + | ! Type |
| + | ! Field |
| + | |- |
| + | | u32 |
| + | | Exception type |
| + | |- |
| + | | u32 |
| + | | Exception address |
| + | |- |
| + | | u32 |
| + | | Exception category: 4 for DEBUGGER BREAK, 3 for USER BREAK, 2 for STOP POINT, |
| + | 1 for DATA ABORT/UNALIGNED DATA ACCESS/UNDEFINED SYSCALL, 0 otherwise |
| + | |- |
| + | | <code>union { ... }</code> |
| + | | Type-specific data, see below |
| + | |} |
| + | |
| + | For UNDEFINED INSTRUCTION/PREFETCH ABORT/DATA ABORT/UNALIGNED DATA ACCESS/UNDEFINED SYSCALL/STOP POINT: |
| + | {| class="wikitable" border="1" |
| + | ! Type |
| + | ! Field |
| + | |- |
| + | | u32 |
| + | | Fault information: Fault Address Register (for watchpoints, DATA ABORT and UNALIGNED DATA ACCESS), |
| + | attempted SVC ID (for UNDEFINED SYSCALL), otherwise 0 |
| + | |- |
| + | | u32 |
| + | | Stop point type that caused the event (when applicable): 0 = svc 0xFF, 1 = breakpoint, 2 = watchpoint |
| + | |} |
| + | |
| + | For USER BREAK: |
| + | {| class="wikitable" border="1" |
| + | ! Type |
| + | ! Field |
| + | |- |
| | u32 | | | u32 |
| + | | Break reason |
| + | |- |
| + | | u32[2] |
| + | | User-provided parameters for debug reasons, or 0 |
| + | |} |
| + | |
| + | For DEBUGGER BREAK: |
| + | {| class="wikitable" border="1" |
| + | ! Type |
| + | ! Field |
| + | |- |
| + | | [[KThread]]*[nbCores] |
| + | | Pointers to the current threads at the time svcBreakDebugProcess was called |
| + | |} |
| + | |
| + | === SCHEDULE/SYSCALL IN/OUT events === |
| + | |
| + | {| class="wikitable" border="1" |
| + | ! Type |
| + | ! Field |
| + | |- |
| + | | u64 |
| + | | Clock tick |
| + | |- |
| + | | u32 |
| + | | CPU ID (SCHEDULE events) / syscall (SYSCALL events) |
| + | |- |
| + | | u32[5] |
| | Unknown | | | Unknown |
| |- | | |- |
− | | 0xD | + | | u32 (?) |
| + | | Event info, apparently 0 |
| + | |} |
| + | |
| + | === OUTPUT STRING event === |
| + | |
| + | {| class="wikitable" border="1" |
| + | ! Type |
| + | ! Field |
| + | |- |
| + | | u32 |
| + | | String address |
| + | |- |
| + | | u32 |
| + | | String size |
| + | |} |
| + | |
| + | === MAP event === |
| + | |
| + | {| class="wikitable" border="1" |
| + | ! Type |
| + | ! Field |
| + | |- |
| + | | u32 |
| + | | Mapped address |
| + | |- |
| | u32 | | | u32 |
− | | Unknown | + | | Mapped size |
| |- | | |- |
− | | 0xE
| |
| | u32 | | | u32 |
− | | Unknown | + | | MemoryPermission |
| |- | | |- |
− | | 0xF
| |
| | u32 | | | u32 |
− | | Unknown | + | | MemoryState |
| |} | | |} |