Changes

Jump to navigation Jump to search
281 bytes removed ,  23:20, 30 May 2020
Lots of misinfo in there →‎GetProcessInfo
Line 510: Line 510:  
| style="background: red" | No
 
| style="background: red" | No
 
| style="background: red" | No
 
| style="background: red" | No
| Result [[IPC|ReplyAndReceive]](s32* index, Handle* handles, s32 handleCount, Handle replyTarget)
+
| Result [[IPC#svcReplyAndReceive|ReplyAndReceive]](s32* index, Handle* handles, s32 handleCount, Handle replyTarget)
 
|
 
|
 
|-
 
|-
Line 1,311: Line 1,311:  
| Yes
 
| Yes
 
| Yes
 
| Yes
| Used by kernelpanic. This makes core0 enter a WFI/B infinite loop. Threads that were created on core1 or core2 have their priority set to 0x3F, except if the thread was created on core1 and whose parent process (if any) has the "Runnable on sleep" [[NCCH/Extended_Header#ARM11_Kernel_Flags|ARM11 kernel flag]] set. Core1 threads with a priority of 0x40 without a parent process have their priority set to 0x3E.
+
| Power state change. Takes one u32 parameter.
   −
Prior to first invoking this handler, the global variable holding <code>UNITINFO != 0</code> is true, and if there is no [[LCD_Registers#Fill_Color|LCD fill]] set at the time kernelpanic is called, kernelpanic fills the top screen with red and the bottom screen with either yellow (if the current process was running under the APPLICATION memregion) or red.  
+
0: shutdown/reboot. hangs the Arm11. Used by kernelpanic and PTM. This makes all cores enter a WFI/B infinite loop.  
 
  −
Before invoking this handler a second time, kernelpanic wait for the user to hold L+R+Start+Select down.
   
|-
 
|-
 
| 6
 
| 6
Line 1,321: Line 1,319:  
| No
 
| No
 
| Arguments: <code>u32 what, u64 val</code>
 
| Arguments: <code>u32 what, u64 val</code>
UNITINFO needs to be non-zero.  
+
UNITINFO needs to be non-zero for <code>what</code> 1 and 2.  
    
If <code>what</code> is 0 or any invalid value, nothing is done.  
 
If <code>what</code> is 0 or any invalid value, nothing is done.  
   −
If it is 1, <code>val != 0</code> is written to the global variable enabling ERR:F-format register dumps on user-mode CPU/VFP exceptions (the VFP exception handler acts as if this variable was always true and works on retail environments). The user handler, stack pointer to use for exception handling, and pointer to use for the exception info structure are contiguously located in either the thread's TLS, or if the handler is NULL, in the main thread's TLS, at offset 0x40. If the specified stack pointer is 1, sp_usr - 0x5c is used instead; if the specified exception info buffer is 1, sp_usr - 0x5c is used instead, and if it is 0, <specified stack> - 0x5c is used (0x5c is the size of the exception info structure that is being pushed). Configured by NS on startup on dev-units (default being 0 on non-debugger/jtag units).
+
If it is 1, <code>val != 0</code> is written to the global variable enabling ERR:F-format register dumps on user-mode CPU/VFP exceptions (the VFP exception handler acts as if this variable was always true and works on retail environments). The user handler, stack pointer to use for exception handling, and pointer to use for the exception info structure are contiguously located in either the thread's TLS, or if the handler is NULL, in the main thread's TLS, at offset 0x40. If the specified stack pointer is 1, sp_usr - 0x5c is used instead; if the specified exception info buffer is 1, sp_usr - 0x5c is used instead, and if it is 0, <specified stack> - 0x5c is used (0x5c is the size of the exception info structure that is being pushed). Configured by NS on startup on dev-units (default being 0 on non-debugger/jtag units) using the 0x000F0000 configuration block in the [[Config_Savegame|config savegame]].
   −
If 2, kernelpanic will be called when svcBreak is used by a non-attached process. Configured by NS on startup on dev-units (default being 0 on non-debugger/jtag units).
+
If 2, kernelpanic will be called when svcBreak is used by a non-attached process. Configured by NS on startup on dev-units (default being 0 on non-debugger/jtag units) using the 0x000F0000 configuration block in the [[Config_Savegame|config savegame]].
    
If 3, this changes the scheduling/preemption mode (when no threads are being preempted, otherwise returns error 0xC8A01414), see [[KResourceLimit]] for more details.
 
If 3, this changes the scheduling/preemption mode (when no threads are being preempted, otherwise returns error 0xC8A01414), see [[KResourceLimit]] for more details.
Line 1,340: Line 1,338:  
| Yes
 
| Yes
 
| No
 
| No
| Alternate FIRM launch code-path, with different [[PXI]] FIFO word constants. Usually not used. PTM-sysmodule can use this but it's unknown what exactly triggers that in PTM-sysmodule.
+
| Hangs the Arm9, using a code path similar to the one used on firmlaunch. Used by PTM on shutdown/reboot.
 
|-
 
|-
 
| 9
 
| 9
Line 1,409: Line 1,407:  
| 0
 
| 0
 
|  
 
|  
| Returns the amount of executable memory allocated to the process + thread context size + page-rounded size of the external handle table
+
| Returns the amount of private (code, data, regular heap) and shared memory used by the process + total supervisor-mode stack size + page-rounded size of the external handle table. This is the amount of physical memory the process is using, minus TLS, main thread stack and linear memory.
 
|-
 
|-
 
| 1
 
| 1
 
|  
 
|  
| Returns the amount of <unknown> memory allocated to the process + thread context size + page-rounded size of the external handle table
+
| Returns the amount of <related unused field> + total supervisor-mode stack size + page-rounded size of the external handle table
 
|-
 
|-
 
| 2
 
| 2
 
|  
 
|  
| Returns the amount of DMA-able (code, data, IO pages, etc.) memory allocated to the process + thread context size + page-rounded size of the external handle table
+
| Returns the amount of private (code, data, heap) memory used by the process + total supervisor-mode stack size + page-rounded size of the external handle table
 
|-
 
|-
 
| 3
 
| 3
 
|  
 
|  
| Returns the amount of <unknown> memory allocated to the process + thread context size + page-rounded size of the external handle table
+
| Returns the amount of <related unused field> + total supervisor-mode stack size + page-rounded size of the external handle table
 
|-
 
|-
 
| 4
 
| 4
 
|  
 
|  
| Returns the amount handles in use by the process.
+
| Returns the amount of handles in use by the process.
 
|-
 
|-
 
| 5
 
| 5
Line 1,437: Line 1,435:  
| 7
 
| 7
 
|  
 
|  
| Returns 0
+
| Returns the number of threads of the process
 
|-
 
|-
 
| 8
 
| 8
Line 1,449: Line 1,447:  
| 19
 
| 19
 
| Stub: [[8.0.0-18]]. Implementation: [[11.3.0-36|11.3.0-X]].
 
| Stub: [[8.0.0-18]]. Implementation: [[11.3.0-36|11.3.0-X]].
| Originally this only returned 0xD8E007ED. Now with v11.3 this returns the memregion for the process: out low u32 = [[KProcess]] "Kernel flags from the exheader kernel descriptors" & 0xF00. High out u32 = 0.
+
| Originally this only returned 0xD8E007ED. Now with v11.3 this returns the memregion for the process: out low u32 = [[KProcess]] "Kernel flags from the exheader kernel descriptors" & 0xF00 (memory region flag). High out u32 = 0.
 
|-
 
|-
 
| 20
 
| 20
Line 1,457: Line 1,455:  
| 21
 
| 21
 
| [[8.0.0-18]]. N3DS only.
 
| [[8.0.0-18]]. N3DS only.
| Returns the maximum amount of VRAM memory allocatable by the process: 0x800000 bytes if the process has already allocated VRAM memory, otherwise 0 (+ error 0xE0E01BF4)
+
| Returns the VA -> PA conversion offset for the QTM static mem block reserved in the exheader (0x800000), otherwise 0 (+ error 0xE0E01BF4) if it doesn't exist
 
|-
 
|-
 
| 22
 
| 22
 
| [[8.0.0-18]]. N3DS only.
 
| [[8.0.0-18]]. N3DS only.
| Returns the address of the first chunk of VRAM allocated by this process
+
| Returns the base VA of the QTM static mem block reserved in the exheader, otherwise 0 (+ error 0xE0E01BF4) if it doesn't exist
 
|-
 
|-
 
| 23
 
| 23
 
| [[8.0.0-18]]. N3DS only.
 
| [[8.0.0-18]]. N3DS only.
| Returns the amount of VRAM allocated by this process (?)
+
| Returns the size of the QTM static mem block reserved in the exheader, otherwise 0 (+ error 0xE0E01BF4) if it doesn't exist
 
|}
 
|}
   Line 1,478: Line 1,476:  
|-
 
|-
 
| 1
 
| 1
| Get internal refcount for kernel object (not counting the one this SVC adds internally to operate), and also a boolean if it is negative.
+
| Get internal refcount for kernel object (not counting the one this SVC adds internally to operate), sign-extended to 64 bits.
 
|-
 
|-
 
| 2
 
| 2
516

edits

Navigation menu