diff libgaim/protocols/oscar/family_locate.c @ 14192:60b1bc8dbf37

[gaim-migrate @ 16863] Renamed 'core' to 'libgaim' committer: Tailor Script <[e-mail]>

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/libgaim/protocols/oscar/family_locate.c	Sat Aug 19 01:50:10 2006 +0000
@@ -0,0 +1,1443 @@
+/*
+ * Gaim's oscar protocol plugin
+ * This file is the legal property of its developers.
+ * Please see the AUTHORS file distributed alongside this file.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+*/
+
+/*
+ * Family 0x0002 - Locate.
+ *
+ * The functions here are responsible for requesting and parsing information-
+ * gathering SNACs.  Or something like that.  This family contains the SNACs
+ * for getting and setting info, away messages, directory profile thingy, etc.
+ */
+
+#include "oscar.h"
+#ifdef _WIN32
+#include "win32dep.h"
+#endif
+
+/*
+ * Capability blocks.
+ *
+ * These are CLSIDs. They should actually be of the form:
+ *
+ * {0x0946134b, 0x4c7f, 0x11d1,
+ *  {0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}}},
+ *
+ * But, eh.
+ */
+static const struct {
+	guint32 flag;
+	guint8 data[16];
+} aim_caps[] = {
+
+	/*
+	 * These are in ascending numerical order.
+	 */
+
+	/*
+	 * Perhaps better called OSCAR_CAPABILITY_SHORTCAPS
+	 */
+	{OSCAR_CAPABILITY_ICHAT,
+	 {0x09, 0x46, 0x00, 0x00, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_SECUREIM,
+	 {0x09, 0x46, 0x00, 0x01, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_VIDEO,
+	 {0x09, 0x46, 0x01, 0x00, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	/* "Live Video" support in Windows AIM 5.5.3501 and newer */
+	{OSCAR_CAPABILITY_LIVEVIDEO,
+	 {0x09, 0x46, 0x01, 0x01, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	/* "Camera" support in Windows AIM 5.5.3501 and newer */
+	{OSCAR_CAPABILITY_CAMERA,
+	 {0x09, 0x46, 0x01, 0x02, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	/* In Windows AIM 5.5.3501 and newer */
+	{OSCAR_CAPABILITY_GENERICUNKNOWN,
+	 {0x09, 0x46, 0x01, 0x03, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	/* In iChatAV (version numbers...?) */
+	{OSCAR_CAPABILITY_ICHATAV,
+	 {0x09, 0x46, 0x01, 0x05, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x45, 0x53, 0x54, 0x00}},
+
+	/*
+	 * Not really sure about this one.  In an email from
+	 * 26 Sep 2003, Matthew Sachs suggested that, "this
+	 * is probably the capability for the SMS features."
+	 */
+	{OSCAR_CAPABILITY_SMS,
+	 {0x09, 0x46, 0x01, 0xff, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_GENERICUNKNOWN,
+	 {0x09, 0x46, 0xf0, 0x03, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_GENERICUNKNOWN,
+	 {0x09, 0x46, 0xf0, 0x04, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_GENERICUNKNOWN,
+	 {0x09, 0x46, 0xf0, 0x05, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_HIPTOP,
+	 {0x09, 0x46, 0x13, 0x23, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_TALK,
+	 {0x09, 0x46, 0x13, 0x41, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_SENDFILE,
+	 {0x09, 0x46, 0x13, 0x43, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_ICQ_DIRECT,
+	 {0x09, 0x46, 0x13, 0x44, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_DIRECTIM,
+	 {0x09, 0x46, 0x13, 0x45, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_BUDDYICON,
+	 {0x09, 0x46, 0x13, 0x46, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_ADDINS,
+	 {0x09, 0x46, 0x13, 0x47, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_GETFILE,
+	 {0x09, 0x46, 0x13, 0x48, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_ICQSERVERRELAY,
+	 {0x09, 0x46, 0x13, 0x49, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	/*
+	 * Indeed, there are two of these.  The former appears to be correct,
+	 * but in some versions of winaim, the second one is set.  Either they
+	 * forgot to fix endianness, or they made a typo. It really doesn't
+	 * matter which.
+	 */
+	{OSCAR_CAPABILITY_GAMES,
+	 {0x09, 0x46, 0x13, 0x4a, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+	{OSCAR_CAPABILITY_GAMES2,
+	 {0x09, 0x46, 0x13, 0x4a, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x22, 0x82, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_SENDBUDDYLIST,
+	 {0x09, 0x46, 0x13, 0x4b, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	/*
+	 * Setting this lets AIM users receive messages from ICQ users, and ICQ
+	 * users receive messages from AIM users.  It also lets ICQ users show
+	 * up in buddy lists for AIM users, and AIM users show up in buddy lists
+	 * for ICQ users.  And ICQ privacy/invisibility acts like AIM privacy,
+	 * in that if you add a user to your deny list, you will not be able to
+	 * see them as online (previous you could still see them, but they
+	 * couldn't see you.
+	 */
+	{OSCAR_CAPABILITY_INTEROPERATE,
+	 {0x09, 0x46, 0x13, 0x4d, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_ICQUTF8,
+	 {0x09, 0x46, 0x13, 0x4e, 0x4c, 0x7f, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_ICQUTF8OLD,
+	 {0x2e, 0x7a, 0x64, 0x75, 0xfa, 0xdf, 0x4d, 0xc8,
+	  0x88, 0x6f, 0xea, 0x35, 0x95, 0xfd, 0xb6, 0xdf}},
+
+	/*
+	 * Chat is oddball.
+	 */
+	{OSCAR_CAPABILITY_CHAT,
+	 {0x74, 0x8f, 0x24, 0x20, 0x62, 0x87, 0x11, 0xd1,
+	  0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
+
+	/*
+	{OSCAR_CAPABILITY_ICQ2GO,
+	 {0x56, 0x3f, 0xc8, 0x09, 0x0b, 0x6f, 0x41, 0xbd,
+	  0x9f, 0x79, 0x42, 0x26, 0x09, 0xdf, 0xa2, 0xf3}},
+	*/
+
+	{OSCAR_CAPABILITY_ICQRTF,
+	 {0x97, 0xb1, 0x27, 0x51, 0x24, 0x3c, 0x43, 0x34,
+	  0xad, 0x22, 0xd6, 0xab, 0xf7, 0x3f, 0x14, 0x92}},
+
+	/* This is added by the servers and it only shows up for ourselves... */
+	{OSCAR_CAPABILITY_GENERICUNKNOWN,
+	 {0x97, 0xb1, 0x27, 0x51, 0x24, 0x3c, 0x43, 0x34,
+	  0xad, 0x22, 0xd6, 0xab, 0xf7, 0x3f, 0x14, 0x09}},
+
+	{OSCAR_CAPABILITY_APINFO,
+	 {0xaa, 0x4a, 0x32, 0xb5, 0xf8, 0x84, 0x48, 0xc6,
+	  0xa3, 0xd7, 0x8c, 0x50, 0x97, 0x19, 0xfd, 0x5b}},
+
+	{OSCAR_CAPABILITY_TRILLIANCRYPT,
+	 {0xf2, 0xe7, 0xc7, 0xf4, 0xfe, 0xad, 0x4d, 0xfb,
+	  0xb2, 0x35, 0x36, 0x79, 0x8b, 0xdf, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_EMPTY,
+	 {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+	  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+
+	{OSCAR_CAPABILITY_LAST,
+	 {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+	  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+};
+
+/*
+ * Add the userinfo to our linked list.  If we already have userinfo
+ * for this buddy, then just overwrite parts of the old data.
+ *
+ * @param userinfo Contains the new information for the buddy.
+ */
+static void
+aim_locate_adduserinfo(OscarData *od, aim_userinfo_t *userinfo)
+{
+	aim_userinfo_t *cur;
+	FlapConnection *conn;
+	aim_rxcallback_t userfunc;
+
+	cur = aim_locate_finduserinfo(od, userinfo->sn);
+
+	if (cur == NULL) {
+		cur = (aim_userinfo_t *)calloc(1, sizeof(aim_userinfo_t));
+		cur->sn = strdup(userinfo->sn);
+		cur->next = od->locate.userinfo;
+		od->locate.userinfo = cur;
+	}
+
+	cur->warnlevel = userinfo->warnlevel;
+	cur->idletime = userinfo->idletime;
+	if (userinfo->flags != 0)
+		cur->flags = userinfo->flags;
+	if (userinfo->createtime != 0)
+		cur->createtime = userinfo->createtime;
+	if (userinfo->membersince != 0)
+		cur->membersince = userinfo->membersince;
+	if (userinfo->onlinesince != 0)
+		cur->onlinesince = userinfo->onlinesince;
+	if (userinfo->sessionlen != 0)
+		cur->sessionlen = userinfo->sessionlen;
+	if (userinfo->capabilities != 0)
+		cur->capabilities = userinfo->capabilities;
+	cur->present |= userinfo->present;
+
+	if (userinfo->iconcsumlen > 0) {
+		free(cur->iconcsum);
+		cur->iconcsum = (guint8 *)malloc(userinfo->iconcsumlen);
+		memcpy(cur->iconcsum, userinfo->iconcsum, userinfo->iconcsumlen);
+		cur->iconcsumlen = userinfo->iconcsumlen;
+	}
+
+	if (userinfo->info != NULL) {
+		free(cur->info);
+		free(cur->info_encoding);
+		if (userinfo->info_len > 0) {
+			cur->info = (char *)malloc(userinfo->info_len);
+			memcpy(cur->info, userinfo->info, userinfo->info_len);
+		} else
+			cur->info = NULL;
+		cur->info_encoding = strdup(userinfo->info_encoding);
+		cur->info_len = userinfo->info_len;
+	}
+
+	if (userinfo->status != NULL) {
+		free(cur->status);
+		free(cur->status_encoding);
+		if (userinfo->status_len > 0) {
+			cur->status = (char *)malloc(userinfo->status_len);
+			memcpy(cur->status, userinfo->status, userinfo->status_len);
+		} else
+			cur->status = NULL;
+		if (userinfo->status_encoding != NULL)
+			cur->status_encoding = strdup(userinfo->status_encoding);
+		else
+			cur->status_encoding = NULL;
+		cur->status_len = userinfo->status_len;
+	}
+
+	if (userinfo->away != NULL) {
+		free(cur->away);
+		free(cur->away_encoding);
+		if (userinfo->away_len > 0) {
+			cur->away = (char *)malloc(userinfo->away_len);
+			memcpy(cur->away, userinfo->away, userinfo->away_len);
+		} else
+			cur->away = NULL;
+		cur->away_encoding = strdup(userinfo->away_encoding);
+		cur->away_len = userinfo->away_len;
+	}
+
+	/*
+	 * This callback can be used by a client if they want to know whenever
+	 * info for a buddy is updated.  For example, if a client shows away
+	 * messages in its buddy list, then it would need to know if a user's
+	 * away message changes.
+	 */
+	conn = flap_connection_findbygroup(od, SNAC_FAMILY_LOCATE);
+	if ((userfunc = aim_callhandler(od, SNAC_FAMILY_LOCATE, SNAC_SUBTYPE_LOCATE_GOTINFOBLOCK)))
+		userfunc(od, conn, NULL, cur);
+}
+
+void
+aim_locate_dorequest(OscarData *od)
+{
+	struct userinfo_node *cur = od->locate.torequest;
+
+	if (od->locate.waiting_for_response == TRUE)
+		return;
+
+	od->locate.waiting_for_response = TRUE;
+	aim_locate_getinfoshort(od, cur->sn, 0x00000003);
+
+	/* Move this node to the "requested" queue */
+	od->locate.torequest = cur->next;
+	cur->next = od->locate.requested;
+	od->locate.requested = cur;
+}
+
+static gboolean
+gaim_reqinfo_timeout_cb(void *data)
+{
+	OscarData *od;
+
+	od = data;
+
+	if (od->locate.torequest == NULL)
+	{
+		od->getinfotimer = 0;
+		return FALSE;
+	}
+
+	aim_locate_dorequest(od);
+
+	return TRUE;
+}
+
+/**
+ * Remove this screen name from our queue.  If this info was requested
+ * by our info request queue, then pop the next element off of the queue.
+ *
+ * @param od The aim session.
+ * @param sn Screen name of the info we just received.
+ * @return True if the request was explicit (client requested the info),
+ *         false if the request was implicit (libfaim request the info).
+ */
+static int
+aim_locate_gotuserinfo(OscarData *od, FlapConnection *conn, const char *sn)
+{
+	struct userinfo_node *cur, *del;
+	int was_explicit = TRUE;
+
+	while ((od->locate.requested != NULL) && (aim_sncmp(sn, od->locate.requested->sn) == 0)) {
+		del = od->locate.requested;
+		od->locate.requested = del->next;
+		was_explicit = FALSE;
+		free(del->sn);
+		free(del);
+	}
+
+	cur = od->locate.requested;
+	while ((cur != NULL) && (cur->next != NULL)) {
+		if (aim_sncmp(sn, cur->next->sn) == 0) {
+			del = cur->next;
+			cur->next = del->next;
+			was_explicit = FALSE;
+			free(del->sn);
+			free(del);
+		} else
+			cur = cur->next;
+	}
+
+	if (!was_explicit) {
+		od->locate.waiting_for_response = FALSE;
+
+		/*
+		 * Wait a little while then call aim_locate_dorequest(od).
+		 * This keeps us from hitting the rate limit due to
+		 * requesting away messages and info too quickly.
+		 */
+		if (od->getinfotimer == 0)
+			od->getinfotimer = gaim_timeout_add(10000,
+					gaim_reqinfo_timeout_cb, od);
+	}
+
+	return was_explicit;
+}
+
+void
+aim_locate_requestuserinfo(OscarData *od, const char *sn)
+{
+	struct userinfo_node *cur;
+
+	/* Make sure we aren't already requesting info for this buddy */
+	cur = od->locate.torequest;
+	while (cur != NULL) {
+		if (aim_sncmp(sn, cur->sn) == 0)
+			return;
+		cur = cur->next;
+	}
+
+	/* Add a new node to our request queue */
+	cur = (struct userinfo_node *)malloc(sizeof(struct userinfo_node));
+	cur->sn = strdup(sn);
+	cur->next = od->locate.torequest;
+	od->locate.torequest = cur;
+
+	/* Actually request some info up in this piece */
+	aim_locate_dorequest(od);
+}
+
+aim_userinfo_t *aim_locate_finduserinfo(OscarData *od, const char *sn) {
+	aim_userinfo_t *cur = NULL;
+
+	if (sn == NULL)
+		return NULL;
+
+	cur = od->locate.userinfo;
+
+	while (cur != NULL) {
+		if (aim_sncmp(cur->sn, sn) == 0)
+			return cur;
+		cur = cur->next;
+	}
+
+	return NULL;
+}
+
+guint32
+aim_locate_getcaps(OscarData *od, ByteStream *bs, int len)
+{
+	guint32 flags = 0;
+	int offset;
+
+	for (offset = 0; byte_stream_empty(bs) && (offset < len); offset += 0x10) {
+		guint8 *cap;
+		int i, identified;
+
+		cap = byte_stream_getraw(bs, 0x10);
+
+		for (i = 0, identified = 0; !(aim_caps[i].flag & OSCAR_CAPABILITY_LAST); i++) {
+			if (memcmp(&aim_caps[i].data, cap, 0x10) == 0) {
+				flags |= aim_caps[i].flag;
+				identified++;
+				break; /* should only match once... */
+			}
+		}
+
+		if (!identified)
+			gaim_debug_misc("oscar", "unknown capability: {%02x%02x%02x%02x-%02x%02x-%02x%02x-%02x%02x-%02x%02x%02x%02x%02x%02x}\n",
+					cap[0], cap[1], cap[2], cap[3],
+					cap[4], cap[5],
+					cap[6], cap[7],
+					cap[8], cap[9],
+					cap[10], cap[11], cap[12], cap[13],
+					cap[14], cap[15]);
+
+		free(cap);
+	}
+
+	return flags;
+}
+
+guint32
+aim_locate_getcaps_short(OscarData *od, ByteStream *bs, int len)
+{
+	guint32 flags = 0;
+	int offset;
+
+	for (offset = 0; byte_stream_empty(bs) && (offset < len); offset += 0x02) {
+		guint8 *cap;
+		int i, identified;
+
+		cap = byte_stream_getraw(bs, 0x02);
+
+		for (i = 0, identified = 0; !(aim_caps[i].flag & OSCAR_CAPABILITY_LAST); i++) {
+			if (memcmp(&aim_caps[i].data[2], cap, 0x02) == 0) {
+				flags |= aim_caps[i].flag;
+				identified++;
+				break; /* should only match once... */
+			}
+		}
+
+		if (!identified)
+			gaim_debug_misc("oscar", "unknown short capability: {%02x%02x}\n", cap[0], cap[1]);
+
+		free(cap);
+	}
+
+	return flags;
+}
+
+int
+byte_stream_putcaps(ByteStream *bs, guint32 caps)
+{
+	int i;
+
+	if (!bs)
+		return -EINVAL;
+
+	for (i = 0; byte_stream_empty(bs); i++) {
+
+		if (aim_caps[i].flag == OSCAR_CAPABILITY_LAST)
+			break;
+
+		if (caps & aim_caps[i].flag)
+			byte_stream_putraw(bs, aim_caps[i].data, 0x10);
+
+	}
+
+	return 0;
+}
+
+#if 0
+static void
+dumptlv(OscarData *od, guint16 type, ByteStream *bs, guint8 len)
+{
+	int i;
+
+	if (!od || !bs || !len)
+		return;
+
+	gaim_debug_misc("oscar", "userinfo:   type  =0x%04x\n", type);
+	gaim_debug_misc("oscar", "userinfo:   length=0x%04x\n", len);
+	gaim_debug_misc("oscar", "userinfo:   value:\n");
+
+	for (i = 0; i < len; i++) {
+		if ((i % 8) == 0)
+			gaim_debug_misc("oscar", "\nuserinfo:        ");
+		gaim_debug_misc("oscar", "0x%2x ", byte_stream_get8(bs));
+	}
+
+	gaim_debug_misc("oscar", "\n");
+
+	return;
+}
+#endif
+
+void
+aim_info_free(aim_userinfo_t *info)
+{
+	free(info->sn);
+	free(info->iconcsum);
+	free(info->info);
+	free(info->info_encoding);
+	free(info->status);
+	free(info->status_encoding);
+	free(info->away);
+	free(info->away_encoding);
+}
+
+/*
+ * AIM is fairly regular about providing user info.  This is a generic
+ * routine to extract it in its standard form.
+ */
+int
+aim_info_extract(OscarData *od, ByteStream *bs, aim_userinfo_t *outinfo)
+{
+	int curtlv, tlvcnt;
+	guint8 snlen;
+
+	if (!bs || !outinfo)
+		return -EINVAL;
+
+	/* Clear out old data first */
+	memset(outinfo, 0x00, sizeof(aim_userinfo_t));
+
+	/*
+	 * Screen name.  Stored as an unterminated string prepended with a
+	 * byte containing its length.
+	 */
+	snlen = byte_stream_get8(bs);
+	outinfo->sn = byte_stream_getstr(bs, snlen);
+
+	/*
+	 * Warning Level.  Stored as an unsigned short.
+	 */
+	outinfo->warnlevel = byte_stream_get16(bs);
+
+	/*
+	 * TLV Count. Unsigned short representing the number of
+	 * Type-Length-Value triples that follow.
+	 */
+	tlvcnt = byte_stream_get16(bs);
+
+	/*
+	 * Parse out the Type-Length-Value triples as they're found.
+	 */
+	for (curtlv = 0; curtlv < tlvcnt; curtlv++) {
+		int endpos;
+		guint16 type, length;
+
+		type = byte_stream_get16(bs);
+		length = byte_stream_get16(bs);
+
+		endpos = byte_stream_curpos(bs) + length;
+
+		if (type == 0x0001) {
+			/*
+			 * Type = 0x0001: User flags
+			 *
+			 * Specified as any of the following ORed together:
+			 *      0x0001  Trial (user less than 60days)
+			 *      0x0002  Unknown bit 2
+			 *      0x0004  AOL Main Service user
+			 *      0x0008  Unknown bit 4
+			 *      0x0010  Free (AIM) user
+			 *      0x0020  Away
+			 *      0x0400  ActiveBuddy
+			 *
+			 */
+			outinfo->flags = byte_stream_get16(bs);
+			outinfo->present |= AIM_USERINFO_PRESENT_FLAGS;
+
+		} else if (type == 0x0002) {
+			/*
+			 * Type = 0x0002: Account creation time.
+			 *
+			 * The time/date that the user originally registered for
+			 * the service, stored in time_t format.
+			 *
+			 * I'm not sure how this differs from type 5 ("member
+			 * since").
+			 *
+			 * Note: This is the field formerly known as "member
+			 * since".  All these years and I finally found out
+			 * that I got the name wrong.
+			 */
+			outinfo->createtime = byte_stream_get32(bs);
+			outinfo->present |= AIM_USERINFO_PRESENT_CREATETIME;
+
+		} else if (type == 0x0003) {
+			/*
+			 * Type = 0x0003: On-Since date.
+			 *
+			 * The time/date that the user started their current
+			 * session, stored in time_t format.
+			 */
+			outinfo->onlinesince = byte_stream_get32(bs);
+			outinfo->present |= AIM_USERINFO_PRESENT_ONLINESINCE;
+
+		} else if (type == 0x0004) {
+			/*
+			 * Type = 0x0004: Idle time.
+			 *
+			 * Number of minutes since the user actively used the
+			 * service.
+			 *
+			 * Note that the client tells the server when to start
+			 * counting idle times, so this may or may not be
+			 * related to reality.
+			 */
+			outinfo->idletime = byte_stream_get16(bs);
+			outinfo->present |= AIM_USERINFO_PRESENT_IDLE;
+
+		} else if (type == 0x0005) {
+			/*
+			 * Type = 0x0005: Member since date.
+			 *
+			 * The time/date that the user originally registered for
+			 * the service, stored in time_t format.
+			 *
+			 * This is sometimes sent instead of type 2 ("account
+			 * creation time"), particularly in the self-info.
+			 * And particularly for ICQ?
+			 */
+			outinfo->membersince = byte_stream_get32(bs);
+			outinfo->present |= AIM_USERINFO_PRESENT_MEMBERSINCE;
+
+		} else if (type == 0x0006) {
+			/*
+			 * Type = 0x0006: ICQ Online Status
+			 *
+			 * ICQ's Away/DND/etc "enriched" status. Some decoding
+			 * of values done by Scott <[e-mail]>
+			 */
+			byte_stream_get16(bs);
+			outinfo->icqinfo.status = byte_stream_get16(bs);
+			outinfo->present |= AIM_USERINFO_PRESENT_ICQEXTSTATUS;
+
+		} else if (type == 0x0008) {
+			/*
+			 * Type = 0x0008
+			 *
+			 * Client type, or some such.
+			 */
+
+		} else if (type == 0x000a) {
+			/*
+			 * Type = 0x000a
+			 *
+			 * ICQ User IP Address.
+			 * Ahh, the joy of ICQ security.
+			 */
+			outinfo->icqinfo.ipaddr = byte_stream_get32(bs);
+			outinfo->present |= AIM_USERINFO_PRESENT_ICQIPADDR;
+
+		} else if (type == 0x000c) {
+			/*
+			 * Type = 0x000c
+			 *
+			 * random crap containing the IP address,
+			 * apparently a port number, and some Other Stuff.
+			 *
+			 * Format is:
+			 * 4 bytes - Our IP address, 0xc0 a8 01 2b for 192.168.1.43
+			 *
+			 *
+			 */
+			byte_stream_getrawbuf(bs, outinfo->icqinfo.crap, 0x25);
+			outinfo->present |= AIM_USERINFO_PRESENT_ICQDATA;
+
+		} else if (type == 0x000d) {
+			/*
+			 * Type = 0x000d
+			 *
+			 * OSCAR Capability information.
+			 *
+			 */
+			outinfo->capabilities |= aim_locate_getcaps(od, bs, length);
+			outinfo->present |= AIM_USERINFO_PRESENT_CAPABILITIES;
+
+		} else if (type == 0x000e) {
+			/*
+			 * Type = 0x000e
+			 *
+			 * AOL capability information.
+			 *
+			 */
+
+		} else if ((type == 0x000f) || (type == 0x0010)) {
+			/*
+			 * Type = 0x000f: Session Length. (AIM)
+			 * Type = 0x0010: Session Length. (AOL)
+			 *
+			 * The duration, in seconds, of the user's current
+			 * session.
+			 *
+			 * Which TLV type this comes in depends on the
+			 * service the user is using (AIM or AOL).
+			 *
+			 */
+			outinfo->sessionlen = byte_stream_get32(bs);
+			outinfo->present |= AIM_USERINFO_PRESENT_SESSIONLEN;
+
+		} else if (type == 0x0019) {
+			/*
+			 * Type = 0x0019
+			 *
+			 * OSCAR short capability information.  A shortened
+			 * form of the normal capabilities.
+			 */
+			outinfo->capabilities |= aim_locate_getcaps_short(od, bs, length);
+			outinfo->present |= AIM_USERINFO_PRESENT_CAPABILITIES;
+
+		} else if (type == 0x001b) {
+			/*
+			 * Type = 0x001a
+			 *
+			 * AOL short capability information.  A shortened
+			 * form of the normal capabilities.
+			 */
+
+		} else if (type == 0x001b) {
+			/*
+			 * Type = 0x0019
+			 *
+			 * Encryption certification MD5 checksum.
+			 */
+
+		} else if (type == 0x001d) {
+			/*
+			 * Type = 0x001d
+			 *
+			 * Buddy icon information and status/available messages.
+			 *
+			 * This almost seems like the AIM protocol guys gave
+			 * the iChat guys a Type, and the iChat guys tried to
+			 * cram as much cool shit into it as possible.  Then
+			 * the Windows AIM guys were like, "hey, that's
+			 * pretty neat, let's copy those prawns."
+			 *
+			 * In that spirit, this can contain a custom message,
+			 * kind of like an away message, but you're not away
+			 * (it's called an "available" message).  Or it can
+			 * contain information about the buddy icon the user
+			 * has stored on the server.
+			 */
+			int type2, number, length2;
+
+			while (byte_stream_curpos(bs) < endpos) {
+				type2 = byte_stream_get16(bs);
+				number = byte_stream_get8(bs);
+				length2 = byte_stream_get8(bs);
+
+				switch (type2) {
+					case 0x0000: { /* This is an official buddy icon? */
+						/* This is always 5 bytes of "0x02 01 d2 04 72"? */
+						byte_stream_advance(bs, length2);
+					} break;
+
+					case 0x0001: { /* A buddy icon checksum */
+						if ((length2 > 0) && ((number == 0x00) || (number == 0x01))) {
+							free(outinfo->iconcsum);
+							outinfo->iconcsumtype = number;
+							outinfo->iconcsum = byte_stream_getraw(bs, length2);
+							outinfo->iconcsumlen = length2;
+						} else
+							byte_stream_advance(bs, length2);
+					} break;
+
+					case 0x0002: { /* A status/available message */
+						free(outinfo->status);
+						free(outinfo->status_encoding);
+						if (length2 >= 4) {
+							outinfo->status_len = byte_stream_get16(bs);
+							outinfo->status = byte_stream_getstr(bs, outinfo->status_len);
+							if (byte_stream_get16(bs) == 0x0001) { /* We have an encoding */
+								byte_stream_get16(bs);
+								outinfo->status_encoding = byte_stream_getstr(bs, byte_stream_get16(bs));
+							} else {
+								/* No explicit encoding, client should use UTF-8 */
+								outinfo->status_encoding = NULL;
+							}
+						} else {
+							byte_stream_advance(bs, length2);
+							outinfo->status_len = 0;
+							outinfo->status = g_strdup("");
+							outinfo->status_encoding = NULL;
+						}
+					} break;
+
+					default: {
+						byte_stream_advance(bs, length2);
+					} break;
+				}
+			}
+
+		} else if (type == 0x001e) {
+			/*
+			 * Type 30: Unknown.
+			 *
+			 * Always four bytes, but it doesn't look like an int.
+			 */
+
+		} else if (type == 0x001f) {
+			/*
+			 * Type 31: Unknown.
+			 *
+			 * Seen on a buddy using DeadAIM.  Data was 4 bytes:
+			 * 0x00 00 00 10
+			 */
+
+		} else {
+
+			/*
+			 * Reaching here indicates that either AOL has
+			 * added yet another TLV for us to deal with,
+			 * or the parsing has gone Terribly Wrong.
+			 *
+			 * Either way, inform the owner and attempt
+			 * recovery.
+			 *
+			 */
+#if 0
+			gaim_debug_misc("oscar", "userinfo: **warning: unexpected TLV:\n");
+			gaim_debug_misc("oscar", "userinfo:   sn    =%s\n", outinfo->sn);
+			dumptlv(od, type, bs, length);
+#endif
+		}
+
+		/* Save ourselves. */
+		byte_stream_setpos(bs, endpos);
+	}
+
+	aim_locate_adduserinfo(od, outinfo);
+
+	return 0;
+}
+
+/*
+ * Inverse of aim_info_extract()
+ */
+int
+aim_putuserinfo(ByteStream *bs, aim_userinfo_t *info)
+{
+	aim_tlvlist_t *tlvlist = NULL;
+
+	if (!bs || !info)
+		return -EINVAL;
+
+	byte_stream_put8(bs, strlen(info->sn));
+	byte_stream_putstr(bs, info->sn);
+
+	byte_stream_put16(bs, info->warnlevel);
+
+	if (info->present & AIM_USERINFO_PRESENT_FLAGS)
+		aim_tlvlist_add_16(&tlvlist, 0x0001, info->flags);
+	if (info->present & AIM_USERINFO_PRESENT_MEMBERSINCE)
+		aim_tlvlist_add_32(&tlvlist, 0x0002, info->membersince);
+	if (info->present & AIM_USERINFO_PRESENT_ONLINESINCE)
+		aim_tlvlist_add_32(&tlvlist, 0x0003, info->onlinesince);
+	if (info->present & AIM_USERINFO_PRESENT_IDLE)
+		aim_tlvlist_add_16(&tlvlist, 0x0004, info->idletime);
+
+/* XXX - So, ICQ_OSCAR_SUPPORT is never defined anywhere... */
+#ifdef ICQ_OSCAR_SUPPORT
+	if (atoi(info->sn) != 0) {
+		if (info->present & AIM_USERINFO_PRESENT_ICQEXTSTATUS)
+			aim_tlvlist_add_16(&tlvlist, 0x0006, info->icqinfo.status);
+		if (info->present & AIM_USERINFO_PRESENT_ICQIPADDR)
+			aim_tlvlist_add_32(&tlvlist, 0x000a, info->icqinfo.ipaddr);
+	}
+#endif
+
+	if (info->present & AIM_USERINFO_PRESENT_CAPABILITIES)
+		aim_tlvlist_add_caps(&tlvlist, 0x000d, info->capabilities);
+
+	if (info->present & AIM_USERINFO_PRESENT_SESSIONLEN)
+		aim_tlvlist_add_32(&tlvlist, (guint16)((info->flags & AIM_FLAG_AOL) ? 0x0010 : 0x000f), info->sessionlen);
+
+	byte_stream_put16(bs, aim_tlvlist_count(&tlvlist));
+	aim_tlvlist_write(bs, &tlvlist);
+	aim_tlvlist_free(&tlvlist);
+
+	return 0;
+}
+
+/*
+ * Subtype 0x0001
+ */
+static int
+error(OscarData *od, FlapConnection *conn, aim_module_t *mod, FlapFrame *frame, aim_modsnac_t *snac, ByteStream *bs)
+{
+	int ret = 0;
+	aim_rxcallback_t userfunc;
+	aim_snac_t *snac2;
+	guint16 reason;
+	char *sn;
+	int was_explicit;
+
+	if (!(snac2 = aim_remsnac(od, snac->id))) {
+		gaim_debug_misc("oscar", "faim: locate.c, error(): received response from unknown request!\n");
+		return 0;
+	}
+
+	if ((snac2->family != 0x0002) && (snac2->type != 0x0015)) {
+		gaim_debug_misc("oscar", "faim: locate.c, error(): received response from invalid request! %d\n", snac2->family);
+		return 0;
+	}
+
+	if (!(sn = snac2->data)) {
+		gaim_debug_misc("oscar", "faim: locate.c, error(): received response from request without a screen name!\n");
+		return 0;
+	}
+
+	reason = byte_stream_get16(bs);
+
+	/*
+	 * Remove this screen name from our queue.  If the client requested
+	 * this buddy's info explicitly, then notify them that we do not have
+	 * info for this buddy.
+	 */
+	was_explicit = aim_locate_gotuserinfo(od, conn, sn);
+	if (was_explicit == TRUE)
+		if ((userfunc = aim_callhandler(od, snac->family, snac->subtype)))
+			ret = userfunc(od, conn, frame, reason, sn);
+
+	if (snac2)
+		free(snac2->data);
+	free(snac2);
+
+	return ret;
+}
+
+/*
+ * Subtype 0x0002
+ *
+ * Request Location services rights.
+ *
+ */
+int
+aim_locate_reqrights(OscarData *od)
+{
+	FlapConnection *conn;
+
+	if (!od || !(conn = flap_connection_findbygroup(od, SNAC_FAMILY_LOCATE)))
+		return -EINVAL;
+
+	aim_genericreq_n_snacid(od, conn, SNAC_FAMILY_LOCATE, SNAC_SUBTYPE_LOCATE_REQRIGHTS);
+
+	return 0;
+}
+
+/*
+ * Subtype 0x0003
+ *
+ * Normally contains:
+ *   t(0001)  - short containing max profile length (value = 1024)
+ *   t(0002)  - short - unknown (value = 16) [max MIME type length?]
+ *   t(0003)  - short - unknown (value = 10)
+ *   t(0004)  - short - unknown (value = 2048) [ICQ only?]
+ */
+static int
+rights(OscarData *od, FlapConnection *conn, aim_module_t *mod, FlapFrame *frame, aim_modsnac_t *snac, ByteStream *bs)
+{
+	aim_tlvlist_t *tlvlist;
+	aim_rxcallback_t userfunc;
+	int ret = 0;
+	guint16 maxsiglen = 0;
+
+	tlvlist = aim_tlvlist_read(bs);
+
+	if (aim_tlv_gettlv(tlvlist, 0x0001, 1))
+		maxsiglen = aim_tlv_get16(tlvlist, 0x0001, 1);
+
+	if ((userfunc = aim_callhandler(od, snac->family, snac->subtype)))
+		ret = userfunc(od, conn, frame, maxsiglen);
+
+	aim_tlvlist_free(&tlvlist);
+
+	return ret;
+}
+
+/*
+ * Subtype 0x0004
+ *
+ * Gives BOS your profile.
+ *
+ * profile_encoding and awaymsg_encoding MUST be set if profile or
+ * away are set, respectively, and their value may or may not be
+ * restricted to a few choices.  I am currently aware of:
+ *
+ * us-ascii		Just that
+ * unicode-2-0		UCS2-BE
+ *
+ * profile_len and awaymsg_len MUST be set similarly, and they MUST
+ * be the length of their respective strings in bytes.
+ *
+ * To get the previous behavior of awaymsg == "" un-setting the away
+ * message, set awaymsg non-NULL and awaymsg_len to 0 (this is the
+ * obvious equivalent).
+ *
+ */
+int
+aim_locate_setprofile(OscarData *od,
+				  const char *profile_encoding, const gchar *profile, const int profile_len,
+				  const char *awaymsg_encoding, const gchar *awaymsg, const int awaymsg_len)
+{
+	FlapConnection *conn;
+	FlapFrame *frame;
+	aim_snacid_t snacid;
+	aim_tlvlist_t *tl = NULL;
+	char *encoding;
+	static const char defencoding[] = {"text/aolrtf; charset=\"%s\""};
+
+	if (!od || !(conn = flap_connection_findbygroup(od, SNAC_FAMILY_LOCATE)))
+		return -EINVAL;
+
+	if (!profile && !awaymsg)
+		return -EINVAL;
+
+	if ((profile && profile_encoding == NULL) || (awaymsg && awaymsg_len && awaymsg_encoding == NULL)) {
+		return -EINVAL;
+	}
+
+	/* Build the packet first to get real length */
+	if (profile) {
+		/* no + 1 here because of %s */
+		encoding = malloc(strlen(defencoding) + strlen(profile_encoding));
+		snprintf(encoding, strlen(defencoding) + strlen(profile_encoding), defencoding, profile_encoding);
+		aim_tlvlist_add_str(&tl, 0x0001, encoding);
+		aim_tlvlist_add_raw(&tl, 0x0002, profile_len, (const guchar *)profile);
+		free(encoding);
+	}
+
+	/*
+	 * So here's how this works:
+	 *   - You are away when you have a non-zero-length type 4 TLV stored.
+	 *   - You become unaway when you clear the TLV with a zero-length
+	 *       type 4 TLV.
+	 *   - If you do not send the type 4 TLV, your status does not change
+	 *       (that is, if you were away, you'll remain away).
+	 */
+	if (awaymsg) {
+		if (awaymsg_len) {
+			encoding = malloc(strlen(defencoding) + strlen(awaymsg_encoding));
+			snprintf(encoding, strlen(defencoding) + strlen(awaymsg_encoding), defencoding, awaymsg_encoding);
+			aim_tlvlist_add_str(&tl, 0x0003, encoding);
+			aim_tlvlist_add_raw(&tl, 0x0004, awaymsg_len, (const guchar *)awaymsg);
+			free(encoding);
+		} else
+			aim_tlvlist_add_noval(&tl, 0x0004);
+	}
+
+	frame = flap_frame_new(od, 0x02, 10 + aim_tlvlist_size(&tl));
+
+	snacid = aim_cachesnac(od, 0x0002, 0x0004, 0x0000, NULL, 0);
+	aim_putsnac(&frame->data, 0x0002, 0x004, 0x0000, snacid);
+
+	aim_tlvlist_write(&frame->data, &tl);
+	aim_tlvlist_free(&tl);
+
+	flap_connection_send(conn, frame);
+
+	return 0;
+}
+
+/*
+ * Subtype 0x0004 - Set your client's capabilities.
+ */
+int
+aim_locate_setcaps(OscarData *od, guint32 caps)
+{
+	FlapConnection *conn;
+	FlapFrame *frame;
+	aim_snacid_t snacid;
+	aim_tlvlist_t *tl = NULL;
+
+	if (!od || !(conn = flap_connection_findbygroup(od, SNAC_FAMILY_LOCATE)))
+		return -EINVAL;
+
+	aim_tlvlist_add_caps(&tl, 0x0005, caps);
+
+	frame = flap_frame_new(od, 0x02, 10 + aim_tlvlist_size(&tl));
+
+	snacid = aim_cachesnac(od, 0x0002, 0x0004, 0x0000, NULL, 0);
+	aim_putsnac(&frame->data, 0x0002, 0x004, 0x0000, snacid);
+
+	aim_tlvlist_write(&frame->data, &tl);
+	aim_tlvlist_free(&tl);
+
+	flap_connection_send(conn, frame);
+
+	return 0;
+}
+
+/*
+ * Subtype 0x0005 - Request info of another AIM user.
+ *
+ * @param sn The screenname whose info you wish to request.
+ * @param infotype The type of info you wish to request.
+ *        0x0001 - Info/profile
+ *        0x0003 - Away message
+ *        0x0004 - Capabilities
+ */
+int
+aim_locate_getinfo(OscarData *od, const char *sn, guint16 infotype)
+{
+	FlapConnection *conn;
+	FlapFrame *frame;
+	aim_snacid_t snacid;
+
+	if (!od || !(conn = flap_connection_findbygroup(od, SNAC_FAMILY_LOCATE)) || !sn)
+		return -EINVAL;
+
+	frame = flap_frame_new(od, 0x02, 12+1+strlen(sn));
+
+	snacid = aim_cachesnac(od, 0x0002, 0x0005, 0x0000, NULL, 0);
+
+	aim_putsnac(&frame->data, 0x0002, 0x0005, 0x0000, snacid);
+	byte_stream_put16(&frame->data, infotype);
+	byte_stream_put8(&frame->data, strlen(sn));
+	byte_stream_putstr(&frame->data, sn);
+
+	flap_connection_send(conn, frame);
+
+	return 0;
+}
+
+/* Subtype 0x0006 */
+static int
+userinfo(OscarData *od, FlapConnection *conn, aim_module_t *mod, FlapFrame *frame, aim_modsnac_t *snac, ByteStream *bs)
+{
+	int ret = 0;
+	aim_rxcallback_t userfunc;
+	aim_userinfo_t *userinfo, *userinfo2;
+	aim_tlvlist_t *tlvlist;
+	aim_tlv_t *tlv = NULL;
+	int was_explicit;
+
+	userinfo = (aim_userinfo_t *)malloc(sizeof(aim_userinfo_t));
+	aim_info_extract(od, bs, userinfo);
+	tlvlist = aim_tlvlist_read(bs);
+
+	/* Profile will be 1 and 2 */
+	userinfo->info_encoding = aim_tlv_getstr(tlvlist, 0x0001, 1);
+	if ((tlv = aim_tlv_gettlv(tlvlist, 0x0002, 1))) {
+		userinfo->info = (char *)malloc(tlv->length);
+		memcpy(userinfo->info, tlv->value, tlv->length);
+		userinfo->info_len = tlv->length;
+	}
+
+	/* Away message will be 3 and 4 */
+	userinfo->away_encoding = aim_tlv_getstr(tlvlist, 0x0003, 1);
+	if ((tlv = aim_tlv_gettlv(tlvlist, 0x0004, 1))) {
+		userinfo->away = (char *)malloc(tlv->length);
+		memcpy(userinfo->away, tlv->value, tlv->length);
+		userinfo->away_len = tlv->length;
+	}
+
+	/* Caps will be 5 */
+	if ((tlv = aim_tlv_gettlv(tlvlist, 0x0005, 1))) {
+		ByteStream cbs;
+		byte_stream_init(&cbs, tlv->value, tlv->length);
+		userinfo->capabilities = aim_locate_getcaps(od, &cbs, tlv->length);
+		userinfo->present = AIM_USERINFO_PRESENT_CAPABILITIES;
+	}
+	aim_tlvlist_free(&tlvlist);
+
+	aim_locate_adduserinfo(od, userinfo);
+	userinfo2 = aim_locate_finduserinfo(od, userinfo->sn);
+	aim_info_free(userinfo);
+	free(userinfo);
+
+	/*
+	 * Remove this screen name from our queue.  If the client requested
+	 * this buddy's info explicitly, then notify them that we have info
+	 * for this buddy.
+	 */
+	was_explicit = aim_locate_gotuserinfo(od, conn, userinfo2->sn);
+	if (was_explicit == TRUE)
+		if ((userfunc = aim_callhandler(od, snac->family, snac->subtype)))
+			ret = userfunc(od, conn, frame, userinfo2);
+
+	return ret;
+}
+
+/*
+ * Subtype 0x0009 - Set directory profile data.
+ *
+ * This is not the same as aim_location_setprofile!
+ * privacy: 1 to allow searching, 0 to disallow.
+ *
+ */
+int aim_locate_setdirinfo(OscarData *od, const char *first, const char *middle, const char *last, const char *maiden, const char *nickname, const char *street, const char *city, const char *state, const char *zip, int country, guint16 privacy)
+{
+	FlapConnection *conn;
+	FlapFrame *frame;
+	aim_snacid_t snacid;
+	aim_tlvlist_t *tl = NULL;
+
+	if (!od || !(conn = flap_connection_findbygroup(od, SNAC_FAMILY_LOCATE)))
+		return -EINVAL;
+
+	aim_tlvlist_add_16(&tl, 0x000a, privacy);
+
+	if (first)
+		aim_tlvlist_add_str(&tl, 0x0001, first);
+	if (last)
+		aim_tlvlist_add_str(&tl, 0x0002, last);
+	if (middle)
+		aim_tlvlist_add_str(&tl, 0x0003, middle);
+	if (maiden)
+		aim_tlvlist_add_str(&tl, 0x0004, maiden);
+
+	if (state)
+		aim_tlvlist_add_str(&tl, 0x0007, state);
+	if (city)
+		aim_tlvlist_add_str(&tl, 0x0008, city);
+
+	if (nickname)
+		aim_tlvlist_add_str(&tl, 0x000c, nickname);
+	if (zip)
+		aim_tlvlist_add_str(&tl, 0x000d, zip);
+
+	if (street)
+		aim_tlvlist_add_str(&tl, 0x0021, street);
+
+	frame = flap_frame_new(od, 0x02, 10+aim_tlvlist_size(&tl));
+
+	snacid = aim_cachesnac(od, 0x0002, 0x0009, 0x0000, NULL, 0);
+
+	aim_putsnac(&frame->data, 0x0002, 0x0009, 0x0000, snacid);
+	aim_tlvlist_write(&frame->data, &tl);
+	aim_tlvlist_free(&tl);
+
+	flap_connection_send(conn, frame);
+
+	return 0;
+}
+
+/*
+ * Subtype 0x000b - Huh? What is this?
+ */
+int aim_locate_000b(OscarData *od, const char *sn)
+{
+	FlapConnection *conn;
+	FlapFrame *frame;
+	aim_snacid_t snacid;
+
+		return -EINVAL;
+
+	if (!od || !(conn = flap_connection_findbygroup(od, SNAC_FAMILY_LOCATE)) || !sn)
+		return -EINVAL;
+
+	frame = flap_frame_new(od, 0x02, 10+1+strlen(sn));
+
+	snacid = aim_cachesnac(od, 0x0002, 0x000b, 0x0000, NULL, 0);
+
+	aim_putsnac(&frame->data, 0x0002, 0x000b, 0x0000, snacid);
+	byte_stream_put8(&frame->data, strlen(sn));
+	byte_stream_putstr(&frame->data, sn);
+
+	flap_connection_send(conn, frame);
+
+	return 0;
+}
+
+/*
+ * Subtype 0x000f
+ *
+ * XXX pass these in better
+ *
+ */
+int
+aim_locate_setinterests(OscarData *od, const char *interest1, const char *interest2, const char *interest3, const char *interest4, const char *interest5, guint16 privacy)
+{
+	FlapConnection *conn;
+	FlapFrame *frame;
+	aim_snacid_t snacid;
+	aim_tlvlist_t *tl = NULL;
+
+	if (!od || !(conn = flap_connection_findbygroup(od, SNAC_FAMILY_LOCATE)))
+		return -EINVAL;
+
+	/* ?? privacy ?? */
+	aim_tlvlist_add_16(&tl, 0x000a, privacy);
+
+	if (interest1)
+		aim_tlvlist_add_str(&tl, 0x0000b, interest1);
+	if (interest2)
+		aim_tlvlist_add_str(&tl, 0x0000b, interest2);
+	if (interest3)
+		aim_tlvlist_add_str(&tl, 0x0000b, interest3);
+	if (interest4)
+		aim_tlvlist_add_str(&tl, 0x0000b, interest4);
+	if (interest5)
+		aim_tlvlist_add_str(&tl, 0x0000b, interest5);
+
+	frame = flap_frame_new(od, 0x02, 10+aim_tlvlist_size(&tl));
+
+	snacid = aim_cachesnac(od, 0x0002, 0x000f, 0x0000, NULL, 0);
+
+	aim_putsnac(&frame->data, 0x0002, 0x000f, 0x0000, 0);
+	aim_tlvlist_write(&frame->data, &tl);
+	aim_tlvlist_free(&tl);
+
+	flap_connection_send(conn, frame);
+
+	return 0;
+}
+
+/*
+ * Subtype 0x0015 - Request the info a user using the short method.  This is
+ * what iChat uses.  It normally is VERY leniently rate limited.
+ *
+ * @param sn The screen name whose info you wish to request.
+ * @param flags The bitmask which specifies the type of info you wish to request.
+ *        0x00000001 - Info/profile.
+ *        0x00000002 - Away message.
+ *        0x00000004 - Capabilities.
+ *        0x00000008 - Certification.
+ * @return Return 0 if no errors, otherwise return the error number.
+ */
+int
+aim_locate_getinfoshort(OscarData *od, const char *sn, guint32 flags)
+{
+	FlapConnection *conn;
+	FlapFrame *frame;
+	aim_snacid_t snacid;
+
+	if (!od || !(conn = flap_connection_findbygroup(od, SNAC_FAMILY_LOCATE)) || !sn)
+		return -EINVAL;
+
+	frame = flap_frame_new(od, 0x02, 10+4+1+strlen(sn));
+
+	snacid = aim_cachesnac(od, 0x0002, 0x0015, 0x0000, sn, strlen(sn)+1);
+
+	aim_putsnac(&frame->data, 0x0002, 0x0015, 0x0000, snacid);
+	byte_stream_put32(&frame->data, flags);
+	byte_stream_put8(&frame->data, strlen(sn));
+	byte_stream_putstr(&frame->data, sn);
+
+	flap_connection_send(conn, frame);
+
+	return 0;
+}
+
+static int
+snachandler(OscarData *od, FlapConnection *conn, aim_module_t *mod, FlapFrame *frame, aim_modsnac_t *snac, ByteStream *bs)
+{
+	if (snac->subtype == 0x0001)
+		return error(od, conn, mod, frame, snac, bs);
+	else if (snac->subtype == 0x0003)
+		return rights(od, conn, mod, frame, snac, bs);
+	else if (snac->subtype == 0x0006)
+		return userinfo(od, conn, mod, frame, snac, bs);
+
+	return 0;
+}
+
+static void
+locate_shutdown(OscarData *od, aim_module_t *mod)
+{
+	aim_userinfo_t *del;
+
+	while (od->locate.userinfo) {
+		del = od->locate.userinfo;
+		od->locate.userinfo = od->locate.userinfo->next;
+		aim_info_free(del);
+		free(del);
+	}
+}
+
+int
+locate_modfirst(OscarData *od, aim_module_t *mod)
+{
+	mod->family = SNAC_FAMILY_LOCATE;
+	mod->version = 0x0001;
+	mod->toolid = 0x0110;
+	mod->toolversion = 0x0629;
+	mod->flags = 0;
+	strncpy(mod->name, "locate", sizeof(mod->name));
+	mod->snachandler = snachandler;
+	mod->shutdown = locate_shutdown;
+
+	return 0;
+}