Protocols/OSCAR/SNAC/BUDDY ADD BUDDIES: Difference between revisions

From NINA Wiki
Jump to navigation Jump to search
No edit summary
 
Line 39: Line 39:
|
|
|}
|}
=== From Aleksandr Shutko: SNAC(03,04) add buddies to contact list SNAC(03,04) BUDDY__ADD_BUDDIES  ===
<table width=640 cellSpacing=0 cellPadding=0 border=0>
<tr>
<td>
<br>
Use this this to add new buddies to your client-side contact list. You can delete buddies from contact
using [[Protocols/OSCAR/SNAC_03_05|SNAC(03,05)]]. See also complete snac list for this service
[[Protocols/OSCAR/SNAC_03|here]].
<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=169>&nbsp;00 03</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 04</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>SNAC subtype</td>
</tr>
<tr>
<td>&nbsp;00 00</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>
  <table width=640 cellSpacing=0 cellPadding=0 align=center border=0>
  <tr>
  <td width=169>&nbsp;xx</td>
  <td width=5>&nbsp;</td>
  <td>byte</td>
  <td width=5>&nbsp;</td>
  <td width=55%>buddy id #1 strlen </td>
  </tr>
  <tr>
  <td>&nbsp;xx ..</td>
  <td>&nbsp;</td>
  <td>string</td>
  <td>&nbsp;</td>
  <td>buddy id #1 string </td>
  </tr>
  <tr>
  <td>&nbsp;...</td>
  <td>&nbsp;</td>
  <td>&nbsp;...</td>
  <td>&nbsp;</td>
  <td>&nbsp;...</td>
  </tr>
  <tr>
  <td>&nbsp;xx</td>
  <td>&nbsp;</td>
  <td>byte</td>
  <td>&nbsp;</td>
  <td>buddy id #n strlen </td>
  </tr>
  <tr>
  <td>&nbsp;xx ..</td>
  <td>&nbsp;</td>
  <td>string</td>
  <td>&nbsp;</td>
  <td>buddy id #n string </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 62 79 00 48 00 03  00 04 00 00 00 00 00 04 *.by.H..........
  07 31 30 30 30 30 30 30  04 31 30 30 31 07 36 32 .1000000.1001.62
  31 38 38 39 37 07 36 32  31 38 38 39 38 07 36 32 18897.6218898.62
  31 38 38 39 39 07 36 32  31 38 39 30 30 08 31 30 18899.6218900.10
  30 30 30 30 30 31 07 36  32 31 38 38 39 35      000001.6218895
</pre></font>
</td></tr></table>
</td></tr></table>


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


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

Latest revision as of 04:36, 13 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
0x0003, 0x0004 Client BUDDY__ADD_BUDDIES Unspecified BOS Active 1.10

Add buddy or buddies to Buddy List.

SNAC Header

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

SNAC Data

@NOTE Combine like w/ PD into BUDDY

Adds a number of buddies to your buddy list, causing AIM to send us on/off events for the given users. Len/buddy combinations can be repeated as many times as you have buddies to add.

Container Data TLV Type
RAW SNAC Header
RAW Buddy name length (byte)
RAW Buddy name

From Aleksandr Shutko: SNAC(03,04) add buddies to contact list SNAC(03,04) BUDDY__ADD_BUDDIES


Use this this to add new buddies to your client-side contact list. You can delete buddies from contact using SNAC(03,05). See also complete snac list for this service here.

 00 03   word   SNAC family
 00 04   word   SNAC subtype
 00 00   word   SNAC flags
 xx xx xx xx   dword   SNAC request-id
 xx   byte   buddy id #1 strlen
 xx ..   string   buddy id #1 string
 ...    ...    ...
 xx   byte   buddy id #n strlen
 xx ..   string   buddy id #n string


Example SNAC dump with flap header:


  2A 02 62 79 00 48 00 03  00 04 00 00 00 00 00 04 *.by.H..........
  07 31 30 30 30 30 30 30  04 31 30 30 31 07 36 32 .1000000.1001.62
  31 38 38 39 37 07 36 32  31 38 38 39 38 07 36 32 18897.6218898.62
  31 38 38 39 39 07 36 32  31 38 39 30 30 08 31 30 18899.6218900.10
  30 30 30 30 30 31 07 36  32 31 38 38 39 35       000001.6218895



BUDDY SNACs

SNAC List
Subgroup Origin Name
0x0001 Any BUDDY__ERR
This is the error SNAC for the BUDDY foodgroup.
0x0002 Client BUDDY__RIGHTS_QUERY
This SNAC is optionally sent by the client to discover the client's and user's rights.
0x0003 Host BUDDY__RIGHTS_REPLY
This is the response the host sends to a BUDDY__RIGHTS_QUERY SNAC.
0x0004 Client BUDDY__ADD_BUDDIES
Add buddy or buddies to Buddy List.
0x0005 Client BUDDY__DEL_BUDDIES
Remove buddy or buddies from Buddy List.
0x0006 Client BUDDY__WATCHER_LIST_QUERY
Query for other users who have current user listed.
0x0007 Host BUDDY__WATCHER_LIST_RESPONSE
Response to BUDDY__WATCHER_LIST_QUERY.
0x0008 Client BUDDY__WATCHER_SUB_REQUEST
Watcher sub request.
0x0009 Host BUDDY__WATCHER_NOTIFICATION
Watcher sub notification.
0x000A Host BUDDY__REJECT_NOTIFICATION
This is sent in the event that one or more of the users specified in the user's Buddy List are overloaded with watchers.
0x000B Host BUDDY__ARRIVED
This notification, potentially batched, indicates that one or more users on the client's Buddy List has signed on or updated their information.
0x000C Host BUDDY__DEPARTED
This potentially batched notification indicates that one or more users on the client's Buddy List has signed off.
0x000F Client BUDDY__ADD_TEMP_BUDDIES
This SNAC adds one or more users to the client's temporary Buddy List.
0x0010 Client BUDDY__DEL_TEMP_BUDDIES
This SNAC deletes one or more users from the client's temporary Buddy List.