yellows111/msnp-wiki
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
msnp-wiki/docs/commands/nln.md
yellows111 f267b61dde
ILN, NLN, REA, SND, ADG, LSG, and MSNP4 changes 
information for MSNP4 found: adds the client codebase parameter to SND and CVR (and an empty to CVQ, but that lasted all the way to MSNP7 lol, does that for MSNP3 fallback too which is kind of funny)

18 commands left.
2024-10-18 23:52:48 +01:00

4 KiB
Raw Blame History

Introduction

NLN is a command introduced with MSNP2.

It is a Notification Server command, without a response payload.

Specifies that a user has now came online. For the version sent with a Transaction ID as a response to some commands, read ILN.

Client/Request

This command can not be sent from the client.

Server/Response

NLN status user-handle {network-id} friendly-name {client-capabilities{:extended-client-capabilities}} {msnobj} {presence-icon-url}

Where status is any of the defined statuses:

  • NLN: Online
  • BSY: Busy
  • IDL: Idle
  • BRB: Be Right Back
  • AWY: Away
  • PHN: On The Phone
  • LUN: Out To Lunch
  • HDN: Appear Offline (previously Invisible, Valid but should never be sent.)
  • FLN: Offline (Valid but should never be sent.)

Where user-handle is the relevant user's handle.

Where network-id is the Network Identification Number. Added since MSNP14.

Where friendly-name is the relevant user's friendly name.

Where client-capabilities are the relevant user's Client Capabilities. Optional? Added since MSNP8.

Where extended-client-capabilities are the relevant user's Extended Client Capabilities. Optional. Added since MSNP16.

Where msnobj is the MSNObject the relevant user has set. Optional. Added since MSNP9.

Where presence-icon-url is an image that is rendered to this client that replaces the default user icon. Optional. Added since MSNP14.

Examples

Wihout anything special

S: NLN NLN anotheruser@example.com another%20user

With Client Capabilities

Since MSNP8.

S: NLN NLN anotheruser@example.com another%20user 0

With a MSNObject

Since MSNP9.

NOTE: This has been line-breaked. Lines beginning with .. followed by a space are continuations of the previous line.

S: NLN NLN anotheruser@hotmail.com another%20user 268435500 %3Cmsnobj%20Creator%3D%22anotherdude%40hotmail.com%22
.. %20Size%3D%2225235%22%20Type%3D%223%22
.. %20Location%3D%22uexA4DE.dat%22%20Friendly%3D%22AAA%3D%22
.. %20SHA1D%3D%22vP1ppB+xiFQ8ceZivRe0uCaYLIU%3D%22
.. %20SHA1C%3D%22PApbbjkbDSGrt3ybGHRKNaZ8s%2Fw%3D%22%2F%3E

With Network IDs and Presence Icon URLs

Since MSNP14.

NOTE: This has been line-breaked. Lines beginning with .. followed by a space are continuations of the previous line.

S: NLN NLN anotheruser@hotmail.com 1 another%20user insert-wlm-8-cid-here %3Cmsnobj%20Creator%3D%22anotherdude%40hotmail.com%22
.. %20Size%3D%2225235%22%20Type%3D%223%22
.. %20Location%3D%22uexA4DE.dat%22%20Friendly%3D%22AAA%3D%22
.. %20SHA1D%3D%22vP1ppB+xiFQ8ceZivRe0uCaYLIU%3D%22
.. %20SHA1C%3D%22PApbbjkbDSGrt3ybGHRKNaZ8s%2Fw%3D%22%2F%3E
..  http://example.com/interop/online.png

With Extended Client Capabilities

Since MSNP16.

NOTE: This has been line-breaked. Lines beginning with .. followed by a space are continuations of the previous line.

S: NLN NLN anotheruser@hotmail.com 1 another%20user 2789003324:48 %3Cmsnobj%20Creator%3D%22anotherdude%40hotmail.com%22
.. %20Size%3D%2225235%22%20Type%3D%223%22
.. %20Location%3D%22uexA4DE.dat%22%20Friendly%3D%22AAA%3D%22
.. %20SHA1D%3D%22vP1ppB+xiFQ8ceZivRe0uCaYLIU%3D%22
.. %20SHA1C%3D%22PApbbjkbDSGrt3ybGHRKNaZ8s%2Fw%3D%22%2F%3E
..  http://example.com/interop/online.png

Invalid context

Inherited from being an unimplemented command.

C: NLN FLN example@hotmail.com example%20user

Server disconnects client.

Known changes

  • MSNP8: Added a parameter for Client Capabilities.
  • MSNP9: Added a parameter for the MSNObject.
  • MSNP14: Added a way to override the default presense icon, and added a new non-optional Network ID parameter.
  • MSNP16: Added Extended Client Capabilities support to the Client Capabilities parameter, delimited by a colon.