aboutsummaryrefslogtreecommitdiffstats
path: root/lib/base64.h
blob: 570f2b142e9a320ae44a5e3e392f2ab064473fe5 (plain)
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
/***************************************************************************\
*                                                                           *
*  BitlBee - An IRC to IM gateway                                           *
*  Base64 handling functions. encode_real() is mostly based on the y64 en-  *
*  coder from libyahoo2. Moving it to a new file because it's getting big.  *
*                                                                           *
*  Copyright 2006 Wilmer van der Gaast <wilmer@gaast.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.,  *
*  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.              *
*                                                                           *
\***************************************************************************/

#include <glib.h>
#include <gmodule.h>

G_MODULE_EXPORT char *tobase64( const char *text );
G_MODULE_EXPORT char *base64_encode( const char *in, int len );
G_MODULE_EXPORT int base64_encode_real( const unsigned char *in, int inlen, unsigned char *out, const char *b64digits );
G_MODULE_EXPORT char *frombase64( const char *in );
G_MODULE_EXPORT int base64_decode( const char *in, unsigned char **out );
G_MODULE_EXPORT int base64_decode_real( const unsigned char *in, unsigned char *out, char *b64reverse );
ver stores a message * in it and gives it to the sender. The sender will stall the receiver * till the buffer has been sent out. */ #define FT_BUFFER_SIZE 2048 typedef enum { FT_STATUS_LISTENING = 1, FT_STATUS_TRANSFERRING = 2, FT_STATUS_FINISHED = 4, FT_STATUS_CANCELED = 8, FT_STATUS_CONNECTING = 16 } file_status_t; /* * This structure holds all irc specific information regarding an incoming (from the point of view of * the irc client) file transfer. New instances of this struct should only be created by calling the * imcb_file_send_start() method, which will initialize most of the fields. The data field and the various * methods are zero-initialized. Instances will automatically be deleted once the transfer is completed, * canceled, or the connection to the irc client has been lost (note that also if only the irc connection * and not the file transfer connection is lost, the file transfer will still be canceled and freed). * * The following (poor ascii-art) diagram illustrates what methods are called for which status-changes: * * /-----------\ /----------\ * -------> | LISTENING | -----------------> | CANCELED | * \-----------/ [canceled,]free \----------/ * | * | accept * V * /------ /-------------\ /------------------------\ * out_of_data | | TRANSFERING | -----------------> | TRANSFERING | CANCELED | * \-----> \-------------/ [canceled,]free \------------------------/ * | * | finished,free * V * /------------------------\ * | TRANSFERING | FINISHED | * \------------------------/ */ typedef struct file_transfer { /* Are we sending something? */ int sending; /* * The current status of this file transfer. */ file_status_t status; /* * file size */ size_t file_size; /* * Number of bytes that have been successfully transferred. */ size_t bytes_transferred; /* * Time started. Used to calculate kb/s. */ time_t started; /* * file name */ char *file_name; /* * A unique local ID for this file transfer. */ unsigned int local_id; /* * IM-protocol specific data associated with this file transfer. */ gpointer data; struct im_connection *ic; /* * Private data. */ gpointer priv; /* * If set, called after succesful connection setup. */ void (*accept) ( struct file_transfer *file ); /* * If set, called when the transfer is canceled or finished. * Subsequently, this structure will be freed. * */ void (*free) ( struct file_transfer *file ); /* * If set, called when the transfer is finished and successful. */ void (*finished) ( struct file_transfer *file ); /* * If set, called when the transfer is canceled. * ( canceled either by the transfer implementation or by * a call to imcb_file_canceled ) */ void (*canceled) ( struct file_transfer *file, char *reason ); /* * called by the sending side to indicate that it is writable. * The callee should check if data is available and call the * function(as seen below) if that is the case. */ gboolean (*write_request) ( struct file_transfer *file ); /* * When sending files, protocols register this function to receive data. * This should only be called once after write_request is called. The caller * should not read more data until write_request is called again. This technique * avoids buffering. */ gboolean (*write) (struct file_transfer *file, char *buffer, unsigned int len ); /* The send buffer associated with this transfer. * Since receivers always wait for a write_request call one is enough. */ char buffer[FT_BUFFER_SIZE]; } file_transfer_t; /* * This starts a file transfer from bitlbee to the user. */ file_transfer_t *imcb_file_send_start( struct im_connection *ic, char *user_nick, char *file_name, size_t file_size ); /* * This should be called by a protocol when the transfer is canceled. Note that * the canceled() and free() callbacks given in file will be called by this function. */ void imcb_file_canceled( struct im_connection *ic, file_transfer_t *file, char *reason ); gboolean imcb_file_recv_start( struct im_connection *ic, file_transfer_t *ft ); void imcb_file_finished( struct im_connection *ic, file_transfer_t *file ); #endif