Changes

Jump to navigation Jump to search

NS services (view source)

Revision as of 20:37, 14 July 2021

14,547 bytes added ,  20:37, 14 July 2021
no edit summary
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 104: Line 141:  
| 33 || ResumeApplicationDownload
 
| 33 || ResumeApplicationDownload
 
|-
 
|-
−
| 34 ||  
+
| 34 || ClearTaskStatusList
 
|-
 
|-
 
| 35 || UpdateVersionList
 
| 35 || UpdateVersionList
Line 212: Line 249:  
| 504 || [2.0.0+] RequestRegisterGameCard
 
| 504 || [2.0.0+] RequestRegisterGameCard
 
|-
 
|-
−
| 600 || [2.0.0+] CountApplicationContentMeta
+
| 600 || [2.0.0+] [[#CountApplicationContentMeta]]
 
|-
 
|-
 
| 601 || [2.0.0+] [[#ListApplicationContentMetaStatus]]
 
| 601 || [2.0.0+] [[#ListApplicationContentMetaStatus]]
Line 226: Line 263:  
| 700 || [2.0.0+] PushDownloadTaskList
 
| 700 || [2.0.0+] PushDownloadTaskList
 
|-
 
|-
−
| 701 || [2.0.0+] ClearTaskStatusList
+
| 701 || [2.0.0+] [[#ClearTaskStatusList]]
 
|-
 
|-
−
| 702 || [2.0.0+] RequestDownloadTaskList
+
| 702 || [2.0.0+] [[#RequestDownloadTaskList]]
 
|-
 
|-
−
| 703 || [2.0.0+] RequestEnsureDownloadTask
+
| 703 || [2.0.0+] [[#RequestEnsureDownloadTask]]
 
|-
 
|-
−
| 704 || [2.0.0+] ListDownloadTaskStatus
+
| 704 || [2.0.0+] [[#ListDownloadTaskStatus]]
 
|-
 
|-
 
| 705 || [2.0.0+] RequestDownloadTaskListData
 
| 705 || [2.0.0+] RequestDownloadTaskListData
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 513: Line 552:  
| 30 || [[#RequestApplicationUpdateInfo]]
 
| 30 || [[#RequestApplicationUpdateInfo]]
 
|-
 
|-
−
| 31 || [1.0.0-3.0.2]  
+
| 31 || [1.0.0-3.0.2] RequestUpdateApplication
 
|-
 
|-
 
| 32 || [[#CancelApplicationDownload]]
 
| 32 || [[#CancelApplicationDownload]]
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 699: Line 742:  
| 510 || [9.0.0+] [[#GetGameCardPlatformRegion]]
 
| 510 || [9.0.0+] [[#GetGameCardPlatformRegion]]
 
|-
 
|-
−
| 600 || CountApplicationContentMeta
+
| 600 || [[#CountApplicationContentMeta]]
 
|-
 
|-
 
| 601 || [[#ListApplicationContentMetaStatus]]
 
| 601 || [[#ListApplicationContentMetaStatus]]
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
 
|-
 
|-
−
| 701 || ClearTaskStatusList
+
| 701 || [[#ClearTaskStatusList]]
 
|-
 
|-
−
| 702 || RequestDownloadTaskList
+
| 702 || [[#RequestDownloadTaskList]]
 
|-
 
|-
−
| 703 || RequestEnsureDownloadTask
+
| 703 || [[#RequestEnsureDownloadTask]]
 
|-
 
|-
−
| 704 || ListDownloadTaskStatus
+
| 704 || [[#ListDownloadTaskStatus]]
 
|-
 
|-
 
| 705 || [[#RequestDownloadTaskListData]]
 
| 705 || [[#RequestDownloadTaskListData]]
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.
  −
 
  −
==== ListApplicationContentMetaStatusWithRightsCheck ====
  −
Same input/output as [[#ListApplicationContentMetaStatus]].
  −
 
  −
=== IDocumentInterface ===
  −
This is "nn::ns::detail::IDocumentInterface".
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 1,497: Line 1,635:  
! Cmd || Name
 
! Cmd || Name
 
|-
 
|-
−
| 21 || GetApplicationContentPath
+
| 0 || GetLaunchRequiredVersion
 
|-
 
|-
−
| 23 || ResolveApplicationContentPath
+
| 1 || UpgradeLaunchRequiredVersion
 
|-
 
|-
−
| 92 || [5.0.0+] GetRunningApplicationProgramId
+
| 35 || UpdateVersionList
−
|}
  −
 
  −
=== IDownloadTaskInterface ===
  −
This is "nn::ns::detail::IDownloadTaskInterface".
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
−
! Cmd || Name
+
| 36 || PushLaunchVersion
 
|-
 
|-
−
| 701 || ClearTaskStatusList
+
| 37 || ListRequiredVersion
 
|-
 
|-
−
| 702 || RequestDownloadTaskList
+
| 800 || RequestVersionList
 
|-
 
|-
−
| 703 || RequestEnsureDownloadTask
+
| 801 || ListVersionList
 
|-
 
|-
−
| 704 || ListDownloadTaskStatus
+
| 802 || [[#RequestVersionListData]]
 
|-
 
|-
−
| 705 || [[#RequestDownloadTaskListData]]
+
| 900 || [12.0.0+] ImportAutoUpdatePolicyJsonForDebug
 
|-
 
|-
−
| 706 || [4.0.0+] TryCommitCurrentApplicationDownloadTask
+
| 901 || [12.0.0+] ListDefaultAutoUpdatePolicy
 
|-
 
|-
−
| 707 || [4.0.0+] EnableAutoCommit
+
| 902 || [12.0.0+] ListAutoUpdatePolicyForSpecificApplication
 
|-
 
|-
−
| 708 || [4.0.0+] DisableAutoCommit
+
| 1000 || PerformAutoUpdate
 
|-
 
|-
−
| 709 || [4.0.0+] TriggerDynamicCommitEvent
+
| 1001 || [11.0.0+] ListAutoUpdateSchedule
 
|}
 
|}
   −
=== IReadOnlyApplicationRecordInterface ===
+
==== RequestVersionListData ====
−
This is "nn::ns::detail::IReadOnlyApplicationRecordInterface".
+
No input, returns an output Event handle and an [[#IAsyncValue]].
 +
 
 +
The data that can be read from the [[#IAsyncValue]] is [[#VersionListData]].
   −
This was added with [5.0.0+].
+
=== IContentManagementInterface ===
 +
This is "nn::ns::detail::IContentManagementInterface".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Cmd || Name
 
|-
 
|-
−
| 0 || HasApplicationRecord || Same as [[#IApplicationManagerInterface]] cmd 910
+
| 11 || [[#CalculateApplicationOccupiedSize]]
−
|}
  −
 
  −
=== IReadOnlyApplicationControlDataInterface ===
  −
This is "nn::ns::detail::IReadOnlyApplicationControlDataInterface".
  −
 
  −
This was added with [5.1.0+].
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
−
! Cmd || Name || Notes
+
| 43 || [[#CheckSdCardMountStatus]]
 
|-
 
|-
−
| 0 || [[#GetApplicationControlData]] || Same as [[#IApplicationManagerInterface]] cmd 400
+
| 47 || [[#GetTotalSpaceSize]]
 
|-
 
|-
−
| 1 || [[#GetApplicationDesiredLanguage]] || Same as [[#IApplicationManagerInterface]] cmd 55
+
| 48 || [[#GetFreeSpaceSize]]
 
|-
 
|-
−
| 2 || ConvertApplicationLanguageToLanguageCode || Same as [[#IApplicationManagerInterface]] cmd 59
+
| 600 || [[#CountApplicationContentMeta]]
 
|-
 
|-
−
| 3 || [[#ConvertLanguageCodeToApplicationLanguage]] || Same as [[#IApplicationManagerInterface]] cmd 60
+
| 601 || [[#ListApplicationContentMetaStatus]]
 +
|-
 +
| 605 || [[#ListApplicationContentMetaStatusWithRightsCheck]]
 
|-
 
|-
−
| 4 || [9.0.0+] SelectApplicationDesiredLanguage ||
+
| 607 || [[#IsAnyApplicationRunning]]
 
|}
 
|}
   −
=== IDynamicRightsInterface ===
+
==== CalculateApplicationOccupiedSize ====
−
This is "nn::ns::detail::IDynamicRightsInterface".
+
Takes an input [[NCM_services#ApplicationId|ApplicationId]], returns an output [[#ApplicationOccupiedSize]].
 +
 
 +
==== CheckSdCardMountStatus ====
 +
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.
   −
This was added with [6.0.0+].
+
=== IDocumentInterface ===
 +
This is "nn::ns::detail::IDocumentInterface".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Cmd || Name
 
|-
 
|-
−
| 0 || [[#RequestApplicationRightsOnServer]] ||  
+
| 21 || GetApplicationContentPath
 
|-
 
|-
−
| 1 || RequestAssignRights ||  
+
| 23 || ResolveApplicationContentPath
 
|-
 
|-
−
| 4 || DeprecatedRequestAssignRightsToResume ||  
+
| 92 || [5.0.0+] GetRunningApplicationProgramId
 +
|}
 +
 
 +
=== IDownloadTaskInterface ===
 +
This is "nn::ns::detail::IDownloadTaskInterface".
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 5 || VerifyActivatedRightsOwners ||  
+
! Cmd || Name
 
|-
 
|-
−
| 6 || DeprecatedGetApplicationRightsStatus ||  
+
| 701 || [[#ClearTaskStatusList]]
 
|-
 
|-
−
| 7 || RequestPrefetchForDynamicRights ||  
+
| 702 || [[#RequestDownloadTaskList]]
 
|-
 
|-
−
| 8 || GetDynamicRightsState ||  
+
| 703 || [[#RequestEnsureDownloadTask]]
 
|-
 
|-
−
| 9 || [7.0.0+] [[#RequestApplicationRightsOnServerToResume]] ||
+
| 704 || [[#ListDownloadTaskStatus]]
 
|-
 
|-
−
| 10 || [7.0.0+] RequestAssignRightsToResume ||
+
| 705 || [[#RequestDownloadTaskListData]]
 
|-
 
|-
−
| 11 || [7.0.0+] GetActivatedRightsUsers ||
+
| 706 || [4.0.0+] [[#TryCommitCurrentApplicationDownloadTask]]
 
|-
 
|-
−
| 12 || [8.0.0+] GetApplicationRightsStatus ||
+
| 707 || [4.0.0+] [[#EnableAutoCommit]]
 
|-
 
|-
−
| 13 || [8.0.0+] GetRunningApplicationStatus ||
+
| 708 || [4.0.0+] [[#DisableAutoCommit]]
 +
|-
 +
| 709 || [4.0.0+] [[#TriggerDynamicCommitEvent]]
 
|}
 
|}
   −
==== RequestApplicationRightsOnServer ====
+
==== ClearTaskStatusList ====
−
Takes a total of 0x20-bytes of input, returns an output Event handle and an [[#IAsyncValue]].
+
No input/output.
 +
 
 +
==== RequestDownloadTaskList ====
 +
No input/output.
 +
 
 +
==== RequestEnsureDownloadTask ====
 +
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.
   −
==== RequestApplicationRightsOnServerToResume ====
+
==== TriggerDynamicCommitEvent ====
−
Takes a total of 8-bytes of input, returns an output Event handle and an [[#IAsyncValue]].
+
No input/output.
   −
=== IECommerceInterface===
+
=== IReadOnlyApplicationRecordInterface ===
−
This is "nn::ns::detail::IECommerceInterface".
+
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,611: 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]]
 +
|-
 +
| 1 || [[#OpenSystemUpdateControl]]
 
|-
 
|-
−
! Cmd || Name
+
| 2 || [[#NotifyExFatDriverRequired]]
 
|-
 
|-
−
| 0 || Attach
+
| 3 || [[#ClearExFatDriverStatusForDebug]]
 
|-
 
|-
−
| 1 || BoostSystemMemoryResourceLimit
+
| 4 || [[#RequestBackgroundNetworkUpdate]]
−
|}
  −
 
  −
= ns:vm =
  −
This is "nn::ns::detail::IVulnerabilityManagerInterface".
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
−
! Cmd || Name
+
| 5 || [[#NotifyBackgroundNetworkUpdate]]
 
|-
 
|-
−
| 1200 || [3.0.0+] [[#NeedsUpdateVulnerability]]
+
| 6 || [[#NotifyExFatDriverDownloadedForDebug]]
 
|-
 
|-
−
| 1201 || [4.0.0+] [[#UpdateSafeSystemVersionForDebug]]
+
| 9 || [[#GetSystemUpdateNotificationEventForContentDelivery]]
 
|-
 
|-
−
| 1202 || [4.0.0+] [[#GetSafeSystemVersion]]
+
| 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.
   −
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 uses [[NIM_services|nim]] ListSystemUpdateTask, then when a task is returned uses it with DestroySystemUpdateTask.
   −
== GetSafeSystemVersion ==
+
Then this runs ExFat handling, updates state, and sets the same state flag as [[#RequestBackgroundNetworkUpdate]].
−
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>).
+
 
 +
== ClearExFatDriverStatusForDebug ==
 +
No input/output.
 +
 
 +
== RequestBackgroundNetworkUpdate ==
 +
No input/output.
 +
 
 +
Only usable when an [[#ISystemUpdateControl]] isn't open.
 +
 
 +
This sets a state flag to value 1.
 +
 
 +
== NotifyBackgroundNetworkUpdate ==
 +
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:
−
 
+
** Uses [[NIM_services|nim]] cmd76, returning the Result on failure.
−
== 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]] 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.
 
** Handles cleanup and returns.
 
** Handles cleanup and returns.
Line 1,910: 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 1,999: 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,075: 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,080: 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,125: 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,133: 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,350: Line 2,746:  
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
!  Value
+
!  Value
−
!  Description
+
!  Description
 +
|-
 +
| 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]]
 
|-
 
|-
−
| 1 || Unknown.
+
| 0x8 || 0x4 || Application version
 
|-
 
|-
−
| 2 || Unknown.
+
| 0xC || 0x4 || [[Process_Manager_services#LaunchFlags|LaunchFlags]], set to hard-coded value 0xB by [[#GetApplicationLaunchInfo]].
 
|-
 
|-
−
| Other values || Unknown.
+
| 0x10 || 0x1 || Application [[NCM_services#StorageId|StorageId]]
−
|}
  −
 
  −
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.
+
| 0x11 || 0x1 || Update [[NCM_services#StorageId|StorageId]]
 
|-
 
|-
−
| 0x1A || 0x6 || Unknown
+
| 0x12 || 0x2E ||  
 
|}
 
|}
    
[[Category:Services]]
 
[[Category:Services]]
Retrieved from "https://switchbrew.org/wiki/Special:MobileDiff/8805...11064"

Navigation menu