WiiUBrew

Changes

Coreinit.rpl (view source)

Revision as of 20:53, 17 May 2023

17,138 bytes added ,  20:53, 17 May 2023
Cleanup and add ConsoleType
Line 1: Line 1:  
coreinit.rpl is the the system library that provides direct access to Cafe OS services. It provides kernel calls, thread scheduling, memory management, and filesystem services. coreinit is the first RPL loaded by the loader, even before the main executable itself.
 
coreinit.rpl is the the system library that provides direct access to Cafe OS services. It provides kernel calls, thread scheduling, memory management, and filesystem services. coreinit is the first RPL loaded by the loader, even before the main executable itself.
   −
==Functions==
+
= Functions =
−
===Cache===
+
== Auto Power-Down ==
 +
The Auto Power-Down feature in the WiiU saves the battery of the console, shutting down in one hour when there is no user activity.
 +
{| class="wikitable"
 +
!Name
 +
!Prototype
 +
!Description
 +
|-
 +
|IMEnableAPD
 +
|<code>void IMEnableAPD(void)</code>
 +
|Enables the Auto Power-Down system.
 +
|-
 +
|IMDisableAPD
 +
|<code>void IMDisableAPD(void)</code>
 +
|Disables the Auto Power-Down system.
 +
|-
 +
|IMIsAPDEnabled
 +
|<code>void IMIsAPDEnabled(uint32_t *isEnabled)</code>
 +
|Writes the current Auto Power-Down setting to isEnabled: 0x0 = off, 0x1 = on.
 +
|-
 +
|IMIsAPDEnabledBySysSettings
 +
|<code>void IMIsAPDEnabledBySysSettings(uint32_t *isEnabled)</code>
 +
|Writes the current Auto Power-Down setting from system settings to isEnabled: 0x0 = off, 0x1 = on.
 +
|
 +
|-
 +
|IMGetAPDPeriod
 +
|<code>void IMGetAPDPeriod(uint32_t *apd_secs)</code>
 +
|Returns the amount of seconds it takes of user inactivity to turn off the WiiU, if the Auto Power-Down setting is True. apd_secs is a pointer to the variable that stores the amount of seconds.
 +
|-
 +
|IMGetTimeBeforeAPD
 +
|<code>void IMGetTimeBeforeAPD(uint32_t *apd_secs)</code>
 +
|Returns the amount of seconds that are left until the WiiU powers down, if the Auto Power-Down setting is True. apd_secs is a pointer to the variable that stores the amount of seconds.
 +
|}
 +
 
 +
== Driver ==
 +
{| class="wikitable"
 +
!Name
 +
!Prototype
 +
!Description
 +
|-
 +
|OSDriver_Register
 +
|<code>uint32_t OSDriver_Register(char *drv_name, size_t name_len, void *buf1, void *buf2)</code>
 +
|Will register an OSDriver entity with the given name and bufs
 +
|-
 +
|OSDriver_Deregister
 +
|<code>uint32_t OSDriver_Deregister(char *drv_name, size_t name_len)</code>
 +
|Will try to find a OSDriver with the given name (and length because implementing a strlen was too hard), and deregister him
 +
|-
 +
|OSDriver_CopyToSaveArea
 +
|<code>uint32_t OSDriver_CopyToSaveArea(char *drv_name, size_t name_len, void *in_buf, size_t buf_size)</code>
 +
|Will copy buf to an OSDriver "safe" save area [0x44/4]
 +
|-
 +
|OSDriver_CopyFromSaveArea
 +
|<code>uint32_t OSDriver_CopyFromSaveArea(char *drv_name, size_t name_len, void *out_buf, size_t buf_size)</code>
 +
|Will copy data from the OSDriver save area to an user controlled buffer
 +
|}
 +
 
 +
