annotate src/protocols/oscar/session.c @ 13255:f280bf585fb3

[gaim-migrate @ 15621] The file committer: Tailor Script <tailor@pidgin.im>
author Mark Doliner <mark@kingant.net>
date Sun, 12 Feb 2006 22:15:12 +0000
parents
children 3b04ab4d96db
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
13255
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
1 /*
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
2 * Gaim's oscar protocol plugin
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
3 * This file is the legal property of its developers.
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
4 * Please see the AUTHORS file distributed alongside this file.
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
5 *
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
6 * This library is free software; you can redistribute it and/or
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
7 * modify it under the terms of the GNU Lesser General Public
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
8 * License as published by the Free Software Foundation; either
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
9 * version 2 of the License, or (at your option) any later version.
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
10 *
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
11 * This library is distributed in the hope that it will be useful,
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
14 * Lesser General Public License for more details.
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
15 *
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
16 * You should have received a copy of the GNU Lesser General Public
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
17 * License along with this library; if not, write to the Free Software
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
19 */
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
20
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
21 #include "oscar.h"
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
22
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
23 /**
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
24 * Allocates a new OscarSession and initializes it with default values.
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
25 */
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
26 OscarSession *
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
27 oscar_session_new(void)
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
28 {
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
29 OscarSession *sess;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
30
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
31 sess = g_new(OscarSession, 1);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
32
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
33 sess->queue_outgoing = NULL;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
34 sess->queue_incoming = NULL;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
35 aim_initsnachash(sess);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
36 sess->msgcookies = NULL;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
37 sess->modlistv = NULL;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
38 sess->snacid_next = 0x00000001;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
39
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
40 sess->locate.userinfo = NULL;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
41 sess->locate.torequest = NULL;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
42 sess->locate.requested = NULL;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
43 sess->locate.waiting_for_response = FALSE;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
44 sess->ssi.received_data = 0;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
45 sess->ssi.numitems = 0;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
46 sess->ssi.official = NULL;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
47 sess->ssi.local = NULL;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
48 sess->ssi.pending = NULL;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
49 sess->ssi.timestamp = (time_t)0;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
50 sess->ssi.waiting_for_ack = 0;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
51 sess->icq_info = NULL;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
52 sess->authinfo = NULL;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
53 sess->emailinfo = NULL;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
54 sess->peer_connections = NULL;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
55
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
56 /*
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
57 * This must always be set. Default to the queue-based
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
58 * version for back-compatibility.
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
59 */
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
60 aim_tx_setenqueue(sess, AIM_TX_QUEUED, NULL);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
61
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
62 /*
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
63 * Register all the modules for this session...
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
64 */
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
65 aim__registermodule(sess, misc_modfirst); /* load the catch-all first */
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
66 aim__registermodule(sess, service_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
67 aim__registermodule(sess, locate_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
68 aim__registermodule(sess, buddylist_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
69 aim__registermodule(sess, msg_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
70 aim__registermodule(sess, adverts_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
71 aim__registermodule(sess, invite_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
72 aim__registermodule(sess, admin_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
73 aim__registermodule(sess, popups_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
74 aim__registermodule(sess, bos_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
75 aim__registermodule(sess, search_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
76 aim__registermodule(sess, stats_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
77 aim__registermodule(sess, translate_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
78 aim__registermodule(sess, chatnav_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
79 aim__registermodule(sess, chat_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
80 aim__registermodule(sess, odir_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
81 aim__registermodule(sess, bart_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
82 /* missing 0x11 - 0x12 */
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
83 aim__registermodule(sess, ssi_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
84 /* missing 0x14 */
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
85 aim__registermodule(sess, icq_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
86 /* missing 0x16 */
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
87 aim__registermodule(sess, auth_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
88 aim__registermodule(sess, email_modfirst);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
89
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
90 return sess;
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
91 }
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
92
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
93 /**
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
94 * Logoff and deallocate a session.
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
95 *
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
96 * @param sess Session to kill
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
97 */
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
98 void
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
99 oscar_session_destroy(OscarSession *sess)
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
100 {
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
101 aim_cleansnacs(sess, -1);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
102
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
103 while (sess->oscar_connections != NULL)
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
104 oscar_connection_destroy(sess, sess->oscar_connections->data);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
105
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
106 aim__shutdownmodules(sess);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
107
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
108 g_free(sess);
f280bf585fb3 [gaim-migrate @ 15621]
Mark Doliner <mark@kingant.net>
parents:
diff changeset
109 }