Mercurial > pidgin
view libpurple/internal.h @ 30915:d9db23719cf9
merge of '148e99c7c4a60cc18826232bd8b3270cbdddc7b5'
and '89847795e1c9cbdd51c942ae1e506e6060ac2235'
author | Daniel Atallah <daniel.atallah@gmail.com> |
---|---|
date | Mon, 08 Nov 2010 22:51:35 +0000 |
parents | 39716f7d2c93 |
children | f2e0b8f38e14 da81195f635e |
line wrap: on
line source
/** * @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 <config.h> #endif /* for SIOCGIFCONF in SKYOS */ #ifdef SKYOS #include <net/sockios.h> #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 <locale.h> # include <libintl.h> # define _(String) ((const char *)dgettext(PACKAGE, String)) # ifdef gettext_noop # define N_(String) gettext_noop (String) # else # define N_(String) (String) # endif #else # include <locale.h> # 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 <endian.h> #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 <sys/stat.h> #include <sys/types.h> #ifndef _WIN32 #include <sys/time.h> #include <sys/wait.h> #include <sys/time.h> #endif #include <ctype.h> #include <errno.h> #include <fcntl.h> #include <math.h> #include <stdio.h> #include <stdlib.h> #include <string.h> #include <time.h> #ifdef HAVE_ICONV #include <iconv.h> #endif #ifdef HAVE_LANGINFO_CODESET #include <langinfo.h> #endif #include <gmodule.h> #ifdef PURPLE_PLUGINS # ifdef HAVE_DLFCN_H # include <dlfcn.h> # endif #endif #ifndef _WIN32 # include <netinet/in.h> # include <sys/socket.h> # include <arpa/inet.h> # include <sys/un.h> # include <sys/utsname.h> # include <netdb.h> # include <signal.h> # include <unistd.h> #endif #ifndef HOST_NAME_MAX # define HOST_NAME_MAX 255 #endif #include <glib.h> /* This wasn't introduced until Glib 2.14 :( */ #ifndef G_MAXSSIZE # if GLIB_SIZEOF_LONG == 8 # define G_MAXSSIZE ((gssize) 0x7fffffffffffffff) # else # define G_MAXSSIZE ((gssize) 0x7fffffff) # endif #endif #include <glib/gstdio.h> #ifdef _WIN32 #include "win32dep.h" #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 <glib-object.h> /* 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_ */