== Memory ==
 +
{| class="wikitable"
 +
!Name
 +
!Prototype
 +
!Description
 +
|-
 +
|memset
 +
|<code>void *memset(void *str, int c, size_t n)</code>
 +
|Call OSBlockSet (Looks like it does the same thing as standart memset). Copies the character c (an unsigned char) to the first n characters of the String pointed to by the argument str. See  [http://www.tutorialspoint.com/c_standard_library/c_function_memset.htm]
 +
|-
 +
|memclr
 +
|<code>void *memclr(void *str, size_t n)</code>
 +
|Like memset but sets the memory to 0. Call OSBlockSet (memset) with 0 as second arg (r4).
 +
|-
 +
|memcpy
 +
|<code>void *memcpy(void *str1, const void *str2, size_t n)</code>
 +
|Call OSBlockMove with  1 as the  fourth arg (r6).Copies n characters from memory area str2 to memory area str1. See [http://www.tutorialspoint.com/c_standard_library/c_function_memcpy.htm]
 +
|-
 +
|memmove
 +
|<code>void *memmove(void *str1, const void *str2, size_t n)</code>
 +
|Call OSBlockMove with 1 as the fourth arg (r6) exactly the same as memcpy.
 +
|-
 +
|MEMAllocFromDefaultHeapEx
 +
|<code>void *MEMAllocFromDefaultHeapEx(uint32_t size, int alignment)</code>
 +
|Allocates memory on the heap with the given size and memory alignment. This is typically in the 0x4??????? memory area
 +
|-
 +
|MEMFreeToDefaultHeap
 +
|<code>void MEMFreeToDefaultHeap(void* addr)</code>
 +
|Frees previously heap memory. addr is the address returned by MEMAllocFromDefaultHeapEx()
 +
|-
 +
|OSAllocFromSystem
 +
|<code>void *OSAllocFromSystem(uint32_t size, int alignment)</code>
 +
|Allocates system memory with the given size and memory alignment. This is typically in the 0x10?????? memory area
 +
|-
 +
|OSFreeToSystem
 +
|<code>void OSFreeToSystem(void* addr)</code>
 +
|Frees previously allocated system memory. addr is the address returned by OSAllocFromSystem()
 +
|-
 +
|OSBlockMove
 +
|<code>void *OSBlockMove(void* dst, const void* src, uint32_t size, bool flush);</code>
 +
|Will move src to dest (And set the flush flag to flush src in the data cache)
 +
|-
 +
|OSBlockSet
 +
|<code>void *OSBlockSet(void* dst, uint8_t val, uint32_t size);</code>
 +
|Basic memset (??? Is that uint8_t)
 +
|}
 +
 
 +
== Cache ==
 
{| class="wikitable"
 
{| class="wikitable"
 
!Name
 
!Name
Line 21: Line 124:  
|}
 
|}
   −
===Disassembler===
+
== Disassembler ==
 
{| class="wikitable"
 
{| class="wikitable"
 
!Name
 
!Name
Line 36: Line 139:  
|}
 
|}
   −
===Dynamic Linking===
+
== Dynamic Linking ==
 
{| class="wikitable"
 
{| class="wikitable"
 
!Name
 
!Name
Line 47: Line 150:  
|-
 
|-
 
|OSDynLoad_IsModuleLoaded
 
|OSDynLoad_IsModuleLoaded
−
|<code>int OSDynLoad_Acquire(const char *rplname, uint32_t *handle)</code>  
+
|<code>int OSDynLoad_IsModuleLoaded(const char *rplname, uint32_t *handle)</code>  
 
|Checks if a module is loaded. If the target module is loaded the function set the existing handle to the module otherwise the handle is not set. Returns a errorcode.
 
|Checks if a module is loaded. If the target module is loaded the function set the existing handle to the module otherwise the handle is not set. Returns a errorcode.
 
|-
 
|-
Line 59: Line 162:  
|}
 
|}
   −
===Error===
+
Attempting to use OSDynLoad_Acquire() with rplname "nn_uds.rpl" / "test.rpl" (which Internet Browser itself doesn't import) under Internet Browser has the same result: OSDynLoad_Acquire() never returns. Launching a game which uses the former before running Internet Browser has the same result.
 +
 
 +
== Error ==
 
{| class="wikitable"
 
{| class="wikitable"
 
!Name
 
!Name
Line 70: Line 175:  
|}
 
|}
   −
===Internal===
+
== Internal ==
 
{| class="wikitable"
 
{| class="wikitable"
 
!Name
 
!Name
Line 81: Line 186:  
|}
 
|}
   −
===Threads===
+
== Threads ==
 
{| class="wikitable"
 
{| class="wikitable"
 
!Name
 
!Name
Line 101: Line 206:  
|OSGetCurrentThread
 
|OSGetCurrentThread
 
|<code>OSThread *OSGetCurrentThread(void)</code>
 
|<code>OSThread *OSGetCurrentThread(void)</code>
−
|Get the OSThread structure ptr for the current thread.
+
|Get the OSThread structure ptr for the current thread
 +
|-
 +
|OSSetThreadName
 +
|<code>void OSSetThreadName(OSThread *thread, char *name)</code>
 +
|Sets a new name for the thread
 +
|-
 +
|OSGetThreadName
 +
|<code>char *OSGetThreadName(OSThread *thread)</code>
 +
|Returns a pointer to the thread's name char array
 
|-
 
|-
 
|OSSetThreadAffinity
 
|OSSetThreadAffinity
 
|<code>uint32_t OSSetThreadAffinity(OSThread* thread, int16_t affinity)</code>
 
|<code>uint32_t OSSetThreadAffinity(OSThread* thread, int16_t affinity)</code>
−
|Sets the affinity for the specified thread. Returns 0 for failure, 1 for success.
+
|Sets the affinity for the specified thread. Returns 0 for failure, 1 for success
 
|-
 
|-
 
|OSGetCoreId
 
|OSGetCoreId
 
|<code>uint32_t OSGetCoreId(void)</code>
 
|<code>uint32_t OSGetCoreId(void)</code>
−
|Returns the PowerPC coreid this code is running on(value of spr1007).
+
|Returns the PowerPC coreid this code is running on(value of spr1007)
 
|-
 
|-
 
|OSGetStackPointer
 
|OSGetStackPointer
 
|<code>uint32_t *OSGetStackPointer(void)</code>
 
|<code>uint32_t *OSGetStackPointer(void)</code>
−
|Returns the r1 register(aka "sp").
+
|Returns the r1 register(aka "sp")
 
|-
 
|-
 
|OSSwitchStack
 
|OSSwitchStack
 
|<code>void OSSwitchStack(uint32_t *stackptr)</code>
 
|<code>void OSSwitchStack(uint32_t *stackptr)</code>
−
|This basically sets the current thread's r1(aka sp) to the input address, and also calls internal coreinit functions with input_param=input_stackptr. Note that this overwrites data near the start of the specified address due to stack push/pop. This will return to the address LR was set to at function entry.
+
|This basically sets the current thread's r1(aka sp) to the input address, and also calls internal coreinit functions with input_param=input_stackptr. Note that this overwrites data near the start of the specified address due to stack push/pop. This will return to the address LR was set to at function entry
 
|}
 
|}
   −
===Codegen===
+
== Codegen ==
 
These functions are used for managing the codegen/JIT area which begins at virtual-memory address 0x01800000. The codegen area size, whether codegen can be used at all, and permissions/etc are loaded from cos.xml for the process. Hence, almost all processes which don't use WebKit don't have access to codegen. These permissions include the coreid which is allowed to use codegen at all(with [[Internet Browser]] this is core1). These permissions also seem to include whether the process is allowed to use OSCodegenCopy([[Internet Browser]] isn't allowed to use it). Certain Virtual Console titles seem to be the only applications which are allowed to use OSCodegenCopy due to cos.xml(codegen_core is set to 40000001 for these, unlike 80000001 for browser-based titles).
 
These functions are used for managing the codegen/JIT area which begins at virtual-memory address 0x01800000. The codegen area size, whether codegen can be used at all, and permissions/etc are loaded from cos.xml for the process. Hence, almost all processes which don't use WebKit don't have access to codegen. These permissions include the coreid which is allowed to use codegen at all(with [[Internet Browser]] this is core1). These permissions also seem to include whether the process is allowed to use OSCodegenCopy([[Internet Browser]] isn't allowed to use it). Certain Virtual Console titles seem to be the only applications which are allowed to use OSCodegenCopy due to cos.xml(codegen_core is set to 40000001 for these, unlike 80000001 for browser-based titles).
   Line 153: Line 266:  
|}
 
|}
   −
=== Screen ===
+
== Screen ==
 
"bufferNum" is the screenid, see the below screen defines for that. OSScreen *only* supports values 0-1 for screenid. "colour" in the form stored in memory is RGBA8. These functions can't be used without crashing, unless OSScreen was properly initialized. The below functions will immediately return if x/y is out-of-bounds.
 
"bufferNum" is the screenid, see the below screen defines for that. OSScreen *only* supports values 0-1 for screenid. "colour" in the form stored in memory is RGBA8. These functions can't be used without crashing, unless OSScreen was properly initialized. The below functions will immediately return if x/y is out-of-bounds.
   Line 204: Line 317:  
|}
 
|}
   −
===OSSystem=== <!-- TODO: Find better name?? -->
+
== System ==
−
 
   
{| class="wikitable"
 
{| class="wikitable"
 
!Name
 
!Name
Line 214: Line 326:  
|<code>OSTime OSGetSystemTime(void)</code>
 
|<code>OSTime OSGetSystemTime(void)</code>
 
|Gets OSTime (which is just an int64_t) from tbu/tb (timebase upper/lower special purpose registers), same as get_timebase in kernel (FFF099E0 on 5.5.X)
 
|Gets OSTime (which is just an int64_t) from tbu/tb (timebase upper/lower special purpose registers), same as get_timebase in kernel (FFF099E0 on 5.5.X)
 +
|-
 +
|OSGetTime
 +
|<code>OSTime OSGetTime(void)</code>
 +
|Returns OSTime equal to then number of ticks from 1/1/2000 00:00
 +
|-
 +
|OSTicksToCalendarTime
 +
|<code>void OSTicksToCalendarTime(OSTime time, OSCalendarTime *calendartime)</code>
 +
|Converts OStime to an OSCalendarTime structure
 
|-
 
|-
 
|OSGetSystemInfo
 
|OSGetSystemInfo
 
|<code>uint32_t* OSGetSystemInfo(void)</code>
 
|<code>uint32_t* OSGetSystemInfo(void)</code>
 
|Returns pointer to OSSystemInfo struct (see below)
 
|Returns pointer to OSSystemInfo struct (see below)
 +
|-
 +
|OSIsDebuggerInitialized
 +
|<code>int OSIsDebuggerInitialized(void)</code>
 +
|Returns 1 if [https://en.wikipedia.org/wiki/GNU_Debugger GDB] has been initialized. Default is 0.
 +
|-
 +
|OSIsDebuggerPresent
 +
|<code>uint32_t OSIsDebuggerPresent(void)</code>
 +
|Returns 1 if a debugger is present. Default is 0.
 +
|-
 +
|OSIsInterruptEnabled
 +
|<code>int OSIsInterruptEnabled(void)</code>
 +
|Returns 1 if [https://en.wikipedia.org/wiki/Interrupt interrupts] are enabled. Default is 1.
 +
|-
 +
|OSDisableInterrupts
 +
|<code>int OSDisableInterrupts(void)</code>
 +
|Disables interrupts. Returns 1 on success otherwise, if already disabled, returns 0.
 +
|-
 +
|OSIsAddressValid
 +
|<code>int OSIsAddressValid(int addr)</code>
 +
|Determines whether the given address addr is readable. Returns 1 or 0.
 +
|-
 +
|OSIsHomeButtonMenuEnabled
 +
|<code>int OSIsHomeButtonMenuEnabled(void)</code>
 +
|Whether the home menu button is enabled. Default is 1.
 +
|-
 +
|OSGetConsoleType
 +
|<code>uint32_t OSGetConsoleType(void)</code>
 +
|Returns the [[#ConsoleType|ConsoleType]].
 +
|-
 +
|OSSleepTicks
 +
|<code>void OSSleepTicks(OSTime)</code>
 +
|Makes the current thread sleep for a specified amount of ticks
 +
|-
 +
|_Exit
 +
|<code>void _Exit(int status)</code>
 +
|Makes the current process exit. Crashes when invoked in titles like Wii U games
 +
|-
 +
|OSEffectiveToPhysical
 +
|<code>uint32_t OSEffectiveToPhysical(uint32_t addr)</code>
 +
|Converts an effective address to its physical representation. For example 0x10000000 becomes 0x50000000
 +
|-
 +
|OSGetPFID
 +
|<code>int OSGetPFID(void)</code>
 +
|Returns the current process PFID e.g. 15 (Game)
 +
|-
 +
|OSGetUPID
 +
|<code>int OSGetUPID(void)</code>
 +
|Does the same as OSGetPFID
 +
|-
 +
|OSGetTitleID
 +
|<code>uint64_t OSGetTitleID(void)</code>
 +
|Returns the current title id e.g. 0x0005000E1010ED00 (Mario Kart 8 EUR). See [http://wiiubrew.org/wiki/Title_database]
 +
|-
 +
|OSGetOSID
 +
|<code>uint64_t OSGetOSID(void)</code>
 +
|Returns the current OS id e.g. 0x000500101000400A (OSv10). See [http://wiiubrew.org/wiki/Title_database]
 +
|-
 +
|__OSGetAppFlags
 +
|<code>uint32_t __OSGetAppFlags(void)</code>
 +
|Returns the flags set for the current app e.g. 0x00000200. Influences the control flow in OSSDKVersionInits
 +
|-
 +
|__OSGetProcessSDKVersion
 +
|<code>uint32_t __OSGetProcessSDKVersion(void)</code>
 +
|Returns the SDK version e.g. 0x000050DF
 +
|-
 +
|OSSDKVersionInits
 +
|<code>? OSSDKVersionInits(?)</code>
 +
|Initializes the OS SDK version using the results from __OSGetAppFlags and __OSGetProcessSDKVersion. Seems to crash when invoked
 +
|-
 +
|OSShutdown
 +
|<code>int OSShutdown(int status)</code>
 +
|Shuts down the console. Behaves identical to holding down the power button. Returns 1 on success
 +
|}
 +
 +
== Boot ==
 +
{| class="wikitable"
 +
!Name
 +
!Prototype
 +
!Description
 +
|-
 +
|OSIsColdBoot
 +
|<code>int OSIsColdBoot(void)</code>
 +
|Probably allows for [https://en.wikipedia.org/wiki/Cold_boot_attack cold boot attacks]. Default is 0.
 +
|-
 +
|OSIsSelfRefreshBoot
 +
|<code>int OSIsSelfRefreshBoot(void)</code>
 +
|Probably handles [https://en.wikipedia.org/wiki/Memory_refresh memory refreshing]. Default is 0.
 +
|-
 +
|OSIsNormalBoot
 +
|<code>int OSIsNormalBoot(void)</code>
 +
|Determines the boot type (normal and ?). Default is 1.
 +
|-
 +
|OSIsECOBoot
 +
|<code>int OSIsECOBoot(void)</code>
 +
|Whether to save energy (at the expense of processing power). Default is 0.
 +
|-
 +
|OSIsStandbyBoot
 +
|<code>int OSIsStandbyBoot(void)</code>
 +
|Whether the boot is in [https://en.wikipedia.org/wiki/Sleep_mode sleep mode]. Default is 0.
 
|}
 
|}
   −
==Filesystem==
+
== IOS ==
 +
{| class="wikitable"
 +
!Name
 +
!Prototype
 +
!Description
 +
|-
 +
|IOS_Open
 +
|<code>int IOS_Open(char *path, uint32_t mode)</code>
 +
|Gets an handle to an IOS device node at the specified path whith the given mode
 +
|-
 +
|IOS_Close
 +
|<code>int IOS_Close(int fd);</code>
 +
|Closes an handle to an IOS device node fd (returned by IOS_Open)
 +
|-
 +
|IOS_Ioctl
 +
|<code>int IOS_Ioctl(int fd, uint32_t request, void *input_buf, uint32_t input_buf_len, void *output_buf, uint32_t output_buf_len)</code>
 +
|Sends an ioctl request to an IOS device node fd; input_buf contains the input data for the request, output_buf cointains what the request returns
 +
|}
 +
 
 +
== MCP ==
 +
{| class="wikitable"
 +
!Name
 +
!Prototype
 +
!Description
 +
|-
 +
|MCP_Open
 +
|int MCP_Open()
 +
|Opens an handle to the MCP IOS node
 +
|-
 +
|MCP_Close
 +
|int MCP_Close(int handle)
 +
|Closes an handle to the MCP IOS node
 +
|-
 +
|MCP_DeviceList
 +
|int MCP_DeviceList(int handle, int *numDevices, MCPDeviceList *outDevices, uint32_t outBufferSize)
 +
|Gets a list of available devices
 +
|-
 +
|MCP_FullDeviceList
 +
|int MCP_FullDeviceList(int handle, int *numDevices, MCPDeviceList *outDevices, uint32_t outBufferSize)
 +
|Gets the full list of available devices
 +
|-
 +
|MCP_InstallSetTargetDevice
 +
|int MCP_InstallSetTargetDevice(int handle, MCPInstallTarget device)
 +
|Sets the the target device for title installation
 +
|-
 +
|MCP_InstallGetTargetDevice
 +
|int MCP_InstallGetTargetDevice(int handle, MCPInstallTarget *deviceOut)
 +
|Gets the target device for title installation
 +
|-
 +
|MCP_InstallSetTargetUsb
 +
|int MCP_InstallSetTargetUsb(int handle, int usb)
 +
|Sets the target USB device for installation
 +
|-
 +
|MCP_InstallGetInfo
 +
|int MCP_InstallGetInfo(int handle, char *path, MCPInstallInfo *out)
 +
|Gets informations about the install operation
 +
|-
 +
|MCP_InstallTitleAsync
 +
|int MCP_InstallTitleAsync(int handle, char *path, MCPInstallInfo *out)
 +
|Installs a title
 +
|-
 +
|MCP_InstallGetProgress
 +
|int MCP_InstallGetProgress(int handle, MCPInstallProgress *installProgressOut)
 +
|Gets installation progress
 +
|-
 +
|MCP_InstallTitleAbort
 +
|int MCP_InstallTitleAbort(int handle)
 +
|Aborts the installation of a title
 +
|-
 +
|MCP_UninstallTitleAsync
 +
|int MCP_UninstallTitleAsync(int handle, char *path, MCPInstallInfo *out)
 +
|Uninstalls a title
 +
|}
 +
 
 +
= Filesystem =
 
The FS* functions appear to only be used by regular applications, while the FSA* functions appear to only be used by system rpls.
 
The FS* functions appear to only be used by regular applications, while the FSA* functions appear to only be used by system rpls.
−
===Setup===
+
 
 +
== Setup ==
 
{| class="wikitable"
 
{| class="wikitable"
 
!Name
 
!Name
Line 255: Line 549:  
|}
 
|}
   −
===Command Blocks===
+
== Command Blocks ==
 
{| class="wikitable"
 
{| class="wikitable"
 
!Name
 
!Name
Line 303: Line 597:  
|}
 
|}
   −
== Structures ==
+
== File Commands ==
−
=== Threads ===
+
{| class="wikitable"
 +
!Name
 +
!Prototype
 +
!Description
 +
!Return Values: 0=FS_STATUS_OK -or- <0=[[#Defines| Error Codes]]
 +
!Notes
 +
|-
 +
|FSOpenFile
 +
|<code>FSStatus FSOpenFile( FSClient *client, FSCmdBlock *block, const char *path, const char *mode, FSFileHandle *fileHandle, FSRetFlag errHandling );
 +
|Open file stream
 +
| -1 -3 -4 -6 -7 -8 -9 -10 -12 -13 -15 -17 -18 -19
 +
|
 +
|-
 +
|FSCloseFile
 +
|<code>FSStatus FSCloseFile( FSClient *client, FSCmdBlock *block, FSFileHandle fileHandle, FSRetFlag errHandling );
 +
|Close file stream.
 +
| -1 -17
 +
|
 +
|-
 +
|FSReadFile
 +
|<code>FSStatus FSReadFile( FSClient *client, FSCmdBlock *block, void *dest, FSSize size, FSCount count, FSFileHandle fileHandle, FSFlag flag, FSRetFlag errHandling );
 +
|Read data from an open file.
 +
|Non-negative value ( >= 0 ) = Number of elements read or -1 -9 -15 -17 -18
 +
|
 +
|-
 +
|FSWriteFile
 +
|<code>FSStatus FSWriteFile( FSClient *client, FSCmdBlock *block, const void *source, FSSize size, FSCount count, FSFileHandle fileHandle, FSFlag flag, FSRetFlag errHandling );
 +
|Write data to file
 +
|Non-negative value ( >= 0 ) = Number of elements write or -1 -9 -11 -12 -13 -14 -15 -17 -18
 +
|
 +
|-
 +
|FSAppendFile
 +
|<code>FSStatus FSAppendFile( FSClient *client, FSCmdBlock *block, FSSize size, FSCount count, FSFileHandle fileHandle, FSRetFlag errHandling );
 +
|Append file.
 +
|Non-negative value ( >= 0 ) = Newly appended size (newly added preallocation area [Byte] divided by size) or -1 -9 -11 -12 -13 -15 -17 -18 -19
 +
|
 +
|-
 +
|FSTruncateFile
 +
|<code>FSStatus FSTruncateFile( FSClient *client, FSCmdBlock *block, FSFileHandle fileHandle, FSRetFlag errHandling );
 +
|Truncate file at file position
 +
| -1 -9 -12 -13 -14 -15 -17 -18
 +
|
 +
|-
 +
|FSFlushFile
 +
|<code>FSStatus FSFlushFile( FSClient *client, FSCmdBlock *block, FSFileHandle fileHandle, FSRetFlag errHandling );
 +
|Flush file.
 +
| -1 -9 -15 -17 -18
 +
|
 +
|-
 +
|FSGetPosFile
 +
|<code>FSStatus FSGetPosFile( FSClient *client, FSCmdBlock *block, FSFileHandle fileHandle, FSFilePosition *returnedFpos, FSRetFlag errHandling );
 +
|Get position of specified file stream.
 +
| -1 -15 -17 -18
 +
|
 +
|-
 +
|FSSetPosFile
 +
|<code>FSStatus FSSetPosFile( FSClient *client, FSCmdBlock *block, FSFileHandle fileHandle, FSFilePosition fpos, FSRetFlag errHandling );
 +
|Set position of specified file stream
 +
| -1 -15 -17 -18
 +
|
 +
|-
 +
|FSGetStatFile
 +
|<code>FSStatus FSGetStatFile( FSClient *client, FSCmdBlock *block, FSFileHandle fileHandle, FSStat *returnedStat, FSRetFlag errHandling );
 +
|Get stat information of specified file.
 +
| -1 -15 -17 -18
 +
|
 +
|-
 +
|FSIsEof
 +
|<code>FSStatus FSIsEof( FSClient *client, FSCmdBlock *block, FSFileHandle fileHandle, FSRetFlag errHandling );
 +
|Determine if the current file position of specified file stream is at the end-of-file(EOF).
 +
| -1 -2 -15 -17 -18
 +
|
 +
|-
 +
|FSOpenDir
 +
|<code>FSStatus FSOpenDir( FSClient *client, FSCmdBlock *block, const char *path, FSDirHandle *dirHandle, FSRetFlag errHandling );
 +
|Open directory stream
 +
| -1 -3 -6 -8 -10 -15 -17 -18
 +
|
 +
|-
 +
|FSCloseDir
 +
|<code>FSStatus FSCloseDir( FSClient *client, FSCmdBlock *block, FSDirHandle dirHandle, FSRetFlag errHandling );
 +
|Close directory stream.
 +
| -1 -17
 +
|
 +
|-
 +
|FSReadDir
 +
|<code>FSStatus FSReadDir( FSClient *client, FSCmdBlock *block, FSDirHandle dirHandle, FSDirEntry *returnedDirEntry, FSRetFlag errHandling );
 +
|Read next directory entry.
 +
| -1 -2 -15 -17 -18
 +
|
 +
|-
 +
|FSRewindDir
 +
|<code>FSStatus FSRewindDir( FSClient *client, FSCmdBlock *block, FSDirHandle dirHandle, FSRetFlag errHandling );
 +
|Set position of specified directory stream to the head.
 +
| -1 -2 -15 -17 -18
 +
|
 +
|-
 +
|FSGetCwd
 +
|<code>FSStatus FSGetCwd( FSClient *client, FSCmdBlock *block, char *returnedPath, u32 bytes, FSRetFlag errHandling );
 +
|Get current work directory.
 +
| -1
 +
|
 +
|-
 +
|FSMakeDir
 +
|<code>FSStatus FSMakeDir( FSClient *client, FSCmdBlock *block, const char*path, FSRetFlag errHandling );
 +
|Create directory.
 +
| -1 -5 -6 -8 -10 -12 -13 -14 -17 -18 -19 
 +
|
 +
|-
 +
|FSRemove
 +
|<code>FSStatus FSRemove( FSClient *client, FSCmdBlock *block, const char *path, FSRetFlag errHandling );
 +
|Remove file or directory.
 +
| -1 -4 -6 -8 -9 -10 -12 -13 -14 -15 -17 -18 -19
 +
|
 +
|-
 +
|FSRename
 +
|<code>FSStatus FSRename( FSClient *client, FSCmdBlock *block, const char *oldpath, const char *newpath, FSRetFlag errHandling );
 +
|Rename file or directory.
 +
| -1 -4 -5 -6 -8 -10 -12 -13 -14 -15 -17 -18 -19
 +
|
 +
|-
 +
|FSFlushQuota
 +
|<code>FSStatus FSFlushQuota( FSClient *client, FSCmdBlock *block, const char *path, FSRetFlag errHandling );
 +
|Flush journaling data of quota.
 +
| -1 -6 -14 -15 -17 -18 -19
 +
|
 +
|-
 +
|FSRollbackQuota
 +
|<code>FSStatus FSRollbackQuota( FSClient *client, FSCmdBlock *block, const char *path, FSRetFlag errHandling );
 +
|Rollback journaling data of quota.
 +
| -1 -4 -6 -14 -15 -17 -18
 +
|
 +
|-
 +
|FSGetStat
 +
|<code>FSStatus FSGetStat( FSClient *client, FSCmdBlock *block, const char *path, FSStat *returnedStat, FSRetFlag errHandling );
 +
|Get stat information of specified entry.
 +
| -1 -6 -10 -15 -16 -18 -19
 +
|
 +
|-
 +
|FSGetFreeSpaceSize
 +
|<code>FSStatus FSGetFreeSpaceSize( FSClient *client, FSCmdBlock *block, const char *path, FSFreeSpaceSize *returnedFreeSize, FSRetFlag errHandling );
 +
|Get free space size in quota.
 +
| -1 -6 -10 -15 -17 -18
 +
|
 +
|-
 +
|}
    +
= Structures =
 +
== Threads ==
 
{| class="wikitable"
 
{| class="wikitable"
 
!Name
 
!Name
Line 426: Line 867:  
|}
 
|}
   −
===System Info===
+
== System Info ==
 
{| class="wikitable"
 
{| class="wikitable"
 
!Name
 
!Name
Line 438: Line 879:  
     /* 0x04 */ uint32_t coreClockSpeed;
 
     /* 0x04 */ uint32_t coreClockSpeed;
 
     /* 0x08 */ OSTime  timeBase;
 
     /* 0x08 */ OSTime  timeBase;
−
     /* 0x0C+*/ uint32_t unknown[5]; //Length is 8 words/32 bytes
+
     /* 0x0C */ uint32_t L2Size[3];
 +
    /* 0x18 */ uint32_t cpuRatio;
 
} OSSystemInfo;
 
} OSSystemInfo;
 
</syntaxhighlight>
 
</syntaxhighlight>
 
|}
 
|}
   −
===Filesystem===
+
== Filesystem ==
 
<syntaxhighlight lang="C">
 
<syntaxhighlight lang="C">
 
typedef struct {uint8_t buffer[FS_CLIENT_BUFFER_SIZE];} FSClient;
 
typedef struct {uint8_t buffer[FS_CLIENT_BUFFER_SIZE];} FSClient;
Line 468: Line 910:  
</syntaxhighlight>
 
</syntaxhighlight>
   −
== Defines ==
+
= Defines =
−
===Filesystem===
+
== Filesystem ==
 
<syntaxhighlight lang="C">
 
<syntaxhighlight lang="C">
 
#define FS_CLIENT_BUFFER_SIZE  (5888) /* 0x1700 */
 
#define FS_CLIENT_BUFFER_SIZE  (5888) /* 0x1700 */
Line 521: Line 963:  
</syntaxhighlight>
 
</syntaxhighlight>
   −
=== Disassembler ===
+
== Disassembler ==
 
printf_func() and find_symbol() have the following types:
 
printf_func() and find_symbol() have the following types:
 
<syntaxhighlight lang="C">
 
<syntaxhighlight lang="C">
Line 535: Line 977:  
</syntaxhighlight>
 
</syntaxhighlight>
   −
===OSSystem===
+
== System ==
 +
=== Time ===
 
<syntaxhighlight lang="C">
 
<syntaxhighlight lang="C">
 
#define OSTime int64_t /* stored in timebase upper/lower */
 
#define OSTime int64_t /* stored in timebase upper/lower */
 +
 +
typedef struct {
 +
    int sec;
 +
    int min;
 +
    int hour;
 +
    int mday;
 +
    int mon;
 +
    int year;
 +
    int wday;
 +
    int yday;
 +
    int msec;
 +
    int usec;
 +
} OSCalendarTime;
 
</syntaxhighlight>
 
</syntaxhighlight>
   −
=== Screen ===
+
=== ConsoleType ===
 +
{| class="wikitable"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 0x03000050
 +
| CAFE (Production/Test)
 +
|-
 +
| 0x11000021
 +
| NDEV 2.1
 +
|-
 +
| 0x11000022
 +
| Cortado (HW)
 +
|-
 +
| 0x11000023
 +
| Cortado (BW)
 +
|-
 +
| 0x11000024
 +
| Cortado (ESP-BW SCM)
 +
|-
 +
| 0x13000040
 +
| EV board (Evaluation)
 +
|-
 +
| 0x13000048
 +
| CAT-DEV (Development)
 +
|-
 +
| 0x13000050
 +
| CAFE (Development)
 +
|-
 +
| 0x23000050
 +
| OrchestraX
 +
|}
 +
 
 +
== Driver ==
 +
<syntaxhighlight lang="C">
 +
#define OSDRIVER_SIZE 0x4c
 +
 
 +
typedef struct OSDriver {
 +
 
 +
  char drv_name[0x40];  // 0x00 - 0x40
 +
  uint32_t unknown;      // 0x40 - 0x44
 +
  uint32_t *save_area;  // 0x44 - 0x48
 +
  struct OSDriver *next; // 0x48 - 0x4c
 +
 
 +
} OSDriver;
 +
</syntaxhighlight>
 +
 
 +
== Screen ==
 
{| class="wikitable"
 
{| class="wikitable"
 
!Name
 
!Name
Line 554: Line 1,058:  
|The buffer number for the first Gamepad
 
|The buffer number for the first Gamepad
 
|}
 
|}
 +
 +
== MCP ==
 +
<syntaxhighlight lang="C">
 +
typedef enum MCPInstallTarget {
 +
  MCP_INSTALL_TARGET_MLC  = 0,
 +
  MCP_INSTALL_TARGET_USB  = 1,
 +
} MCPInstallTarget;
 +
 +
typedef struct MCPInstallProgress {
 +
  uint32_t inProgress;
 +
  uint64_t tid;
 +
  uint64_t sizeTotal;
 +
  uint64_t sizeProgress;
 +
  uint32_t contentsTotal;
 +
  uint32_t contentsProgress;
 +
} MCPInstallProgress;
 +
 +
typedef struct MCPInstallInfo {
 +
  char unknown[0x27F];
 +
} MCPInstallInfo;
 +
 +
typedef struct MCPDevice {
 +
  char name[0x31B];
 +
} MCPDevice;
 +
 +
typedef struct MCPDeviceList {
 +
  MCPDevice devices[32];
 +
} MCPDeviceList;
 +
</syntaxhighlight>
Retrieved from "https://wiiubrew.org/wiki/Special:MobileDiff/1819...3679"