yellows111
f267b61dde
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.
121 lines
4.5 KiB
Markdown
121 lines
4.5 KiB
Markdown
# Introduction
|
|
`ILN` is a command introduced with [MSNP2](../versions/msnp2.md).
|
|
|
|
It is a Notification Server command, without a response payload.
|
|
|
|
Specifies that a user was already online by the time the client was.
|
|
For the version of this command without the Transaction ID that is sent at any time, read [NLN](nln.md).
|
|
|
|
This command is sent after the initial [CHG](chg.md) command, using it's Transaction ID.
|
|
It may also be sent as a follow-up to a [ADD](add.md), ADC or ADL command, using it's Transaction ID.
|
|
|
|
# Client/Request
|
|
This command can not be sent from the client.
|
|
|
|
# Server/Response
|
|
`ILN TrID 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](../versions/msnp14.md).
|
|
|
|
Where `friendly-name` is the relevant user's friendly name.
|
|
|
|
Where `client-capabilities` are the relevant user's Client Capabilities. Optional? Added since [MSNP8](../versions/msnp8.md).
|
|
|
|
Where `extended-client-capabilities` are the relevant user's Extended Client Capabilities.
|
|
Optional. Added since [MSNP16](../versions/msnp16.md).
|
|
|
|
Where `msnobj` is the MSNObject the relevant user has set. Optional. Added since [MSNP9](../versions/msnp9.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
|
|
|
|
## Wihout anything special
|
|
```
|
|
C: CHG 1 NLN
|
|
S: CHG 1 NLN
|
|
S: ILN 1 NLN anotheruser@example.com another%20user
|
|
```
|
|
|
|
## With Client Capabilities
|
|
*Since [MSNP8](../versions/msnp8.md).*
|
|
```
|
|
C: CHG 2 NLN 1
|
|
S: CHG 2 NLN 1
|
|
S: ILN 2 NLN anotheruser@example.com another%20user 0
|
|
```
|
|
|
|
## With a MSNObject
|
|
*Since [MSNP9](../versions/msnp9.md).*
|
|
|
|
*NOTE: This has been line-breaked.
|
|
Lines beginning with `..` followed by a space are continuations of the previous line.*
|
|
```
|
|
C: CHG 3 NLN 268435500
|
|
S: CHG 3 NLN 268435500
|
|
S: ILN 3 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](../versions/msnp14.md).*
|
|
|
|
*NOTE: This has been line-breaked.
|
|
Lines beginning with `..` followed by a space are continuations of the previous line.*
|
|
```
|
|
C: CHG 4 NLN insert-wlm-8-cid-here
|
|
S: CHG 4 NLN insert-wlm-8-cid-here
|
|
S: ILN 4 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](../versions/msnp16.md).*
|
|
|
|
*NOTE: This has been line-breaked.
|
|
Lines beginning with `..` followed by a space are continuations of the previous line.*
|
|
```
|
|
C: CHG 5 NLN 2789003324:48
|
|
S: CHG 5 NLN 2789003324:48
|
|
S: ILN 5 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: ILN 6 FLN example@hotmail.com example%20user
|
|
```
|
|
|
|
Server disconnects client.
|
|
|
|
# Known changes
|
|
* [MSNP8](../versions/msnp8.md): Added a parameter for Client Capabilities.
|
|
* [MSNP9](../versions/msnp9.md): Added a parameter for the MSNObject.
|
|
* [MSNP14](../versions/msnp14.md): Added a way to override the default presense icon, and added a new non-optional Network ID parameter.
|
|
* [MSNP16](../versions/msnp16.md): Added Extended Client Capabilities support to the Client Capabilities parameter, delimited by a colon.
|