Line 23: |
Line 23: |
| |- | | |- |
| | 8 || [4.0.0+] GetAddOnContentListChangedEvent | | | 8 || [4.0.0+] GetAddOnContentListChangedEvent |
| + | |- |
| + | | 9 || [10.0.0+] GetAddOnContentLostErrorCode |
| + | |- |
| + | | 10 || [11.0.0+] GetAddOnContentListChangedEventWithProcessId |
| |- | | |- |
| | 100 || [7.0.0+] [[#IPurchaseEventManager|CreateEcPurchasedEventManager]] | | | 100 || [7.0.0+] [[#IPurchaseEventManager|CreateEcPurchasedEventManager]] |
| |- | | |- |
| | 101 || [9.0.0+] [[#IPurchaseEventManager|CreatePermanentEcPurchasedEventManager]] | | | 101 || [9.0.0+] [[#IPurchaseEventManager|CreatePermanentEcPurchasedEventManager]] |
| + | |- |
| + | | 110 || [12.0.0+] [[#IContentsServiceManager|CreateContentsServiceManager]] |
| |} | | |} |
| | | |
Line 45: |
Line 51: |
| |- | | |- |
| | 4 || [9.0.0+] PopPurchasedProductInfoWithUid | | | 4 || [9.0.0+] PopPurchasedProductInfoWithUid |
| + | |} |
| + | |
| + | == IContentsServiceManager == |
| + | This is "nn::ec::IContentsServiceManager". |
| + | |
| + | This was added with [12.0.0+]. |
| + | |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Cmd || Name |
| + | |- |
| + | | 0 || [[#RequestContentsAuthorizationToken]] |
| + | |} |
| + | |
| + | === RequestContentsAuthorizationToken === |
| + | Takes a total of 0x50-bytes of input, a PID, a type-0x5 input buffer. Returns an [[#IAsyncData|IAsyncData]] and an output handle. |
| + | |
| + | == IAsyncData == |
| + | This is "nn::ec::detail::IAsyncData". |
| + | |
| + | This was added with [12.0.0+]. |
| + | |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Cmd || Name |
| + | |- |
| + | | 0 || GetSize |
| + | |- |
| + | | 1 || Get |
| + | |- |
| + | | 2 || Cancel |
| |} | | |} |
| | | |
Line 82: |
Line 119: |
| | 17 || ListApplicationRecordContentMeta | | | 17 || ListApplicationRecordContentMeta |
| |- | | |- |
− | | 18 || | + | | 18 || CheckLaunchRights |
| |- | | |- |
| | 19 || [[#LaunchApplication]] | | | 19 || [[#LaunchApplication]] |
Line 426: |
Line 463: |
| |} | | |} |
| | | |
− | = ns:am2, ns:ec, ns:rid, ns:rt, ns:web = | + | = ns:am2, ns:ec, ns:rid, ns:rt, ns:web, ns:ro = |
| These services are all, at the top level, "nn::ns::detail::IServiceGetterInterface". These commands check a state field for a command-specific bit and returns an error if not set, this is likely a permissions check for service+command. | | These services are all, at the top level, "nn::ns::detail::IServiceGetterInterface". These commands check a state field for a command-specific bit and returns an error if not set, this is likely a permissions check for service+command. |
| + | |
| + | [11.0.0+] ns:ro was added. |
| | | |
| {| class="wikitable" border="1" | | {| class="wikitable" border="1" |
Line 433: |
Line 472: |
| ! Cmd || Name | | ! Cmd || Name |
| |- | | |- |
− | | 7988 || [6.0.0+] [[#IDynamicRightsInterface|GetDynamicRightsInterface]]. | + | | 7988 || [6.0.0+] [[#IDynamicRightsInterface|GetDynamicRightsInterface]] |
| |- | | |- |
− | | 7989 || [5.1.0+] [[#IReadOnlyApplicationControlDataInterface|GetReadOnlyApplicationControlDataInterface]]. | + | | 7989 || [5.1.0+] [[#IReadOnlyApplicationControlDataInterface|GetReadOnlyApplicationControlDataInterface]] |
| |- | | |- |
− | | 7991 || [5.0.0+] [[#IReadOnlyApplicationRecordInterface|GetReadOnlyApplicationRecordInterface]]. | + | | 7991 || [5.0.0+] [[#IReadOnlyApplicationRecordInterface|GetReadOnlyApplicationRecordInterface]] |
| |- | | |- |
| | 7992 || [4.0.0+] [[#IECommerceInterface|GetECommerceInterface]] | | | 7992 || [4.0.0+] [[#IECommerceInterface|GetECommerceInterface]] |
Line 491: |
Line 530: |
| | 8 || [[#IsApplicationEntityMovable]] | | | 8 || [[#IsApplicationEntityMovable]] |
| |- | | |- |
− | | 9 || [[#MoveApplicationEntity]] | + | | 9 || [1.0.0-9.2.0] [[#MoveApplicationEntity]] |
| |- | | |- |
| | 11 || [[#CalculateApplicationOccupiedSize]] | | | 11 || [[#CalculateApplicationOccupiedSize]] |
Line 613: |
Line 652: |
| | 93 || [5.0.0+] GetMainApplicationProgramIndex | | | 93 || [5.0.0+] GetMainApplicationProgramIndex |
| |- | | |- |
− | | 94 || [6.0.0+] LaunchApplication | + | | 94 || [6.0.0+] [[#LaunchApplication_2|LaunchApplication]] |
| |- | | |- |
− | | 95 || [6.0.0+] GetApplicationLaunchInfo | + | | 95 || [6.0.0+] [[#GetApplicationLaunchInfo]] |
| |- | | |- |
− | | 96 || [6.0.0+] AcquireApplicationLaunchInfo | + | | 96 || [6.0.0+] [[#AcquireApplicationLaunchInfo]] |
| |- | | |- |
| | 97 || [6.0.0+] GetMainApplicationProgramIndexByApplicationLaunchInfo | | | 97 || [6.0.0+] GetMainApplicationProgramIndexByApplicationLaunchInfo |
Line 634: |
Line 673: |
| |- | | |- |
| | 104 || [9.1.0+] [[#ResetToFactorySettingsWithPlatformRegionAuthentication]] | | | 104 || [9.1.0+] [[#ResetToFactorySettingsWithPlatformRegionAuthentication]] |
| + | |- |
| + | | 105 || [10.0.0+] [[#RequestResetToFactorySettingsSecurely]] |
| + | |- |
| + | | 106 || [10.0.0+] [[#RequestResetToFactorySettingsWithPlatformRegionAuthenticationSecurely]] |
| |- | | |- |
| | 200 || CalculateUserSaveDataStatistics | | | 200 || CalculateUserSaveDataStatistics |
Line 651: |
Line 694: |
| | 301 || PopApplicationShellEventInfo | | | 301 || PopApplicationShellEventInfo |
| |- | | |- |
− | | 302 || LaunchLibraryApplet | + | | 302 || [[#LaunchLibraryApplet]] |
| |- | | |- |
| | 303 || TerminateLibraryApplet | | | 303 || TerminateLibraryApplet |
| |- | | |- |
− | | 304 || LaunchSystemApplet | + | | 304 || [[#LaunchSystemApplet]] |
| |- | | |- |
| | 305 || TerminateSystemApplet | | | 305 || TerminateSystemApplet |
| |- | | |- |
− | | 306 || LaunchOverlayApplet | + | | 306 || [[#LaunchOverlayApplet]] |
| |- | | |- |
| | 307 || TerminateOverlayApplet | | | 307 || TerminateOverlayApplet |
Line 713: |
Line 756: |
| | 606 || [3.0.0+] GetContentMetaStorage | | | 606 || [3.0.0+] GetContentMetaStorage |
| |- | | |- |
− | | 607 || [6.0.0+] ListAvailableAddOnContent | + | | 607 || [6.0.0+] [[#ListAvailableAddOnContent]] |
| |- | | |- |
| | 700 || PushDownloadTaskList | | | 700 || PushDownloadTaskList |
Line 764: |
Line 807: |
| |- | | |- |
| | 915 || [9.0.0+] ShowApplicationRecord | | | 915 || [9.0.0+] ShowApplicationRecord |
| + | |- |
| + | | 916 || [11.0.0+] IsApplicationAutoDeleteDisabled |
| |- | | |- |
| | 1000 || [[#RequestVerifyApplicationDeprecated]] | | | 1000 || [[#RequestVerifyApplicationDeprecated]] |
Line 769: |
Line 814: |
| | 1001 || CorruptApplicationForDebug | | | 1001 || CorruptApplicationForDebug |
| |- | | |- |
− | | 1002 || [3.0.0+] [[#RequestVerifyAddOnContentsRights]] | + | | 1002 || [3.0.0-9.2.0] [[#RequestVerifyAddOnContentsRights]] |
| |- | | |- |
| | 1003 || [5.0.0+] [[#RequestVerifyApplication]] | | | 1003 || [5.0.0+] [[#RequestVerifyApplication]] |
Line 783: |
Line 828: |
| | 1302 || CleanupUnrecordedApplicationEntity | | | 1302 || CleanupUnrecordedApplicationEntity |
| |- | | |- |
− | | 1303 || [3.0.0+] CleanupAddOnContentsWithNoRights | + | | 1303 || [3.0.0-9.2.0] CleanupAddOnContentsWithNoRights |
| |- | | |- |
| | 1304 || [3.0.0+] DeleteApplicationContentEntity | | | 1304 || [3.0.0+] DeleteApplicationContentEntity |
Line 791: |
Line 836: |
| | 1309 || [6.0.0+] [[#CleanupUnavailableAddOnContents]] | | | 1309 || [6.0.0+] [[#CleanupUnavailableAddOnContents]] |
| |- | | |- |
− | | 1400 || PrepareShutdown | + | | 1310 || [10.0.0+] RequestMoveApplicationEntity |
| + | |- |
| + | | 1311 || [10.0.0+] EstimateSizeToMove |
| + | |- |
| + | | 1312 || [10.0.0+] HasMovableEntity |
| + | |- |
| + | | 1313 || [11.0.0+] CleanupOrphanContents |
| + | |- |
| + | | 1314 || [11.0.0+] CheckPreconditionSatisfiedToMove |
| + | |- |
| + | | 1400 || PrepareShutdown |
| |- | | |- |
| | 1500 || [[#FormatSdCard]] | | | 1500 || [[#FormatSdCard]] |
Line 818: |
Line 873: |
| |- | | |- |
| | 1704 || [8.0.0+] [[#GetApplicationViewWithPromotionInfo]] | | | 1704 || [8.0.0+] [[#GetApplicationViewWithPromotionInfo]] |
| + | |- |
| + | | 1705 || [11.0.0+] [[#IsPatchAutoDeletableApplication]] |
| |- | | |- |
| | 1800 || IsNotificationSetupCompleted | | | 1800 || IsNotificationSetupCompleted |
Line 891: |
Line 948: |
| | 2155 || [7.0.0+] UpdateRightsEnvironmentStatus | | | 2155 || [7.0.0+] UpdateRightsEnvironmentStatus |
| |- | | |- |
− | | 2156 || [9.0.0+] CreateRightsEnvironmentForPreomia | + | | 2156 || [10.0.0+] CreateRightsEnvironmentForMicroApplication ([9.0.0-9.2.0] CreateRightsEnvironmentForPreomia) |
| |- | | |- |
| | 2160 || [6.0.0+] AddTargetApplicationToRightsEnvironment | | | 2160 || [6.0.0+] AddTargetApplicationToRightsEnvironment |
Line 911: |
Line 968: |
| | 2199 || [6.0.0+] GetRightsEnvironmentCountForDebug | | | 2199 || [6.0.0+] GetRightsEnvironmentCountForDebug |
| |- | | |- |
− | | 2200 || [6.0.0+] GetGameCardApplicationCopyIdentifier | + | | 2200 || [6.0.0-9.2.0] GetGameCardApplicationCopyIdentifier |
| |- | | |- |
− | | 2201 || [6.0.0+] GetInstalledApplicationCopyIdentifier | + | | 2201 || [6.0.0-9.2.0] GetInstalledApplicationCopyIdentifier |
| |- | | |- |
| | 2250 || [6.0.0-6.2.0] RequestReportActiveELicence | | | 2250 || [6.0.0-6.2.0] RequestReportActiveELicence |
Line 924: |
Line 981: |
| |- | | |- |
| | 2352 || [9.0.0+] [[#RequestResolveNoDownloadRightsError]] | | | 2352 || [9.0.0+] [[#RequestResolveNoDownloadRightsError]] |
| + | |- |
| + | | 2353 || [10.0.0+] GetApplicationDownloadTaskInfo |
| + | |- |
| + | | 2354 || [11.0.0+] PrioritizeApplicationBackgroundTask |
| + | |- |
| + | | 2355 || [12.0.0+] PreferStorageEfficientUpdate |
| + | |- |
| + | | 2356 || [12.0.0+] RequestStorageEfficientUpdatePreferable |
| |- | | |- |
| | 2400 || [8.0.0+] [[#GetPromotionInfo]] | | | 2400 || [8.0.0+] [[#GetPromotionInfo]] |
Line 941: |
Line 1,006: |
| | 2511 || [9.0.0+] [[#GetApplicationResource]] | | | 2511 || [9.0.0+] [[#GetApplicationResource]] |
| |- | | |- |
− | | 2513 || [9.0.0+] LaunchPreomia | + | | 2513 || [10.0.0+] LaunchMicroApplication ([9.0.0-9.2.0] LaunchPreomia) |
| |- | | |- |
| | 2514 || [9.0.0+] ClearTaskOfAsyncTaskManager | | | 2514 || [9.0.0+] ClearTaskOfAsyncTaskManager |
| + | |- |
| + | | 2515 || [10.0.0+] CleanupAllPlaceHolderAndFragmentsIfNoTask |
| + | |- |
| + | | 2516 || [10.0.0+] EnsureApplicationCertificate |
| |- | | |- |
| | 2800 || [9.0.0+] GetApplicationIdOfPreomia | | | 2800 || [9.0.0+] GetApplicationIdOfPreomia |
| + | |- |
| + | | 3000 || [11.0.0+] [[#RegisterDeviceLockKey]] |
| + | |- |
| + | | 3001 || [11.0.0+] [[#UnregisterDeviceLockKey]] |
| + | |- |
| + | | 3002 || [11.0.0+] [[#VerifyDeviceLockKey]] |
| + | |- |
| + | | 3003 || [11.0.0+] [[#HideApplicationIcon]] |
| + | |- |
| + | | 3004 || [11.0.0+] [[#ShowApplicationIcon]] |
| + | |- |
| + | | 3005 || [11.0.0+] [[#HideApplicationTitle]] |
| + | |- |
| + | | 3006 || [11.0.0+] [[#ShowApplicationTitle]] |
| + | |- |
| + | | 3007 || [11.0.0+] [[#EnableGameCard]] |
| + | |- |
| + | | 3008 || [11.0.0+] [[#DisableGameCard]] |
| + | |- |
| + | | 3009 || [11.0.0+] [[#EnableLocalContentShare]] |
| + | |- |
| + | | 3010 || [11.0.0+] [[#DisableLocalContentShare]] |
| + | |- |
| + | | 3011 || [11.0.0+] [[#IsApplicationIconHidden]] |
| + | |- |
| + | | 3012 || [11.0.0+] [[#IsApplicationTitleHidden]] |
| + | |- |
| + | | 3013 || [11.0.0+] [[#IsGameCardEnabled]] |
| + | |- |
| + | | 3014 || [11.0.0+] [[#IsLocalContentShareEnabled]] |
| + | |- |
| + | | 9999 || [10.0.0-10.2.0] GetApplicationCertificate |
| |} | | |} |
| | | |
Line 1,040: |
Line 1,141: |
| | | |
| See [[#RequestApplicationUpdateInfo]] regarding nifm. | | See [[#RequestApplicationUpdateInfo]] regarding nifm. |
| + | |
| + | ==== LaunchApplication ==== |
| + | Takes an input u8 ProgramIndex, an input [[#ApplicationLaunchInfo]], returns an output u64. |
| + | |
| + | ==== GetApplicationLaunchInfo ==== |
| + | Takes an input [[NCM_services#ApplicationId|ApplicationId]], returns an output [[#ApplicationLaunchInfo]]. |
| + | |
| + | ==== AcquireApplicationLaunchInfo ==== |
| + | Takes an input [[NCM_services#ApplicationId|ApplicationId]], returns an output [[#ApplicationLaunchInfo]]. |
| + | |
| + | This verifies that a state flag is set and that a state field matches the input ApplicationId, throwing an error otherwise. The [[#ApplicationLaunchInfo]] from state is copied to output, then the state flag is cleared. |
| | | |
| ==== LaunchDevMenu ==== | | ==== LaunchDevMenu ==== |
Line 1,050: |
Line 1,162: |
| [[NCM_services#ncm|OpenContentMetaDatabase]] is used with StorageId = NandSystem, then IContentMetaDatabase GetLatestContentMetaKey is used with both of the above ProgramIds to verify that the cmd is successful. | | [[NCM_services#ncm|OpenContentMetaDatabase]] is used with StorageId = NandSystem, then IContentMetaDatabase GetLatestContentMetaKey is used with both of the above ProgramIds to verify that the cmd is successful. |
| | | |
− | Then if the above succeeds, the above titles are launched with the above StorageId via [[Process_Manager_services|pmshell]] LaunchProgram, with a 0.5s sleep-thread afterwards on success. | + | Then if the above succeeds, the above titles are launched with the above StorageId via [[Process_Manager_services|pmshell]] LaunchProgram ([10.0.0+] [[PGL_services#LaunchProgram|pgl]] with pgl_launch_flags=0), with a 0.5s sleep-thread afterwards on success. [[Process_Manager_services#LaunchFlags|LaunchFlags]] value 0xB is used here. |
| | | |
| ==== DeleteUserSaveDataAll ==== | | ==== DeleteUserSaveDataAll ==== |
Line 1,068: |
Line 1,180: |
| ==== UnregisterNetworkServiceAccountWithUserSaveDataDeletion ==== | | ==== UnregisterNetworkServiceAccountWithUserSaveDataDeletion ==== |
| Takes an input [[Account_services#Uid|Uid]], no output. | | Takes an input [[Account_services#Uid|Uid]], no output. |
| + | |
| + | ==== LaunchLibraryApplet ==== |
| + | Takes an input u64 [[NCM_services#ProgramId|ProgramId]], returns an output u64. |
| + | |
| + | The specified program is launched with StorageId=BuiltInSystem via [[Process_Manager_services|pmshell]] LaunchProgram ([10.0.0+] [[PGL_services#LaunchProgram|pgl]] with pgl_launch_flags=0). [[Process_Manager_services#LaunchFlags|LaunchFlags]] value 0x9 is used here. The output u64 from here is written to the output for this cmd, on success. |
| + | |
| + | This is used by [[Applet_Manager_services|AM]]. |
| + | |
| + | ==== LaunchSystemApplet ==== |
| + | No input, returns an output u64. |
| + | |
| + | A state flag must be zero, otherwise an error is thrown. When a state field is value 1, a hard-coded ProgramId for MaintenanceMenu is used. Otherwise, the ProgramId is loaded from [[System_Settings|system-setting]] <code>ns.applet!system_applet_id</code>. |
| + | |
| + | The SystemApplet is launched with StorageId=BuiltInSystem via [[Process_Manager_services|pmshell]] LaunchProgram ([10.0.0+] [[PGL_services#LaunchProgram|pgl]] with pgl_launch_flags=0). [[Process_Manager_services#LaunchFlags|LaunchFlags]] value 0x9 is used here. The output u64 from here is written to the output for this cmd, on success. |
| + | |
| + | This is used by [[Applet_Manager_services|AM]]. |
| + | |
| + | ==== LaunchOverlayApplet ==== |
| + | No input, returns an output u64. |
| + | |
| + | A state flag must be zero, otherwise an error is thrown. The ProgramId is loaded from [[System_Settings|system-setting]] <code>ns.applet!overlay_applet_id</code>. |
| + | |
| + | The OverlayApplet is launched with StorageId=BuiltInSystem via [[Process_Manager_services|pmshell]] LaunchProgram ([10.0.0+] [[PGL_services#LaunchProgram|pgl]] with pgl_launch_flags=0). [[Process_Manager_services#LaunchFlags|LaunchFlags]] value 0x9 is used here. The output u64 from here is written to the output for this cmd, on success. |
| + | |
| + | This is used by [[Applet_Manager_services|AM]]. |
| | | |
| ==== RequestDownloadApplicationControlData ==== | | ==== RequestDownloadApplicationControlData ==== |
Line 1,134: |
Line 1,271: |
| | | |
| This calls [[Filesystem_services#IDeviceOperator|fsp-srv IDeviceOperator]] GetGameCardCompatibilityType and returns the result. | | This calls [[Filesystem_services#IDeviceOperator|fsp-srv IDeviceOperator]] GetGameCardCompatibilityType and returns the result. |
| + | |
| + | ==== ListAvailableAddOnContent ==== |
| + | [10.0.0+] This now takes a total of 0x10-bytes of input instead of a total of 0x18-bytes of input. |
| | | |
| ==== RequestDownloadTaskListData ==== | | ==== RequestDownloadTaskListData ==== |
Line 1,187: |
Line 1,327: |
| ==== GetApplicationViewWithPromotionInfo ==== | | ==== GetApplicationViewWithPromotionInfo ==== |
| Takes a type-0x6 output buffer containing an array of [[#ApplicationViewWithPromotionInfo]], a type-0x5 input buffer containing an array of u64 [[NCM_services#ApplicationId|ApplicationIds]], no output. | | Takes a type-0x6 output buffer containing an array of [[#ApplicationViewWithPromotionInfo]], a type-0x5 input buffer containing an array of u64 [[NCM_services#ApplicationId|ApplicationIds]], no output. |
| + | |
| + | ==== IsPatchAutoDeletableApplication ==== |
| + | Takes an input [[NCM_services#ApplicationId|ApplicationId]], returns an output bool. |
| + | |
| + | Compares the input ApplicationId with the value of [[System_Settings|system-setting]] <code>ns.application!auto_deletable_application_id_on_not_enough_space</code>, with the bool being set to the comparsion result. |
| | | |
| ==== RequestDownloadApplicationPrepurchasedRights ==== | | ==== RequestDownloadApplicationPrepurchasedRights ==== |
Line 1,265: |
Line 1,410: |
| ** 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. | | ** 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. | | ** Handles cleanup and returns. |
− | * On success, this loads various data which is then used for saving a SystemPlayReport when a state flag is set. | + | * 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>. | | ** The EventId is "receive_app_contents" with ApplicationId <NS ProgramId>. |
| | | |
Line 1,294: |
Line 1,439: |
| ** 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. | | ** 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. | | ** Handles cleanup and returns. |
− | * On success, this loads various data which is then used for saving a SystemPlayReport when a state flag is set. | + | * 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>. | | ** The EventId is "send_app_contents" with ApplicationId <NS ProgramId>. |
| | | |
Line 1,370: |
Line 1,515: |
| Returns an [[#IApplicationResource]]. | | Returns an [[#IApplicationResource]]. |
| | | |
− | === IGameCardStopper === | + | ==== RegisterDeviceLockKey ==== |
− | This is "nn::ns::detail::IGameCardStopper". | + | Takes a type-0x5 input buffer containing an InArray of u8, no output. |
| + | |
| + | User-processes expose this with two funcs: one which uses an user-specified u8 array directly, while the other uses [[HID_services#NpadButtonSet|NpadButton]]. |
| + | |
| + | This does SHA256 hashing, etc. |
| + | |
| + | ==== UnregisterDeviceLockKey ==== |
| + | No input/output. |
| + | |
| + | Runs code identical to [[#RegisterDeviceLockKey]], except the passed buffer/size are 0. |
| | | |
− | This interface has no commands.
| + | ==== VerifyDeviceLockKey ==== |
| + | Takes a type-0x5 input buffer containing an InArray of u8, no output. |
| | | |
− | === IRequestServerStopper ===
| + | User-processes expose this with two funcs: one which uses an user-specified u8 array directly, while the other uses [[HID_services#NpadButtonSet|NpadButton]]. |
− | This is "nn::ns::detail::IRequestServerStopper".
| |
| | | |
− | This interface has no commands. | + | This runs hashing similar to [[#RegisterDeviceLockKey]], with the calculated hash being verified with the one from state. |
| | | |
− | === IProgressMonitorForDeleteUserSaveDataAll === | + | ==== HideApplicationIcon ==== |
− | This is "nn::ns::detail::IProgressMonitorForDeleteUserSaveDataAll".
| + | No input/output. |
| | | |
− | {| class="wikitable" border="1"
| + | ==== ShowApplicationIcon ==== |
− | |-
| + | No input/output. |
− | ! Cmd || Name
| + | |
− | |-
| + | ==== HideApplicationTitle ==== |
− | | 0 || GetSystemEvent
| + | No input/output. |
− | |-
| + | |
− | | 1 || IsFinished
| + | ==== ShowApplicationTitle ==== |
− | |-
| + | No input/output. |
− | | 2 || GetResult
| + | |
− | |-
| + | ==== EnableGameCard ==== |
− | | 10 || GetProgress
| + | No input/output. |
− | |}
| + | |
| + | ==== DisableGameCard ==== |
| + | No input/output. |
| + | |
| + | ==== EnableLocalContentShare ==== |
| + | No input/output. |
| | | |
− | When closing the object, official sw uses IsFinished first, asserting when the output bool is false.
| + | ==== DisableLocalContentShare ==== |
| + | No input/output. |
| | | |
− | * GetSystemEvent: No input, returns an output Event handle. [[qlaunch]] doesn't use this.
| + | ==== IsApplicationIconHidden ==== |
| + | No input, returns an output bool. |
| | | |
− | * IsFinished: No input, returns an output u8 bool.
| + | ==== IsApplicationTitleHidden ==== |
| + | No input, returns an output bool. |
| | | |
− | * GetResult: No input/output.
| + | ==== IsGameCardEnabled ==== |
| + | No input, returns an output bool. |
| | | |
− | * GetProgress: No input, returns an output [[#ProgressForDeleteUserSaveDataAll]]. Official sw writes this struct directly to object state.
| + | ==== IsLocalContentShareEnabled ==== |
| + | No input, returns an output bool. |
| | | |
− | === IProgressAsyncResult ===
| + | Various Deliver cmds now load the same flag used by this cmd (IsLocalContentShareEnabled), with an error being returned when it's not enabled. |
− | This is "nn::ns::detail::IProgressAsyncResult".
| |
| | | |
− | {| class="wikitable" border="1"
| + | === IGameCardStopper === |
− | |-
| + | This is "nn::ns::detail::IGameCardStopper". |
− | ! Cmd || Name
| + | |
− | |-
| + | This interface has no commands. |
− | | 0 || Get
| + | |
− | |-
| + | === IRequestServerStopper === |
− | | 1 || Cancel
| + | This is "nn::ns::detail::IRequestServerStopper". |
− | |-
| |
− | | 2 || GetProgress
| |
− | |-
| |
− | | 3 || GetDetailResult
| |
− | |-
| |
− | | 4 || [4.0.0+] GetErrorContext
| |
− | |}
| |
| | | |
− | === IApplicationVersionInterface ===
| + | This interface has no commands. |
− | This is "nn::ns::detail::IApplicationVersionInterface". | |
| | | |
− | This was added with [4.0.0+]. | + | === IProgressMonitorForDeleteUserSaveDataAll === |
| + | This is "nn::ns::detail::IProgressMonitorForDeleteUserSaveDataAll". |
| | | |
| {| class="wikitable" border="1" | | {| class="wikitable" border="1" |
Line 1,433: |
Line 1,589: |
| ! Cmd || Name | | ! Cmd || Name |
| |- | | |- |
− | | 0 || GetLaunchRequiredVersion | + | | 0 || GetSystemEvent |
| |- | | |- |
− | | 1 || UpgradeLaunchRequiredVersion | + | | 1 || IsFinished |
| |- | | |- |
− | | 35 || UpdateVersionList | + | | 2 || GetResult |
| |- | | |- |
− | | 36 || PushLaunchVersion | + | | 10 || GetProgress |
− | |- | + | |} |
− | | 37 || ListRequiredVersion
| + | |
− | |-
| + | When closing the object, official sw uses IsFinished first, asserting when the output bool is false. |
− | | 800 || RequestVersionList
| + | |
− | |-
| + | * GetSystemEvent: No input, returns an output Event handle. [[qlaunch]] doesn't use this. |
− | | 801 || ListVersionList
| + | |
− | |-
| + | * IsFinished: No input, returns an output u8 bool. |
− | | 802 || [[#RequestVersionListData]]
| |
− | |-
| |
− | | 1000 || PerformAutoUpdate
| |
− | |}
| |
| | | |
− | ==== RequestVersionListData ====
| + | * GetResult: No input/output. |
− | No input, returns an output Event handle and an [[#IAsyncValue]]. | |
| | | |
− | The data that can be read from the [[#IAsyncValue]] is [[#VersionListData]].
| + | * GetProgress: No input, returns an output [[#ProgressForDeleteUserSaveDataAll]]. Official sw writes this struct directly to object state. |
| | | |
− | === IContentManagementInterface === | + | === IProgressAsyncResult === |
− | This is "nn::ns::detail::IContentManagementInterface". | + | This is "nn::ns::detail::IProgressAsyncResult". |
| | | |
| {| class="wikitable" border="1" | | {| class="wikitable" border="1" |
Line 1,464: |
Line 1,615: |
| ! Cmd || Name | | ! Cmd || Name |
| |- | | |- |
− | | 11 || [[#CalculateApplicationOccupiedSize]] | + | | 0 || Get |
| |- | | |- |
− | | 43 || [[#CheckSdCardMountStatus]] | + | | 1 || Cancel |
| |- | | |- |
− | | 47 || [[#GetTotalSpaceSize]] | + | | 2 || GetProgress |
| |- | | |- |
− | | 48 || [[#GetFreeSpaceSize]] | + | | 3 || GetDetailResult |
| |- | | |- |
− | | 600 || [[#CountApplicationContentMeta]] | + | | 4 || [4.0.0+] GetErrorContext |
− | |-
| + | |} |
− | | 601 || [[#ListApplicationContentMetaStatus]]
| |
− | |-
| |
− | | 605 || [[#ListApplicationContentMetaStatusWithRightsCheck]]
| |
− | |-
| |
− | | 607 || [[#IsAnyApplicationRunning]]
| |
− | |} | |
| | | |
− | ==== CalculateApplicationOccupiedSize ==== | + | === IApplicationVersionInterface === |
− | Takes an input [[NCM_services#ApplicationId|ApplicationId]], returns an output [[#ApplicationOccupiedSize]].
| + | This is "nn::ns::detail::IApplicationVersionInterface". |
| | | |
− | ==== CheckSdCardMountStatus ====
| + | This was added with [4.0.0+]. |
− | No input/output.
| |
− | | |
− | ==== CountApplicationContentMeta ====
| |
− | Takes an input [[NCM_services#ApplicationId|ApplicationId]], returns an output s32.
| |
− | | |
− | ==== ListApplicationContentMetaStatusWithRightsCheck ====
| |
− | Same input/output as [[#ListApplicationContentMetaStatus]].
| |
− | | |
− | ==== IsAnyApplicationRunning ====
| |
− | No input, returns an output u8 bool.
| |
− | | |
− | === IDocumentInterface ===
| |
− | This is "nn::ns::detail::IDocumentInterface".
| |
| | | |
| {| class="wikitable" border="1" | | {| class="wikitable" border="1" |
Line 1,503: |
Line 1,635: |
| ! Cmd || Name | | ! Cmd || Name |
| |- | | |- |
− | | 21 || GetApplicationContentPath | + | | 0 || GetLaunchRequiredVersion |
| + | |- |
| + | | 1 || UpgradeLaunchRequiredVersion |
| |- | | |- |
− | | 23 || ResolveApplicationContentPath | + | | 35 || UpdateVersionList |
| |- | | |- |
− | | 92 || [5.0.0+] GetRunningApplicationProgramId | + | | 36 || PushLaunchVersion |
− | |}
| |
− | | |
− | === IDownloadTaskInterface ===
| |
− | This is "nn::ns::detail::IDownloadTaskInterface".
| |
− | | |
− | {| class="wikitable" border="1"
| |
| |- | | |- |
− | ! Cmd || Name
| + | | 37 || ListRequiredVersion |
| |- | | |- |
− | | 701 || [[#ClearTaskStatusList]] | + | | 800 || RequestVersionList |
| |- | | |- |
− | | 702 || [[#RequestDownloadTaskList]] | + | | 801 || ListVersionList |
| |- | | |- |
− | | 703 || [[#RequestEnsureDownloadTask]] | + | | 802 || [[#RequestVersionListData]] |
| |- | | |- |
− | | 704 || [[#ListDownloadTaskStatus]] | + | | 900 || [12.0.0+] ImportAutoUpdatePolicyJsonForDebug |
| |- | | |- |
− | | 705 || [[#RequestDownloadTaskListData]] | + | | 901 || [12.0.0+] ListDefaultAutoUpdatePolicy |
| |- | | |- |
− | | 706 || [4.0.0+] [[#TryCommitCurrentApplicationDownloadTask]] | + | | 902 || [12.0.0+] ListAutoUpdatePolicyForSpecificApplication |
| |- | | |- |
− | | 707 || [4.0.0+] [[#EnableAutoCommit]] | + | | 1000 || PerformAutoUpdate |
− | |-
| |
− | | 708 || [4.0.0+] [[#DisableAutoCommit]]
| |
| |- | | |- |
− | | 709 || [4.0.0+] [[#TriggerDynamicCommitEvent]] | + | | 1001 || [11.0.0+] ListAutoUpdateSchedule |
| |} | | |} |
| | | |
− | ==== ClearTaskStatusList ==== | + | ==== RequestVersionListData ==== |
− | No input/output. | + | No input, returns an output Event handle and an [[#IAsyncValue]]. |
| | | |
− | ==== RequestDownloadTaskList ====
| + | The data that can be read from the [[#IAsyncValue]] is [[#VersionListData]]. |
− | No input/output.
| |
| | | |
− | ==== RequestEnsureDownloadTask ==== | + | === IContentManagementInterface === |
− | No input, returns an output Event handle and an [[#IAsyncResult]].
| + | This is "nn::ns::detail::IContentManagementInterface". |
| | | |
− | ==== ListDownloadTaskStatus ==== | + | {| class="wikitable" border="1" |
− | Takes a type-0x6 output buffer containing an array of [[#DownloadTaskStatus]], returns an output s32 total_out.
| + | |- |
| + | ! Cmd || Name |
| + | |- |
| + | | 11 || [[#CalculateApplicationOccupiedSize]] |
| + | |- |
| + | | 43 || [[#CheckSdCardMountStatus]] |
| + | |- |
| + | | 47 || [[#GetTotalSpaceSize]] |
| + | |- |
| + | | 48 || [[#GetFreeSpaceSize]] |
| + | |- |
| + | | 600 || [[#CountApplicationContentMeta]] |
| + | |- |
| + | | 601 || [[#ListApplicationContentMetaStatus]] |
| + | |- |
| + | | 605 || [[#ListApplicationContentMetaStatusWithRightsCheck]] |
| + | |- |
| + | | 607 || [[#IsAnyApplicationRunning]] |
| + | |} |
| | | |
− | A maximum of 0x100 tasks can be stored in state.
| + | ==== CalculateApplicationOccupiedSize ==== |
| + | Takes an input [[NCM_services#ApplicationId|ApplicationId]], returns an output [[#ApplicationOccupiedSize]]. |
| | | |
− | ==== TryCommitCurrentApplicationDownloadTask ==== | + | ==== CheckSdCardMountStatus ==== |
| No input/output. | | No input/output. |
| | | |
− | ==== EnableAutoCommit ==== | + | ==== CountApplicationContentMeta ==== |
− | No input/output.
| + | Takes an input [[NCM_services#ApplicationId|ApplicationId]], returns an output s32. |
| | | |
− | ==== DisableAutoCommit ==== | + | ==== ListApplicationContentMetaStatusWithRightsCheck ==== |
− | No input/output.
| + | Same input/output as [[#ListApplicationContentMetaStatus]]. |
| | | |
− | ==== TriggerDynamicCommitEvent ==== | + | ==== IsAnyApplicationRunning ==== |
− | No input/output. | + | No input, returns an output u8 bool. |
| | | |
− | === IReadOnlyApplicationRecordInterface === | + | === IDocumentInterface === |
− | This is "nn::ns::detail::IReadOnlyApplicationRecordInterface". | + | This is "nn::ns::detail::IDocumentInterface". |
− | | |
− | This was added with [5.0.0+].
| |
| | | |
| {| class="wikitable" border="1" | | {| class="wikitable" border="1" |
| |- | | |- |
− | ! Cmd || Name || Notes | + | ! Cmd || Name |
| + | |- |
| + | | 21 || GetApplicationContentPath |
| + | |- |
| + | | 23 || ResolveApplicationContentPath |
| |- | | |- |
− | | 0 || HasApplicationRecord || Same as [[#IApplicationManagerInterface]] cmd 910 | + | | 92 || [5.0.0+] GetRunningApplicationProgramId |
| |} | | |} |
| | | |
− | === IReadOnlyApplicationControlDataInterface === | + | === IDownloadTaskInterface === |
− | This is "nn::ns::detail::IReadOnlyApplicationControlDataInterface". | + | This is "nn::ns::detail::IDownloadTaskInterface". |
− | | |
− | This was added with [5.1.0+].
| |
| | | |
| {| class="wikitable" border="1" | | {| class="wikitable" border="1" |
| |- | | |- |
− | ! Cmd || Name || Notes | + | ! Cmd || Name |
| |- | | |- |
− | | 0 || [[#GetApplicationControlData]] || Same as [[#IApplicationManagerInterface]] cmd 400 | + | | 701 || [[#ClearTaskStatusList]] |
| |- | | |- |
− | | 1 || [[#GetApplicationDesiredLanguage]] || Same as [[#IApplicationManagerInterface]] cmd 55 | + | | 702 || [[#RequestDownloadTaskList]] |
| |- | | |- |
− | | 2 || ConvertApplicationLanguageToLanguageCode || Same as [[#IApplicationManagerInterface]] cmd 59 | + | | 703 || [[#RequestEnsureDownloadTask]] |
| |- | | |- |
− | | 3 || [[#ConvertLanguageCodeToApplicationLanguage]] || Same as [[#IApplicationManagerInterface]] cmd 60 | + | | 704 || [[#ListDownloadTaskStatus]] |
| |- | | |- |
− | | 4 || [9.0.0+] SelectApplicationDesiredLanguage || | + | | 705 || [[#RequestDownloadTaskListData]] |
− | |}
| |
− | | |
− | === IDynamicRightsInterface ===
| |
− | This is "nn::ns::detail::IDynamicRightsInterface".
| |
− | | |
− | This was added with [6.0.0+].
| |
− | | |
− | {| class="wikitable" border="1"
| |
| |- | | |- |
− | ! Cmd || Name || Notes
| + | | 706 || [4.0.0+] [[#TryCommitCurrentApplicationDownloadTask]] |
| |- | | |- |
− | | 0 || [[#RequestApplicationRightsOnServer]] || | + | | 707 || [4.0.0+] [[#EnableAutoCommit]] |
| |- | | |- |
− | | 1 || RequestAssignRights || | + | | 708 || [4.0.0+] [[#DisableAutoCommit]] |
| |- | | |- |
− | | 4 || DeprecatedRequestAssignRightsToResume || | + | | 709 || [4.0.0+] [[#TriggerDynamicCommitEvent]] |
− | |-
| |
− | | 5 || VerifyActivatedRightsOwners ||
| |
− | |-
| |
− | | 6 || DeprecatedGetApplicationRightsStatus ||
| |
− | |-
| |
− | | 7 || RequestPrefetchForDynamicRights ||
| |
− | |-
| |
− | | 8 || GetDynamicRightsState ||
| |
− | |-
| |
− | | 9 || [7.0.0+] [[#RequestApplicationRightsOnServerToResume]] ||
| |
− | |-
| |
− | | 10 || [7.0.0+] RequestAssignRightsToResume ||
| |
− | |-
| |
− | | 11 || [7.0.0+] GetActivatedRightsUsers ||
| |
− | |-
| |
− | | 12 || [8.0.0+] GetApplicationRightsStatus ||
| |
− | |-
| |
− | | 13 || [8.0.0+] GetRunningApplicationStatus ||
| |
| |} | | |} |
| | | |
− | ==== RequestApplicationRightsOnServer ==== | + | ==== ClearTaskStatusList ==== |
− | Takes a total of 0x20-bytes of input, returns an output Event handle and an [[#IAsyncValue]].
| + | No input/output. |
| | | |
− | ==== RequestApplicationRightsOnServerToResume ==== | + | ==== RequestDownloadTaskList ==== |
− | Takes a total of 8-bytes of input, returns an output Event handle and an [[#IAsyncValue]].
| + | No input/output. |
| | | |
− | === IECommerceInterface=== | + | ==== RequestEnsureDownloadTask ==== |
− | This is "nn::ns::detail::IECommerceInterface". | + | No input, returns an output Event handle and an [[#IAsyncResult]]. |
| + | |
| + | ==== ListDownloadTaskStatus ==== |
| + | Takes a type-0x6 output buffer containing an array of [[#DownloadTaskStatus]], returns an output s32 total_out. |
| + | |
| + | A maximum of 0x100 tasks can be stored in state. |
| + | |
| + | ==== TryCommitCurrentApplicationDownloadTask ==== |
| + | No input/output. |
| + | |
| + | ==== EnableAutoCommit ==== |
| + | No input/output. |
| + | |
| + | ==== DisableAutoCommit ==== |
| + | No input/output. |
| + | |
| + | ==== TriggerDynamicCommitEvent ==== |
| + | No input/output. |
| + | |
| + | === IReadOnlyApplicationRecordInterface === |
| + | This is "nn::ns::detail::IReadOnlyApplicationRecordInterface". |
| | | |
− | This was added with [4.0.0+]. | + | This was added with [5.0.0+]. |
| | | |
| {| class="wikitable" border="1" | | {| class="wikitable" border="1" |
Line 1,643: |
Line 1,781: |
| ! Cmd || Name || Notes | | ! Cmd || Name || Notes |
| |- | | |- |
− | | 0 || RequestLinkDevice || Takes a total of 0x10-bytes of input, returns an [[#IAsyncResult]]. | + | | 0 || HasApplicationRecord || Same as [[#IApplicationManagerInterface]] cmd 910 |
− | |-
| |
− | | 1 || [6.0.0+] RequestCleanupAllPreInstalledApplications || No input, returns an [[#IAsyncResult]].
| |
− | |-
| |
− | | 2 || [6.0.0+] RequestCleanupPreInstalledApplication || Takes a total of 0x8-bytes of input, returns an [[#IAsyncResult]].
| |
− | |-
| |
− | | 3 || [6.0.0+] RequestSyncRights || No input, returns an [[#IAsyncResult]].
| |
− | |-
| |
− | | 4 || [6.0.0+] RequestUnlinkDevice || Takes a total of 0x10-bytes of input, returns an [[#IAsyncResult]].
| |
| |- | | |- |
− | | 5 || [6.1.0+] RequestRevokeAllELicense || Takes a total of 0x10-bytes of input, returns an [[#IAsyncResult]]. | + | | 1 || [10.0.0+] NotifyApplicationFailure || |
| |- | | |- |
− | | 6 || [9.0.0+] RequestSyncRightsBasedOnAssignedELicenses || | + | | 2 || [10.0.0+] IsDataCorruptedResult || |
| |} | | |} |
| | | |
− | === IFactoryResetInterface === | + | === IReadOnlyApplicationControlDataInterface === |
− | This is "nn::ns::detail::IFactoryResetInterface". | + | This is "nn::ns::detail::IReadOnlyApplicationControlDataInterface". |
| + | |
| + | This was added with [5.1.0+]. |
| | | |
| {| class="wikitable" border="1" | | {| class="wikitable" border="1" |
| |- | | |- |
− | ! Cmd || Name | + | ! Cmd || Name || Notes |
| |- | | |- |
− | | 100 || [[#ResetToFactorySettings]] | + | | 0 || [[#GetApplicationControlData]] || Same as [[#IApplicationManagerInterface]] cmd 400 |
| |- | | |- |
− | | 101 || [[#ResetToFactorySettingsWithoutUserSaveData]] | + | | 1 || [[#GetApplicationDesiredLanguage]] || Same as [[#IApplicationManagerInterface]] cmd 55 |
| |- | | |- |
− | | 102 || [[#ResetToFactorySettingsForRefurbishment]] | + | | 2 || ConvertApplicationLanguageToLanguageCode || Same as [[#IApplicationManagerInterface]] cmd 59 |
| |- | | |- |
− | | 103 || [9.1.0+] [[#ResetToFactorySettingsWithPlatformRegion]] | + | | 3 || [[#ConvertLanguageCodeToApplicationLanguage]] || Same as [[#IApplicationManagerInterface]] cmd 60 |
| |- | | |- |
− | | 104 || [9.1.0+] [[#ResetToFactorySettingsWithPlatformRegionAuthentication]] | + | | 4 || [9.0.0+] SelectApplicationDesiredLanguage || |
| |} | | |} |
| | | |
− | ==== ResetToFactorySettings ==== | + | === IDynamicRightsInterface === |
− | No input/output.
| + | This is "nn::ns::detail::IDynamicRightsInterface". |
| | | |
− | As of [9.1.0] this is the only [[#IFactoryResetInterface]] cmd used by [[qlaunch]].
| + | This was added with [6.0.0+]. |
| | | |
− | ==== ResetToFactorySettingsWithoutUserSaveData ==== | + | {| class="wikitable" border="1" |
− | No input/output. | + | |- |
− | | + | ! Cmd || Name |
− | ==== ResetToFactorySettingsForRefurbishment ==== | + | |- |
− | No input/output. | + | | 0 || [[#RequestApplicationRightsOnServer]] |
− | | + | |- |
− | ==== ResetToFactorySettingsWithPlatformRegion ==== | + | | 1 || [[#RequestAssignRights]] |
− | No input/output. | + | |- |
− | | + | | 4 || [[#DeprecatedRequestAssignRightsToResume]] |
− | ==== ResetToFactorySettingsWithPlatformRegionAuthentication ==== | + | |- |
− | No input/output. | + | | 5 || [[#VerifyActivatedRightsOwners]] |
− | | + | |- |
− | === IApplicationResource === | + | | 6 || [[#DeprecatedGetApplicationRightsStatus]] |
− | This is "nn::ns::detail::IApplicationResource". | + | |- |
− | | + | | 7 || [[#RequestPrefetchForDynamicRights]] |
− | This was added with [9.0.0+]. | + | |- |
− | | + | | 8 || [[#GetDynamicRightsState]] |
− | {| class="wikitable" border="1" | + | |- |
| + | | 9 || [7.0.0+] [[#RequestApplicationRightsOnServerToResume]] |
| + | |- |
| + | | 10 || [7.0.0+] [[#RequestAssignRightsToResume]] |
| + | |- |
| + | | 11 || [7.0.0+] [[#GetActivatedRightsUsers]] |
| + | |- |
| + | | 12 || [8.0.0+] [[#GetApplicationRightsStatus]] |
| + | |- |
| + | | 13 || [8.0.0+] [[#GetRunningApplicationStatus]] |
| + | |- |
| + | | 14 || [10.0.0+] SelectApplicationLicense |
| + | |- |
| + | | 15 || [12.0.0+] [[#RequestContentsAuthorizationToken]] |
| + | |} |
| + | |
| + | ==== RequestApplicationRightsOnServer ==== |
| + | Takes an input [[NCM_services#ApplicationId|ApplicationId]], an [[Account_services#Uid|Uid]] and an u32. Returns an output Event handle and an [[#IAsyncValue]]. |
| + | |
| + | ==== RequestAssignRights ==== |
| + | Takes a type-0x5 input buffer containing an array of "nn::ns::ApplicationRightsOnServer". Returns an output Event handle and an [[#IAsyncResult]]. |
| + | |
| + | ==== DeprecatedRequestAssignRightsToResume ==== |
| + | Takes an input u64 "nn::ns::RightsEnvironmentHandle" and an [[Account_services#Uid|Uid]]. Returns an output Event handle and an [[#IAsyncResult]]. |
| + | |
| + | ==== VerifyActivatedRightsOwners ==== |
| + | Takes an input u64 "nn::ns::RightsEnvironmentHandle". No output. |
| + | |
| + | ==== DeprecatedGetApplicationRightsStatus ==== |
| + | Takes an input u64 "nn::ns::RightsEnvironmentHandle". Returns a bool "nn::ns::ApplicationRightsStatus". |
| + | |
| + | ==== RequestPrefetchForDynamicRights ==== |
| + | Takes an input [[Account_services#Uid|Uid]]. Returns an output Event handle and an [[#IAsyncResult]]. |
| + | |
| + | ==== GetDynamicRightsState ==== |
| + | No input. Returns a bool "nn::ns::DynamicRightsState". |
| + | |
| + | ==== RequestApplicationRightsOnServerToResume ==== |
| + | Takes an input u64 "nn::ns::RightsEnvironmentHandle". Returns an output Event handle and an [[#IAsyncValue]]. |
| + | |
| + | ==== RequestAssignRightsToResume ==== |
| + | Takes an input u64 "nn::ns::RightsEnvironmentHandle". Returns an output Event handle and an [[#IAsyncResult]]. |
| + | |
| + | ==== GetActivatedRightsUsers ==== |
| + | Takes an input u64 "nn::ns::RightsEnvironmentHandle". Returns a bool, an u32 and a type-0x6 output buffer containing an array of [[Account_services#Uid|Uid]]. |
| + | |
| + | ==== GetApplicationRightsStatus ==== |
| + | Takes an input "nn::ns::RightsEnvironmentHandle". Returns 2 bools "nn::ns::ApplicationRightsStatus" and "nn::ns::ApplicationLicenseType". |
| + | |
| + | ==== GetRunningApplicationStatus ==== |
| + | Takes an input u64 "nn::ns::RightsEnvironmentHandle". Returns an u32 "nn::ns::RunningApplicationStatus". |
| + | |
| + | ==== RequestContentsAuthorizationToken ==== |
| + | Takes a total of 0x50-bytes of input, a type-0x5 input buffer. Returns an [[#IAsyncData_2|IAsyncData]] and an output handle. |
| + | |
| + | ==== IAsyncData ==== |
| + | This is "nn::ns::detail::IAsyncData". |
| + | |
| + | This was added with [12.0.0+]. |
| + | |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Cmd || Name |
| + | |- |
| + | | 0 || GetSize |
| + | |- |
| + | | 1 || Get |
| + | |- |
| + | | 2 || Cancel |
| + | |- |
| + | | 3 || GetErrorContext |
| + | |} |
| + | |
| + | === IECommerceInterface=== |
| + | This is "nn::ns::detail::IECommerceInterface". |
| + | |
| + | This was added with [4.0.0+]. |
| + | |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Cmd || Name |
| + | |- |
| + | | 0 || [[#RequestLinkDevice]] |
| + | |- |
| + | | 1 || [6.0.0+] [[#RequestCleanupAllPreInstalledApplications]] |
| + | |- |
| + | | 2 || [6.0.0+] [[#RequestCleanupPreInstalledApplication]] |
| + | |- |
| + | | 3 || [6.0.0+] [[#RequestSyncRights]] |
| + | |- |
| + | | 4 || [6.0.0+] [[#RequestUnlinkDevice]] |
| + | |- |
| + | | 5 || [6.1.0+] [[#RequestRevokeAllELicense]] |
| + | |- |
| + | | 6 || [9.0.0+] [[#RequestSyncRightsBasedOnAssignedELicenses]] |
| + | |} |
| + | |
| + | ==== RequestLinkDevice ==== |
| + | Takes an input [[Account_services#Uid|Uid]], returns an output Event handle and an [[#IAsyncResult]]. |
| + | |
| + | See [[#RequestApplicationUpdateInfo]] regarding nifm. |
| + | |
| + | ==== RequestCleanupAllPreInstalledApplications ==== |
| + | No input, returns an output Event handle and an [[#IAsyncResult]]. |
| + | |
| + | ==== RequestCleanupPreInstalledApplication ==== |
| + | Takes an input [[NCM_services#ApplicationId|ApplicationId]], returns an output Event handle and an [[#IAsyncResult]]. |
| + | |
| + | ==== RequestSyncRights ==== |
| + | No input, returns an output Event handle and an [[#IAsyncResult]]. |
| + | |
| + | ==== RequestUnlinkDevice ==== |
| + | Takes an input [[Account_services#Uid|Uid]], returns an output Event handle and an [[#IAsyncResult]]. |
| + | |
| + | See [[#RequestApplicationUpdateInfo]] regarding nifm. |
| + | |
| + | ==== RequestRevokeAllELicense ==== |
| + | Takes an input [[Account_services#Uid|Uid]], returns an output Event handle and an [[#IAsyncResult]]. |
| + | |
| + | ==== RequestSyncRightsBasedOnAssignedELicenses ==== |
| + | No input, returns an output Event handle and an [[#IAsyncResult]]. |
| + | |
| + | === IFactoryResetInterface === |
| + | This is "nn::ns::detail::IFactoryResetInterface". |
| + | |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Cmd || Name |
| + | |- |
| + | | 100 || [[#ResetToFactorySettings]] |
| + | |- |
| + | | 101 || [[#ResetToFactorySettingsWithoutUserSaveData]] |
| + | |- |
| + | | 102 || [[#ResetToFactorySettingsForRefurbishment]] |
| + | |- |
| + | | 103 || [9.1.0+] [[#ResetToFactorySettingsWithPlatformRegion]] |
| + | |- |
| + | | 104 || [9.1.0+] [[#ResetToFactorySettingsWithPlatformRegionAuthentication]] |
| + | |- |
| + | | 105 || [10.0.0+] [[#RequestResetToFactorySettingsSecurely]] |
| + | |- |
| + | | 106 || [10.0.0+] [[#RequestResetToFactorySettingsWithPlatformRegionAuthenticationSecurely]] |
| + | |} |
| + | |
| + | ==== ResetToFactorySettings ==== |
| + | No input/output. |
| + | |
| + | As of [9.1.0] this is the only [[#IFactoryResetInterface]] cmd used by [[qlaunch]]. |
| + | |
| + | ==== ResetToFactorySettingsWithoutUserSaveData ==== |
| + | No input/output. |
| + | |
| + | ==== ResetToFactorySettingsForRefurbishment ==== |
| + | No input/output. |
| + | |
| + | ==== ResetToFactorySettingsWithPlatformRegion ==== |
| + | No input/output. |
| + | |
| + | ==== ResetToFactorySettingsWithPlatformRegionAuthentication ==== |
| + | No input/output. |
| + | |
| + | ==== RequestResetToFactorySettingsSecurely ==== |
| + | Takes a total of 8-bytes of input, a handle, returns an output [[#IAsyncValueAndProgress]] and a handle. |
| + | |
| + | ==== RequestResetToFactorySettingsWithPlatformRegionAuthenticationSecurely ==== |
| + | Takes a total of 0x10-bytes of input, a handle, returns an output [[#IAsyncValueAndProgress]] and a handle. |
| + | |
| + | ===== IAsyncValueAndProgress ===== |
| + | This is "nn::ns::detail::IAsyncValueAndProgress". |
| + | |
| + | This was added with [10.0.0+]. |
| + | |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Cmd || Name |
| + | |- |
| + | | 0 || GetSize |
| + | |- |
| + | | 1 || Get |
| + | |- |
| + | | 2 || Cancel |
| + | |- |
| + | | 3 || GetErrorContext |
| + | |- |
| + | | 4 || GetProgress |
| + | |} |
| + | |
| + | === IApplicationResource === |
| + | This is "nn::ns::detail::IApplicationResource". |
| + | |
| + | This was added with [9.0.0+]. |
| + | |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Cmd || Name |
| + | |- |
| + | | 0 || Attach |
| + | |- |
| + | | 1 || BoostSystemMemoryResourceLimit |
| + | |} |
| + | |
| + | = ns:vm = |
| + | This is "nn::ns::detail::IVulnerabilityManagerInterface". |
| + | |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Cmd || Name |
| + | |- |
| + | | 1200 || [3.0.0+] [[#NeedsUpdateVulnerability]] |
| + | |- |
| + | | 1201 || [4.0.0+] [[#UpdateSafeSystemVersionForDebug]] |
| + | |- |
| + | | 1202 || [4.0.0+] [[#GetSafeSystemVersion]] |
| + | |} |
| + | |
| + | == NeedsUpdateVulnerability == |
| + | No input, returns an output u8 bool flag. |
| + | |
| + | Web-applets use this command to check if the system needs an update. |
| + | |
| + | == UpdateSafeSystemVersionForDebug == |
| + | Takes an input [[NCM_services#ApplicationId|ApplicationId]] and an u32 '''version'''. |
| + | |
| + | This command is not available for retail units. On a debug unit, if the [[System_Settings|system setting]] <code>vulnerability!enable_debug</code> is set, this mounts the system savegame [[Flash_Filesystem#System_Savegames|0x8000000000000049]] as "ns_ssversion:/", opens the file "ns_ssversion:/entry" and writes the supplied [[NCM_services#ApplicationId|ApplicationId]] and '''version''' in it. |
| + | |
| + | Finally, it calls [[NCM_services#ncm|OpenContentMetaDatabase]] with [[NCM_services#StorageId|StorageId]] 3, then calls [[NCM_services#IContentMetaDatabase|GetLatestContentMetaKey]] with the supplied [[NCM_services#ApplicationId|ApplicationId]] and compares the version field from the returned [[CNMT#Content_Meta_Records|Content Meta Record]] with the supplied '''version'''. |
| + | |
| + | If the supplied '''version''' is higher than the one in NCM's database, the value returned by [[NS_Services#NeedsUpdateVulnerability|NeedsUpdateVulnerability]] is set to "true". |
| + | |
| + | == GetSafeSystemVersion == |
| + | No input, returns an output [[NCM_services#ContentMetaKey|ContentMetaKey]] with the cached contents of "ns_ssversion:/entry" ([[NCM_services#ApplicationId|ApplicationId]], u32 '''version''' and u32 '''policy''' from <code>vulnerability!needs_update_vulnerability_policy</code>). |
| + | |
| + | = ns:su = |
| + | This is "nn::ns::detail::ISystemUpdateInterface". |
| + | |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Cmd || Name |
| + | |- |
| + | | 0 || [[#GetBackgroundNetworkUpdateState]] |
| |- | | |- |
− | ! Cmd || Name
| + | | 1 || [[#OpenSystemUpdateControl]] |
| |- | | |- |
− | | 0 || Attach | + | | 2 || [[#NotifyExFatDriverRequired]] |
| |- | | |- |
− | | 1 || BoostSystemMemoryResourceLimit | + | | 3 || [[#ClearExFatDriverStatusForDebug]] |
− | |}
| |
− | | |
− | = ns:vm =
| |
− | This is "nn::ns::detail::IVulnerabilityManagerInterface".
| |
− | | |
− | {| class="wikitable" border="1"
| |
| |- | | |- |
− | ! Cmd || Name
| + | | 4 || [[#RequestBackgroundNetworkUpdate]] |
| |- | | |- |
− | | 1200 || [3.0.0+] [[#NeedsUpdateVulnerability]] | + | | 5 || [[#NotifyBackgroundNetworkUpdate]] |
| |- | | |- |
− | | 1201 || [4.0.0+] [[#UpdateSafeSystemVersionForDebug]] | + | | 6 || [[#NotifyExFatDriverDownloadedForDebug]] |
| |- | | |- |
− | | 1202 || [4.0.0+] [[#GetSafeSystemVersion]] | + | | 9 || [[#GetSystemUpdateNotificationEventForContentDelivery]] |
| + | |- |
| + | | 10 || [[#NotifySystemUpdateForContentDelivery]] |
| + | |- |
| + | | 11 || [3.0.0+] [[#PrepareShutdown]] |
| + | |- |
| + | | 12 || [3.0.0-3.0.2] |
| + | |- |
| + | | 13 || [3.0.0-3.0.2] |
| + | |- |
| + | | 14 || [3.0.0-3.0.2] |
| + | |- |
| + | | 15 || [3.0.0-3.0.2] |
| + | |- |
| + | | 16 || [4.0.0+] [[#DestroySystemUpdateTask]] |
| + | |- |
| + | | 17 || [4.0.0+] [[#RequestSendSystemUpdate]] |
| + | |- |
| + | | 18 || [4.0.0+] [[#GetSendSystemUpdateProgress]] |
| |} | | |} |
| | | |
− | == NeedsUpdateVulnerability == | + | == GetBackgroundNetworkUpdateState == |
− | No input, returns an output u8 bool flag. | + | No input, returns an output [[#BackgroundNetworkUpdateState]]. |
| | | |
− | Web-applets use this command to check if the system needs an update.
| + | This is similar to [[#HasDownloaded]], see [[#BackgroundNetworkUpdateState]]. |
| | | |
− | == UpdateSafeSystemVersionForDebug == | + | == OpenSystemUpdateControl == |
− | Takes an input [[NCM_services#ApplicationId|ApplicationId]] and an u32 '''version'''.
| + | No input, returns an [[#ISystemUpdateControl]]. |
| | | |
− | This command is not available for retail units. On a debug unit, if the [[System_Settings|system setting]] <code>vulnerability!enable_debug</code> is set, this mounts the system savegame [[Flash_Filesystem#System_Savegames|0x8000000000000049]] as "ns_ssversion:/", opens the file "ns_ssversion:/entry" and writes the supplied [[NCM_services#ApplicationId|ApplicationId]] and '''version''' in it.
| + | == NotifyExFatDriverRequired == |
| + | No input/output. |
| | | |
− | Finally, it calls [[NCM_services#ncm|OpenContentMetaDatabase]] with [[NCM_services#StorageId|StorageId]] 3, then calls [[NCM_services#IContentMetaDatabase|GetLatestContentMetaKey]] with the supplied [[NCM_services#ApplicationId|ApplicationId]] and compares the version field from the returned [[CNMT#Content_Meta_Records|Content Meta Record]] with the supplied '''version'''.
| + | Only usable when an [[#ISystemUpdateControl]] isn't open. |
| + | |
| + | This uses [[NIM_services|nim]] ListSystemUpdateTask, then when a task is returned uses it with DestroySystemUpdateTask. |
| + | |
| + | Then this runs ExFat handling, updates state, and sets the same state flag as [[#RequestBackgroundNetworkUpdate]]. |
| + | |
| + | == ClearExFatDriverStatusForDebug == |
| + | No input/output. |
| + | |
| + | == RequestBackgroundNetworkUpdate == |
| + | No input/output. |
| + | |
| + | Only usable when an [[#ISystemUpdateControl]] isn't open. |
| | | |
− | If the supplied '''version''' is higher than the one in NCM's database, the value returned by [[NS_Services#NeedsUpdateVulnerability|NeedsUpdateVulnerability]] is set to "true".
| + | This sets a state flag to value 1. |
| | | |
− | == GetSafeSystemVersion == | + | == NotifyBackgroundNetworkUpdate == |
− | No input, returns an output [[NCM_services#ContentMetaKey|ContentMetaKey]] with the cached contents of "ns_ssversion:/entry" ([[NCM_services#ApplicationId|ApplicationId]], u32 '''version''' and u32 '''policy''' from <code>vulnerability!needs_update_vulnerability_policy</code>).
| + | Takes an input [[NCM_services#ContentMetaKey|ContentMetaKey]], no output. |
| | | |
− | = ns:su =
| + | This checks whether a sysupdate is needed with the input ContentMetaKey using [[NCM_services|NCM]] commands, if not this will just return 0. Otherwise, this will then run code which is identical to [[#RequestBackgroundNetworkUpdate]]. |
− | This is "nn::ns::detail::ISystemUpdateInterface". | |
| | | |
− | {| class="wikitable" border="1"
| + | == NotifyExFatDriverDownloadedForDebug == |
− | |-
| + | No input/output. |
− | ! Cmd || Name
| |
− | |-
| |
− | | 0 || [[#GetBackgroundNetworkUpdateState]]
| |
− | |-
| |
− | | 1 || [[#OpenSystemUpdateControl]]
| |
− | |-
| |
− | | 2 || [[#NotifyExFatDriverRequired]]
| |
− | |-
| |
− | | 3 || [[#ClearExFatDriverStatusForDebug]]
| |
− | |-
| |
− | | 4 || [[#RequestBackgroundNetworkUpdate]]
| |
− | |-
| |
− | | 5 || [[#NotifyBackgroundNetworkUpdate]]
| |
− | |-
| |
− | | 6 || [[#NotifyExFatDriverDownloadedForDebug]]
| |
− | |-
| |
− | | 9 || [[#GetSystemUpdateNotificationEventForContentDelivery]]
| |
− | |-
| |
− | | 10 || [[#NotifySystemUpdateForContentDelivery]]
| |
− | |-
| |
− | | 11 || [3.0.0+] [[#PrepareShutdown]]
| |
− | |-
| |
− | | 12 || [3.0.0-3.0.2]
| |
− | |-
| |
− | | 13 || [3.0.0-3.0.2]
| |
− | |-
| |
− | | 14 || [3.0.0-3.0.2]
| |
− | |-
| |
− | | 15 || [3.0.0-3.0.2]
| |
− | |-
| |
− | | 16 || [4.0.0+] [[#DestroySystemUpdateTask]]
| |
− | |-
| |
− | | 17 || [4.0.0+] [[#RequestSendSystemUpdate]]
| |
− | |-
| |
− | | 18 || [4.0.0+] [[#GetSendSystemUpdateProgress]]
| |
− | |}
| |
| | | |
− | == GetBackgroundNetworkUpdateState == | + | == GetSystemUpdateNotificationEventForContentDelivery == |
− | No input, returns an output [[#BackgroundNetworkUpdateState]]. | + | No input, returns an output Event handle with EventClearMode=0. |
| | | |
− | This is similar to [[#HasDownloaded]], see [[#BackgroundNetworkUpdateState]].
| + | == NotifySystemUpdateForContentDelivery == |
| + | No input/output. |
| | | |
− | == OpenSystemUpdateControl ==
| + | Signals the Event returned by [[#GetSystemUpdateNotificationEventForContentDelivery]]. |
− | No input, returns an [[#ISystemUpdateControl]].
| |
| | | |
− | == NotifyExFatDriverRequired == | + | == PrepareShutdown == |
| No input/output. | | No input/output. |
| | | |
− | Only usable when an [[#ISystemUpdateControl]] isn't open.
| + | This is used by [[AM_services|AM]]. |
| | | |
− | This uses [[NIM_services|nim]] ListSystemUpdateTask, then when a task is returned uses it with DestroySystemUpdateTask.
| + | Just returns 0 when an [[#ISystemUpdateControl]] is open. |
| | | |
− | Then this runs ExFat handling, updates state, and sets the same state flag as [[#RequestBackgroundNetworkUpdate]].
| + | This does various cleanup / uses various service-cmds etc for shutdown preparation. |
| | | |
− | == ClearExFatDriverStatusForDebug == | + | == DestroySystemUpdateTask == |
− | No input/output.
| |
− | | |
− | == RequestBackgroundNetworkUpdate ==
| |
| No input/output. | | No input/output. |
| | | |
| Only usable when an [[#ISystemUpdateControl]] isn't open. | | Only usable when an [[#ISystemUpdateControl]] isn't open. |
| | | |
− | This sets a state flag to value 1. | + | This uses [[NIM_services|nim]] ListSystemUpdateTask, then when a task is returned uses it with DestroySystemUpdateTask. |
| | | |
− | == NotifyBackgroundNetworkUpdate == | + | == RequestSendSystemUpdate == |
− | Takes an input [[NCM_services#ContentMetaKey|ContentMetaKey]], no output. | + | Takes a type-0x15 input buffer containing a [[#SystemDeliveryInfo]], an u16 port, an u32 Ipv4Address, returns an output Event handle and an [[#IAsyncResult]]. |
| | | |
− | This checks whether a sysupdate is needed with the input ContentMetaKey using [[NCM_services|NCM]] commands, if not this will just return 0. Otherwise, this will then run code which is identical to [[#RequestBackgroundNetworkUpdate]].
| + | [[qlaunch]] uses value 55556 for the port. IP is normally a local-WLAN address, however this can be any address. port/addr are little-endian. |
| | | |
− | == NotifyExFatDriverDownloadedForDebug ==
| + | [[NIM_services|NIM]] will use the input addr/port with [[Sockets_services|bind()]]. During [[Sockets_services|accept()]] handling the addr from there must match the input addr. Hence, addr must be the client addr. [[NIM_services|NIM]] will also eventually verify that the system is not Internet-connected. |
− | No input/output.
| |
| | | |
− | == GetSystemUpdateNotificationEventForContentDelivery ==
| + | 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: |
− | No input, returns an output Event handle with EventClearMode=0.
| + | * Calls a func which does: |
− | | |
− | == NotifySystemUpdateForContentDelivery ==
| |
− | No input/output.
| |
− | | |
− | Signals the Event returned by [[#GetSystemUpdateNotificationEventForContentDelivery]].
| |
− | | |
− | == PrepareShutdown ==
| |
− | No input/output.
| |
− | | |
− | This is used by [[AM_services|AM]].
| |
− | | |
− | Just returns 0 when an [[#ISystemUpdateControl]] is open.
| |
− | | |
− | This does various cleanup / uses various service-cmds etc for shutdown preparation.
| |
− | | |
− | == DestroySystemUpdateTask ==
| |
− | No input/output.
| |
− | | |
− | Only usable when an [[#ISystemUpdateControl]] isn't open.
| |
− | | |
− | This uses [[NIM_services|nim]] ListSystemUpdateTask, then when a task is returned uses it with DestroySystemUpdateTask.
| |
− | | |
− | == RequestSendSystemUpdate ==
| |
− | Takes a type-0x15 input buffer containing a [[#SystemDeliveryInfo]], an u16 port, an u32 Ipv4Address, returns an output Event handle and an [[#IAsyncResult]].
| |
− | | |
− | [[qlaunch]] uses value 55556 for the port. IP is normally a local-WLAN address, however this can be any address. port/addr are little-endian.
| |
− | | |
− | [[NIM_services|NIM]] will use the input addr/port with [[Sockets_services|bind()]]. During [[Sockets_services|accept()]] handling the addr from there must match the input addr. Hence, addr must be the client addr. [[NIM_services|NIM]] will also eventually verify that the system is not Internet-connected.
| |
− | | |
− | 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: | |
− | * Calls a func which does: | |
| ** Uses [[NIM_services|nim]] cmd76, returning the Result on failure. | | ** Uses [[NIM_services|nim]] cmd76, returning the Result on failure. |
| ** Uses [[NIM_services|nim]] cmd77, returning the Result on failure. Waits for the IAsyncResult operation from this to finish, then uses the Get cmd to get the output Result. | | ** Uses [[NIM_services|nim]] cmd77, returning the Result on failure. Waits for the IAsyncResult operation from this to finish, then uses the Get cmd to get the output Result. |
Line 1,942: |
Line 2,266: |
| | | |
| * Uses ListSystemUpdateTask again, then [[NIM_services|nim]] IsExFatDriverIncluded. Runs ExFat handling when the output flag is set. | | * Uses ListSystemUpdateTask again, then [[NIM_services|nim]] IsExFatDriverIncluded. Runs ExFat handling when the output flag is set. |
− | * On newer system-versions, this uses [[NIM_services|nim]] GetSystemUpdateTaskInfo then on success uses data from there to save a SystemPlayReport when a state flag is set (by default it's not set). | + | * On newer system-versions, this uses [[NIM_services|nim]] GetSystemUpdateTaskInfo then on success uses data from there to save a SystemPlayReport when the cached [[System_Settings|system-setting]] "systemreport!enabled" is set. |
| ** The EventId is "systemupdate_dl_throughput" with ApplicationId 0100000000001018. | | ** The EventId is "systemupdate_dl_throughput" with ApplicationId 0100000000001018. |
− | ** The following fields are added to the report, see [[NIM_services#SystemUpdateTaskInfo|nim SystemUpdateTaskInfo]]: "ContentMetaId", "Version", "DownloadSize", and "ThroughputKBps", | + | ** The following fields are added to the report, see [[NIM_services#SystemUpdateTaskInfo|nim SystemUpdateTaskInfo]]: "ContentMetaId", "Version", "DownloadSize", and "ThroughputKBps". |
| * On newer system-versions, this saves another SystemPlayReport when a state flag is set (same flag mentioned above). | | * On newer system-versions, this saves another SystemPlayReport when a state flag is set (same flag mentioned above). |
| ** The EventId is "systemupdate_pass" with ApplicationId 0100000000001021. | | ** The EventId is "systemupdate_pass" with ApplicationId 0100000000001021. |
Line 2,031: |
Line 2,355: |
| ** Uses [[NIM_services|nim]] cmd72, returning the Result on failure. Waits for the IAsyncResult operation from this to finish, then uses the Get cmd to get the output Result. | | ** Uses [[NIM_services|nim]] cmd72, 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. | | ** Handles cleanup and returns. |
− | * On success, this loads various data which is then used for saving a SystemPlayReport when a state flag is set. | + | * 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_system_update" with ApplicationId <NS ProgramId>. | | ** The EventId is "receive_system_update" with ApplicationId <NS ProgramId>. |
| + | ** This report has the following fields: |
| + | *** "SourceSystemUpdateId" |
| + | *** "DestinationSystemUpdateId" |
| + | *** "SourceSystemUpdateVersion" |
| + | *** "DestinationSystemUpdateVersion" |
| + | *** "SenderFirmwareVariationId" |
| + | *** "ReceiverFirmwareVariationId" |
| + | *** "SenderPlatformRegion" |
| + | *** "ReceiverPlatformRegion" |
| + | *** "SenderHasExFat" |
| + | *** "ReceiverHasExFat" |
| + | *** "Size" |
| + | *** "ThroughputKBps" |
| | | |
| === GetReceiveProgress === | | === GetReceiveProgress === |
Line 2,107: |
Line 2,444: |
| = ns:dev = | | = ns:dev = |
| This is "nn::ns::detail::IDevelopInterface". | | This is "nn::ns::detail::IDevelopInterface". |
| + | |
| + | [10.0.0+] Some of these cmds were replaced by the [[PGL_services|pgl]] system module. |
| | | |
| {| class="wikitable" border="1" | | {| class="wikitable" border="1" |
Line 2,112: |
Line 2,451: |
| ! Cmd || Name | | ! Cmd || Name |
| |- | | |- |
− | | 0 || [[#LaunchProgram]] | + | | 0 || [1.0.0-9.2.0] [[#LaunchProgram]] |
| |- | | |- |
| | 1 || [[#TerminateProcess]] | | | 1 || [[#TerminateProcess]] |
| |- | | |- |
− | | 2 || [[#TerminateProgram]] | + | | 2 || [1.0.0-9.2.0] [[#TerminateProgram]] |
| |- | | |- |
− | | 4 || [[#GetShellEvent]] | + | | 4 || [1.0.0-9.2.0] [[#GetShellEvent]] |
| |- | | |- |
− | | 5 || [[#GetShellEventInfo]] | + | | 5 || [1.0.0-9.2.0] [[#GetShellEventInfo]] |
| |- | | |- |
| | 6 || [[#TerminateApplication]] | | | 6 || [[#TerminateApplication]] |
| |- | | |- |
− | | 7 || [[#PrepareLaunchProgramFromHost]] | + | | 7 || [1.0.0-9.2.0] [[#PrepareLaunchProgramFromHost]] |
| |- | | |- |
− | | 8 || [[#LaunchApplicationForDevelop]] | + | | 8 || [10.0.0+] [[#LaunchApplicationFromHost]] ([1.0.0-9.2.0] [[#LaunchApplicationForDevelop]]) |
| |- | | |- |
| | 9 || [[#LaunchApplicationWithStorageIdForDevelop]] | | | 9 || [[#LaunchApplicationWithStorageIdForDevelop]] |
| |- | | |- |
− | | 10 || [6.0.0-8.1.0] IsSystemMemoryResourceLimitBoosted | + | | 10 || [6.0.0-8.1.0] [[#IsSystemMemoryResourceLimitBoosted]] |
| |- | | |- |
− | | 11 || [6.0.0+] GetRunningApplicationProcessIdForDevelop | + | | 11 || [6.0.0+] [[#GetRunningApplicationProcessIdForDevelop]] |
| |- | | |- |
− | | 12 || [6.0.0+] SetCurrentApplicationRightsEnvironmentCanBeActiveForDevelop | + | | 12 || [6.0.0+] [[#SetCurrentApplicationRightsEnvironmentCanBeActiveForDevelop]] |
| |- | | |- |
| | 13 || [9.0.0+] [[#CreateApplicationResourceForDevelop]] | | | 13 || [9.0.0+] [[#CreateApplicationResourceForDevelop]] |
| |- | | |- |
| | 14 || [9.0.0+] [[#IsPreomiaForDevelop]] | | | 14 || [9.0.0+] [[#IsPreomiaForDevelop]] |
| + | |- |
| + | | 15 || [10.0.0+] [[#GetApplicationProgramIdFromHost]] |
| + | |- |
| + | | 16 || [12.0.0+] RefreshCachedDebugValues |
| + | |- |
| + | | 17 || [12.0.0+] PrepareLaunchApplicationFromHost |
| + | |- |
| + | | 18 || [12.0.0+] GetLaunchEvent |
| + | |- |
| + | | 19 || [12.0.0+] GetLaunchResult |
| |} | | |} |
| | | |
Line 2,157: |
Line 2,506: |
| | | |
| == TerminateApplication == | | == TerminateApplication == |
− | Calls "pm:shell" [[Process_Manager_services#pm:shell|GetApplicationProcessIdForShell]] and sends PID to [[Process_Manager_services#pm:shell|TerminateProcess]]. | + | Calls "pm:shell" [[Process_Manager_services#pm:shell|GetApplicationProcessIdForShell]] and sends the ProcessId to [[Process_Manager_services#pm:shell|TerminateProcess]]. |
| | | |
| == PrepareLaunchProgramFromHost == | | == PrepareLaunchProgramFromHost == |
Line 2,165: |
Line 2,514: |
| | | |
| == LaunchApplicationForDevelop == | | == LaunchApplicationForDevelop == |
− | Takes an input u32 [[Process_Manager_services#LaunchFlags|LaunchFlags]] and [[NCM_services#ApplicationId|ApplicationId]], returns an output u64 PID. | + | Takes an input u32 [[Process_Manager_services#LaunchFlags|LaunchFlags]] and [[NCM_services#ApplicationId|ApplicationId]], returns an output u64 ProcessId. |
| + | |
| + | Same as [[#LaunchApplicationWithStorageIdForDevelop]] except the last two params passed to the internal vtable funcptr call are value 0x6, instead of from the command input. |
| | | |
− | Same as LaunchApplicationWithStorageId except the last two params passed to the internal vtable funcptr call are value 0x6, instead of from the command input.
| + | == LaunchApplicationFromHost == |
| + | Takes an input u32 [[Process_Manager_services#LaunchFlags|LaunchFlags]] and a type-0x5 input buffer containing the [[Filesystem_services|ContentPath]]. Returns an output u64 ProcessId. |
| | | |
| == LaunchApplicationWithStorageIdForDevelop == | | == LaunchApplicationWithStorageIdForDevelop == |
− | Takes 2 input u8s, an u32 [[Process_Manager_services#LaunchFlags|LaunchFlags]], and an [[NCM_services#ApplicationId|ApplicationId]]. Returns an output u64 PID. | + | Takes 2 input u8 [[NCM_services#StorageId|StorageIds]], an u32 [[Process_Manager_services#LaunchFlags|LaunchFlags]], and an [[NCM_services#ApplicationId|ApplicationId]]. Returns an output u64 ProcessId. |
| | | |
| Launches an application title which is registered with NS. | | Launches an application title which is registered with NS. |
| + | |
| + | == IsSystemMemoryResourceLimitBoosted == |
| + | No input. Returns a bool. |
| + | |
| + | == GetRunningApplicationProcessIdForDevelop == |
| + | Returns an output u64 ProcessId. |
| + | |
| + | == SetCurrentApplicationRightsEnvironmentCanBeActiveForDevelop == |
| + | Takes an input bool. No output. |
| | | |
| == CreateApplicationResourceForDevelop == | | == CreateApplicationResourceForDevelop == |
− | Takes an input u32 (1 = Preomia). Returns an [[#IApplicationResource]]. | + | Takes an input u32 (1 = Preomia/MicroApplication). Returns an [[#IApplicationResource]]. |
| | | |
| == IsPreomiaForDevelop == | | == IsPreomiaForDevelop == |
− | Takes an u64 [[NCM_services#ProgramId|ProgramId]]. Returns a bool. | + | Takes an input u64 [[NCM_services#ProgramId|ProgramId]]. Returns a bool. |
| + | |
| + | == GetApplicationProgramIdFromHost == |
| + | Takes a type-0x5 input buffer containing the [[Filesystem_services|ContentPath]]. Returns an u64 [[NCM_services#ProgramId|ProgramId]]. |
| | | |
| = VersionListData = | | = VersionListData = |
Line 2,385: |
Line 2,749: |
| ! Description | | ! Description |
| |- | | |- |
− | | 1 || Unknown. | + | | 1 || Unknown. |
| + | |- |
| + | | 2 || Unknown. |
| + | |- |
| + | | Other values || Unknown. |
| + | |} |
| + | |
| + | This is "nn::ns::LatestSystemUpdate". This is an u8. |
| + | |
| + | = ReceiveApplicationProgress = |
| + | This is "nn::ns::ReceiveApplicationProgress". This is a 0x10-byte struct. |
| + | |
| + | = SendApplicationProgress = |
| + | This is "nn::ns::SendApplicationProgress". This is a 0x10-byte struct. |
| + | |
| + | = ApplicationRightsOnClient = |
| + | This is a 0x20-byte struct. |
| + | |
| + | [[qlaunch]] only uses +0x18/+0x19 in this struct. |
| + | |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Offset |
| + | ! Size |
| + | ! Description |
| + | |- |
| + | | 0x0 || 0x8 || [[NCM_services#ApplicationId|ApplicationId]] |
| + | |- |
| + | | 0x8 || 0x10 || [[Account_services#Uid|Uid]] |
| + | |- |
| + | | 0x18 || 0x1 || Flags, [[qlaunch]] only uses bit0-bit4 and bit7. |
| + | |- |
| + | | 0x19 || 0x1 || Flags, [[qlaunch]] only uses bit0. |
| + | |- |
| + | | 0x1A || 0x6 || Unknown |
| + | |} |
| + | |
| + | = DownloadTaskStatus = |
| + | This is "nn::ns::DownloadTaskStatus". This is a 0x20-byte struct. |
| + | |
| + | = ApplicationLaunchInfo = |
| + | This is a 0x40-byte struct. |
| + | |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Offset |
| + | ! Size |
| + | ! Description |
| + | |- |
| + | | 0x0 || 0x8 || [[NCM_services#ApplicationId|ApplicationId]] |
| |- | | |- |
− | | 2 || Unknown. | + | | 0x8 || 0x4 || Application version |
| |- | | |- |
− | | Other values || Unknown. | + | | 0xC || 0x4 || [[Process_Manager_services#LaunchFlags|LaunchFlags]], set to hard-coded value 0xB by [[#GetApplicationLaunchInfo]]. |
− | |}
| |
− | | |
− | This is "nn::ns::LatestSystemUpdate". This is an u8.
| |
− | | |
− | = ReceiveApplicationProgress =
| |
− | This is "nn::ns::ReceiveApplicationProgress". This is a 0x10-byte struct.
| |
− | | |
− | = SendApplicationProgress =
| |
− | This is "nn::ns::SendApplicationProgress". This is a 0x10-byte struct.
| |
− | | |
− | = ApplicationRightsOnClient =
| |
− | This is a 0x20-byte struct.
| |
− | | |
− | [[qlaunch]] only uses +0x18/+0x19 in this struct.
| |
− | | |
− | {| class="wikitable" border="1"
| |
− | |-
| |
− | ! Offset
| |
− | ! Size
| |
− | ! Description
| |
− | |-
| |
− | | 0x0 || 0x8 || [[NCM_services#ApplicationId|ApplicationId]]
| |
− | |-
| |
− | | 0x8 || 0x10 || [[Account_services#Uid|Uid]]
| |
| |- | | |- |
− | | 0x18 || 0x1 || Flags, [[qlaunch]] only uses bit0-bit4 and bit7. | + | | 0x10 || 0x1 || Application [[NCM_services#StorageId|StorageId]] |
| |- | | |- |
− | | 0x19 || 0x1 || Flags, [[qlaunch]] only uses bit0. | + | | 0x11 || 0x1 || Update [[NCM_services#StorageId|StorageId]] |
| |- | | |- |
− | | 0x1A || 0x6 || Unknown | + | | 0x12 || 0x2E || |
| |} | | |} |
− |
| |
− | = DownloadTaskStatus =
| |
− | This is "nn::ns::DownloadTaskStatus". This is a 0x20-byte struct.
| |
| | | |
| [[Category:Services]] | | [[Category:Services]] |