/* * gabble-error.c - Source for Gabble's error handling API * Copyright (C) 2006 Collabora Ltd. * Copyright (C) 2006 Nokia Corporation * @author Ole Andre Vadla Ravnaas * * This library 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.1 of the License, or (at your option) any later version. * * This library 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 library; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */ #include #include #include "gabble-error.h" #include "namespaces.h" #define MAX_LEGACY_ERRORS 3 typedef struct { const gchar *name; const gchar *description; const gchar *type; const guint16 legacy_errors[MAX_LEGACY_ERRORS]; } XmppErrorSpec; static const XmppErrorSpec xmpp_errors[NUM_XMPP_ERRORS] = { { "redirect", "the recipient or server is redirecting requests for this information " "to another entity", "modify", { 302, 0, }, }, { "gone", "the recipient or server can no longer be contacted at this address", "modify", { 302, 0, }, }, { "bad-request", "the sender has sent XML that is malformed or that cannot be processed", "modify", { 400, 0, }, }, { "unexpected-request", "the recipient or server understood the request but was not expecting " "it at this time", "wait", { 400, 0, }, }, { "jid-malformed", "the sending entity has provided or communicated an XMPP address or " "aspect thereof (e.g., a resource identifier) that does not adhere " "to the syntax defined in Addressing Scheme (Section 3)", "modify", { 400, 0, }, }, { "not-authorized", "the sender must provide proper credentials before being allowed to " "perform the action, or has provided improper credentials", "auth", { 401, 0, }, }, { "payment-required", "the requesting entity is not authorized to access the requested " "service because payment is required", "auth", { 402, 0, }, }, { "forbidden", "the requesting entity does not possess the required permissions to " "perform the action", "auth", { 403, 0, }, }, { "item-not-found", "the addressed JID or item requested cannot be found", "cancel", { 404, 0, }, }, { "recipient-unavailable", "the intended recipient is temporarily unavailable", "wait", { 404, 0, }, }, { "remote-server-not-found", "a remote server or service specified as part or all of the JID of the " "intended recipient (or required to fulfill a request) could not be " "contacted within a reasonable amount of time", "cancel", { 404, 0, }, }, { "not-allowed", "the recipient or server does not allow any entity to perform the action", "cancel", { 405, 0, }, }, { "not-acceptable", "the recipient or server understands the request but is refusing to " "process it because it does not meet criteria defined by the recipient " "or server (e.g., a local policy regarding acceptable words in messages)", "modify", { 406, 0, }, }, { "registration-required", "the requesting entity is not authorized to access the requested service " "because registration is required", "auth", { 407, 0, }, }, { "subscription-required", "the requesting entity is not authorized to access the requested service " "because a subscription is required", "auth", { 407, 0, }, }, { "remote-server-timeout", "a remote server or service specified as part or all of the JID of the " "intended recipient (or required to fulfill a request) could not be " "contacted within a reasonable amount of time", "wait", { 408, 504, 0, }, }, { "conflict", "access cannot be granted because an existing resource or session exists " "with the same name or address", "cancel", { 409, 0, }, }, { "internal-server-error", "the server could not process the stanza because of a misconfiguration " "or an otherwise-undefined internal server error", "wait", { 500, 0, }, }, { "undefined-condition", "application-specific condition", NULL, { 500, 0, }, }, { "resource-constraint", "the server or recipient lacks the system resources necessary to service " "the request", "wait", { 500, 0, }, }, { "feature-not-implemented", "the feature requested is not implemented by the recipient or server and " "therefore cannot be processed", "cancel", { 501, 0, }, }, { "service-unavailable", "the server or recipient does not currently provide the requested " "service", "cancel", { 502, 503, 510, }, }, }; GQuark gabble_xmpp_error_quark (void) { static GQuark quark = 0; if (!quark) quark = g_quark_from_static_string ("gabble-xmpp-error"); return quark; } GabbleXmppError gabble_xmpp_error_from_node (LmMessageNode *error_node) { gint i, j; const gchar *error_code_str; /* First, try to look it up the modern way */ if (error_node->children) { for (i = 0; i < NUM_XMPP_ERRORS; i++) { if (lm_message_node_get_child (error_node, xmpp_errors[i].name)) { return i; } } } /* Ok, do it the legacy way */ error_code_str = lm_message_node_get_attribute (error_node, "code"); if (error_code_str) { gint error_code; error_code = atoi (error_code_str); for (i = 0; i < NUM_XMPP_ERRORS; i++) { const XmppErrorSpec *spec = &xmpp_errors[i]; for (j = 0; j < MAX_LEGACY_ERRORS; j++) { gint cur_code = spec->legacy_errors[j]; if (cur_code == 0) break; if (cur_code == error_code) return i; } } } return INVALID_XMPP_ERROR; } GError * gabble_xmpp_error_to_g_error (GabbleXmppError error) { if (error < 0 || error >= NUM_XMPP_ERRORS) return NULL; return g_error_new (GABBLE_XMPP_ERROR, error, xmpp_errors[error].description); } LmMessageNode * gabble_xmpp_error_to_node (GabbleXmppError error, LmMessageNode *parent_node) { const XmppErrorSpec *spec; LmMessageNode *error_node, *node; gchar str[6]; if (error < 0 || error >= NUM_XMPP_ERRORS) return NULL; spec = &xmpp_errors[error]; error_node = lm_message_node_add_child (parent_node, "error", NULL); sprintf (str, "%d", spec->legacy_errors[0]); lm_message_node_set_attribute (error_node, "code", str); if (spec->type) { lm_message_node_set_attribute (error_node, "type", spec->type); } node = lm_message_node_add_child (error_node, spec->name, NULL); lm_message_node_set_attribute (node, "xmlns", NS_XMPP_STANZAS); return error_node; } const gchar * gabble_xmpp_error_string (GabbleXmppError error) { if (error >= 0 && error < NUM_XMPP_ERRORS) return xmpp_errors[error].name; else return NULL; } const gchar * gabble_xmpp_error_description (GabbleXmppError error) { if (error >= 0 && error < NUM_XMPP_ERRORS) return xmpp_errors[error].description; else return NULL; }