43 lines
1.0 KiB
Markdown
43 lines
1.0 KiB
Markdown
|
# Introduction
|
||
|
|
`RNG` is a command introduced with [MSNP2](../commands/msnp2.md).
|
||
|
|
|
||
|
|
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`.
|
||
|
|
|
||
|
|
Where `cookie` is the Switchboard cookie, to be used in USR and [ANS](ans.md).
|
||
|
|
|
||
|
|
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.
|