PSPSDK 2024-10-31
Loading...
Searching...
No Matches
PSPSDK Utility Library

Functions

int pspSdkQueryModuleInfoV1 (SceUID uid, SceKernelModuleInfo *modinfo)
 Query a modules information from its uid.
 
int pspSdkGetModuleIdList (SceUID *readbuf, int readbufsize, int *idcount)
 Get the list of module IDs.
 
int pspSdkInstallNoDeviceCheckPatch (void)
 Patch the sceModuleManager module to nullify LoadDeviceCheck() calls.
 
int pspSdkInstallNoPlainModuleCheckPatch (void)
 Patch sceLoadCore module to remove loading plain module checks.
 
int pspSdkInstallKernelLoadModulePatch (void)
 Patch sceLoadModuleWithApiType to remove the kernel check in loadmodule allowing all modules to load.
 
SceUID pspSdkLoadStartModule (const char *filename, int mpid)
 Load a module and start it.
 
SceUID pspSdkLoadStartModuleWithArgs (const char *filename, int mpid, int argc, char *const argv[])
 Load a module and start it with arguments.
 
void pspSdkFixupImports (int moduleId)
 Manually fixup library imports for late binding modules.
 
int pspSdkLoadInetModules ()
 Load Inet related modules.
 
int pspSdkInetInit ()
 Initialize Inet related modules.
 
void pspSdkInetTerm ()
 Terminate Inet related modules.
 
int pspSdkReferThreadStatusByName (const char *name, SceUID *pUID, SceKernelThreadInfo *pInfo)
 Search for a thread with the given name and retrieve it's SceKernelThreadInfo struct.
 
int pspSdkReferSemaStatusByName (const char *name, SceUID *pUID, SceKernelSemaInfo *pInfo)
 Search for a semaphore with the given name and retrieve it's SceKernelSemaInfo struct.
 
int pspSdkReferEventFlagStatusByName (const char *name, SceUID *pUID, SceKernelEventFlagInfo *pInfo)
 Search for an event flag with the given name and retrieve it's SceKernelEventFlagInfo struct.
 
int pspSdkReferMboxStatusByName (const char *name, SceUID *pUID, SceKernelMbxInfo *pInfo)
 Search for a message box with the given name and retrieve it's SceKernelMbxInfo struct.
 
int pspSdkReferVplStatusByName (const char *name, SceUID *pUID, SceKernelVplInfo *pInfo)
 Search for a VPL with the given name and retrieve it's SceKernelVplInfo struct.
 
int pspSdkReferFplStatusByName (const char *name, SceUID *pUID, SceKernelFplInfo *pInfo)
 Search for a FPL with the given name and retrieve it's SceKernelFplInfo struct.
 
int pspSdkReferMppStatusByName (const char *name, SceUID *pUID, SceKernelMppInfo *pInfo)
 Search for a message pipe with the given name and retrieve it's SceKernelMppInfo struct.
 
int pspSdkReferCallbackStatusByName (const char *name, SceUID *pUID, SceKernelCallbackInfo *pInfo)
 Search for a callback with the given name and retrieve it's SceKernelCallbackInfo struct.
 
int pspSdkReferVTimerStatusByName (const char *name, SceUID *pUID, SceKernelVTimerInfo *pInfo)
 Search for a vtimer with the given name and retrieve it's SceKernelVTimerInfo struct.
 
int pspSdkReferThreadEventHandlerStatusByName (const char *name, SceUID *pUID, SceKernelThreadEventHandlerInfo *pInfo)
 Search for a thread event handler with the given name and retrieve it's SceKernelThreadEventHandlerInfo struct.
 
unsigned int pspSdkDisableInterrupts (void)
 Disable interrupts.
 
void pspSdkEnableInterrupts (unsigned int istate)
 Enable interrupts.
 
unsigned int pspSdkSetK1 (unsigned int k1)
 Set the processors K1 register to a known value.
 
unsigned int pspSdkGetK1 (void)
 Get the current value of the processors K1 register.
 
void pspSdkDisableFPUExceptions (void)
 Disable the CPUs FPU exceptions.
 
SceSize pspSdkTotalFreeUserMemSize (void)
 Gets the amount of memory available in the user partition(s).
 

