Migration services - Revision history

Yellows8: /* Protocol */

2026-05-17T02:27:09Z

Protocol

← Older revision		Revision as of 06:27, 17 May 2026
Line 1,020:		Line 1,020:
	= Protocol =		= Protocol =
	Once connected with [[LDN_services\|ldn]], the client node connects to the server with TCP port 441.		Once connected with [[LDN_services\|ldn]], the client node connects to the server with TCP port 441.

			With [20.0.0+] [[LDN_services\|ldn]] SetProtocol is used with a state field (Protocol3). It's unknown whether the protocol changes later during S2-only savedata transfer.

	== AdvertiseData ==		== AdvertiseData ==

2026-05-16T23:48:42Z

CreateSaveDataMigrationClient

← Older revision		Revision as of 03:48, 17 May 2026
Line 121:		Line 121:
	== CreateSaveDataMigrationClient ==		== CreateSaveDataMigrationClient ==
	Takes an input u32 tmem_size, a type-0x19 input buffer containing a [[#ClientProfile\|ClientProfile]], a TransferMemory handle, returns an [[#IClient_2\|IClient]].		Takes an input u32 tmem_size, a type-0x19 input buffer containing a [[#ClientProfile\|ClientProfile]], a TransferMemory handle, returns an [[#IClient_2\|IClient]].

			The tmem_size must be at least 0x50EA80.

	== ResumeSaveDataMigrationClient ==		== ResumeSaveDataMigrationClient ==

2026-05-16T23:38:20Z

ListServers

← Older revision		Revision as of 03:38, 17 May 2026
Line 573:		Line 573:

	=== ListServers ===		=== ListServers ===
			Takes a type-0x6 output buffer containing an array of a 0x128-byte struct, returns an output u32 total_out.

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

2026-05-16T19:28:49Z

KeyExchange

← Older revision		Revision as of 23:28, 16 May 2026
Line 1,180:		Line 1,180:
	\| 0x8 \|\| 0x20 \|\| Data from [[SPL_services\|GenerateRandomBytes]].		\| 0x8 \|\| 0x20 \|\| Data from [[SPL_services\|GenerateRandomBytes]].
	\|-		\|-
	\| 0x28 \|\| 0x10 \|\| CMAC ([[SPL_services\|ComputeCmac]]) over the above 0x20-bytes, followed by 0x20-bytes from state.		\| 0x28 \|\| 0x10 \|\| CMAC ([[SPL_services\|ComputeCmac]]) over the above 0x20-bytes, followed by 0x20-bytes from state (zeros).
	\|}		\|}

2026-05-16T02:54:15Z

@@ Line 1,330: / Line 1,330: @@
 |-
 | 0x80 || [[#Transfer|Transfer]]
 |-
 | 0xE0 || [20.0.0+] [[#PrepareTransferDisconnect2|PrepareTransferDisconnect2]]
@@ Line 1,517: / Line 1,521: @@
 The transfer payload is the output from exporting savedata from [[Filesystem_services|ISaveDataTransferManager]], which the client then imports.
 ==== PrepareTransferDisconnect2 ====

2026-05-15T22:45:33Z

2026-05-14T19:58:10Z

← Older revision		Revision as of 23:58, 14 May 2026
Line 393:		Line 393:
	** Calls a func. This receives [[#Suspend\|Suspend]] or [[#SynchronizeState\|SynchronizeState]] and sends the response.		** Calls a func. This receives [[#Suspend\|Suspend]] or [[#SynchronizeState\|SynchronizeState]] and sends the response.
	* Updates a state flag and returns 0.		* Updates a state flag and returns 0.

			The "nn::migration::device::IServer" version of this is roughly equivalent, except the funcs called after [[#RequestServerProfile\|RequestServerProfile]] above are not used.

	=== GetClientProductModel ===		=== GetClientProductModel ===
Line 780:		Line 782:
	\| 130 \|\|		\| 130 \|\|
	\|-		\|-
	\| 200 \|\|		\| 200 \|\| [[#WaitConnectionAsync\|WaitConnectionAsync]]
	\|-		\|-
	\| 230 \|\|		\| 230 \|\|
Line 1,375:		Line 1,377:
	\| 0x144 \|\| 0x4 \|\| [[Settings_services#GetProductModel\|ProductModel]]		\| 0x144 \|\| 0x4 \|\| [[Settings_services#GetProductModel\|ProductModel]]
	\|}		\|}

			With "nn::migration::device::" this is a 0x398-byte struct.

	When the aforementioned vfunc returned true, the client only uses the response data for verifying that various fields match state. Otherwise when false the client uses this data, in which case:		When the aforementioned vfunc returned true, the client only uses the response data for verifying that various fields match state. Otherwise when false the client uses this data, in which case:

2026-05-14T15:05:18Z

← Older revision		Revision as of 19:05, 14 May 2026
Line 1,398:		Line 1,398:
	\| 0x104 \|\| 0x4 \|\| [20.0.0+] [[System_Version_Title\|SystemVersion]]. u32 in the form: <code>(Major<<16) \| (Minor<<8) \| Micro</code>		\| 0x104 \|\| 0x4 \|\| [20.0.0+] [[System_Version_Title\|SystemVersion]]. u32 in the form: <code>(Major<<16) \| (Minor<<8) \| Micro</code>
	\|}		\|}

			With "nn::migration::device::" this is a 0x218-byte struct.

	The response only contains the header.		The response only contains the header.

2026-05-13T15:03:58Z

← Older revision		Revision as of 19:03, 13 May 2026
Line 1,345:		Line 1,345:
	The request only contains the header.		The request only contains the header.

	Response payload (0x148-byte ~~struct~~, which has the following layout):		Response payload (0x140-byte struct ([20.0.0+] 0x148-byte), which has the following layout):

			[20.0.0+]:

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
Line 1,392:		Line 1,394:
	\| 0x0 \|\| 0x100 \|\| [[#ClientProfile\|ClientProfile]]		\| 0x0 \|\| 0x100 \|\| [[#ClientProfile\|ClientProfile]]
	\|-		\|-
	\| 0x100 \|\| 0x4 \|\| [[Settings_services#GetProductModel\|ProductModel]]		\| 0x100 \|\| 0x4 \|\| [20.0.0+] [[Settings_services#GetProductModel\|ProductModel]]
	\|-		\|-
	\| 0x104 \|\| 0x4 \|\| [[System_Version_Title\|SystemVersion]]. u32 in the form: <code>(Major<<16) \| (Minor<<8) \| Micro</code>		\| 0x104 \|\| 0x4 \|\| [20.0.0+] [[System_Version_Title\|SystemVersion]]. u32 in the form: <code>(Major<<16) \| (Minor<<8) \| Micro</code>
	\|}		\|}

2026-05-13T03:44:55Z

← Older revision		Revision as of 07:44, 13 May 2026
Line 1,492:		Line 1,492:
	! Offset \|\| Size \|\| Description		! Offset \|\| Size \|\| Description
	\|-		\|-
	\| 0x4 \|\| 0x4 \|\| s32, must not be negative.		\| 0x4 \|\| 0x4 \|\| s32, must not be negative. Index in the fs data used by [[#GetList\|GetList]].
	\|}		\|}

Line 1,526:		Line 1,526:
	! Offset \|\| Size \|\| Description		! Offset \|\| Size \|\| Description
	\|-		\|-
	\| 0x4 \|\| 0x4 \|\| s32, must not be negative.		\| 0x4 \|\| 0x4 \|\| s32, must not be negative. Index in the fs data used by [[#GetList\|GetList]].
	\|}		\|}