msnp-wiki/docs/versions/msnp2.md

# Introduction
MSNP2 is the first released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 1.0.0863, along with [CVR0](cvr0.md).

# Command information
It introduces the dispatch service commands:
* [INF](../commands/inf.md)
* [OUT](../commands/out.md)
* [USR](../commands/usr.md)
* [VER](../commands/ver.md)
* [XFR](../commands/xfr.md)

It introduces the notification service commands:
* [ADD](../commands/add.md)
* [BLP](../commands/blp.md)
* [CHG](../commands/chg.md)
* [CVR](../commands/cvr.md) (not in draft)
* [FND](../commands/fnd.md) (not in draft)
* [FLN](../commands/fln.md)
* [GTC](../commands/gtc.md)
* [INF](../commands/inf.md)
* [ILN](../commands/iln.md)
* [LST](../commands/lst.md)
* [MSG](../commands/msg.md)
* [NLN](../commands/nln.md)
* [OUT](../commands/out.md)
* [PNG](../commands/png.md) (not in draft)
* [QNG](../commands/qng.md) (not in draft)
* [REA](../commands/rea.md) (not in draft, surprisingly)
* [REM](../commands/rem.md)
* [RNG](../commands/rng.md)
* [SND](../commands/snd.md) (not in draft)
* [SYN](../commands/syn.md)
* [URL](../commands/url.md) (not in draft)
* [USR](../commands/usr.md)
* [VER](../commands/ver.md)
* [XFR](../commands/xfr.md)

It introduces the switchboard service commands:
* [ACK](../commands/ack.md)
* [ANS](../commands/ans.md)
* [BYE](../commands/bye.md)
* [CAL](../commands/cal.md)
* [IRO](../commands/iro.md)
* [JOI](../commands/joi.md)
* [MSG](../commands/msg.md)
* [NAK](../commands/nak.md)
* [OUT](../commands/out.md)
* [USR](../commands/usr.md)

It introduces the error codes:
* 100 (not in draft)
* 146 (not in draft)
* 200
* 201
* 205
* 206
* 207
* 208 (draft only)
* 209
* 210
* 211 (not in draft)
* 215 (draft only)
* 216
* 218
* 219
* 280
* 281
* 300
* 302
* 500
* 501 (draft only)
* 503 (not in draft)
* 510
* 520
* 600
* 601
* 602 (draft only)
* 603 (draft only)
* 604 (draft only)
* 707
* 711 (draft only)
* 712
* 713
* 714
* 715 (draft only)
* 717 (draft only)
* 911
* 912 (not in draft)
* 913 (draft only)
* 914 (not in draft)
* 918 (not in draft)
* 919 (not in draft)
* 920

*No commands were known to be removed in this version*

# Known changes
(from Beta 2)
* Dispatch servers now go through the normal user proceedure until `USR x MD5 I`.

# Client-server communication example
```
C: VER 1 MSNP2 CVR0
S: VER 1 MSNP2
C: INF 2
S: INF 2 MD5
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
```
C: VER 4 MSNP2 CVR0
S: VER 4 MSNP2
C: INF 5
S: INF 5 MD5
C: USR 6 MD5 I example@hotmail.com
S: USR 6 MD5 S prefix
C: USR 7 MD5 S $md5(prefix + password)
S: USR 7 OK example@hotmail.com example%40hotmail.com
S: MSG Hotmail Hotmail 95
MIME-Version: 1.0
Content-Type: text/x-msmsgsprofile; charset=UTF-8
LoginTime: 1726321960

