pidgin/pidgin

merge of '77693555855fe9cd3215414f79964dba346cc5fa'
gaim
2008-11-12, Richard Laager
1966704b3e42
merge of '77693555855fe9cd3215414f79964dba346cc5fa'
and '19a87e98e5857ad0289f2c760d460f7f1dbbb42d'
/*
* 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
/* Define to log unknown TLVs */
/* #define LOG_UNKNOWN_TLV */
/*
* 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_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_UNICODE,
{0x09, 0x46, 0x13, 0x4e, 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_UNICODEOLD,
{0x2e, 0x7a, 0x64, 0x75, 0xfa, 0xdf, 0x4d, 0xc8,
0x88, 0x6f, 0xea, 0x35, 0x95, 0xfd, 0xb6, 0xdf}},
/*
{OSCAR_CAPABILITY_ICQ2GO,
{0x56, 0x3f, 0xc8, 0x09, 0x0b, 0x6f, 0x41, 0xbd,
0x9f, 0x79, 0x42, 0x26, 0x09, 0xdf, 0xa2, 0xf3}},
*/
/*
* Chat is oddball.
*/
{OSCAR_CAPABILITY_CHAT,
{0x74, 0x8f, 0x24, 0x20, 0x62, 0x87, 0x11, 0xd1,
0x82, 0x22, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00}},
/* 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_ICQRTF,
{0x97, 0xb1, 0x27, 0x51, 0x24, 0x3c, 0x43, 0x34,
0xad, 0x22, 0xd6, 0xab, 0xf7, 0x3f, 0x14, 0x92}},
{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;
} else if (!(userinfo->flags & AIM_FLAG_AWAY)) {
/*
* We don't have an away message specified in this user_info block.
* If the user is not away, clear any cached away message now.
*/
if (cur->away) {
free(cur->away);
cur->away = NULL;
}
if (cur->away_encoding) {
free(cur->away_encoding);
cur->away_encoding = NULL;
}
cur->away_len = 0;
}
/*
* 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(500,
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;
}
#ifdef LOG_UNKNOWN_TLV
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) {
/*
* 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) {
/*
* 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) {
/*
* 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) {
/*
* 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) {
/*
* 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) {
/*
* ICQ Online Status
*
* ICQ's Away/DND/etc "enriched" status. Some decoding
* of values done by Scott <darkagl@pcnet.com>
*/
byte_stream_get16(bs);
outinfo->icqinfo.status = byte_stream_get16(bs);
outinfo->present |= AIM_USERINFO_PRESENT_ICQEXTSTATUS;
} else if (type == 0x0008) {
/*
* Client type, or some such.
*/
} else if (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) {
/*
* 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) {
/*
* OSCAR Capability information
*/
outinfo->capabilities |= aim_locate_getcaps(od, bs, length);
outinfo->present |= AIM_USERINFO_PRESENT_CAPABILITIES;
} else if (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) {
/*
* 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 == 0x001a) {
/*
* Type = 0x001a
*
* AOL short capability information. A shortened
* form of the normal capabilities.
*/
} else if (type == 0x001b) {
/*
* Encryption certification MD5 checksum.
*/
} else if (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) {
/*
* Always four bytes, but it doesn't look like an int.
*/
} else if (type == 0x001f) {
/*
* 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.
*
*/
#ifdef LOG_UNKNOWN_TLV
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;
ByteStream data;
aim_snacid_t snacid;
if (!od || !(conn = flap_connection_findbygroup(od, SNAC_FAMILY_LOCATE)) || !sn)
return -EINVAL;
byte_stream_new(&data, 4 + 1 + strlen(sn));
byte_stream_put32(&data, flags);
byte_stream_put8(&data, strlen(sn));
byte_stream_putstr(&data, sn);
snacid = aim_cachesnac(od, 0x0002, 0x0015, 0x0000, sn, strlen(sn)+1);
flap_connection_send_snac(od, conn, 0x0002, 0x0015, 0x0000, snacid, &data);
g_free(data.data);
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;
}