1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451
|
/*
* MXit Protocol libPurple Plugin
*
* -- file transfers (sending and receiving) --
*
* Pieter Loubser <libpurple@mxit.com>
*
* (C) Copyright 2009 MXit Lifestyle (Pty) Ltd.
* <http://www.mxitlifestyle.com>
*
* 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., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
*/
#include "internal.h"
#include "purple.h"
#include "protocol.h"
#include "mxit.h"
#include "chunk.h"
#include "filexfer.h"
#define MIME_TYPE_OCTETSTREAM "application/octet-stream"
/* supported file mime types */
static struct mime_type {
const char* magic;
const short magic_len;
const char* mime;
} const mime_types[] = {
/* magic length mime */
/* images */ { "\x89\x50\x4E\x47\x0D\x0A\x1A\x0A", 8, "image/png" }, /* image png */
{ "\xFF\xD8", 2, "image/jpeg" }, /* image jpeg */
{ "\x3C\x3F\x78\x6D\x6C", 5, "image/svg+xml" }, /* image SVGansi */
{ "\xEF\xBB\xBF", 3, "image/svg+xml" }, /* image SVGutf */
{ "\xEF\xBB\xBF", 3, "image/svg+xml" }, /* image SVGZ */
/* mxit */ { "\x4d\x58\x4d", 3, "application/mxit-msgs" }, /* mxit message */
{ "\x4d\x58\x44\x01", 4, "application/mxit-mood" }, /* mxit mood */
{ "\x4d\x58\x45\x01", 4, "application/mxit-emo" }, /* mxit emoticon */
{ "\x4d\x58\x46\x01", 4, "application/mxit-emof" }, /* mxit emoticon frame */
{ "\x4d\x58\x53\x01", 4, "application/mxit-skin" }, /* mxit skin */
/* audio */ { "\x4d\x54\x68\x64", 4, "audio/midi" }, /* audio midi */
{ "\x52\x49\x46\x46", 4, "audio/wav" }, /* audio wav */
{ "\xFF\xF1", 2, "audio/aac" }, /* audio aac1 */
{ "\xFF\xF9", 2, "audio/aac" }, /* audio aac2 */
{ "\xFF", 1, "audio/mp3" }, /* audio mp3 */
{ "\x23\x21\x41\x4D\x52\x0A", 6, "audio/amr" }, /* audio AMR */
{ "\x23\x21\x41\x4D\x52\x2D\x57\x42", 8, "audio/amr-wb" }, /* audio AMR WB */
{ "\x00\x00\x00", 3, "audio/mp4" }, /* audio mp4 */
{ "\x2E\x73\x6E\x64", 4, "audio/au" } /* audio AU */
};
/*------------------------------------------------------------------------
* Return the MIME type matching the data file.
*
* @param filename The name of file
* @param buf The data
* @param buflen The length of the data
* @return A MIME type string
*/
const char* file_mime_type( const char* filename, const char* buf, int buflen )
{
unsigned int i;
/* check for matching magic headers */
for ( i = 0; i < ARRAY_SIZE( mime_types ); i++ ) {
if ( buflen < mime_types[i].magic_len ) /* data is shorter than size of magic */
continue;
if ( memcmp( buf, mime_types[i].magic, mime_types[i].magic_len ) == 0 )
return mime_types[i].mime;
}
/* we did not find the MIME type, so return the default (application/octet-stream) */
return MIME_TYPE_OCTETSTREAM;
}
/*------------------------------------------------------------------------
* Cleanup and deallocate a MXit file transfer object
*
* @param xfer The file transfer object
*/
static void mxit_xfer_free( PurpleXfer* xfer )
{
struct mxitxfer* mx = (struct mxitxfer*) xfer->data;;
if ( mx ) {
g_free( mx );
xfer->data = NULL;
}
}
/*========================================================================================================================
* File Transfer callbacks
*/
/*------------------------------------------------------------------------
* Initialise a new file transfer.
*
* @param xfer The file transfer object
*/
static void mxit_xfer_init( PurpleXfer* xfer )
{
struct mxitxfer* mx = (struct mxitxfer*) xfer->data;
purple_debug_info( MXIT_PLUGIN_ID, "mxit_xfer_init\n" );
if ( purple_xfer_get_type( xfer ) == PURPLE_XFER_SEND ) {
/* we are trying to send a file to MXit */
if ( purple_xfer_get_size( xfer ) > CP_MAX_FILESIZE ) {
/* the file is too big */
purple_xfer_error( xfer->type, xfer->account, xfer->who, _( "The file you are trying to send is too large!" ) );
purple_xfer_cancel_local( xfer );
return;
}
/* start the file transfer */
purple_xfer_start( xfer, -1, NULL, 0 );
}
else {
/*
* we have just accepted a file transfer request from MXit. send a confirmation
* to the MXit server so that can send us the file
*/
mxit_send_file_accept( mx->session, mx->fileid, purple_xfer_get_size( xfer ), 0 );
}
}
/*------------------------------------------------------------------------
* Start the file transfer.
*
* @param xfer The file transfer object
*/
static void mxit_xfer_start( PurpleXfer* xfer )
{
unsigned char* buffer;
int size;
int wrote;
purple_debug_info( MXIT_PLUGIN_ID, "mxit_xfer_start\n" );
if ( purple_xfer_get_type( xfer ) == PURPLE_XFER_SEND ) {
/*
* the user wants to send a file to one of his contacts. we need to create
* a buffer and copy the file data into memory and then we can send it to
* the contact. we will send the whole file with one go.
*/
buffer = g_malloc( xfer->bytes_remaining );
size = fread( buffer, xfer->bytes_remaining, 1, xfer->dest_fp );
wrote = purple_xfer_write( xfer, buffer, xfer->bytes_remaining );
if ( wrote > 0 )
purple_xfer_set_bytes_sent( xfer, wrote );
/* free the buffer */
g_free( buffer );
buffer = NULL;
}
}
/*------------------------------------------------------------------------
* The file transfer has ended.
*
* @param xfer The file transfer object
*/
static void mxit_xfer_end( PurpleXfer* xfer )
{
purple_debug_info( MXIT_PLUGIN_ID, "mxit_xfer_end\n" );
/* deallocate object */
mxit_xfer_free( xfer );
}
/*------------------------------------------------------------------------
* The file transfer (to a user) has been cancelled.
*
* @param xfer The file transfer object
*/
static void mxit_xfer_cancel_send( PurpleXfer* xfer )
{
purple_debug_info( MXIT_PLUGIN_ID, "mxit_xfer_cancel_send\n" );
/* deallocate object */
mxit_xfer_free( xfer );
}
/*------------------------------------------------------------------------
* Send the file data.
*
* @param buffer The data to sent
* @param size The length of the data to send
* @param xfer The file transfer object
* @return The amount of data actually sent
*/
static gssize mxit_xfer_write( const guchar* buffer, size_t size, PurpleXfer* xfer )
{
struct mxitxfer* mx = (struct mxitxfer*) xfer->data;
purple_debug_info( MXIT_PLUGIN_ID, "mxit_xfer_write\n" );
if ( !mx ) {
purple_debug_warning( MXIT_PLUGIN_ID, "mxit_xfer_write: invalid internal mxit xfer data\n" );
return -1;
}
else if ( purple_xfer_get_type( xfer ) != PURPLE_XFER_SEND ) {
purple_debug_warning( MXIT_PLUGIN_ID, "mxit_xfer_write: wrong xfer type received\n" );
return -1;
}
/* create and send the packet to MXit */
mxit_send_file( mx->session, purple_xfer_get_remote_user( xfer ), purple_xfer_get_filename( xfer ), buffer, size );
/* the transfer is complete */
purple_xfer_set_completed( xfer, TRUE );
return size;
}
/*------------------------------------------------------------------------
* The user has rejected a file offer from MXit.
*
* @param xfer The file transfer object
*/
static void mxit_xfer_request_denied( PurpleXfer* xfer )
{
struct mxitxfer* mx = (struct mxitxfer*) xfer->data;
purple_debug_info( MXIT_PLUGIN_ID, "mxit_xfer_request_denied\n" );
/* send file reject packet to MXit server */
mxit_send_file_reject( mx->session, mx->fileid );
/* deallocate object */
mxit_xfer_free( xfer );
}
/*------------------------------------------------------------------------
* The file transfer (from MXit) has been cancelled.
*/
static void mxit_xfer_cancel_recv( PurpleXfer* xfer )
{
purple_debug_info( MXIT_PLUGIN_ID, "mxit_xfer_cancel_recv\n" );
/* deallocate object */
mxit_xfer_free( xfer );
}
/*========================================================================================================================
* Callbacks from libPurple
*/
/*------------------------------------------------------------------------
* Indicate if file transfers are supported to this contact.
* For MXit file transfers are always supported.
*
* @param gc The connection object
* @param who The username of the contact
* @return TRUE if file transfers are supported
*/
gboolean mxit_xfer_enabled( PurpleConnection* gc, const char* who )
{
return TRUE;
}
/*------------------------------------------------------------------------
* Create and initialize a new file transfer to a contact.
*
* @param gc The connection object
* @param who The username of the recipient
*/
PurpleXfer* mxit_xfer_new( PurpleConnection* gc, const char* who )
{
struct MXitSession* session = (struct MXitSession*) gc->proto_data;
PurpleXfer* xfer = NULL;
struct mxitxfer* mx = NULL;
/* (reference: "libpurple/ft.h") */
xfer = purple_xfer_new( session->acc, PURPLE_XFER_SEND, who );
/* create file info and attach it to the file transfer */
mx = g_new0( struct mxitxfer, 1 );
mx->session = session;
xfer->data = mx;
/* configure callbacks (reference: "libpurple/ft.h") */
purple_xfer_set_init_fnc( xfer, mxit_xfer_init );
purple_xfer_set_start_fnc( xfer, mxit_xfer_start );
purple_xfer_set_end_fnc( xfer, mxit_xfer_end );
purple_xfer_set_cancel_send_fnc( xfer, mxit_xfer_cancel_send );
purple_xfer_set_write_fnc( xfer, mxit_xfer_write );
return xfer;
}
/*------------------------------------------------------------------------
* The user has initiated a file transfer to a contact.
*
* @param gc The connection object
* @param who The username of the contact
* @param filename The filename (is NULL if request has not been accepted yet)
*/
void mxit_xfer_tx( PurpleConnection* gc, const char* who, const char* filename )
{
PurpleXfer *xfer = mxit_xfer_new( gc, who );
if ( filename )
purple_xfer_request_accepted( xfer, filename );
else
purple_xfer_request( xfer );
}
/*========================================================================================================================
* Calls from the MXit Protocol layer
*/
/*------------------------------------------------------------------------
* A file transfer offer has been received from the MXit server.
*
* @param session The MXit session object
* @param usermame The username of the sender
* @param filename The name of the file being offered
* @param filesize The size of the file being offered
* @param fileid A unique ID that identifies this file
*/
void mxit_xfer_rx_offer( struct MXitSession* session, const char* username, const char* filename, int filesize, const char* fileid )
{
PurpleXfer* xfer = NULL;
struct mxitxfer* mx = NULL;
purple_debug_info( MXIT_PLUGIN_ID, "File Offer: file=%s, from=%s, size=%i\n", filename, username, filesize );
xfer = purple_xfer_new( session->acc, PURPLE_XFER_RECEIVE, username );
if ( xfer ) {
/* create a new mxit xfer struct for internal use */
mx = g_new0( struct mxitxfer, 1 );
mx->session = session;
memcpy( mx->fileid, fileid, MXIT_CHUNK_FILEID_LEN );
xfer->data = mx;
purple_xfer_set_filename( xfer, filename );
if( filesize > 0 )
purple_xfer_set_size( xfer, filesize );
/* register file transfer callback functions */
purple_xfer_set_init_fnc( xfer, mxit_xfer_init );
purple_xfer_set_request_denied_fnc( xfer, mxit_xfer_request_denied );
purple_xfer_set_cancel_recv_fnc( xfer, mxit_xfer_cancel_recv );
purple_xfer_set_end_fnc( xfer, mxit_xfer_end );
/* give the request to the user to accept/deny */
purple_xfer_request( xfer );
}
}
/*------------------------------------------------------------------------
* Return the libPurple file-transfer object associated with a MXit transfer
*
* @param session The MXit session object
* @param fileid A unique ID that identifies this file
*/
static PurpleXfer* find_mxit_xfer( struct MXitSession* session, const char* fileid )
{
GList* item = NULL;
PurpleXfer* xfer = NULL;
item = purple_xfers_get_all(); /* list of all active transfers */
while ( item ) {
xfer = item->data;
if ( xfer->account == session->acc ) {
/* transfer is associated with this MXit account */
struct mxitxfer* mx = xfer->data;
/* does the fileid match? */
if ( ( mx ) && ( memcmp( mx->fileid, fileid, MXIT_CHUNK_FILEID_LEN ) == 0 ) )
break;
}
item = g_list_next( item );
}
if ( item )
return item->data;
else
return NULL;
}
/*------------------------------------------------------------------------
* A file has been received from the MXit server.
*
* @param session The MXit session object
* @param fileid A unique ID that identifies this file
* @param data The file data
* @param datalen The size of the data
*/
void mxit_xfer_rx_file( struct MXitSession* session, const char* fileid, const char* data, int datalen )
{
PurpleXfer* xfer = NULL;
struct mxitxfer* mx = NULL;
purple_debug_info( MXIT_PLUGIN_ID, "mxit_xfer_rx_file: (size=%i)\n", datalen );
/* find the file-transfer object */
xfer = find_mxit_xfer( session, fileid );
if ( xfer ) {
mx = xfer->data;
/* this is the transfer we have been looking for */
purple_xfer_ref( xfer );
purple_xfer_start( xfer, -1, NULL, 0 );
fwrite( data, datalen, 1, xfer->dest_fp );
purple_xfer_unref( xfer );
purple_xfer_set_completed( xfer, TRUE );
purple_xfer_end( xfer );
/* inform MXit that file was successfully received */
mxit_send_file_received( session, fileid, RECV_STATUS_SUCCESS );
}
else {
/* file transfer not found */
mxit_send_file_received( session, fileid, RECV_STATUS_BAD_ID );
}
}
|