Protocols/OSCAR/SNAC/LOCATE USER INFO QUERY: Difference between revisions

From NINA Wiki
Jump to navigation Jump to search
(Created page with "{{Protocols/OSCAR}} {{Protocols/OSCAR/SNAC/Stats |origin={{Protocols/OSCAR/SNAC/LOCATE__USER_INFO_QUERY/Origin}} |name=LOCATE__USER_INFO_QUERY |id=0x0002, 0x0005 |service={{Pr...")
 
No edit summary
 
Line 19: Line 19:
=== SNAC Data ===
=== SNAC Data ===
Unconfirmed: This SNAC contains no data
Unconfirmed: This SNAC contains no data
=== From Aleksandr Shutko: SNAC(02,05) request user location info SNAC(02,05) LOCATE__USER_INFO_QUERY ===
<table width=640 cellSpacing=0 cellPadding=0 border=0>
<tr>
<td>
<br>
Every client can request another user location info. There are three known request
types: 1 - general info, 2 - short user info, 3 - away message, 4 - client capabilities.
Server should reply via [[Protocols/OSCAR/SNAC_02_06|SNAC(02,06)]]. Reply contain fixed
part "short info" (class, status, dc, ip, times) and request dependent part
(caps | profile | away message).
<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 02</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 05</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 xx</td>
  <td width=5>&nbsp;</td>
  <td>word</td>
  <td width=5>&nbsp;</td>
  <td width=55%>Type of the requesting info</td>
  </tr>
  <tr>
  <td>&nbsp;xx</td>
  <td>&nbsp;</td>
  <td>char</td>
  <td>&nbsp;</td>
  <td>User uin string length</td>
  </tr>
  <tr>
  <td>&nbsp;xx ..</td>
  <td>&nbsp;</td>
  <td>string</td>
  <td>&nbsp;</td>
  <td>User uin 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 22 A3 00 15 00 02  00 05 00 00 00 00 00 05 *."..Z..........
  00 01 07 36 32 31 38  38 39 35                ....6218895
</pre></font>
</td></tr></table>
</td></tr></table>


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


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

Latest revision as of 04:31, 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
0x0002, 0x0005 Client LOCATE__USER_INFO_QUERY Unspecified BOS Active 1.19

Request user information for profiles, capabilities, away message, and certificates.

SNAC Header

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

SNAC Data

Unconfirmed: This SNAC contains no data

From Aleksandr Shutko: SNAC(02,05) request user location info SNAC(02,05) LOCATE__USER_INFO_QUERY


Every client can request another user location info. There are three known request types: 1 - general info, 2 - short user info, 3 - away message, 4 - client capabilities. Server should reply via SNAC(02,06). Reply contain fixed part "short info" (class, status, dc, ip, times) and request dependent part (caps | profile | away message).

 00 02   word   SNAC family
 00 05   word   SNAC subtype
 00 00   word   SNAC flags
 xx xx xx xx   dword   SNAC request-id
 xx xx   word   Type of the requesting info
 xx   char   User uin string length
 xx ..   string   User uin string


Example SNAC dump with flap header: 


  2A 02 22 A3 00 15 00 02  00 05 00 00 00 00 00 05 *."..Z..........
  00 01 07 36 32 31 38  38 39 35                ....6218895



LOCATE SNACs

SNAC List
Subgroup Origin Name
0x0001 Any LOCATE__ERR
This is the error SNAC for the LOCATE foodgroup.
0x0002 Client LOCATE__RIGHTS_QUERY
This query is sent to the server by the client to discover what some of its rights are with respect to the PD SNAC group.
0x0003 Host LOCATE__RIGHTS_REPLY
This is the response to the LOCATE__RIGHTS_QUERY SNAC.
0x0004 Client LOCATE__SET_INFO
The client may set SIG, UNAVAILABLE, and CAPABILITIES type and data tags with this SNAC.
0x0005 Client LOCATE__USER_INFO_QUERY
Request user information for profiles, capabilities, away message, and certificates.
0x0006 Host LOCATE__USER_INFO_REPLY
This is the usual response to a LOCATE__USER_INFO_QUERY2 SNAC.
0x0007 Client LOCATE__WATCHER_SUB_REQUEST
Watcher sub request.
0x0008 Host LOCATE__WATCHER_NOTIFICATION
Watcher sub notification.
0x0009 Client LOCATE__SET_DIR_INFO
Set directory info. Host will reply LOCATE__SET_DIR_REPLY.
0x000A Host LOCATE__SET_DIR_REPLY
Reply to LOCATE__SET_DIR_INFO.
0x000B Client LOCATE__GET_DIR_INFO
Get directory information for user. Host should reply with LOCATE__GET_DIR_REPLY.
0x000C Host LOCATE__GET_DIR_REPLY
Host reply to LOCATE__GET_DIR_INFO.
0x000D NCD LOCATE__GROUP_CAPABILITY_QUERY
This is not currently documented. Want to contribute?
0x000E NCD LOCATE__GROUP_CAPABILITY_REPLY
This is not currently documented. Want to contribute?
0x000F Client LOCATE__SET_KEYWORD_INFO
Set profile keywords and interests. Host should reply with LOCATE__SET_KEYWORD_REPLY.
0x0010 Host LOCATE__SET_KEYWORD_REPLY
This is the host reply to LOCATE__SET_KEYWORD_REPLY.
0x0011 Client LOCATE__GET_KEYWORD_INFO
Set profile keywords and interests. Host should reply with LOCATE__SET_KEYWORD_REPLY.
0x0012 Host LOCATE__GET_KEYWORD_REPLY
This is the host reply to LOCATE__SET_KEYWORD_REPLY.
0x0013 Client LOCATE__FIND_LIST_BY_EMAIL
This is a query sent to the server that looks up a list of users by their email address and returns one NickwInfo for each email account queried.
0x0014 Host LOCATE__FIND_LIST_REPLY
This SNAC provides the results of the LOCATE__FIND_LIST_BY_EMAIL.
0x0015 Client LOCATE__USER_INFO_QUERY2
This SNAC is sent by the client to perform the basic locate query on a user.
Retrieved from "https://wiki.nina.chat/index.php?title=Protocols/OSCAR/SNAC/LOCATE_USER_INFO_QUERY&oldid=3496"