debug.h

Go to the documentation of this file.

 
// or SceDebugForKernel_stub
 
#ifndef _PSP2KERN_KERNEL_DEBUG_H_
#define _PSP2KERN_KERNEL_DEBUG_H_
 
#include <vitasdk/build_utils.h>
#include <psp2kern/types.h>
#include <stdarg.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
 
typedef struct SceKernelDebugInfo {
    union {
        struct {
            SceUInt32 fileHash;
            SceUInt32 lineHash;
            SceUInt32 funcHash;
        };
        struct { /* For backwards compatibility */
            SceUInt32 hex_value0_hi;
            SceUInt32 hex_value0_lo;
            SceUInt32 hex_value1;
        };
    };
    const char *func;
    SceUInt32 line;
    const char *file;
} SceKernelDebugInfo;
VITASDK_BUILD_ASSERT_EQ(0x18, SceKernelDebugInfo);
 
typedef SceKernelDebugInfo SceKernelDebugMessageContext;
 
typedef enum SceKernelDebugInfoFlags {
    SCE_KERNEL_DEBUG_INFO_FLAG_NONE = 0,
    SCE_KERNEL_DEBUG_INFO_FLAG_CORE = 1,
    SCE_KERNEL_DEBUG_INFO_FLAG_FUNC = 2,
    SCE_KERNEL_DEBUG_INFO_FLAG_LINE = 4,
    SCE_KERNEL_DEBUG_INFO_FLAG_FILE = 8
} SceKernelDebugInfoFlags;
 
typedef enum SceKernelDebugLevel {
    SCE_KERNEL_DEBUG_LEVEL_ALWAYS = 0,
    SCE_KERNEL_DEBUG_LEVEL_DEBUG,
    SCE_KERNEL_DEBUG_LEVEL_TRACE
} SceKernelDebugLevel;
 
typedef enum SceKernelAssertLevel {
    SCE_KERNEL_ASSERT_LEVEL_0 = 0,
    SCE_KERNEL_ASSERT_LEVEL_1,
    SCE_KERNEL_ASSERT_LEVEL_2
} SceKernelAssertLevel;
 
 
int ksceKernelDebugPutchar(int character);
 
int ksceKernelPrintf(const char *fmt, ...);
 
int ksceKernelPrintfLevel(SceUInt32 level, const char *fmt, ...);
 
int ksceKernelPrintfLevelWithInfo(SceUInt32 level, SceUInt32 flags, const SceKernelDebugInfo *dbginfo, const char *fmt, ...);
 
int ksceKernelPrintfWithInfo(SceUInt32 flags, const SceKernelDebugInfo *dbginfo, const char *fmt, ...);
 
int ksceKernelVprintf(const char *fmt, va_list arg);
 
int ksceKernelVprintfLevel(SceUInt32 level, const char *fmt, va_list arg);
 
__attribute__((__noreturn__)) void ksceKernelPanic(const SceKernelDebugInfo *dbginfo, const void *lr);
 
__attribute__((__noreturn__)) void ksceKernelPrintfPanic(const SceKernelDebugInfo *dbginfo, const void *lr, const char *fmt, ...);
 
void ksceKernelAssert(SceBool condition, const SceKernelDebugInfo *dbginfo, const void *lr);
 
void ksceKernelAssertLevel(SceUInt32 level, SceBool condition, const SceKernelDebugInfo *dbginfo, const void *lr);
 
void ksceKernelPrintfAssertLevel(SceUInt32 level, SceBool condition, const SceKernelDebugInfo *dbginfo, const void *lr, const char *fmt, ...);
 
 
#ifndef __PSP2FILEHASH__
#define __PSP2FILEHASH__ (0)
#endif
 
#ifndef __PSP2FILE__
#define __PSP2FILE__ __FILE__
#endif
 
 
#define SCE_KERNEL_PANIC() do { \
    static const SceKernelDebugInfo __dbginfo = {.fileHash = __PSP2FILEHASH__, .lineHash = 0, .funcHash = 0, .func = __FUNCTION__, .line = __LINE__, .file = __PSP2FILE__}; \
    ksceKernelPanic(&__dbginfo, __builtin_return_address(0)); \
    } while(0)
 
#define SCE_KERNEL_PRINTF_PANIC(__fmt__, ...) do { \
    static const SceKernelDebugInfo __dbginfo = {.fileHash = __PSP2FILEHASH__, .lineHash = 0, .funcHash = 0, .func = __FUNCTION__, .line = __LINE__, .file = __PSP2FILE__}; \
    ksceKernelPrintfPanic(&__dbginfo, __builtin_return_address(0), __fmt__, ##__VA_ARGS__); \
    } while(0)
 
