msnp-wiki/docs/commands/xfr.md

2.5 KiB

Introduction

XFR is a command introduced with MSNP2.

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

It tells the client what server to connect to for the request.

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

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

In MSNP3 or higher, 0 is always 0.

In MSNP7 or higher, current-server is the current server you are connected to.

XFR SB

XFR TrID SB address:port authentication-method authentication-parameter

Where authentication-method is always CKI.

Where authentication-parameter is the "cookie" you need to log in to Switchboard.

Examples

Client requests a new Switchboard connection

C: XFR 1 SB
S: XFR 1 SB 10.0.1.200:1865 CKI 123456789.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

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

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

Client opens a connection to 10.0.0.5:1863

Modern

Since MSNP7.

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

Client opens a connection to 10.0.0.5:1863

Forced soft reset

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

Known changes

  • MSNP3 adds a new parameter that is always 0 to XFR NS.
  • MSNP7 adds a new parameter that is the current server you are communicating with to XFR NS.