Mercurial > pidgin.yaz
diff libpurple/protocols/myspace/myspace.c @ 16395:05e2df434077
Import msimprpl 0.4.
author | Jeffrey Connelly <jaconnel@calpoly.edu> |
---|---|
date | Sat, 21 Apr 2007 03:15:48 +0000 |
parents | |
children | 70c069168459 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/libpurple/protocols/myspace/myspace.c Sat Apr 21 03:15:48 2007 +0000 @@ -0,0 +1,1556 @@ +/* MySpaceIM Protocol Plugin + * + * \author Jeff Connelly + * + * Copyright (C) 2007, Jeff Connelly <myspaceim@xyzzy.cjb.net> + * + * Based on Gaim's "C Plugin HOWTO" hello world example. + * + * Code also drawn from myspace: + * http://snarfed.org/space/gaim+mock+protocol+plugin + * Copyright (C) 2004-2007, Ryan Barrett <mockprpl@ryanb.org> + * + * and some constructs also based on existing Gaim plugins, which are: + * Copyright (C) 2003, Robbert Haarman <gaim@inglorion.net> + * Copyright (C) 2003, Ethan Blanton <eblanton@cs.purdue.edu> + * Copyright (C) 2000-2003, Rob Flynn <rob@tgflinux.com> + * Copyright (C) 1998-1999, Mark Spencer <markster@marko.net> + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * This program 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 General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ + +#define GAIM_PLUGINS + +#include <string.h> +#include <errno.h> /* for EAGAIN */ + +#include <glib.h> + +#ifdef _WIN32 +#include "win32dep.h" +#else +/* For recv() and send(); needed to match Win32 */ +#include <sys/types.h> +#include <sys/socket.h> +#endif + +#include "notify.h" +#include "plugin.h" +#include "version.h" +#include "cipher.h" /* for SHA-1 */ +#include "util.h" /* for base64 */ +#include "debug.h" /* for gaim_debug_info */ + +#define MSIM_STATUS_ONLINE "online" +#define MSIM_STATUS_AWAY "away" +#define MSIM_STATUS_OFFLINE "offline" +#define MSIM_STATUS_INVISIBLE "invisible" + +/* Build version of MySpaceIM to report to servers */ +#define MSIM_CLIENT_VERSION 673 + +#define MSIM_SERVER "im.myspace.akadns.net" +//#define MSIM_SERVER "localhost" +#define MSIM_PORT 1863 /* TODO: alternate ports and automatic */ + +/* Constants */ +#define HASH_SIZE 0x14 /**< Size of SHA-1 hash for login */ +#define NONCE_HALF_SIZE 0x20 /**< Half of decoded 'nc' field */ +#define MSIM_READ_BUF_SIZE 5*1024 /**< Receive buffer size */ +#define MSIM_FINAL_STRING "\\final\\" /**< Message end marker */ + +/* Messages */ +#define MSIM_BM_INSTANT 1 +#define MSIM_BM_STATUS 100 +#define MSIM_BM_ACTION 121 +/*#define MSIM_BM_UNKNOWN1 122*/ + +/* Random number in every MsimSession, to ensure it is valid. */ +#define MSIM_SESSION_STRUCT_MAGIC 0xe4a6752b + +/* Everything needed to keep track of a session. */ +typedef struct _MsimSession +{ + guint magic; /**< MSIM_SESSION_STRUCT_MAGIC */ + GaimAccount *account; + GaimConnection *gc; + gchar *sesskey; /**< Session key text string from server */ + gchar *userid; /**< This user's numeric user ID */ + gint fd; /**< File descriptor to/from server */ + + GHashTable *user_lookup_cb; /**< Username -> userid lookup callback */ + GHashTable *user_lookup_cb_data; /**< Username -> userid lookup callback data */ + GHashTable *user_lookup_cache; /**< Cached information on users */ + + gchar *rxbuf; /**< Receive buffer */ + guint rxoff; /**< Receive buffer offset */ +} MsimSession; + +#define MSIM_SESSION_VALID(s) (session != NULL && session->magic == MSIM_SESSION_STRUCT_MAGIC) + +/* Callback for when a user's information is received, initiated from a user lookup. */ +typedef void (*MSIM_USER_LOOKUP_CB)(MsimSession *session, GHashTable *userinfo, gpointer data); + +/* Passed to MSIM_USER_LOOKUP_CB for msim_send_im_cb - called when + * user information is available, ready to send a message. */ +typedef struct _send_im_cb_struct +{ + gchar *who; + gchar *message; + GaimMessageFlags flags; +} send_im_cb_struct; + + +/* TODO: .h file */ +static void msim_lookup_user(MsimSession *session, const gchar *user, MSIM_USER_LOOKUP_CB cb, gpointer data); +static inline gboolean msim_is_userid(const gchar *user); +static void msim_session_destroy(MsimSession *session); + +static void init_plugin(GaimPlugin *plugin) +{ + gaim_notify_message(plugin, GAIM_NOTIFY_MSG_INFO, "Hello World!", + "This is the Hello World! plugin :)", NULL, NULL, NULL); +} + +/** + * Get possible user status types. Based on mockprpl. + * + * @return GList of status types. + */ +static GList *msim_status_types(GaimAccount *acct) +{ + GList *types; + GaimStatusType *type; + + gaim_debug_info("myspace", "returning status types for %s: %s, %s, %s\n", + acct->username, + MSIM_STATUS_ONLINE, MSIM_STATUS_AWAY, MSIM_STATUS_OFFLINE, MSIM_STATUS_INVISIBLE); + + + types = NULL; + + type = gaim_status_type_new(GAIM_STATUS_AVAILABLE, MSIM_STATUS_ONLINE, + MSIM_STATUS_ONLINE, TRUE); + gaim_status_type_add_attr(type, "message", "Online", + gaim_value_new(GAIM_TYPE_STRING)); + types = g_list_append(types, type); + + type = gaim_status_type_new(GAIM_STATUS_AWAY, MSIM_STATUS_AWAY, + MSIM_STATUS_AWAY, TRUE); + gaim_status_type_add_attr(type, "message", "Away", + gaim_value_new(GAIM_TYPE_STRING)); + types = g_list_append(types, type); + + type = gaim_status_type_new(GAIM_STATUS_OFFLINE, MSIM_STATUS_OFFLINE, + MSIM_STATUS_OFFLINE, TRUE); + gaim_status_type_add_attr(type, "message", "Offline", + gaim_value_new(GAIM_TYPE_STRING)); + types = g_list_append(types, type); + + type = gaim_status_type_new(GAIM_STATUS_INVISIBLE, MSIM_STATUS_INVISIBLE, + MSIM_STATUS_INVISIBLE, TRUE); + gaim_status_type_add_attr(type, "message", "Invisible", + gaim_value_new(GAIM_TYPE_STRING)); + types = g_list_append(types, type); + + return types; +} + +/** + * Parse a MySpaceIM protocol message into a hash table. + * + * @param msg The message string to parse, will be g_free()'d. + * + * @return Hash table of message. Caller should destroy with + * g_hash_table_destroy() when done. + */ +static GHashTable* msim_parse(gchar* msg) +{ + GHashTable *table; + gchar *token; + gchar **tokens; + gchar *key; + gchar *value; + int i; + + g_return_val_if_fail(msg != NULL, NULL); + + gaim_debug_info("msim", "msim_parse: got <%s>\n", msg); + + key = NULL; + + /* All messages begin with a \ */ + if (msg[0] != '\\' || msg[1] == 0) + { + gaim_debug_info("msim", "msim_parse: incomplete/bad msg, " + "missing initial backslash: <%s>", msg); + /* XXX: Should we try to recover, and read to first backslash? */ + + g_free(msg); + return NULL; + } + + /* Create table of strings, set to call g_free on destroy. */ + table = g_hash_table_new_full((GHashFunc)g_str_hash, + (GEqualFunc)g_str_equal, g_free, g_free); + + for (tokens = g_strsplit(msg + 1, "\\", 0), i = 0; + (token = tokens[i]); + i++) + { + //printf("tok=<%s>, i%2=%d\n", token, i % 2); + if (i % 2) + { + value = token; + + /* Check if key already exists */ + if (g_hash_table_lookup(table, key) == NULL) + { + //printf("insert: |%s|=|%s|\n", key, value); + g_hash_table_insert(table, g_strdup(key), g_strdup(value)); + } else { + /* TODO: Some dictionaries have multiple values for the same + * key. Should append to a GList to handle this case. */ + gaim_debug_info("msim", "msim_parse: key %s already exists, " + "not overwriting or replacing; ignoring new value %s", key, + value); + } + } else { + key = token; + } + } + g_strfreev(tokens); + + /* Can free now since all data was copied to hash key/values */ + g_free(msg); + + return table; +} + +#include "crypt-rc4.c" + +/** + * Compute the base64'd login challenge response based on username, password, nonce, and IPs. + * + * @param nonce The base64 encoded nonce ('nc') field from the server. + * @param email User's email address (used as login name). + * @param password User's cleartext password. + * + * @return Encoded login challenge response, ready to send to the server. Must be g_free()'d + * when finished. + */ +static gchar* msim_compute_login_response(guchar nonce[2*NONCE_HALF_SIZE], gchar* email, gchar* password) +{ + GaimCipherContext *key_context; + GaimCipher *sha1; + rc4_state_struct rc4; + guchar hash_pw[HASH_SIZE]; + guchar key[HASH_SIZE]; + gchar* password_utf16le; + guchar* data; + gchar* response; + int i, data_len; + + //memset(nonce, 0, NONCE_HALF_SIZE); + //memset(nonce + NONCE_HALF_SIZE, 1, NONCE_HALF_SIZE); + + /* Convert ASCII password to UTF16 little endian */ + /* TODO: use the built-in facility to do this, like Nathan Peterson does. */ + gaim_debug_info("msim", "converting password to utf16le\n"); + //printf("pw=<%s>\n",password); + password_utf16le = g_new0(gchar, strlen(password) * 2); + for (i = 0; i < strlen(password) * 2; i += 2) + { + password_utf16le[i] = password[i / 2]; + password_utf16le[i + 1] = 0; + } + + /* Compute password hash */ + gaim_cipher_digest_region("sha1", (guchar*)password_utf16le, strlen(password) * 2, + sizeof(hash_pw), hash_pw, NULL); + +#ifdef MSIM_DEBUG_LOGIN_CHALLENGE + printf("pwhash = "); + for (i = 0; i < sizeof(hash_pw); i++) + printf("%.2x ", hash_pw[i]); + printf("\n"); +#endif + + /* key = sha1(sha1(pw) + nonce2) */ + sha1 = gaim_ciphers_find_cipher("sha1"); + key_context = gaim_cipher_context_new(sha1, NULL); + gaim_cipher_context_append(key_context, hash_pw, HASH_SIZE); + gaim_cipher_context_append(key_context, nonce + NONCE_HALF_SIZE, NONCE_HALF_SIZE); + gaim_cipher_context_digest(key_context, sizeof(key), key, NULL); + +#ifdef MSIM_DEBUG_LOGIN_CHALLENGE + printf("key = "); + for (i = 0; i < sizeof(key); i++) + { + printf("%.2x ", key[i]); + } + printf("\n"); +#endif + + /* Note: 'key' variable is 0x14 bytes (from SHA-1 hash), + * but only first 0x10 used for the RC4 key. */ + crypt_rc4_init(&rc4, key, 0x10); + + /* TODO: obtain IPs of network interfaces. This is not immediately + * important because you can still connect and perform basic + * functions of the protocol. There is also a high chance that the addreses + * are RFC1918 private, so the servers couldn't do anything with them + * anyways except make note of that fact. Probably important for any + * kind of direct connection, or file transfer functionality. + */ + /* rc4 encrypt: + * nonce1+email+IP list */ + data_len = NONCE_HALF_SIZE + strlen(email) + 25; + data = g_new0(guchar, data_len); + memcpy(data, nonce, NONCE_HALF_SIZE); + memcpy(data + NONCE_HALF_SIZE, email, strlen(email)); + memcpy(data + NONCE_HALF_SIZE + strlen(email), + /* IP addresses of network interfaces */ + "\x00\x00\x00\x00\x05\x7f\x00\x00\x01\x00\x00\x00\x00\x0a\x00\x00\x40\xc0\xa8\x58\x01\xc0\xa8\x3c\x01", 25); + crypt_rc4(&rc4, data, data_len); + + response = gaim_base64_encode(data, data_len); +#ifdef MSIM_DEBUG_LOGIN_CHALLENGE + printf("response=<%s>\n", response); +#endif + + return response; +} + +static void print_hash_item(gpointer key, gpointer value, gpointer user_data) +{ + printf("%s=%s\n", (char*)key, (char*)value); +} + +/** + * Send an arbitrary protocol message. + * + * @param session + * @param msg The textual, encoded message to send. + * + * Note: this does not send instant messages. For that, see msim_send_im. + */ +static void msim_send(MsimSession *session, const gchar *msg) +{ + int ret; + + g_return_if_fail(MSIM_SESSION_VALID(session)); + g_return_if_fail(msg != NULL); + + gaim_debug_info("msim", "msim_send: writing <%s>\n", msg); + + ret = send(session->fd, msg, strlen(msg), 0); + + if (ret != strlen(msg)) + { + gaim_debug_info("msim", "msim_send(%s): strlen=%d, but only wrote %s\n", + msg, strlen(msg), ret); + /* TODO: better error */ + } +} + +/** + * Process a login challenge, sending a response. + * + * @param session + * @param table Hash table of login challenge message. + * + * @return 0, since the 'table' parameter is no longer needed. + */ +static int msim_login_challenge(MsimSession *session, GHashTable *table) +{ + GaimAccount *account; + gchar *nc_str; + guchar *nc; + gchar *response_str; + gsize nc_len; + gchar *buf; + + g_return_val_if_fail(MSIM_SESSION_VALID(session), 0); + g_return_val_if_fail(table != NULL, 0); + + nc_str = g_hash_table_lookup(table, "nc"); + + account = session->account; + //assert(account); + + gaim_connection_update_progress(session->gc, "Reading challenge", 1, 4); + + gaim_debug_info("msim", "nc=<%s>\n", nc_str); + + nc = (guchar*)gaim_base64_decode(nc_str, &nc_len); + gaim_debug_info("msim", "base64 decoded to %d bytes\n", nc_len); + if (nc_len != 0x40) + { + gaim_debug_info("msim", "bad nc length: %x != 0x40\n", nc_len); + gaim_connection_error(session->gc, "Unexpected challenge length from server"); + return 0; + } + + gaim_connection_update_progress(session->gc, "Logging in", 2, 4); + + printf("going to compute login response\n"); + //response_str = msim_compute_login_response(nc_str, "testuser", "testpw"); //session->gc->account->username, session->gc->account->password); + response_str = msim_compute_login_response(nc, account->username, account->password); + printf("got back login response\n"); + + g_free(nc); + + /* Reply */ + buf = g_strdup_printf("\\login2\\%d\\username\\%s\\response\\%s\\clientver\\%d\\reconn\\%d\\status\\%d\\id\\1\\final\\", + 196610, account->username, response_str, MSIM_CLIENT_VERSION, 0, 100); + + g_free(response_str); + + gaim_debug_info("msim", "response=<%s>\n", buf); + + msim_send(session, buf); + + g_free(buf); + + return 0; +} + +/** + * Parse a \x1c-separated "dictionary" of key=value pairs into a hash table. + * + * @param body_str The text of the dictionary to parse. Often the + * value for the 'body' field. + * + * @return Hash table of the keys and values. Must g_hash_table_destroy() when done. + */ +static GHashTable *msim_parse_body(const gchar *body_str) +{ + GHashTable *table; + gchar *item; + gchar **items; + gchar **elements; + guint i; + + g_return_val_if_fail(body_str != NULL, NULL); + + table = g_hash_table_new_full(g_str_hash, g_str_equal, g_free, g_free); + + for (items = g_strsplit(body_str, "\x1c", 0), i = 0; + (item = items[i]); + i++) + { + gchar *key, *value; + + //printf("TOK=<%s>\n", token); + elements = g_strsplit(item, "=", 2); + + key = elements[0]; + if (!key) + { + gaim_debug_info("msim", "msim_parse_body(%s): null key", body_str); + g_strfreev(elements); + break; + } + + value = elements[1]; + if (!value) + { + gaim_debug_info("msim", "msim_parse_body(%s): null value", body_str); + g_strfreev(elements); + break; + } + + //printf("-- %s: %s\n", key, value); + + /* XXX: This overwrites duplicates. */ + /* TODO: make the GHashTable values be GList's, and append to the list if + * there is already a value of the same key name. This is important for + * the WebChallenge message. */ + g_hash_table_insert(table, g_strdup(key), g_strdup(value)); + + g_strfreev(elements); + } + + g_strfreev(items); + + return table; +} + +/** + * Immediately send an IM to a user, by their numeric user ID. + * + * @param session + * @param userid ASCII numeric userid. + * @param message Text of message to send. + * @param flags Gaim instant message flags. + * + * @return 0, since the 'table' parameter is no longer needed. + * + */ +static int msim_send_im_by_userid(MsimSession *session, const gchar *userid, const gchar *message, GaimMessageFlags flags) +{ + gchar *msg_string; + + g_return_val_if_fail(MSIM_SESSION_VALID(session), 0); + g_return_val_if_fail(userid != NULL, 0); + g_return_val_if_fail(msim_is_userid(userid) == TRUE, 0); + g_return_val_if_fail(message != NULL, 0); + + /* TODO: constants for bm types */ + msg_string = g_strdup_printf("\\bm\\121\\sesskey\\%s\\t\\%s\\cv\\%d\\msg\\%s\\final\\", + session->sesskey, userid, MSIM_CLIENT_VERSION, message); + + gaim_debug_info("msim", "going to write: %s\n", msg_string); + + msim_send(session, msg_string); + + /* TODO: notify Gaim that we sent the IM. */ + + /* Not needed since sending messages to yourself is allowed by MSIM! */ + /*if (strcmp(from_username, who) == 0) + serv_got_im(gc, from_username, message, GAIM_MESSAGE_RECV, time(NULL)); + */ + + return 0; +} + + +/** + * Callback called when ready to send an IM by userid (the userid has been looked up). + * Calls msim_send_im_by_userid. + * + * @param session + * @param userinfo User info message from server containing a 'body' field + * with a 'UserID' key. This is where the user ID is taken from. + * @param data A send_im_cb_struct* of information on the IM to send. + * + */ +static void msim_send_im_by_userid_cb(MsimSession *session, GHashTable *userinfo, gpointer data) +{ + send_im_cb_struct *s; + gchar *userid; + GHashTable *body; + + g_return_if_fail(MSIM_SESSION_VALID(session)); + g_return_if_fail(userinfo != NULL); + + body = msim_parse_body(g_hash_table_lookup(userinfo, "body")); + g_assert(body); + + userid = g_hash_table_lookup(body, "UserID"); + + s = (send_im_cb_struct*)data; + msim_send_im_by_userid(session, userid, s->message, s->flags); + + g_hash_table_destroy(body); + g_hash_table_destroy(userinfo); + g_free(s->message); + g_free(s->who); +} + +/** + * Process a message reply from the server. + * + * @param session + * @param table Message reply from server. + * + * @return 0, since the 'table' field is no longer needed. + */ +static int msim_process_reply(MsimSession *session, GHashTable *table) +{ + gchar *rid_str; + + g_return_val_if_fail(MSIM_SESSION_VALID(session), 0); + g_return_val_if_fail(table != NULL, 0); + + rid_str = g_hash_table_lookup(table, "rid"); + + if (rid_str) /* msim_lookup_user sets callback for here */ + { + MSIM_USER_LOOKUP_CB cb; + gpointer data; + guint rid; + + GHashTable *body; + gchar *username; + + rid = atol(rid_str); + + /* Cache the user info. Currently, the GHashTable of user info in + * this cache never expires so is never freed. TODO: expire and destroy + * + * Some information never changes (username->userid map), some does. + * TODO: Cache what doesn't change only + */ + body = msim_parse_body(g_hash_table_lookup(table, "body")); + username = g_hash_table_lookup(body, "UserName"); + if (username) + { + g_hash_table_insert(session->user_lookup_cache, g_strdup(username), body); + } else { + gaim_debug_info("msim", "msim_process_reply: not caching <%s>, no UserName", + g_hash_table_lookup(table, "body")); + } + + /* If a callback is registered for this userid lookup, call it. */ + + cb = g_hash_table_lookup(session->user_lookup_cb, GUINT_TO_POINTER(rid)); + data = g_hash_table_lookup(session->user_lookup_cb_data, GUINT_TO_POINTER(rid)); + + if (cb) + { + gaim_debug_info("msim", "msim_process_body: calling callback now\n"); + cb(session, table, data); + g_hash_table_remove(session->user_lookup_cb, GUINT_TO_POINTER(rid)); + g_hash_table_remove(session->user_lookup_cb_data, GUINT_TO_POINTER(rid)); + + /* Return 1 to tell caller of msim_process (msim_input_cb) to + * not destroy 'table'; allow 'cb' to hang on to it and destroy + * it when it wants. */ + return 1; + } else { + gaim_debug_info("msim", "msim_process_body: no callback for rid %d\n", rid); + } + } + return 0; +} + +/** + * Handle an error from the server. + * + * @param session + * @param table The message. + * + * @return 0, since 'table' can be freed. + */ +static int msim_error(MsimSession *session, GHashTable *table) +{ + gchar *err, *errmsg, *full_errmsg; + + g_return_val_if_fail(MSIM_SESSION_VALID(session), 0); + g_return_val_if_fail(table != NULL, 0); + + err = g_hash_table_lookup(table, "err"); + errmsg = g_hash_table_lookup(table, "errmsg"); + + full_errmsg = g_strdup_printf("Protocol error, code %s: %s", err, errmsg); + + gaim_debug_info("msim", "msim_error: %s\n", full_errmsg); + + /* TODO: check 'fatal' and die if asked to. + * TODO: do something with the error # (localization of errmsg?) */ + gaim_notify_error(session->account, g_strdup("MySpaceIM Error"), + full_errmsg, NULL); + + if (g_hash_table_lookup(table, "fatal")) + { + gaim_debug_info("msim", "fatal error, destroy session\n"); + gaim_connection_error(session->gc, full_errmsg); + close(session->fd); + //msim_session_destroy(session); + } + + return 0; +} + +/** + * Callback to handle incoming messages, after resolving userid. + * + * @param session + * @param userinfo Message from server on user's info, containing UserName. + * @param data A gchar* of the incoming instant message's text. + */ +static void msim_incoming_im_cb(MsimSession *session, GHashTable *userinfo, gpointer data) +{ + gchar *msg; + gchar *username; + GHashTable *body; + + g_return_if_fail(MSIM_SESSION_VALID(session)); + g_return_if_fail(userinfo != NULL); + + body = msim_parse_body(g_hash_table_lookup(userinfo, "body")); + g_assert(body != NULL); + + username = g_hash_table_lookup(body, "UserName"); + + msg = (gchar*)data; + serv_got_im(session->gc, username, msg, GAIM_MESSAGE_RECV, time(NULL)); + + g_hash_table_destroy(body); + g_hash_table_destroy(userinfo); +} + +/** + * Handle an incoming message. + * + * @param session The session + * @param table Message from the server, containing 'f' (userid from) and 'msg'. + * + * @return 0, since table can be freed. + */ +static int msim_incoming_im(MsimSession *session, GHashTable *table) +{ + gchar *userid; + gchar *msg; + + g_return_val_if_fail(MSIM_SESSION_VALID(session), 0); + g_return_val_if_fail(table != NULL, 0); + + + userid = g_hash_table_lookup(table, "f"); + msg = g_hash_table_lookup(table, "msg"); + + gaim_debug_info("msim", "msim_incoming_im: got msg <%s> from <%s>, resolving username\n", + msg, userid); + + msim_lookup_user(session, userid, msim_incoming_im_cb, g_strdup(msg)); + + return 0; +} + +#if 0 +/* Not sure about this */ +static void msim_status_now(gchar *who, gpointer data) +{ + printf("msim_status_now: %s\n", who); +} +#endif + +/** + * Callback to update incoming status messages, after looked up username. + * + * @param session + * @param userinfo Looked up user information from server. + * @param data gchar* status string. + * + */ +static void msim_status_cb(MsimSession *session, GHashTable *userinfo, gpointer data) +{ + GaimBuddyList *blist; + GaimBuddy *buddy; + GaimPresence *presence; + GHashTable *body; + //GaimStatus *status; + gchar **status_array; + GList *list; + gchar *status_text, *status_code; + gchar *status_str; + gint i; + gchar *username; + + g_return_if_fail(MSIM_SESSION_VALID(session)); + g_return_if_fail(userinfo != NULL); + + status_str = (gchar*)data; + + body = msim_parse_body(g_hash_table_lookup(userinfo, "body")); + g_assert(body); + + username = g_hash_table_lookup(body, "UserName"); + /* Note: DisplayName doesn't seem to be resolvable. It could be displayed on + * the buddy list, if the UserID was stored along with it. */ + + if (!username) + { + gaim_debug_info("msim", "msim_status_cb: no username?!\n"); + return; + } + + gaim_debug_info("msim", "msim_status_cb: updating status for <%s> to <%s>\n", username, status_str); + + /* TODO: generic functions to split into a GList */ + status_array = g_strsplit(status_str, "|", 0); + for (list = NULL, i = 0; + status_array[i]; + i++) + { + list = g_list_append(list, status_array[i]); + } + + /* Example fields: |s|0|ss|Offline */ + status_code = g_list_nth_data(list, 2); + status_text = g_list_nth_data(list, 4); + + blist = gaim_get_blist(); + + /* Add buddy if not found */ + buddy = gaim_find_buddy(session->account, username); + if (!buddy) + { + /* TODO: gaim aliases, userids and usernames */ + gaim_debug_info("msim", "msim_status: making new buddy for %s\n", username); + buddy = gaim_buddy_new(session->account, username, NULL); + + /* TODO: sometimes (when click on it), buddy list disappears. Fix. */ + gaim_blist_add_buddy(buddy, NULL, NULL, NULL); + } else { + gaim_debug_info("msim", "msim_status: found buddy %s\n", username); + } + + /* For now, always set status to online. + * TODO: make status reflect reality + * TODO: show headline */ + presence = gaim_presence_new_for_buddy(buddy); + gaim_presence_set_status_active(presence, MSIM_STATUS_ONLINE, TRUE); + + g_strfreev(status_array); + g_list_free(list); + g_hash_table_destroy(body); + g_hash_table_destroy(userinfo); + /* Do not free status_str - it will be freed by g_hash_table_destroy on session->userid_lookup_cb_data */ +} + +/** + * Process incoming status messages. + * + * @param session + * @param table Status update message. + * + * @return 0, since 'table' can be freed. + */ +static int msim_status(MsimSession *session, GHashTable *table) +{ + gchar *status_str; + gchar *userid; + + g_return_val_if_fail(MSIM_SESSION_VALID(session), 0); + g_return_val_if_fail(table != NULL, 0); + + status_str = g_hash_table_lookup(table, "msg"); + if (!status_str) + { + gaim_debug_info("msim", "msim_status: bm=100 but no status msg\n"); + return 0; + } + + userid = g_hash_table_lookup(table, "f"); + if (!userid) + { + gaim_debug_info("msim", "msim_status: bm=100 but no f field\n"); + return 0; + } + + /* TODO: if buddies were identified on buddy list by uid, wouldn't have to lookup + * before updating the status! Much more efficient. */ + gaim_debug_info("msim", "msim_status: got status msg <%s> for <%s>, scheduling lookup\n", + status_str, userid); + + /* Actually update status once obtain username */ + msim_lookup_user(session, userid, msim_status_cb, g_strdup(status_str)); + + return 0; +} + + +/** + * Process a message. + * + * @param gc Connection. + * @param table Any message from the server. + * + * @return The return value of the function used to process the message, or -1 if + * called with invalid parameters. + */ +static int msim_process(GaimConnection *gc, GHashTable *table) +{ + MsimSession *session; + + g_return_val_if_fail(gc != NULL, -1); + g_return_val_if_fail(table != NULL, -1); + + session = (MsimSession*)gc->proto_data; + + printf("-------- message -------------\n"); + g_hash_table_foreach(table, print_hash_item, NULL); + printf("------------------------------\n"); + + if (g_hash_table_lookup(table, "nc")) + { + return msim_login_challenge(session, table); + } else if (g_hash_table_lookup(table, "sesskey")) { + printf("SESSKEY=<%s>\n", (gchar*)g_hash_table_lookup(table, "sesskey")); + + gaim_connection_update_progress(gc, "Connected", 3, 4); + + session->sesskey = g_strdup(g_hash_table_lookup(table, "sesskey")); + + /* Comes with: proof,profileid,userid,uniquenick -- all same values + * (at least for me). */ + session->userid = g_strdup(g_hash_table_lookup(table, "userid")); + + gaim_connection_set_state(gc, GAIM_CONNECTED); + + return 0; + } else if (g_hash_table_lookup(table, "bm")) { + guint bm; + + bm = atoi(g_hash_table_lookup(table, "bm")); + switch (bm) + { + case MSIM_BM_STATUS: + return msim_status(session, table); + case MSIM_BM_INSTANT: + return msim_incoming_im(session, table); + default: + /* Not really an IM, but show it for informational + * purposes during development. */ + return msim_incoming_im(session, table); + } + + if (bm == MSIM_BM_STATUS) + { + return msim_status(session, table); + } else { /* else if strcmp(bm, "1") == 0) */ + return msim_incoming_im(session, table); + } + } else if (g_hash_table_lookup(table, "rid")) { + return msim_process_reply(session, table); + } else if (g_hash_table_lookup(table, "error")) { + return msim_error(session, table); + } else if (g_hash_table_lookup(table, "ka")) { + gaim_debug_info("msim", "msim_process: got keep alive\n"); + return 0; + } else { + printf("<<unhandled>>\n"); + return 0; + } +} + +/** + * Callback when input available. + * + * @param gc_uncasted A GaimConnection pointer. + * @param source File descriptor. + * @param cond GAIM_INPUT_READ + * + * Reads the input, and dispatches calls msim_process to handle it. + */ +static void msim_input_cb(gpointer gc_uncasted, gint source, GaimInputCondition cond) +{ + GaimConnection *gc; + GaimAccount *account; + MsimSession *session; + gchar *end; + int n; + + g_return_if_fail(gc_uncasted != NULL); + g_return_if_fail(source >= 0); /* Note: 0 is a valid fd */ + + gc = (GaimConnection*)(gc_uncasted); + account = gaim_connection_get_account(gc); + session = gc->proto_data; + + g_return_if_fail(MSIM_SESSION_VALID(session)); + + g_assert(cond == GAIM_INPUT_READ); + + /* Only can handle so much data at once... + * If this happens, try recompiling with a higher MSIM_READ_BUF_SIZE. + * Should be large enough to hold the largest protocol message. + */ + if (session->rxoff == MSIM_READ_BUF_SIZE) + { + gaim_debug_error("msim", "msim_input_cb: %d-byte read buffer full!\n", + MSIM_READ_BUF_SIZE); + gaim_connection_error(gc, "Read buffer full"); + /* TODO: fix 100% CPU after closing */ + close(source); + return; + } + + gaim_debug_info("msim", "buffer at %d (max %d), reading up to %d\n", + session->rxoff, MSIM_READ_BUF_SIZE, MSIM_READ_BUF_SIZE - session->rxoff); + + /* Read into buffer. On Win32, need recv() not read(). session->fd also holds + * the file descriptor, but it sometimes differs from the 'source' parameter. + */ + n = recv(session->fd, session->rxbuf + session->rxoff, MSIM_READ_BUF_SIZE - session->rxoff, 0); + + if (n < 0 && errno == EAGAIN) + { + return; + } + else if (n < 0) + { + gaim_connection_error(gc, "Read error"); + gaim_debug_error("msim", "msim_input_cb: read error, ret=%d, " + "error=%s, source=%d, fd=%d (%X))\n", + n, strerror(errno), source, session->fd, session->fd); + close(source); + return; + } + else if (n == 0) + { + gaim_debug_info("msim", "msim_input_cb: server disconnected\n"); + gaim_connection_error(gc, "Server has disconnected"); + return; + } + + /* Null terminate */ + session->rxbuf[session->rxoff + n] = 0; + + /* Check for embedded NULs. I don't handle them, and they shouldn't occur. */ + if (strlen(session->rxbuf + session->rxoff) != n) + { + /* Occurs after login, but it is not a null byte. */ + gaim_debug_info("msim", "msim_input_cb: strlen=%d, but read %d bytes" + "--null byte encountered?\n", strlen(session->rxbuf + session->rxoff), n); + //gaim_connection_error(gc, "Invalid message - null byte on input"); + return; + } + + session->rxoff += n; + gaim_debug_info("msim", "msim_input_cb: read=%d\n", n); + + //printf("buf=<%s>\n", session->rxbuf); + + /* Look for \\final\\ end markers. If found, process message. */ + while((end = strstr(session->rxbuf, MSIM_FINAL_STRING))) + { + GHashTable *table; + + //printf("in loop: buf=<%s>\n", session->rxbuf); + *end = 0; + table = msim_parse(g_strdup(session->rxbuf)); + if (!table) + { + gaim_debug_info("msim", "msim_input_cb: couldn't parse <%s>\n", session->rxbuf); + gaim_connection_error(gc, "Unparseable message"); + } + else + { + /* Process message. Returns 0 to free */ + if (msim_process(gc, table) == 0) + g_hash_table_destroy(table); + } + + /* Move remaining part of buffer to beginning. */ + session->rxoff -= strlen(session->rxbuf) + strlen(MSIM_FINAL_STRING); + memmove(session->rxbuf, end + strlen(MSIM_FINAL_STRING), + MSIM_READ_BUF_SIZE - (end + strlen(MSIM_FINAL_STRING) - session->rxbuf)); + + /* Clear end of buffer */ + //memset(end, 0, MSIM_READ_BUF_SIZE - (end - session->rxbuf)); + } +} + +/** + * Callback when connected. Sets up input handlers. + * + * @param data A GaimConnection pointer. + * @param source File descriptor. + * @param error_message + */ +static void msim_connect_cb(gpointer data, gint source, const gchar *error_message) +{ + GaimConnection *gc; + MsimSession *session; + + g_return_if_fail(data != NULL); + + gc = (GaimConnection*)data; + session = gc->proto_data; + + if (source < 0) + { + gaim_connection_error(gc, "Couldn't connect to host"); + gaim_connection_error(gc, g_strdup_printf("Couldn't connect to host: %s (%d)", + error_message, source)); + return; + } + + session->fd = source; + + gc->inpa = gaim_input_add(source, GAIM_INPUT_READ, msim_input_cb, gc); +} + +/* Session methods */ + +/** + * Create a new MSIM session. + * + * @param acct The account to create the session from. + * + * @return Pointer to a new session. Free with msim_session_destroy. + */ +static MsimSession *msim_session_new(GaimAccount *acct) +{ + MsimSession *session; + + g_return_val_if_fail(acct != NULL, NULL); + + session = g_new0(MsimSession, 1); + + session->magic = MSIM_SESSION_STRUCT_MAGIC; + session->account = acct; + session->gc = gaim_account_get_connection(acct); + session->fd = -1; + session->user_lookup_cb = g_hash_table_new_full(g_direct_hash, g_direct_equal, NULL, NULL); /* do NOT free function pointers! */ + session->user_lookup_cb_data = g_hash_table_new_full(g_direct_hash, g_direct_equal, NULL, g_free); + session->user_lookup_cache = g_hash_table_new_full(g_str_hash, g_str_equal, g_free, (GDestroyNotify)g_hash_table_destroy); + session->rxoff = 0; + session->rxbuf = g_new0(gchar, MSIM_READ_BUF_SIZE); + + return session; +} + +/** + * Free a session. + * + * @param session The session to destroy. + */ +static void msim_session_destroy(MsimSession *session) +{ + g_return_if_fail(MSIM_SESSION_VALID(session)); + + session->magic = -1; + + g_free(session->rxbuf); + g_free(session->userid); + g_free(session->sesskey); + + g_free(session); +} + +/** + * Start logging in to the MSIM servers. + * + * @param acct Account information to use to login. + */ +static void msim_login(GaimAccount *acct) +{ + GaimConnection *gc; + const char *host; + int port; + + g_return_if_fail(acct != NULL); + + gaim_debug_info("myspace", "logging in %s\n", acct->username); + + gc = gaim_account_get_connection(acct); + gc->proto_data = msim_session_new(acct); + + /* 1. connect to server */ + gaim_connection_update_progress(gc, "Connecting", + 0, /* which connection step this is */ + 4); /* total number of steps */ + + /* TODO: GUI option to be user-modifiable. */ + host = gaim_account_get_string(acct, "server", MSIM_SERVER); + port = gaim_account_get_int(acct, "port", MSIM_PORT); + /* TODO: connect */ + /* From gaim.sf.net/api: + * """Note that this function name can be misleading--although it is called + * "proxy connect," it is used for establishing any outgoing TCP connection, + * whether through a proxy or not.""" */ + + /* Calls msim_connect_cb when connected. */ + if (gaim_proxy_connect(gc, acct, host, port, msim_connect_cb, gc) == NULL) + { + /* TODO: try other ports if in auto mode, then save + * working port and try that first next time. */ + gaim_connection_error(gc, "Couldn't create socket"); + return; + } + +} + + +/** + * Close the connection. + * + * @param gc The connection. + */ +static void msim_close(GaimConnection *gc) +{ + g_return_if_fail(gc != NULL); + + msim_session_destroy(gc->proto_data); +} + +/** + * Return the icon name for a buddy and account. + * + * @param acct The account to find the icon for. + * @param buddy The buddy to find the icon for, or NULL for the accoun icon. + * + * @return The base icon name string. + */ +static const gchar *msim_list_icon(GaimAccount *acct, GaimBuddy *buddy) +{ + /* TODO: use a MySpace icon. hbons submitted one to + * http://developer.pidgin.im/wiki/MySpaceIM - tried placing in + * C:\cygwin\home\Jeff\gaim-2.0.0beta6\gtk\pixmaps\status\default + * and returning "myspace" but icon shows up blank. + */ + if (acct == NULL) + { + gaim_debug_info("msim", "msim_list_icon: acct == NULL!\n"); + //exit(-2); + } + return "meanwhile"; +} + +/** + * Check if a string is a userid (all numeric). + * + * @param user The user id, email, or name. + * + * @return TRUE if is userid, FALSE if not. + */ +static inline gboolean msim_is_userid(const gchar *user) +{ + g_return_val_if_fail(user != NULL, FALSE); + + return strspn(user, "0123456789") == strlen(user); +} + +/** + * Check if a string is an email address (contains an @). + * + * @param user The user id, email, or name. + * + * @return TRUE if is an email, FALSE if not. + * + * This function is not intended to be used as a generic + * means of validating email addresses, but to distinguish + * between a user represented by an email address from + * other forms of identification. + */ +static inline gboolean msim_is_email(const gchar *user) +{ + g_return_val_if_fail(user != NULL, FALSE); + + return strchr(user, '@') != NULL; +} + + +/** + * Asynchronously lookup user information, calling callback when receive result. + * + * @param session + * @param user The user id, email address, or username. + * @param cb Callback, called with user information when available. + * @param data An arbitray data pointer passed to the callback. + */ +static void msim_lookup_user(MsimSession *session, const gchar *user, MSIM_USER_LOOKUP_CB cb, gpointer data) +{ + gchar *field_name; + gchar *msg_string; + guint rid, cmd, dsn, lid; + + g_return_if_fail(MSIM_SESSION_VALID(session)); + g_return_if_fail(user != NULL); + g_return_if_fail(cb != NULL); + + gaim_debug_info("msim", "msim_lookup_userid", "asynchronously looking up <%s>\n", user); + + /* TODO: check if this user's info was cached and fresh; if so return immediately */ +#if 0 + /* If already know userid, then call callback immediately */ + cached_userid = g_hash_table_lookup(session->userid_cache, who); + if (cached_userid && !by_userid) + { + cb(cached_userid, NULL, NULL, data); + return; + } +#endif + + rid = rand(); //om(); + + /* Setup callback. Response will be associated with request using 'rid'. */ + g_hash_table_insert(session->user_lookup_cb, GUINT_TO_POINTER(rid), cb); + g_hash_table_insert(session->user_lookup_cb_data, GUINT_TO_POINTER(rid), data); + + /* Send request */ + + cmd = 1; + + if (msim_is_userid(user)) + { + /* TODO: document cmd,dsn,lid */ + field_name = "UserID"; + dsn = 4; + lid = 3; + } else if (msim_is_email(user)) { + field_name = "Email"; + dsn = 5; + lid = 7; + } else { + field_name = "UserName"; + dsn = 5; + lid = 7; + } + + msg_string = g_strdup_printf("\\persist\\1\\sesskey\\%s\\cmd\\1\\dsn\\%d\\uid\\%s\\lid\\%d\\rid\\%d\\body\\%s=%s\\final\\", + session->sesskey, dsn, session->userid, lid, rid, field_name, user); + + msim_send(session, msg_string); +} + +/** + * Schedule an IM to be sent once the user ID is looked up. + * + * @param gc Connection. + * @param who A user id, email, or username to send the message to. + * @param message Instant message text to send. + * @param flags Flags. + * + * @return 1 in all cases, even if the message delivery is destined to fail. + * + * Allows sending to a user by username, email address, or userid. If + * a username or email address is given, the userid must be looked up. + * This function does that by calling msim_lookup_user(), setting up + * a msim_send_im_by_userid_cb() callback function called when the userid + * response is received from the server. + * + * The callback function calls msim_send_im_by_userid() to send the actual + * instant message. If a userid is specified directly, this function is called + * immediately here. + */ +static int msim_send_im(GaimConnection *gc, const char *who, + const char *message, GaimMessageFlags flags) +{ + MsimSession *session; + const char *from_username = gc->account->username; + send_im_cb_struct *cbinfo; + + g_return_val_if_fail(gc != NULL, 0); + g_return_val_if_fail(who != NULL, 0); + g_return_val_if_fail(message != NULL, 0); + + gaim_debug_info("msim", "sending message from %s to %s: %s\n", + from_username, who, message); + + session = gc->proto_data; + + /* If numeric ID, can send message immediately without userid lookup */ + if (msim_is_userid(who)) + { + gaim_debug_info("msim", "msim_send_im: numeric 'who' detected, sending asap\n"); + msim_send_im_by_userid(session, who, message, flags); + return 1; + } + + /* Otherwise, add callback to IM when userid of destination is available */ + + /* Setup a callback for when the userid is available */ + cbinfo = g_new0(send_im_cb_struct, 1); + cbinfo->who = g_strdup(who); + cbinfo->message = g_strdup(message); + cbinfo->flags = flags; + + /* Send the request to lookup the userid */ + msim_lookup_user(session, who, msim_send_im_by_userid_cb, cbinfo); + + /* msim_send_im_by_userid_cb will now be called once userid is looked up */ + + /* Return 1 to have Gaim show this IM as being sent, 0 to not. I always + * return 1 even if the message could not be sent, since I don't know if + * it has failed yet--because the IM is only sent after the userid is + * retrieved from the server (which happens after this function returns). + * + * TODO: In MySpace, you login with your email address, but don't talk to other + * users using their email address. So there is currently an asymmetry in the + * IM windows when using this plugin: + * + * you@example.com: hello + * some_other_user: what's going on? + * you@example.com: just coding a prpl + * + * TODO: Make the sent IM's appear as from the user's username, instead of + * their email address. Gaim uses the login (in MSIM, the email)--change this. + */ + return 1; +} + +/** + * Obtain the status text for a buddy. + * + * @param buddy The buddy to obtain status text for. + * + * @return Status text. + * + * Currently returns the display name. + */ +static char *msim_status_text(GaimBuddy *buddy) +{ + MsimSession *session; + GHashTable *userinfo; + gchar *display_name; + + g_return_val_if_fail(buddy != NULL, NULL); + + session = (MsimSession*)buddy->account->gc->proto_data; + g_assert(MSIM_SESSION_VALID(session)); + g_assert(session->user_lookup_cache != NULL); + + userinfo = g_hash_table_lookup(session->user_lookup_cache, buddy->name); + if (!userinfo) + { + return g_strdup(""); + } + + display_name = g_hash_table_lookup(userinfo, "DisplayName"); + g_assert(display_name != NULL); + + return g_strdup(display_name); +} + +/** + * Obtain the tooltip text for a buddy. + * + * @param buddy Buddy to obtain tooltip text on. + * @param user_info Variable modified to have the tooltip text. + * @param full TRUE if should obtain full tooltip text. + * + */ +static void msim_tooltip_text(GaimBuddy *buddy, GaimNotifyUserInfo *user_info, gboolean full) +{ + g_return_if_fail(buddy != NULL); + g_return_if_fail(user_info != NULL); + + if (GAIM_BUDDY_IS_ONLINE(buddy)) + { + MsimSession *session; + GHashTable *userinfo; + + session = (MsimSession*)buddy->account->gc->proto_data; + + g_assert(MSIM_SESSION_VALID(session)); + g_assert(session->user_lookup_cache); + + userinfo = g_hash_table_lookup(session->user_lookup_cache, buddy->name); + + g_assert(userinfo != NULL); + + // TODO: if (full), do something different + gaim_notify_user_info_add_pair(user_info, "User ID", g_hash_table_lookup(userinfo, "UserID")); + gaim_notify_user_info_add_pair(user_info, "Display Name", g_hash_table_lookup(userinfo, "DisplayName")); + gaim_notify_user_info_add_pair(user_info, "User Name", g_hash_table_lookup(userinfo, "UserName")); + gaim_notify_user_info_add_pair(user_info, "Total Friends", g_hash_table_lookup(userinfo, "TotalFriends")); + gaim_notify_user_info_add_pair(user_info, "Song", + g_strdup_printf("%s - %s", + (gchar*)g_hash_table_lookup(userinfo, "BandName"), + (gchar*)g_hash_table_lookup(userinfo, "SongName"))); + } +} + +/** Callbacks called by Gaim, to access this plugin. */ +static GaimPluginProtocolInfo prpl_info = +{ + OPT_PROTO_MAIL_CHECK,/* options - TODO: myspace will notify of mail */ + NULL, /* user_splits */ + NULL, /* protocol_options */ + NO_BUDDY_ICONS, /* icon_spec - TODO: eventually should add this */ + msim_list_icon, /* list_icon */ + NULL, /* list_emblems */ + msim_status_text, /* status_text */ + msim_tooltip_text, /* tooltip_text */ + msim_status_types, /* status_types */ + NULL, /* blist_node_menu */ + NULL, /* chat_info */ + NULL, /* chat_info_defaults */ + msim_login, /* login */ + msim_close, /* close */ + msim_send_im, /* send_im */ + NULL, /* set_info */ + NULL, /* send_typing */ + NULL, /* get_info */ + NULL, /* set_away */ + NULL, /* set_idle */ + NULL, /* change_passwd */ + NULL, /* add_buddy */ + NULL, /* add_buddies */ + NULL, /* remove_buddy */ + NULL, /* remove_buddies */ + NULL, /* add_permit */ + NULL, /* add_deny */ + NULL, /* rem_permit */ + NULL, /* rem_deny */ + NULL, /* set_permit_deny */ + NULL, /* join_chat */ + NULL, /* reject chat invite */ + NULL, /* get_chat_name */ + NULL, /* chat_invite */ + NULL, /* chat_leave */ + NULL, /* chat_whisper */ + NULL, /* chat_send */ + NULL, /* keepalive */ + NULL, /* register_user */ + NULL, /* get_cb_info */ + NULL, /* get_cb_away */ + NULL, /* alias_buddy */ + NULL, /* group_buddy */ + NULL, /* rename_group */ + NULL, /* buddy_free */ + NULL, /* convo_closed */ + NULL, /* normalize */ + NULL, /* set_buddy_icon */ + NULL, /* remove_group */ + NULL, /* get_cb_real_name */ + NULL, /* set_chat_topic */ + NULL, /* find_blist_chat */ + NULL, /* roomlist_get_list */ + NULL, /* roomlist_cancel */ + NULL, /* roomlist_expand_category */ + NULL, /* can_receive_file */ + NULL, /* send_file */ + NULL, /* new_xfer */ + NULL, /* offline_message */ + NULL, /* whiteboard_prpl_ops */ + NULL, /* send_raw */ + NULL /* roomlist_room_serialize */ +}; + + + +/** Based on MSN's plugin info comments. */ +static GaimPluginInfo info = +{ + GAIM_PLUGIN_MAGIC, + GAIM_MAJOR_VERSION, + GAIM_MINOR_VERSION, + GAIM_PLUGIN_PROTOCOL, /**< type */ + NULL, /**< ui_requirement */ + 0, /**< flags */ + NULL, /**< dependencies */ + GAIM_PRIORITY_DEFAULT, /**< priority */ + + "prpl-myspace", /**< id */ + "MySpaceIM", /**< name */ + "0.4", /**< version */ + /** summary */ + "MySpaceIM Protocol Plugin", + /** description */ + "MySpaceIM Protocol Plugin", + "Jeff Connelly <myspaceim@xyzzy.cjb.net>", /**< author */ + "http://developer.pidgin.im/wiki/MySpaceIM/", /**< homepage */ + + NULL, /**< load */ + NULL, /**< unload */ + NULL, /**< destroy */ + NULL, /**< ui_info */ + &prpl_info, /**< extra_info */ + NULL, /**< prefs_info */ + + /* msim_actions */ + NULL +}; + + +GAIM_INIT_PLUGIN(myspace, init_plugin, info);