* @file internal.h Internal definitions and includes * 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 * 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_ /* for SIOCGIFCONF in SKYOS */ * 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. # define _(String) ((const char *)dgettext(PACKAGE, String)) # define N_(String) gettext_noop (String) # define N_(String) (String) # define N_(String) (String) # define _(String) ((const char *)String) # 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)) /* The above should normally be the same as BUF_LEN, * but just so we're explicitly asking for the max message #define BUF_LONG BUF_LEN * 2 #ifdef HAVE_LANGINFO_CODESET # include <sys/utsname.h> # define HOST_NAME_MAX 255 /* This wasn't introduced until Glib 2.14 :( */ # if GLIB_SIZEOF_LONG == 8 # define G_MAXSSIZE ((gssize) 0x7fffffffffffffff) # define G_MAXSSIZE ((gssize) 0x7fffffff) # define PURPLE_TIME_T_MODIFIER "lu" # define PURPLE_TIME_T_MODIFIER "zu" #error Unknown size of time_t /* 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/" /* 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. */ _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. */ _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. */ _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 * @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, * 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() * @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 * @param gc The purple connection to destroy. void _purple_connection_destroy(PurpleConnection *gc); #endif /* _PURPLE_INTERNAL_H_ */