#define SCE_KERNEL_ASSERT(__cond__) do { \
    static const SceKernelDebugInfo __dbginfo = {.fileHash = __PSP2FILEHASH__, .lineHash = 0, .funcHash = 0, .func = __FUNCTION__, .line = __LINE__, .file = __PSP2FILE__}; \
    ksceKernelAssert(__cond__, &__dbginfo, __builtin_return_address(0)); \
    } while(0)
 
#define SCE_KERNEL_ASSERT_LEVEL(__level__, __cond__) do { \
    static const SceKernelDebugInfo __dbginfo = {.fileHash = __PSP2FILEHASH__, .lineHash = 0, .funcHash = 0, .func = __FUNCTION__, .line = __LINE__, .file = __PSP2FILE__}; \
    ksceKernelAssertLevel(__level__, __cond__, &__dbginfo, __builtin_return_address(0)); \
    } while(0)
 
#define SCE_KERNEL_PRINTF_LEVEL(__level__, __fmt__, ...) do { \
    static const SceKernelDebugInfo __dbginfo = {.fileHash = __PSP2FILEHASH__, .lineHash = 0, .funcHash = 0, .func = __FUNCTION__, .line = __LINE__, .file = __PSP2FILE__}; \
    ksceKernelPrintfLevelWithInfo(__level__, 0xF, &__dbginfo, __fmt__, ##__VA_ARGS__); \
    } while(0)
 
 
int ksceKernelRegisterKprintfHandler(int (* handler)(int unk, const char *format, va_list args), void *argp);
 
int ksceKernelRegisterDebugPutcharHandler(int (* handler)(void *argp, char c), void *argp);
 
void *ksceKernelGetDebugPutcharHandler(void);
 
int ksceKernelEnableCrashDump(SceBool enable);
 
int ksceKernelGetAssertLevel(void);
 
SceUInt32 ksceKernelSetAssertLevel(SceUInt32 level);
 
// process
typedef struct SceKernelDebugEventLog1 { // size is 0x1C
    int data_0x40;
    SceUID pid;
    int budget_type;
    int data_0x4C;    
    char titleid[0xC];
} __attribute__((packed)) SceKernelDebugEventLog1;
VITASDK_BUILD_ASSERT_EQ(0x1C, SceKernelDebugEventLog1);
 
// Related to network
typedef struct SceKernelDebugEventLog2 { // size is 0x4
    int data_0x40;    
} __attribute__((packed)) SceKernelDebugEventLog2;
VITASDK_BUILD_ASSERT_EQ(4, SceKernelDebugEventLog2);
 
// Related to network
typedef struct SceKernelDebugEventLog3 { // size is 0x54
    int data_0x40;    
    char ip1[0x10];
    char ip2[0x10];
    char ip3[0x10];
    char ip4[0x10];
    char ip5[0x10];
} __attribute__((packed)) SceKernelDebugEventLog3;
VITASDK_BUILD_ASSERT_EQ(0x54, SceKernelDebugEventLog3);
 
typedef struct SceKernelDebugEventLog {
    SceSize size;      
    int data_0x04;     
    char titleid[0xC]; 
    int flags;         
    SceUID ppid;       
    SceUID data_0x1C;  
    int rsvd[4];
    SceUInt64 time;    
    int data_0x38;
    SceSize item_size; 
    union {
        SceKernelDebugEventLog1 type1;
        SceKernelDebugEventLog2 type2;
        SceKernelDebugEventLog3 type3;
    };
} __attribute__((packed)) SceKernelDebugEventLog;
VITASDK_BUILD_ASSERT_EQ(0x54 + 0x40, SceKernelDebugEventLog);
 
int ksceEventLogGetInfo(void *buf, SceSize buf_size, SceSize *read_blocks);
 
int ksceKernelGetTtyInfo(char *buf, SceSize buf_size);
 
 
/* For backwards compatibility */
 
#define ksceDebugPrintf ksceKernelPrintf
#define ksceDebugPrintf2 ksceKernelPrintfWithInfo
#define ksceDebugPrintKernelPanic ksceKernelPanic
#define ksceDebugPrintfKernelPanic ksceKernelVprintfPanic
#define ksceDebugPrintKernelAssertion ksceKernelAssert
#define ksceDebugPrintfKernelAssertion ksceKernelPrintfAssertLevel
#define ksceKernelGetMinimumAssertionLevel ksceKernelGetAssertLevel
#define ksceDebugPutchar ksceKernelDebugPutchar
#define ksceDebugSetHandlers ksceKernelRegisterKprintfHandler
#define ksceDebugRegisterPutcharHandler ksceKernelRegisterDebugPutcharHandler
#define ksceDebugGetPutcharHandler ksceKernelGetDebugPutcharHandler
#define ksceDebugDisableInfoDump ksceKernelEnableCrashDump
#define ksceKernelSetMinimumAssertionLevel ksceKernelSetAssertLevel
 
 
#ifdef __cplusplus
}
#endif
 
#endif /* _PSP2KERN_KERNEL_DEBUG_H_ */