Migration services

Migration is a sysmodule designed for handling the Switch-to-Switch transfer system introduced in firmware 4.0.0.

With newer system-versions this sysmodule is only running when qlaunch is using migration from the relevant transfer menus (see ActivateMigrationService/DeactivateMigrationService).

mig:usr

This is "nn::migration::user::IService"

Cmd	Name
0	[19.0.0+]
1	[20.0.0+]
2	[20.0.0+]
10	[7.0.0-19.0.1] TryGetLastUserMigrationInfo ([4.0.0-6.2.0] TryGetLastMigrationInfo)
11	[20.0.0+]
100	[7.0.0+] CreateUserMigrationServer ([4.0.0-6.2.0] CreateServer)
101	[7.0.0+] ResumeUserMigrationServer ([4.0.0-6.2.0] ResumeServer)
200	[7.0.0+] CreateUserMigrationClient ([4.0.0-6.2.0] CreateClient)
201	[7.0.0+] ResumeUserMigrationClient ([4.0.0-6.2.0] ResumeClient)
1001	[8.0.0+] GetSaveDataMigrationPolicyInfoAsync
1010	[7.0.0+] TryGetLastSaveDataMigrationInfo
1100	[7.0.0-19.0.1] CreateSaveDataMigrationServer
1101	[7.0.0+] ResumeSaveDataMigrationServer
1110	[17.0.0+]
1200	[7.0.0+] CreateSaveDataMigrationClient
1201	[7.0.0+] ResumeSaveDataMigrationClient
2001	[20.0.0+]
2010	[20.0.0+]
2100	[20.0.0+]
2110	[20.0.0+]
2200	[20.0.0+]
2210	[20.0.0+]
2220	[20.0.0+]
2230	[20.0.0+]
2231	[20.0.0+]
2232	[20.0.0+]
2233	[20.0.0+]
2234	[20.0.0+]
2250	[20.0.0+]
2260	[20.0.0+]
2270	[20.0.0+]
2280	[20.0.0+]
2300	[20.0.0+]
2310	[20.0.0+]
2400	[20.0.0+]
2420	[20.0.0+]

CreateUserMigrationServer

Takes a total of 0x18-bytes of input, a type-0x19 input buffer, a TransferMemory handle, returns an #IServer.

ResumeUserMigrationServer

Takes an input u32, a TransferMemory handle, returns an #IServer.

CreateUserMigrationClient

Takes an input u32, a type-0x19 input buffer, a TransferMemory handle, returns an #IClient.

ResumeUserMigrationClient

Takes an input u32, a TransferMemory handle, returns an #IClient.

GetSaveDataMigrationPolicyInfoAsync

Takes an ApplicationId, returns an #IAsyncSaveDataMigrationPolicyInfoContext.

This is used by qlaunch before the actual savedata transfer is started.

This starts a network request for save_data_migration_policy.

CreateSaveDataMigrationServer

Takes a total of 0x20-bytes of input, a type-0x19 input buffer, a TransferMemory handle, returns an IServer.

ResumeSaveDataMigrationServer

Takes an input u32, a TransferMemory handle, returns an IServer.

Cmd1110

Takes a total of 0x18-bytes of input, a type-0x19 input buffer, a type-0x5 input buffer containing an array of u64s, and a TransferMemory handle. Returns an IServer.

This is identical to CreateSaveDataMigrationServer except the u64-array is passed directly instead of from a single input u64.

CreateSaveDataMigrationClient

Takes an input u32, a type-0x19 input buffer, a TransferMemory handle, returns an IClient.

ResumeSaveDataMigrationClient

Takes an input u32, a TransferMemory handle, returns an IClient.

Cmd2100

Takes 4-bytes of input, a type-0x19 input buffer containing a 0x100-byte struct, a handle. Returns an IUnknown0.

Cmd2110

Takes 4-bytes of input, a handle. Returns an IUnknown0.

Cmd2200

Takes 4-bytes of input, a type-0x19 input buffer containing a 0x100-byte struct, a handle. Returns an IUnknown1.

Cmd2210

Takes 4-bytes of input, a handle. Returns an IUnknown1.

Cmd2250

Takes a total of 0x18-bytes of input, a handle. Returns an IUnknown2.

Cmd2260

Takes 4-bytes of input, a handle. Returns an IUnknown2.

Cmd2280

Takes an input u64, returns an #IAsyncContext.

This starts a network request for transfer_events/%lld/rollback.

Cmd2300

Takes a total of 0x18-bytes of input, a handle. Returns an IUnknown3.

Cmd2310

Takes 4-bytes of input, a handle. Returns an IUnknown3.

Cmd2400

Takes a total of 0x10-bytes of input, a handle. Returns an IUnknown4.

Cmd2420

Takes 4-bytes of input, a handle. Returns an IUnknown4.

