pidgin  2.14.10
internal.h
Go to the documentation of this file.
1 
6 /* purple
7  *
8  * Purple is the legal property of its developers, whose names are too numerous
9  * to list here. Please refer to the COPYRIGHT file distributed with this
10  * source distribution.
11  *
12  * This program is free software; you can redistribute it and/or modify
13  * it under the terms of the GNU General Public License as published by
14  * the Free Software Foundation; either version 2 of the License, or
15  * (at your option) any later version.
16  *
17  * This program is distributed in the hope that it will be useful,
18  * but WITHOUT ANY WARRANTY; without even the implied warranty of
19  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20  * GNU General Public License for more details.
21  *
22  * You should have received a copy of the GNU General Public License
23  * along with this program; if not, write to the Free Software
24  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
25  */
26 #ifndef _PURPLE_INTERNAL_H_
27 #define _PURPLE_INTERNAL_H_
28 
29 #ifdef HAVE_CONFIG_H
30 # include <config.h>
31 #endif
32 
33 /* for SIOCGIFCONF in SKYOS */
34 #ifdef SKYOS
35 #include <net/sockios.h>
36 #endif
37 /*
38  * If we're using NLS, make sure gettext works. If not, then define
39  * dummy macros in place of the normal gettext macros.
40  *
41  * Also, the perl XS config.h file sometimes defines _ So we need to
42  * make sure _ isn't already defined before trying to define it.
43  *
44  * The Singular/Plural/Number ngettext dummy definition below was
45  * taken from an email to the texinfo mailing list by Manuel Guerrero.
46  * Thank you Manuel, and thank you Alex's good friend Google.
47  */
48 #ifdef ENABLE_NLS
49 # include <locale.h>
50 # include <libintl.h>
51 # define _(String) ((const char *)dgettext(PACKAGE, String))
52 # ifdef gettext_noop
53 # define N_(String) gettext_noop (String)
54 # else
55 # define N_(String) (String)
56 # endif
57 #else
58 # include <locale.h>
59 # define N_(String) (String)
60 # ifndef _
61 # define _(String) ((const char *)String)
62 # endif
63 # define ngettext(Singular, Plural, Number) ((Number == 1) ? ((const char *)Singular) : ((const char *)Plural))
64 # define dngettext(Domain, Singular, Plural, Number) ((Number == 1) ? ((const char *)Singular) : ((const char *)Plural))
65 #endif
66 
67 #ifdef HAVE_ENDIAN_H
68 # include <endian.h>
69 #endif
70 
71 #define MSG_LEN 2048
72 /* The above should normally be the same as BUF_LEN,
73  * but just so we're explicitly asking for the max message
74  * length. */
75 #define BUF_LEN MSG_LEN
76 #define BUF_LONG BUF_LEN * 2
77 
78 #include <sys/stat.h>
79 #include <sys/types.h>
80 #ifndef _WIN32
81 #include <sys/time.h>
82 #include <sys/wait.h>
83 #include <sys/time.h>
84 #endif
85 #include <ctype.h>
86 #include <errno.h>
87 #include <fcntl.h>
88 #include <math.h>
89 #include <stdio.h>
90 #include <stdlib.h>
91 #include <string.h>
92 #include <time.h>
93 
94 #ifdef HAVE_ICONV
95 #include <iconv.h>
96 #endif
97 
98 #ifdef HAVE_LANGINFO_CODESET
99 #include <langinfo.h>
100 #endif
101 
102 #include <gmodule.h>
103 
104 #ifdef PURPLE_PLUGINS
105 # ifdef HAVE_DLFCN_H
106 # include <dlfcn.h>
107 # endif
108 #endif
109 
110 #ifndef _WIN32
111 # include <netinet/in.h>
112 # include <sys/socket.h>
113 # include <arpa/inet.h>
114 # include <sys/un.h>
115 # include <sys/utsname.h>
116 # include <netdb.h>
117 # include <signal.h>
118 # include <unistd.h>
119 #endif
120 
121 #ifndef HOST_NAME_MAX
122 # define HOST_NAME_MAX 255
123 #endif
124 
125 #include <glib.h>
126 
127 #include "glibcompat.h"
128 
129 #include <glib/gstdio.h>
130 
131 #ifdef _WIN32
132 #include "win32dep.h"
133 #endif
134 
135 #ifdef HAVE_CONFIG_H
136 #if SIZEOF_TIME_T == 4
137 # define PURPLE_TIME_T_MODIFIER "lu"
138 #elif SIZEOF_TIME_T == 8
139 # define PURPLE_TIME_T_MODIFIER "zu"
140 #else
141 #error Unknown size of time_t
142 #endif
143 #endif
144 
145 #include <glib-object.h>
146 
147 #ifdef __COVERITY__
148 
149 /* avoid TAINTED_SCALAR warning */
150 #undef g_utf8_next_char
151 #define g_utf8_next_char(p) (char *)((p) + 1)
152 
153 #endif
154 
155 /* Safer ways to work with static buffers. When using non-static
156  * buffers, either use g_strdup_* functions (preferred) or use
157  * g_strlcpy/g_strlcpy directly. */
158 #define purple_strlcpy(dest, src) g_strlcpy(dest, src, sizeof(dest))
159 #define purple_strlcat(dest, src) g_strlcat(dest, src, sizeof(dest))
160 
161 typedef union
162 {
163  struct sockaddr sa;
164  struct sockaddr_in in;
165  struct sockaddr_in6 in6;
166  struct sockaddr_storage storage;
168 
169 #define PURPLE_WEBSITE "https://pidgin.im/"
170 #define PURPLE_DEVEL_WEBSITE "https://pidgin.im/development/"
171 
172 
173 /* INTERNAL FUNCTIONS */
174 
175 #include "account.h"
176 #include "connection.h"
177 
178 /* This is for the accounts code to notify the buddy icon code that
179  * it's done loading. We may want to replace this with a signal. */
180 void
181 _purple_buddy_icons_account_loaded_cb(void);
182 
183 /* This is for the buddy list to notify the buddy icon code that
184  * it's done loading. We may want to replace this with a signal. */
185 void
186 _purple_buddy_icons_blist_loaded_cb(void);
187 
188 /* This is for the purple_core_migrate() code to tell the buddy
189  * icon subsystem about the old icons directory so it can
190  * migrate any icons in use. */
191 void
192 _purple_buddy_icon_set_old_icons_dir(const char *dirname);
193 
211 void _purple_connection_new(PurpleAccount *account, gboolean regist,
212  const char *password);
225 void _purple_connection_new_unregister(PurpleAccount *account, const char *password,
226  PurpleAccountUnregistrationCb cb, void *user_data);
237 
245 gboolean
247 
248 #endif /* _PURPLE_INTERNAL_H_ */
Account API.
Connection API.
Compatibility for many glib versions.
void _purple_connection_new_unregister(PurpleAccount *account, const char *password, PurpleAccountUnregistrationCb cb, void *user_data)
Tries to unregister the account on the server.
gboolean _purple_network_set_common_socket_flags(int fd)
Sets most commonly used socket flags: O_NONBLOCK and FD_CLOEXEC.
void _purple_connection_new(PurpleAccount *account, gboolean regist, const char *password)
Creates a connection to the specified account and either connects or attempts to register a new accou...
void _purple_connection_destroy(PurpleConnection *gc)
Disconnects and destroys a PurpleConnection.
Structure representing an account.
Definition: account.h:170