Chapter 9. Finder Protocol

Finder protocol is used to find Access Servers using a UDP broadcast message. Finder server is listening in port 9990 for broadcast and unicast messages. The reply is unicasted to sender.

In Access Server a finder message can be sent with command finder. See finder --help for usage. The finder server is enabled by default.

9.1. Finder Search Message

Finder search message has four bytes:


      0x62 0x66 0x62 0x66
    

9.2. Finder Reply Message

Finder reply message has four header bytes:


      0x66 0x62 0x66 0x62
    

Following the header bytes there is zero or more value tuples. Each tuple has format:

Table 9-1. Finder Tuple Format

Field NameLengthDescription
ID1 byteTuple ID, see below
Length1 byteData length, in bytes
DataLength bytesValue for ID

Following tuple IDs are defined:

Table 9-2. Finder Tuple IDs

Tuple IDDescription of Data
0x01, ProdId Product identification string, ASCII.
0x02, Revision Product revision string, ASCII.
0x03, HWSerial Hardware serial number, ASCII.
0x04, IP IP address of "nap" interface, 4 bytes.
0x05, EthMac Ethernet MAC address, 6 bytes.
0x06, iWRAP iWRAP information string, ASCII.
0x07, IPString List of all IP addresses, ASCII.
0x08, Hostname Hostname and domain, ASCII.
0x09, Description Free description, ASCII.
0x0a, BuildTag Software version, ASCII.