* @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 #define PURPLE_WEBSITE "https://pidgin.im/" #define PURPLE_DEVEL_WEBSITE "https://developer.pidgin.im/" * Sets an error for an account. * @param account The account to set the error for. * @param new_err The #PurpleConnectionErrorInfo instance representing the void _purple_account_set_current_error(PurpleAccount *account, PurpleConnectionErrorInfo *new_err); * Get an XML description of an account. * @param account The account * @return The XML description of the account. PurpleXmlNode *_purple_account_to_xmlnode(PurpleAccount *account); * Returns the last child of a particular node. * @param node The node whose last child is to be retrieved. * @return The last child of the node. PurpleBlistNode *_purple_blist_get_last_child(PurpleBlistNode *node); /* 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); * 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); * Checks if a connection is disconnecting, and should not attempt to reconnect. * @note This function should only be called by purple_account_set_enabled() * @param gc The connection to check gboolean _purple_connection_wants_to_die(const PurpleConnection *gc); * Adds a chat to the active chats list of a connection * @note This function should only be called by serv_got_joined_chat() * @param gc The connection * @param chat The chat conversation to add void _purple_connection_add_active_chat(PurpleConnection *gc, PurpleChatConversation *chat); * Removes a chat from the active chats list of a connection * @note This function should only be called by serv_got_chat_left() * @param gc The connection * @param chat The chat conversation to remove void _purple_connection_remove_active_chat(PurpleConnection *gc, PurpleChatConversation *chat); * Returns the primitive scores array from status.c. * @note This function should only be called by * purple_buddy_presence_compute_score() in presence.c. int *_purple_statuses_get_primitive_scores(void); #endif /* _PURPLE_INTERNAL_H_ */