sslconn.h

Go to the documentation of this file.

 
/* purple
 *
 * Purple is the legal property of its developers, whose names are too numerous
 * to list here.  Please refer to the COPYRIGHT file distributed with this
 * source distribution.
 *
 * 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
 */
#ifndef _PURPLE_SSLCONN_H_
#define _PURPLE_SSLCONN_H_
 
typedef enum
{
    PURPLE_SSL_HANDSHAKE_FAILED = 1,
    PURPLE_SSL_CONNECT_FAILED = 2,
    PURPLE_SSL_CERTIFICATE_INVALID = 3
} PurpleSslErrorType;
 
#include "certificate.h"
#include "proxy.h"
 
#define PURPLE_SSL_DEFAULT_PORT 443
 
typedef struct _PurpleSslConnection PurpleSslConnection;
 
typedef void (*PurpleSslInputFunction)(gpointer, PurpleSslConnection *,
                                     PurpleInputCondition);
typedef void (*PurpleSslErrorFunction)(PurpleSslConnection *, PurpleSslErrorType,
                                     gpointer);
 
struct _PurpleSslConnection
{
    char *host;
    int port;
    void *connect_cb_data;
    PurpleSslInputFunction connect_cb;
    PurpleSslErrorFunction error_cb;
    void *recv_cb_data;
    PurpleSslInputFunction recv_cb;
 
    int fd;
    guint inpa;
    PurpleProxyConnectData *connect_data;
 
    void *private_data;
 
    PurpleCertificateVerifier *verifier;
};
 
typedef struct
{
    gboolean (*init)(void);
    void (*uninit)(void);
    void (*connectfunc)(PurpleSslConnection *gsc);
    void (*close)(PurpleSslConnection *gsc);
    size_t (*read)(PurpleSslConnection *gsc, void *data, size_t len);
    size_t (*write)(PurpleSslConnection *gsc, const void *data, size_t len);
    GList * (* get_peer_certificates)(PurpleSslConnection * gsc);
 
    void (*_purple_reserved2)(void);
    void (*_purple_reserved3)(void);
    void (*_purple_reserved4)(void);
} PurpleSslOps;
 
#ifdef __cplusplus
extern "C" {
#endif
 
/**************************************************************************/
/**************************************************************************/
gboolean purple_ssl_is_supported(void);
 
const gchar * purple_ssl_strerror(PurpleSslErrorType error);
 
PurpleSslConnection *purple_ssl_connect(PurpleAccount *account, const char *host,
                                    int port, PurpleSslInputFunction func,
                                    PurpleSslErrorFunction error_func,
                                    void *data);
 
PurpleSslConnection *purple_ssl_connect_with_ssl_cn(PurpleAccount *account, const char *host,
                                    int port, PurpleSslInputFunction func,
                                    PurpleSslErrorFunction error_func,
                                    const char *ssl_host,
                                    void *data);
 
#if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_SSLCONN_C_)
PurpleSslConnection *purple_ssl_connect_fd(PurpleAccount *account, int fd,
                                       PurpleSslInputFunction func,
                                       PurpleSslErrorFunction error_func,
                                       void *data);
#endif
 
PurpleSslConnection *purple_ssl_connect_with_host_fd(PurpleAccount *account, int fd,
                                           PurpleSslInputFunction func,
                                           PurpleSslErrorFunction error_func,
                                           const char *host,
                                           void *data);
 
void purple_ssl_input_add(PurpleSslConnection *gsc, PurpleSslInputFunction func,
                        void *data);
 
void purple_ssl_close(PurpleSslConnection *gsc);
 
size_t purple_ssl_read(PurpleSslConnection *gsc, void *buffer, size_t len);
 
size_t purple_ssl_write(PurpleSslConnection *gsc, const void *buffer, size_t len);
 
GList * purple_ssl_get_peer_certificates(PurpleSslConnection *gsc);
 
/**************************************************************************/
/**************************************************************************/
void purple_ssl_set_ops(PurpleSslOps *ops);
 
PurpleSslOps *purple_ssl_get_ops(void);
 
void purple_ssl_init(void);
 
void purple_ssl_uninit(void);
 
#ifdef __cplusplus
}
#endif
 
#endif /* _PURPLE_SSLCONN_H_ */