Protocols/OSCAR/SNAC/BUDDY RIGHTS QUERY
Jump to navigation
Jump to search
| 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 |
|---|---|---|---|---|---|---|
| 0x0003, 0x0002 | Client | BUDDY__RIGHTS_QUERY | Unspecified | BOS | Active | 1.10 |
This SNAC is optionally sent by the client to discover the client's and user's rights.
Contents
SNAC Header
| Foodgroup | uint16 (word) | 00 03 |
| Subgroup | uint16 (word) | 00 02 |
| Flags | uint16 (word) | 00 00 |
| Request ID | uint32 (dword) | 00 00 00 00 |
SNAC Data
This SNAC is usually sent before the OSERVICE__CLIENT_ONLINE SNAC.
| Name | Type | Notes |
|---|---|---|
| tlvs | Rest of SNAC array of TLV | [Class: BUDDY__RIGHTS_QUERY_TAGS] Qualifying parameters for query |
Query the BUDDY foodgroup rights:
| Field | Size | Value |
|---|---|---|
| u08 | flapHeader.startMarker | '*' |
| u08 | flapHeader.frameType | 0x02 (FLAP__FRAME_TYPE_DATA) |
| u16 | flapHeader.sequenceNumber | XX |
| u16 | flapHeader.payloadLength | YY |
| u16 | snacHeader.foodgroup | 0x03 (BUDDY) |
| u16 | snacHeader.type | 0x02 (BUDDY__RIGHTS_QUERY) |
| u16 | snacHeader.flags | 0 |
| u32 | snacHeader.requestId | ZZ |
| u16 | tlvs[0].tag | 0x05 (BUDDY__RIGHTS_QUERY_TAGS_FLAGS) |
| u16 | tlvs[0].len | 2 |
| u16 | tlvs[0].value | 0x0F |
TLV Class: BUDDY__RIGHTS_QUERY_TAGS
These are tags the client uses to inform the server of options for the BUDDY foodgroup.
| Name | Tag | Type | Notes |
|---|---|---|---|
| FLAGS | 0x05 | uint16 (word) | [Class:BUDDY__RIGHTS_QUERY_FLAGS] Flags that govern feature support |
Class: BUDDY__RIGHTS_QUERY_FLAGS
These are the flags the client uses to inform the server what kinds of features it supports.
| Name | Value | Notes |
|---|---|---|
| BUDDY__RIGHTS_FLAGS_BART_SUPPORTED | 0x0001 | Want to receive BART items |
| BUDDY__RIGHTS_FLAGS_INITIAL_DEPARTS | 0x0002 | Want to receive ARRIVE/DEPART for all users on a Buddy List, even those offline |
| BUDDY__RIGHTS_FLAGS_OFFLINE_BART_SUPPORTED | 0x0004 | Want to receive BART items for offline buddies, excluding location |
| BUDDY__RIGHTS_FLAGS_REJECT_PENDING_BUDDIES | 0x0008 | If set and INITIAL_DEPARTS is set, use REJECT on pending buddies instead of DEPART |
From Aleksandr Shutko: SNAC(03,02) request baddylist service parameters SNAC(03,02) BUDDY__RIGHTS_QUERY
|
|
Example SNAC dump with flap header:
|
BUDDY SNACs
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
