69 lines
2.1 KiB
Markdown
69 lines
2.1 KiB
Markdown
# Introduction
|
|
`REA` is a command introduced with [MSNP2](../versions/msnp2.md).
|
|
|
|
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).
|
|
|
|
# Client/Request
|
|
`REA TrID user-handle new-friendly-name`
|
|
|
|
Where `user-handle` is the user handle that you'd like to change the friendly name of.
|
|
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.
|
|
|
|
# Server/Response
|
|
`REA TrID list-version user-handle new-friendly-name`
|
|
|
|
Where `list-version` is the new List Version.
|
|
|
|
# Examples
|
|
|
|
## Changing my friendly name
|
|
```
|
|
C: REA 1 example@hotmail.com new%20name
|
|
S: REA 1 256 example@hotmail.com new%20name
|
|
```
|
|
|
|
## Changing a stored friendly name
|
|
```
|
|
S: NLN NLN anotheruser@hotmail.com different%20name
|
|
C: REA 2 anotheruser@hotmail.com different%20name
|
|
S: REA 2 257 anotheruser@hotmail.com different%20name
|
|
```
|
|
|
|
## Not allowed to be called that
|
|
```
|
|
C: REA 3 example@hotmail.com bad
|
|
S: 209 3
|
|
```
|
|
|
|
## Can not change the friendly name of a user not in your lists
|
|
```
|
|
C: REA 4 ghost@hotmail.com ghost
|
|
S: 216 4
|
|
```
|
|
|
|
## Rate limited, try again later
|
|
```
|
|
C: REA 5 example@hotmail.com new%20name%201
|
|
S: REA 5 258 example@hotmail.com new%20name%201
|
|
C: REA 6 example@hotmail.com new%20name%202
|
|
S: REA 6 258 example@hotmail.com new%20name%202
|
|
C: REA 7 example@hotmail.com new%20name%203
|
|
S: REA 7 258 example@hotmail.com new%20name%203
|
|
C: REA 8 example@hotmail.com new%20name%204
|
|
S: REA 8 258 example@hotmail.com new%20name%204
|
|
C: REA 9 example@hotmail.com new%20name%205
|
|
S: REA 9 258 example@hotmail.com new%20name%205
|
|
C: REA 10 example@hotmail.com new%20name%206
|
|
S: 800 10
|
|
```
|
|
|
|
# Known changes
|
|
* [MSNP10](../versions/msnp10.md): Removed (automatic disconnection?).
|
|
Use [PRP](prp.md) `MFN` to change your own friendly name, and [SBP](sbp.md) `MFN` to change stored friendly names.
|