IServer

This is "nn::migration::user::IServer"

Cmd	Name
0	GetUid
1	GetServerProfile
100	PrepareAsync
101	GetConnectionRequirement
102	[20.0.0+]
200	WaitConnectionAsync
201	GetClientProfile
202	AcceptConnectionAsync
203	DeclineConnectionAsync
300	ProcessTransferAsync
400	CompleteAsync
500	Abort

IClient

This is "nn::migration::user::IClient"

Cmd	Name
0	GetClientProfile
10	CreateLoginSession
11	GetNetworkServiceAccountId
12	GetUserNickname
13	GetUserProfileImage
100	PrepareAsync
101	GetConnectionRequirement
102	[20.0.0+]
200	ScanServersAsync
201	ListServers
210	ConnectByServerIdAsync
300	GetStorageShortfall
301	GetTotalTransferInfo
302	GetImmigrantUid
310	GetCurrentTransferInfo
311	GetCurrentRelatedApplications
320	TransferNextAsync
350	SuspendAsync
400	CompleteAsync
500	Abort
999	DebugSynchronizeStateInFinalizationAsync

IAsyncContext

This is "nn::migration::detail::IAsyncContext".

Cmd	Name
0	GetSystemEvent
1	Cancel
2	HasDone
3	GetResult

IAsyncSaveDataMigrationPolicyInfoContext

This is "nn::migration::detail::IAsyncSaveDataMigrationPolicyInfoContext".

Cmd	Name
0	GetSystemEvent
1	Cancel
2	HasDone
3	GetResult
100	GetSaveDataMigrationPolicyInfo

IServer

This is "nn::migration::savedata::IServer".

This was added with [7.0.0+].

Cmd	Name
0	GetUid
1	[7.0.0-19.0.1] GetApplicationId
2	GetServerProfile
3	[17.0.0+] ListApplicationIds
100	PrepareAsync
101	GetConnectionRequirement
102	[20.0.0+]
200	WaitConnectionAsync
201	GetClientProfile
202	[20.0.0+]
203	[20.0.0+]
210	[8.0.0+] WaitAcceptanceAsync
300	ProcessTransferAsync
400	CompleteAsync
500	[7.0.0-19.0.1] Abort
510	[19.0.0+]
998	[8.0.0+] DebugTryGetState
999	[8.0.0+] DebugWaitStateSynchronizationFinalizedAsync

PrepareAsync

No input, returns an IAsyncContext.

Besides various other functionality, the async task also uses functionality similar to GetSaveDataMigrationPolicyInfoAsync, throwing an error if needed.

IClient

This is "nn::migration::savedata::IClient".

This was added with [7.0.0+].

Cmd	Name
0	GetClientProfile
100	GetConnectionRequirement
101	[20.0.0+]
200	ScanServersAsync
201	ListServers
210	ConnectByServerIdAsync
220	[8.0.0+] AcceptAsync
221	[8.0.0+] DeclineAsync
300	GetStorageShortfall
301	GetTotalTransferInfo
302	GetImmigrantUid
303	GetApplicationId
304	[17.0.0+] ListApplicationIds
310	GetCurrentTransferInfo
320	TransferNextAsync
350	SuspendAsync
400	CompleteAsync
500	[7.0.0-19.0.1] Abort
510	[19.0.0+]
996	[8.0.0+] DebugTryGetState
997	[8.0.0+] DebugSynchronizeStateInFinalization0Async
998	[8.0.0+] DebugSynchronizeStateInFinalization1Async
999	DebugSynchronizeStateFinalizedAsync

ListServers

[20.0.0+] The struct size is now 0x130-bytes instead of 0x128-bytes.

IUnknown0

This was added with [20.0.0+].

Cmd	Name
0
10
20
21
30
40
50
100
110
111
120
130
200
230
290
300
400
510
900

IUnknown1

This was added with [20.0.0+].

Cmd	Name
10
20
30
100
110
111
200
210
220
230
240
250
290
300
310
320
330
340
400
500
610
700
710
720

IUnknown2

This was added with [20.0.0+].

Cmd	Name
0
1
2
3
100
110

IUnknown3

This was added with [20.0.0+].

Cmd	Name
90
100
310
320
330
340
350
400
500
610
900

IUnknown4

This was added with [20.0.0+].

Cmd	Name
10
20
30
90
100
300
310
320
330
400
500
610
620
900

Notes

Savedata transfer ("nn::migration::savedata::IServer"/"nn::migration::savedata::IClient") requires that accounts are linked to the same network-account. acc:su IManagerForSystemService GetAccountId is used here. The server stores this Id into state, and also stores it in the ldn AdvertiseData. The client also verifies the Id in AdvertiseData against the Id from GetAccountId for the account(s) being used, during ScanServersAsync.