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

From NINA Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 18: Line 18:


== 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.
 
{| 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 ===
=== Class: LOCATE__QUERY_TYPE ===
X
 
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
|}


== LOCATE SNACs ==
== LOCATE SNACs ==

Revision as of 09:03, 22 March 2020

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
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

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.