Difference between revisions of "Protocols/OSCAR/SNAC/ICQ ERR"

From NINA Wiki
Jump to navigation Jump to search
 
Line 36: Line 36:
 
| ''[Class: [[Protocols/OSCAR/Errors#TLV_Class:_ERROR_TAGS|ERROR__TAGS]]]''
 
| ''[Class: [[Protocols/OSCAR/Errors#TLV_Class:_ERROR_TAGS|ERROR__TAGS]]]''
 
|}
 
|}
 +
 +
=== From Aleksandr Shutko: SNAC(15,01) server icq extension service error ===
 +
 +
<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=#4040FF >
 +
<table width=100% cellSpacing=0 cellPadding=0 border=0>
 +
<tr>
 +
<td><b><font color="white">SNAC(15,01)&nbsp;</font></b></td>
 +
<td width=70% align=right><b><font color="white">ICQ__ERR &nbsp;</font>
 +
</b></td></tr>
 +
</table>
 +
</td></tr>
 +
</table>
 +
</td></tr></table>
 +
 +
<table width=640 cellSpacing=0 cellPadding=0 border=0>
 +
<tr>
 +
<td>
 +
<br>
 +
This is an error notification snac.
 +
See also error types [[Protocols/OSCAR/Errors|complete list]].<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=30%>&nbsp;00 15</td>
 +
<td width=5>&nbsp;</td>
 +
<td>word</td>
 +
<td width=5>&nbsp;</td>
 +
<td width=55%>SNAC family</td>
 +
</tr>
 +
<tr>
 +
<td>&nbsp;00 01</td>
 +
<td width=5>&nbsp;</td>
 +
<td>word</td>
 +
<td width=5>&nbsp;</td>
 +
<td width=55%>SNAC subtype</td>
 +
</tr>
 +
<tr>
 +
<td>&nbsp;00 00</td>
 +
<td width=5>&nbsp;</td>
 +
<td>word</td>
 +
<td width=5>&nbsp;</td>
 +
<td width=55%>SNAC flags</td>
 +
</tr>
 +
<tr>
 +
<td>&nbsp;xx xx xx xx</td>
 +
<td width=5>&nbsp;</td>
 +
<td>dword</td>
 +
<td width=5>&nbsp;</td>
 +
<td width=55%>SNAC request-id</td>
 +
</tr>
 +
</table>
 +
 +
</td></tr>
 +
<tr><td bgcolor=#E9E9E9>
 +
 +
<table width=640 cellSpacing=0 cellPadding=0 align=center border=0>
 +
<tr>
 +
<td width=30%>&nbsp;xx xx</td>
 +
<td width=5>&nbsp;</td>
 +
<td>word</td>
 +
<td width=5>&nbsp;</td>
 +
<td width=55%>error code (see [[Protocols/OSCAR/Errors|list]])</td>
 +
</tr>
 +
</table>
 +
 +
<!-- TLV 0x08 -->
 +
<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=170>&nbsp;00 08</td>
 +
  <td width=5>&nbsp;</td>
 +
  <td>word</td>
 +
  <td width=5>&nbsp;</td>
 +
  <td width=57%>TLV.Type(0x08) - error subcode, from [[Protocols/OSCAR/TLV#Common_TLVs|tlv tags]] list</td>
 +
  </tr>
 +
  <tr>
 +
  <td>&nbsp;xx xx</td>
 +
  <td>&nbsp;</td>
 +
  <td>word</td>
 +
  <td>&nbsp;</td>
 +
  <td>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=170>&nbsp;xx xx</td>
 +
  <td width=5>&nbsp;</td>
 +
  <td>word</td>
 +
  <td width=5>&nbsp;</td>
 +
  <td width=57%>error subcode</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 0x21 -->
 +
<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=170>&nbsp;00 21</td>
 +
  <td width=5>&nbsp;</td>
 +
  <td>word</td>
 +
  <td width=5>&nbsp;</td>
 +
  <td width=57%>TLV.Type(0x21) - service specific data from request</td>
 +
  </tr>
 +
  <tr>
 +
  <td>&nbsp;xx xx</td>
 +
  <td>&nbsp;</td>
 +
  <td>word</td>
 +
  <td>&nbsp;</td>
 +
  <td>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=170>&nbsp;xx ..</td>
 +
  <td width=5>&nbsp;</td>
 +
  <td>struct</td>
 +
  <td width=5>&nbsp;</td>
 +
  <td width=57%>contents of TLV with encapsulated META_DATA <br>(look SNAC(15,02)/07D0/*)</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 E1 CA 00 0C 00 15  00 01 00 00 7D C9 71 68  *..............h
 +
  00 0E                                            ..
 +
 +
</pre></font>
 +
</td></tr></table>
 +
</td></tr></table>
 +
 +
 +
 +
[[Category:With_Contrib]]
 +
  
 
== ICQ SNACs ==
 
== ICQ SNACs ==

Latest revision as of 06:10, 14 February 2021

OSCAR Protocol
IntroductionTermsClients
Basic
DatatypesFLAPSNACTLV
UUIDsErrorsTool IDs
Host Interaction
Rate LimitsMigrationMessages
Other Services
ADMINADVERTALERT
BARTBOSBUCPCHAT
CHAT_NAV
Tutorials
Sign OnBARTRendezvous
ICBMLocateBuddies
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, 0x0001 Any ICQ__ERR ICQ BOS Active 1.2

This is the error SNAC for the ICQ foodgroup.

SNAC Header

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

SNAC Data

Error code is required, however the TLV chain is optional depending on the error code and/or other information the user needs to be provided.

Name Length Value Note
Code uint16 (word) xx xx [Class: ERROR__CODE]
TLV blob xx .. [Class: ERROR__TAGS]

From Aleksandr Shutko: SNAC(15,01) server icq extension service error

SNAC(15,01)  ICQ__ERR  


This is an error notification snac. See also error types complete list.

 00 15   word   SNAC family
 00 01   word   SNAC subtype
 00 00   word   SNAC flags
 xx xx xx xx   dword   SNAC request-id
 xx xx   word   error code (see list)
 00 08   word   TLV.Type(0x08) - error subcode, from tlv tags list
 xx xx   word   TLV.Length
 xx xx   word   error subcode
 00 21   word   TLV.Type(0x21) - service specific data from request
 xx xx   word   TLV.Length
 xx ..   struct   contents of TLV with encapsulated META_DATA
(look SNAC(15,02)/07D0/*)


Example SNAC dump with flap header:


  2A 02 E1 CA 00 0C 00 15  00 01 00 00 7D C9 71 68  *..............h
  00 0E                                             ..


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.