From ce7c3bee1c85327e86bebbc595c2c4a40678b588 Mon Sep 17 00:00:00 2001 From: yellows111 Date: Wed, 18 Dec 2024 20:16:29 +0000 Subject: [PATCH] 0.2.0: The Winter Roll-up i have basically touched every file help * Moved all the error code stuff to one new sectional page, because the old way of doing it sucked big time. * Rename passport (soap) to RST * Formatting changes (many) * Several corrections * change git host because git.kevinthe.horse seems Dead --- docs/commands/ack.md | 5 +- docs/commands/adc.md | 5 +- docs/commands/add.md | 5 +- docs/commands/adg.md | 8 +- docs/commands/ans.md | 12 ++- docs/commands/blp.md | 4 +- docs/commands/bpr.md | 1 + docs/commands/bye.md | 1 - docs/commands/cal.md | 10 +- docs/commands/chg.md | 14 +-- docs/commands/chl.md | 13 ++- docs/commands/cvq.md | 7 +- docs/commands/cvr.md | 5 +- docs/commands/fln.md | 28 +++++- docs/commands/fnd.md | 2 +- docs/commands/fqy.md | 4 +- docs/commands/gcf.md | 4 +- docs/commands/gtc.md | 11 ++- docs/commands/iln.md | 3 +- docs/commands/ims.md | 1 - docs/commands/inf.md | 2 +- docs/commands/ipg.md | 1 - docs/commands/iro.md | 1 - docs/commands/joi.md | 1 - docs/commands/lst.md | 19 ++-- docs/commands/msg.md | 17 ++-- docs/commands/nak.md | 5 +- docs/commands/nln.md | 3 +- docs/commands/not.md | 1 - docs/commands/out.md | 5 +- docs/commands/pag.md | 4 +- docs/commands/pgd.md | 3 +- docs/commands/png.md | 4 +- docs/commands/prp.md | 2 - docs/commands/qng.md | 6 +- docs/commands/qry.md | 1 - docs/commands/rea.md | 13 +-- docs/commands/reg.md | 13 +-- docs/commands/rem.md | 6 ++ docs/commands/rmg.md | 10 +- docs/commands/rng.md | 1 - docs/commands/sbp.md | 31 +++++- docs/commands/sdc.md | 7 +- docs/commands/snd.md | 11 +-- docs/commands/syn.md | 3 +- docs/commands/ubx.md | 1 - docs/commands/url.md | 2 +- docs/commands/usr.md | 26 +++-- docs/commands/uux.md | 1 - docs/commands/ver.md | 6 +- docs/commands/xfr.md | 16 +-- docs/errors_and_hresults.md | 114 ++++++++++++++++++++++ docs/files/challenge_keypairs.md | 4 +- docs/files/shields.md | 6 +- docs/index.md | 14 +-- docs/services/abservice.md | 4 +- docs/services/abservice/contactinfo.md | 1 + docs/services/passport14.md | 3 +- docs/services/{passportsoap.md => rst.md} | 7 +- docs/services/sharingservice.md | 4 +- docs/table_of_commands.md | 11 ++- docs/versions/cvr0.md | 4 +- docs/versions/msnp10.md | 19 ++-- docs/versions/msnp11.md | 21 ++-- docs/versions/msnp12.md | 23 ++--- docs/versions/msnp13.md | 15 ++- docs/versions/msnp14.md | 20 ++-- docs/versions/msnp2.md | 57 ++--------- docs/versions/msnp3.md | 44 +-------- docs/versions/msnp4.md | 24 +---- docs/versions/msnp5.md | 34 +------ docs/versions/msnp6.md | 28 ++---- docs/versions/msnp7.md | 45 +-------- docs/versions/msnp8.md | 20 ++-- docs/versions/msnp9.md | 15 +-- package-lock.json | 6 +- package.json | 2 +- templates/command.md | 3 +- templates/msnpver.md | 12 +-- 79 files changed, 437 insertions(+), 488 deletions(-) create mode 100644 docs/errors_and_hresults.md rename docs/services/{passportsoap.md => rst.md} (98%) diff --git a/docs/commands/ack.md b/docs/commands/ack.md index b6c3924..6ecabf6 100644 --- a/docs/commands/ack.md +++ b/docs/commands/ack.md @@ -15,9 +15,9 @@ This command can not be sent from the client. ## As a response to MSG A ``` -C: MSG 1 A 68 +C: MSG 1 A 69 MIME-Version: 1.0 -Content-Type: text/plain;charset=UTF-8 +Content-Type: text/plain; charset=UTF-8 message S: ACK 1 @@ -39,7 +39,6 @@ S: ACK 2 ``` C: ACK 3 ``` - Server disconnects client. # Known changes diff --git a/docs/commands/adc.md b/docs/commands/adc.md index 0291a59..ac9ca5f 100644 --- a/docs/commands/adc.md +++ b/docs/commands/adc.md @@ -154,14 +154,13 @@ S: 224 12 ``` C: ADC 13 PL N=anotheruser@hotmail.com ``` - Server disconnects client. -## Removed +## Command removed +*Since [MSNP13](../versions/msnp13.md).* ``` C: ADC 14 FL N=anotheruser@hotmail.com F=anotheruser@hotmail.com ``` - Server disconnects client. ## Asynchronous update diff --git a/docs/commands/add.md b/docs/commands/add.md index a7d1a09..be448c0 100644 --- a/docs/commands/add.md +++ b/docs/commands/add.md @@ -84,14 +84,13 @@ S: 224 10 ``` C: ADD 11 RL anotheruser@hotmail.com anotheruser@hotmail.com ``` - Server disconnects client. -## Removed +## Command removed +*Since [MSNP10](../versions/msnp10.md).* ``` C: ADD 12 FL anotheruser@hotmail.com anotheruser@hotmail.com ``` - Server disconnects client. ## Asynchronous update diff --git a/docs/commands/adg.md b/docs/commands/adg.md index b254d24..35c975b 100644 --- a/docs/commands/adg.md +++ b/docs/commands/adg.md @@ -55,7 +55,6 @@ C: ADG 3 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAA 0 ``` - Server disconnects client. ## Without list versions @@ -89,7 +88,6 @@ C: ADG 7 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAA ``` - Server disconnects client. ### With group GUIDs @@ -121,7 +119,13 @@ C: ADG 11 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAA ``` +Server disconnects client. +## Command removed +*Since [MSNP13](../versions/msnp13.md).* +``` +C: ADG 12 Example%20Group +``` Server disconnects client. # Known changes diff --git a/docs/commands/ans.md b/docs/commands/ans.md index 90785aa..0e7ca56 100644 --- a/docs/commands/ans.md +++ b/docs/commands/ans.md @@ -7,10 +7,11 @@ Used to join ("answer") a Switchboard session ("call"). The response of this command sent after the [IRO](iro.md) list has been sent. # Client/Request -`ANS TrID my-handle cookie session-id` +`ANS TrID my-handle{;machine-guid} cookie session-id` Where `my-handle` is the current user's handle. -In [MSNP16](../versions/msnp16.md), a UUID is appended after a semi-colon, which is your MPOP Machine ID. + +Where `;machine-guid` is a bracketed Machine GUID. Added since [MSNP16](../versions/msnp16.md). Where `cookie` is the `cookie` from the [RNG](rng.md) command sent to you. @@ -24,8 +25,11 @@ Where `OK` is always `OK`. # Examples ## Answering a RNG +*NOTE: This has been line-breaked. +Lines beginning with .. followed by a space are continuations of the previous line.* ``` -S: RNG 987654331 10.0.1.200:1865 CKI 123456789.123456789.123456789 anotheruser@hotmail.com another%20user +S: RNG 987654331 10.0.1.200:1865 CKI 123456789.123456789.123456789 +.. anotheruser@hotmail.com another%20user C: ANS 1 example@hotmail.com 123456789.123456789.123456789 987654321 S: IRO 1 1 1 anotheruser@hotmail.com another%20user S: ANS 1 OK @@ -36,7 +40,6 @@ S: ANS 1 OK ``` C: ANS 2 example@hotmail.com bad data ``` - Server disconnects client. ## Invalid context (Notification Server) @@ -44,7 +47,6 @@ Server disconnects client. ``` C: ANS 3 example@hotmail.com wrong server ``` - Server disconnects client. # Known changes diff --git a/docs/commands/blp.md b/docs/commands/blp.md index 74acdac..30c4a27 100644 --- a/docs/commands/blp.md +++ b/docs/commands/blp.md @@ -36,12 +36,10 @@ S: 218 4 ``` ## Invalid argument -*NOTE: This is an assumption. The actual error code here is unknown. -It may also lead to an Instant Disconnection.* ``` C: BLP 5 CL -S: 201 5 ``` +Server disconnects client. # Known changes * [MSNP10](../versions/msnp10.md) and higher: List Versions are dropped in `ABCHMigrated: 1` mode. diff --git a/docs/commands/bpr.md b/docs/commands/bpr.md index c25b76b..3e3eae5 100644 --- a/docs/commands/bpr.md +++ b/docs/commands/bpr.md @@ -37,6 +37,7 @@ S: BPR 256 anotheruser@hotmail.com PHH 1%20(444)%20222%203333 ``` C: BPR example@hotmail.com ``` +Server disconnects client. # Known changes * [MSNP8](../versions/msnp8.md): Removed the user's handle when used in [SYN](syn.md). diff --git a/docs/commands/bye.md b/docs/commands/bye.md index 18ef907..25b94fb 100644 --- a/docs/commands/bye.md +++ b/docs/commands/bye.md @@ -32,7 +32,6 @@ S: BYE anotheruser@hotmail.com 1 ``` C: BYE 1 ``` - Server disconnects client. # Known changes diff --git a/docs/commands/cal.md b/docs/commands/cal.md index a5d7b81..015a8b4 100644 --- a/docs/commands/cal.md +++ b/docs/commands/cal.md @@ -1,7 +1,7 @@ # Introduction `CAL` is a command introduced with [MSNP2](../versions/msnp2.md). -It is a Switchboard Server command, without a response payload. +It is a Switchboard Server command, without either a request or response payload. It invites ("calls") a user to a Switchboard session. @@ -43,14 +43,15 @@ C: CAL 4 anotheruser@hotmail.com S: 217 4 ``` -## User does not allow you to contact them -*All instances that returned this have been changed to a 217. This response is deprecated.* +## That user does not allow you to contact them +*All instances that returned this have been changed to a 217. +This response is obsolete.* ``` C: CAL 5 anotheruser@hotmail.com S: 216 5 ``` -## Rate limited +## You are being rate limited ``` C: CAL 6 anotheruser@hotmail.com S: 217 6 @@ -71,7 +72,6 @@ S: 713 11 ``` C: CAL 12 anotheruser@hotmail.com ``` - Server disconnects client. # Known changes diff --git a/docs/commands/chg.md b/docs/commands/chg.md index 39a6304..7eb4002 100644 --- a/docs/commands/chg.md +++ b/docs/commands/chg.md @@ -28,22 +28,23 @@ add additional information related to your user. Requires that `flags` MUST be s The MSNObject itself is a XML-like element. ## Status explanations -All statuses except `HDN` and `FLN` will treat you as online. +All statuses except `HDN` and `FLN` will treat you as online. Which means all users on your Allow List (AL) and Reverse List (RL) will get all presence changes via the NLN command. -The statuses `HDN` and `FLN` will treat you as offline. +The statuses `HDN` and `FLN` will treat you as offline. Which means all users on your Allow List (AL) and Reverse List (RL) -will get a FLN command instead of an NLN command. +will get a FLN command instead of an NLN command. Also, all attempts to create a Switchboard session will fail automatically, Exclusive to the `FLN` state, you are put in a very reduced state where you can -only recieve presence changes from other users and resynchronize your Lists. +only recieve presence changes from other users and resynchronize your Lists. +You may be able to execute more commands, but doing so is Undefined Behaviour. # Server/Response `CHG TrID status {flags} {msnobj}` -The server may also send this Asynchronously, if it does, the TrID will be 0. +The server may also send this command asynchronously (at any time) with the `TrID` set to `0`. # Examples @@ -78,7 +79,7 @@ S: CHG 3 BSY 268435500 %3Cmsnobj%20Creator%3D%22example%40hotmail.com%22 .. %20SHA1C%3D%22DBRJPnGb+wBYawENkdor1bOdYUs%3D%22%2F%3E ``` -## Server Decides it wants you in Semi-Offline mode. +## Server asynchronously changes your status to Semi-offline. ``` S: CHG 0 FLN ``` @@ -88,7 +89,6 @@ S: CHG 0 FLN ``` C: CHG 4 HOT ``` - Server disconnects client. # Known changes diff --git a/docs/commands/chl.md b/docs/commands/chl.md index ce814dd..0ab2a56 100644 --- a/docs/commands/chl.md +++ b/docs/commands/chl.md @@ -19,17 +19,17 @@ that is concatenated with the client's Private Key. # Examples -## From server at any time -``` -S: CHL 0 12345678901234567890 -``` - -## Requested challenge +## Client-initiated challenge ``` C: CHL 1 S: CHL 1 12345678901234567890 ``` +## From server at any time +``` +S: CHL 0 12345678901234567890 +``` + ## Challenge timeout ``` S: CHL 0 12345678901234567890 @@ -38,7 +38,6 @@ S: CHL 0 12345678901234567890 ``` S: OUT ``` - Server disconnects client. # Known changes diff --git a/docs/commands/cvq.md b/docs/commands/cvq.md index 15151f1..cf25c52 100644 --- a/docs/commands/cvq.md +++ b/docs/commands/cvq.md @@ -17,7 +17,7 @@ Where `system-ver` is the major and minor version of the operating system, such Where `system-arch` is the architecture of the processor that is used to run the client, usually `i386`. -Where `requesting-library` is the name of the library that requested this CVR, usually `MSMSGS` or `MSNMSGR`. +Where `requesting-library` is the name of the library that requested this CVQ, usually `MSMSGS` or `MSNMSGR`. Where `client-version` is the current client's major, minor and patch version, should be in the format of "{M}M.m.pppp". @@ -55,7 +55,6 @@ S: CVQ 1 5.0.0537 5.0.0537 1.0.0863 .. http://download.microsoft.com/download/msnmessenger/install/5.0/w98nt42kmexp/en-us/setupdl.exe .. http://messenger.microsoft.com ``` - Client disconnects from server, since it sees that `minimum-allowed` is above it's `client-version`. ## New @@ -66,7 +65,6 @@ S: CVQ 2 7.0.0813 7.0.0813 6.2.0205 .. http://msgr.dlservice.microsoft.com/download/5/d/9/5d9bb5b2-49c7-4890-94ab-d1d5e44a0e6d/Install_MSN_Messenger.exe .. http://messenger.msn.com ``` - Client disconnects from server, since it sees that `minimum-allowed` is above it's `client-version`. ## Invalid client identification or version @@ -84,12 +82,11 @@ C: CVQ 5 0x1111 winnt 5.1 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com S: 710 5 ``` -## Invalid CVR +## Invalid parameters ``` C: CVQ 6 spaghetti S: 731 6 ``` - Server disconnects client. # Known changes diff --git a/docs/commands/cvr.md b/docs/commands/cvr.md index 8093654..93e63b2 100644 --- a/docs/commands/cvr.md +++ b/docs/commands/cvr.md @@ -55,7 +55,6 @@ S: CVR 1 5.0.0537 5.0.0537 1.0.0863 .. http://download.microsoft.com/download/msnmessenger/install/5.0/w98nt42kmexp/en-us/setupdl.exe .. http://messenger.microsoft.com ``` - Client asks if user would like to update, and stays connected. ## Pre-login @@ -66,7 +65,6 @@ S: CVR 2 7.0.0813 7.0.0813 6.2.0205 .. http://msgr.dlservice.microsoft.com/download/5/d/9/5d9bb5b2-49c7-4890-94ab-d1d5e44a0e6d/Install_MSN_Messenger.exe .. http://messenger.msn.com ``` - Client disconnects from server, since it sees that `minimum-allowed` is above it's `client-version`. ## Invalid client identification or version @@ -84,12 +82,11 @@ C: CVR 5 0x1111 winnt 5.1 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com S: 710 5 ``` -## Invalid CVR +## Invalid parameters ``` C: CVR 6 spaghetti S: 731 6 ``` - Server disconnects client. # Known changes diff --git a/docs/commands/fln.md b/docs/commands/fln.md index 29c621b..20a13ff 100644 --- a/docs/commands/fln.md +++ b/docs/commands/fln.md @@ -9,13 +9,22 @@ It specifies that another user in your contact list has gone offline. This command can not be sent from the client. # Server/Response -`FLN {user-handle} {network-id}` +`FLN user-handle {network-id} {client-capabilities{:extended-client-capabilities}} {presence-icon-url}` Where `user-handle` is the related user's handle. Where `network-id` is the Network Identification Number that this user is from. Added since [MSNP14](../versions/msnp14.md). +Where `client-capabilities` are the relevant user's new Client Capabilities. +Optional? Added since [MSNP14](../versions/msnp14.md). + +Where `extended-client-capabilities` are the relevant user's Extended Client Capabilities. +Optional. Added since [MSNP16](../versions/msnp16.md). + +Where `presence-icon-url` is an image that is rendered to this client that replaces the default user icon. +Optional. Added since [MSNP14](../versions/msnp14.md). + # Examples ## User goes offline @@ -26,10 +35,16 @@ Added since [MSNP14](../versions/msnp14.md). S: FLN anotheruser@hotmail.com ``` -### With Network IDs +### With Network IDs and Preesense Icon URLs and Client Capabilities *Since [MSNP14](../versions/msnp14.md).* ``` -S: FLN anotheruser@hotmail.com 1 +S: FLN anotheruser@hotmail.com 1 0 http://example.com/interop/offline.png +``` + +### With Extended Client Capabilities +*Since [MSNP16](../versions/msnp16.md).* +``` +S: FLN anotheruser@hotmail.com 1 0:0 http://example.com/interop/offline.png ``` ## Invalid context @@ -37,8 +52,11 @@ S: FLN anotheruser@hotmail.com 1 ``` C: FLN Hotmail ``` - Server disconnects client. # Known changes -* [MSNP14](../versions/msnp14.md): Added a new parameter that denotes the Network ID of the user that is now offline. +* [MSNP14](../versions/msnp14.md): Added several new parameters that denotes the following: + * Network ID of the user that is now offline. + * The new client capabilities of the user that is now offline. + * A way to override the default presense icon. +* [MSNP16](../versions/msnp16.md): Added Extended Client Capabilities support to the Client Capabilities parameter, delimited by a colon. diff --git a/docs/commands/fnd.md b/docs/commands/fnd.md index 8870d7c..0e959d0 100644 --- a/docs/commands/fnd.md +++ b/docs/commands/fnd.md @@ -51,7 +51,7 @@ C: FND 4 fname=Another lname=User city=* state=* country=* S: 301 4 ``` -## Removed +## Command removed ``` C: FND 5 fname=Another lname=User city=* state=* country=US S: 502 5 diff --git a/docs/commands/fqy.md b/docs/commands/fqy.md index 116d9bf..afc4286 100644 --- a/docs/commands/fqy.md +++ b/docs/commands/fqy.md @@ -41,7 +41,7 @@ Where payload is a [``](#ml) document, without any support for whitespace ou No whitespace is allowed in FQY's payload and the payload size reflects this, and is set to the correct value.* -## User on another service +## User on the same service ``` C: FQY 1 53 @@ -57,7 +57,7 @@ S: FQY 1 59 ``` -## User on the same service +## User on another service ``` C: FQY 2 53 diff --git a/docs/commands/gcf.md b/docs/commands/gcf.md index c80d03f..32415dc 100644 --- a/docs/commands/gcf.md +++ b/docs/commands/gcf.md @@ -6,7 +6,8 @@ It is a Notification Server command, without a request payload and WITH a respon It gets configuration data from a file on the server. # Client/Request -*Only in [MSNP11](../versions/msnp11.md) and [MSNP12](./versions/msnp12.md).* +*Only in [MSNP11](../versions/msnp11.md) and [MSNP12](../versions/msnp12.md).* + `GCF TrID filename` Where filename is the file to retrieve. Only `Shields.xml` is known to be this parameter. @@ -58,7 +59,6 @@ S: USR 2 TWN S passport=parameters,neat=huh,lc=1033,id=507 ``` C: GCF 3 Shields.xml ``` - Server disconnects client. # Known changes diff --git a/docs/commands/gtc.md b/docs/commands/gtc.md index e56383d..f1ee9c0 100644 --- a/docs/commands/gtc.md +++ b/docs/commands/gtc.md @@ -36,12 +36,17 @@ S: 218 4 ``` ## Invalid argument -*NOTE: This is an assumption. The actual error code here is unknown. -It may also lead to an Instant Disconnection.* ``` C: GTC 5 B -S: 201 5 ``` +Server disconnects client. + +## Command removed +*Since [MSNP13](../versions/msnp13.md).* +``` +C: GTC 6 A +``` +Server disconnects client. # Known changes * [MSNP10](../versions/msnp10.md) and higher: List Versions are dropped in `ABCHMigrated: 1` mode. diff --git a/docs/commands/iln.md b/docs/commands/iln.md index 3a1c8c2..8ff106c 100644 --- a/docs/commands/iln.md +++ b/docs/commands/iln.md @@ -45,7 +45,7 @@ Optional. Added since [MSNP14](../versions/msnp14.md). # Examples -## Wihout anything special +## Only with status ``` C: CHG 1 NLN S: CHG 1 NLN @@ -112,7 +112,6 @@ S: ILN 5 NLN anotheruser@hotmail.com 1 another%20user 2789003324:48 %3Cmsnobj%20 ``` C: ILN 6 FLN example@hotmail.com example%20user ``` - Server disconnects client. # Known changes diff --git a/docs/commands/ims.md b/docs/commands/ims.md index a3b5fd5..adc494a 100644 --- a/docs/commands/ims.md +++ b/docs/commands/ims.md @@ -33,7 +33,6 @@ S: IMS 2 0 OFF ``` C: IMS 3 TOMORROW ``` - Server disconnects client. # Known changes diff --git a/docs/commands/inf.md b/docs/commands/inf.md index 9f8f4c8..2f1408a 100644 --- a/docs/commands/inf.md +++ b/docs/commands/inf.md @@ -14,7 +14,7 @@ Any further uses of this command in the same session is Undefined Behaviour. # Server/Response `INF TrID security-package {security-package ...}` -Where (unlikely multiple) `security-package` parameters being the avaliable authentication methods your client is allowed to use. +Where one or more `security-package` parameters being the avaliable authentication methods your client is allowed to use. # Examples diff --git a/docs/commands/ipg.md b/docs/commands/ipg.md index 4ffcf10..fd9fb56 100644 --- a/docs/commands/ipg.md +++ b/docs/commands/ipg.md @@ -44,7 +44,6 @@ S: IPG 478 ``` C: IPG 1 0 ``` - Server disconnects client. # Known changes diff --git a/docs/commands/iro.md b/docs/commands/iro.md index 7e5da04..26af0cb 100644 --- a/docs/commands/iro.md +++ b/docs/commands/iro.md @@ -43,7 +43,6 @@ S: ANS 2 OK ``` C: IRO 3 ``` - Server disconnects client. # Known changes diff --git a/docs/commands/joi.md b/docs/commands/joi.md index 5985244..c7c5bb6 100644 --- a/docs/commands/joi.md +++ b/docs/commands/joi.md @@ -35,7 +35,6 @@ S: JOI anotheruser@hotmail.com another%20user 1342554172 ``` C: JOI 2 ``` - Server disconnects client. # Known changes diff --git a/docs/commands/lst.md b/docs/commands/lst.md index 0c5aa10..6ffe8bc 100644 --- a/docs/commands/lst.md +++ b/docs/commands/lst.md @@ -33,7 +33,7 @@ Added since [MSNP7](../versions/msnp7.md). ## In SYN -### First generation +### First generation parameters *Applies for [MSNP2](../versions/msnp2.md) to [MSNP6](../versions/msnp6.md).* Same as the response [Outside of SYN](#outside-of-syn). @@ -46,7 +46,7 @@ Same as the response [Outside of SYN](#outside-of-syn). Where `groups` is a comma-delimited list of Group IDs this contact is in, only appended if the list (parameter 1) is set to FL. Defaults to `0`. -### Second generation +### Second generation parameters *Applies for [MSNP8](../versions/msnp8.md) and [MSNP9](../versions/msnp9.md)* `LST user-handle stored-friendly-name list-bits {groups}` @@ -60,14 +60,14 @@ Where `list-bits` are in the format: Where `groups` is a comma-delimited list of Group IDs this contact is in, only appended if Forward List (FL) is set in `list-bits`. Defaults to `0`. -### Third generation +### Third generation parameters *Applies for [MSNP10](../versions/msnp10.md) with `ABCHMigrated: 0`.* `LST N=user-handle F=stored-friendly-name list-bits {groups}` Same parameters as the [second generation](#second-generation). -### Fourth generation +### Fourth generation parameters *Applies for [MSNP10](../versions/msnp10.md) and [MSNP11](../versions/msnp11.md) with `ABCHMigrated: 1`.* `LST N=user-handle F=stored-friendly-name C=contact-guid list-bits {groupGuids}` @@ -77,7 +77,7 @@ Where `contact-guid` is the GUID/UUID of the contact. Where `groupGuids` is a comma-delimited list of Group GUIDs this contact is in, only appending if Forward List (FL) is set in `list-bits`, defaults to whatever "Other Contacts"'s GUID is. -### Fifth generation +### Fifth generation parameters *Applies for [MSNP12](../versions/msnp12.md).* `LST N=user-handle F=stored-friendly-name C=contact-guid list-bits network-id {groupGuids}` @@ -131,7 +131,7 @@ S: LST 4 BL 5 0 0 S: LST 4 RL 5 1 1 anotheruser@hotmail.com another%20user ``` -### Using second generation +### Using second generation parameters *Only in [MSNP8](../versions/msnp8.md) and [MSNP9](../versions/msnp9.md).* ``` C: SYN 5 0 @@ -143,7 +143,7 @@ S: LSG 0 Other%20Contacts 0 S: LST anotheruser@hotmail.com another%20user 11 0 ``` -### Using third generation +### Using third generation parameters *Only in [MSNP10](../versions/msnp10.md) with `ABCHMigrated: 0`.* ``` @@ -156,7 +156,7 @@ S: LSG Other%20Contacts 0 S: LST N=anotheruser@hotmail.com F=another%20user C=anotheruser@hotmail.com 11 0 ``` -### Using fourth generation +### Using fourth generation parameters *Only in [MSNP10](../versions/msnp10.md) and [MSNP11](../versions/msnp11.md) with `ABCHMigrated: 1`.* ``` C: SYN 7 0 0 @@ -168,8 +168,7 @@ S: LSG Other%20Contacts d6deeacd-7849-4de4-93c5-d130915d0042 S: LST N=anotheruser@hotmail.com F=another%20user C=c1f9a363-4ee9-4a33-a434-b056a4c55b98 11 d6deeacd-7849-4de4-93c5-d130915d0042 ``` - -### Using fifth generation +### Using fifth generation parameters *Only in [MSNP12](../versions/msnp12.md).* ``` C: SYN 8 0 0 diff --git a/docs/commands/msg.md b/docs/commands/msg.md index 183a349..c737bde 100644 --- a/docs/commands/msg.md +++ b/docs/commands/msg.md @@ -47,18 +47,18 @@ usually containing a `MIME-Version` header and a `Content-Type`. ### Unacknowledged message ``` -C: MSG 1 U 75 +C: MSG 1 U 76 MIME-Version: 1.0 -Content-Type: text/plain;charset=UTF-8 +Content-Type: text/plain; charset=UTF-8 unacknowledged ``` ### Acknowledged message ``` -C: MSG A 2 73 +C: MSG A 2 74 MIME-Version: 1.0 -Content-Type: text/plain;charset=UTF-8 +Content-Type: text/plain; charset=UTF-8 acknowledged S: ACK 2 @@ -66,9 +66,9 @@ S: ACK 2 ### Negative-Acknowledged message ``` -C: MSG 3 2 85 +C: MSG 3 2 86 MIME-Version: 1.0 -Content-Type: text/plain;charset=UTF-8 +Content-Type: text/plain; charset=UTF-8 negatively acknowledged? S: NAK 3 @@ -88,9 +88,9 @@ S: ACK 4 ### Poorly formatted data message *Since [MSNP9](../versions/msnp9.md).* ``` -C: MSG 5 D 74 +C: MSG 5 D 75 MIME-Version: 1.0 -Content-Type: text/plain;charset=UTF-8 +Content-Type: text/plain; charset=UTF-8 data message? S: 282 5 @@ -101,7 +101,6 @@ S: 282 5 ``` C: MSG 6 U 0 ``` - Server disconnects client. ## Server initated diff --git a/docs/commands/nak.md b/docs/commands/nak.md index 443594f..5cf2719 100644 --- a/docs/commands/nak.md +++ b/docs/commands/nak.md @@ -15,9 +15,9 @@ This command can not be sent from the client. ## As a response to MSG N ``` -C: MSG 1 N 68 +C: MSG 1 N 69 MIME-Version: 1.0 -Content-Type: text/plain;charset=UTF-8 +Content-Type: text/plain; charset=UTF-8 message S: NAK 1 @@ -28,7 +28,6 @@ S: NAK 1 ``` C: NAK 2 ``` - Server disconnects client. # Known changes diff --git a/docs/commands/nln.md b/docs/commands/nln.md index 9030fe5..0cd35b3 100644 --- a/docs/commands/nln.md +++ b/docs/commands/nln.md @@ -42,7 +42,7 @@ Optional. Added since [MSNP14](../versions/msnp14.md). # Examples -## Wihout anything special +## Only with status ``` S: NLN NLN anotheruser@example.com another%20user ``` @@ -99,7 +99,6 @@ S: NLN NLN anotheruser@hotmail.com 1 another%20user 2789003324:48 %3Cmsnobj%20Cr ``` C: NLN FLN example@hotmail.com example%20user ``` - Server disconnects client. # Known changes diff --git a/docs/commands/not.md b/docs/commands/not.md index 7af6b6e..27d4b11 100644 --- a/docs/commands/not.md +++ b/docs/commands/not.md @@ -124,7 +124,6 @@ S: NOT 694 ``` C: NOT 1 0 ``` - Server disconnects client. # Known changes diff --git a/docs/commands/out.md b/docs/commands/out.md index 5492f73..66d3e6c 100644 --- a/docs/commands/out.md +++ b/docs/commands/out.md @@ -31,7 +31,6 @@ Where `minutes` is the amount of minutes the client should wait before trying to C: OUT S: OUT ``` - Server disconnects client. ## Logged in from another client @@ -44,7 +43,7 @@ S: OUT OTH S: OUT SSD ``` -## ABCH Migration +## ABCH migration *Only in [MSNP10](../versions/msnp10.md).* ``` S: OUT MIG @@ -56,7 +55,7 @@ S: OUT MIG S: OUT TOU ``` -## Forced Reconnect +## Forced reconnect *Since [MSNP11](../versions/msnp11.md).* ``` S: OUT RCT 6 diff --git a/docs/commands/pag.md b/docs/commands/pag.md index 08ddbee..0f8ed0e 100644 --- a/docs/commands/pag.md +++ b/docs/commands/pag.md @@ -1,7 +1,7 @@ # Introduction `PAG` is a command introduced with [MSNP5](../versions/msnp5.md). -It is a Notification Server command, with a request payload. +It is a Notification Server command, WITH a request payload. It sends a text message to a mobile device or pager. For the version of this command that supports Web Watches, read [PGD](pgd.md). @@ -64,7 +64,7 @@ C: PAG 5 anotheruser@hotmail.com 61 S: 800 5 ``` -## Removed +## Command removed *Since [MSNP9](../versions/msnp9.md).* ``` C: PAG 6 anotheruser@hotmail.com 61 diff --git a/docs/commands/pgd.md b/docs/commands/pgd.md index 0ce7a34..db7d4e5 100644 --- a/docs/commands/pgd.md +++ b/docs/commands/pgd.md @@ -1,7 +1,7 @@ # Introduction `PGD` is a command introduced with [MSNP9](../versions/msnp9.md). -It is a Notification Server command, with a request payload. +It is a Notification Server command, WITH a request payload. It sends a text message to a mobile device/pager or Web Watch. For the version of this command that doesn't support Web watches, read [PAG](pag.md). @@ -102,7 +102,6 @@ S: 201 8 C: PGD 9 anotheruser@hotmail.com W 74 This is an example message. ``` - Server disconnects client. # Known changes diff --git a/docs/commands/png.md b/docs/commands/png.md index 18ccb03..846905e 100644 --- a/docs/commands/png.md +++ b/docs/commands/png.md @@ -1,7 +1,7 @@ # Introduction `PNG` is a command introduced with [MSNP2](../versions/msnp2.md). -It is a Notification Server command, without either a request or response payload. +It is a Notification Server command, without a request payload. Makes the server respond with a [QNG](qng.md) command. @@ -13,7 +13,7 @@ The server responds to this command via [QNG](qng.md). # Examples -## Client-sent +## Client-initiated ``` C: PNG S: QNG diff --git a/docs/commands/prp.md b/docs/commands/prp.md index bd57fdb..f47a69a 100644 --- a/docs/commands/prp.md +++ b/docs/commands/prp.md @@ -47,7 +47,6 @@ S: 715 2 ``` C: PRP 3 NICE Y ``` - Server disconnects client. ## Property value is too long @@ -57,7 +56,6 @@ Lines beginning with `..` followed by a space are continuations of the previous C: PRP 4 PHM this%20is%20way%20too%20long%20of%20a .. %20phone%20number%20not%20like%20it%20is%20one%20anyway... ``` - Server disconnects client. # Known changes diff --git a/docs/commands/qng.md b/docs/commands/qng.md index 2537693..fd6387c 100644 --- a/docs/commands/qng.md +++ b/docs/commands/qng.md @@ -15,13 +15,14 @@ Where `next-seconds` is the amount of seconds until the client should send anoth # Examples -## Server-reply, old +## Server reply, without next seconds parameter +*Only in [MSNP2](../versions/msnp2.md) to [MSNP8](../versions/msnp8.md).* ``` C: PNG S: QNG ``` -## Server-reply, new +## Server reply, with next seconds parameter *Since [MSNP9](../versions/msnp9.md).* ``` C: PNG @@ -33,7 +34,6 @@ S: QNG 50 ``` C: QNG ``` - Server disconnects client. # Known changes diff --git a/docs/commands/qry.md b/docs/commands/qry.md index b2d4112..dc3d5c2 100644 --- a/docs/commands/qry.md +++ b/docs/commands/qry.md @@ -62,7 +62,6 @@ C: QRY 2 msmsgs@msnmsgr.com 32 8ba1bb9d6dbf624fee31a2053af5fdd0 S: 540 2 ``` - Server disconnects client. # Known changes diff --git a/docs/commands/rea.md b/docs/commands/rea.md index 3555f3c..d4dfc70 100644 --- a/docs/commands/rea.md +++ b/docs/commands/rea.md @@ -3,7 +3,8 @@ It is a Notification Server command, without either a request or response payload. -Renames a user. For the commands that replaced REA with a `MFN` property, read [PRP](prp.md) and [SBP](sbp.md). +Renames a user. +For the commands that replaced REA with a `MFN` property, read [PRP](prp.md) and [SBP](sbp.md). # Client/Request `REA TrID user-handle new-friendly-name` @@ -12,8 +13,8 @@ Where `user-handle` is the user handle that you'd like to change the friendly na If this is the current user's handle, the change will be announced via [NLN](nln.md) to all users on your Reverse List (RL) if they are not in your Block List (BL). -Where `new-friendly-name` is the friendly name you'd like to set. -Subject to server-side restrictions. +Where `new-friendly-name` is the friendly name you'd like to set, +which may be rejected for any reason by the server. # Server/Response `REA TrID list-version user-handle new-friendly-name` @@ -35,19 +36,19 @@ C: REA 2 anotheruser@hotmail.com different%20name S: REA 2 257 anotheruser@hotmail.com different%20name ``` -## Not allowed to be called that +## You are not allowed to have that name ``` C: REA 3 example@hotmail.com bad S: 209 3 ``` -## Can not change the friendly name of a user not in your lists +## You can not change the friendly name of a user that is not on any of your Lists ``` C: REA 4 ghost@hotmail.com ghost S: 216 4 ``` -## Rate limited, try again later +## You have been rate limited, try again later ``` C: REA 5 example@hotmail.com new%20name%201 S: REA 5 258 example@hotmail.com new%20name%201 diff --git a/docs/commands/reg.md b/docs/commands/reg.md index 5bddf77..36831b4 100644 --- a/docs/commands/reg.md +++ b/docs/commands/reg.md @@ -45,8 +45,7 @@ S: 224 2 ``` C: REG 3 30 example%20out%20of%20bounds%20group 0 ``` - -Server disconnects client +Server disconnects client. ### Group name extremely long *NOTE: This has been line-breaked. @@ -56,7 +55,6 @@ C: REG 4 0 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAAAA 0 ``` - Server disconnects client. ## Without list versions @@ -80,7 +78,6 @@ S: 224 6 ``` C: REG 7 30 still%20out%20of%20bounds ``` - Server disconnects client. ### Group name extremely long @@ -91,7 +88,6 @@ C: REG 8 0 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAAAA ``` - Server disconnects client. ### With group GUIDs @@ -113,7 +109,6 @@ S: 224 10 ``` C: REG 11 THIS0IS0-NOT0-A0VA-LID0-GUID0AT0ALL! very%20invalid%20GUID%20there ``` - Server disconnects client. ### Group name extremely long @@ -124,7 +119,13 @@ C: REG 12 d6deeacd-7849-4de4-93c5-d130915d0042 AAAAAAAAAAAAAAAAAAAA .. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ``` +Server disconnects client. +## Command removed +*Since [MSNP13](../versions/msnp13.md).* +``` +C: REG 13 f60efbe7-94af-4b16-b926-e4e10878d329 Other%20Friends +``` Server disconnects client. # Known changes diff --git a/docs/commands/rem.md b/docs/commands/rem.md index 6b56215..af41566 100644 --- a/docs/commands/rem.md +++ b/docs/commands/rem.md @@ -111,7 +111,13 @@ S: 225 11 ``` C: REM 12 RL anotheruser@hotmail.com ``` +Server disconnects client. +## Command removed +*Since [MSNP13](../versions/msnp13.md).* +``` +C: REM 13 FL anotheruser@hotmail.com +``` Server disconnects client. ## Asynchronous update diff --git a/docs/commands/rmg.md b/docs/commands/rmg.md index 86b1d4c..ff16bba 100644 --- a/docs/commands/rmg.md +++ b/docs/commands/rmg.md @@ -51,7 +51,6 @@ S: 230 3 ``` C: RMG 4 30 ``` - Server disconnects client. ### With group IDs @@ -79,7 +78,6 @@ S: 230 7 ``` C: RMG 8 30 ``` - Server disconnects client. ### With group GUIDs @@ -105,9 +103,15 @@ S: 230 11 #### Can not remove out-of-bounds groups ``` -C: RMG 8 THIS0IS0-NOT0-A0VA-LID0-GUID0AT0ALL! +C: RMG 12 THIS0IS0-NOT0-A0VA-LID0-GUID0AT0ALL! ``` +Server disconnects client. +## Command removed +*Since [MSNP13](../versions/msnp13.md).* +``` +C: RMG 13 f60efbe7-94af-4b16-b926-e4e10878d329 +``` Server disconnects client. # Known changes diff --git a/docs/commands/rng.md b/docs/commands/rng.md index 3866a21..3719187 100644 --- a/docs/commands/rng.md +++ b/docs/commands/rng.md @@ -65,7 +65,6 @@ S: RNG 987654331 10.0.1.200:1865 CKI 123456789.123456789.123456789 ``` C: RNG 1 ``` - Server disconnects client. # Known changes diff --git a/docs/commands/sbp.md b/docs/commands/sbp.md index ff5febd..16b8e1d 100644 --- a/docs/commands/sbp.md +++ b/docs/commands/sbp.md @@ -7,7 +7,7 @@ Sets a buddy's property in your cache to a specified value. For the command this replaced, read [REA](rea.md). # Client/Request -`SBP TrID contact-id property value` +`SBP TrID contact-id property value {unknown}` Where `contact-id` is the `C=` value from either [ADD](add.md) or [LST](lst.md). If you are using `ABCHMigrated: 0`, this is the contact's user handle. @@ -17,10 +17,14 @@ Where `property` are any of the values: * `MFN`: My Friendly Name * `MOB`: User can contact me via MSN Mobile, changed by the Client Capability. * `WWE`: User can contact me via MSN Direct, changed by the Client Capability. +* `PHM`: [MSNP11](../versions/msnp11.md)+: The user's mobile phone number. * `HSB`: [MSNP11](../versions/msnp11.md)+: Has blog, changed by the Client Capability. Where `value` is the URL-encoded value to set the related `property` to. +Where `unknown` is set to `1` if setting the `property` of `PHM`. Added since [MSNP11](../versions/msnp11.md) +(TODO: What does this mean?) + # Server/Response `SBP TrID contact-id property value` @@ -28,25 +32,42 @@ Same parameters as the request. # Examples -## Normal use - -### Without GUIDs +## Without GUIDs *Only with `ABCHMigrated: 0`.* + +### My friendly name ``` C: SBP 1 anotheruser@hotmail.com MFN another%20user S: SBP 1 anotheruser@hotmail.com MFN anoter%20user ``` -### With GUIDs +## With GUIDs *Only with `ABCHMigrated: 1`.* + +### My friendly name ``` C: SBP 2 c1f9a363-4ee9-4a33-a434-b056a4c55b98 MFN another%20user S: SBP 2 c1f9a363-4ee9-4a33-a434-b056a4c55b98 MFN another%20user ``` +### Contact mobile number +*Since [MSNP11](../versions/msnp11.md).* +*TODO: Is this correct? Needs mobile stuff enabled in msgrconfig.* +``` +C: SBP 3 c1f9a363-4ee9-4a33-a434-b056a4c55b95 PHM tel:+15554444333 1 +S: SBP 3 c1f9a363-4ee9-4a33-a434-b056a4c55b95 PHM tel:+15554444333 1 +``` + ## Errors None are currently known. If you know of one, please contact me. +## Command removed +*Since [MSNP13](../versions/msnp13.md).* +``` +C: SBP 4 c1f9a363-4ee9-4a33-a434-b056a4c55b98 MFN another%20user +``` +Server disconnects client. + # Known changes * [MSNP11](../versions/msnp11.md): Added support for `HSB` property. * [MSNP13](../versions/msnp13.md): Removed, use [Address Book Service](../services/abservice.md)'s `ABContactUpdate` action instead. diff --git a/docs/commands/sdc.md b/docs/commands/sdc.md index f55fb3d..1e9269f 100644 --- a/docs/commands/sdc.md +++ b/docs/commands/sdc.md @@ -1,7 +1,7 @@ # Introduction `SDC` is a command introduced with [MSNP5](../versions/msnp5.md). -It is a Notification Server command, with a request payload, but without a response payload. +It is a Notification Server command, WITH a request payload and without a response payload. Sends a service invitation to an e-mail address or directory user. For the version of this command that does not support friendly names, read [SND](snd.md). @@ -10,13 +10,13 @@ For the version of this command that does not support friendly names, read [SND] ``` SDC TrID target-address translation-lcid requesting-library client-identification X X my-friendly-name length payload -```` +``` Where `target-address` is the E-mail address or index from the last [FND](fnd.md) response you'd like to invite to the service. Where `translation-lcid` is the LCID of the translation you'd like the invitation to be in. -Where `requesting-library` is the name of the library that requested this CVR, usually `MSMSGS` or `MSNMSGR`. +Where `requesting-library` is the name of the library that sent this SDC, usually `MSMSGS` or `MSNMSGR`. Where `client-identification` is the internal name of the codebase used to create `requesting-library`, usually `MSMSGS`. @@ -76,7 +76,6 @@ S: SDC 6 OK C: SDC 7 anotheruser@hotmail.com 10 S: 503 7 ``` - Server disconnects client. # Known changes diff --git a/docs/commands/snd.md b/docs/commands/snd.md index 79b92fe..404bf41 100644 --- a/docs/commands/snd.md +++ b/docs/commands/snd.md @@ -14,7 +14,7 @@ Where `target-address` is the E-mail address or index from the last [FND](fnd.md Where `translation-lcid` is the LCID of the translation you'd like the invitation to be in. Added since [MSNP3](../versions/msnp3.md). -Where `requesting-library` is the name of the library that requested this CVR, usually `MSMSGS` or `MSNMSGR`. +Where `requesting-library` is the name of the library that sent this SND, usually `MSMSGS` or `MSNMSGR`. Added since [MSNP3](../versions/msnp3.md). Where `client-identification` is the internal name of the codebase used to create `requesting-library`, usually `MSMSGS`. @@ -29,20 +29,20 @@ Where `OK` is always `OK`. ## Normal use -### First generation +### E-mail only *Only in [MSNP2](../versions/msnp2.md).* ``` C: SND 1 anotheruser@hotmail.com S: SND 1 OK ``` -### Second generation +### With language ID and client library name *Only in [MSNP3](../versions/msnp3.md).* ``` C: SND 2 anotheruser@hotmail.com 0x0409 MSMSGS S: SND 2 OK ``` -### Third generation +### With the client internal name *Since [MSNP4](../versions/msnp4.md).* ``` C: SND 3 anotheruser@hotmail.com 0x0409 MSMSGS MSMSGS @@ -63,10 +63,9 @@ S: SND 5 OK C: SND 6 anotheruser@hotmail.com 10 S: 503 6 ``` - Server disconnects client. # Known changes * [MSNP3](../versions/msnp3.md): Added translation support and requesting library parameters. * [MSNP4](../versions/msnp4.md): Added client codebase parameter. -* [MSNP5](../versions/msnp5.md): Deprecated in place of [SDC](sdc.md). +* [MSNP5](../versions/msnp5.md): Deprecated. Use [SDC](sdc.md) instead. diff --git a/docs/commands/syn.md b/docs/commands/syn.md index f0178f4..15b8de4 100644 --- a/docs/commands/syn.md +++ b/docs/commands/syn.md @@ -249,12 +249,11 @@ S: LST N=anotheruser@hotmail.com F=another%20user C=c1f9a363-4ee9-4a33-a434-b056 S: BPR PHH 1%20(222)%20333%204444 ``` -## Removed +## Command removed *Since [MSNP13](../versions/msnp13.md).* ``` C: SYN 16 0 0 ``` - Server disconnects client. # Known changes diff --git a/docs/commands/ubx.md b/docs/commands/ubx.md index 808bc5b..6b29670 100644 --- a/docs/commands/ubx.md +++ b/docs/commands/ubx.md @@ -132,7 +132,6 @@ S: UUX anotheruser@hotmail.com 1 202 ``` C: UBX 1 0 ``` - Server disconnects client. # Known changes diff --git a/docs/commands/url.md b/docs/commands/url.md index 88aef6d..88f82a8 100644 --- a/docs/commands/url.md +++ b/docs/commands/url.md @@ -74,7 +74,7 @@ C: URL 4 MOBILE S: URL 4 http://mobile.msn.com/hotmail/confirmUser.asp?URL=%2Fmessengerok.htm&mobID=1 https://loginnet.passport.com/ppsecure/md5auth.srf?lc=1033 961 ``` -## Edit Member Directory Profile +## Edit Member Directory profile *Since [MSNP6](../versions/msnp3.md).* ``` C: URL 5 PROFILE 0x0409 diff --git a/docs/commands/usr.md b/docs/commands/usr.md index 28471c0..5b82c4f 100644 --- a/docs/commands/usr.md +++ b/docs/commands/usr.md @@ -20,7 +20,8 @@ Depending on the version of the protocol you are using, `security-package` can b * `CTP`: Clear Text Password. Only in [MSNP2](../versions/msnp2.md). * `MD5`: MD5-based authentication. Only in [MSNP2](../versions/msnp2.md) to [MSNP7](../versions/msnp7.md). * `TWN`: "Tweener", [Passport 1.4](../services/passport14.md) or compatible authentication service. Since [MSNP8](../versions/msnp8.md). -* `SSO`: Single Sign On, usually a more advanced [Passport (SOAP)](../services/passportsoap.md) authentication method. Since [MSNP15](../versions/msnp15.md). +* `SSO`: Single Sign On, using a more advanced version of the + [Passport Request Security Token service](../services/rst.md) based authentication method. Since [MSNP15](../versions/msnp15.md). ### The Subsequent request `USR TrID security-package S {...response-args}` @@ -29,9 +30,10 @@ Where `response-args` can be anything, but based on `security-package` it can be * `CTP`: Your password in plain text. * `MD5`: The server's login challenge concatenated with your password. * `TWN`: The `from-PP` parameter in the `Authentication-Info` header sent in response to [Passport 1.4](../services/passport14.md), - or if using [Passport (SOAP)](../services/passportsoap.md), the `` of the relevant ``. -* `SSO`: The same as [Passport (SOAP)](../services/passportsoap.md) in `TWN`, but with the extra parameter - being the custom challenge response encoded as base64. + or if using the [Passport Request Security Token service](../services/rst.md), + the `` of the relevant ``. +* `SSO`: The same as the [Passport Request Security Token service](../services/rst.md) + in `TWN`, but with the extra parameter being the custom challenge response encoded as base64. ## Switchboard Server `USR TrID user-handle cookie` @@ -120,15 +122,16 @@ C: USR 7 SSO I example@hotmail.com S: USR 7 SSO S MBI_KEY_OLD AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA= ``` -*The HTTPS interlude has been moved to the [Passport (SOAP)](../services/passportsoap.md) article.* +*The HTTPS interlude has been moved to the +[Passport Request Security Token service](../services/rst.md) article.* *The key-encryption interlude has been removed from here and is to reinstated as another article.* ``` -C: USR 8 SSO S t=ticket HAAAAAEAAAADZgAABIAAAAgAAAAUAAAASAAAAAA -.. AAAAAAAAA7XgT5ohvaZdoXdrWUUcMF2G8OK2JohyYcK5l5MJSitab33scxJe -.. K/RQXcUr0L+R2ZA9CEAzn0izmUzSMp2LZdxSbHtnuxCmptgtoScHp9E26HjQ -.. VkA9YJxgK/HM= +C: USR 8 SSO S t=ticket&p=HAAAAAEAAAADZgAABIAAAAgAAAAUAAAASAAAA +.. AAAAAAAAAAA7XgT5ohvaZdoXdrWUUcMF2G8OK2JohyYcK5l5MJSitab33scx +.. JeK/RQXcUr0L+R2ZA9CEAzn0izmUzSMp2LZdxSbHtnuxCmptgtoScHp9E26H +.. jQVkA9YJxgK/HM= S: USR 8 OK example@hotmail.com ``` @@ -139,7 +142,6 @@ S: USR 9 TWN S passport=parameters,neat=huh,lc=1033,id=507 C: USR 10 TWN S t=not*a*passport*ticket&p=not*a*profile*either S: 911 10 ``` - Server disconnects client. ### Child account not authorized @@ -150,7 +152,6 @@ S: USR 11 MD5 S 1234567890.123456789 C: USR 12 MD5 S f59af8f2fa91d38aff7c870c17f99903 S: 923 12 ``` - Server disconnects client. ### Account not verified @@ -165,7 +166,6 @@ S: USR 13 MD5 S 1234567890.123456789 C: USR 14 MD5 S f59af8f2fa91d38aff7c870c17f99903 S: 924 14 ``` - Server disconnects client. #### Soft warning @@ -187,7 +187,6 @@ S: USR 17 TWN S passport=parameters,neat=huh,lc=1033,id=507 C: USR 18 TWN S t=token&p=profile S: USR 18 OK example@hotmail.com example%20user 1 1 ``` - Client disconnects from server. ### Wrong server for this account @@ -195,7 +194,6 @@ Client disconnects from server. C: USR 19 TWN I example@hotmail.com S: 931 19 ``` - Server disconnects client. ## Switchboard Server diff --git a/docs/commands/uux.md b/docs/commands/uux.md index 7fce36e..6d6b54e 100644 --- a/docs/commands/uux.md +++ b/docs/commands/uux.md @@ -103,7 +103,6 @@ S: UUX 6 C: UUX 7 19 ``` - Server disconnects client. # Known changes diff --git a/docs/commands/ver.md b/docs/commands/ver.md index 9c6ebe0..7f71604 100644 --- a/docs/commands/ver.md +++ b/docs/commands/ver.md @@ -22,20 +22,20 @@ If the server's `preferred-dialect-name` is `0`, that means it doesn't want to u # Examples -## Unsupported Protocols +## No supported protocols ``` C: VER 1 DISREGARDANCE FOR A REAL PROTOCOL S: VER 1 0 ``` Server disconnects client. -## Supported Fallback Protocol +## Supported fallback protocol ``` C: VER 2 MSNP2 CVR0 S: VER 2 CVR0 ``` -## Supported Primary Protocol +## Supported primary protocol ``` C: VER 3 MSNP8 CVR0 S: VER 3 MSNP8 diff --git a/docs/commands/xfr.md b/docs/commands/xfr.md index 5892afe..92caf3e 100644 --- a/docs/commands/xfr.md +++ b/docs/commands/xfr.md @@ -66,9 +66,9 @@ S: XFR 1 SB 10.0.1.200:1865 CKI 123456789.123456789.123456789 C: XFR 2 NS S: XFR 2 NS 10.0.0.5:1863 ``` -Client disconnects from server +Client disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. ### Client referred from Dispatch Server @@ -78,9 +78,9 @@ Client opens a connection to 10.0.0.5:1863 C: USR 3 MD5 I example@hotmail.com S: XFR 3 NS 10.0.0.5:1863 ``` -Client disconnects from server +Client disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. #### Classic *Only in [MSNP3](../versions/msnp3.md) to [MSNP6](../versions/msnp6.md).* @@ -88,9 +88,9 @@ Client opens a connection to 10.0.0.5:1863 C: USR 4 MD5 I example@hotmail.com S: XFR 4 NS 10.0.0.5:1863 0 ``` -Client disconnects from server +Client disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. #### Modern *Only in [MSNP7](../versions/msnp7.md) to [MSNP12](../versions/msnp12.md).* @@ -98,9 +98,9 @@ Client opens a connection to 10.0.0.5:1863 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 disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. ## After rework *Since [MSNP13](../versions/msnp13.md).* diff --git a/docs/errors_and_hresults.md b/docs/errors_and_hresults.md new file mode 100644 index 0000000..b90af33 --- /dev/null +++ b/docs/errors_and_hresults.md @@ -0,0 +1,114 @@ +# Error codes and HRESULTs +The following is a list of all **known** MSNP error codes and related `HRESULT` values. +If you know any error that isn't listed, please contact me. + +For valid MSNP commands, read the [Table of Commands](table_of_commands.md). + +## MSNP error codes +| `MSNP ERROR CODE` | related `HRESULT` value | related `HRESULT`'s name | `DRAFT` name | Description / Known reason? | +| ----- | ------------ | -------------------------------------- | ------------------------------ | ------------------ | +| `200` | N/A | N/A | `ERR_SYNTAX_ERROR` | Syntax error. | +| `201` | `0x81000435` | `MSGR_E_MSNP_INVALID_PARAMETER` | `ERR_INVALID_PARAMETER` | Invalid parameter in command. | +| `203` | `0x810003c0` | `MSGR_E_INVALID_FEDERATED_USER` | N/A | ? | +| `204` | `0x8100037c` | `MSGR_E_UNROUTABLE_USER` | N/A | ? | +| `205` | `0x8100030a` | `MSGR_E_USER_NOT_FOUND` | `ERR_INVALID_USER` | The user is invalid. | +| `206` | `0x8100030a` | `MSGR_E_USER_NOT_FOUND` | `ERR_FQDN_MISSING` | The domain name of the user handle is missing. | +| `207` | `0x81000304` | `MSGR_E_ALREADY_LOGGED_ON` | `ERR_ALREADY_LOGIN` | You are already logged in. | +| `208` | `0x8100030a` | `MSGR_E_USER_NOT_FOUND` | `ERR_INVALID_USERNAME` | The username of the user handle is invalid. | +| `209` | `0x81000324` | `MSGR_E_INVALID_FRIENDLY_NAME` | `ERR_INVALID_FRIENDLY_NAME` | You cannot use that friendly name. | +| `210` | `0x81000307` | `MSGR_E_LIST_FULL` | `ERR_LIST_FULL` | That list is full. | +| `212` | `0x8100030d` | `MSGR_E_UNEXPECTED` | N/A | ? | +| `213` | `0x81000392` | `MSGR_E_USER_DOESNT_EXIST` | N/A | ? | +| `215` | `0x8100030b` | `MSGR_E_ALREADY_IN_LIST` | `ERR_ALREADY_THERE` | That user is already added to that list. | +| `216` | `0x8100030a` | `MSGR_E_USER_NOT_FOUND` | `ERR_NOT_ON_LIST` | This user is not on any of your lists. | +| `217` | `0x81000430` | `MSGR_E_MSNP_NOT_ACCEPTING_IMS` | N/A | That user is currently not accepting instant messages. | +| `218` | `0x01000301` | `MSGR_S_ALREADY_IN_THE_MODE` | `ERR_ALREADY_IN_THE_MODE` | You are already in the mode specified. | +| `219` | `0x81000431` | `MSGR_E_MSNP_ALREADY_IN_OPPOSITE_LIST` | `ERR_ALREADY_IN_OPPOSITE_LIST` | The user is in a mutually exclusive list and therefore can not be added to the specified one. | +| `220` | `0x81000335` | `MSGR_E_NOT_ACCEPTING_PAGES` | N/A | ? | +| `232` | `0x810003b5` | `MSGR_E_INVALID_MSISDN` | N/A | ? | +| `233` | `0x810003b6` | `MSGR_E_UNKNOWN_MSISDN` | N/A | ? | +| `234` | `0x81000439` | `MSGR_E_MSNP_UNKNOWN_KEITAI_DOMAIN` | N/A | ? | +| `240` | `0x8100043b` | `MSGR_E_MSNP_INVALID_XML` | N/A | ? | +| `241` | `0x8100043a` | `MSGR_E_MSNP_INVALID_XML_DATA` | N/A | ? | +| `280` | `0x81000436` | `MSGR_E_MSNP_SWITCHBOARD_FAILED` | `ERR_SWITCHBOARD_FAILED` | ? | +| `281` | N/A | N/A | `ERR_NOTIFY_XFR_FAILED` | ? | +| `300` | N/A | N/A | `ERR_REQUIRED_FIELDS_MISSING` | ? | +| `302` | N/A | N/A | `ERR_NOT_LOGGED_IN` | You need to log in to perform that action. | +| `400` | `0x81000376` | `MSGR_E_ABCH_READ_ONLY` | N/A | Your Address Book is read-only and can not be used. | +| `402` | `0x81000377` | `MSGR_E_ABCH_TOO_BUSY` | N/A | The Address Book service is currently too busy. | +| `403` | `0x81000378` | `MSGR_E_ABCH_UNAVAILABLE` | N/A | The Address Book service is currently unavaliable. | +| `413` | `0x810003a5` | `MSGR_E_SUBSCRIPTION_NEEDED` | N/A | ? | +| `414` | `0x810003a6` | `MSGR_E_SUBSCRIPTION_DISABLED` | N/A | ? | +| `416` | `0x810003c1` | `MSGR_E_MARKET_DISABLED` | N/A | ? | +| `417` | `0x810003c2` | `MSGR_E_DISABLED_EVERYWHERE` | N/A | ? | +| `418` | `0x810003c3` | `MSGR_E_TRY_AGAIN_LATER` | N/A | ? | +| `419` | `0x810003c4` | `MSGR_E_NO_MARKET_SPECIFIED` | N/A | ? | +| `420` | `0x810003cc` | `MSGR_E_INVITE_REQUIRED` | N/A | You need an invitation to use this version of the Official Client. | +| `500` | `0x810003a8` | `MSGR_E_INTERNAL_SERVER_ERROR` | `ERR_INTERNAL_SERVER` | Internal server error. | +| `501` | N/A | N/A | `ERR_DB_SERVER` | ? | +| `503` | `0x80004005` | `MSGR_E_FAIL` / `E_FAIL` | N/A | Unspecified failure. | +| `504` | `0x810003c5` | `MSGR_E_UPS_UNAVAILABLE` | N/A | ? | +| `505` | `0x810003c6` | `MSGR_E_SCS_UNAVAILABLE` | N/A | ? | +| `508` | `0x81000433` | `MSGR_E_MSNP_FEDERATED_SERVER_ERROR` | N/A | ? | +| `509` | `0x81000434` | `MSGR_E_MSNP_UUM_ERROR` | N/A | ? | +| `510` | N/A | N/A | `ERR_FILE_OPERATION` | ? | +| `511` | `0x81000603` | `MSGR_E_PPLATFORM_SERVER_511` | N/A | ? | +| `520` | `0x810003a8` | `MSGR_E_INTERNAL_SERVER_ERROR` | `ERR_MEMORY_ALLOC` | ? | +| `540` | `0x8100036d` | `MSGR_E_LOCKANDKEY_FAILED` | N/A | ? | +| `600` | `0x8100030e` | `MSGR_E_SERVER_TOO_BUSY` | `ERR_SERVER_BUSY` | ? | +| `601` | `0x81000314` | `MSGR_E_SERVER_UNAVAILABLE` | `ERR_SERVER_UNAVAILABLE` | The server is unavaliable at this time. | +| `602` | N/A | N/A | `ERR_PEER_NS_DOWN` | ? | +| `603` | N/A | N/A | `ERR_DB_CONNECT` | ? | +| `604` | N/A | N/A | `ERR_SERVER_GOING_DOWN` | ? | +| `606` | `0x81000339` | `MSGR_E_PAGING_UNAVAILABLE` | N/A | ? | +| `707` | N/A | N/A | `ERR_CREATE_CONNECTION` | ? | +| `710` | `0x81000339` | `MSGR_E_PAGING_UNAVAILABLE` | N/A | ? | +| `711` | N/A | N/A | `ERR_BLOCKING_WRITE` | ? | +| `712` | N/A | N/A | `ERR_SESSION_OVERLOAD` | ? | +| `713` | N/A | N/A | `ERR_USER_TOO_ACTIVE` | You are being too active. You have been rate limited. | +| `714` | N/A | N/A | `ERR_TOO_MANY_SESSIONS` | ? | +| `715` | `0x81000438` | `MSGR_E_MSNP_NOT_EXPECTED` | `ERR_NOT_EXPECTED` | Command not expected at that time. | +| `717` | N/A | N/A | `ERR_BAD_FRIEND_FILE` | ? | +| `718` | `0x8100035a` | `MSGR_E_RESTRICTED_USER` | N/A | ? | +| `719` | `0x810003c7` | `MSGR_E_FEDERATED_SESSION` | N/A | ? | +| `726` | `0x8100037d` | `MSGR_E_USER_FEDERATED` | N/A | ? | +| `729` | `0x8100030e` | `MSGR_E_SERVER_TOO_BUSY` | N/A | ? | +| `800` | `0x81000398` | `MSGR_E_RATE_LIMIT_EXCEEDED` | N/A | You are being rate limited. | +| `910` | `0x8100030e` | `MSGR_E_SERVER_TOO_BUSY` | N/A | The server is too busy to authenticate your user. | +| `911` | `0x81000395` | `MSGR_E_MSNP_911` | `ERR_AUTHENTICATION_FAILED` | Generic authentication failure. | +| `913` | `0x8100043c` | `MSGR_E_MSNP_NOT_ALLOWED_WHEN_OFFLINE` | `ERR_NOT_ALLOWED_WHEN_OFFLINE` | You may not do that while appearing offline or in semi-offline mode. | +| `917` | `0x81000327` | `MSGR_E_INVALID_DOMAIN` | N/A | The domain specified at authentication is invalid. | +| `918` | `0x810003a8` | `MSGR_E_INTERNAL_SERVER_ERROR` | N/A | ? | +| `919` | `0x810003a8` | `MSGR_E_INTERNAL_SERVER_ERROR` | N/A | ? | +| `920` | `0x81000326` | N/A | `ERR_NOT_ACCEPTING_NEW_USERS` | The server is too full and is no longer accepting new authentication requests. | +| `921` | `0x8100030e` | `MSGR_E_SERVER_TOO_BUSY` | N/A | The server is too busy to authenticate your user. | +| `922` | `0x8100030e` | `MSGR_E_SERVER_TOO_BUSY` | N/A | ? | +| `923` | `0x81000331` | `MSGR_E_CHILD_WITHOUT_CONSENT` | N/A | Child account does not have authorization to use the Messenger Service. | +| `924` | `0x81000336` | `MSGR_E_EMAIL_PASSPORT_NOT_VALIDATED` | N/A | You need to verify your account before using the Messenger Service. | +| `926` | `0x81000359` | `MSGR_E_MANAGED_USER_INVALID_CVR` | N/A | The account's permissions could not be verified. | +| `927` | `0x8100035a` | `MSGR_E_RESTRICTED_USER` | N/A | The parent or guardian of this account has blocked access of the Messenger Service using this account. | +| `928` | `0x81000303` | `MSGR_E_INVALID_PASSWORD` | N/A | The password provided is invalid. | +| `929` | `0x81000385` | `MSGR_E_LOCKANDKEY_FAILED_FOR_MCAA` | N/A | ? | +| `930` | `0x8100037b` | `MSGR_E_FEDERATED_DOMAIN` | N/A | This account belongs to a enterprise domain and can not be used on the Messenger Service. | +| `934` | `0x81000410` | `MSGR_E_FSS_USER_NO_ACCESS` | N/A | ? | + +## Common HRESULTS without related MSNP error codes +| related `HRESULT` value | related `HRESULT`'s name | Description / Known reason? | +| ------------ | ------------------------------------------------- | ------------- | +| `0x80004005` | `E_FAIL` | Unspecified failure. | +| `0x00048802` | `PPCRL_AUTHSTATE_S_AUTHENTICATED_OFFLINE` | You are logged in, but working offline. | +| `0x00048803` | `PPCRL_AUTHSTATE_S_AUTHENTICATED_PASSWORD` | You are logged in using a password. | +| `0x80048810` | `PPCRL_AUTHREQUIRED_E_PASSWORD` | Please input your password. | +| `0x80048800` | `PPCRL_AUTHSTATE_E_UNAUTHENTICATED` | You are not logged in. | +| `0x80048801` | `PPCRL_AUTHSTATE_E_EXPIRED` | Your session has expired. Please log in again. | +| `0x80048820` | `PPCRL_REQUEST_E_AUTH_SERVER_ERROR` | Authentication server error. | +| `0x80048821` | `PPCRL_REQUEST_E_BAD_MEMBER_NAME_OR_PASSWORD` | Invalid email address or password. | +| `0x80048823` | `PPCRL_REQUEST_E_PASSWORD_LOCKED_OUT` | This account's password is disabled and needs to be reset. | +| `0x80048825` | `PPCRL_REQUEST_E_TOU_CONSENT_REQUIRED` | You must accept the service's Terms of Use before using this account.| +| `0x80048826` | `PPCRL_REQUEST_E_FORCE_RENAME_REQUIRED` | Your account details needs to be revised. | +| `0x80048827` | `PPCRL_REQUEST_E_FORCE_CHANGE_PASSWORD_REQUIRED` | Your account's password needs to be changed. | +| `0x80048831` | `PPCRL_REQUEST_E_PASSWORD_EXPIRED` | Your account's password has expired and needs to be changed. | +| `0x80048836` | `PPCRL_REQUEST_E_EMAIL_VALIDATION_REQUIRED` | Your account's e-mail address must be verified. | +| `0x80070002` | System Error `ERROR_FILE_NOT_FOUND` | A file could not be found. | +| `0x80070057` | System Error `ERROR_INVALID_PARAMETER` | One or more parameters have invalid values. +| `0x80072f7d` | System Error `ERROR_WINHTTP_SECURE_CHANNEL_ERROR` | Any possible secure channel (SSL) error from WinHTTP. | diff --git a/docs/files/challenge_keypairs.md b/docs/files/challenge_keypairs.md index 3bb51a0..ae719df 100644 --- a/docs/files/challenge_keypairs.md +++ b/docs/files/challenge_keypairs.md @@ -41,7 +41,7 @@ Random characters in both cases will match the regular expression of | `PROD01065C%ZFN6F` | `O4BG@C7BWLYQX?5G` | Client Version 8.0.0328 (unconfirmed) | | `PROD0112J1LW7%NB` | `RH96F{PHI8PPX_TJ` | Client Version 8.0.0812 (unconfirmed) | | `PROD0113H11T8$X_` | `RG@XY*28Q5QHS%Q5` | Client Version 8.1.0168 (unconfirmed) | -| `PROD0114ES4Z%Q5W` | `PK}_A_0N_K%O?A9S` | Client Version 8.1.0178 (unconfirmed) | +| `PROD0114ES4Z%Q5W` | `PK}_A_0N_K%O?A9S` | Client Version 8.1.0178 (unconfirmed), Client Version 9.0.1407 (confirmed) | | `PROD0118R6%2WYOS` | `YIXPX@5I2P0UT*LK` | Client Version 8.5.1235 (unconfirmed) | | `PROD0119GSJUC$18` | `ILTXC!4IXB5FB*PX` | Client Version 8.5.1288 (unconfirmed) | -| `PROD0120PW!CCV9@` | `C1BX{V4W}Q3*10SM` | Client Version 14.0.8050 (unconfirmed)| +| `PROD0120PW!CCV9@` | `C1BX{V4W}Q3*10SM` | Client Version 14.0.8050 (confirmed) | diff --git a/docs/files/shields.md b/docs/files/shields.md index 00544a3..e8f2b4c 100644 --- a/docs/files/shields.md +++ b/docs/files/shields.md @@ -37,9 +37,9 @@ This empty attribute has 5 parameters: * `audio`: Audio Conversations. * `filexfer`: File transfer. * `hotlinks`: Web links. - If this feature is blocked URLs sent in the chat will not be formatted as links. - * `ddp`: Dynamic Display Pictures (Flash avatars). - * `winks`: Winks (Flash full chat window animations). + If this feature is blocked URLs sent in conversation windows will not be formatted as links. + * `ddp`: Dynamic Display Pictures (Flash-based profile pictures). + * `winks`: Winks (Flash-based full conversation window animations). ### block *Since [MSNP12](../versions/msnp12.md).* diff --git a/docs/index.md b/docs/index.md index a8e73be..32c756a 100644 --- a/docs/index.md +++ b/docs/index.md @@ -4,11 +4,11 @@ Welcome to yellows' MSNP wiki - "we actually have documentation" Why not visit the [Table of Commands](table_of_commands.md)? # License -Copyright (C) 2024 yellows111. +Copyright (C) 2024 yellows111. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; -with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. +with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the article entitled "[GNU Free Documentation License](license.md)". @@ -26,6 +26,7 @@ A copy of the license is included in the article entitled * [MSNP11](versions/msnp11.md) * [MSNP12](versions/msnp12.md) * [MSNP13](versions/msnp13.md) +* [MSNP14](versions/msnp14.md) More is to come soon! Hopefully! @@ -34,12 +35,13 @@ More is to come soon! Hopefully! * [Contact Sharing Service](services/sharingservice.md) * [Messenger Config Service](services/msgrconfig.md) * [Passport 1.4](services/passport14.md) -* [Passport (SOAP)](services/passportsoap.md) +* [Passport Request Security Token service](services/rst.md) More is to come soon! Hopefully! # Other documents and files * [Constants used on the wiki](reference_constants.md) +* [List of Error Codes and HRESULTs](errors_and_hresults.md) * [Shields Configuration Data](files/shields.md) * [`` documents](files/notification.md) * [Challenge key pairs](files/challenge_keypairs.md) @@ -54,7 +56,6 @@ More is to come soon! Hopefully! * [MSNP11](versions/msnp11.md): How does `ABCHMigrated: 0` really work now? `OUT MIG` still exists. * [MSNP12](versions/msnp12.md): Did [LST](commands/lst.md) change outside of [SYN](commands/syn.md) in this version? * [MSNP18](versions/msnp18.md): Did ``-based circle updates get added in [MSNP17](versions/msnp17.md) instead of [MSNP18](versions/msnp18.md)? -* Error Codes: A new article for them, seems like they are implemented in wildly different ways. * [MSNP2](versions/msnp2.md) to [MSNP7](versions/msnp7.md): TODO: Add CVR requests as command 10. * All Protocols: Any error code known to exist but is missing from the pages. * All Protocols: Good [CVR](commands/cvr.md) responses, all of them are their release versions, when they could be latest. @@ -104,7 +105,8 @@ More is to come soon! Hopefully! * `svcs.microsoft.com`: Usually a grab-bag of random XML files or services used for clients older than Client Version 6.0. * Protocol Split: A MSNP version that usually defines a point of no return. * PP14: [Passport SSI Version 1.4](services/passport14.md). -* PPSOAP: [Passport (SOAP)](services/passportsoap.md) that was implemented in Client Version 7.5+ ([MSNP12](versions/msnp12.md)). +* RST: The [Passport Request Security Token service](services/rst.md) that was implemented in Client Version 7.5+ ([MSNP12](versions/msnp12.md)). +* RST2: The second version of the Passport Request Security Token service that was implemented in Client Version 14.0+ ([MSNP18](versions/msnp18.md)) (TODO: Am I right about this?). * SOAP: Simple Object Access Protocol, A message schema based on XML. That's the kindest thing I can write about it. * Passport: The Authentication Server and/or Protocol. * Undefined Behaviour: An intentional blank left in the documentation, basically as a "I am not responsible for what this does to your client or server" warning. @@ -127,7 +129,7 @@ More is to come soon! Hopefully! An example of the Private Key is `Q1P7W2E4J9R8U3S5` or `YMM8C_H7KCQ2S_KL`. # Where can I find or edit the source of the articles provided? -The git repository for the project is avaliable at . +The git repository for the project is avaliable at . You can submit changes to me via any avaliable contact method as a e-mail merge request, like those made with [`git format-patch`](https://git-scm.com/docs/git-format-patch). diff --git a/docs/services/abservice.md b/docs/services/abservice.md index d99ab02..9d5237f 100644 --- a/docs/services/abservice.md +++ b/docs/services/abservice.md @@ -1,6 +1,6 @@ # Introduction -The Address Book Service (abservice) is a SOAP (XML) Web Service. -Introduced with [MSNP8](../versions/msnp8.md). +The Address Book Service (abservice), also known as the Address Book Clearing House (ABCH) is a SOAP (XML) Web Service. +It was introduced with [MSNP8](../versions/msnp8.md). It manages the link(s) between the E-mail Service Address Book and the Forward List (FL). diff --git a/docs/services/abservice/contactinfo.md b/docs/services/abservice/contactinfo.md index 998f973..bb9b70c 100644 --- a/docs/services/abservice/contactinfo.md +++ b/docs/services/abservice/contactinfo.md @@ -10,6 +10,7 @@ This element can contain many children, all of which optional: * ``: The type of contact this is related to: * `LivePending`: A user yet to authorise you * `Regular`: A user from another service. + * `Me`: My own user. * ``: The display name for this contact. * ``: Unused. Always 0. * ``: The Common ID of this contact, which is a signed 64-bit integer. diff --git a/docs/services/passport14.md b/docs/services/passport14.md index f3c76d1..af6f67e 100644 --- a/docs/services/passport14.md +++ b/docs/services/passport14.md @@ -2,7 +2,8 @@ Passport 1.4, or "Tweener", as it's sometimes called, is an HTTP-based authentication system that was introduced with [MSNP8](../versions/msnp8.md). -For [MSNP12](../versions/msnp12.md) and above, read the [Passport (SOAP)](passportsoap.md) article. +For [MSNP12](../versions/msnp12.md) and above, read the [Passport Request Security Token service](rst.md) article. +For [MSNP18](../versions/msnp18.md) and above, read the Request Security Token service, version 2 article. # Nexus The Passport Nexus is a server that provides information to other parties about how to use Passport. diff --git a/docs/services/passportsoap.md b/docs/services/rst.md similarity index 98% rename from docs/services/passportsoap.md rename to docs/services/rst.md index 368013a..88fe1b9 100644 --- a/docs/services/passportsoap.md +++ b/docs/services/rst.md @@ -1,10 +1,11 @@ # Introduction -Passport (SOAP), or "Passport 3.0" as it's sometimes called, +The Passport Request Security Token (RST) service, or "Passport 3.0" as it's sometimes called, is a HTTP-based authentication system that was introduced with [MSNP12](../versions/msnp12.md). -The endpoint is called `RST.srf`, residing on either the `login.passport.net` or `login.live.com` domain. +The endpoint is called `RST.srf`, residing on either the `login.passport.net` or the `login.live.com` domain. -For [MSNP8](../versions/msnp8.md) to [MSNP11](../versions/msnp11.md), read the [Passport 1.4](passport14.md) article. +For [MSNP8](../versions/msnp8.md) to [MSNP11](../versions/msnp11.md), read the [Passport 1.4](passport14.md) article. +For [MSNP18](../versions/msnp18.md) and above, read the Request Security Token service, version 2 article. (TODO: Write this, and did I get this right?) # Client/Request The following sub-headers are XML elements for the client's request. diff --git a/docs/services/sharingservice.md b/docs/services/sharingservice.md index c87e314..af78e5d 100644 --- a/docs/services/sharingservice.md +++ b/docs/services/sharingservice.md @@ -1,13 +1,13 @@ # Introduction The Contact Sharing Service (SharingService) is a SOAP (XML) Web Service. -Introduced with [MSNP13](../versions/msnp13.md). +It was introduced with [MSNP13](../versions/msnp13.md). It manages the Messenger Service's Allow List (AL), Block List (BL), Reverse List (RL), and Pending List (PL) members. It's default HTTP URL is `http://byrdr.omega.contacts.msn.com/abservice/SharingService.asmx`. It's default HTTPS URL is `https://byrdr.omega.contacts.msn.com/abservice/SharingService.asmx`. -This service requires [Passport authentication](passportsoap.md). +This service requires [Passport authentication](rst.md). Related: [Address Book Service](abservice.md) (for Forward List (FL) members). diff --git a/docs/table_of_commands.md b/docs/table_of_commands.md index d6002b3..743b9ff 100644 --- a/docs/table_of_commands.md +++ b/docs/table_of_commands.md @@ -1,9 +1,10 @@ # Table of Commands - This is a list of all known MSNP commands and their originating version. +For negative responses to these commands, read the [Error Code and HRESULTs](errors_and_hresults.md) article. + | `COMMAND` | Payload (Y/N) | Client to Server (Y/N) | Server to Client (Y/N) | Originating Version | Changed? (version list) | -| ----- | - | - | -| ------ | ----- | +| ------------------------ | - | - | - | -------------------------- | ---- | | [`VER`](commands/ver.md) | N | Y | N | [MSNP2](versions/msnp2.md) | every MSNP version, but retaining base syntax, removed in MSNP24 | | [`INF`](commands/inf.md) | N | Y | N | [MSNP2](versions/msnp2.md) | [MSNP3](versions/msnp3.md) (removed CTP), [MSNP8](versions/msnp8.md) (Removed; automatic disconnect) | | [`CVR`](commands/cvr.md) | N | Y | N | [MSNP2](versions/msnp2.md) | [MSNP4](versions/msnp4.md) (parameter 7), [MSNP8](versions/msnp8.md) (parameter 8) | @@ -30,14 +31,14 @@ This is a list of all known MSNP commands and their originating version. | [`LST`](commands/lst.md) | N | Y | Y\*| [MSNP2](versions/msnp2.md) | [MSNP7](versions/msnp7.md) (Added groups support), [MSNP8](versions/msnp8.md) ([SYN](commands/syn.md): removed iterator parameters, condensed all lists into a single parameter, removed List Version), [MSNP10](versions/msnp10.md) (Added prefixes to contact's handle and friendly name, and added a GUID parameter if `ABCHMigrated: 1`. Also changed group IDs to GUIDs.), [MSNP12](versions/msnp12.md) (Added network IDs), [MSNP13](versions/msnp13.md) (Removed; automatic disconnect, use [Address Book Service](services/abservice.md)'s [`ABFindAll`](services/abservice/abfindall.md) and [Contact Sharing Service](services/sharingservice.md)'s [`FindMembership`](services/sharingservice/findmembership.md) instead.), November 2003 (Removed outside of [SYN](commands/syn.md), not really any specific MSNP update, just hard removed with an automatic disconnect.) | | [`ADD`](commands/add.md) | N | Y | Y | [MSNP2](versions/msnp2.md) | [MSNP7](versions/msnp7.md) (Added groups support), [MSNP10](versions/msnp10.md) (Removed; automatic disconnect, use [ADC](commands/adc.md) instead) | | [`REM`](commands/rem.md) | N | Y | Y | [MSNP2](versions/msnp2.md) | [MSNP7](versions/msnp7.md) (Added groups support), [MSNP10](versions/msnp10.md) (Replaced user handles with GUIDs if list is the Forward List (FL), and removed list versions from all responses), [MSNP13](versions/msnp13.md) (Removed; automatic disconnect, replaced with RML and [Address Book Service](services/abservice.md)'s [`ABContactDelete`](services/abservice/abcontactdelete.md) and [Contact Sharing Service](services/sharingservice.md)'s [`DeleteMember`](services/sharingservice/deletemember.md) instead) | -| [`FLN`](commands/fln.md) | N | N | Y | [MSNP2](versions/msnp2.md) | [MSNP14](versions/msnp14.md) (Added Network ID parameter) | +| [`FLN`](commands/fln.md) | N | N | Y | [MSNP2](versions/msnp2.md) | [MSNP14](versions/msnp14.md) (Added Network ID parameter, Client Capabilities parameter and optional Presense Icon URL parameter), [MSNP16](versions/msnp16.md) (Added support for the Extended Client Capabilities, changing the original Client Capabilities parameter to now be delimited by a colon) | | [`PNG`](commands/png.md) | N | Y | N | [MSNP2](versions/msnp2.md) | | | [`QNG`](commands/qng.md) | N | N | Y | [MSNP2](versions/msnp2.md) | [MSNP9](versions/msnp9.md) (Added next seconds parameter) | | [`URL`](commands/url.md) | N | Y | N | [MSNP2](versions/msnp2.md) | [MSNP3](versions/msnp3.md) (Added Passport Site ID support as parameter 3), removed `PASSWORD` service), [MSNP5](versions/msnp5.md) (Added `MOBILE` and `CHGMOB` services), [MSNP6](versions/msnp6.md) (Added `PROFILE`, `N2PACCOUNT` and `N2PFUND` services), [MSNP7](versions/msnp7.md) (Added `CHAT` service), [MSNP8](versions/msnp8.md) (Added `ADDRBOOK`, `ADVSEARCH` and `INTSEARCH` services) | | [`LSG`](commands/lsg.md) | N | Y | Y\*| [MSNP7](versions/msnp7.md) | [MSNP8](versions/msnp8.md) (Removed iterator and List Version parameters from [SYN](commands/syn.md) version), [MSNP10](versions/msnp10.md) (Removed unused parameter, and replaced Group IDs with Group GUIDs if `ABCHMigrated: 1`.), [MSNP13](versions/msnp13.md) (Removed; automatic disconnect, use [Address Book Service](services/abservice.md)'s [`ABFindAll`](services/abservice/abfindall.md) instead.) November 2003 (Removed outside of [SYN](commands/syn.md), not really any specific MSNP update, just hard removed with an automatic disconnect.) | | [`ADG`](commands/adg.md) | N | Y | N | [MSNP7](versions/msnp7.md) | [MSNP10](versions/msnp10.md) (Removed unused `0` and List Version parameters, and replaced Group IDs with Group GUIDs if `ABCHMigrated: 1`), [MSNP13](versions/msnp13.md) (Removed; automatic disconnect?, use [Address Book Service](services/abservice.md) [`ABGroupAdd`](services/abservice/abgroupadd.md) instead.) | -| [`ILN`](commands/iln.md) | N | N | Y | [MSNP2](versions/msnp2.md) | [MSNP8](versions/msnp8.md) (Added support for Client Capabilities), [MSNP9](versions/msnp9.md) (Added optional MSNObject parameter), [MSNP14](versions/msnp14.md) (Added Network ID parameter and optional Presence Icon URL parameter), [MSNP16](versions/msnp16.md) (Support for the Extended Client Capabilities, changing the original Client Capabilities parameter to now be delimited by a colon) | -| [`NLN`](commands/nln.md) | N | N | Y | [MSNP2](versions/msnp2.md) | [MSNP8](versions/msnp8.md) (Added support for Client Capabilities), [MSNP9](versions/msnp9.md) (Added optional MSNObject parameter), [MSNP14](versions/msnp14.md) (Added Network ID parameter and optional Presence Icon URL parameter), [MSNP16](versions/msnp16.md) (Support for the Extended Client Capabilities, changing the original Client Capabilities parameter to now be delimited by a colon) | +| [`ILN`](commands/iln.md) | N | N | Y | [MSNP2](versions/msnp2.md) | [MSNP8](versions/msnp8.md) (Added support for Client Capabilities), [MSNP9](versions/msnp9.md) (Added optional MSNObject parameter), [MSNP14](versions/msnp14.md) (Added Network ID parameter and optional Presence Icon URL parameter), [MSNP16](versions/msnp16.md) (Added support for the Extended Client Capabilities, changing the original Client Capabilities parameter to now be delimited by a colon) | +| [`NLN`](commands/nln.md) | N | N | Y | [MSNP2](versions/msnp2.md) | [MSNP8](versions/msnp8.md) (Added support for Client Capabilities), [MSNP9](versions/msnp9.md) (Added optional MSNObject parameter), [MSNP14](versions/msnp14.md) (Added Network ID parameter and optional Presence Icon URL parameter), [MSNP16](versions/msnp16.md) (Added support for the Extended Client Capabilities, changing the original Client Capabilities parameter to now be delimited by a colon) | | [`REA`](commands/rea.md) | N | Y | N | [MSNP2](versions/msnp2.md) | [MSNP10](versions/msnp10.md) (Removed; automatic disconnect) | | [`SND`](commands/snd.md) | N | Y | N | [MSNP2](versions/msnp2.md) | [MSNP3](versions/msnp3.md) (parameters 2 and 3), [MSNP4](versions/msnp4.md) (parameter 4), [MSNP5](versions/msnp5.md) (obsoleted by [SDC](commands/sdc.md)) | | [`SDC`](commands/sdc.md) | Y | Y | N | [MSNP5](versions/msnp5.md) | | diff --git a/docs/versions/cvr0.md b/docs/versions/cvr0.md index 171fda9..c9f55a0 100644 --- a/docs/versions/cvr0.md +++ b/docs/versions/cvr0.md @@ -1,5 +1,5 @@ # Introduction -CVR0 is a subprotocol of the Mobile Status Notification Protocol. +CVR0 is a subprotocol of the Mobile Status Notification Protocol. It was introduced officially in Client Version 1.0.0863, along with [MSNP2](msnp2.md). It is used for requesting the latest client information in case no other protocols were supported. @@ -8,8 +8,6 @@ It is used for requesting the latest client information in case no other protoco It introduces the commands: * [CVQ](../commands/cvq.md) -*No error codes were known to be introduced in this version* - *No commands were known to be removed in this version* # Known changes diff --git a/docs/versions/msnp10.md b/docs/versions/msnp10.md index 18fcd46..c6d104e 100644 --- a/docs/versions/msnp10.md +++ b/docs/versions/msnp10.md @@ -1,5 +1,5 @@ # Introduction -MSNP10 is the ninth released version of the Mobile Status Notification Protocol. +MSNP10 is the ninth released version of the Mobile Status Notification Protocol. It was introduced officially in Client Version 6.1.0155. # Command information @@ -9,8 +9,6 @@ It introduces the notification service commands: *No switchboard or dispatch service commands were known to be introduced in this version* -*No error codes were known to be introduced in this version* - The following commands were removed in this version: * [ADD](../commands/add.md) (automatic disconnection) * [REA](../commands/rea.md) (automatic disconnection?) @@ -49,9 +47,6 @@ The following commands were removed in this version: This list contains users that have unhandled "contact added you" notifications. * Added new server-side [OUT](../commands/out.md) reasons: `MIG`, if the server has migrated you to ABCH, and `TOU`, for not accepting the Service Terms of Use. -* Official Client: Now handles the 604, 914, 916 error codes again, - which were last seen in Client Version 3.6.003x. - Error code 913 is no longer handled after being implemented in Client Version 4.5. * First protocol version to remove a core command implemented since [MSNP2](msnp2.md) draft ([ADD](../commands/add.md)). # Client-server communication example @@ -67,9 +62,9 @@ S: CVR 2 6.1.0211 6.1.0211 6.1.0155 C: USR 3 TWN I example@hotmail.com S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863 ``` -Client disconnects from server +Client disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. ``` C: VER 4 MSNP10 MSNP9 CVR0 S: VER 4 MSNP10 @@ -122,9 +117,9 @@ C: CHG 9 NLN S: CHG 9 NLN S: OUT MIG ``` -Server disconnects client +Server disconnects client. -Client opens a connection to 10.0.0.5:1863 (from stored server) +Client opens a connection to `10.0.0.5:1863` (from stored server). ``` C: VER 10 MSNP10 MSNP9 CVR0 S: VER 10 MSNP10 @@ -174,8 +169,8 @@ C: CHG 15 NLN S: CHG 15 NLN C: OUT ``` -Client disconnects from server +Client disconnects from server. ``` S: OUT ``` -Server disconnects client +Server disconnects client. diff --git a/docs/versions/msnp11.md b/docs/versions/msnp11.md index dc2afb5..6a1e008 100644 --- a/docs/versions/msnp11.md +++ b/docs/versions/msnp11.md @@ -1,5 +1,5 @@ # Introduction -MSNP11 is the tenth released version of the Mobile Status Notification Protocol. +MSNP11 is the tenth released version of the Mobile Status Notification Protocol. It was introduced officially in Client Version 7.0.0777. # Command information @@ -12,8 +12,6 @@ It introduces the notification service commands: *No switchboard or dispatch service commands were known to be introduced in this version* -*No error codes were known to be introduced in this version* - *No commands were known to be removed in this version* # Known changes @@ -39,14 +37,13 @@ It introduces the notification service commands: [``](../files/notification.md) sub-documents are supported for spaces (blogs). * Official Client: Messenger Config requests now support regional arguments via SOAP. * Official Client: [OUT](../commands/out.md) SSD is actually implemented now. -* Official Client: Error code 913 is handled again after being removed last version. Why? # Client-server communication example *NOTE: This has been line-breaked. Lines beginning with `..` followed by a space are continuations of the previous line.* ``` -C: VER 1 MSNP10 MSNP9 CVR0 -S: VER 1 MSNP10 +C: VER 1 MSNP11 MSNP10 MSNP9 CVR0 +S: VER 1 MSNP11 C: CVR 2 0x0409 winnt 5.1 i386 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com S: CVR 2 6.1.0211 6.1.0211 6.1.0155 .. http://download.microsoft.com/download/8/3/C/83C4B2DB-AC1C-4B56-8144-4472C0982F21/SetupDl.exe @@ -54,12 +51,12 @@ S: CVR 2 6.1.0211 6.1.0211 6.1.0155 C: USR 3 TWN I example@hotmail.com S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863 ``` -Client disconnects from server +Client disconnects from server. -Client opens a connection to 10.0.0.5:1863 (from stored server) +Client opens a connection to `10.0.0.5:1863`. ``` -C: VER 4 MSNP10 MSNP9 CVR0 -S: VER 4 MSNP10 +C: VER 4 MSNP11 MSNP10 MSNP9 CVR0 +S: VER 4 MSNP11 C: CVR 5 0x0409 winnt 5.1 i386 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com S: CVR 5 6.1.0211 6.1.0211 6.1.0155 .. http://download.microsoft.com/download/8/3/C/83C4B2DB-AC1C-4B56-8144-4472C0982F21/SetupDl.exe @@ -152,8 +149,8 @@ S: NOT 1264 C: OUT ``` -Client disconnects from server +Client disconnects from server. ``` S: OUT ``` -Server disconnects client +Server disconnects client. diff --git a/docs/versions/msnp12.md b/docs/versions/msnp12.md index a06d012..296c267 100644 --- a/docs/versions/msnp12.md +++ b/docs/versions/msnp12.md @@ -1,5 +1,5 @@ # Introduction -MSNP12 is the eleventh released version of the Mobile Status Notification Protocol. +MSNP12 is the eleventh released version of the Mobile Status Notification Protocol. It was introduced officially in Client Version 7.5.0299. # Command information @@ -8,8 +8,6 @@ It introduces the notification service commands: *No switchboard or dispatch service commands were known to be introduced in this version* -*No error codes were known to be introduced in this version* - *No commands were known to be removed in this version* # Known changes @@ -17,8 +15,10 @@ It introduces the notification service commands: * Network IDs are introduced, each bit represents a contact's service, with bit 0/decimal 1 being MSNP. * Switchboard commands [JOI](../commands/joi.md) and [IRO](../commands/iro.md) have a new parameter for the [Client Capabilities](../files/client_capabilities.md) of the relevant user. -* [LST](../commands/lst.md) has the Network ID after the list bits (on any list), but before the Group ID (if on Forward List (FL)). -* Official Client: Uses Passport 3.0 (via the Microsoft Identity Common Runtime Library). +* [LST](../commands/lst.md) has the Network ID after the list bits (on any list), + but before the Group ID (if contact is on the Forward List (FL)). +* Official Client: Now uses the [Passport Request Security Token service](../services/rst.md), + via the Microsoft Identity Common Runtime Library. * Official Client: Dropped support for older operating systems, Now requires Windows XP or higher. * Official Client: Now supports Voice Clips, which can be disabled in the [Messenger Config](../services/msgrconfig.md). * Official Client: [Shield Configuration Data](../files/shields.md) can now block file hashes and @@ -37,9 +37,9 @@ S: CVR 2 6.1.0211 6.1.0211 6.1.0155 C: USR 3 TWN I example@hotmail.com S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863 ``` -Client disconnects from server +Client disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. ``` C: VER 4 MSNP12 MSNP11 MSNP10 CVR0 S: VER 4 MSNP12 @@ -49,10 +49,11 @@ S: CVR 5 6.1.0211 6.1.0211 6.1.0155 .. http://messenger.msn.com C: USR 6 TWN I example@hotmail.com ``` -*The HTTPS interlude is described in the [Passport (SOAP)](../services/passportsoap.md) article.* +*The HTTPS interlude is described in the +[Passport Request Security Token service](../services/rst.md) article.* ``` S: USR 6 TWN S passport=parameters,neat=huh,lc=1033,id=507 -C: USR 7 TWN S $(xmldecode(passportsoap.BinarySecurityToken#Compact1)) +C: USR 7 TWN S $(xmldecode(RequestSecurityTokenResponse.BinarySecurityToken#Compact1)) S: USR 7 OK example@hotmail.com 1 0 S: SBS 0 null S: MSG Hotmail Hotmail 465 @@ -99,8 +100,8 @@ C: UUX 11 53 S: UUX 11 0 C: OUT ``` -Client disconnects from server +Client disconnects from server. ``` S: OUT ``` -Server disconnects client +Server disconnects client. diff --git a/docs/versions/msnp13.md b/docs/versions/msnp13.md index 556c58d..9664c81 100644 --- a/docs/versions/msnp13.md +++ b/docs/versions/msnp13.md @@ -1,5 +1,5 @@ # Introduction -MSNP13 is the twelfth released version of the Mobile Status Notification Protocol. +MSNP13 is the twelfth released version of the Mobile Status Notification Protocol. It was introduced officially in Client Version 8.0.0787, along with [MSNP14](msnp14.md). # Command information @@ -13,8 +13,6 @@ It introduces the notification service commands: *No switchboard or dispatch service commands were known to be introduced in this version* -*No error codes were known to be introduced in this version* - The following commands were removed in this version: * [ADC](../commands/adc.md) (automatic disconnection) * [ADG](../commands/adc.md) (automatic disconnection) @@ -33,7 +31,7 @@ The following commands were removed in this version: The unused parameter from [MSNP3](msnp3.md) and the current server parameter from [MSNP7](msnp7.md) have been replaced with two new parameters, one containing `U`, and one containing a `D`. The use of these parameters is unknown. -* The [Passport (SOAP)](../services/passportsoap.md) authentication request +* The [Passport Request Security Token service](../services/rst.md) authentication request will now include a request for few more security tokens, notably `contacts.msn.com` for the [Address Book Service](../services/abservice.md). * Replaced [SYN](../commands/syn.md) with both the @@ -90,9 +88,9 @@ S: CVR 2 8.0.0566 8.0.0566 8.0.0566 C: USR 3 TWN I example@hotmail.com S: XFR 3 NS 10.0.0.5:1863 U D ``` -Client disconnects from server +Client disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. ``` C: VER 4 MSNP13 CVR0 S: VER 4 MSNP13 @@ -102,7 +100,8 @@ S: CVR 5 8.0.0566 8.0.0566 8.0.0566 .. http://ideas.live.com C: USR 6 TWN I example@hotmail.com ``` -*The HTTPS interlude is described in the [Passport (SOAP)](../services/passportsoap.md) article.* +*The HTTPS interlude is described in the +[Passport Request Security Token service](../services/rst.md) article.* ``` S: USR 6 TWN S passport=parameters,neat=huh,lc=1033,id=507 S: GCF 0 201 @@ -117,7 +116,7 @@ S: GCF 0 201 -C: USR 7 TWN S $(xmldecode(passportsoap.BinarySecurityToken#Compact1)) +C: USR 7 TWN S $(xmldecode(RequestSecurityTokenResponse.BinarySecurityToken#Compact1)) S: USR 7 OK example@hotmail.com 1 0 S: SBS 0 null S: MSG Hotmail Hotmail 481 diff --git a/docs/versions/msnp14.md b/docs/versions/msnp14.md index 6e3e32a..650001d 100644 --- a/docs/versions/msnp14.md +++ b/docs/versions/msnp14.md @@ -1,5 +1,5 @@ # Introduction -MSNP14 is the thirteenth released version of the Mobile Status Notification Protocol. +MSNP14 is the thirteenth released version of the Mobile Status Notification Protocol. It was introduced officially in Client Version 8.0.0787, along with [MSNP13](../versions/msnp13.md). # Command information @@ -11,8 +11,6 @@ It introduces the notificaiton service commands: *No switchboard or dispatch service commands were known to be introduced in this version* -*No error codes were known to be introduced in this version* - *No commands were known to be removed in this version* # Known changes @@ -22,7 +20,10 @@ It introduces the notificaiton service commands: * [RNG](../commands/rng.md) and [XFR](../commands/xfr.md) SB commands now have an extra parameter to specify if the address should be connected to directly or only via the HTTP Gateway. * [ILN](../commands/iln.md), [NLN](../commands/nln.md) and [FLN](../commands/fln.md) - now have an extra parameter for the Network ID of the network that generated the new status. + now have a few extra parameters: + * One for the Network ID of the network that generated the new status. + * One for the current Client Capabilities of the user. + * Finally, one to specify what icon to use to denote a user from another service. * Official Client: Yahoo! Messenger interoperability is now supported. The [FQY](../command/fqy.md) command is used to discover if a user is from the Yahoo! Messenger network. This is represented in the [Address Book Service](../services/abservice.md) as a email-only contact @@ -30,8 +31,6 @@ It introduces the notificaiton service commands: This is also represented in the [Contact Sharing Service](../services/sharingservice.md) as a e-mail membership, with the `MSN.IM.BuddyType` annotation set to `32:`. The Network ID 32 (bit 6) is used to specify that this user is from the Yahoo! Messenger service. -* [ILN](../commands/iln.md) and [NLN](../commands/nln.md) now include a new parameter - that specifies what icon to use to denote a user from another service. # Client-server communication example *NOTE: This has been line-breaked. @@ -46,9 +45,9 @@ S: CVR 2 8.0.0566 8.0.0566 8.0.0566 C: USR 3 TWN I example@hotmail.com S: XFR 3 NS 10.0.0.5:1863 U D ``` -Client disconnects from server +Client disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. ``` C: VER 4 MSNP14 MSNP13 CVR0 S: VER 4 MSNP14 @@ -58,7 +57,8 @@ S: CVR 5 8.0.0566 8.0.0566 8.0.0566 .. http://ideas.live.com C: USR 6 TWN I example@hotmail.com ``` -*The HTTPS interlude is described in the [Passport (SOAP)](../services/passportsoap.md) article.* +*The HTTPS interlude is described in the +[Passport Request Security Token service](../services/rst.md) article.* ``` S: USR 6 TWN S passport=parameters,neat=huh,lc=1033,id=507 S: GCF 0 201 @@ -73,7 +73,7 @@ S: GCF 0 201 -C: USR 7 TWN S $(xmldecode(passportsoap.BinarySecurityToken#Compact1)) +C: USR 7 TWN S $(xmldecode(RequestSecurityTokenResponse.BinarySecurityToken#Compact1)) S: USR 7 OK example@hotmail.com 1 0 S: SBS 0 null S: MSG Hotmail Hotmail 465 diff --git a/docs/versions/msnp2.md b/docs/versions/msnp2.md index 37a277d..e1fedd5 100644 --- a/docs/versions/msnp2.md +++ b/docs/versions/msnp2.md @@ -1,5 +1,5 @@ # Introduction -MSNP2 is the first released version of the Mobile Status Notification Protocol. +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 @@ -26,7 +26,7 @@ It introduces the notification service commands: * [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) +* [REA](../commands/rea.md) (not in draft, despite alluding to it) * [REM](../commands/rem.md) * [RNG](../commands/rng.md) * [SND](../commands/snd.md) (not in draft) @@ -48,51 +48,6 @@ It introduces the switchboard service commands: * [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 @@ -108,9 +63,9 @@ 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 disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. ``` C: VER 4 MSNP2 CVR0 S: VER 4 MSNP2 @@ -147,8 +102,8 @@ S: REA 13 5 example@hotmail.com example%20user S: FLN anotheruser@hotmail.com C: OUT ``` -Client disconnects from server +Client disconnects from server. ``` S: OUT ``` -Server disconnects client +Server disconnects client. diff --git a/docs/versions/msnp3.md b/docs/versions/msnp3.md index 74f089d..a3756e4 100644 --- a/docs/versions/msnp3.md +++ b/docs/versions/msnp3.md @@ -1,5 +1,5 @@ # Introduction -MSNP3 is the second released version of the Mobile Status Notification Protocol. +MSNP3 is the second released version of the Mobile Status Notification Protocol. It was introduced officially in Client Version 2.0.0085. # Command information @@ -8,14 +8,6 @@ It introduces the notification service commands: *No switchboard or dispatch commands were known to be introduced in this version* -It introduces the error codes: -* 131 -* 212 -* 217 -* 716 -* 800 -* 917 - *No commands were known to be removed in this version* # Known changes @@ -53,32 +45,6 @@ It introduces the error codes: * Official Client: Removed [URL](../commands/url.md) service `PASSWORD`. * Official Client: Disabled inviting people to the service (needs confirmation). -## Changes to error codes -*Only applies for the Official Client.* - -### Re-added -*Where the parenthesis are the last version that had the error.* - -* 208 (draft) -* 215 (draft) -* 501 (draft) -* 604 (draft) -* 715 (draft) -* 913 (draft) -* 917 (draft) - -### Removed -* 146 -* 206 -* 207 -* 211 -* 218 -* 503 -* 510 -* 914 -* 918 -* 919 - # Client-server communication example ``` C: VER 1 MSNP3 MSNP2 CVR0 @@ -88,9 +54,9 @@ S: INF 2 MD5 C: USR 3 MD5 I example@hotmail.com S: XFR 3 NS 10.0.0.5:1863 0 ``` -Client disconnects from server +Client disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. ``` C: VER 4 MSNP3 MSNP2 CVR0 S: VER 4 MSNP3 @@ -134,8 +100,8 @@ C: SND 12 anotheruser@hotmail.com 0x0409 MSMSGS S: SND 12 OK C: OUT ``` -Client disconnects from server +Client disconnects from server. ``` S: OUT ``` -Server disconnects client +Server disconnects client. diff --git a/docs/versions/msnp4.md b/docs/versions/msnp4.md index 7293eb5..78f188f 100644 --- a/docs/versions/msnp4.md +++ b/docs/versions/msnp4.md @@ -1,12 +1,10 @@ # Introduction -MSNP4 is the third released version of the Mobile Status Notification Protocol. +MSNP4 is the third released version of the Mobile Status Notification Protocol. It was introduced officially in Client Version 2.1.1047. # Command information *No commands for any service were known to be introduced in this version* -*No error codes were known to be introduced in this version* - *No commands were known to be removed in this version* # Known changes @@ -19,18 +17,6 @@ It was introduced officially in Client Version 2.1.1047. which when sent as a [USR](../commands/usr.md) response, shows the "Sorry, this Kids Passport account does not have permission to access this service" dialog. -## Changes to error codes -*Only applies for the Official Client.* - -### Re-added -*Where the parenthesis are the last version that had the error.* - -* 208 (draft) -* 500 - -### Removed -None. - # Client-server communication example ``` C: VER 1 MSNP4 MSNP3 CVR0 @@ -40,9 +26,9 @@ S: INF 2 MD5 C: USR 3 MD5 I example@hotmail.com S: XFR 3 NS 10.0.0.5:1863 0 ``` -Client disconnects from server +Client disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. ``` C: VER 4 MSNP4 MSNP3 CVR0 S: VER 4 MSNP4 @@ -82,8 +68,8 @@ C: SND 10 anotheruser@hotmail.com 0x0409 MSMSGS MSMSGS S: SND 10 OK C: OUT ``` -Client disconnects from server +Client disconnects from server. ``` S: OUT ``` -Server disconnects client +Server disconnects client. diff --git a/docs/versions/msnp5.md b/docs/versions/msnp5.md index 51de4d9..bf9796c 100644 --- a/docs/versions/msnp5.md +++ b/docs/versions/msnp5.md @@ -1,5 +1,5 @@ # Introduction -MSNP5 is the fourth released version of the Mobile Status Notification Protocol. +MSNP5 is the fourth released version of the Mobile Status Notification Protocol. It was introduced officially in Client Version 3.0.0283. # Command information @@ -12,9 +12,6 @@ It introduces the notification service commands: *No switchboard or dispatch service commands were known to be introduced in this version* -It introduces the error codes: -* 922 - *No commands were known to be removed in this version* # Known changes @@ -38,27 +35,6 @@ It introduces the error codes: which when sent as a [USR](../commands/usr.md) response, shows the "Sorry, you can not sign in until your verify that (user handle) really belongs to you" dialog. -## Changes to error codes -*Only applies for the Official Client.* - -### Re-added -*Where the parenthesis are the last version that had the error.* - -* 211 ([MSNP2](msnp2).md) -* 503 -* 510 -* 914 ([MSNP2](msnp2).md) -* 919 ([MSNP2](msnp2).md) - -### Removed -* 131 -* 209 -* 212 -* 500 -* 501 -* 912 -* 913 - # Client-server communication example ``` C: VER 1 MSNP5 MSNP4 CVR0 @@ -68,9 +44,9 @@ S: INF 2 MD5 C: USR 3 MD5 I example@hotmail.com S: XFR 3 NS 10.0.0.5:1863 0 ``` -Client disconnects from server +Client disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. ``` C: VER 4 MSNP5 MSNP4 CVR0 S: VER 4 MSNP5 @@ -133,8 +109,8 @@ S: PRP 10 7 PHH 123%20(4567) S: BPR 8 anotheruser@hotmail.com PHH 1%20(222)%20333%204444 C: OUT ``` -Client disconnects from server +Client disconnects from server. ``` S: OUT ``` -Server disconnects client +Server disconnects client. diff --git a/docs/versions/msnp6.md b/docs/versions/msnp6.md index 4d5f7a3..e618e85 100644 --- a/docs/versions/msnp6.md +++ b/docs/versions/msnp6.md @@ -1,5 +1,5 @@ # Introduction -MSNP6 is the fifth released version of the Mobile Status Notification Protocol. +MSNP6 is the fifth released version of the Mobile Status Notification Protocol. It was introduced officially in Client Version 3.6.0038. # Command information @@ -10,12 +10,7 @@ It introduces the notification service commands: *No switchboard or dispatch service commands were known to be introduced in this version* -*No error codes were known to be introduced in this version* - -It introduces the error codes: -* 540 -* 915 -* 916 +*No commands were known to be removed in this version* # Known changes (from [MSNP5](msnp5.md)): @@ -31,17 +26,6 @@ It introduces the error codes: * Official Client: Added new [URL](../commands/url.md) services `PROFILE`, `N2PACCOUNT` and `N2PFUND`. * Official Client: Error 924 dialog changed to the unverified but still can use service one. Not sure why. -## Changes to error codes -*Only applies for the Official Client.* - -### Re-added -None. - -### Removed -* 215 -* 219 -* 919 - # Client-server communication example ``` C: VER 1 MSNP6 MSNP5 MSNP4 CVR0 @@ -51,9 +35,9 @@ S: INF 2 MD5 C: USR 3 MD5 I example@hotmail.com S: XFR 3 NS 10.0.0.5:1863 0 ``` -Client disconnects from server +Client disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. ``` C: VER 4 MSNP6 MSNP5 MSNP4 CVR0 S: VER 4 MSNP6 @@ -110,8 +94,8 @@ S: IPG 478 C: OUT ``` -Client disconnects from server +Client disconnects from server. ``` S: OUT ``` -Server disconnects client +Server disconnects client. diff --git a/docs/versions/msnp7.md b/docs/versions/msnp7.md index afe43b4..5e45344 100644 --- a/docs/versions/msnp7.md +++ b/docs/versions/msnp7.md @@ -1,5 +1,5 @@ # Introduction -MSNP7 is the sixth released version of the Mobile Status Notification Protocol. +MSNP7 is the sixth released version of the Mobile Status Notification Protocol. It was introduced officially in Client Version 4.5.0121. # Command information @@ -11,17 +11,6 @@ It introduces the notification service commands: *No switchboard or dispatch service commands were known to be introduced in this version* -It introduces the error codes: -* 224 -* 225 -* 226 -* 229 -* 230 -* 502 -* 710 -* 921 -* 924 - *No commands were known to be removed in this version* # Known changes @@ -41,30 +30,6 @@ It introduces the error codes: * Official Client: Added new [URL](../commands/url.md) service `CHAT`. * Official Client: Removed [URL](../commands/url.md) services `N2PACCOUNT` and `N2PFUND`. -## Changes to error codes -*Only applies for the Official Client.* - -### Re-added -*Where the parenthesis are the last version that had the error.* - -* 131 -* 146 -* 603 -* 604 -* 913 ([MSNP4](msnp4.md)) -* 918 ([MSNP2](msnp2.md)) - -### Removed -* 503 -* 601 -* 604 -* 715 -* 716 -* 914 -* 915 -* 916 -* 920 - # Client-server communication example ``` C: VER 1 MSNP7 MSNP6 MSNP5 MSNP4 CVR0 @@ -74,9 +39,9 @@ S: INF 2 MD5 C: USR 3 MD5 I example@hotmail.com S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863 ``` -Client disconnects from server +Client disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. ``` C: VER 4 MSNP7 MSNP6 MSNP5 MSNP4 CVR0 S: VER 4 MSNP7 @@ -142,8 +107,8 @@ C: RMG 14 2 S: RMG 14 14 2 C: OUT ``` -Client disconnects from server +Client disconnects from server. ``` S: OUT ``` -Server disconnects client +Server disconnects client. diff --git a/docs/versions/msnp8.md b/docs/versions/msnp8.md index 2b4d507..7561f51 100644 --- a/docs/versions/msnp8.md +++ b/docs/versions/msnp8.md @@ -1,12 +1,10 @@ # Introduction -MSNP8 is the seventh released version of the Mobile Status Notification Protocol. +MSNP8 is the seventh released version of the Mobile Status Notification Protocol. It was introduced officially in Client Version 5.0.0537. # Command information *No commands for any service were known to be introduced in this version* -*No error codes were known to be introduced in this version* - The following commands were removed in this version: * [INF](../commands/inf.md) (automatic disconnection) * [FND](../commands/fnd.md) (`502` by July 2003, see Known changes for client details.) @@ -43,7 +41,7 @@ The following commands were removed in this version: You can now tell other clients what features you support. * Official Client: Connectivity field added to application requests to notify the other user about what the network conditions are. -* Official Client: Introduced ABCH (Address Book Clearing House) support. +* Official Client: Introduced support for the [Address Book Service](../services/abservice.md). The URL is gathered from `svcs.microsoft.com`. `abch_config.asp` provides an XML document with a `` element. It has a `` element containing the service URL, a `` element, @@ -51,12 +49,6 @@ The following commands were removed in this version: `http://contacts.msn.com/abservice/abservice.asmx`, `0` and `0.0` respectively. * Official Client: Added new [URL](../commands/url.md) services `ADDRBOOK`, `ADVSEARCH` and `INTSEARCH` -## Changes to error codes -TODO: this section - -Added: 603 - - # Client-server communication example *NOTE: This has been line-breaked. Lines beginning with `..` followed by a space are continuations of the previous line.* @@ -70,9 +62,9 @@ S: CVR 2 5.0.0537 5.0.0537 1.0.0863 C: USR 3 TWN I example@hotmail.com S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863 ``` -Client disconnects from server +Client disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. ``` C: VER 4 MSNP8 CVR0 S: VER 4 MSNP8 @@ -126,8 +118,8 @@ S: NLN NLN anotheruser@hotmail.com another%20user 2 S: NLN NLN anotheruser@hotmail.com another%20user 28 C: OUT ``` -Client disconnects from server +Client disconnects from server. ``` S: OUT ``` -Server disconnects client +Server disconnects client. diff --git a/docs/versions/msnp9.md b/docs/versions/msnp9.md index 0ae3579..27a3439 100644 --- a/docs/versions/msnp9.md +++ b/docs/versions/msnp9.md @@ -1,5 +1,5 @@ # Introduction -MSNP9 is the eighth released version of the Mobile Status Notification Protocol. +MSNP9 is the eighth released version of the Mobile Status Notification Protocol. It was introduced officially in Client Version 6.0.0312. # Command information @@ -8,9 +8,6 @@ It introduces the notification service commands: *No switchboard or dispatch service commands were known to be introduced in this version* -It introduces the error codes: -* 282 - The following commands were removed in this version: * [PAG](../commands/pag.md) (returns 715) * [LST](../commands/lst.md) (Only client-initated, the one in [SYN](../commands/syn.md) is kept, @@ -26,8 +23,6 @@ The following commands were removed in this version: * Switchboard [MSG](../commands/msg.md): Acknowledgement type D added. Can respond with either [ACK](../commands/ack.md), error 282, or possibly any other error codes. * [NOT](../commands/not.md): Extended notifications are now supported via the `` element. -* Official Client: Error 603 is handled again after being removed in Client Version 5.0. - Error code 711 is no longer handled after being implemented in Client Version 5.0. * Official Client: Supports the [Messenger Config](../services/msgrconfig.md) XML service, replacing `svcs.microsoft.com`. # Client-server communication example @@ -43,9 +38,9 @@ S: CVR 2 6.0.0602 6.0.0602 6.0.0268 C: USR 3 TWN I example@hotmail.com S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863 ``` -Client disconnects from server +Client disconnects from server. -Client opens a connection to 10.0.0.5:1863 +Client opens a connection to `10.0.0.5:1863`. ``` C: VER 4 MSNP9 MSNP8 CVR0 S: VER 4 MSNP9 @@ -114,8 +109,8 @@ S: NOT 457 C: OUT ``` -Client disconnects from server +Client disconnects from server. ``` S: OUT ``` -Server disconnects client +Server disconnects client. diff --git a/package-lock.json b/package-lock.json index 5af210c..91b428e 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,15 +1,15 @@ { "name": "yellows-msnp-wiki", - "version": "0.1.4", + "version": "0.2.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "yellows-msnp-wiki", - "version": "0.1.4", + "version": "0.2.0", "license": "GFDL-1.3-or-later", "dependencies": { - "yiki": "git+https://git.kevinthe.horse/yellows111/yiki.git#semver:*" + "yiki": "git+https://git.computernewb.com/yellows111/yiki.git#semver:*" } }, "node_modules/@liquify/prettify": { diff --git a/package.json b/package.json index 0cb972b..662d3f7 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "yellows-msnp-wiki", - "version": "0.1.4", + "version": "0.2.0", "description": "The yellows111 MSNP wiki that aims for accuracy.", "author": "yellows111", "license": "GFDL-1.3-or-later", diff --git a/templates/command.md b/templates/command.md index 3660d29..013b5c7 100644 --- a/templates/command.md +++ b/templates/command.md @@ -33,13 +33,12 @@ S: xxx 3 ## Invalid argument *NOTE: This is an assumption. The actual error code here is unknown. -It may also lead to an Instant Disconnection.* +It may also lead to an Instant Disconnection.* *NOTE: There is no defined behavour for this command specifically.* ``` C: xxx 4 something wrong to go here S: 201 ``` - Server disconnects client. # Known changes diff --git a/templates/msnpver.md b/templates/msnpver.md index f7b8d42..4ae8b9f 100644 --- a/templates/msnpver.md +++ b/templates/msnpver.md @@ -1,14 +1,10 @@ # Introduction - -MSNPx is the nth released version of the Mobile Status Notification Protocol. +MSNPx is the nth released version of the Mobile Status Notification Protocol. It was introduced officially in Client Version y.y.yyyy. # Command information - *No commands for any service were known to be introduced in this version* -*No error codes were known to be introduced in this version* - *No commands were known to be removed in this version* # Known changes @@ -26,11 +22,9 @@ S: CVR 2 6.0.0602 6.0.0602 6.0.0268 http://download.microsoft.com/download/8/a/4 C: USR 3 TWN I example@hotmail.com S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863 ``` +Client disconnects from server. -Client disconnects from server - -Client opens a connection to 10.0.0.5:1863 - +Client opens a connection to `10.0.0.5:1863` ``` C: VER 4 MSNPx MSNPx-1 CVR0 S: VER 4 MSNPx