Detailed Description

Function Documentation

◆ pspSdkDisableFPUExceptions()

void pspSdkDisableFPUExceptions ( void  )

Disable the CPUs FPU exceptions.

◆ pspSdkDisableInterrupts()

unsigned int pspSdkDisableInterrupts ( void  )

Disable interrupts.

Note
Do not disable interrupts for too long otherwise the watchdog will get you.
Returns
The previous state of the interrupt enable bit (should be passed back to pspSdkEnableInterrupts)

Referenced by pspSdkTotalFreeUserMemSize().

◆ pspSdkEnableInterrupts()

void pspSdkEnableInterrupts ( unsigned int  istate)

Enable interrupts.

Parameters
istate- The interrupt state as returned from pspSdkDisableInterrupts

Referenced by pspSdkTotalFreeUserMemSize().

◆ pspSdkFixupImports()

void pspSdkFixupImports ( int  moduleId)

Manually fixup library imports for late binding modules.

Parameters
moduleId- Id of the module to fixup

References i, Kprintf(), module_info, NULL, sceKernelDcacheWritebackAll(), sceKernelFindModuleByUID(), sceKernelIcacheClearAll(), _scemoduleinfo::stub_end, _scemoduleinfo::stub_top, and x.

◆ pspSdkGetK1()

unsigned int pspSdkGetK1 ( void  )

Get the current value of the processors K1 register.

Returns
The current value of K1

◆ pspSdkGetModuleIdList()

int pspSdkGetModuleIdList ( SceUID readbuf,
int  readbufsize,
int idcount 
)

Get the list of module IDs.

Note
This is a replacement function for the missing v1.5 sceKernelGetModuleIdList on v1.0 firmware. DO NOT use on anything above that version.
Parameters
readbuf- Buffer to store the module list.
readbufsize- Number of elements in the readbuffer.
idcount- Returns the number of module ids
Returns
>= 0 on success

References sceKernelGetModuleList(), sceKernelModuleCount(), and x.

◆ pspSdkInetInit()

int pspSdkInetInit ( )

Initialize Inet related modules.

Returns
- 0 on success, otherwise one of PspKernelErrorCodes.

◆ pspSdkInetTerm()

void pspSdkInetTerm ( )

Terminate Inet related modules.

◆ pspSdkInstallKernelLoadModulePatch()

int pspSdkInstallKernelLoadModulePatch ( void  )

Patch sceLoadModuleWithApiType to remove the kernel check in loadmodule allowing all modules to load.

Note
This function must be called while running in kernel mode
Returns
0 on success

◆ pspSdkInstallNoDeviceCheckPatch()

int pspSdkInstallNoDeviceCheckPatch ( void  )

Patch the sceModuleManager module to nullify LoadDeviceCheck() calls.

Returns
0 on success, otherwise one of PspKernelErrorCodes.
Note
This function must be called while running in kernel mode. The program must also be linked against the pspkernel library.

◆ pspSdkInstallNoPlainModuleCheckPatch()

int pspSdkInstallNoPlainModuleCheckPatch ( void  )

Patch sceLoadCore module to remove loading plain module checks.

Note
This function must be called while running in kernel mode.
Returns
0 on success, otherwise one of PspKernelErrorCodes.

◆ pspSdkLoadInetModules()

int pspSdkLoadInetModules ( )

Load Inet related modules.

Note
You must be in kernel mode to execute this function.
Returns
- 0 on success, otherwise one of PspKernelErrorCodes.

◆ pspSdkLoadStartModule()

SceUID pspSdkLoadStartModule ( const char filename,
int  mpid 
)

Load a module and start it.

Parameters
filename- Path to the module.
mpid- Memory parition ID to use to load the module int.
Returns
- The UID of the module on success, otherwise one of PspKernelErrorCodes.

References NULL, pspSdkLoadStartModuleWithArgs(), and x.

◆ pspSdkLoadStartModuleWithArgs()

SceUID pspSdkLoadStartModuleWithArgs ( const char filename,
int  mpid,
int  argc,
char *const  argv[] 
)

Load a module and start it with arguments.

