6 * Copyright (C) 2010-11 SIPE Project <http://sipe.sourceforge.net/>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23 * Some notes on the history of this project/code/copyrights:
25 * - the project is called SIPE, but originally the code was only written
26 * for the libpurple framework, i.e. Pidgin. Hence the package name is
29 * - in the beginning almost all of the code was located in a module
30 * called "sipe.c". During the effort to remove the libpurple
31 * dependencies from the SIPE core, thousands of lines of code got
32 * shifted out of sipe.c, mostly to newly created modules and sipe.c
35 * - it would have been tedious to track down the original author or
36 * copyright and preserve them for each line of code that was moved.
37 * Therefore the new modules started with a fresh copyright notice
38 * (like the one above).
40 * - the original copyright notices from sipe.c have been moved to this
41 * file (see below) and *MUST* be preserved!
43 * - if necessary the author of a line of code in question can still be
44 * reconstructed from the git repository information.
45 * See also "man git-blame"
47 * - if you think your copyright should be restored for a piece of code,
48 * then please contact the SIPE project to fix the source files ASAP.
50 *------------------- Copyright notices from "sipe.c" ---------------
51 * Copyright (C) 2010-11 SIPE Project <http://sipe.sourceforge.net/>
52 * Copyright (C) 2009-10 pier11 <pier11@operamail.com>
53 * Copyright (C) 2008 Novell, Inc.
54 * Copyright (C) 2007-09 Anibal Avelar <debianmx@gmail.com>
55 * Copyright (C) 2005 Thomas Butter <butter@uni-mannheim.de>
58 * Thanks to Google's Summer of Code Program and the helpful mentors
60 *------------------- Copyright notices from "sipe.c" ---------------
72 #include "sipe-common.h"
75 #include "sip-transport.h"
76 #include "sipe-backend.h"
77 #include "sipe-buddy.h"
79 #include "sipe-certificate.h"
80 #include "sipe-chat.h"
81 #include "sipe-conf.h"
82 #include "sipe-core.h"
83 #include "sipe-core-private.h"
84 #include "sipe-crypt.h"
85 #include "sipe-group.h"
86 #include "sipe-groupchat.h"
87 #include "sipe-media.h"
88 #include "sipe-mime.h"
90 #include "sipe-ocs2007.h"
91 #include "sipe-schedule.h"
92 #include "sipe-session.h"
93 #include "sipe-status.h"
94 #include "sipe-subscriptions.h"
96 #include "sipe-utils.h"
98 /* locale_dir is unused if ENABLE_NLS is not defined */
99 void sipe_core_init(SIPE_UNUSED_PARAMETER
const char *locale_dir
)
105 SIPE_DEBUG_INFO("bindtextdomain = %s",
106 bindtextdomain(PACKAGE_NAME
, locale_dir
));
107 SIPE_DEBUG_INFO("bind_textdomain_codeset = %s",
108 bind_textdomain_codeset(PACKAGE_NAME
, "UTF-8"));
109 textdomain(PACKAGE_NAME
);
111 /* Initialization for crypto backend (production mode) */
112 sipe_crypto_init(TRUE
);
116 void sipe_core_destroy(void)
119 sipe_mime_shutdown();
120 sipe_crypto_shutdown();
124 gchar
*sipe_core_about(void)
126 return g_strdup_printf(
128 * Non-translatable parts, like markup, are hard-coded
129 * into the format string. This requires more translatable
130 * texts but it makes the translations less error prone.
132 "<b><font size=\"+1\">SIPE " PACKAGE_VERSION
" </font></b><br/>"
135 "<li> - MS Office Communications Server 2007 R2</li><br/>"
136 "<li> - MS Office Communications Server 2007</li><br/>"
137 "<li> - MS Live Communications Server 2005</li><br/>"
138 "<li> - MS Live Communications Server 2003</li><br/>"
139 "<li> - Reuters Messaging</li><br/>"
141 /* 2 */ "%s: <a href=\"" PACKAGE_URL
"\">" PACKAGE_URL
"</a><br/>"
142 /* 3,4 */ "%s: <a href=\"http://sourceforge.net/projects/sipe/forums/forum/688534\">%s</a><br/>"
143 /* 5,6 */ "%s: <a href=\"" PACKAGE_BUGREPORT
"\">%s</a><br/>"
144 /* 7 */ "%s: <a href=\"" SIPE_TRANSLATIONS_URL
"\">Transifex.net</a><br/>"
145 /* 8 */ "%s: GPLv2+<br/>"
149 " - Reuters Messaging network<br/>"
150 " - Deutsche Bank<br/>"
151 " - Merrill Lynch<br/>"
160 " - Alcatel-Lucent<br/>"
163 /* 10,11 */ "%s<a href=\"" SIPE_TRANSLATIONS_URL
"\">Transifex.net</a>%s.<br/>"
165 /* 12 */ "<b>%s:</b><br/>"
166 " - Anibal Avelar<br/>"
167 " - Gabriel Burt<br/>"
168 " - Stefan Becker<br/>"
171 " - Tomáš Hrabčík<br/>"
175 /* The next 13 texts make up the SIPE about note text */
176 /* About note, part 1/13: introduction */
177 _("A third-party plugin implementing extended version of SIP/SIMPLE used by various products"),
178 /* About note, part 2/13: home page URL (label) */
180 /* About note, part 3/13: support forum URL (label) */
182 /* About note, part 4/13: support forum name (hyperlink text) */
184 /* About note, part 5/13: bug tracker URL (label) */
185 _("Report Problems"),
186 /* About note, part 6/13: bug tracker URL (hyperlink text) */
188 /* About note, part 7/13: translation service URL (label) */
190 /* About note, part 8/13: license type (label) */
192 /* About note, part 9/13: known users */
193 _("We support users in such organizations as"),
194 /* About note, part 10/13: translation request, text before Transifex.net URL */
195 /* append a space if text is not empty */
196 _("Please help us to translate SIPE to your native language here at "),
197 /* About note, part 11/13: translation request, text after Transifex.net URL */
198 /* start with a space if text is not empty */
199 _(" using convenient web interface"),
200 /* About note, part 12/13: author list (header) */
202 /* About note, part 13/13: Localization credit */
203 /* PLEASE NOTE: do *NOT* simply translate the english original */
204 /* but write something similar to the following sentence: */
205 /* "Localization for <language name> (<language code>): <name>" */
206 _("Original texts in English (en): SIPE developers")
210 static guint
sipe_ht_hash_nick(const char *nick
)
212 char *lc
= g_utf8_strdown(nick
, -1);
213 guint bucket
= g_str_hash(lc
);
219 static gboolean
sipe_ht_equals_nick(const char *nick1
, const char *nick2
)
221 char *nick1_norm
= NULL
;
222 char *nick2_norm
= NULL
;
225 if (nick1
== NULL
&& nick2
== NULL
) return TRUE
;
226 if (nick1
== NULL
|| nick2
== NULL
||
227 !g_utf8_validate(nick1
, -1, NULL
) ||
228 !g_utf8_validate(nick2
, -1, NULL
)) return FALSE
;
230 nick1_norm
= g_utf8_casefold(nick1
, -1);
231 nick2_norm
= g_utf8_casefold(nick2
, -1);
232 equal
= g_utf8_collate(nick1_norm
, nick2_norm
) == 0;
239 struct sipe_core_public
*sipe_core_allocate(const gchar
*signin_name
,
240 const gchar
*login_domain
,
241 const gchar
*login_account
,
242 const gchar
*password
,
244 const gchar
*email_url
,
245 const gchar
**errmsg
)
247 struct sipe_core_private
*sipe_private
;
250 SIPE_DEBUG_INFO("sipe_core_allocate: signin_name '%s'", signin_name
);
252 /* ensure that sign-in name doesn't contain invalid characters */
253 if (strpbrk(signin_name
, "\t\v\r\n") != NULL
) {
254 *errmsg
= _("SIP Exchange user name contains invalid characters");
258 /* ensure that sign-in name format is name@domain */
259 if (!strchr(signin_name
, '@') ||
260 g_str_has_prefix(signin_name
, "@") ||
261 g_str_has_suffix(signin_name
, "@")) {
262 *errmsg
= _("User name should be a valid SIP URI\nExample: user@company.com");
266 /* ensure that email format is name@domain (if provided) */
267 if (!is_empty(email
) &&
268 (!strchr(email
, '@') ||
269 g_str_has_prefix(email
, "@") ||
270 g_str_has_suffix(email
, "@")))
272 *errmsg
= _("Email address should be valid if provided\nExample: user@company.com");
276 /* ensure that user name doesn't contain spaces */
277 user_domain
= g_strsplit(signin_name
, "@", 2);
278 SIPE_DEBUG_INFO("sipe_core_allocate: user '%s' domain '%s'", user_domain
[0], user_domain
[1]);
279 if (strchr(user_domain
[0], ' ') != NULL
) {
280 g_strfreev(user_domain
);
281 *errmsg
= _("SIP Exchange user name contains whitespace");
285 /* ensure that email_url is in proper format if enabled (if provided).
286 * Example (Exchange): https://server.company.com/EWS/Exchange.asmx
287 * Example (Domino) : https://[domino_server]/[mail_database_name].nsf
289 if (!is_empty(email_url
)) {
290 char *tmp
= g_ascii_strdown(email_url
, -1);
291 if (!g_str_has_prefix(tmp
, "https://"))
294 g_strfreev(user_domain
);
295 *errmsg
= _("Email services URL should be valid if provided\n"
296 "Example: https://exchange.corp.com/EWS/Exchange.asmx\n"
297 "Example: https://domino.corp.com/maildatabase.nsf");
303 sipe_private
= g_new0(struct sipe_core_private
, 1);
304 SIPE_CORE_PRIVATE_FLAG_UNSET(SUBSCRIBED_BUDDIES
);
305 SIPE_CORE_PRIVATE_FLAG_UNSET(INITIAL_PUBLISH
);
306 sipe_private
->username
= g_strdup(signin_name
);
307 sipe_private
->email
= is_empty(email
) ? g_strdup(signin_name
) : g_strdup(email
);
308 sipe_private
->authdomain
= is_empty(login_domain
) ? NULL
: g_strdup(login_domain
);
309 sipe_private
->authuser
= is_empty(login_account
) ? NULL
: g_strdup(login_account
);
310 sipe_private
->password
= g_strdup(password
);
311 sipe_private
->public.sip_name
= g_strdup(user_domain
[0]);
312 sipe_private
->public.sip_domain
= g_strdup(user_domain
[1]);
313 g_strfreev(user_domain
);
315 sipe_private
->buddies
= g_hash_table_new((GHashFunc
)sipe_ht_hash_nick
, (GEqualFunc
)sipe_ht_equals_nick
);
316 sipe_private
->our_publications
= g_hash_table_new_full(g_str_hash
, g_str_equal
,
317 g_free
, (GDestroyNotify
)g_hash_table_destroy
);
318 sipe_subscriptions_init(sipe_private
);
319 sipe_status_set_activity(sipe_private
, SIPE_ACTIVITY_UNSET
);
321 return((struct sipe_core_public
*)sipe_private
);
324 void sipe_core_connection_cleanup(struct sipe_core_private
*sipe_private
)
326 g_free(sipe_private
->epid
);
327 sipe_private
->epid
= NULL
;
329 sip_transport_disconnect(sipe_private
);
331 sipe_schedule_cancel_all(sipe_private
);
333 if (sipe_private
->allowed_events
) {
334 GSList
*entry
= sipe_private
->allowed_events
;
340 g_slist_free(sipe_private
->allowed_events
);
342 sipe_ocs2007_free(sipe_private
);
344 sipe_core_buddy_menu_free(SIPE_CORE_PUBLIC
);
346 if (sipe_private
->contact
)
347 g_free(sipe_private
->contact
);
348 sipe_private
->contact
= NULL
;
349 if (sipe_private
->register_callid
)
350 g_free(sipe_private
->register_callid
);
351 sipe_private
->register_callid
= NULL
;
353 if (sipe_private
->focus_factory_uri
)
354 g_free(sipe_private
->focus_factory_uri
);
355 sipe_private
->focus_factory_uri
= NULL
;
357 if (sipe_private
->calendar
) {
358 sipe_cal_calendar_free(sipe_private
->calendar
);
360 sipe_private
->calendar
= NULL
;
362 sipe_groupchat_free(sipe_private
);
365 void sipe_core_deallocate(struct sipe_core_public
*sipe_public
)
367 struct sipe_core_private
*sipe_private
= SIPE_CORE_PRIVATE
;
370 if (sipe_private
->media_call
) {
371 sipe_media_handle_going_offline(sipe_private
->media_call
);
375 /* leave all conversations */
376 if (sipe_private
->sessions
) {
378 while ((entry
= sipe_private
->sessions
) != NULL
) {
379 sipe_session_close(sipe_private
, entry
->data
);
383 sipe_conf_cancel_unaccepted(sipe_private
, NULL
);
385 if (sipe_private
->csta
) {
386 sip_csta_close(sipe_private
);
389 sipe_certificate_free(sipe_private
);
390 sipe_svc_free(sipe_private
);
392 if (sipe_backend_connection_is_valid(SIPE_CORE_PUBLIC
)) {
393 sipe_subscriptions_unsubscribe(sipe_private
);
394 sip_transport_deregister(sipe_private
);
397 sipe_core_connection_cleanup(sipe_private
);
398 g_free(sipe_private
->public.sip_name
);
399 g_free(sipe_private
->public.sip_domain
);
400 g_free(sipe_private
->username
);
401 g_free(sipe_private
->email
);
402 g_free(sipe_private
->password
);
403 g_free(sipe_private
->authdomain
);
404 g_free(sipe_private
->authuser
);
405 g_free(sipe_private
->status
);
406 g_free(sipe_private
->note
);
407 g_free(sipe_private
->ocs2005_user_states
);
409 sipe_buddy_free_all(sipe_private
);
410 g_hash_table_destroy(sipe_private
->buddies
);
411 g_hash_table_destroy(sipe_private
->our_publications
);
412 g_hash_table_destroy(sipe_private
->user_state_publications
);
413 sipe_subscriptions_destroy(sipe_private
);
415 if (sipe_private
->groups
) {
416 GSList
*entry
= sipe_private
->groups
;
418 struct sipe_group
*group
= entry
->data
;
424 g_slist_free(sipe_private
->groups
);
426 if (sipe_private
->our_publication_keys
) {
427 GSList
*entry
= sipe_private
->our_publication_keys
;
433 g_slist_free(sipe_private
->our_publication_keys
);
436 g_free(sipe_private
->mras_uri
);
437 g_free(sipe_private
->media_relay_username
);
438 g_free(sipe_private
->media_relay_password
);
439 sipe_media_relay_list_free(sipe_private
->media_relays
);
442 g_free(sipe_private
);