Protocols/OSCAR/SNAC/ICQ DB REPLY

OSCAR Protocol

Introduction • Terms • Clients

Basic

Datatypes • FLAP • SNAC • TLV

UUIDs • Errors • Tool IDs

Host Interaction

Rate Limits • Migration • Messages

Other Services

ADMIN • ADVERT • ALERT

BART • BOS • BUCP • CHAT

CHAT_NAV

Tutorials

Sign On • BART • Rendezvous

ICBM • Locate • Buddies

Foodgroups

OSERVICE (0x0001)

LOCATE (0x0002)

BUDDY (0x0003)

ICBM (0x0004)

ADVERT (0x0005)

INVITE (0x0006)

ADMIN (0x0007)

POPUP (0x0008)

PD (0x0009)

USER_LOOKUP (0x000A)

STATS (0x000B)

TRANSLATE (0x000C)

CHAT_NAV (0x000D)

CHAT (0x000E)

ODIR (0x000F)

BART (0x0010)

FEEDBAG (0x0013)

ICQ (0x0015)

BUCP (0x0017)

ALERT (0x0018)

PLUGIN (0x0022)

UNNAMED_FG_24 (0x0024)

MDIR (0x0025)

ARS (0x044A)

ID	Origin	Name	Foodgroup	Service	Status	Version
0x0015, 0x0003	Host	ICQ__DB_REPLY	ICQ	BOS	Active	1.2

Host information response to ICQ__DB_QUERY.

SNAC Header

Foodgroup	uint16 (word)	00 15
Subgroup	uint16 (word)	00 03
Flags	uint16 (word)	00 00
Request ID	uint32 (dword)	00 00 00 00

SNAC Data

Unconfirmed: This SNAC contains no data

Length	Description
2 bytes	Type - 0x0001
2 bytes	Length L of the following
L bytes	DATA

DATA

All information for this SNAC is in the value of this TLV, and the information is given in network byte order.

Length	Description
2 bytes	Command length. This is L-2
4 bytes	The destination UIN (us)
2 bytes	Command. This actually tells what the rest of the SNAC contains. You decide how to read in the rest of it based on what command it is.
2 bytes	Request ID

If command is 0x0041, then this is an offline message.

Length	Description
4 bytes	The originating UIN (them)
2 bytes	The year the message was sent
1 byte	The month the message was sent
1 byte	The day the message was sent
1 byte	The hour the message was sent
1 byte	The minute the message was sent
2 bytes	The type of message
2 bytes	Length L of the following
L bytes	The actual message

From Aleksandr Shutko: SNAC(15,03) meta information reply SNAC(15,03) ICQ__DB_REPLY

This is the server response to client meta request SNAC(15,02).  00 15   word   SNAC family  00 03   word   SNAC subtype  xx xx   word   SNAC flags  xx xx xx xx   dword   SNAC request-id  00 01   word   TLV.Type(1) - encapsulated META_DATA  xx xx   word   TLV.Length  xx xx   word (LE)   data chunk size (TLV.Length-2)  xx xx xx xx   dword (LE)   requester uin  xx xx   word (LE)   request type (see table bellow)  xx xx   word (LE)   request sequence number    ......   ......   data (depending on request type) Response types list:  SNAC(15,03)/0041    Offline message response  SNAC(15,03)/0042    End-of-offline messages reply  SNAC(15,03)/07DA    Meta information response

Example SNAC dump with flap header:

2A 02 5A 97 00 A6 00 15 00 03 00 01 00 1B 00 02 *.Z............. 00 01 00 98 96 00 8F E4 5E 00 DA 07 2A 00 D2 00 ........^...*... 0A 06 00 77 43 69 74 79 00 03 00 53 74 00 12 00 ...wCity...St... 2B 37 20 28 34 32 31 32 29 20 34 34 34 34 34 34 +7 (4212) 444444 34 00 12 00 2B 37 20 28 34 32 31 32 29 20 35 35 4...+7 (4212) 55 35 35 35 35 35 00 14 00 57 6F 72 6B 20 73 74 72 55555...Work str 65 65 74 20 61 64 64 72 65 73 73 00 06 00 32 32 eet address...22 32 32 32 00 07 00 08 00 43 6F 6D 70 61 6E 79 00 222.....Company. 0B 00 44 65 70 61 72 74 6D 65 6E 74 00 09 00 50 ..Department...P 6F 73 69 74 69 6F 6E 00 05 00 10 00 68 74 74 70 osition.....http 3A 2F 2F 77 6F 72 6B 2E 6F 72 67 00  ://work.org.

ICQ SNACs

SNAC List

Subgroup Origin Name 0x0001 Any ICQ__ERR This is the error SNAC for the ICQ foodgroup. 0x0002 Client ICQ__DB_QUERY Information request used by legacy ICQ clients. 0x0003 Host ICQ__DB_REPLY Host information response to ICQ__DB_QUERY.