/* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* Copyright (C) 2003-2008 Imendio AB
* Copyright (C) 2006 Nokia Corporation. All rights reserved.
* Copyright (C) 2007 Collabora Ltd.
*
* This program 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 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this program; if not, see <https://www.gnu.org/licenses>
*/
/**
* SECTION:lm-connection
* @Title: LmConnection
* @Short_description: A client connection to the server
*
* An example of how to use Loudmouth with the synchronous API.
* <informalexample><programlisting>
* int
* main (int argc, char **argv)
* {
* LmConnection *connection;
* GError *error = NULL;
* gint i;
* LmMessage *m;
*
* connection = lm_connection_new ("myserver");
*
* if (!lm_connection_open_and_block (connection, &error)) {
* g_error ("Failed to open: %s\n", error->message);
* }
*
* if (!lm_connection_authenticate_and_block (connection,
* "username", "password",
* "resource",
* &error)) {
* g_error ("Failed to authenticate: %s\n", error->message);
* }
*
* m = lm_message_new ("recipient", LM_MESSAGE_TYPE_MESSAGE);
* lm_message_node_add_child (m->node, "body", "message");
*
* if (!lm_connection_send (connection, m, &error)) {
* g_error ("Send failed: %s\n", error->message);
* }
*
* lm_message_unref (m);
*
* lm_connection_close (connection, NULL);
* lm_connection_unref (connection);
*
* return 0;
* }
* </programlisting></informalexample>
*/
#include <config.h>
#include <string.h>
#include <sys/stat.h>
#include <sys/types.h>
#include <fcntl.h>
/* Needed on Mac OS X */
#if HAVE_NETINET_IN_H
#include <netinet/in.h>
#endif
#include <arpa/nameser.h>
#include <resolv.h>
#include <glib-object.h>
#include "lm-data-objects.h"
#include "lm-sock.h"
#include "lm-debug.h"
#include "lm-error.h"
#include "lm-feature-ping.h"
#include "lm-internals.h"
#include "lm-message-queue.h"
#include "lm-misc.h"
#include "lm-ssl-internals.h"
#include "lm-parser.h"
#include "lm-sha.h"
#include "lm-connection.h"
#include "lm-utils.h"
#include "lm-old-socket.h"
#include "lm-sasl.h"
typedef struct {
LmHandlerPriority priority;
LmMessageHandler *handler;
} HandlerData;
struct _LmConnection {
/* Parameters */
GMainContext *context;
/* TODO: Clean up this and make some parameter object for server, jid, effective jid etc */
gchar *server;
gchar *jid;
gchar *effective_jid;
guint port;
LmOldSocket *socket;
LmSSL *ssl;
LmProxy *proxy;
LmParser *parser;
gchar *stream_id;
GHashTable *id_handlers;
GSList *handlers[LM_MESSAGE_TYPE_UNKNOWN];
/* XMPP1.0 stuff (SASL, resource binding, StartTLS) */
gboolean use_sasl;
LmSASL *sasl;
gchar *resource;
LmMessageHandler *features_cb;
LmMessageHandler *starttls_cb;
gboolean tls_started;
/* Communication */
guint open_id;
LmCallback *open_cb;
gboolean cancel_open;
LmCallback *auth_cb;
LmCallback *disconnect_cb;
LmMessageQueue *queue;
LmConnectionState state;
/* TODO: Move the rate to use the one in LmFeaturePing instead of keeping the two in sync */
guint keep_alive_rate;
LmFeaturePing *feature_ping;
gint ref_count;
};
typedef enum {
AUTH_TYPE_PLAIN = 1,
AUTH_TYPE_DIGEST = 2,
AUTH_TYPE_0K = 4
} AuthType;
#define XMPP_NS_BIND "urn:ietf:params:xml:ns:xmpp-bind"
#define XMPP_NS_SESSION "urn:ietf:params:xml:ns:xmpp-session"
#define XMPP_NS_STARTTLS "urn:ietf:params:xml:ns:xmpp-tls"
static void connection_free (LmConnection *connection);
static void connection_handle_message (LmConnection *connection,
LmMessage *message);
static void connection_new_message_cb (LmParser *parser,
LmMessage *message,
LmConnection *connection);
static gboolean connection_do_open (LmConnection *connection,
GError **error);
void connection_do_close (LmConnection *connection);
static LmMessage *
connection_create_auth_req_msg (LmAuthParameters *auth_params);
static LmMessage *
connection_create_auth_msg (LmConnection *connection,
LmAuthParameters *auth_params,
gint auth_type);
static LmHandlerResult
connection_auth_req_reply (LmMessageHandler *handler,
LmConnection *connection,
LmMessage *m,
gpointer user_data);
static int connection_check_auth_type (LmMessage *auth_req_rpl);
static LmHandlerResult
connection_auth_reply (LmMessageHandler *handler,
LmConnection *connection,
LmMessage *m,
gpointer user_data);
static void connection_stream_received (LmConnection *connection,
LmMessage *m);
static void connection_stream_error (LmConnection *connection,
LmMessage *m);
static gint
connection_handler_compare_func (HandlerData *a,
HandlerData *b);
static void connection_start_keep_alive (LmConnection *connection);
static void connection_stop_keep_alive (LmConnection *connection);
static gboolean connection_send (LmConnection *connection,
const gchar *str,
gint len,
GError **error);
static void connection_message_queue_cb (LmMessageQueue *queue,
LmConnection *connection);
static void
connection_signal_disconnect (LmConnection *connection,
LmDisconnectReason reason);
static void connection_incoming_data (LmOldSocket *socket,
const gchar *buf,
LmConnection *connection);
static void connection_socket_closed_cb (LmOldSocket *socket,
LmDisconnectReason reason,
LmConnection *connection);
static void
connection_socket_connect_cb (LmOldSocket *socket,
gboolean result,
LmConnection *connection);
static gboolean
connection_get_server_from_jid (const gchar *jid,
gchar **server);
static void
connection_send_stream_header (LmConnection *connection);
static LmHandlerResult
connection_features_cb (LmMessageHandler *handler,
LmConnection *connection,
LmMessage *message,
gpointer user_data);
static gboolean connection_old_auth (LmConnection *connection,
LmAuthParameters *auth_params,
GError **errror);
static void
connection_free_handlers (LmConnection *connection)
{
int i;
/* Unref handlers */
for (i = 0; i < LM_MESSAGE_TYPE_UNKNOWN; ++i) {
GSList *l;
for (l = connection->handlers[i]; l; l = l->next) {
HandlerData *hd = (HandlerData *) l->data;
lm_message_handler_unref (hd->handler);
g_free (hd);
}
g_slist_free (connection->handlers[i]);
}
}
static void
connection_free (LmConnection *connection)
{
/* This needs to be run before starting to free internal states.
* It used to be run after the handlers where freed which lead to a crash
* when the connection was freed prior to running lm_connection_close.
*/
if (connection->state >= LM_CONNECTION_STATE_OPENING) {
connection_do_close (connection);
}
g_free (connection->server);
g_free (connection->jid);
g_free (connection->effective_jid);
g_free (connection->stream_id);
g_free (connection->resource);
if (connection->sasl) {
lm_sasl_free (connection->sasl);
}
if (connection->parser) {
lm_parser_free (connection->parser);
}
connection_free_handlers (connection);
g_hash_table_destroy (connection->id_handlers);
if (connection->open_cb) {
_lm_utils_free_callback (connection->open_cb);
}
if (connection->auth_cb) {
_lm_utils_free_callback (connection->auth_cb);
}
lm_connection_set_disconnect_function (connection, NULL, NULL, NULL);
if (connection->proxy) {
lm_proxy_unref (connection->proxy);
}
lm_message_queue_unref (connection->queue);
if (connection->context) {
g_main_context_unref (connection->context);
}
if (connection->socket) {
lm_old_socket_unref (connection->socket);
}
g_slice_free (LmConnection, connection);
}
static LmHandlerResult
connection_run_message_handler (LmConnection *connection, LmMessage *m)
{
LmMessageHandler *handler;
const gchar *id;
LmHandlerResult result = LM_HANDLER_RESULT_ALLOW_MORE_HANDLERS;
id = lm_message_node_get_attribute (m->node, "id");
if (!id) {
return LM_HANDLER_RESULT_ALLOW_MORE_HANDLERS;
}
handler = g_hash_table_lookup (connection->id_handlers, id);
if (handler) {
result = _lm_message_handler_handle_message (handler,
connection,
m);
g_hash_table_remove (connection->id_handlers,
id);
}
return result;
}
static void
connection_handle_message (LmConnection *connection, LmMessage *m)
{
GSList *l;
LmHandlerResult result = LM_HANDLER_RESULT_ALLOW_MORE_HANDLERS;
lm_connection_ref (connection);
if (lm_message_get_type (m) == LM_MESSAGE_TYPE_STREAM) {
connection_stream_received (connection, m);
goto out;
}
if ((lm_message_get_type (m) != LM_MESSAGE_TYPE_IQ) ||
(lm_message_get_sub_type (m) == LM_MESSAGE_SUB_TYPE_ERROR) ||
(lm_message_get_sub_type (m) == LM_MESSAGE_SUB_TYPE_RESULT)) {
result = connection_run_message_handler (connection, m);
if (result == LM_HANDLER_RESULT_REMOVE_MESSAGE) {
goto out;
}
}
for (l = connection->handlers[lm_message_get_type (m)];
l && result == LM_HANDLER_RESULT_ALLOW_MORE_HANDLERS;
l = l->next) {
HandlerData *hd = (HandlerData *) l->data;
result = _lm_message_handler_handle_message (hd->handler,
connection,
m);
}
if (lm_message_get_type (m) == LM_MESSAGE_TYPE_STREAM_ERROR) {
connection_stream_error (connection, m);
goto out;
}
out:
lm_connection_unref (connection);
return;
}
static void
connection_new_message_cb (LmParser *parser,
LmMessage *m,
LmConnection *connection)
{
const gchar *from;
lm_message_ref (m);
from = lm_message_node_get_attribute (m->node, "from");
if (!from) {
from = "unknown";
}
lm_verbose ("New message with type=\"%s\" from: %s\n",
_lm_message_type_to_string (lm_message_get_type (m)),
from);
lm_message_queue_push_tail (connection->queue, m);
}
static void
connection_ping_timed_out (LmFeaturePing *fp, LmConnection *connection)
{
connection_do_close (connection);
connection_signal_disconnect (connection,
LM_DISCONNECT_REASON_PING_TIME_OUT);
}
static void
connection_start_keep_alive (LmConnection *connection)
{
if (connection->feature_ping) {
connection_stop_keep_alive (connection);
}
connection->feature_ping = g_object_new (LM_TYPE_FEATURE_PING,
"connection", connection,
"rate", connection->keep_alive_rate,
NULL);
g_signal_connect (connection->feature_ping, "timed-out",
G_CALLBACK (connection_ping_timed_out),
connection);
lm_feature_ping_start (connection->feature_ping);
}
static void
connection_stop_keep_alive (LmConnection *connection)
{
if (connection->feature_ping) {
lm_feature_ping_stop (connection->feature_ping);
g_signal_handlers_disconnect_by_func (connection->feature_ping,
G_CALLBACK (connection_ping_timed_out),
connection);
g_object_unref (connection->feature_ping);
}
connection->feature_ping = NULL;
}
static void
connection_log_send (LmConnection *connection,
const gchar *str,
gint len)
{
g_log (LM_LOG_DOMAIN, LM_LOG_LEVEL_NET, "\nSEND:\n");
g_log (LM_LOG_DOMAIN, LM_LOG_LEVEL_NET,
"-----------------------------------\n");
g_log (LM_LOG_DOMAIN, LM_LOG_LEVEL_NET, "%s\n", str);
g_log (LM_LOG_DOMAIN, LM_LOG_LEVEL_NET,
"-----------------------------------\n");
}
static gboolean
connection_send (LmConnection *connection,
const gchar *str,
gint len,
GError **error)
{
gint b_written;
if (connection->state < LM_CONNECTION_STATE_OPENING) {
g_log (LM_LOG_DOMAIN,LM_LOG_LEVEL_NET,
"Connection is not open.\n");
g_set_error (error,
LM_ERROR,
LM_ERROR_CONNECTION_NOT_OPEN,
"Connection is not open, call lm_connection_open() first");
return FALSE;
}
if (len == -1) {
len = strlen (str);
}
connection_log_send (connection, str, len);
/* Check to see if there already is an output buffer, if so, add to the
buffer and return */
b_written = lm_old_socket_write (connection->socket, str, len);
if (b_written < 0) {
g_set_error (error,
LM_ERROR,
LM_ERROR_CONNECTION_FAILED,
"Server closed the connection");
return FALSE;
}
return TRUE;
}
static void
connection_message_queue_cb (LmMessageQueue *queue, LmConnection *connection)
{
LmMessage *m;
m = lm_message_queue_pop_nth (connection->queue, 0);
if (m) {
connection_handle_message (connection, m);
lm_message_unref (m);
}
}
/* Returns directly */
/* Setups all data needed to start the connection attempts */
static gboolean
connection_do_open (LmConnection *connection, GError **error)
{
gchar *domain = NULL;
if (lm_connection_is_open (connection)) {
g_set_error (error,
LM_ERROR,
LM_ERROR_CONNECTION_NOT_OPEN,
"Connection is already open, call lm_connection_close() first");
return FALSE;
}
domain = _lm_connection_get_server (connection);
lm_verbose ("Connecting to: %s:%d\n", connection->server, connection->port);
connection->socket = lm_old_socket_create (connection->context,
(IncomingDataFunc) connection_incoming_data,
(SocketClosedFunc) connection_socket_closed_cb,
(ConnectResultFunc) connection_socket_connect_cb,
connection,
connection,
connection->server,
domain,
connection->port,
connection->ssl,
connection->proxy,
error);
g_free (domain);
if (!connection->socket) {
return FALSE;
}
lm_message_queue_attach (connection->queue, connection->context);
connection->state = LM_CONNECTION_STATE_OPENING;
return TRUE;
}
void
connection_do_close (LmConnection *connection)
{
connection_stop_keep_alive (connection);
if (connection->socket) {
lm_old_socket_close (connection->socket);
}
lm_message_queue_detach (connection->queue);
if (!lm_connection_is_open (connection)) {
/* lm_connection_is_open is FALSE for state OPENING as well */
connection->state = LM_CONNECTION_STATE_CLOSED;
return;
}
connection->state = LM_CONNECTION_STATE_CLOSED;
if (connection->sasl) {
lm_sasl_free (connection->sasl);
connection->sasl = NULL;
}
}
static LmMessage *
connection_create_auth_req_msg (LmAuthParameters *auth_params)
{
LmMessage *m;
LmMessageNode *q_node;
m = lm_message_new_with_sub_type (NULL, LM_MESSAGE_TYPE_IQ,
LM_MESSAGE_SUB_TYPE_GET);
q_node = lm_message_node_add_child (m->node, "query", NULL);
lm_message_node_set_attributes (q_node,
"xmlns", "jabber:iq:auth",
NULL);
lm_message_node_add_child (q_node, "username", lm_auth_parameters_get_username (auth_params));
return m;
}
static LmMessage *
connection_create_auth_msg (LmConnection *connection,
LmAuthParameters *auth_params,
gint auth_type)
{
LmMessage *auth_msg;
LmMessageNode *q_node;
auth_msg = lm_message_new_with_sub_type (NULL, LM_MESSAGE_TYPE_IQ,
LM_MESSAGE_SUB_TYPE_SET);
q_node = lm_message_node_add_child (auth_msg->node, "query", NULL);
lm_message_node_set_attributes (q_node,
"xmlns", "jabber:iq:auth",
NULL);
lm_message_node_add_child (q_node, "username", lm_auth_parameters_get_username (auth_params));
if (auth_type & AUTH_TYPE_0K) {
lm_verbose ("Using 0k auth (not implemented yet)\n");
/* TODO: Should probably use this? */
}
if (auth_type & AUTH_TYPE_DIGEST) {
gchar *str;
gchar *digest;
lm_verbose ("Using digest\n");
str = g_strconcat (connection->stream_id, lm_auth_parameters_get_password (auth_params), NULL);
digest = lm_sha_hash (str);
g_free (str);
lm_message_node_add_child (q_node, "digest", digest);
g_free (digest);
}
else if (auth_type & AUTH_TYPE_PLAIN) {
lm_verbose ("Using plaintext auth\n");
lm_message_node_add_child (q_node, "password", lm_auth_parameters_get_password (auth_params));
} else {
/* TODO: Report error somehow */
}
lm_message_node_add_child (q_node, "resource", lm_auth_parameters_get_resource (auth_params));
return auth_msg;
}
static LmHandlerResult
connection_auth_req_reply (LmMessageHandler *handler,
LmConnection *connection,
LmMessage *m,
gpointer user_data)
{
int auth_type;
LmMessage *auth_msg;
LmMessageHandler *auth_handler;
LmAuthParameters *auth_params = (LmAuthParameters *) user_data;
auth_type = connection_check_auth_type (m);
auth_msg = connection_create_auth_msg (connection, auth_params, auth_type);
auth_handler = lm_message_handler_new (connection_auth_reply,
NULL, NULL);
lm_connection_send_with_reply (connection, auth_msg,
auth_handler, NULL);
lm_message_handler_unref (auth_handler);
lm_message_unref (auth_msg);
return LM_HANDLER_RESULT_REMOVE_MESSAGE;
}
static int
connection_check_auth_type (LmMessage *auth_req_rpl)
{
LmMessageNode *q_node;
gint ret_val = 0;
q_node = lm_message_node_get_child (auth_req_rpl->node, "query");
if (!q_node) {
return AUTH_TYPE_PLAIN;
}
if (lm_message_node_get_child (q_node, "password")) {
ret_val |= AUTH_TYPE_PLAIN;
}
if (lm_message_node_get_child (q_node, "digest")) {
ret_val |= AUTH_TYPE_DIGEST;
}
if (lm_message_node_get_child (q_node, "sequence") &&
lm_message_node_get_child (q_node, "token")) {
ret_val |= AUTH_TYPE_0K;
}
return ret_val;
}
static void
connection_call_auth_cb (LmConnection *connection, gboolean success)
{
if (success) {
connection->state = LM_CONNECTION_STATE_AUTHENTICATED;
} else {
connection->state = LM_CONNECTION_STATE_OPEN;
}
if (connection->auth_cb) {
LmCallback *cb = connection->auth_cb;
connection->auth_cb = NULL;
if (cb->func) {
(* ((LmResultFunction) cb->func)) (connection,
success,
cb->user_data);
}
_lm_utils_free_callback (cb);
}
}
static LmHandlerResult
connection_auth_reply (LmMessageHandler *handler,
LmConnection *connection,
LmMessage *m,
gpointer user_data)
{
LmMessageSubType type;
g_return_val_if_fail (connection != NULL,
LM_HANDLER_RESULT_ALLOW_MORE_HANDLERS);
type = lm_message_get_sub_type (m);
connection_call_auth_cb (connection, type == LM_MESSAGE_SUB_TYPE_RESULT);
return LM_HANDLER_RESULT_REMOVE_MESSAGE;
}
static LmHandlerResult
_lm_connection_starttls_cb (LmMessageHandler *handler,
LmConnection *connection,
LmMessage *message,
gpointer user_data)
{
if (lm_old_socket_starttls (connection->socket)) {
connection->tls_started = TRUE;
connection_send_stream_header (connection);
} else {
connection_do_close (connection);
connection_signal_disconnect (connection,
LM_DISCONNECT_REASON_ERROR);
}
return LM_HANDLER_RESULT_REMOVE_MESSAGE;
}
static void
connection_possibly_register_starttls_handler (LmConnection *connection)
{
/* if we'd like to use tls and we didn't already start
* it, prepare for it now */
if (connection->ssl &&
lm_old_socket_get_use_starttls (connection->socket) &&
!connection->starttls_cb) {
connection->starttls_cb =
lm_message_handler_new (_lm_connection_starttls_cb,
NULL, NULL);
lm_connection_register_message_handler (connection,
connection->starttls_cb,
LM_MESSAGE_TYPE_PROCEED,
LM_HANDLER_PRIORITY_FIRST);
}
}
static void
connection_stream_received (LmConnection *connection, LmMessage *m)
{
gboolean result;
const char *xmpp_version;
g_return_if_fail (connection != NULL);
g_return_if_fail (m != NULL);
connection->stream_id = g_strdup (lm_message_node_get_attribute (m->node,
"id"));
xmpp_version = lm_message_node_get_attribute (m->node, "version");
if (xmpp_version && strcmp (xmpp_version, "1.0") == 0) {
lm_verbose ("XMPP 1.0 stream received: %s\n",
connection->stream_id);
connection->use_sasl = TRUE;
/* stream is started multiple times, but we only want
* one sasl mechanism */
if (!connection->sasl) {
connection->sasl = lm_sasl_new (connection);
}
connection_possibly_register_starttls_handler (connection);
} else {
lm_verbose ("Old Jabber stream received: %s\n",
connection->stream_id);
}
if (connection->state < LM_CONNECTION_STATE_OPEN) {
connection->state = LM_CONNECTION_STATE_OPEN;
}
/* Check to see if the stream is correctly set up */
result = TRUE;
connection_start_keep_alive (connection);
if (connection->open_cb) {
LmCallback *cb = connection->open_cb;
connection->open_cb = NULL;
if (cb->func) {
(* ((LmResultFunction) cb->func)) (connection, result,
cb->user_data);
}
_lm_utils_free_callback (cb);
}
}
static void
connection_stream_error (LmConnection *connection, LmMessage *m)
{
LmMessageNode *node;
LmMessageNode *reason_node;
LmDisconnectReason reason;
g_return_if_fail (connection != NULL);
g_return_if_fail (m != NULL);
node = m->node;
/* Resource conflict */
reason_node = lm_message_node_get_child (node, "conflict");
if (reason_node) {
lm_verbose ("Stream error: Conflict (resource connected elsewhere)\n");
reason = LM_DISCONNECT_REASON_RESOURCE_CONFLICT;
return;
}
/* XML is crack */
reason_node = lm_message_node_get_child (node, "xml-not-well-formed");
if (reason_node) {
lm_verbose ("Stream error: XML not well formed\n");
reason = LM_DISCONNECT_REASON_INVALID_XML;
return;
}
lm_verbose ("Stream error: Unrecognised error\n");
reason = LM_DISCONNECT_REASON_ERROR;
connection->stream_id = g_strdup (lm_message_node_get_attribute (m->node,
"id"));
connection_do_close (connection);
connection_signal_disconnect (connection, reason);
}
static gint
connection_handler_compare_func (HandlerData *a, HandlerData *b)
{
return b->priority - a->priority;
}
static void
connection_signal_disconnect (LmConnection *connection,
LmDisconnectReason reason)
{
if (connection->disconnect_cb && connection->disconnect_cb->func) {
LmCallback *cb = connection->disconnect_cb;
lm_connection_ref (connection);
(* ((LmDisconnectFunction) cb->func)) (connection,
reason,
cb->user_data);
lm_connection_unref (connection);
}
}
static void
connection_incoming_data (LmOldSocket *socket,
const gchar *buf,
LmConnection *connection)
{
lm_parser_parse (connection->parser, buf);
}
static void
connection_socket_closed_cb (LmOldSocket *socket,
LmDisconnectReason reason,
LmConnection *connection)
{
connection_do_close (connection);
connection_signal_disconnect (connection, reason);
}
static void
connection_socket_connect_cb (LmOldSocket *socket,
gboolean result,
LmConnection *connection)
{
/* FIXME: Set up according to XMPP 1.0 specification */
/* StartTLS and the like */
if (result == TRUE && !connection_send (connection,
"<?xml version='1.0' encoding='UTF-8'?>", -1,
NULL)) {
lm_verbose ("Failed to send xml version and encoding\n");
result = FALSE;
}
if (result == FALSE) {
connection_do_close (connection);
if (connection->open_cb) {
LmCallback *cb = connection->open_cb;
connection->open_cb = NULL;
(* ((LmResultFunction) cb->func)) (connection, FALSE,
cb->user_data);
_lm_utils_free_callback (cb);
}
} else {
connection_send_stream_header (connection);
}
}
static gboolean
connection_get_server_from_jid (const gchar *jid, gchar **server)
{
gchar *ch;
gchar *ch_end;
if (jid != NULL && (ch = strchr (jid, '@')) != NULL) {
ch_end = strchr(ch + 1, '/');
if (ch_end != NULL) {
*server = g_strndup (ch + 1, ch_end - ch - 1);
} else {
*server = g_strdup (ch + 1);
}
return TRUE;
}
return FALSE;
}
static void
connection_send_stream_header (LmConnection *connection)
{
LmMessage *m;
gchar *server_from_jid;
lm_verbose ("Sending stream header\n");
server_from_jid = _lm_connection_get_server (connection);
m = lm_message_new (server_from_jid, LM_MESSAGE_TYPE_STREAM);
lm_message_node_set_attributes (m->node,
"xmlns:stream",
"http://etherx.jabber.org/streams",
"xmlns", "jabber:client",
"version", "1.0",
NULL);
g_free (server_from_jid);
if (!lm_connection_send (connection, m, NULL)) {
lm_verbose ("Failed to send stream information\n");
connection_do_close (connection);
connection_signal_disconnect (connection, LM_DISCONNECT_REASON_ERROR);
}
lm_message_unref (m);
}
GMainContext *
_lm_connection_get_context (LmConnection *conn)
{
g_return_val_if_fail (conn != NULL, NULL);
return conn->context;
}
gchar *
_lm_connection_get_server (LmConnection *conn)
{
gchar *server;
g_return_val_if_fail (conn != NULL, NULL);
if (!connection_get_server_from_jid (conn->jid, &server)) {
server = g_strdup (conn->server);
}
return server;
}
static LmHandlerResult
connection_bind_reply (LmMessageHandler *handler,
LmConnection *connection,
LmMessage *message,
gpointer user_data)
{
LmMessage *m;
LmMessageNode *session_node;
LmMessageNode *jid_node;
int result;
LmMessageSubType type;
type = lm_message_get_sub_type (message);
if (type == LM_MESSAGE_SUB_TYPE_ERROR) {
g_log (LM_LOG_DOMAIN, LM_LOG_LEVEL_SASL,
"%s: error while binding to resource\n", G_STRFUNC);
connection_call_auth_cb (connection, FALSE);
return LM_HANDLER_RESULT_REMOVE_MESSAGE;
}
/* use whatever server returns as our effective jid */
jid_node = lm_message_node_find_child (message->node, "jid");
if (jid_node) {
g_free (connection->effective_jid);
connection->effective_jid = g_strdup
(lm_message_node_get_value (jid_node));
}
m = lm_message_new_with_sub_type (NULL,
LM_MESSAGE_TYPE_IQ,
LM_MESSAGE_SUB_TYPE_SET);
session_node = lm_message_node_add_child (m->node, "session", NULL);
lm_message_node_set_attributes (session_node,
"xmlns", XMPP_NS_SESSION,
NULL);
result = lm_connection_send (connection, m, NULL);
lm_message_unref (m);
if (result < 0) {
connection_do_close (connection);
connection_signal_disconnect (connection, LM_DISCONNECT_REASON_ERROR);
} else {
/* We may finally tell the client they're authorized */
connection_call_auth_cb (connection, TRUE);
}
return LM_HANDLER_RESULT_REMOVE_MESSAGE;
}
static LmHandlerResult
connection_features_cb (LmMessageHandler *handler,
LmConnection *connection,
LmMessage *message,
gpointer user_data)
{
LmMessageNode *bind_node;
LmMessageNode *starttls_node;
LmMessageNode *old_auth;
LmMessageNode *sasl_mechanisms;
starttls_node = lm_message_node_find_child (message->node, "starttls");
if (connection->ssl && lm_old_socket_get_use_starttls (connection->socket)) {
if (starttls_node) {
LmMessage *msg;
msg = lm_message_new (NULL, LM_MESSAGE_TYPE_STARTTLS);
lm_message_node_set_attributes (
msg->node,
"xmlns", XMPP_NS_STARTTLS,
NULL);
lm_connection_send (connection, msg, NULL);
lm_message_unref (msg);
return LM_HANDLER_RESULT_REMOVE_MESSAGE;
} else if (!connection->tls_started &&
lm_old_socket_get_require_starttls (connection->socket)) {
/* If there were no starttls features present and we require it, this is
* the place to scream. */
g_log (LM_LOG_DOMAIN, LM_LOG_LEVEL_SASL,
"%s: required StartTLS feature not supported by server\n", G_STRFUNC);
connection_do_close (connection);
connection_signal_disconnect (connection,
LM_DISCONNECT_REASON_ERROR);
return LM_HANDLER_RESULT_REMOVE_MESSAGE;
}
}
bind_node = lm_message_node_find_child (message->node, "bind");
if (bind_node) {
LmMessageHandler *bind_handler;
LmMessage *bind_msg;
const gchar *ns;
int result;
ns = lm_message_node_get_attribute (bind_node, "xmlns");
if (!ns || strcmp (ns, XMPP_NS_BIND) != 0) {
return LM_HANDLER_RESULT_ALLOW_MORE_HANDLERS;
}
bind_msg = lm_message_new_with_sub_type (NULL,
LM_MESSAGE_TYPE_IQ,
LM_MESSAGE_SUB_TYPE_SET);
bind_node = lm_message_node_add_child (bind_msg->node,
"bind", NULL);
lm_message_node_set_attributes (bind_node,
"xmlns", XMPP_NS_BIND,
NULL);
lm_message_node_add_child (bind_node, "resource",
connection->resource);
bind_handler = lm_message_handler_new (connection_bind_reply,
NULL, NULL);
result = lm_connection_send_with_reply (connection, bind_msg,
bind_handler, NULL);
lm_message_handler_unref (bind_handler);
lm_message_unref (bind_msg);
if (result < 0) {
g_log (LM_LOG_DOMAIN, LM_LOG_LEVEL_SASL,
"%s: can't send resource binding request\n", G_STRFUNC);
connection_do_close (connection);
connection_signal_disconnect (connection,
LM_DISCONNECT_REASON_ERROR);
}
}
old_auth = lm_message_node_find_child (message->node, "auth");
sasl_mechanisms = lm_message_node_find_child (message->node, "mechanisms");
if (connection->use_sasl && old_auth != NULL && sasl_mechanisms == NULL) {
g_log (LM_LOG_DOMAIN, LM_LOG_LEVEL_SASL,
"Server uses XEP-0078 (jabber iq auth) instead of SASL\n");
/* So the server is XMPP1.0, but doesn't support SASL and uses
* obsolete XEP-0078 instead. Let's cope. */
connection->use_sasl = FALSE;
if (connection->sasl) {
if (lm_sasl_get_auth_params (connection->sasl)) {
GError *error = NULL;
connection_old_auth (connection, lm_sasl_get_auth_params (connection->sasl),
&error);
if (error) {
g_error_free (error);
}
}
lm_sasl_free (connection->sasl);
connection->sasl = NULL;
}
}
return LM_HANDLER_RESULT_ALLOW_MORE_HANDLERS;
}
/**
* lm_connection_new:
* @server: The hostname to the server for the connection.
*
* Creates a new closed connection. To open the connection call
* lm_connection_open(). @server can be #NULL but must be set before calling lm_connection_open().
*
* Return value: A newly created LmConnection, should be unreffed with lm_connection_unref().
**/
LmConnection *
lm_connection_new (const gchar *server)
{
LmConnection *connection;
gint i;
#if !GLIB_CHECK_VERSION(2, 35, 0)
g_type_init (); /* Ensure that the GLib type library is initialized */
#endif
lm_debug_init ();
_lm_sock_library_init ();
connection = g_slice_new0 (LmConnection);
if (server) {
connection->server = _lm_utils_hostname_to_punycode (server);
}
connection->port = LM_CONNECTION_DEFAULT_PORT;
connection->queue = lm_message_queue_new ((LmMessageQueueCallback) connection_message_queue_cb,
connection);
connection->state = LM_CONNECTION_STATE_CLOSED;
connection->id_handlers = g_hash_table_new_full (g_str_hash,
g_str_equal,
g_free,
(GDestroyNotify) lm_message_handler_unref);
connection->ref_count = 1;
for (i = 0; i < LM_MESSAGE_TYPE_UNKNOWN; ++i) {
connection->handlers[i] = NULL;
}
connection->parser = lm_parser_new
((LmParserMessageFunction) connection_new_message_cb,
connection, NULL);
return connection;
}
/**
* lm_connection_new_with_context:
* @server: The hostname to the server for the connection.
* @context: The context this connection should be running in.
*
* Creates a new closed connection running in a certain context. To open the
* connection call #lm_connection_open. @server can be #NULL but must be set
* before calling #lm_connection_open.
*
* Return value: A newly created LmConnection, should be unreffed with lm_connection_unref().
**/
LmConnection *
lm_connection_new_with_context (const gchar *server, GMainContext *context)
{
LmConnection *connection;
connection = lm_connection_new (server);
connection->context = context;
if (context) {
g_main_context_ref (connection->context);
}
return connection;
}
/**
* lm_connection_open:
* @connection: #LmConnection to open
* @function: Callback function that will be called when the connection is open.
* @user_data: User data that will be passed to @function.
* @notify: Function for freeing that user_data, can be NULL.
* @error: location to store error, or %NULL
*
* An async call to open @connection. When the connection is open @function will be called.
*
* Return value: #TRUE if everything went fine, otherwise #FALSE.
**/
gboolean
lm_connection_open (LmConnection *connection,
LmResultFunction function,
gpointer user_data,
GDestroyNotify notify,
GError **error)
{
g_return_val_if_fail (connection != NULL, FALSE);
connection->open_cb = _lm_utils_new_callback (function,
user_data, notify);
return connection_do_open (connection, error);
}
/**
* lm_connection_open_and_block:
* @connection: an #LmConnection to open
* @error: location to store error, or %NULL
*
* Opens @connection and waits until the stream is setup.
*
* Return value: #TRUE if no errors where encountered during opening and stream setup successfully, #FALSE otherwise.
**/
gboolean
lm_connection_open_and_block (LmConnection *connection, GError **error)
{
gboolean result;
g_return_val_if_fail (connection != NULL, FALSE);
connection->open_cb = NULL;
result = connection_do_open (connection, error);
if (result == FALSE) {
return FALSE;
}
while (lm_connection_get_state (connection) == LM_CONNECTION_STATE_OPENING) {
if (g_main_context_pending (connection->context)) {
g_main_context_iteration (connection->context, TRUE);
} else {
/* Sleep for 1 millisecond */
g_usleep (1000);
}
}
if (lm_connection_is_open (connection)) {
connection_start_keep_alive (connection);
return TRUE;
}
/* Need to set the error here: LM-15 */
g_set_error (error,
LM_ERROR,
LM_ERROR_CONNECTION_FAILED,
"Opening the connection failed");
return FALSE;
}
/**
* lm_connection_cancel_open:
* @connection: an #LmConnection to cancel opening on
*
* Cancels the open operation of a connection. The connection should be in the state #LM_CONNECTION_STATE_OPENING.
**/
void
lm_connection_cancel_open (LmConnection *connection)
{
g_return_if_fail (connection != NULL);
if (connection->open_cb) {
_lm_utils_free_callback (connection->open_cb);
connection->open_cb = NULL;
}
connection->cancel_open = TRUE;
lm_old_socket_asyncns_cancel (connection->socket);
}
/**
* lm_connection_close:
* @connection: #LmConnection to close
* @error: location to store error, or %NULL
*
* A synchronous call to close the connection. When returning the connection is considered to be closed and can be opened again with lm_connection_open().
*
* Return value: Returns #TRUE if no errors where detected, otherwise #FALSE.
**/
gboolean
lm_connection_close (LmConnection *connection, GError **error)
{
gboolean no_errors = TRUE;
g_return_val_if_fail (connection != NULL, FALSE);
if (connection->socket) {
lm_old_socket_asyncns_cancel (connection->socket);
}
if (connection->state == LM_CONNECTION_STATE_CLOSED) {
g_set_error (error,
LM_ERROR,
LM_ERROR_CONNECTION_NOT_OPEN,
"Connection is not open, call lm_connection_open() first");
return FALSE;
}
lm_verbose ("Disconnecting from: %s:%d\n",
connection->server, connection->port);
if (lm_connection_is_open (connection)) {
if (!connection_send (connection, "</stream:stream>", -1, error)) {
no_errors = FALSE;
}
lm_old_socket_flush (connection->socket);
}
connection_do_close (connection);
connection_signal_disconnect (connection, LM_DISCONNECT_REASON_OK);
return no_errors;
}
static void
connection_sasl_auth_finished (LmSASL *sasl,
LmConnection *connection,
gboolean success,
const gchar *reason)
{
if (!success) {
lm_verbose ("SASL authentication failed, closing connection\n");
connection_call_auth_cb (connection, FALSE);
return;
}
connection_send_stream_header (connection);
}
/**
* lm_connection_authenticate:
* @connection: #LmConnection to authenticate.
* @username: Username used to authenticate.
* @password: Password corresponding to @username.
* @resource: Resource used for this connection.
* @function: Callback called when authentication is finished.
* @user_data: Userdata passed to @function when called.
* @notify: Destroy function to free the memory used by @user_data, can be NULL.
* @error: location to store error, or %NULL
*
* Tries to authenticate a user against the server. The #LmResult in the result callback @function will say whether it succeeded or not.
*
* Return value: #TRUE if no errors where detected while sending the authentication message, #FALSE otherwise.
**/
gboolean
lm_connection_authenticate (LmConnection *connection,
const gchar *username,
const gchar *password,
const gchar *resource,
LmResultFunction function,
gpointer user_data,
GDestroyNotify notify,
GError **error)
{
LmAuthParameters *auth_params;
gboolean ret_val;
g_return_val_if_fail (connection != NULL, FALSE);
g_return_val_if_fail (username != NULL, FALSE);
g_return_val_if_fail (password != NULL, FALSE);
g_return_val_if_fail (resource != NULL, FALSE);
auth_params = lm_auth_parameters_new (username, password, resource);
if (!lm_connection_is_open (connection)) {
g_set_error (error,
LM_ERROR,
LM_ERROR_CONNECTION_NOT_OPEN,
"Connection is not open, call lm_connection_open() first");
return FALSE;
}
connection->state = LM_CONNECTION_STATE_AUTHENTICATING;
connection->auth_cb = _lm_utils_new_callback (function,
user_data,
notify);
connection->resource = g_strdup (lm_auth_parameters_get_resource (auth_params));
connection->effective_jid = g_strdup_printf ("%s/%s",
connection->jid, connection->resource);
/* TODO: Break out Credentials (or use the already existing AuthReqData struct for *
* Username/Password and Resource */
if (connection->use_sasl) {
gchar *domain = NULL;
if (!connection_get_server_from_jid (connection->jid, &domain)) {
domain = g_strdup (connection->server);
}
lm_sasl_authenticate (connection->sasl, auth_params, domain,
connection_sasl_auth_finished);
g_free (domain);
connection->features_cb =
lm_message_handler_new (connection_features_cb,
NULL, NULL);
lm_connection_register_message_handler (connection,
connection->features_cb,
LM_MESSAGE_TYPE_STREAM_FEATURES,
LM_HANDLER_PRIORITY_FIRST);
ret_val = TRUE;
} else {
ret_val = connection_old_auth (connection, auth_params, error);
}
lm_auth_parameters_unref (auth_params);
return ret_val;
}
static gboolean
connection_old_auth (LmConnection *connection,
LmAuthParameters *auth_params,
GError **error)
{
LmMessage *m;
LmMessageHandler *handler;
gboolean result;
m = connection_create_auth_req_msg (auth_params);
handler = lm_message_handler_new (connection_auth_req_reply,
lm_auth_parameters_ref (auth_params),
(GDestroyNotify) lm_auth_parameters_unref);
result = lm_connection_send_with_reply (connection, m, handler, error);
lm_message_handler_unref (handler);
lm_message_unref (m);
return result;
}
/**
* lm_connection_authenticate_and_block:
* @connection: an #LmConnection
* @username: Username used to authenticate.
* @password: Password corresponding to @username.
* @resource: Resource used for this connection.
* @error: location to store error, or %NULL
*
* Tries to authenticate a user against the server. This function blocks until a reply to the authentication attempt is returned and returns whether it was successful or not.
*
* Return value: #TRUE if no errors where detected and authentication was successful. #FALSE otherwise.
**/
gboolean
lm_connection_authenticate_and_block (LmConnection *connection,
const gchar *username,
const gchar *password,
const gchar *resource,
GError **error)
{
gboolean result;
result = lm_connection_authenticate (connection, username, password,
resource, NULL, NULL, NULL, error);
if (!result)
return result;
while (lm_connection_get_state (connection) == LM_CONNECTION_STATE_AUTHENTICATING) {
if (g_main_context_pending (connection->context)) {
g_main_context_iteration (connection->context, TRUE);
} else {
/* Sleep for 1 millisecond */
g_usleep (1000);
}
}
switch (lm_connection_get_state (connection)) {
case LM_CONNECTION_STATE_AUTHENTICATED:
return TRUE;
break;
case LM_CONNECTION_STATE_OPEN:
g_set_error (error,
LM_ERROR,
LM_ERROR_AUTH_FAILED,
"Authentication failed");
return FALSE;
break;
default:
g_assert_not_reached ();
break;
}
return FALSE;
}
/**
* lm_connection_get_keep_alive_rate:
* @connection: an #LmConnection
*
* Get the keep alive rate, in seconds. Zero is returned if no keep alive rate has been set.
*
* Since 1.3.5
**/
guint
lm_connection_get_keep_alive_rate (LmConnection *connection)
{
g_return_val_if_fail (connection != NULL, 0);
return connection->keep_alive_rate;
}
/**
* lm_connection_set_keep_alive_rate:
* @connection: an #LmConnection
* @rate: Number of seconds between keep alive packages are sent.
*
* Set the keep alive rate, in seconds. Set to 0 to prevent keep alive messages to be sent.
* A keep alive message is a single space character.
**/
void
lm_connection_set_keep_alive_rate (LmConnection *connection, guint rate)
{
g_return_if_fail (connection != NULL);
connection_stop_keep_alive (connection);
if (rate == 0) {
return;
}
connection->keep_alive_rate = rate;
if (lm_connection_is_open (connection)) {
connection_start_keep_alive (connection);
}
}
/**
* lm_connection_is_open:
* @connection: #LmConnection to check if it is open.
*
* Check if the @connection is currently open.
*
* Return value: #TRUE if connection is open and #FALSE if it is closed.
**/
gboolean
lm_connection_is_open (LmConnection *connection)
{
g_return_val_if_fail (connection != NULL, FALSE);
return connection->state >= LM_CONNECTION_STATE_OPEN;
}
/**
* lm_connection_is_authenticated:
* @connection: #LmConnection to check if it is authenticated
*
* Check if @connection is authenticated.
*
* Return value: #TRUE if connection is authenticated, #FALSE otherwise.
**/
gboolean
lm_connection_is_authenticated (LmConnection *connection)
{
g_return_val_if_fail (connection != NULL, FALSE);
return connection->state >= LM_CONNECTION_STATE_AUTHENTICATED;
}
/**
* lm_connection_get_server:
* @connection: an #LmConnection
*
* Fetches the server address that @connection is using.
*
* Return value: the server address
**/
const gchar *
lm_connection_get_server (LmConnection *connection)
{
g_return_val_if_fail (connection != NULL, NULL);
return connection->server;
}
/**
* lm_connection_set_server:
* @connection: an #LmConnection
* @server: Address of the server
*
* Sets the server address for @connection to @server. Notice that @connection
* can't be open while doing this.
**/
void
lm_connection_set_server (LmConnection *connection, const gchar *server)
{
g_return_if_fail (connection != NULL);
g_return_if_fail (server != NULL);
if (lm_connection_is_open (connection)) {
g_log (LM_LOG_DOMAIN, LM_LOG_LEVEL_VERBOSE,
"Can't change server address while connected");
return;
}
g_free (connection->server);
connection->server = _lm_utils_hostname_to_punycode (server);
}
/**
* lm_connection_get_jid:
* @connection: an #LmConnection
*
* Fetches the jid set for @connection is using.
*
* Return value: the jid
**/
const gchar *
lm_connection_get_jid (LmConnection *connection)
{
g_return_val_if_fail (connection != NULL, NULL);
return connection->jid;
}
/**
* lm_connection_get_full_jid:
* @connection: an #LmConnection
*
* Returns the full jid that server set for us after
* resource binding, complete with the resource.
*
* Return value: the jid
**/
gchar *
lm_connection_get_full_jid (LmConnection *connection)
{
g_return_val_if_fail (connection != NULL, NULL);
return connection->effective_jid;
}
/**
* lm_connection_set_jid:
* @connection: an #LmConnection
* @jid: JID to be used for @connection
*
* Sets the JID to be used for @connection.
**/
void
lm_connection_set_jid (LmConnection *connection, const gchar *jid)
{
g_return_if_fail (connection != NULL);
if (lm_connection_is_open (connection)) {
g_log (LM_LOG_DOMAIN, LM_LOG_LEVEL_VERBOSE,
"Can't change JID while connected");
return;
}
g_free (connection->jid);
connection->jid = g_strdup (jid);
}
/**
* lm_connection_get_port:
* @connection: an #LmConnection
*
* Fetches the port that @connection is using.
*
* Return value:
**/
guint
lm_connection_get_port (LmConnection *connection)
{
g_return_val_if_fail (connection != NULL, 0);
return connection->port;
}
/**
* lm_connection_set_port:
* @connection: an #LmConnection
* @port: server port
*
* Sets the server port that @connection will be using.
**/
void
lm_connection_set_port (LmConnection *connection, guint port)
{
g_return_if_fail (connection != NULL);
if (lm_connection_is_open (connection)) {
g_log (LM_LOG_DOMAIN, LM_LOG_LEVEL_VERBOSE,
"Can't change server port while connected");
return;
}
connection->port = port;
}
/**
* lm_connection_get_ssl:
* @connection: an #LmConnection
*
* Returns the SSL struct if the connection is using one.
*
* Return value: The ssl struct or %NULL if no proxy is used.
**/
LmSSL *
lm_connection_get_ssl (LmConnection *connection)
{
g_return_val_if_fail (connection != NULL, NULL);
return connection->ssl;
}
/**
* lm_connection_set_ssl:
* @connection: An #LmConnection
* @ssl: An #LmSSL
*
* Sets SSL struct or unset if @ssl is %NULL. If set @connection will use SSL to for the connection.
*/
void
lm_connection_set_ssl (LmConnection *connection, LmSSL *ssl)
{
g_return_if_fail (connection != NULL);
g_return_if_fail (lm_ssl_is_supported () == TRUE);
if (connection->ssl) {
lm_ssl_unref (connection->ssl);
}
if (ssl) {
connection->ssl = lm_ssl_ref (ssl);
} else {
connection->ssl = NULL;
}
}
/**
* lm_connection_get_proxy:
* @connection: an #LmConnection
*
* Returns the proxy if the connection is using one.
*
* Return value: The proxy or %NULL if no proxy is used.
**/
LmProxy *
lm_connection_get_proxy (LmConnection *connection)
{
g_return_val_if_fail (connection != NULL, NULL);
return connection->proxy;
}
/**
* lm_connection_set_proxy:
* @connection: an #LmConnection
* @proxy: an #LmProxy
*
* Sets the proxy to use for this connection. To unset pass #NULL.
*
**/
void
lm_connection_set_proxy (LmConnection *connection, LmProxy *proxy)
{
g_return_if_fail (connection != NULL);
if (lm_connection_is_open (connection)) {
g_log (LM_LOG_DOMAIN, LM_LOG_LEVEL_VERBOSE,
"Can't change server proxy while connected");
return;
}
if (connection->proxy) {
lm_proxy_unref (connection->proxy);
connection->proxy = NULL;
}
if (proxy && lm_proxy_get_type (proxy) != LM_PROXY_TYPE_NONE) {
connection->proxy = lm_proxy_ref (proxy);
}
}
/**
* lm_connection_send:
* @connection: #LmConnection to send message over.
* @message: #LmMessage to send.
* @error: location to store error, or %NULL
*
* Asynchronous call to send a message.
*
* Return value: Returns #TRUE if no errors where detected while sending, #FALSE otherwise.
**/
gboolean
lm_connection_send (LmConnection *connection,
LmMessage *message,
GError **error)
{
gchar *xml_str;
gchar *ch;
gboolean result;
g_return_val_if_fail (connection != NULL, FALSE);
g_return_val_if_fail (message != NULL, FALSE);
xml_str = lm_message_node_to_string (message->node);
if ((ch = strstr (xml_str, "</stream:stream>"))) {
*ch = '\0';
}
result = connection_send (connection, xml_str, -1, error);
g_free (xml_str);
return result;
}
/**
* lm_connection_send_with_reply:
* @connection: #LmConnection used to send message.
* @message: #LmMessage to send.
* @handler: #LmMessageHandler that will be used when a reply to @message arrives
* @error: location to store error, or %NULL
*
* Send a #LmMessage which will result in a reply.
*
* Return value: Returns #TRUE if no errors where detected while sending, #FALSE otherwise.
**/
gboolean
lm_connection_send_with_reply (LmConnection *connection,
LmMessage *message,
LmMessageHandler *handler,
GError **error)
{
gchar *id;
g_return_val_if_fail (connection != NULL, FALSE);
g_return_val_if_fail (message != NULL, FALSE);
g_return_val_if_fail (handler != NULL, FALSE);
if (lm_message_node_get_attribute (message->node, "id")) {
id = g_strdup (lm_message_node_get_attribute (message->node,
"id"));
} else {
id = _lm_utils_generate_id ();
lm_message_node_set_attributes (message->node, "id", id, NULL);
}
g_hash_table_insert (connection->id_handlers,
id, lm_message_handler_ref (handler));
return lm_connection_send (connection, message, error);
}
/**
* lm_connection_send_with_reply_and_block:
* @connection: an #LmConnection
* @message: an #LmMessage
* @error: Set if error was detected during sending.
*
* Send @message and wait for return.
*
* Return value: The reply
**/
LmMessage *
lm_connection_send_with_reply_and_block (LmConnection *connection,
LmMessage *message,
GError **error)
{
gchar *id;
LmMessage *reply = NULL;
g_return_val_if_fail (connection != NULL, NULL);
g_return_val_if_fail (message != NULL, NULL);
if (connection->state < LM_CONNECTION_STATE_OPENING) {
g_set_error (error,
LM_ERROR,
LM_ERROR_CONNECTION_NOT_OPEN,
"Connection is not open, call lm_connection_open() first");
return FALSE;
}
if (lm_message_node_get_attribute (message->node, "id")) {
id = g_strdup (lm_message_node_get_attribute (message->node,
"id"));
} else {
id = _lm_utils_generate_id ();
lm_message_node_set_attributes (message->node, "id", id, NULL);
}
lm_message_queue_detach (connection->queue);
lm_connection_send (connection, message, error);
while (!reply) {
const gchar *m_id;
guint n;
g_main_context_iteration (connection->context, TRUE);
if (lm_message_queue_is_empty (connection->queue)) {
continue;
}
for (n = 0; n < lm_message_queue_get_length (connection->queue); n++) {
LmMessage *m;
m = (LmMessage *) lm_message_queue_peek_nth (connection->queue, n);
m_id = lm_message_node_get_attribute (m->node, "id");
if (m_id && strcmp (m_id, id) == 0) {
reply = m;
lm_message_queue_pop_nth (connection->queue, n);
break;
}
}
}
g_free (id);
lm_message_queue_attach (connection->queue, connection->context);
return reply;
}
/**
* lm_connection_unregister_reply_handler:
* @connection: Connection to unregister a handler for.
* @handler: The handler to unregister.
*
* Unregisters the reply handler for @connection. @handler will no longer be
* called if an incoming message has the id for which it was registered.
**/
void
lm_connection_unregister_reply_handler (LmConnection *connection,
LmMessageHandler *handler)
{
GHashTableIter iter;
gpointer key, value;
g_return_if_fail (connection != NULL);
g_return_if_fail (handler != NULL);
g_hash_table_iter_init (&iter, connection -> id_handlers);
while (g_hash_table_iter_next (&iter, &key, &value)) {
if (handler == value) {
g_hash_table_iter_remove (&iter);
break;
}
}
}
/**
* lm_connection_register_message_handler:
* @connection: Connection to register a handler for.
* @handler: Message handler to register.
* @type: Message type that @handler will handle.
* @priority: The priority in which to call @handler.
*
* Registers a #LmMessageHandler to handle incoming messages of a certain type.
* To unregister the handler call lm_connection_unregister_message_handler().
**/
void
lm_connection_register_message_handler (LmConnection *connection,
LmMessageHandler *handler,
LmMessageType type,
LmHandlerPriority priority)
{
HandlerData *hd;
g_return_if_fail (connection != NULL);
g_return_if_fail (handler != NULL);
g_return_if_fail (type != LM_MESSAGE_TYPE_UNKNOWN);
hd = g_new0 (HandlerData, 1);
hd->priority = priority;
hd->handler = lm_message_handler_ref (handler);
connection->handlers[type] = g_slist_insert_sorted (connection->handlers[type],
hd,
(GCompareFunc) connection_handler_compare_func);
}
/**
* lm_connection_unregister_message_handler:
* @connection: Connection to unregister a handler for.
* @handler: The handler to unregister.
* @type: What type of messages to unregister this handler for.
*
* Unregisters a handler for @connection. @handler will no longer be called
* when incoming messages of @type arrive.
**/
void
lm_connection_unregister_message_handler (LmConnection *connection,
LmMessageHandler *handler,
LmMessageType type)
{
GSList *l;
g_return_if_fail (connection != NULL);
g_return_if_fail (handler != NULL);
g_return_if_fail (type != LM_MESSAGE_TYPE_UNKNOWN);
for (l = connection->handlers[type]; l; l = l->next) {
HandlerData *hd = (HandlerData *) l->data;
if (handler == hd->handler) {
connection->handlers[type] = g_slist_remove_link (connection->handlers[type], l);
g_slist_free (l);
lm_message_handler_unref (hd->handler);
g_free (hd);
break;
}
}
}
/**
* lm_connection_set_disconnect_function:
* @connection: Connection to register disconnect callback for.
* @function: Function to be called when @connection is closed.
* @user_data: User data passed to @function.
* @notify: Function that will be called with @user_data when @user_data needs to be freed. Pass #NULL if it shouldn't be freed.
*
* Set the callback that will be called when a connection is closed.
**/
void
lm_connection_set_disconnect_function (LmConnection *connection,
LmDisconnectFunction function,
gpointer user_data,
GDestroyNotify notify)
{
g_return_if_fail (connection != NULL);
if (connection->disconnect_cb) {
_lm_utils_free_callback (connection->disconnect_cb);
}
if (function) {
connection->disconnect_cb = _lm_utils_new_callback (function,
user_data,
notify);
} else {
connection->disconnect_cb = NULL;
}
}
/**
* lm_connection_send_raw:
* @connection: Connection used to send
* @str: The string to send, the entire string will be sent.
* @error: Set if error was detected during sending.
*
* Asynchronous call to send a raw string. Useful for debugging and testing.
*
* Return value: Returns #TRUE if no errors was detected during sending,
* #FALSE otherwise.
**/
gboolean
lm_connection_send_raw (LmConnection *connection,
const gchar *str,
GError **error)
{
g_return_val_if_fail (connection != NULL, FALSE);
g_return_val_if_fail (str != NULL, FALSE);
return connection_send (connection, str, -1, error);
}
/**
* lm_connection_get_state:
* @connection: Connection to get state on
*
* Returns the state of the connection.
*
* Return value: The state of the connection.
**/
LmConnectionState
lm_connection_get_state (LmConnection *connection)
{
g_return_val_if_fail (connection != NULL,
LM_CONNECTION_STATE_CLOSED);
return connection->state;
}
/**
* lm_connection_get_client_host:
* @connection: An #LmConnection
*
* Returns the local host name of the connection.
*
* Return value: A newly allocated string representing the local host name.
**/
gchar *
lm_connection_get_local_host (LmConnection *connection)
{
return lm_old_socket_get_local_host (connection->socket);
}
/**
* lm_connection_ref:
* @connection: Connection to add a reference to.
*
* Add a reference on @connection. To remove a reference call
* lm_connection_unref().
*
* Return value: Returns the same connection.
**/
LmConnection*
lm_connection_ref (LmConnection *connection)
{
g_return_val_if_fail (connection != NULL, NULL);
connection->ref_count++;
return connection;
}
/**
* lm_connection_unref:
* @connection: Connection to remove reference from.
*
* Removes a reference on @connection. If there are no references to
* @connection it will be freed and shouldn't be used again.
**/
void
lm_connection_unref (LmConnection *connection)
{
g_return_if_fail (connection != NULL);
connection->ref_count--;
if (connection->ref_count == 0) {
connection_free (connection);
}
}