2024-10-15 13:14:20 -04:00
|
|
|
# Introduction
|
2024-10-16 16:12:41 -04:00
|
|
|
`RNG` is a command introduced with [MSNP2](../versions/msnp2.md).
|
2024-10-15 13:14:20 -04:00
|
|
|
|
|
|
|
|
It is a Notification Server command, without a response payload.
|
|
|
|
|
|
|
|
|
|
Used to invite ("ring") you to a Switchboard session.
|
|
|
|
|
|
|
|
|
|
# Client/Request
|
|
|
|
|
This command can not be sent from the client.
|
|
|
|
|
|
|
|
|
|
# Server/Response
|
|
|
|
|
`RNG session-id address:port CKI cookie inviter-handle inviter-friendly-name`
|
|
|
|
|
|
|
|
|
|
Where `session-id` is the Switchboard session identification number you need in [ANS](ans.md).
|
|
|
|
|
|
|
|
|
|
Where `address:port` is the server you need to connect to join the conversation.
|
|
|
|
|
|
|
|
|
|
Where `CKI` is always `CKI`.
|
|
|
|
|
|
2024-10-23 16:47:02 -04:00
|
|
|
Where `cookie` is the Switchboard cookie, to be used in [USR](usr.md) and [ANS](ans.md).
|
2024-10-15 13:14:20 -04:00
|
|
|
|
|
|
|
|
Where `inviter-handle` is the inviter's handle.
|
|
|
|
|
|
|
|
|
|
Where `inviter-handle` is the inviter's friendly name.
|
|
|
|
|
|
|
|
|
|
# Examples
|
|
|
|
|
|
|
|
|
|
## Getting a Switchboard invite
|
|
|
|
|
```
|
|
|
|
|
S: RNG 987654331 10.0.1.200:1865 CKI 123456789.123456789.123456789 anotheruser@hotmail.com another%20user
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Invalid context
|
|
|
|
|
*Inherited from being an unimplemented command.*
|
|
|
|
|
```
|
|
|
|
|
C: RNG 1
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Server disconnects client.
|
|
|
|
|
|
|
|
|
|
# Known changes
|
|
|
|
|
None.
|
