--- a/src/protocols/oscar/family_locate.c Sat Aug 19 00:24:14 2006 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1443 +0,0 @@ -/* - * 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 <darkagl@pcnet.com> - */ - 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; -}