Parameters
filename- Path to the module.
mpid- Memory parition ID to use to load the module int.
argc- Number of arguments to pass to start module
argv- Array of arguments
Returns
- The UID of the module on success, otherwise one of PspKernelErrorCodes.

References i, MAX_ARGS, modid, NULL, sceKernelLoadModule(), sceKernelStartModule(), and x.

Referenced by pspSdkLoadStartModule().

◆ pspSdkQueryModuleInfoV1()

int pspSdkQueryModuleInfoV1 ( SceUID  uid,
SceKernelModuleInfo modinfo 
)

Query a modules information from its uid.

Note
this is a replacement function for the broken kernel sceKernelQueryModuleInfo in v1.0 firmware DO NOT use on a anything above that version. This also needs kernel mode access where the normal one has a user mode stub.
Parameters
uid- The UID of the module to query.
modinfo- Pointer a module SceKernelModuleInfo structure.
Returns
< 0 on error.

References NULL, sceKernelFindModuleByUID(), and x.

◆ pspSdkReferCallbackStatusByName()

int pspSdkReferCallbackStatusByName ( const char name,
SceUID pUID,
SceKernelCallbackInfo pInfo 
)

Search for a callback with the given name and retrieve it's SceKernelCallbackInfo struct.

Parameters
name- The name of to search for.
pUID- If the given name is found, it's SceUID is stored here.
pInfo- If the given name is found, it's SceKernelMppInfo data is stored here.
Returns
0 if successful, otherwise one of PspKernelErrorCodes.

References name, NULL, SCE_KERNEL_TMID_Callback, sceKernelReferCallbackStatus(), and x.

◆ pspSdkReferEventFlagStatusByName()

int pspSdkReferEventFlagStatusByName ( const char name,
SceUID pUID,
SceKernelEventFlagInfo pInfo 
)

Search for an event flag with the given name and retrieve it's SceKernelEventFlagInfo struct.

Parameters
name- The name of the event flag to search for.
pUID- If the event flag with the given name is found, it's SceUID is stored here.
pInfo- If the event flag with the given name is found, it's SceKernelEventFlagInfo data is stored here.
Returns
0 if successful, otherwise one of PspKernelErrorCodes.

References name, NULL, SCE_KERNEL_TMID_EventFlag, sceKernelReferEventFlagStatus(), and x.

◆ pspSdkReferFplStatusByName()

int pspSdkReferFplStatusByName ( const char name,
SceUID pUID,
SceKernelFplInfo pInfo 
)

Search for a FPL with the given name and retrieve it's SceKernelFplInfo struct.

Parameters
name- The name of to search for.
pUID- If the given name is found, it's SceUID is stored here.
pInfo- If the given name is found, it's SceKernelFplInfo data is stored here.
Returns
0 if successful, otherwise one of PspKernelErrorCodes.

References name, NULL, SCE_KERNEL_TMID_Fpl, sceKernelReferFplStatus(), and x.

◆ pspSdkReferMboxStatusByName()

int pspSdkReferMboxStatusByName ( const char name,
SceUID pUID,
SceKernelMbxInfo pInfo 
)

Search for a message box with the given name and retrieve it's SceKernelMbxInfo struct.

Parameters
name- The name of the message box to search for.
pUID- If the message box with the given name is found, it's SceUID is stored here.
pInfo- If the message box with the given name is found, it's SceKernelMbxInfo data is stored here.
Returns
0 if successful, otherwise one of PspKernelErrorCodes.

References name, NULL, SCE_KERNEL_TMID_Mbox, sceKernelReferMbxStatus(), and x.

◆ pspSdkReferMppStatusByName()

int pspSdkReferMppStatusByName ( const char name,
SceUID pUID,
SceKernelMppInfo pInfo 
)

Search for a message pipe with the given name and retrieve it's SceKernelMppInfo struct.

Parameters
name- The name of to search for.
pUID- If the given name is found, it's SceUID is stored here.
pInfo- If the given name is found, it's SceKernelMppInfo data is stored here.
Returns
0 if successful, otherwise one of PspKernelErrorCodes.

References name, NULL, SCE_KERNEL_TMID_Mpipe, sceKernelReferMsgPipeStatus(), and x.

◆ pspSdkReferSemaStatusByName()