C: SYN 8 0
S: SYN 8 1
S: GTC 8 1 A
S: BLP 8 1 AL
S: LST 8 FL 1 0 0
S: LST 8 AL 1 0 0
S: LST 8 BL 1 0 0
S: LST 8 RL 1 0 0
C: CHG 9 NLN
S: CHG 9 NLN
C: ADD 10 AL anotheruser@hotmail.com anotheruser%40hotmail.com
S: ADD 10 AL 2 anotheruser@hotmail.com anotheruser%40hotmail.com
C: ADD 11 FL anotheruser@hotmail.com anotheruser%40hotmail.com
S: ADD 11 FL 3 anotheruser@hotmail.com anotheruser%40hotmail.com
S: NLN NLN anotheruser@hotmail.com another%20user
C: REA 12 anotheruser@hotmail.com another%20user
S: REA 12 4 anotheruser@hotmail.com another%20user
C: REA 13 example@hotmail.com example%20user
S: REA 13 5 example@hotmail.com example%20user
S: FLN anotheruser@hotmail.com
C: OUT
```
Client disconnects from server
```
S: OUT
```
Server disconnects client
actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`# Introduction`
initial commit 2024-10-10 15:38:51 -04:00			`MSNP2 is the first released version of the Mobile Status Notification Protocol.`
			`It was introduced officially in Client Version 1.0.0863, along with [CVR0](cvr0.md).`

actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`# Command information`
initial commit 2024-10-10 15:38:51 -04:00			`It introduces the dispatch service commands:`
actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`* [INF](../commands/inf.md)`
			`* [OUT](../commands/out.md)`
Corrections, USR, SYN Added new section to Protocols (half done with it though): Changes to error codes, to ask "When did that error code get implemented and when did it get removed" Probably could be made better, eh. 5 Commands Remain. New change record, too. 2024-10-23 16:47:02 -04:00			`* [USR](../commands/usr.md)`
fix accidental LaTeX thanks markdown extensions 2024-10-10 17:44:08 -04:00			`* [VER](../commands/ver.md)`
actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`* [XFR](../commands/xfr.md)`
initial commit 2024-10-10 15:38:51 -04:00
			`It introduces the notification service commands:`
fix a bunch of errors, new commands + ADD + REM + URL * fixed a bunch of formatting * changed the default list version to 255, if it increases to 256 it means it changed * fixed a bunch of muscle memory mishaps * Clean-up some missing "fill this in once information is available's 2024-10-16 16:12:41 -04:00			`* [ADD](../commands/add.md)`
add new pages, templates and update yiki + templates not compiled + added: BLP, FND and GTC, CHG and IMS command pages * updated links and added new relevant ones 2024-10-13 17:03:57 -04:00			`* [BLP](../commands/blp.md)`
			`* [CHG](../commands/chg.md)`
fattest update yet - 30 whole changed files next is formatting, which is why i wanted to commit anyway 2024-10-15 13:14:20 -04:00			`* [CVR](../commands/cvr.md) (not in draft)`
add new pages, templates and update yiki + templates not compiled + added: BLP, FND and GTC, CHG and IMS command pages * updated links and added new relevant ones 2024-10-13 17:03:57 -04:00			`* [FND](../commands/fnd.md) (not in draft)`
fattest update yet - 30 whole changed files next is formatting, which is why i wanted to commit anyway 2024-10-15 13:14:20 -04:00			`* [FLN](../commands/fln.md)`
add new pages, templates and update yiki + templates not compiled + added: BLP, FND and GTC, CHG and IMS command pages * updated links and added new relevant ones 2024-10-13 17:03:57 -04:00			`* [GTC](../commands/gtc.md)`
actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`* [INF](../commands/inf.md)`
ILN, NLN, REA, SND, ADG, LSG, and MSNP4 changes information for MSNP4 found: adds the client codebase parameter to SND and CVR (and an empty to CVQ, but that lasted all the way to MSNP7 lol, does that for MSNP3 fallback too which is kind of funny) 18 commands left. 2024-10-18 18:52:48 -04:00			`* [ILN](../commands/iln.md)`
fattest update yet - 30 whole changed files next is formatting, which is why i wanted to commit anyway 2024-10-15 13:14:20 -04:00			`* [LST](../commands/lst.md)`
all of switchboard except USR USR is very big and would consider a break here ... Why does the spec imply that Switchboard has INF? Is that why every client implements it after MSNP8? 2024-10-14 16:13:21 -04:00			`* [MSG](../commands/msg.md)`
ILN, NLN, REA, SND, ADG, LSG, and MSNP4 changes information for MSNP4 found: adds the client codebase parameter to SND and CVR (and an empty to CVQ, but that lasted all the way to MSNP7 lol, does that for MSNP3 fallback too which is kind of funny) 18 commands left. 2024-10-18 18:52:48 -04:00			`* [NLN](../commands/nln.md)`
actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`* [OUT](../commands/out.md)`
fattest update yet - 30 whole changed files next is formatting, which is why i wanted to commit anyway 2024-10-15 13:14:20 -04:00			`* [PNG](../commands/png.md) (not in draft)`
			`* [QNG](../commands/qng.md) (not in draft)`
