1,359
edits
Changes
Jump to navigation
Jump to search
Line 3:
Line 3: − + − + − + − + − * If new state is 7, it sets 0x30 in process flags, and signals the ProcessEventWaiter handle. − + − + Line 24:
Line 23: − + Line 69:
Line 68: − + Line 75:
Line 74: − + − + − + Line 95:
Line 94: − + − After that, it sets process state to 2.+ − + − Same as [[Process_Manager_services#GetProcessTitleIdByPid|GetProcessTitleIdByPid]] but for debug processes.+ + + − + + + − + − + − Same as [[Process_Manager_services#GetCrashingProcessPid|GetCrashingProcessPid]] but for debug processes.+ Line 120:
Line 123: − + − + Line 147:
Line 150: − + Line 179:
Line 182: − +
Process Manager services (view source)
Revision as of 01:24, 18 November 2017
, 01:24, 18 November 2017no edit summary
== 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.
[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.
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.
! Cmd || Name
! Cmd || Name
|-
|-
| 0 || [[#GetDebugMode]]
| 0 || [[#IsDebugMode]]
|-
|-
| 1 || [[#GetDebugProcesses]]
| 1 || [[#GetDebugProcesses]]
| 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.
== 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.
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.
== 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 ==
Returns the pid of the debugged process.
== EnableDebug ==
== EnableDebug ==
! 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.
| 7 || [[#NotifyBootFinished]]
| 7 || [[#NotifyBootFinished]]
|-
|-
| 8 || [[#GetCrashingProcessPid]]
| 8 || [[#GetApplicationPid]]
|}
|}
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]]