NIM services - Revision history

Hexkyz at 02:47, 20 March 2026

2026-03-20T01:47:33Z

← Older revision		Revision as of 04:47, 20 March 2026
Line 208:		Line 208:
	\| 101 \|\| [9.0.0+] RequestDownloadETickets		\| 101 \|\| [9.0.0+] RequestDownloadETickets
	\|-		\|-
	\| 102 \|\| [9.0.0+] RequestQueryDownloadableContents		\| 102 \|\| [9.0.0+] [[#RequestQueryDownloadableContents]]
	\|-		\|-
	\| 103 \|\| [9.0.0+] DeleteNetworkInstallTaskContentMeta		\| 103 \|\| [9.0.0+] DeleteNetworkInstallTaskContentMeta
	\|-		\|-
	\| 104 \|\| [9.0.0+] RequestIssueEdgeTokenForDebug		\| 104 \|\| [9.0.0+] [[#RequestIssueEdgeTokenForDebug]]
	\|-		\|-
	\| 105 \|\| [9.0.0+] RequestQueryAvailableELicenses2		\| 105 \|\| [9.0.0+] RequestQueryAvailableELicenses2
Line 238:		Line 238:
	\| 116 \|\| [10.0.0+] GetAllocatorInfo		\| 116 \|\| [10.0.0+] GetAllocatorInfo
	\|-		\|-
	\| 117 \|\| [11.0.0+] RequestQueryDownloadableContentsByApplicationId		\| 117 \|\| [11.0.0+] [[#RequestQueryDownloadableContentsByApplicationId]]
	\|-		\|-
	\| 118 \|\| [10.0.0+] MarkNoDownloadRightsErrorResolved		\| 118 \|\| [10.0.0+] MarkNoDownloadRightsErrorResolved
Line 353:		Line 353:
	\|-		\|-
	\| 177 \|\| [21.0.0+]		\| 177 \|\| [21.0.0+]
			\|-
			\| 178 \|\| [22.0.0+]
			\|-
			\| 179 \|\| [22.0.0+]
			\|-
			\| 180 \|\| [22.0.0+]
			\|-
			\| 181 \|\| [22.0.0+]
	\|-		\|-
	\| 2000 \|\| [20.0.0+]		\| 2000 \|\| [20.0.0+]
Line 631:		Line 639:

	This is the Send version of [[#ListLocalCommunicationReceiveSystemUpdateTask]].		This is the Send version of [[#ListLocalCommunicationReceiveSystemUpdateTask]].

			== RequestQueryDownloadableContents ==
			[22.0.0+] Now takes a total of 1-byte of input.

			== RequestIssueEdgeTokenForDebug ==
			[22.0.0+] Now takes a total of 1-byte of input.

			== RequestQueryDownloadableContentsByApplicationId ==
			[22.0.0+] Now takes a total of 1-byte of input.

	== GetApplyDeltaTaskAllAppliedContentMeta ==		== GetApplyDeltaTaskAllAppliedContentMeta ==

Yellows8 at 18:21, 24 February 2026

2026-02-24T17:21:35Z

← Older revision		Revision as of 20:21, 24 February 2026
Line 1,060:		Line 1,060:
	See [[#CreateLocalCommunicationReceiveSystemUpdateTask]]/[[#CreateLocalCommunicationSendSystemUpdateTask]] for the socket setup during Receive/Send task creation. Receive system = client, while Send system = server.		See [[#CreateLocalCommunicationReceiveSystemUpdateTask]]/[[#CreateLocalCommunicationSendSystemUpdateTask]] for the socket setup during Receive/Send task creation. Receive system = client, while Send system = server.

	The Receive async [[#RequestLocalCommunicationReceiveSystemUpdateTaskRun\|thread]] does the following:		The Receive async [[#RequestLocalCommunicationReceiveSystemUpdateTaskRun\|thread]] does the following (the ReceiveApplication [[#RequestLocalCommunicationReceiveApplicationTaskRun\|thread]] is identical except it uses different previously setup state):
	* [5.0.0+] Sets the <code>nn::fs::PriorityRaw</code> using a value loaded from state.		* [5.0.0+] Sets the <code>nn::fs::PriorityRaw</code> using a value loaded from state.
	* Calls a func, and writes the returned Result into state.		* Calls a func, and writes the returned Result into state.

Yellows8: /* RequestCheckSafeSystemVersion */

2026-01-30T21:13:18Z

RequestCheckSafeSystemVersion

← Older revision		Revision as of 00:13, 31 January 2026
Line 640:		Line 640:
	The async task does a network request with [[Network\|bvc]].		The async task does a network request with [[Network\|bvc]].

	Attempting to block this domain may result in the ([S2]) applets which use ns:vm displaying error message "This feature is not available".		Attempting to block this domain may result in the ([S2]) applets which use ns:vm displaying error message "This feature is not available" (possibly related to newer-version already being cached?).

	== RequestApplicationIcon ==		== RequestApplicationIcon ==

Yellows8: /* RequestCheckSafeSystemVersion */

2026-01-29T18:12:24Z

RequestCheckSafeSystemVersion

← Older revision		Revision as of 21:12, 29 January 2026
Line 639:		Line 639:

	The async task does a network request with [[Network\|bvc]].		The async task does a network request with [[Network\|bvc]].

			Attempting to block this domain may result in the ([S2]) applets which use ns:vm displaying error message "This feature is not available".

	== RequestApplicationIcon ==		== RequestApplicationIcon ==

Hexkyz at 21:21, 11 November 2025

2025-11-11T20:21:47Z

← Older revision		Revision as of 23:21, 11 November 2025
Line 188:		Line 188:
	\| 91 \|\| [6.0.0-14.1.2]		\| 91 \|\| [6.0.0-14.1.2]
	\|-		\|-
	\| 92 \|\| [6.0.0-19.0.1] RequestQueryRevokeReason		\| 92 \|\| [21.0.0+] ([6.0.0-19.0.1] RequestQueryRevokeReason)
	\|-		\|-
	\| 93 \|\| [6.0.0+] RequestReportActiveELicenses		\| 93 \|\| [6.0.0+] RequestReportActiveELicenses
Line 345:		Line 345:
	\|-		\|-
	\| 173 \|\| [20.1.0+]		\| 173 \|\| [20.1.0+]
			\|-
			\| 174 \|\| [21.0.0+]
			\|-
			\| 175 \|\| [21.0.0+]
			\|-
			\| 176 \|\| [21.0.0+]
			\|-
			\| 177 \|\| [21.0.0+]
	\|-		\|-
	\| 2000 \|\| [20.0.0+]		\| 2000 \|\| [20.0.0+]

Yellows8 at 23:36, 10 August 2025

2025-08-10T21:36:45Z

← Older revision		Revision as of 01:36, 11 August 2025
Line 288:		Line 288:
	\| 141 \|\| [15.0.0+] IsNetworkConnectionEnabledToUseApplicationCore		\| 141 \|\| [15.0.0+] IsNetworkConnectionEnabledToUseApplicationCore
	\|-		\|-
	\| 142 \|\| [17.0.0+] RequestCheckSafeSystemVersion		\| 142 \|\| [17.0.0+] [[#RequestCheckSafeSystemVersion]]
	\|-		\|-
	\| 143 \|\| [17.0.0+] [[#RequestApplicationIcon]]		\| 143 \|\| [17.0.0+] [[#RequestApplicationIcon]]
Line 626:		Line 626:
	== GetApplyDeltaTaskAllAppliedContentMeta ==		== GetApplyDeltaTaskAllAppliedContentMeta ==
	[20.0.0+] Now takes a 0x18-bytes type-0x6 output buffer and returns 4-bytes of output instead of 0x18-bytes.		[20.0.0+] Now takes a 0x18-bytes type-0x6 output buffer and returns 4-bytes of output instead of 0x18-bytes.

			== RequestCheckSafeSystemVersion ==
			No input, returns an output Event and an [[#IAsyncResult]].

			The async task does a network request with [[Network\|bvc]].

	== RequestApplicationIcon ==		== RequestApplicationIcon ==

Yellows8: /* Contents Delivery */

2025-07-20T17:06:59Z

Contents Delivery

← Older revision		Revision as of 21:06, 20 July 2025
Line 1,106:		Line 1,106:

	With SystemUpdate the server only uses StorageId=BuiltInSystem.		With SystemUpdate the server only uses StorageId=BuiltInSystem.

			With SystemUpdate, when the server handles message 0x1 prior to loading the PackagedContentInfo, it first loads the [[CNMT]] ContentMetaInfo array with the ContentMetaKey from [[#CreateLocalCommunicationSendSystemUpdateTask\|CreateLocalCommunicationSendSystemUpdateTask]]. The input message ContentMetaKey [[NCM_services\|ContentInstallType]] must be 0x0 (Full), otherwise it skips the following loop. It then loops through the ContentMetaInfo array comparing against the input message ContentMetaKey, for verifying that one of the entries match. After the loop if a valid entry wasn't found, the input message ContentMetaKey must match the ContentMetaKey from [[#CreateLocalCommunicationSendSystemUpdateTask\|CreateLocalCommunicationSendSystemUpdateTask]], otherwise an error is thrown. It then loads the PackagedContentInfo.

	With Application, when the server handles message 0x1 prior to loading the PackagedContentInfo, it first loops through the input array from [[#CreateLocalCommunicationSendApplicationTask\|CreateLocalCommunicationSendApplicationTask]], throwing an error if the input ContentMetaKey doesn't match an entry from here. It then loads the PackagedContentInfo with the StorageId from the located entry.		With Application, when the server handles message 0x1 prior to loading the PackagedContentInfo, it first loops through the input array from [[#CreateLocalCommunicationSendApplicationTask\|CreateLocalCommunicationSendApplicationTask]], throwing an error if the input ContentMetaKey doesn't match an entry from here. It then loads the PackagedContentInfo with the StorageId from the located entry.

Yellows8: /* Contents Delivery */

2025-07-19T18:12:46Z

Contents Delivery

← Older revision		Revision as of 22:12, 19 July 2025
Line 1,106:		Line 1,106:

	With SystemUpdate the server only uses StorageId=BuiltInSystem.		With SystemUpdate the server only uses StorageId=BuiltInSystem.

			With Application, when the server handles message 0x1 prior to loading the PackagedContentInfo, it first loops through the input array from [[#CreateLocalCommunicationSendApplicationTask\|CreateLocalCommunicationSendApplicationTask]], throwing an error if the input ContentMetaKey doesn't match an entry from here. It then loads the PackagedContentInfo with the StorageId from the located entry.

			With Application, when the server handles message 0x2 for determining what StorageId to use, it loops through the input array from [[#CreateLocalCommunicationSendApplicationTask\|CreateLocalCommunicationSendApplicationTask]]. [[NCM_services\|ncm]] IContentMetaDatabase HasContent is used with the array entry ContentMetaKey and the message input [[NCM_services#ContentId\|ContentId]]. When cmd output indicates the content is present, the entry StorageId is written to output. Otherwise an error is thrown if none found with all array entries.

	Messages:		Messages:

Yellows8: /* CreateLocalCommunicationSendApplicationTask */

2025-07-19T17:49:16Z

CreateLocalCommunicationSendApplicationTask

← Older revision		Revision as of 21:49, 19 July 2025
Line 511:		Line 511:

	This is the SendApplication version of [[#CreateLocalCommunicationSendSystemUpdateTask]].		This is the SendApplication version of [[#CreateLocalCommunicationSendSystemUpdateTask]].

			The struct for the input array contains: {[[NCM_services\|ContentMetaKey]], u8 [[NCM_services\|StorageId]], the rest is padding}.

	== RequestLocalCommunicationSendApplicationTaskRun ==		== RequestLocalCommunicationSendApplicationTaskRun ==

Yellows8: /* CreateLocalCommunicationReceiveSystemUpdateTask */

2025-07-13T00:28:56Z

CreateLocalCommunicationReceiveSystemUpdateTask

← Older revision		Revision as of 04:28, 13 July 2025
Line 537:		Line 537:
	[8.0.0+] Takes an input u16 port, an u32 Ipv4Address, an u32 firmware_variation, an u32 '''unk''', a [[NCM_services#ContentMetaKey\|ContentMetaKey]], returns an output [[#LocalCommunicationReceiveSystemUpdateTaskId]].		[8.0.0+] Takes an input u16 port, an u32 Ipv4Address, an u32 firmware_variation, an u32 '''unk''', a [[NCM_services#ContentMetaKey\|ContentMetaKey]], returns an output [[#LocalCommunicationReceiveSystemUpdateTaskId]].

	~~Official sw sets '''unk''' to: <code>unk = stateflag==0 ? 0x4 : 0xC</code>.~~ The port/Ipv4Address params originate from the [[NS_Services#RequestReceiveSystemUpdate\|RequestReceiveSystemUpdate]] params.		The port/Ipv4Address params originate from the [[NS_Services#RequestReceiveSystemUpdate\|RequestReceiveSystemUpdate]] params, see [[NS_Services#RequestReceiveSystemUpdate\|RequestReceiveSystemUpdate]] regarding the rest of the input params.

	This is the ReceiveSystemUpdate version of [[#CreateSystemUpdateTask]].		This is the ReceiveSystemUpdate version of [[#CreateSystemUpdateTask]].