int pspSdkReferSemaStatusByName ( const char name,
SceUID pUID,
SceKernelSemaInfo pInfo 
)

Search for a semaphore with the given name and retrieve it's SceKernelSemaInfo struct.

Parameters
name- The name of the sema to search for.
pUID- If the sema with the given name is found, it's SceUID is stored here.
pInfo- If the sema with the given name is found, it's SceKernelSemaInfo data is stored here.
Returns
0 if successful, otherwise one of PspKernelErrorCodes.

References name, NULL, SCE_KERNEL_TMID_Semaphore, sceKernelReferSemaStatus(), and x.

◆ pspSdkReferThreadEventHandlerStatusByName()

int pspSdkReferThreadEventHandlerStatusByName ( const char name,
SceUID pUID,
SceKernelThreadEventHandlerInfo pInfo 
)

Search for a thread event handler with the given name and retrieve it's SceKernelThreadEventHandlerInfo struct.

Parameters
name- The name of to search for.
pUID- If the given name is found, it's SceUID is stored here.
pInfo- If the given name is found, it's SceKernelThreadEventHandlerInfo data is stored here.
Returns
0 if successful, otherwise one of PspKernelErrorCodes.

References name, NULL, SCE_KERNEL_TMID_ThreadEventHandler, sceKernelReferThreadEventHandlerStatus(), and x.

◆ pspSdkReferThreadStatusByName()

int pspSdkReferThreadStatusByName ( const char name,
SceUID pUID,
SceKernelThreadInfo pInfo 
)

Search for a thread with the given name and retrieve it's SceKernelThreadInfo struct.

Parameters
name- The name of the thread to search for.
pUID- If the thread with the given name is found, it's SceUID is stored here.
pInfo- If the thread with the given name is found, it's SceKernelThreadInfo data is stored here.
Returns
0 if successful, otherwise one of PspKernelErrorCodes.

References name, NULL, SCE_KERNEL_TMID_Thread, sceKernelReferThreadStatus(), and x.

◆ pspSdkReferVplStatusByName()

int pspSdkReferVplStatusByName ( const char name,
SceUID pUID,
SceKernelVplInfo pInfo 
)

Search for a VPL with the given name and retrieve it's SceKernelVplInfo struct.

Parameters
name- The name of to search for.
pUID- If the given name is found, it's SceUID is stored here.
pInfo- If the given name is found, it's SceKernelVplInfo data is stored here.
Returns
0 if successful, otherwise one of PspKernelErrorCodes.

References name, NULL, SCE_KERNEL_TMID_Vpl, sceKernelReferVplStatus(), and x.

◆ pspSdkReferVTimerStatusByName()

int pspSdkReferVTimerStatusByName ( const char name,
SceUID pUID,
SceKernelVTimerInfo pInfo 
)

Search for a vtimer with the given name and retrieve it's SceKernelVTimerInfo struct.

Parameters
name- The name of to search for.
pUID- If the given name is found, it's SceUID is stored here.
pInfo- If the given name is found, it's SceKernelVTimerInfo data is stored here.
Returns
0 if successful, otherwise one of PspKernelErrorCodes.

References name, NULL, SCE_KERNEL_TMID_VTimer, sceKernelReferVTimerStatus(), and x.

◆ pspSdkSetK1()

unsigned int pspSdkSetK1 ( unsigned int  k1)

Set the processors K1 register to a known value.

Note
This function is for use in kernel mode syscall exports. The kernel sets the k1 register to indicate what mode called the function, i.e. whether it was directly called, was called via a syscall from a kernel thread or called via a syscall from a user thread. By setting k1 to 0 before doing anything in your code you can make the other functions think you are calling from a kernel thread and therefore disable numerous protections.
Parameters
k1- The k1 value to set
Returns
The previous value of k1

◆ pspSdkTotalFreeUserMemSize()

SceSize pspSdkTotalFreeUserMemSize ( void  )

Gets the amount of memory available in the user partition(s).

Note
This is not to be confused with sceKernelTotalFreeMemSize, which rather contradictorily only returns the amount of memory free in the kernel memory partition.
Returns
The amount of user memory available, in bytes.

References NULL, pspSdkDisableInterrupts(), pspSdkEnableInterrupts(), size, and x.