Protocols/OSCAR/SNAC/USER LOOKUP FIND BY EMAIL: Difference between revisions

	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)

Latest revision as of 01:14, 13 February 2021

ID	Origin	Name	Foodgroup	Service	Status	Version
0x000A, 0x0002	Client	USER_LOOKUP__FIND_BY_EMAIL	Unspecified	BOS	Active	1.9

Search for other users by email address.

SNAC Header

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

SNAC Data

Unconfirmed: This SNAC contains no data

6.3 Finding People

The OSCAR BOS (basic services) allows a few rudimentrary methods of locating other AIM and AOL users.

6.3.1 Finding by EMail Address

A "find SN by email address" request is facilitated by the "Request Screen Name by Address" command in next table.

Fig 6.3.1.1 Request Screen Name by Address

Position	Length	Data
1	Word	0x000a
3	Word	0x0002
5	Word	0x0000
7	DWord	Request ID
11	ASCII String	Email Address (unterminated)

Please notice the lack of a length byte/word prefixed to the email address. It's kind of strange for this derivation in behavior, but AOL can do what they want.

The server's response to that is the "Search by Address Response" command, explaned in the next table. Please note that there may be several screen names per email address.

Fig 6.3.1.2 Search by Address Response

Position	Length	Data
1	Word	0x000a
3	Word	0x0003
5	Word	0x0000
7	DWord	Request ID
11*	Word	0x0001
13*	Word	SN Length
15*	ASCII String	SN (unterminated)
* Field repeats for every listed screen name.

And if no screen names are found, we get the "Search by Address Response Fail" command below.

Fig 6.3.1.3 Search by Address Fail

Position	Length	Data
1	Word	0x000a
3	Word	0x0001
5	Word	0x0000
7	DWord	Request ID
11	Word	0x0014

6.3.2 Finding by Name

It would appear that AIM no longer has the feature of being able to find by name. That now takes you to the address: http://www.aol.com/netfind/whitepages.html. I sure thought it used to do this....

From Aleksandr Shutko: SNAC(0A,02) client search by email request SNAC(0A,02) CLI_SEARCHxBYxEMAIL

Use this to search AIM account by email address associated with it. Server will reply via SNAC(0A,03) or via SNAC(0A,01) - error.

00 0A	word	SNAC family
00 02	word	SNAC subtype
00 00	word	SNAC flags
xx xx xx xx	dword	SNAC request-id

xx ..

string

email address string

Example SNAC dump with flap header:


  2A 02 33 73 00 17 00 0A  00 02 00 00 00 00 00 02 *.3s............
  61 61 61 61 61 40 61 61  61 61 2E 72 75          aaaaa@aaaa.ru

USER_LOOKUP SNACs

SNAC List

Subgroup	Origin	Name
0x0001	Any	USER_LOOKUP__ERR
This is the error SNAC for the USER_LOOKUP foodgroup.
0x0002	Client	USER_LOOKUP__FIND_BY_EMAIL
Search for other users by email address.
0x0003	Host	USER_LOOKUP__FIND_REPLY
Response to search queries.

@@ Line 131: / Line 131: @@
 It would appear that AIM no longer has the feature of being able to find by name. That now takes you to the address: http://www.aol.com/netfind/whitepages.html. I sure thought it used to do this....
+=== From Aleksandr Shutko: SNAC(0A,02) client search by email request SNAC(0A,02) CLI_SEARCHxBYxEMAIL ===
+<table width=640 cellSpacing=0 cellPadding=0 border=0>
+<tr>
+<td>
+<br>
+Use this to search AIM account by email address associated with it.
+Server will reply via [[Protocols/OSCAR/SNAC_0a_03|SNAC(0A,03)]] or via
+[[Protocols/OSCAR/SNAC_0a_01|SNAC(0A,01)]] - error.<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 0A</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 02</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 ..</td>
+ <td width=5>&nbsp;</td>
+ <td>string</td>
+ <td width=5>&nbsp;</td>
+ <td width=55%>email address 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">
+A 02 33 73 00 17 00 0A  00 02 00 00 00 00 00 02 *.3s............
+61 61 61 61 40 61 61  61 61 2E 72 75          aaaaa@aaaa.ru
+</pre></font>
+</td></tr></table>
+</td></tr></table>
 === USER_LOOKUP SNACs ===
@@ Line 141: / Line 220: @@
 [[Category:Protocols/OSCAR/SNACs]]
 [[Category:Work_In_Progress]]
+[[Category:With_Contrib]]