Protocols/OSCAR/SNAC/LOCATE USER INFO QUERY2: 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_QUERY2/Origin}} |name=LOCATE__USER_INFO_QUERY2 |id=0x0002, 0x0015 |service={{...")
 
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 10: Line 10:
{{Protocols/OSCAR/SNAC/LOCATE__USER_INFO_QUERY2/Description}}
{{Protocols/OSCAR/SNAC/LOCATE__USER_INFO_QUERY2/Description}}


=== SNAC Header ===
== SNAC Header ==
{{Protocols/OSCAR/SNAC/Header
{{Protocols/OSCAR/SNAC/Header
|foodgroup=00 02
|foodgroup=00 02
Line 17: Line 17:
|reqid=00 00 00 00}}
|reqid=00 00 00 00}}


=== SNAC Data ===
== SNAC Data ==
Unconfirmed: This SNAC contains no data
A client should only use this SNAC when it needs to display information to a user and should not call on every Buddy arrive. Either a LOCATE__USER_INFO_REPLY or a [[Protocols/OSCAR/SNAC/LOCATE__ERR|LOCATE__ERR]] will be generated.


=== LOCATE SNACs ===
{| class="wikitable"
! Name
! Type
! Notes
|-
| type2
| uint32 (dword)
| ''[Class: [[Protocols/OSCAR/SNAC/LOCATE_USER_INFO_QUERY2#Class:_LOCATE_QUERY_TYPE|LOCATE__QUERY_TYPE]]]'' What data should be returned
|-
| username
| string08
| User for which to the information requested
|}
 
=== Class: LOCATE__QUERY_TYPE ===
 
This class specified which fields the client wants returned when doing a LOCATE__USER_INFO_QUERY2.
 
{| class="wikitable"
! Name
! Value
! Notes
|-
| LOCATE__TYPE2_SIG
| 0x00000001
| The AIM signature
|-
| LOCATE__TYPE2_UNAVAILABLE
| 0x00000002
| The away message
|-
| LOCATE__TYPE2_CAPABILITIES
| 0x00000004
| CAPABILITIES UUID array; short caps will be represented in long form
|-
| LOCATE__TYPE2_CERTS
| 0x00000008
| The CERT Blob
|-
| LOCATE__TYPE2_HTML_INFO
| 0x00000400
| Return HTML formatted Buddy Info page
|}
 
=== From Aleksandr Shutko: SNAC(02,15) LOCATE__USER_INFO_QUERY2 ===
 
<table width=640 cellSpacing=0 cellPadding=0 border=0>
<tr>
<td>
<br>Query user online info by screen name. Server should respond with
[[Protocols/OSCAR/SNAC_02_06|SNAC(02,06)]]. <br>
Here is the table for request flags bitmask:
<br><br>
 
<table width=100% bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0><tr><td bgcolor=#E5E5E5>
<table width=100% cellSpacing=1 cellPadding=1 border=0>
<tr>
<td bgcolor=#f9f9f9 width=70 valign=top>&nbsp;&nbsp;<b>0x00000001&nbsp;</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;User profile requested (tlv(1)/tlv(2))</td>
</tr>
<tr>
<td bgcolor=#f9f9f9 width=70 valign=top>&nbsp;&nbsp;<b>0x00000002&nbsp;</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;User away message requested (tlv(3)/tlv(4))</td>
</tr>
<tr>
<td bgcolor=#f9f9f9 width=70 valign=top>&nbsp;&nbsp;<b>0x00000004&nbsp;</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;User capability block requested (tlv(5))</td>
</tr>
<tr>
<td bgcolor=#f9f9f9 width=70 valign=top>&nbsp;&nbsp;<b>0x00000008&nbsp;</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;Certification info requested (tlv(1b) ?)</td>
</tr>
</table>
</td></tr></table>
</td></tr></table>
 
<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 15</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 xx xx</td>
<td width=5>&nbsp;</td>
<td>dword</td>
<td width=5>&nbsp;</td>
<td width=55%>Request flags</td>
</tr>
<tr>
<td width=169>&nbsp;xx</td>
<td width=5>&nbsp;</td>
<td>byte</td>
<td width=5>&nbsp;</td>
<td width=55%>length of screen name</td>
</tr>
<tr>
<td>&nbsp;xx ..</td>
<td>&nbsp;</td>
<td>string</td>
<td>&nbsp;</td>
<td>screen name</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 58 44 00 17 00 02 00 15 00 00 00 04 00 15  *.XD............
  00 00 00 01 08 73 6F 6D 65 6E 69 63 6B          .....somenick
 
</pre></font>
</td></tr></table>
</td></tr></table>
 
 
 
 
 
== 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:34, 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, 0x0015 Client LOCATE__USER_INFO_QUERY2 Unspecified BOS Active 1.19

This SNAC is sent by the client to perform the basic locate query on a user.

SNAC Header

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

SNAC Data

A client should only use this SNAC when it needs to display information to a user and should not call on every Buddy arrive. Either a LOCATE__USER_INFO_REPLY or a LOCATE__ERR will be generated.

Name Type Notes
type2 uint32 (dword) [Class: LOCATE__QUERY_TYPE] What data should be returned
username string08 User for which to the information requested

Class: LOCATE__QUERY_TYPE

This class specified which fields the client wants returned when doing a LOCATE__USER_INFO_QUERY2.

Name Value Notes
LOCATE__TYPE2_SIG 0x00000001 The AIM signature
LOCATE__TYPE2_UNAVAILABLE 0x00000002 The away message
LOCATE__TYPE2_CAPABILITIES 0x00000004 CAPABILITIES UUID array; short caps will be represented in long form
LOCATE__TYPE2_CERTS 0x00000008 The CERT Blob
LOCATE__TYPE2_HTML_INFO 0x00000400 Return HTML formatted Buddy Info page

From Aleksandr Shutko: SNAC(02,15) LOCATE__USER_INFO_QUERY2


Query user online info by screen name. Server should respond with SNAC(02,06).
Here is the table for request flags bitmask:

  0x00000001    User profile requested (tlv(1)/tlv(2))
  0x00000002    User away message requested (tlv(3)/tlv(4))
  0x00000004    User capability block requested (tlv(5))
  0x00000008    Certification info requested (tlv(1b) ?)


 00 02   word   SNAC family
 00 15   word   SNAC subtype
 00 00   word   SNAC flags
 xx xx xx xx   dword   SNAC request-id
 xx xx xx xx   dword   Request flags
 xx   byte   length of screen name
 xx ..   string   screen name


Example SNAC dump with flap header: 


  2A 02 58 44 00 17 00 02 00 15 00 00 00 04 00 15  *.XD............
  00 00 00 01 08 73 6F 6D 65 6E 69 63 6B           .....somenick



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_QUERY2&oldid=3501"