NS services: Difference between revisions

==== GetApplicationDeliveryInfo ====

==== HasAllContentsToDeliver ====

Takes a type-0x5 input buffer containing an array of [[#ApplicationDeliveryInfo]], returns an output u8 bool.

==== CompareApplicationDeliveryInfo ====

Takes two type-0x5 input buffers containing an array of [[#ApplicationDeliveryInfo]], returns an output s32.

The array-count for both buffers must be 1, otherwise an error is returned.

Takes two type-0x5 input buffers containing an array of [[#ApplicationDeliveryInfo]], returns an output u8 bool.

The array-count for the first buffer must be <=1, otherwise an error is returned. If the array-count for the first buffer is 0, this will return 0 with the output bool set to 0. The first [[#ApplicationDeliveryInfo]] buffer is validated. An error is thrown when u32 [[#ApplicationDeliveryInfo]] (first buffer) +0x1C bit1 is clear or bit0 set. An error is thrown when u32 [[#ApplicationDeliveryInfo]] (second buffer) +0x1C bit1 is clear.

==== ListContentMetaKeyToDeliverApplication ====

Takes a type-0x6 output buffer containing an array of [[NCM_services#ContentMetaKey|ContentMetaKey]], a type-0x5 input buffer containing an array of [[#ApplicationDeliveryInfo]], a s32, and returns an output s32 total_out.

The array-count for ContentMetaKey must be at least 1, and for ApplicationDeliveryInfo it must match 1.

==== NeedsSystemUpdateToDeliverApplication ====

Takes a type-0x15 input buffer containing a [[#SystemDeliveryInfo]], a type-0x5 input buffer containing an array of [[#ApplicationDeliveryInfo]], and returns an output u8 bool.

The array-count must match 1.

[[qlaunch]] uses value Any for the StorageId, and value 55556 for the port.

This loops through the input [[NCM_services#ContentMetaKey|ContentMetaKey]] array, throwing an error if the [[NCM_services#ContentMetaType|ContentMetaType]] doesn't match Patch. The input array is copied into state which is used later by the thread for [[NIM_services|nim]] cmd53, max entries is 0x12.

** Uses [[NIM_services|nim]] cmd53, returning the Result on failure.

** Uses [[NIM_services|nim]] cmd56, returning the Result on failure. Waits for the IAsyncResult operation from this to finish, then uses the Get cmd to get the output Result.

** Handles cleanup and returns.

* On success, this loads various data which is then used for saving a SystemPlayReport when the cached [[System_Settings|system-setting]] "systemreport!enabled" is set.

** The EventId is "receive_app_contents" with ApplicationId <NS ProgramId>.

==== CommitReceiveApplication ====

Takes an input [[NCM_services#ApplicationId|ApplicationId]], no output.

==== GetReceiveApplicationProgress ====

Takes an input [[NCM_services#ApplicationId|ApplicationId]], returns an output [[#ReceiveApplicationProgress]].

Uses [[NIM_services|nim]] cmd67, throwing an error if no task is returned. Then [[NIM_services|nim]] cmd57 is used, returning the error from there on failure. Lastly, this writes the 0x10-bytes from output+8 from the latter cmd to the output [[#ReceiveApplicationProgress]], and returns 0.

[[qlaunch]] uses value 55556 for the port.

* Calls a func which does:

** Uses [[NIM_services|nim]] cmd60, returning the Result on failure.

** Uses [[NIM_services|nim]] cmd61, returning the Result on failure. Waits for the IAsyncResult operation from this to finish, then uses the Get cmd to get the output Result.

** Handles cleanup and returns.

* On success, this loads various data which is then used for saving a SystemPlayReport when the cached [[System_Settings|system-setting]] "systemreport!enabled" is set.

** The EventId is "send_app_contents" with ApplicationId <NS ProgramId>.

==== GetSendApplicationProgress ====

Takes an input [[NCM_services#ApplicationId|ApplicationId]], returns an output [[#SendApplicationProgress]].

==== CompareSystemDeliveryInfo ====

==== ListNotCommittedContentMeta ====

Takes a type-0x6 output buffer containing an array of [[NCM_services#ContentMetaKey|ContentMetaKey]], a s32, an [[NCM_services#ApplicationId|ApplicationId]], returns an output s32 total_out.

==== RecoverDownloadTask ====

Takes a type-0x5 input buffer containing an array of {unknown} and an input u64, no output.

==== GetApplicationDeliveryInfoHash ====

Takes a type-0x5 input buffer containing an array of [[#ApplicationDeliveryInfo]], returns an output 0x20-byte SHA256 hash.

==== Cmd2019 ====

Takes a type-0x15 input buffer containing a [[#SystemDeliveryInfo]], a type-0x5 input buffer containing an array of [[#ApplicationDeliveryInfo]], a type-0x5 input buffer containing an array of [[#ApplicationDeliveryInfo]], returns an output u8 bool.

This calls a func for validating the [[#SystemDeliveryInfo]] from the type-0x15 buffer, returning the Result on failure.

* When the SystemDeliveryInfoPlatform from the input [[#SystemDeliveryInfo]] matches the [[System_Settings|sys-setting]], it does the following:

** Uses [[Shared_Database_services|pl:s]] RequestApplicationFunctionAuthorizationByApplicationId with the [[#ApplicationDeliveryInfo]] ApplicationId/ApplicationVersion and ApplicationFunctionAuthorizationId=0x5, handling the Result on failure.

** When the [[#SystemDeliveryInfo]] SystemDeliveryInfoPlatform is 0x0 (NX): write 0 to the output bool and return 0.

** Otherwise, Abort.

No input, returns an output bool.

==== Cmd4026 ====

See [[NIM_services|nim]] regarding the input addr/port usage, etc.

This validates the [[#SystemDeliveryInfo]] and generates a [[NCM_services#ContentMetaKey|ContentMetaKey]] from that, and creates the [[#IAsyncResult]] + the async thread which handles the [[#IAsyncResult]] operation. Then the thread does:

! Description

|-

|-

|-

| 0x8 || 0x8 || ApplicationId.

| 0x10 || 0x4 || ApplicationVersion.

|-

|-

| 0x18 || 0x4 || RequiredSystemVersion.

|-

|-

|-

| 0xE0 || 0x20 || HMAC-SHA256 over the previous 0xE0-bytes. Uses a different key than [[#SystemDeliveryInfo]].