2,787
edits
Changes
no edit summary
| 8 || ListNetworkInstallTask
| 8 || ListNetworkInstallTask
|-
|-
| 9 || RequestNetworkInstallTaskRun
| 9 || [[#RequestNetworkInstallTaskRun]]
|-
|-
| 10 || [[#GetNetworkInstallTaskInfo]]
| 10 || [[#GetNetworkInstallTaskInfo]]
| 35 || [2.0.0+] [[#GetApplyDeltaTaskInfo]]
| 35 || [2.0.0+] [[#GetApplyDeltaTaskInfo]]
|-
|-
| 36 || [2.0.0+] ListApplyDeltaTask
| 36 || [2.0.0+] ListApplyDeltaTaskContentMeta
|-
|-
| 37 || [2.0.0+] CommitApplyDeltaTask
| 37 || [2.0.0+] CommitApplyDeltaTask
| 39 || [2.0.0+] PrepareShutdown
| 39 || [2.0.0+] PrepareShutdown
|-
|-
| 40 || [2.0.0+] ListApplyDeltaTask2
| 40 || [2.0.0+] ListApplyDeltaTask
|-
|-
| 41 || [2.0.0+] ClearNotEnoughSpaceStateOfApplyDeltaTask
| 41 || [2.0.0+] ClearNotEnoughSpaceStateOfApplyDeltaTask
|-
|-
| 42 || [3.0.0+]
| 42 || [3.0.0+] CreateApplyDeltaTaskFromDownloadTask
|-
|-
| 43 || [3.0.0+]
| 43 || [3.0.0+] GetBackgroundApplyDeltaStressTaskInfo
|-
|-
| 44 || [3.0.0+]
| 44 || [3.0.0+] GetApplyDeltaTaskRequiredStorage
|-
|-
| 45 || [3.0.0+]
| 45 || [3.0.0+] CalculateNetworkInstallTaskContentsSize
|-
|-
| 46 || [3.0.0+]
| 46 || [3.0.0+] PrepareShutdownForSystemUpdate
|-
|-
| 47 || [4.0.0-9.2.0]
| 47 || [4.0.0-9.2.0] FindMaxRequiredApplicationVersionOfTask
|-
|-
| 48 || [4.0.0+]
| 48 || [4.0.0+] CommitNetworkInstallTaskPartially
|-
|-
| 49 || [4.0.0+]
| 49 || [4.0.0+] ListNetworkInstallTaskCommittedContentMeta
|-
|-
| 50 || [4.0.0+]
| 50 || [4.0.0+] ListNetworkInstallTaskNotCommittedContentMeta
|-
|-
| 51 || [4.0.0+]
| 51 || [4.0.0+] FindMaxRequiredSystemVersionOfTask
|-
|-
| 52 || [4.0.0+]
| 52 || [4.0.0+] GetNetworkInstallTaskErrorContext
|-
|-
| 53 || [4.0.0+]
| 53 || [4.0.0+] [[#CreateLocalCommunicationReceiveApplicationTask]]
|-
|-
| 54 || [4.0.0+]
| 54 || [4.0.0+] DestroyLocalCommunicationReceiveApplicationTask
|-
|-
| 55 || [4.0.0+]
| 55 || [4.0.0+] ListLocalCommunicationReceiveApplicationTask
|-
|-
| 56 || [4.0.0+]
| 56 || [4.0.0+] [[#RequestLocalCommunicationReceiveApplicationTaskRun]]
|-
|-
| 57 || [4.0.0+]
| 57 || [4.0.0+] [[#GetLocalCommunicationReceiveApplicationTaskInfo]]
|-
|-
| 58 || [4.0.0+]
| 58 || [4.0.0+] CommitLocalCommunicationReceiveApplicationTask
|-
|-
| 59 || [4.0.0+]
| 59 || [4.0.0+] ListLocalCommunicationReceiveApplicationTaskContentMeta
|-
|-
| 60 || [4.0.0+]
| 60 || [4.0.0+] [[#CreateLocalCommunicationSendApplicationTask]]
|-
|-
| 61 || [4.0.0+]
| 61 || [4.0.0+] [[#RequestLocalCommunicationSendApplicationTaskRun]]
|-
|-
| 62 || [4.0.0+]
| 62 || [4.0.0+] GetLocalCommunicationReceiveApplicationTaskErrorContext
|-
|-
| 63 || [4.0.0+]
| 63 || [4.0.0+] [[#GetLocalCommunicationSendApplicationTaskInfo]]
|-
|-
| 64 || [4.0.0+]
| 64 || [4.0.0+] DestroyLocalCommunicationSendApplicationTask
|-
|-
| 65 || [4.0.0+]
| 65 || [4.0.0+] GetLocalCommunicationSendApplicationTaskErrorContext
|-
|-
| 66 || [4.0.0+]
| 66 || [4.0.0+] CalculateLocalCommunicationReceiveApplicationTaskRequiredSize
|-
|-
| 67 || [4.0.0+]
| 67 || [4.0.0+] [[#ListApplicationLocalCommunicationReceiveApplicationTask]]
|-
|-
| 68 || [4.0.0+]
| 68 || [4.0.0+] [[#ListApplicationLocalCommunicationSendApplicationTask]]
|-
|-
| 69 || [4.0.0+]
| 69 || [4.0.0+] [[#CreateLocalCommunicationReceiveSystemUpdateTask]]
|-
|-
| 70 || [4.0.0+]
| 70 || [4.0.0+] DestroyLocalCommunicationReceiveSystemUpdateTask
|-
|-
| 71 || [4.0.0+]
| 71 || [4.0.0+] [[#ListLocalCommunicationReceiveSystemUpdateTask]]
|-
|-
| 72 || [4.0.0+]
| 72 || [4.0.0+] [[#RequestLocalCommunicationReceiveSystemUpdateTaskRun]]
|-
|-
| 73 || [4.0.0+]
| 73 || [4.0.0+] [[#GetLocalCommunicationReceiveSystemUpdateTaskInfo]]
|-
|-
| 74 || [4.0.0+]
| 74 || [4.0.0+] CommitLocalCommunicationReceiveSystemUpdateTask
|-
|-
| 75 || [4.0.0+]
| 75 || [4.0.0+] GetLocalCommunicationReceiveSystemUpdateTaskErrorContext
|-
|-
| 76 || [4.0.0+]
| 76 || [4.0.0+] [[#CreateLocalCommunicationSendSystemUpdateTask]]
|-
|-
| 77 || [4.0.0+]
| 77 || [4.0.0+] [[#RequestLocalCommunicationSendSystemUpdateTaskRun]]
|-
|-
| 78 || [4.0.0+]
| 78 || [4.0.0+] [[#GetLocalCommunicationSendSystemUpdateTaskInfo]]
|-
|-
| 79 || [4.0.0+]
| 79 || [4.0.0+] DestroyLocalCommunicationSendSystemUpdateTask
|-
|-
| 80 || [4.0.0+]
| 80 || [4.0.0+] GetLocalCommunicationSendSystemUpdateTaskErrorContext
|-
|-
| 81 || [4.0.0+]
| 81 || [4.0.0+] [[#ListLocalCommunicationSendSystemUpdateTask]]
|-
|-
| 82 || [4.0.0+]
| 82 || [4.0.0+] GetReceivedSystemDataPath
|-
|-
| 83 || [4.0.0+]
| 83 || [4.0.0+] CalculateApplyDeltaTaskOccupiedSize
|-
|-
| 84 || [5.0.0+]
| 84 || [5.0.0+]
|-
|-
| 85 || [5.0.0+]
| 85 || [5.0.0+] ListNetworkInstallTaskContentMetaFromInstallMeta
|-
|-
| 86 || [5.0.0+]
| 86 || [5.0.0+] ListNetworkInstallTaskOccupiedSize
|-
|-
| 87 || [6.0.0+]
| 87 || [6.0.0+]
| 90 || [6.0.0+]
| 90 || [6.0.0+]
|-
|-
| 91 || [6.0.0+]
| 91 || [6.0.0-14.1.2]
|-
|-
| 92 || [6.0.0+]
| 92 || [6.0.0+]
|-
|-
| 116 || [10.0.0+]
| 116 || [10.0.0+]
|-
| 117 || [11.0.0+]
|-
|-
| 118 || [10.0.0+]
| 118 || [10.0.0+]
|-
| 119 || [11.0.0+]
|-
| 120 || [11.0.0+]
|-
| 121 || [10.1.0+]
|-
| 122 || [10.1.0+]
|-
| 123 || [10.1.0+]
|-
| 124 || [11.0.0+]
|-
| 125 || [11.0.0+]
|-
| 126 || [12.0.0+]
|-
| 127 || [12.0.0+]
|-
| 128 || [12.0.0+]
|-
| 129 || [12.0.0+]
|-
| 130 || [13.0.0+]
|-
| 131 || [13.0.0+]
|-
| 132 || [13.0.0+]
|-
| 133 || [13.0.0+]
|-
| 134 || [13.0.0+]
|-
| 135 || [14.0.0+]
|-
| 136 || [14.0.0+]
|-
| 137 || [14.0.0+]
|-
| 138 || [15.0.0+]
|-
| 139 || [15.0.0+]
|-
| 140 || [15.0.0+]
|-
| 141 || [15.0.0+]
|-
| 142 || [17.0.0+]
|-
| 143 || [17.0.0+]
|-
| 144 || [17.0.0+]
|-
| 147 || [18.0.0+]
|-
| 148 || [18.0.0+]
|-
| 3000 || [17.0.0+]
|-
| 3001 || [17.0.0+]
|}
|}
[5.0.0+] RequestGameCardRegistrationStatus/RequestRegisterGameCard removed 8-bytes of input, and now takes an additional type-0x5 input buffer.
[5.0.0+] RequestGameCardRegistrationStatus/RequestRegisterGameCard removed 8-bytes of input, and now takes an additional type-0x5 input buffer.
[8.0.0+] Cmd76 now takes an additional 0x8-bytes of input.
[12.0.0+] Cmd92 now returns an [[#IAsyncData]] instead of [[#IAsyncValue]].
== CreateSystemUpdateTask ==
== CreateSystemUpdateTask ==
== CommitSystemUpdateTask ==
== CommitSystemUpdateTask ==
Takes an input [[#SystemUpdateTaskId]], no output.
Takes an input [[#SystemUpdateTaskId]], no output.
== RequestNetworkInstallTaskRun ==
Takes a total of 0x10-bytes of input, returns an output [[#IAsyncResult]] and handle.
[13.0.0+] Now takes an additional 1-byte of input.
== GetNetworkInstallTaskInfo ==
== GetNetworkInstallTaskInfo ==
Takes an input [[#NetworkInstallTask]], returns an output [[#NetworkInstallTaskInfo]].
Takes an input [[#NetworkInstallTask]], returns an output [[#NetworkInstallTaskInfo]].
[10.0.0+] This now returns a total of 0x48-bytes of output instead of 0x40-bytes.
== GetDownloadedSystemDataPath ==
== GetDownloadedSystemDataPath ==
Takes an input u64 titleID, a [[#SystemUpdateTaskId]], and an type-0x16 output buffer containing the [[Filesystem_services|ContentPath]].
Takes an input u64 titleID, a [[#SystemUpdateTaskId]], and an type-0x16 output buffer containing the [[Filesystem_services#FspPath|FspPath]].
Gets the FS ContentPath for the specified task and title.
Gets the FS FspPath for the specified task and title.
== IsExFatDriverIncluded ==
== IsExFatDriverIncluded ==
Takes an input [[#ApplyDeltaTask]], returns an output [[#ApplyDeltaTaskInfo]].
Takes an input [[#ApplyDeltaTask]], returns an output [[#ApplyDeltaTaskInfo]].
== Cmd53 ==
== CreateLocalCommunicationReceiveApplicationTask ==
Takes an input [[NCM_services#StorageId|StorageId]], an u16 port, an u32 Ipv4Address, an u32 '''unk''', an u64 <code>nn::ncm::ApplicationId</code>, a type-0x5 input buffer containing an array of [[NCM_services#ContentMetaKey|ContentMetaKey]], returns an output [[#ReceiveApplicationTask]].
Takes an input [[NCM_services#StorageId|StorageId]], an u16 port, an u32 Ipv4Address, an u32 '''unk''', an u64 <code>nn::ncm::ApplicationId</code>, a type-0x5 input buffer containing an array of [[NCM_services#ContentMetaKey|ContentMetaKey]], returns an output [[#ReceiveApplicationTask]].
This is the ReceiveApplication version of [[#Cmd69]].
This is the ReceiveApplication version of [[#CreateLocalCommunicationReceiveSystemUpdateTask]].
The wrapper used by official sw passes hard-coded value 0x2 for '''unk'''.
The wrapper used by official sw passes hard-coded value 0x2 for '''unk'''.
== Cmd56 ==
== RequestLocalCommunicationReceiveApplicationTaskRun ==
Takes an input [[#ReceiveApplicationTask]], returns an output Event and an [[#IAsyncResult]].
Takes an input [[#ReceiveApplicationTask]], returns an output Event and an [[#IAsyncResult]].
This is the ReceiveApplication version of [[#Cmd72]].
This is the ReceiveApplication version of [[#RequestLocalCommunicationReceiveSystemUpdateTaskRun]].
== Cmd57 ==
== GetLocalCommunicationReceiveApplicationTaskInfo ==
Takes an input [[#ReceiveApplicationTask]], returns an output [[#ReceiveApplicationTaskInfo]].
Takes an input [[#ReceiveApplicationTask]], returns an output [[#ReceiveApplicationTaskInfo]].
This is the ReceiveApplication version of [[#GetSystemUpdateTaskInfo]].
This is the ReceiveApplication version of [[#GetSystemUpdateTaskInfo]].
== Cmd60 ==
== CreateLocalCommunicationSendApplicationTask ==
Takes an input u16 port, an u32 Ipv4Address, an u64 <code>nn::ncm::ApplicationId</code>, a type-0x5 input buffer containing an array of {unknown}, returns an output [[#SendApplicationTask]].
Takes an input u16 port, an u32 Ipv4Address, an u64 <code>nn::ncm::ApplicationId</code>, a type-0x5 input buffer containing an array of {unknown}, returns an output [[#SendApplicationTask]].
This is the SendApplication version of [[#Cmd69]].
This is the SendApplication version of [[#CreateLocalCommunicationReceiveSystemUpdateTask]].
== Cmd61 ==
== RequestLocalCommunicationSendApplicationTaskRun ==
Takes an input [[#SendApplicationTask]], returns an output Event and an [[#IAsyncResult]].
Takes an input [[#SendApplicationTask]], returns an output Event and an [[#IAsyncResult]].
This is the SendApplicationTask version of [[#Cmd72]].
This is the SendApplicationTask version of [[#RequestLocalCommunicationReceiveSystemUpdateTaskRun]].
== Cmd63 ==
== GetLocalCommunicationSendApplicationTaskInfo ==
Takes an input [[#SendApplicationTask]], returns an output [[#SendApplicationTaskInfo]].
Takes an input [[#SendApplicationTask]], returns an output [[#SendApplicationTaskInfo]].
This is the SendApplication version of [[#GetSystemUpdateTaskInfo]].
This is the SendApplication version of [[#GetSystemUpdateTaskInfo]].
== Cmd67 ==
== ListApplicationLocalCommunicationReceiveApplicationTask ==
Takes a type-0x6 output buffer containing an array of [[#ReceiveApplicationTask]] and an input u64 <code>nn::ncm::ApplicationId</code>. Returns a s32 for total output entries.
Takes a type-0x6 output buffer containing an array of [[#ReceiveApplicationTask]] and an input u64 <code>nn::ncm::ApplicationId</code>. Returns a s32 for total output entries.
This is the ReceiveApplication version of [[#Cmd71]].
This is the ReceiveApplication version of [[#ListLocalCommunicationReceiveSystemUpdateTask]].
== Cmd68 ==
== ListApplicationLocalCommunicationSendApplicationTask ==
Takes a type-0x6 output buffer containing an array of [[#SendApplicationTask]] and an input u64 <code>nn::ncm::ApplicationId</code>. Returns a s32 for total output entries.
Takes a type-0x6 output buffer containing an array of [[#SendApplicationTask]] and an input u64 <code>nn::ncm::ApplicationId</code>. Returns a s32 for total output entries.
This is the SendApplication version of [[#Cmd71]].
This is the SendApplication version of [[#ListLocalCommunicationReceiveSystemUpdateTask]].
== Cmd69 ==
== CreateLocalCommunicationReceiveSystemUpdateTask ==
Takes an input u16 port, an u32 Ipv4Address, an u32 firmware_variation, an u32 '''unk''', a [[NCM_services#ContentMetaKey|ContentMetaKey]], returns an output [[#ReceiveSystemUpdateTask]].
Takes an input u16 port, an u32 Ipv4Address, an u32 firmware_variation, an u32 '''unk''', a [[NCM_services#ContentMetaKey|ContentMetaKey]], returns an output [[#ReceiveSystemUpdateTask]].
* All error handling following successful sockfd creation via socket() will also close the socket, when certain errors occur.
* All error handling following successful sockfd creation via socket() will also close the socket, when certain errors occur.
== Cmd71 ==
== ListLocalCommunicationReceiveSystemUpdateTask ==
Takes a type-0x6 output buffer, for an array of [[#ReceiveSystemUpdateTask]]. Returns a s32 for total output entries.
Takes a type-0x6 output buffer, for an array of [[#ReceiveSystemUpdateTask]]. Returns a s32 for total output entries.
This is the ReceiveSystemUpdate version of [[#ListSystemUpdateTask]].
This is the ReceiveSystemUpdate version of [[#ListSystemUpdateTask]].
== Cmd72 ==
== RequestLocalCommunicationReceiveSystemUpdateTaskRun ==
Takes an input [[#ReceiveSystemUpdateTask]], returns an output Event and an [[#IAsyncResult]].
Takes an input [[#ReceiveSystemUpdateTask]], returns an output Event and an [[#IAsyncResult]].
This is the ReceiveSystemUpdate version of RequestSystemUpdateTaskRun.
This is the ReceiveSystemUpdate version of RequestSystemUpdateTaskRun.
This creates the [[#IAsyncResult]] object + the async [[#Contents_Delivery|thread]] which handles the [[#IAsyncResult]] operation, which uses the state previously setup by [[#Cmd69]]. This throws an error if the object was already created.
This creates the [[#IAsyncResult]] object + the async [[#Contents_Delivery|thread]] which handles the [[#IAsyncResult]] operation, which uses the state previously setup by [[#CreateLocalCommunicationReceiveSystemUpdateTask]]. This throws an error if the object was already created.
== Cmd73 ==
== GetLocalCommunicationReceiveSystemUpdateTaskInfo ==
Takes an input [[#ReceiveSystemUpdateTask]], returns an output [[#ReceiveSystemUpdateTaskInfo]].
Takes an input [[#ReceiveSystemUpdateTask]], returns an output [[#ReceiveSystemUpdateTaskInfo]].
This is the ReceiveSystemUpdate version of [[#GetSystemUpdateTaskInfo]].
This is the ReceiveSystemUpdate version of [[#GetSystemUpdateTaskInfo]].
== Cmd76 ==
== CreateLocalCommunicationSendSystemUpdateTask ==
Takes an input u16 port, an u32 Ipv4Address, an u32 firmware_variation, and a [[NCM_services#ContentMetaKey|ContentMetaKey]], returns an output [[#SendSystemUpdateTask]].
Takes an input u16 port, an u32 Ipv4Address, an u32 firmware_variation, and a [[NCM_services#ContentMetaKey|ContentMetaKey]], returns an output [[#SendSystemUpdateTask]].
[8.0.0+] This now takes an additional 0x8-bytes of input.
The port/Ipv4Address params originate from the [[NS_Services#RequestSendSystemUpdate|RequestSendSystemUpdate]] params.
The port/Ipv4Address params originate from the [[NS_Services#RequestSendSystemUpdate|RequestSendSystemUpdate]] params.
The ContentMetaKey is for the SystemUpdate Meta ([[NCM_services#ContentMetaType|ContentMetaType]] must match SystemUpdate).
The ContentMetaKey is for the SystemUpdate Meta ([[NCM_services#ContentMetaType|ContentMetaType]] must match SystemUpdate).
This is the Send version of [[#Cmd69]].
This is the Send version of [[#CreateLocalCommunicationReceiveSystemUpdateTask]].
This does state setup, does the above ContentMetaType validation, copies ContentMetaKey/firmware_variation into state, and does socket setup.
This does state setup, does the above ContentMetaType validation, copies ContentMetaKey/firmware_variation into state, and does socket setup.
* The error handling for bind()/listen() will also close the socket, when certain errors occur.
* The error handling for bind()/listen() will also close the socket, when certain errors occur.
== Cmd77 ==
== RequestLocalCommunicationSendSystemUpdateTaskRun ==
Takes an input [[#SendSystemUpdateTask]], returns an output Event and an [[#IAsyncResult]].
Takes an input [[#SendSystemUpdateTask]], returns an output Event and an [[#IAsyncResult]].
This is the Send version of [[#Cmd72]].
This is the Send version of [[#RequestLocalCommunicationReceiveSystemUpdateTaskRun]].
This creates the [[#IAsyncResult]] object + the async [[#Contents_Delivery|thread]] which handles the [[#IAsyncResult]] operation, which uses the state previously setup by [[#Cmd76]]. This throws an error if the object was already created.
This creates the [[#IAsyncResult]] object + the async [[#Contents_Delivery|thread]] which handles the [[#IAsyncResult]] operation, which uses the state previously setup by [[#CreateLocalCommunicationSendSystemUpdateTask]]. This throws an error if the object was already created.
== Cmd78 ==
== GetLocalCommunicationSendSystemUpdateTaskInfo ==
Takes an input [[#SendSystemUpdateTask]], returns an output [[#SendSystemUpdateTaskInfo]].
Takes an input [[#SendSystemUpdateTask]], returns an output [[#SendSystemUpdateTaskInfo]].
This is the Send version of [[#Cmd73]].
This is the Send version of [[#GetLocalCommunicationReceiveSystemUpdateTaskInfo]].
== Cmd81 ==
== ListLocalCommunicationSendSystemUpdateTask ==
Takes a type-0x6 output buffer, for an array of [[#SendSystemUpdateTask]]. Returns a s32 for total output entries.
Takes a type-0x6 output buffer, for an array of [[#SendSystemUpdateTask]]. Returns a s32 for total output entries.
This is the Send version of [[#Cmd71]].
This is the Send version of [[#ListLocalCommunicationReceiveSystemUpdateTask]].
== SystemUpdateTaskId ==
== SystemUpdateTaskId ==
= nim:shp =
= nim:shp =
This is "nn::nim::detail::IShopServiceManager".
This is "nn::nim::detail::IShopServiceManager".
This is only available when [[Process_Manager_services|pm:bm]] GetBootMode returns output 0 (Normal).
{| class="wikitable" border="1"
{| class="wikitable" border="1"
| 101 || RequestUnregisterDeviceAccount
| 101 || RequestUnregisterDeviceAccount
|-
|-
| 102 || RequestDeviceAccountStatus
| 102 || [1.0.0-14.1.2] RequestDeviceAccountStatus
|-
|-
| 103 || GetDeviceAccountInfo
| 103 || [1.0.0-14.1.2] GetDeviceAccountInfo
|-
|-
| 104 || RequestDeviceRegistrationInfo
| 104 || [1.0.0-14.1.2] RequestDeviceRegistrationInfo
|-
|-
| 105 || RequestTransferDeviceAccount
| 105 || [1.0.0-14.1.2] RequestTransferDeviceAccount
|-
|-
| 106 || [3.0.0+] RequestSyncRegistration
| 106 || [3.0.0-14.1.2] RequestSyncRegistration
|-
|-
| 107 || [3.0.0+] IsOwnDeviceId
| 107 || [3.0.0+] IsOwnDeviceId
|-
| 108 || [14.0.0+] RevertSystemSaveDataOfDeviceAccountForDebug
|-
|-
| 200 || RequestRegisterNotificationToken
| 200 || RequestRegisterNotificationToken
| 302 || RequestLinkDevice
| 302 || RequestLinkDevice
|-
|-
| 303 || HasDeviceLink
| 303 || [1.0.0-13.2.1] HasDeviceLink
|-
|-
| 304 || [4.0.0+] RequestUnlinkDeviceAll
| 304 || [4.0.0+] RequestUnlinkDeviceAll
|-
|-
| 305 || [4.0.0+] RequestCreateVirtualAccount
| 305 || [4.0.0-13.2.1] RequestCreateVirtualAccount
|-
|-
| 306 || [4.0.0+] RequestDeviceLinkStatus
| 306 || [4.0.0+] RequestDeviceLinkStatus
|-
|-
| 400 || GetAccountByVirtualAccount
| 400 || [1.0.0-13.2.1] GetAccountByVirtualAccount
|-
|-
| 401 || [6.0.0+] GetVirtualAccount
| 401 || [6.0.0-13.2.1] GetVirtualAccount
|-
|-
| 500 || RequestSyncTicketLegacy ([1.0.0-8.1.0] RequestSyncTicket)
| 500 || RequestSyncTicketLegacy ([1.0.0-8.1.0] RequestSyncTicket)
|-
|-
| 501 || RequestDownloadTicket
| 501 || [1.0.0-14.1.2] RequestDownloadTicket
|-
|-
| 502 || [4.0.0+] [[#RequestDownloadTicketForPrepurchasedContents]]
| 502 || [4.0.0+] [[#RequestDownloadTicketForPrepurchasedContents]]
|-
|-
| 504 || [9.0.0+] RequestDownloadTicketForPrepurchasedContents2
| 504 || [9.0.0+] RequestDownloadTicketForPrepurchasedContents2
|-
| 505 || [13.1.0+] RequestDownloadTicketForPrepurchasedContentsForAccount
|-
| 600 || [14.0.0+] IsInitialLaunchFinished
|-
| 601 || [14.0.0+] NotifyFinishInitialLaunch
|}
|}
This was added with [5.0.0+].
This was added with [5.0.0+].
This is only available when [[Process_Manager_services|pm:bm]] GetBootMode returns output 0 (Normal).
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
| 4 || [10.0.0+] IsLargeResourceAvailable
| 4 || [10.0.0+] IsLargeResourceAvailable
|-
| 5 || [17.0.0+] CreateServerInterface2
|}
|}
This was added with [7.0.0+].
This was added with [7.0.0+].
This is only available when [[Process_Manager_services|pm:bm]] GetBootMode returns output 0 (Normal).
{| class="wikitable" border="1"
{| class="wikitable" border="1"
! Cmd || Name
! Cmd || Name
|-
|-
| 0 ||
| 0 || Get
|-
|-
| 1 ||
| 1 || Cancel
|-
|-
| 2 ||
| 2 || GetSize
|-
|-
| 3 ||
| 3 || Read
|-
|-
| 4 ||
| 4 || GetETag
|-
|-
| 5 || [4.0.0+]
| 5 || [4.0.0+] GetErrorContext
|}
|}
= Contents Delivery =
= Notes =
nnMain calls two funcs only when when [[Process_Manager_services|pm:bm]] GetBootMode output is 0 or 1 (Normal/Maintenance), which are: [[ETicket_services|es]] service init, and [[Account_services|acc:e:u1]] service init.
nnMain only handles [[PSC_services|ovln:snd]] initialization/deinit when the output from [[Process_Manager_services|pm:bm]] GetBootMode is 0 (Normal).
When initializing [[SSL_services|ssl]], when the input flag is 0 it uses SslVersion = {ApiVersion | Auto}, while when flag is set it uses {ApiVersion | <each flag bit for TLS 1.0-1.2>}. The input flag is set when [[Process_Manager_services|pm:bm]] GetBootMode output is 1 or 2 (Maintenance/SafeMode), otherwise it's 0.
nnMain calls a savedata init func with an input flag determined with the output from [[Process_Manager_services|pm:bm]] GetBootMode. flag=0 for BootMode Normal, flag=1 for BootMode non-Normal. When flag is set, it deletes the savedata for savedata [[Flash_Filesystem|nim_sys]], returning the error on failure. Regardless of flag, it then calls a func which handles mounting savedata nim_sys (and creating it if needed). After checking error and calling another func (with error check), if flag is clear it proceeds with handling other savedata etc, otherwise it calls a func (also called with flag=0 once finished) then returns.
Various hosted services require BootMode Normal, see above.
== Contents Delivery ==
Content can be transferred with a custom protocol over the network. This is intended for use with local [[LDN_services|ldn]] networks, however the used IP addresses can be arbitrary. This can be used for SystemUpdates via the above Send/Receive commands (which are then used via [[NS_Services#ns:su|ns:su]]). Application Patch content can also be transferred with this.
Content can be transferred with a custom protocol over the network. This is intended for use with local [[LDN_services|ldn]] networks, however the used IP addresses can be arbitrary. This can be used for SystemUpdates via the above Send/Receive commands (which are then used via [[NS_Services#ns:su|ns:su]]). Application Patch content can also be transferred with this.
See [[#Cmd69]]/[[#Cmd76]] 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 [[#Cmd72|thread]] does the following:
The Receive async [[#RequestLocalCommunicationReceiveSystemUpdateTaskRun|thread]] does the following:
* Sets the <code>nn::fs::PriorityRaw</code> using a value loaded from state.
* 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.
** This handles installation, with messages being used via vtable funcptrs.
** This handles installation, with messages being used via vtable funcptrs.
The Send async [[#Cmd77|thread]] does the following (the SendApplication [[#Cmd61|thread]] is identical except it uses different previously setup state):
The Send async [[#RequestLocalCommunicationSendSystemUpdateTaskRun|thread]] does the following (the SendApplication [[#RequestLocalCommunicationSendApplicationTaskRun|thread]] is identical except it uses different previously setup state):
* This is identical to the Receive thread except the called func is different.
* This is identical to the Receive thread except the called func is different.
** That func does:
** That func does:
* Enters a loop which repeatedly calls a func. If that func fails, this will immediately return.
* Enters a loop which repeatedly calls a func. If that func fails, this will immediately return.
* Within that loop the following is done:
* Within that loop the following is done:
** sockfd = accept(listen_sockfd, &sockaddr_in, &addrlen); {handle error on fail - listen_sockfd is the saved sockfd from [[#Cmd76]]}
** sockfd = accept(listen_sockfd, &sockaddr_in, &addrlen); {handle error on fail - listen_sockfd is the saved sockfd from [[#CreateLocalCommunicationSendSystemUpdateTask]]}
** Exits the loop when the ipaddr within sockaddr_in matches the saved ipaddr in state from [[#Cmd76]] (originally from the cmd input param). Otherwise, close sockfd and continue the loop (with the above func being called again).
** Exits the loop when the ipaddr within sockaddr_in matches the saved ipaddr in state from [[#CreateLocalCommunicationSendSystemUpdateTask]] (originally from the cmd input param). Otherwise, close sockfd and continue the loop (with the above func being called again).
* The following is done after the loop:
* The following is done after the loop:
* u64 tmpval=1; setsockopt(sockfd, SOL_SOCKET, SO_VENDOR + 0x1, &tmpval, sizeof(tmpval)); {handle error on fail}
* u64 tmpval=1; setsockopt(sockfd, SOL_SOCKET, SO_VENDOR + 0x1, &tmpval, sizeof(tmpval)); {handle error on fail}
| 0x0 || 0x0 || 0x0 || Tells the server to exit. When handling this the handler func will immediately return 0, without sending a reply.
| 0x0 || 0x0 || 0x0 || Tells the server to exit. When handling this the handler func will immediately return 0, without sending a reply.
|-
|-
| 0x1 || [[NCM_services#ContentMetaKey|ContentMetaKey]] || [[CNMT#Content_Records|PackagedContentInfo]] || Gets the PackagedContentInfo with type==Meta for the specified ContentMetaKey. The SystemUpdate client uses the ContentMetaKey from [[#Cmd69]].
| 0x1 || [[NCM_services#ContentMetaKey|ContentMetaKey]] || [[CNMT#Content_Records|PackagedContentInfo]] || Gets the PackagedContentInfo with type==Meta for the specified ContentMetaKey. The SystemUpdate client uses the ContentMetaKey from [[#CreateLocalCommunicationReceiveSystemUpdateTask]].
|-
|-
| 0x2 || 0x18-bytes: [[NCM_services#ContentId|ContentId]], u8 flag, u8 pad[7]. When flag is 0, during the transfer [[#SendSystemUpdateTaskInfo]] [[NS_Services#SystemUpdateProgress|SystemUpdateProgress]] current_size is increased using the size of the current chunk. Once the transfer is finished, the end result is that it would be increased by the total content-size. The only time the nim client sets this flag to 1 with SystemUpdate is with the SystemUpdate Meta content. || Size from [[NCM_services#GetSizeFromContentId|GetSizeFromContentId]] with data from [[NCM_services#ReadContentIdFile|ReadContentIdFile]]. || Gets the entire content data for the specified ContentId. The client uses each received chunk of data during the transfer with [[NCM_services|WritePlaceHolder]].
| 0x2 || 0x18-bytes: [[NCM_services#ContentId|ContentId]], u8 flag, u8 pad[7]. When flag is 0, during the transfer [[#SendSystemUpdateTaskInfo]] [[NS_Services#SystemUpdateProgress|SystemUpdateProgress]] current_size is increased using the size of the current chunk. Once the transfer is finished, the end result is that it would be increased by the total content-size. The only time the nim client sets this flag to 1 with SystemUpdate is with the SystemUpdate Meta content. || Size from [[NCM_services#GetSizeFromContentId|GetSizeFromContentId]] with data from [[NCM_services#ReadContentIdFile|ReadContentIdFile]]. || Gets the entire content data for the specified ContentId. The client uses each received chunk of data during the transfer with [[NCM_services|WritePlaceHolder]].