63 lines
1.9 KiB
Markdown
63 lines
1.9 KiB
Markdown
# Introduction
|
|
`FND` is a command introduced with [MSNP2](../versions/msnp2.md).
|
|
|
|
It is a Notification Server command, without either a request or response payload.
|
|
|
|
Searches for other users on the Network Directory.
|
|
|
|
# Client/Request
|
|
`FND TrID fname=first lname=last city=city state=ST country=CC`
|
|
|
|
Where `first` is the URL-encoded string representation of the first name to search users for.
|
|
|
|
Where `last` is the URL-encoded string representation of the last name to search users for.
|
|
|
|
Where `city` is the URL-encoded string representation of the city to search users in (`*` is allowed, and required for countries outside of `US`.).
|
|
|
|
Where `ST` is a 2-character string representation of the state to search users in (`*` is allowed, and required for countries outside of `US`.).
|
|
|
|
Where `CC` is a 2-character string representation of the country to search users in (`*` is allowed).
|
|
|
|
# Server/Response
|
|
`FND TrID 1 1 fname=Example lname=Name city=Somewhere state=OK country=US`
|
|
|
|
This command, despite having an iterator, can not span across multiple packets.
|
|
Instead, error 301 is returned in cases where the result would be too large to respond as one packet.
|
|
|
|
# Examples
|
|
|
|
## Valid, with users
|
|
```
|
|
C: FND 1 fname=Another lname=User city=* state=* country=US
|
|
S: FND 1 1 2 fname=Another lname=User city=New%20York state=NY country=US
|
|
FND 1 2 2 fname=Another lname=User city=Stillwater state=OK country=US
|
|
```
|
|
|
|
## Valid, no users
|
|
```
|
|
C: FND 2 fname=Another lname=User city=* state=* country=DE
|
|
S: FND 2 0 0
|
|
```
|
|
|
|
## Invalid parameter
|
|
```
|
|
C: FND 3 fname=Another lname=* city=* state=* country=*
|
|
S: 201 3
|
|
```
|
|
|
|
## Too many users
|
|
```
|
|
C: FND 4 fname=Another lname=User city=* state=* country=*
|
|
S: 301 4
|
|
```
|
|
|
|
## Removed
|
|
```
|
|
C: FND 5 fname=Another lname=User city=* state=* country=US
|
|
S: 502 5
|
|
```
|
|
|
|
# Known changes
|
|
* [MSNP5](../versions/msnp5.md): Changed related [SND](snd.md) command to [SDC](sdc.md).
|
|
* Soft-removed in April 2003, uses error 502, which was added in [MSNP7](../versions/msnp7.md).
|