Loader services - Revision history

Hexkyz: /* GetProgramInfo */

2025-05-01T17:45:45Z

GetProgramInfo

← Older revision		Revision as of 21:45, 1 May 2025
Line 76:		Line 76:
	== GetProgramInfo ==		== GetProgramInfo ==
	Takes a type-0x1A output buffer containing a [[#ProgramInfo]] and a [[NCM_services#ProgramLocation\|ProgramLocation]]. No output.		Takes a type-0x1A output buffer containing a [[#ProgramInfo]] and a [[NCM_services#ProgramLocation\|ProgramLocation]]. No output.

			[20.0.0+] Now takes an additional input u16.

	== PinProgram ==		== PinProgram ==

Hexkyz at 22:12, 23 October 2024

2024-10-23T20:12:08Z

Show changes

Yellows8 at 03:57, 9 May 2023

2023-05-09T01:57:55Z

← Older revision		Revision as of 05:57, 9 May 2023
Line 1:		Line 1:
	= ldr:shel =		= ldr:shel =
	This is "nn::ldr::detail::IShellInterface".		This is "nn::ldr::detail::IShellInterface".

			This service has IPC max_sessions 3.

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
Line 24:		Line 26:
	= ldr:dmnt =		= ldr:dmnt =
	This is "nn::ldr::detail::IDebugMonitorInterface".		This is "nn::ldr::detail::IDebugMonitorInterface".

			This service has IPC max_sessions 2.

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
Line 41:		Line 45:
	= ldr:pm =		= ldr:pm =
	This is "nn::ldr::detail::IProcessManagerInterface".		This is "nn::ldr::detail::IProcessManagerInterface".

			This service has IPC max_sessions 1.

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"

Yellows8: /* SetProgramArgument */

2020-12-01T16:21:03Z

SetProgramArgument

← Older revision		Revision as of 19:21, 1 December 2020
Line 13:		Line 13:
	== SetProgramArgument ==		== SetProgramArgument ==
	Takes a type-0x9 input buffer with launch arguments (as string), an u32 (size of arguments string), and an input title-id.		Takes a type-0x9 input buffer with launch arguments (as string), an u32 (size of arguments string), and an input title-id.

			[11.0.0+] Now takes a type-0x5 buffer instead of type-0x9. Now takes a total of 8-bytes of input, instead of 0x10-bytes total.

	Loads a process for the specified title-id and passes along the supplied arguments.		Loads a process for the specified title-id and passes along the supplied arguments.

Hexkyz at 18:07, 14 April 2020

2020-04-14T16:07:05Z

← Older revision		Revision as of 20:07, 14 April 2020
Line 52:		Line 52:
	\| 3 \|\| [[#UnpinProgram]]		\| 3 \|\| [[#UnpinProgram]]
	\|-		\|-
	\| 4 \|\| [10.0.0+]		\| 4 \|\| [10.0.0+] [[#SetEnabledProgramVerification]]
	\|}		\|}

Line 63:		Line 63:
	== UnpinProgram ==		== UnpinProgram ==
	Takes a PinId from [[#PinProgram]].		Takes a PinId from [[#PinProgram]].

			== SetEnabledProgramVerification ==
			Seems to sets a global flag to inputval & 1.

			When the flag is zero, it will set ret=0 instead of ret={error} when verifying the fixed-key [[NPDM]] ACID signature fails. This also skips verifying the [[NCA_Format\|NCA Header]] signature using the ACID key. Note that if verifying the fixed-key ACID signature is successful, and verifying the ACID-key NCA header signature fails, it will throw an error and abort.

	= ModuleInfo =		= ModuleInfo =

Yellows8: /* ldr:pm */

2020-04-14T02:30:20Z

ldr:pm

← Older revision		Revision as of 06:30, 14 April 2020
Line 51:		Line 51:
	\|-		\|-
	\| 3 \|\| [[#UnpinProgram]]		\| 3 \|\| [[#UnpinProgram]]
			\|-
			\| 4 \|\| [10.0.0+]
	\|}		\|}

Hexkyz at 20:13, 22 February 2020

2020-02-22T19:13:41Z

← Older revision		Revision as of 22:13, 22 February 2020
Line 19:		Line 19:
	== FlushArguments ==		== FlushArguments ==
	Clears the loaded processes waiting queue.		Clears the loaded processes waiting queue.


	= ldr:dmnt =		= ldr:dmnt =
Line 36:		Line 35:

	== GetProcessModuleInfo ==		== GetProcessModuleInfo ==
	Takes in a u64 Process ID, and a C descriptor out array of [[#~~ModuleInfos~~]]. Returns the number of ModuleInfos copied to output.		Takes in a u64 Process ID, and a C descriptor out array of [[#ModuleInfo]]s. Returns the number of ModuleInfos copied to output.

	~~ModuleInfo~~ is ~~the same here as for ro~~:~~dmnt~~.		= ldr:pm =
			This is "nn::ldr::detail::IProcessManagerInterface".

	~~ModuleInfo has~~ the ~~following layout~~:		{\| class="wikitable" border="1"
			\|-
			! Cmd \|\| Name
			\|-
			\| 0 \|\| CreateProcess
			\|-
			\| 1 \|\| [[#GetProgramInfo]]
			\|-
			\| 2 \|\| [[#PinProgram]]
			\|-
			\| 3 \|\| [[#UnpinProgram]]
			\|}

			== GetProgramInfo ==
			Takes an ncm::ProgramLocation, parses the NPDM, and writes a [[#ProgramInfo]] to a C descriptor buffer.

			== PinProgram ==
			Takes an ncm::ProgramLocation, returns a u64 "PinId".

			== UnpinProgram ==
			Takes a PinId from [[#PinProgram]].

	=== ModuleInfo ===		= ModuleInfo =
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 51:		Line 71:
	\| 0x0		\| 0x0
	\| 0x20		\| 0x20
	\| ~~Build ID~~		\| ModuleId
	\|-		\|-
	\| 0x20		\| 0x20
	\| 0x8		\| 0x8
	\| ~~Mapped Address~~		\| ImageAddress
	\|-		\|-
	\| 0x28		\| 0x28
	\| 0x8		\| 0x8
	\| ~~Mapped Size~~		\| ImageSize
	\|-
	\|}		\|}

			= ProgramInfo =
	= ~~ldr:pm =~~
	~~This is "nn::ldr::detail::IProcessManagerInterface".~~

	~~{\| class="wikitable" border="1"~~
	\|-
	~~! Cmd \|\| Name~~
	\|-
	~~\| 0 \|\| CreateProcess~~
	\|-
	~~\| 1 \|\| [[#GetProgramInfo]]~~
	\|-
	~~\| 2 \|\| [[#PinProgram]]~~
	\|-
	~~\| 3 \|\| [[#UnpinProgram]]~~
	\|}

	~~== GetProgramInfo ==~~
	~~Takes an ncm::ProgramLocation, parses the NPDM, and writes a [[#~~ProgramInfo~~]] to a C descriptor buffer as follows:~~

	~~=== ProgramInfo ==~~=
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 146:		Line 145:
	\| ACI0 [[NPDM#FS Access Control\|FS Access Control]]		\| ACI0 [[NPDM#FS Access Control\|FS Access Control]]
	\|}		\|}

	~~== PinProgram ==~~
	~~Takes an ncm::ProgramLocation, returns a u64 "PinId".~~

	~~== UnpinProgram ==~~
	~~Takes a PinId from [[#PinProgram]].~~

	[[Category:Services]]		[[Category:Services]]

SciresM at 06:23, 28 October 2019

2019-10-28T05:23:16Z

← Older revision		Revision as of 08:23, 28 October 2019
Line 11:		Line 11:
	\|}		\|}

	== ~~AddProcessToLaunchQueue~~ ==		== SetProgramArgument ==
	Takes a type-0x9 input buffer with launch arguments (as string), an u32 (size of arguments string), and an input title-id.		Takes a type-0x9 input buffer with launch arguments (as string), an u32 (size of arguments string), and an input title-id.

Line 17:		Line 17:
	Loaded processes are kept in a queue waiting for PM to launch them. The maximum number of waiting processes in this list is 10.		Loaded processes are kept in a queue waiting for PM to launch them. The maximum number of waiting processes in this list is 10.

	== ~~ClearLaunchQueue~~ ==		== FlushArguments ==
	Clears the loaded processes waiting queue.		Clears the loaded processes waiting queue.

Line 35:		Line 35:
	\|}		\|}

	== GetProcessModuleInfo==		== GetProcessModuleInfo ==
	Takes in a u64 Process ID, and a C descriptor out array of [[#ModuleInfos]]. Returns the number of ModuleInfos copied to output.		Takes in a u64 Process ID, and a C descriptor out array of [[#ModuleInfos]]. Returns the number of ModuleInfos copied to output.

SciresM at 06:20, 28 October 2019

2019-10-28T05:20:31Z

← Older revision		Revision as of 08:20, 28 October 2019
Line 1:		Line 1:
			= ldr:shel =
			This is "nn::ldr::detail::IShellInterface".

			{\| class="wikitable" border="1"
			\|-
			! Cmd \|\| Name
			\|-
			\| 0 \|\| [[#SetProgramArgument]]
			\|-
			\| 1 \|\| [[#FlushArguments]]
			\|}

			== AddProcessToLaunchQueue ==
			Takes a type-0x9 input buffer with launch arguments (as string), an u32 (size of arguments string), and an input title-id.

			Loads a process for the specified title-id and passes along the supplied arguments.
			Loaded processes are kept in a queue waiting for PM to launch them. The maximum number of waiting processes in this list is 10.

			== ClearLaunchQueue ==
			Clears the loaded processes waiting queue.


	= ldr:dmnt =		= ldr:dmnt =
	This is "nn::ldr::detail::IDebugMonitorInterface".		This is "nn::ldr::detail::IDebugMonitorInterface".
Line 6:		Line 28:
	! Cmd \|\| Name		! Cmd \|\| Name
	\|-		\|-
	\| 0 \|\| [[~~Loader_services~~#~~AddProcessToDebugLaunchQueue\|AddProcessToDebugLaunchQueue~~]]		\| 0 \|\| [[#SetProgramArgument]]
	\|-		\|-
	\| 1 \|\| [[~~Loader_services~~#~~ClearDebugLaunchQueue\|ClearDebugLaunchQueue~~]]		\| 1 \|\| [[#FlushArguments]]
	\|-		\|-
	\| 2 \|\| [[~~Loader_services~~#~~GetNsoInfos\|GetNsoInfos~~]]		\| 2 \|\| [[#GetProcessModuleInfo]]
	\|}		\|}

	== ~~AddProcessToDebugLaunchQueue~~ ==		== GetProcessModuleInfo==
	~~Same as~~ [[~~Loader_services~~#~~AddProcessToLaunchQueue\|AddProcessToLaunchQueue~~]] ~~but for processes marked as debug~~.		Takes in a u64 Process ID, and a C descriptor out array of [[#ModuleInfos]]. Returns the number of ModuleInfos copied to output.

	~~== ClearDebugLaunchQueue ==~~
	~~Same as [[Loader_services#ClearLaunchQueue\|ClearLaunchQueue]]~~.

	~~== GetNsoInfos ==~~		ModuleInfo is the same here as for ro:dmnt.
	~~Takes in a u64 ProcessID, and a C descriptor. Returns~~ the ~~number of NsoInfos copied to output~~.

	~~NsoInfo~~ has the following layout:		ModuleInfo has the following layout:

			=== ModuleInfo ===
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 32:		Line 51:
	\| 0x0		\| 0x0
	\| 0x20		\| 0x20
	\| "Build ID~~", from NSO header+0x40.~~		\| Build ID
	\|-		\|-
	\| 0x20		\| 0x20
	\| 0x8		\| 0x8
	\| Mapped ~~address for this NSO~~		\| Mapped Address
	\|-		\|-
	\| 0x28		\| 0x28
	\| 0x8		\| 0x8
	\| Mapped ~~size for this NSO~~		\| Mapped Size
	\|-		\|-
	\|}		\|}
Line 56:		Line 75:
	\| 1 \|\| [[#GetProgramInfo]]		\| 1 \|\| [[#GetProgramInfo]]
	\|-		\|-
	\| 2 \|\| [[#~~RegisterTitle~~]]		\| 2 \|\| [[#PinProgram]]
	\|-		\|-
	\| 3 \|\| [[#~~UnregisterTitle~~]]		\| 3 \|\| [[#UnpinProgram]]
	\|}		\|}

	== GetProgramInfo ==		== GetProgramInfo ==
	Takes ~~a TitleId + StorageId~~, parses the NPDM, and writes ~~output~~ to a C descriptor buffer as follows:		Takes an ncm::ProgramLocation, parses the NPDM, and writes a [[#ProgramInfo]] to a C descriptor buffer as follows:

			=== ProgramInfo ===
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 127:		Line 147:
	\|}		\|}

	== ~~RegisterTitle~~ ==		== PinProgram ==
	Takes ~~a TitleId + StorageId, returns~~ an ~~index.~~		Takes an ncm::ProgramLocation, returns a u64 "PinId".

	~~== UnregisterTitle ==~~
	~~Takes the index from [[#RegisterTitle]].~~

	~~= ldr~~:~~shel =~~
	~~This is "nn~~:~~:ldr::detail::IShellInterface~~".

	~~{\| class=~~"~~wikitable" border="1"~~
	\|-
	~~! Cmd \|\| Name~~
	\|-
	~~\| 0 \|\| [[#AddProcessToLaunchQueue]]~~
	\|-
	~~\| 1 \|\| [[#ClearLaunchQueue]]~~
	\|}

	~~== AddProcessToLaunchQueue ==~~
	~~Takes a type-0x9 input buffer with launch arguments (as string), an u32 (size of arguments string), and an input title-id.~~

	~~Loads a process for the specified title-id and passes along the supplied arguments.~~
	~~Loaded processes are kept in a queue waiting for PM to launch them. The maximum number of waiting processes in this list is 10~~.

	== ~~ClearLaunchQueue~~ ==		== UnpinProgram ==
	~~Clears the loaded processes waiting queue~~.		Takes a PinId from [[#PinProgram]].

	[[Category:Services]]		[[Category:Services]]

Yellows8: /* AddProcessToLaunchQueue */

2019-10-25T18:56:44Z

AddProcessToLaunchQueue

← Older revision		Revision as of 22:56, 25 October 2019
Line 146:		Line 146:

	== AddProcessToLaunchQueue ==		== AddProcessToLaunchQueue ==
	Takes a type-~~0x19~~ input buffer with launch arguments (as string), an u32 (size of arguments string), and an input title-id.		Takes a type-0x9 input buffer with launch arguments (as string), an u32 (size of arguments string), and an input title-id.

	Loads a process for the specified title-id and passes along the supplied arguments.		Loads a process for the specified title-id and passes along the supplied arguments.