ILN, NLN, REA, SND, ADG, LSG, and MSNP4 changes information for MSNP4 found: adds the client codebase parameter to SND and CVR (and an empty to CVQ, but that lasted all the way to MSNP7 lol, does that for MSNP3 fallback too which is kind of funny) 18 commands left. 2024-10-18 18:52:48 -04:00			`* [REA](../commands/rea.md) (not in draft, surprisingly)`
fix a bunch of errors, new commands + ADD + REM + URL * fixed a bunch of formatting * changed the default list version to 255, if it increases to 256 it means it changed * fixed a bunch of muscle memory mishaps * Clean-up some missing "fill this in once information is available's 2024-10-16 16:12:41 -04:00			`* [REM](../commands/rem.md)`
fattest update yet - 30 whole changed files next is formatting, which is why i wanted to commit anyway 2024-10-15 13:14:20 -04:00			`* [RNG](../commands/rng.md)`
ILN, NLN, REA, SND, ADG, LSG, and MSNP4 changes information for MSNP4 found: adds the client codebase parameter to SND and CVR (and an empty to CVQ, but that lasted all the way to MSNP7 lol, does that for MSNP3 fallback too which is kind of funny) 18 commands left. 2024-10-18 18:52:48 -04:00			`* [SND](../commands/snd.md) (not in draft)`
Corrections, USR, SYN Added new section to Protocols (half done with it though): Changes to error codes, to ask "When did that error code get implemented and when did it get removed" Probably could be made better, eh. 5 Commands Remain. New change record, too. 2024-10-23 16:47:02 -04:00			`* [SYN](../commands/syn.md)`
fix a bunch of errors, new commands + ADD + REM + URL * fixed a bunch of formatting * changed the default list version to 255, if it increases to 256 it means it changed * fixed a bunch of muscle memory mishaps * Clean-up some missing "fill this in once information is available's 2024-10-16 16:12:41 -04:00			`* [URL](../commands/url.md) (not in draft)`
Corrections, USR, SYN Added new section to Protocols (half done with it though): Changes to error codes, to ask "When did that error code get implemented and when did it get removed" Probably could be made better, eh. 5 Commands Remain. New change record, too. 2024-10-23 16:47:02 -04:00			`* [USR](../commands/usr.md)`
fix accidental LaTeX thanks markdown extensions 2024-10-10 17:44:08 -04:00			`* [VER](../commands/ver.md)`
actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`* [XFR](../commands/xfr.md)`
initial commit 2024-10-10 15:38:51 -04:00
			`It introduces the switchboard service commands:`
all of switchboard except USR USR is very big and would consider a break here ... Why does the spec imply that Switchboard has INF? Is that why every client implements it after MSNP8? 2024-10-14 16:13:21 -04:00			`* [ACK](../commands/ack.md)`
			`* [ANS](../commands/ans.md)`
			`* [BYE](../commands/bye.md)`
			`* [CAL](../commands/cal.md)`
			`* [IRO](../commands/iro.md)`
			`* [JOI](../commands/joi.md)`
			`* [MSG](../commands/msg.md)`
			`* [NAK](../commands/nak.md)`
actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`* [OUT](../commands/out.md)`
Corrections, USR, SYN Added new section to Protocols (half done with it though): Changes to error codes, to ask "When did that error code get implemented and when did it get removed" Probably could be made better, eh. 5 Commands Remain. New change record, too. 2024-10-23 16:47:02 -04:00			`* [USR](../commands/usr.md)`
initial commit 2024-10-10 15:38:51 -04:00
			`It introduces the error codes:`
			`* 100 (not in draft)`
			`* 146 (not in draft)`
			`* 200`
			`* 201`
			`* 205`
			`* 206`
			`* 207`
			`* 208 (draft only)`
			`* 209`
			`* 210`
			`* 211 (not in draft)`
			`* 215 (draft only)`
			`* 216`
			`* 218`
			`* 219`
			`* 280`
			`* 281`
			`* 300`
			`* 302`
			`* 500`
			`* 501 (draft only)`
			`* 503 (not in draft)`
			`* 510`
			`* 520`
			`* 600`
			`* 601`
			`* 602 (draft only)`
			`* 603 (draft only)`
			`* 604 (draft only)`
			`* 707`
			`* 711 (draft only)`
			`* 712`
			`* 713`
			`* 714`
			`* 715 (draft only)`
			`* 717 (draft only)`
			`* 911`
			`* 912 (not in draft)`
			`* 913 (draft only)`
			`* 914 (not in draft)`
			`* 918 (not in draft)`
			`* 919 (not in draft)`
			`* 920`

			`No commands were known to be removed in this version`

actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`# Known changes`
			`(from Beta 2)`
initial commit 2024-10-10 15:38:51 -04:00			* Dispatch servers now go through the normal user proceedure until `USR x MD5 I`.

actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`# Client-server communication example`
initial commit 2024-10-10 15:38:51 -04:00			```
			`C: VER 1 MSNP2 CVR0`
			`S: VER 1 MSNP2`
			`C: INF 2`
			`S: INF 2 MD5`
			`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`
			```
			`C: VER 4 MSNP2 CVR0`
			`S: VER 4 MSNP2`
			`C: INF 5`
			`S: INF 5 MD5`
			`C: USR 6 MD5 I example@hotmail.com`
			`S: USR 6 MD5 S prefix`
			`C: USR 7 MD5 S $md5(prefix + password)`
			`S: USR 7 OK example@hotmail.com example%40hotmail.com`
			`S: MSG Hotmail Hotmail 95`
format it up, remove all carriage returns too 2024-10-15 14:08:22 -04:00			`MIME-Version: 1.0`
			`Content-Type: text/x-msmsgsprofile; charset=UTF-8`
			`LoginTime: 1726321960`

initial commit 2024-10-10 15:38:51 -04:00			`C: SYN 8 0`
			`S: SYN 8 1`
			`S: GTC 8 1 A`
			`S: BLP 8 1 AL`
			`S: LST 8 FL 1 0 0`
			`S: LST 8 AL 1 0 0`
			`S: LST 8 BL 1 0 0`
			`S: LST 8 RL 1 0 0`
			`C: CHG 9 NLN`
			`S: CHG 9 NLN`
			`C: ADD 10 AL anotheruser@hotmail.com anotheruser%40hotmail.com`
			`S: ADD 10 AL 2 anotheruser@hotmail.com anotheruser%40hotmail.com`
			`C: ADD 11 FL anotheruser@hotmail.com anotheruser%40hotmail.com`
			`S: ADD 11 FL 3 anotheruser@hotmail.com anotheruser%40hotmail.com`
			`S: NLN NLN anotheruser@hotmail.com another%20user`
			`C: REA 12 anotheruser@hotmail.com another%20user`
			`S: REA 12 4 anotheruser@hotmail.com another%20user`
			`C: REA 13 example@hotmail.com example%20user`
			`S: REA 13 5 example@hotmail.com example%20user`
fattest update yet - 30 whole changed files next is formatting, which is why i wanted to commit anyway 2024-10-15 13:14:20 -04:00			`S: FLN anotheruser@hotmail.com`
initial commit 2024-10-10 15:38:51 -04:00			`C: OUT`
			```
			`Client disconnects from server`
			```
			`S: OUT`
			```
actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`Server disconnects client`