/** * @file internal.h Internal definitions and includes * @ingroup core */ /* 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_INTERNAL_H_ #define _PURPLE_INTERNAL_H_ #ifdef HAVE_CONFIG_H # include #endif /* for SIOCGIFCONF in SKYOS */ #ifdef SKYOS #include #endif /* * If we're using NLS, make sure gettext works. If not, then define * dummy macros in place of the normal gettext macros. * * Also, the perl XS config.h file sometimes defines _ So we need to * make sure _ isn't already defined before trying to define it. * * The Singular/Plural/Number ngettext dummy definition below was * taken from an email to the texinfo mailing list by Manuel Guerrero. * Thank you Manuel, and thank you Alex's good friend Google. */ #ifdef ENABLE_NLS # include # include # define _(String) ((const char *)dgettext(PACKAGE, String)) # ifdef gettext_noop # define N_(String) gettext_noop (String) # else # define N_(String) (String) # endif #else # include # define N_(String) (String) # ifndef _ # define _(String) ((const char *)String) # endif # define ngettext(Singular, Plural, Number) ((Number == 1) ? ((const char *)Singular) : ((const char *)Plural)) # define dngettext(Domain, Singular, Plural, Number) ((Number == 1) ? ((const char *)Singular) : ((const char *)Plural)) #endif #ifdef HAVE_ENDIAN_H # include #endif #define MSG_LEN 2048 /* The above should normally be the same as BUF_LEN, * but just so we're explicitly asking for the max message * length. */ #define BUF_LEN MSG_LEN #define BUF_LONG BUF_LEN * 2 #include #include #ifndef _WIN32 #include #include #include #endif #include #include #include #include #include #include #include #include #ifdef HAVE_ICONV #include #endif #ifdef HAVE_LANGINFO_CODESET #include #endif #include #ifdef PURPLE_PLUGINS # ifdef HAVE_DLFCN_H # include # endif #endif #ifndef _WIN32 # include # include # include # include # include # include # include # include #endif /* MAXPATHLEN should only be used with readlink() on glib < 2.4.0. For * anything else, use g_file_read_link() or other dynamic functions. This is * important because Hurd has no hard limits on path length. */ #if !GLIB_CHECK_VERSION(2,4,0) # ifndef MAXPATHLEN # ifdef PATH_MAX # define MAXPATHLEN PATH_MAX # else # define MAXPATHLEN 1024 # endif # endif #endif #ifndef HOST_NAME_MAX # define HOST_NAME_MAX 255 #endif #include #if !GLIB_CHECK_VERSION(2,4,0) # define G_MAXUINT32 ((guint32) 0xffffffff) #endif #ifndef G_MAXSIZE # if GLIB_SIZEOF_LONG == 8 # define G_MAXSIZE ((gsize) 0xffffffffffffffff) # else # define G_MAXSIZE ((gsize) 0xffffffff) # endif #endif #ifndef G_MAXSSIZE # if GLIB_SIZEOF_LONG == 8 # define G_MAXSSIZE ((gssize) 0x7fffffffffffffff) # else # define G_MAXSSIZE ((gssize) 0x7fffffff) # endif #endif #if GLIB_CHECK_VERSION(2,6,0) # include #endif #if !GLIB_CHECK_VERSION(2,6,0) # define g_freopen freopen # define g_fopen fopen # define g_rmdir rmdir # define g_remove remove # define g_unlink unlink # define g_lstat lstat # define g_stat stat # define g_mkdir mkdir # define g_rename rename # define g_open open #endif #if !GLIB_CHECK_VERSION(2,8,0) && !defined _WIN32 # define g_access access #endif #if !GLIB_CHECK_VERSION(2,10,0) # define g_slice_new(type) g_new(type, 1) # define g_slice_new0(type) g_new0(type, 1) # define g_slice_free(type, mem) g_free(mem) #endif #ifdef _WIN32 #include "win32dep.h" #endif /* ugly ugly ugly */ /* This is a workaround for the fact that G_GINT64_MODIFIER and G_GSIZE_FORMAT * are only defined in Glib >= 2.4 */ #ifndef G_GINT64_MODIFIER # if GLIB_SIZEOF_LONG == 8 # define G_GINT64_MODIFIER "l" # else # define G_GINT64_MODIFIER "ll" # endif #endif #ifndef G_GSIZE_MODIFIER # if GLIB_SIZEOF_LONG == 8 # define G_GSIZE_MODIFIER "l" # else # define G_GSIZE_MODIFIER "" # endif #endif #ifndef G_GSIZE_FORMAT # if GLIB_SIZEOF_LONG == 8 # define G_GSIZE_FORMAT "lu" # else # define G_GSIZE_FORMAT "u" # endif #endif #ifndef G_GSSIZE_FORMAT # if GLIB_SIZEOF_LONG == 8 # define G_GSSIZE_FORMAT "li" # else # define G_GSSIZE_FORMAT "i" # endif #endif #ifndef G_GNUC_NULL_TERMINATED # if __GNUC__ >= 4 # define G_GNUC_NULL_TERMINATED __attribute__((__sentinel__)) # else # define G_GNUC_NULL_TERMINATED # endif #endif #ifdef HAVE_CONFIG_H #if SIZEOF_TIME_T == 4 # define PURPLE_TIME_T_MODIFIER "lu" #elif SIZEOF_TIME_T == 8 # define PURPLE_TIME_T_MODIFIER "zu" #else #error Unknown size of time_t #endif #endif #include #ifndef G_DEFINE_TYPE #define G_DEFINE_TYPE(TypeName, type_name, TYPE_PARENT) \ \ static void type_name##_init (TypeName *self); \ static void type_name##_class_init (TypeName##Class *klass); \ static gpointer type_name##_parent_class = NULL; \ static void type_name##_class_intern_init (gpointer klass) \ { \ type_name##_parent_class = g_type_class_peek_parent (klass); \ type_name##_class_init ((TypeName##Class*) klass); \ } \ \ GType \ type_name##_get_type (void) \ { \ static GType g_define_type_id = 0; \ if (G_UNLIKELY (g_define_type_id == 0)) \ { \ g_define_type_id = \ g_type_register_static_simple (TYPE_PARENT, \ g_intern_static_string (#TypeName), \ sizeof (TypeName##Class), \ (GClassInitFunc)type_name##_class_intern_init, \ sizeof (TypeName), \ (GInstanceInitFunc)type_name##_init, \ (GTypeFlags) 0); \ } \ return g_define_type_id; \ } /* closes type_name##_get_type() */ #endif /* Safer ways to work with static buffers. When using non-static * buffers, either use g_strdup_* functions (preferred) or use * g_strlcpy/g_strlcpy directly. */ #define purple_strlcpy(dest, src) g_strlcpy(dest, src, sizeof(dest)) #define purple_strlcat(dest, src) g_strlcat(dest, src, sizeof(dest)) #define PURPLE_WEBSITE "http://pidgin.im/" #define PURPLE_DEVEL_WEBSITE "http://developer.pidgin.im/" /* INTERNAL FUNCTIONS */ #include "account.h" #include "connection.h" /* This is for the accounts code to notify the buddy icon code that * it's done loading. We may want to replace this with a signal. */ void _purple_buddy_icons_account_loaded_cb(void); /* This is for the buddy list to notify the buddy icon code that * it's done loading. We may want to replace this with a signal. */ void _purple_buddy_icons_blist_loaded_cb(void); /* This is for the purple_core_migrate() code to tell the buddy * icon subsystem about the old icons directory so it can * migrate any icons in use. */ void _purple_buddy_icon_set_old_icons_dir(const char *dirname); /** * Creates a connection to the specified account and either connects * or attempts to register a new account. If you are logging in, * the connection uses the current active status for this account. * So if you want to sign on as "away," for example, you need to * have called purple_account_set_status(account, "away"). * (And this will call purple_account_connect() automatically). * * @note This function should only be called by purple_account_connect() * in account.c. If you're trying to sign on an account, use that * function instead. * * @param account The account the connection should be connecting to. * @param regist Whether we are registering a new account or just * trying to do a normal signon. * @param password The password to use. */ void _purple_connection_new(PurpleAccount *account, gboolean regist, const char *password); /** * Tries to unregister the account on the server. If the account is not * connected, also creates a new connection. * * @note This function should only be called by purple_account_unregister() * in account.c. * * @param account The account to unregister * @param password The password to use. * @param cb Optional callback to be called when unregistration is complete * @param user_data user data to pass to the callback */ void _purple_connection_new_unregister(PurpleAccount *account, const char *password, PurpleAccountUnregistrationCb cb, void *user_data); /** * Disconnects and destroys a PurpleConnection. * * @note This function should only be called by purple_account_disconnect() * in account.c. If you're trying to sign off an account, use that * function instead. * * @param gc The purple connection to destroy. */ void _purple_connection_destroy(PurpleConnection *gc); #endif /* _PURPLE_INTERNAL_H_ */