Protocols/OSCAR/SNAC/PD RIGHTS REPLY: Difference between revisions

From NINA Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 53: Line 53:
| Number of temporary permit entries a client is allowed
| Number of temporary permit entries a client is allowed
|}
|}
=== From Aleksandr Shutko: SNAC(09,03) privacy service parameters SNAC(09,03) PD__RIGHTS_REPLY ===
<table width=640 cellSpacing=0 cellPadding=0 border=0>
<tr>
<td>
<br>
Server replies with this SNAC to [[Protocols/OSCAR/SNAC_09_02|SNAC(09,02)]] - client
service parameters request.
<br><br>
<table width=640 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0><tr><td  bgcolor=#E9E9E9 >
<table width=640 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=23%>&nbsp;00 09</td>
<td width=5>&nbsp;</td>
<td>word</td>
<td width=5>&nbsp;</td>
<td width=58%>SNAC family</td>
</tr>
<tr>
<td>&nbsp;00 03</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>SNAC subtype</td>
</tr>
<tr>
<td>&nbsp;xx xx</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>SNAC flags</td>
</tr>
<tr>
<td>&nbsp;xx xx xx xx</td>
<td>&nbsp;</td>
<td>dword</td>
<td>&nbsp;</td>
<td>SNAC request-id</td>
</tr>
</table>
</td></tr>
<tr><td bgcolor=#E9E9E9>
<!-- TLV 0x01 -->
<table width=640 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=3></td></tr>
<tr><td width=20> </td>
<td>
<table width=610 bgcolor=darkgreen cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0>  <tr><td  bgcolor=#f9f9f9 >
  <table width=610 cellSpacing=0 cellPadding=0 align=center border=0>
  <tr>
  <td width=20%>&nbsp;00 01</td>
  <td width=5>&nbsp;</td>
  <td>word</td>
  <td width=5>&nbsp;</td>
  <td width=60%>TLV.Type(0x01) - max visible list size</td>
  </tr>
  <tr>
  <td>&nbsp;xx xx</td>
  <td width=5>&nbsp;</td>
  <td>word</td>
  <td width=5>&nbsp;</td>
  <td width=60%>TLV.Length</td>
  </tr>
  </table>
  </td></tr>
  <tr><td  bgcolor=#f9f9f9 >
  <table width=610 cellSpacing=0 cellPadding=0 align=center border=0>
  <tr>
  <td width=20%>&nbsp;xx xx</td>
  <td width=5>&nbsp;</td>
  <td>word</td>
  <td width=5>&nbsp;</td>
  <td width=60%>Max number of visible list entries</td>
  </tr>
  </table>
  </td></tr>
  </table>
</td></tr></table>
</td><td width=5> </td>
</tr>
<tr><td height=5 colspan=3> </td></tr>
</table>
<!-- TLV 0x02 -->
<table width=640 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=3></td></tr>
<tr><td width=20> </td>
<td>
<table width=610 bgcolor=darkgreen cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0>  <tr><td  bgcolor=#f9f9f9 >
  <table width=610 cellSpacing=0 cellPadding=0 align=center border=0>
  <tr>
  <td width=20%>&nbsp;00 02</td>
  <td width=5>&nbsp;</td>
  <td>word</td>
  <td width=5>&nbsp;</td>
  <td width=60%>TLV.Type(0x02) - max invisible list size</td>
  </tr>
  <tr>
  <td>&nbsp;xx xx</td>
  <td width=5>&nbsp;</td>
  <td>word</td>
  <td width=5>&nbsp;</td>
  <td width=60%>TLV.Length</td>
  </tr>
  </table>
  </td></tr>
  <tr><td  bgcolor=#f9f9f9 >
  <table width=610 cellSpacing=0 cellPadding=0 align=center border=0>
  <tr>
  <td width=20%>&nbsp;xx xx</td>
  <td width=5>&nbsp;</td>
  <td>word</td>
  <td width=5>&nbsp;</td>
  <td width=60%>Max number of invisible list entries</td>
  </tr>
  </table>
  </td></tr>
  </table>
</td></tr></table>
</td><td width=5> </td>
</tr>
<tr><td height=5 colspan=3> </td></tr>
</table>
</td></tr></table>
</td></tr></table>
</td></tr></table>
<br>Example SNAC dump with flap header:
<table width=640 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0><tr>
<td bgcolor=#E9E9E9>
<font size=3><pre style="font-size: 13px">
  2A 02 3E 06 00 16 00 09  00 03 00 00 00 00 00 02 *.>.............
  00 02 00 02 00 C8 00 01  00 02 00 C8            ............
</pre></font>
</td></tr></table>
</td></tr></table>


== PD SNACs ==
== PD SNACs ==
{{Protocols/OSCAR/Foodgroups/PD/SNACs/Simple}}
{{Protocols/OSCAR/Foodgroups/PD/SNACs/Simple}}


[[Category:With_Contrib]]
[[Category:Stub]]
[[Category:Stub]]
[[Category:AOL]]
[[Category:AOL]]

Revision as of 05:04, 13 February 2021

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, 0x0003 Host PD__RIGHTS_REPLY PD BOS Active 1.9

This SNAC is the response to the PD__RIGHTS_QUERY SNAC.

SNAC Header

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

SNAC Data

Name Type Notes
tlvs Rest of SNAC array of TLV [Class: PD__RIGHTS_REPLY_TAGS] TLVs with rights information

TLV Class: PD__RIGHTS_REPLY_TAGS

This class contains information from the server about the PD foodgroup.

Name Tag Type Notes
PD__TLV_TAGS_RIGHT_MAX_PERMITS 0x01 uint16 (word) Number of permit entries a user is allowed
PD__TLV_TAGS_RIGHT_MAX_DENIES 0x02 uint16 (word) Number of deny entries a user is allowed
PD__TLV_TAGS_RIGHT_MAX_TEMP_PERMITS 0x03 uint16 (word) Number of temporary permit entries a client is allowed

From Aleksandr Shutko: SNAC(09,03) privacy service parameters SNAC(09,03) PD__RIGHTS_REPLY


Server replies with this SNAC to SNAC(09,02) - client service parameters request.

 00 09   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(0x01) - max visible list size
 xx xx   word   TLV.Length
 xx xx   word   Max number of visible list entries
 00 02   word   TLV.Type(0x02) - max invisible list size
 xx xx   word   TLV.Length
 xx xx   word   Max number of invisible list entries


Example SNAC dump with flap header: 


  2A 02 3E 06 00 16 00 09  00 03 00 00 00 00 00 02 *.>.............
  00 02 00 02 00 C8 00 01  00 02 00 C8             ............



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.
Retrieved from "https://wiki.nina.chat/index.php?title=Protocols/OSCAR/SNAC/PD_RIGHTS_REPLY&oldid=3533"