https://www.3dbrew.org/w/api.php?action=feedcontributions&feedformat=atom&user=GasInfinity
3dbrew - User contributions [en]
2026-04-10T07:54:28Z
User contributions
MediaWiki 1.43.1
https://www.3dbrew.org/w/index.php?title=Kernel_ABI&diff=23691
Kernel ABI
2025-08-29T18:08:43Z
<p>GasInfinity: typo</p>
<hr />
<div>= Calling Convention =<br />
Seems to be [https://github.com/ARM-software/abi-aa/blob/main/aapcs32/aapcs32.rst#the-base-procedure-call-standard AAPCS]-based (with modifications)<br />
<br />
== Overview ==<br />
<br />
=== Inputs ===<br />
* <code>r0–r3</code> : Argument / Scratch registers (caller-saved), inherited from AAPCS. ''If an input is to be placed on the stack, it will instead use the next free register starting from <code>r0</code>.''<br />
<br />
=== Outputs ===<br />
* <code>r0-r1</code> : Result, inherited from AAPCS. ''If multiple outputs are returned (e.g., <code>ControlMemory</code>), they are placed in consecutive registers starting from <code>r0</code>.''<br />
<br />
== Example ==<br />
<code>Result ControlMemory(uintptr_t* out, uintptr_t addr0, uintptr_t addr1, size_t size, MemoryOperation operation, MemoryPermission permissions)</code><br />
<br />
=== Inputs ===<br />
Following standard [https://github.com/ARM-software/abi-aa/blob/main/aapcs32/aapcs32.rst#the-base-procedure-call-standard AAPCS] register selection:<br />
; <code>r1</code> -> addr0<br />
; <code>r2</code> -> addr1<br />
; <code>r3</code> -> size<br />
<br />
As there are still more arguments, the next free registers are selected starting from <code>r0</code><br />
; <code>r0</code> -> operation<br />
; <code>r4</code> -> permissions<br />
<br />
=== Outputs ===<br />
; <code>r0</code> -> Result<br />
; <code>r1</code> -> uintptr_t out<br />
<br />
== System calls ==<br />
{| class="wikitable" border="1"<br />
|-<br />
! ID<br />
! Name<br />
! Inputs<br />
! Outputs<br />
|-<br />
| 0x01<br />
| ControlMemory<br />
|<br />
<code>r0</code>: <code>[[Memory Management#enum_MemoryOperation|MemoryOperation]] operation</code><br><br />
<code>r1</code>: <code>u32/void* addr0</code><br><br />
<code>r2</code>: <code>u32/void* addr1</code><br><br />
<code>r3</code>: <code>u32 size</code><br><br />
<code>r4</code>: <code>[[Memory Management#enum_MemoryPermission|MemoryPermission]] permissions</code><br />
|<br />
<code>r0</code>: <code>Result</code><br><br />
<code>r1</code>: <code>u32/void* addr_out</code><br />
|-<br />
| 0x02<br />
| QueryMemory<br />
|<br />
<code>r2</code>?: <code>u32/void* addr</code><br />
|<br />
<code>r0</code>: <code>Result</code><br><br />
<code>r1</code>: <code>u32 base_process_virtual_address</code><br><br />
<code>r2</code>: <code>u32 size</code><br><br />
<code>r3</code>: <code>[[Memory Management#enum_MemoryPermission|MemoryPermission]] permission</code><br><br />
<code>r4</code>: <code>[[Memory_Management#enum_MemoryState|MemoryState]] state</code><br><br />
<code>r5</code>: <code>[[Memory_Management#enum_PageFlags|PageFlags]] page_flags</code><br />
|-<br />
| 0x03<br />
| ExitProcess<br />
| None<br />
| None, doesn't return<br />
|-<br />
| 0x04<br />
| GetProcessAffinityMask<br />
|<br />
<code>r0</code>: <code>[out] u8* affinitymask</code><br><br />
<code>r1</code>: <code>Handle<[[KProcess]]> process</code><br><br />
<code>r2</code>: <code>s32 processorcount</code><br />
|<br />
<code>r0</code>: <code>Result</code><br />
|-<br />
| 0x05<br />
| SetProcessAffinityMask<br />
|<br />
<code>r0</code>: <code>Handle<[[KProcess]]> process</code><br><br />
<code>r1</code>: <code>[in] const u8* affinitymask</code><br><br />
<code>r2</code>: <code>s32 processorcount</code><br />
|<br />
<code>r0</code>: <code>Result</code><br />
|-<br />
| 0x06<br />
| GetProcessIdealProcessor<br />
|<br />
<code>r1</code>?: <code>Handle<[[KProcess]]> process</code><br />
|<br />
<code>r0</code>: <code>Result</code><br><br />
<code>r1</code>: <code>s32 processorid</code><br><br />
<code>r2</code>: Clobbered?<br />
|-<br />
| 0x07<br />
| SetProcessIdealProcessor<br />
|<br />
<code>r0</code>: <code>Handle<[[KProcess]]> process</code><br><br />
<code>r1</code>: <code>s32 processorid</code><br />
|<br />
<code>r0</code>: <code>Result</code><br><br />
|-<br />
| 0x08<br />
| CreateThread<br />
|<br />
<code>r0</code>: <code>s32 thread_priority</code><br><br />
<code>r1</code>: <code>ThreadFunc entrypoint</code><br><br />
<code>r2</code>: <code>u32 arg</code><br><br />
<code>r3</code>: <code>u32/void* stack_top</code><br><br />
<code>r4</code>: <code>s32 processor_id</code><br />
|<br />
<code>r0</code>: <code>Result</code><br><br />
<code>r1</code>: <code>Handle<[[KThread]]> thread_handle</code><br />
|-<br />
| 0x09<br />
| ExitThread<br />
| None<br />
| None, doesn't return<br />
|-<br />
| 0x0A<br />
| SleepThread<br />
|<br />
<code>r0-r1</code>: <code>s64 nanoseconds</code><br />
| None<br />
|-<br />
| 0x0B<br />
| GetThreadPriority<br />
|<br />
<code>r0</code>: Ignored?<br><br />
<code>r1</code>: <code>Handle thread_handle</code><br />
|<br />
<code>r0</code>: <code>Result</code><br><br />
<code>r1</code>: <code>s32 thread_priority</code><br><br />
<code>r2</code>: Clobbered?<br />
|-<br />
| 0x0C<br />
| SetThreadPriority<br />
|<br />
<code>r0</code>: <code>Handle<[[KThread]]> thread_handle</code><br><br />
<code>r1</code>: <code>s32 thread_priority</code><br />
|<br />
<code>r0</code>: <code>Result</code><br />
|-<br />
| 0x0D<br />
| GetThreadAffinityMask<br />
|<br />
<code>r0</code>: <code>[out] u8* affinitymask</code><br><br />
<code>r1</code>: <code>Handle<[[KThread]]> thread_handle</code><br><br />
<code>r2</code>: <code>s32 processorcount</code><br />
|<br />
<code>r0</code>: <code>Result</code><br />
|-<br />
| 0x0E<br />
| SetThreadAffinityMask<br />
|<br />
<code>r0</code>: <code>Handle<[[KThread]]> thread_handle</code><br><br />
<code>r1</code>: <code>[in] const u8* affinitymask</code><br><br />
<code>r2</code>: <code>s32 processorcount</code><br />
|<br />
<code>r0</code>: <code>Result</code><br />
|-<br />
| 0x0F<br />
| GetThreadIdealProcessor<br />
|<br />
<code>r0</code>: Ignored?<br><br />
<code>r1</code>: <code>Handle<[[KThread]]> thread_handle</code><br />
|<br />
<code>r0</code>: <code>Result</code><br><br />
<code>r1</code>: <code>s32 processorid</code><br />
|-<br />
| 0x10<br />
| SetThreadIdealProcessor<br />
|<br />
<code>r0</code>: <code>Handle<[[KThread]]> thread_handle</code><br><br />
<code>r1</code>: <code>s32 processorid</code><br />
|<br />
<code>r0</code>: <code>Result</code><br />
|-<br />
| 0x11<br />
| GetProcessorID<br />
|<br />
None<br />
|<br />
<code>r0</code>: <code>s32 processorid</code><br />
|-<br />
| 0x24<br />
| WaitSynchronization1<br />
|<br />
<code>r0</code>: <code>Handle<[[KSynchronizationObject]]> handle</code><br><br />
<code>r2-r3</code>: <code>s64 timeout</code><br />
|<br />
<code>r0</code>: <code>Result</code><br />
|-<br />
| 0x1B<br />
| SetTimer<br />
| Timer handle, initial_low, interval_low, initial_high, interval_high<br />
| Result<br />
|-<br />
| 0x28<br />
| GetSystemTick<br />
| None<br />
|<br />
<code>r0</code>: <code>Low 32 bits of the tick count</code><br />
<br><code>r1</code>: <code>High 32 bits of the tick count</code><br />
|-<br />
| 0x2D<br />
| ConnectToPort<br />
| ??<br><code>r1</code>: <code>pointer to port name</code><br />
| <code>r0</code>: <code>Result</code><br><code>r1</code>: <code>handle to [[KClientSession]]</code><br />
|-<br />
| 0x32<br />
| SendSyncRequest<br />
| <code>r0</code>: <code>handle to [[KClientSession]]</code><br />
| <code>r0</code>: <code>Result<code><br />
|}</div>
GasInfinity
https://www.3dbrew.org/w/index.php?title=Kernel_ABI&diff=23690
Kernel ABI
2025-08-29T18:01:54Z
<p>GasInfinity: document the calling convention of literally all syscalls</p>
<hr />
<div>= Calling Convention =<br />
Seems to be [https://github.com/ARM-software/abi-aa/blob/main/aapcs32/aapcs32.rst#the-base-procedure-call-standard AAPCS]-based (with modifications)<br />
<br />
== Overview ==<br />
<br />
=== Inputs ===<br />
* <code>r0–r3</code> : Argument / Scratch registers (caller-saved), inherited from AAPCS. ''If an input is to be placed on the stack, it will instead use the next free register starting from <code>r0</code>.''<br />
<br />
=== Outputs ===<br />
* <code>r0-r1</code> : Result, inherited from AAPCS. ''If multiple outputs are returned (e.g., <code>ControlMemory</code>), they are placed in consecutive registers starting from <code>r0</code>.''<br />
<br />
== Example ==<br />
<code>Result ControlMemory(uintptr_t* out, uintptr_t addr0, uintptr_t addr1, size_t size, MemoryOperation operation, MemoryPermission permissions)</code><br />
<br />
=== Inputs ===<br />
Following standard [https://github.com/ARM-software/abi-aa/blob/main/aapcs32/aapcs32.rst#the-base-procedure-call-standard AAPCS] register selection:<br />
; <code>r1</code> -> addr0<br />
; <code>r2</code> -> addr1<br />
; <code>r3</code> -> size<br />
<br />
As there are still have more arguments, the next free registers are selected starting from <code>r0</code><br />
; <code>r0</code> -> operation<br />
; <code>r4</code> -> permissions<br />
<br />
=== Outputs ===<br />
; <code>r0</code> -> Result<br />
; <code>r1</code> -> uintptr_t out<br />
<br />
== System calls ==<br />
{| class="wikitable" border="1"<br />
|-<br />
! ID<br />
! Name<br />
! Inputs<br />
! Outputs<br />
|-<br />
| 0x01<br />
| ControlMemory<br />
|<br />
<code>r0</code>: <code>[[Memory Management#enum_MemoryOperation|MemoryOperation]] operation</code><br><br />
<code>r1</code>: <code>u32/void* addr0</code><br><br />
<code>r2</code>: <code>u32/void* addr1</code><br><br />
<code>r3</code>: <code>u32 size</code><br><br />
<code>r4</code>: <code>[[Memory Management#enum_MemoryPermission|MemoryPermission]] permissions</code><br />
|<br />
<code>r0</code>: <code>Result</code><br><br />
<code>r1</code>: <code>u32/void* addr_out</code><br />
|-<br />
| 0x02<br />
| QueryMemory<br />
|<br />
<code>r2</code>?: <code>u32/void* addr</code><br />
|<br />
<code>r0</code>: <code>Result</code><br><br />
<code>r1</code>: <code>u32 base_process_virtual_address</code><br><br />
<code>r2</code>: <code>u32 size</code><br><br />
<code>r3</code>: <code>[[Memory Management#enum_MemoryPermission|MemoryPermission]] permission</code><br><br />
<code>r4</code>: <code>[[Memory_Management#enum_MemoryState|MemoryState]] state</code><br><br />
<code>r5</code>: <code>[[Memory_Management#enum_PageFlags|PageFlags]] page_flags</code><br />
|-<br />
| 0x03<br />
| ExitProcess<br />
| None<br />
| None, doesn't return<br />
|-<br />
| 0x04<br />
| GetProcessAffinityMask<br />
|<br />
<code>r0</code>: <code>[out] u8* affinitymask</code><br><br />
<code>r1</code>: <code>Handle<[[KProcess]]> process</code><br><br />
<code>r2</code>: <code>s32 processorcount</code><br />
|<br />
<code>r0</code>: <code>Result</code><br />
|-<br />
| 0x05<br />
| SetProcessAffinityMask<br />
|<br />
<code>r0</code>: <code>Handle<[[KProcess]]> process</code><br><br />
<code>r1</code>: <code>[in] const u8* affinitymask</code><br><br />
<code>r2</code>: <code>s32 processorcount</code><br />
|<br />
<code>r0</code>: <code>Result</code><br />
|-<br />
| 0x06<br />
| GetProcessIdealProcessor<br />
|<br />
<code>r1</code>?: <code>Handle<[[KProcess]]> process</code><br />
|<br />
<code>r0</code>: <code>Result</code><br><br />
<code>r1</code>: <code>s32 processorid</code><br><br />
<code>r2</code>: Clobbered?<br />
|-<br />
| 0x07<br />
| SetProcessIdealProcessor<br />
|<br />
<code>r0</code>: <code>Handle<[[KProcess]]> process</code><br><br />
<code>r1</code>: <code>s32 processorid</code><br />
|<br />
<code>r0</code>: <code>Result</code><br><br />
|-<br />
| 0x08<br />
| CreateThread<br />
|<br />
<code>r0</code>: <code>s32 thread_priority</code><br><br />
<code>r1</code>: <code>ThreadFunc entrypoint</code><br><br />
<code>r2</code>: <code>u32 arg</code><br><br />
<code>r3</code>: <code>u32/void* stack_top</code><br><br />
<code>r4</code>: <code>s32 processor_id</code><br />
|<br />
<code>r0</code>: <code>Result</code><br><br />
<code>r1</code>: <code>Handle<[[KThread]]> thread_handle</code><br />
|-<br />
| 0x09<br />
| ExitThread<br />
| None<br />
| None, doesn't return<br />
|-<br />
| 0x0A<br />
| SleepThread<br />
|<br />
<code>r0-r1</code>: <code>s64 nanoseconds</code><br />
| None<br />
|-<br />
| 0x0B<br />
| GetThreadPriority<br />
|<br />
<code>r0</code>: Ignored?<br><br />
<code>r1</code>: <code>Handle thread_handle</code><br />
|<br />
<code>r0</code>: <code>Result</code><br><br />
<code>r1</code>: <code>s32 thread_priority</code><br><br />
<code>r2</code>: Clobbered?<br />
|-<br />
| 0x0C<br />
| SetThreadPriority<br />
|<br />
<code>r0</code>: <code>Handle<[[KThread]]> thread_handle</code><br><br />
<code>r1</code>: <code>s32 thread_priority</code><br />
|<br />
<code>r0</code>: <code>Result</code><br />
|-<br />
| 0x0D<br />
| GetThreadAffinityMask<br />
|<br />
<code>r0</code>: <code>[out] u8* affinitymask</code><br><br />
<code>r1</code>: <code>Handle<[[KThread]]> thread_handle</code><br><br />
<code>r2</code>: <code>s32 processorcount</code><br />
|<br />
<code>r0</code>: <code>Result</code><br />
|-<br />
| 0x0E<br />
| SetThreadAffinityMask<br />
|<br />
<code>r0</code>: <code>Handle<[[KThread]]> thread_handle</code><br><br />
<code>r1</code>: <code>[in] const u8* affinitymask</code><br><br />
<code>r2</code>: <code>s32 processorcount</code><br />
|<br />
<code>r0</code>: <code>Result</code><br />
|-<br />
| 0x0F<br />
| GetThreadIdealProcessor<br />
|<br />
<code>r0</code>: Ignored?<br><br />
<code>r1</code>: <code>Handle<[[KThread]]> thread_handle</code><br />
|<br />
<code>r0</code>: <code>Result</code><br><br />
<code>r1</code>: <code>s32 processorid</code><br />
|-<br />
| 0x10<br />
| SetThreadIdealProcessor<br />
|<br />
<code>r0</code>: <code>Handle<[[KThread]]> thread_handle</code><br><br />
<code>r1</code>: <code>s32 processorid</code><br />
|<br />
<code>r0</code>: <code>Result</code><br />
|-<br />
| 0x11<br />
| GetProcessorID<br />
|<br />
None<br />
|<br />
<code>r0</code>: <code>s32 processorid</code><br />
|-<br />
| 0x24<br />
| WaitSynchronization1<br />
|<br />
<code>r0</code>: <code>Handle<[[KSynchronizationObject]]> handle</code><br><br />
<code>r2-r3</code>: <code>s64 timeout</code><br />
|<br />
<code>r0</code>: <code>Result</code><br />
|-<br />
| 0x1B<br />
| SetTimer<br />
| Timer handle, initial_low, interval_low, initial_high, interval_high<br />
| Result<br />
|-<br />
| 0x28<br />
| GetSystemTick<br />
| None<br />
|<br />
<code>r0</code>: <code>Low 32 bits of the tick count</code><br />
<br><code>r1</code>: <code>High 32 bits of the tick count</code><br />
|-<br />
| 0x2D<br />
| ConnectToPort<br />
| ??<br><code>r1</code>: <code>pointer to port name</code><br />
| <code>r0</code>: <code>Result</code><br><code>r1</code>: <code>handle to [[KClientSession]]</code><br />
|-<br />
| 0x32<br />
| SendSyncRequest<br />
| <code>r0</code>: <code>handle to [[KClientSession]]</code><br />
| <code>r0</code>: <code>Result<code><br />
|}</div>
GasInfinity