# Table of contents:

# Introduction

XFR is a command introduced with MSNP2.

It is a Dispatch Server and Notification Server command, without either a request or response payload.

Requests a transfer to another server.

# Client/Request

XFR TrID server-type

Where server-type is either SB (for a Switchboard Server), or NS (for a new Notification Server).

# Server/Response

XFR TrID server-type address:port {...}

Where server-type is either SB (for Switchboard), or NS (for a Notification Server).

Where address:port is the server you have requested or being referred to is. If this is set to 0, proceed to ignore the server-type parameter and restart the login process on the current server from VER.

# XFR NS

# Original parameters

Only in MSNP2-MSNP12.

XFR TrID NS address:port {0} {current-server}

Where 0 is always set to 0. Since MSNP3.

Where current-server is the current server you are connected to. Since MSNP7

# Reworked parameters

Since MSNP13.

XFR TrID NS address:port (U|S{|(M|G)}) D {target-dispatch-server}

Where (U|S) is either U or S:

Since MSNP16, the (U|S) parameter supports more options, and may now be one of two values:

Where D is always D. This parameter has not been observed to contain other values.

# XFR SB

XFR TrID SB address:port security-package challenge-arg {(U|S)} {gateway-domain} {direct-connect}

Where security-package defines the authentication scheme, which is almost always CKI:

NOTE: CKI is not available in Beta 2.

Where challenge-arg depends on the specified security-package:

Where (U|S) is either U or S. Since MSNP13:

Where gateway-domain is usually set to messenger.msn.com. Since MSNP13.

Where direct-connect is set to one of these two values, Since MSNP14:

# Examples

# Before rework

Only in MSNP2 to MSNP12.

# Client requests a new Switchboard session

C: XFR 1 SB
S: XFR 1 SB 10.0.1.200:1863 CKI 987654321.123456789.123456789

# Client requests a new Notification server

Only used as-is in Beta 2 as the first command sent to a Dispatch Server.

C: XFR 2 NS
S: XFR 2 NS 10.0.0.5:1863

Client disconnects from server.
Server disconnects client.

Client opens a connection to 10.0.0.5:1863.

# Client referred from Dispatch Server

# Very Old

Only in MSNP2.

C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863

Client disconnects from server.
Server disconnects client.

Client opens a connection to 10.0.0.5:1863.

# Classic

Only in MSNP3 to MSNP6.

C: USR 4 MD5 I example@hotmail.com
S: XFR 4 NS 10.0.0.5:1863 0

Client disconnects from server.
Server disconnects client.

Client opens a connection to 10.0.0.5:1863.

# Modern

Only in MSNP7 to MSNP12.

C: USR 5 MD5 I example@hotmail.com
S: XFR 5 NS 10.0.0.5:1863 0 10.0.0.1:1863

Client disconnects from server.
Server disconnects client.

Client opens a connection to 10.0.0.5:1863.

# After rework

Since MSNP13.

# Client requests a new Switchboard session

# Without direct connect parameter

Only in MSNP13.

C: XFR 6 SB
S: XFR 6 SB 10.0.1.200:1863 CKI 987654321.123456789.123456789 U messenger.msn.com

# With direct connect parameter

Since MSNP14.

C: XFR 7 SB
S: XFR 7 SB 10.0.1.200:1863 CKI 987654321.123456789.123456789 U messenger.msn.com 1

# Client referred from Dispatch Server

C: USR 8 TWN I example@hotmail.com
S: XFR 8 NS 10.0.0.5:1863 U D

Client disconnects from server.
Server disconnects client.

Client opens a connection to 10.0.0.5:1863.

# MPOP Transfer

TODO: What does this actually do? Why does this exist?

S: XFR 0 NS 10.0.0.5:1863 M D

Client disconnects from server.
Server disconnects client.

Client opens a connection to 10.0.0.5:1863.

# Forced soft reset

Applies for any protocol version.

S: XFR 0 NS 0
C: VER 9 MSNP7 MSNP6 MSNP5 MSNP4

# You can not be hidden or semi-offline while requesting a new Switchboard session

Applies for any protocol version.

C: XFR 10 SB
S: 913 10

# Known changes