Nintendo Switch Brew

Changes

Process Manager services (view source)

Revision as of 02:24, 18 November 2017

126 bytes removed ,  02:24, 18 November 2017
no edit summary
Line 3: Line 3:     
== State changes ==
 
== State changes ==
−
When the kernel signals a process handle, it uses svcResetSignal on the process handle and then it uses svcGetProcessInfo to read out the ProcessState.
+
When the kernel signals a process handle, it uses svcResetSignal on the process handle and then it uses svcGetProcessInfo to read out the ProcessEvent.
   −
If the process moved state non-3 -> 3 it clears 4 in process flags.
+
If the process moved from non-3 -> 3 it clears 4 in process flags.
    
If process flags has mask 8 set:
 
If process flags has mask 8 set:
−
* If new state is 2, it clears 0x20 and sets 0x10 in process flags, and signals the ProcessEventWaiter handle.
+
* If event is ProcessEvent_Running or ProcessEvent_DebugDetached, it clears 0x20 and sets 0x10 in process flags, and signals the ProcessEventWaiter handle.
−
* If new state is 4, it clears 0x20 and sets 0x10 in process flags, and signals the ProcessEventWaiter handle.
+
* If event is ProcessEvent_DebugSuspended, it sets 0x30 in process flags, and signals the ProcessEventWaiter handle.
−
* If new state is 7, it sets 0x30 in process flags, and signals the ProcessEventWaiter handle.
     −
[2.0.0+] If new state is 2, and process flags has 0x80 set, it sets mask 0x100 and signals the ProcessEventWaiter handle.
+
[2.0.0+] If new state is ProcessEvent_DebugDetached, and process flags has 0x80 set, it sets mask 0x100 and signals the ProcessEventWaiter handle.
    
If process flags has mask 1 set:
 
If process flags has mask 1 set:
−
* If new state is 6, it signals the ProcessEventWaiter handle.
+
* If new state is ProcessEvent_Exited, it signals the ProcessEventWaiter handle.
    
If mask 1 is not set, it immediately does what is otherwise done by the [[#FinalizeDeadProcess]] command.
 
If mask 1 is not set, it immediately does what is otherwise done by the [[#FinalizeDeadProcess]] command.
Line 24: Line 23:  
It uses [[Loader_services|ldr:pm]] GetProgramInfo with the supplied title-id.
 
It uses [[Loader_services|ldr:pm]] GetProgramInfo with the supplied title-id.
   −
If ((*(u8*) (info_output+2)) & 3) is == 1, it goes through the process list and errors if any has bit 0x40 set. Thus only one process can have bit 0x40 set at a time.
+
If ((*(u8*) (info_output+2)) & 3) is == 1, it goes through the process list and errors if any has bit 0x40 set. Thus you can only run one application at a time.
    
Resource limits for the process is selected by ApplicationType which is ((*(u8*) (info_output+2)) & 3) being 0, 1, or 2. Value 3 is not used. 0 = sysmodule(sysmodules don't have the ApplicationType kernel [[NPDM|descriptor]]), 1 = application, 2 = applet.
 
Resource limits for the process is selected by ApplicationType which is ((*(u8*) (info_output+2)) & 3) being 0, 1, or 2. Value 3 is not used. 0 = sysmodule(sysmodules don't have the ApplicationType kernel [[NPDM|descriptor]]), 1 = application, 2 = applet.
Line 69: Line 68:  
! Cmd || Name
 
! Cmd || Name
 
|-
 
|-
−
| 0 || [[#GetDebugMode]]
+
| 0 || [[#IsDebugMode]]
 
|-
 
|-
 
| 1 || [[#GetDebugProcesses]]
 
| 1 || [[#GetDebugProcesses]]
Line 75: Line 74:  
| 2 || [[#StartDebugProcess]]
 
| 2 || [[#StartDebugProcess]]
 
|-
 
|-
−
| 3 || [[#GetDebugProcessTitleIdByPid]]
+
| 3 || [[#GetDebuggedTitleId]]
 
|-
 
|-
 
| 4 || [[#EnableDebugForTitleId]]
 
| 4 || [[#EnableDebugForTitleId]]
 
|-
 
|-
−
| 5 || [[#GetCrashingDebugProcessPid]]
+
| 5 || [[#GetDebuggedPid]]
 
|-
 
|-
 
| 6 || [[#EnableDebug]]
 
| 6 || [[#EnableDebug]]
 
|}
 
|}
   −
== GetDebugMode ==
+
== IsDebugMode ==
 
Always returns u32 0 on retail.
 
Always returns u32 0 on retail.
   Line 95: Line 94:     
== StartDebugProcess ==
 
== StartDebugProcess ==
−
Takes a pid. Process state must be 0 or 1. Then it uses svcStartProcess(process_handle, u8, u8, u32) with args coming from ldr:pm GetProgramInfo.
+
Takes a pid. Last process event must be ProcessEvent_Created or ProcessEvent_DebugAttached.
   −
After that, it sets process state to 2.
+
Then it uses svcStartProcess(process_handle, u8, u8, u32) with args coming from ldr:pm GetProgramInfo.
   −
== GetDebugProcessTitleIdByPid ==
+
After that, it sets last process state to ProcessEvent_DebugDetached.
−
Same as [[Process_Manager_services#GetProcessTitleIdByPid|GetProcessTitleIdByPid]] but for debug processes.
+
 
 +
== GetDebuggedTitleId ==
 +
Takes a pid and returns the title-id.
    
== EnableDebugForTitleId ==
 
== EnableDebugForTitleId ==
−
Takes a title-id of the program to debug. Sets this to a global field. Next time it gets launched it will be handled differently.
+
Takes a title-id of the program to debug. Sets this to a global field.
 +
 
 +
Next time it gets launched it will be handled differently.
   −
Returns an event handle that is signaled when the requested title is launched.
+
Returns an event handle that is signaled when the requested title is about to be launched.
   −
== GetCrashingDebugProcessPid ==
+
== GetDebuggedPid ==
−
Same as [[Process_Manager_services#GetCrashingProcessPid|GetCrashingProcessPid]] but for debug processes.
+
Returns the pid of the debugged process.
    
== EnableDebug ==
 
== EnableDebug ==
Line 120: Line 123:  
! Cmd || Name
 
! Cmd || Name
 
|-
 
|-
−
| 0 || [[#GetProcessTitleIdByPid]]
+
| 0 || [[#GetTitleId]]
 
|}
 
|}
   −
== GetProcessTitleIdByPid ==
+
== GetTitleId ==
 
Takes a pid and returns the title-id associated with the process.
 
Takes a pid and returns the title-id associated with the process.
   Line 147: Line 150:  
| 7 || [[#NotifyBootFinished]]
 
| 7 || [[#NotifyBootFinished]]
 
|-
 
|-
−
| 8 || [[#GetCrashingProcessPid]]
+
| 8 || [[#GetApplicationPid]]
 
|}
 
|}
   Line 179: Line 182:  
Launches a process with hardcoded [[boot2]] title-id.
 
Launches a process with hardcoded [[boot2]] title-id.
   −
== GetCrashingProcessPid ==
+
== GetApplicationPid ==
 
Loops through the internal linked-list of processes, looks for mask 0x40 set in process flags. Returns pid of first such entry.
 
Loops through the internal linked-list of processes, looks for mask 0x40 set in process flags. Returns pid of first such entry.
    
[[Category:Services]]
 
[[Category:Services]]
Retrieved from "https://switchbrew.org/wiki/Special:MobileDiff/3026"