Protocols/OSCAR/SNAC/PD RIGHTS QUERY

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
0x0009, 0x0002	Client	PD__RIGHTS_QUERY	PD	BOS	Active	1.9

This is a query sent to the host by the client to discover what some of its rights are with respect to the PD SNAC group.

SNAC Header

Foodgroup	uint16 (word)	00 09
Subgroup	uint16 (word)	00 02
Flags	uint16 (word)	00 00
Request ID	uint32 (dword)	xx xx xx xx

SNAC Data

This SNAC has no fields and is always empty.

Query the PD foodgroup rights:

Field	Size	Value
u08	flapHeader.startMarker	'*'
u08	flapHeader.frameType	2 ([Protocols/OSCAR/FLAP#Class:_FLAP_FRAME FLAP__FRAME_TYPE_DATA])
u16	flapHeader.sequenceNumber	XX
u16	flapHeader.payloadLength	YY
u16	snacHeader.foodgroup	9 ([Protocols/OSCAR/Foodgroups/PD PD])
u16	snacHeader.type	2 ([Protocols/OSCAR/SNAC/PD_RIGHTS_QUERY PD__RIGHTS_QUERY])
u16	snacHeader.flags	0
u32	snacHeader.requestId	ZZ

From Aleksandr Shutko: SNAC(09,02) request privacy service parameters SNAC(09,02) PD__RIGHTS_QUERY

Client use this SNAC to request buddylist service parameters and limitations. Server should reply via SNAC(09,03).  00 09   word   SNAC family  00 02   word   SNAC subtype  00 00   word   SNAC flags  xx xx xx xx   dword   SNAC request-id  empty (no snac data)

Example SNAC dump with flap header:

2A 02 22 9B 00 0A 00 09 00 02 00 00 00 00 00 02 *.".............

PD SNACs

SNAC List

Subgroup Origin Name 0x0001 Any PD__ERR This is the error SNAC for the PD foodgroup. 0x0002 Client PD__RIGHTS_QUERY This is a query sent to the host by the client to discover what some of its rights are with respect to the PD SNAC group. 0x0003 Host PD__RIGHTS_REPLY This SNAC is the response to the PD__RIGHTS_QUERY SNAC. 0x0004 Client PD__SET_GROUP_PERMIT_MASK Set group permission mask. 0x0005 Client PD__ADD_PERM_LIST_ENTRIES Add user to permission/visible list. Users on this list will be able to see the client, even if it is invisible or has default-deny enabled. 0x0006 Client PD__DEL_PERM_LIST_ENTRIES Delete user from permission/visible list. 0x0007 Client PD__ADD_DENY_LIST_ENTRIES Add user to deny/invisible list. Users on this list will not see you online. Note that it can be overridden by PD__ADD_TEMP_PERMIT_LIST_ENTRIES. 0x0008 Client PD__DEL_DENY_LIST_ENTRIES Delete user from deny/invisible list. 0x0009 Host PD__BOS_ERR Error notification for permissions on the BOS host. 0x000A Client PD__ADD_TEMP_PERMIT_LIST_ENTRIES This SNAC adds one or more entries to the temporary permit/visible list. A username in this list will bypass the Feedbag permit/deny lists and always be permitted. 0x000B Client PD__DEL_TEMP_PERMIT_LIST_ENTRIES This SNAC deletes one or more entries in the temporary permit list.