source: skype/skype.c @ 8bbe52a

Last change on this file since 8bbe52a was 8bbe52a, checked in by Miklos Vajna <vmiklos@…>, at 2009-01-07T01:11:44Z

cleanup in skype_parse_users()

  • Property mode set to 100644
File size: 34.4 KB
Line 
1/*
2 *  skype.c - Skype plugin for BitlBee
3 *
4 *  Copyright (c) 2007, 2008, 2009 by Miklos Vajna <vmiklos@frugalware.org>
5 *
6 *  Several ideas are used from the BitlBee Jabber plugin, which is
7 *
8 *  Copyright (c) 2006 by Wilmer van der Gaast <wilmer@gaast.net>
9 *
10 *  This program is free software; you can redistribute it and/or modify
11 *  it under the terms of the GNU General Public License as published by
12 *  the Free Software Foundation; either version 2 of the License, or
13 *  (at your option) any later version.
14 *
15 *  This program is distributed in the hope that it will be useful,
16 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
17 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18 *  GNU General Public License for more details.
19 *
20 *  You should have received a copy of the GNU General Public License
21 *  along with this program; if not, write to the Free Software
22 *  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
23 *  USA.
24 */
25
26#define _XOPEN_SOURCE
27#include <stdio.h>
28#include <poll.h>
29#include <bitlbee.h>
30#include <bitlbee/ssl_client.h>
31#include <glib.h>
32
33#define SKYPE_DEFAULT_SERVER "localhost"
34#define SKYPE_DEFAULT_PORT "2727"
35
36/*
37 * Enumerations
38 */
39
40enum {
41        SKYPE_CALL_RINGING = 1,
42        SKYPE_CALL_MISSED,
43        SKYPE_CALL_CANCELLED,
44        SKYPE_CALL_FINISHED,
45        SKYPE_CALL_REFUSED
46} skype_call_status;
47
48enum {
49        SKYPE_FILETRANSFER_NEW = 1,
50        SKYPE_FILETRANSFER_FAILED
51} skype_filetransfer_status;
52
53/*
54 * Structures
55 */
56
57struct skype_data {
58        struct im_connection *ic;
59        char *username;
60        /* The effective file descriptor. We store it here so any function can
61         * write() to it. */
62        int fd;
63        /* File descriptor returned by bitlbee. we store it so we know when
64         * we're connected and when we aren't. */
65        int bfd;
66        /* ssl_getfd() uses this to get the file desciptor. */
67        void *ssl;
68        /* When we receive a new message id, we query the properties, finally
69         * the chatname. Store the properties here so that we can use
70         * imcb_buddy_msg() when we got the chatname. */
71        char *handle;
72        /* List, because of multiline messages. */
73        GList *body;
74        char *type;
75        /* This is necessary because we send a notification when we get the
76         * handle. So we store the state here and then we can send a
77         * notification about the handle is in a given status. */
78        int call_status;
79        char *call_id;
80        char *call_duration;
81        /* If the call is outgoing or not */
82        int call_out;
83        /* Same for file transfers. */
84        int filetransfer_status;
85        /* Using /j #nick we want to have a groupchat with two people. Usually
86         * not (default). */
87        char *groupchat_with;
88        /* The user who invited us to the chat. */
89        char *adder;
90        /* If we are waiting for a confirmation about we changed the topic. */
91        int topic_wait;
92        /* These are used by the info command. */
93        char *info_fullname;
94        char *info_phonehome;
95        char *info_phoneoffice;
96        char *info_phonemobile;
97        char *info_nrbuddies;
98        char *info_tz;
99        char *info_seen;
100        char *info_birthday;
101        char *info_sex;
102        char *info_language;
103        char *info_country;
104        char *info_province;
105        char *info_city;
106        char *info_homepage;
107        char *info_about;
108        /* When a call fails, we get the reason and later we get the failure
109         * event, so store the failure code here till then */
110        int failurereason;
111};
112
113struct skype_away_state {
114        char *code;
115        char *full_name;
116};
117
118struct skype_buddy_ask_data {
119        struct im_connection *ic;
120        /* This is also used for call IDs for simplicity */
121        char *handle;
122};
123
124/*
125 * Tables
126 */
127
128const struct skype_away_state skype_away_state_list[] = {
129        { "ONLINE",  "Online" },
130        { "SKYPEME",  "Skype Me" },
131        { "AWAY",   "Away" },
132        { "NA",    "Not available" },
133        { "DND",      "Do Not Disturb" },
134        { "INVISIBLE",      "Invisible" },
135        { "OFFLINE",      "Offline" },
136        { NULL, NULL}
137};
138
139/*
140 * Functions
141 */
142
143int skype_write(struct im_connection *ic, char *buf)
144{
145        struct skype_data *sd = ic->proto_data;
146        struct pollfd pfd[1];
147        int len = strlen(buf);
148
149        pfd[0].fd = sd->fd;
150        pfd[0].events = POLLOUT;
151
152        /* This poll is necessary or we'll get a SIGPIPE when we write() to
153         * sd->fd. */
154        poll(pfd, 1, 1000);
155        if (pfd[0].revents & POLLHUP) {
156                imc_logout(ic, TRUE);
157                return FALSE;
158        }
159        ssl_write(sd->ssl, buf, len);
160
161        return TRUE;
162}
163
164static void skype_buddy_ask_yes(void *data)
165{
166        struct skype_buddy_ask_data *bla = data;
167        char *buf = g_strdup_printf("SET USER %s ISAUTHORIZED TRUE",
168                bla->handle);
169        skype_write(bla->ic, buf);
170        g_free(buf);
171        g_free(bla->handle);
172        g_free(bla);
173}
174
175static void skype_buddy_ask_no(void *data)
176{
177        struct skype_buddy_ask_data *bla = data;
178        char *buf = g_strdup_printf("SET USER %s ISAUTHORIZED FALSE",
179                bla->handle);
180        skype_write(bla->ic, buf);
181        g_free(buf);
182        g_free(bla->handle);
183        g_free(bla);
184}
185
186void skype_buddy_ask(struct im_connection *ic, char *handle, char *message)
187{
188        struct skype_buddy_ask_data *bla = g_new0(struct skype_buddy_ask_data,
189                1);
190        char *buf;
191
192        bla->ic = ic;
193        bla->handle = g_strdup(handle);
194
195        buf = g_strdup_printf("The user %s wants to add you to "
196                "his/her buddy list, saying: '%s'.", handle, message);
197        imcb_ask(ic, buf, bla, skype_buddy_ask_yes, skype_buddy_ask_no);
198        g_free(buf);
199}
200
201static void skype_call_ask_yes(void *data)
202{
203        struct skype_buddy_ask_data *bla = data;
204        char *buf = g_strdup_printf("SET CALL %s STATUS INPROGRESS",
205                bla->handle);
206        skype_write(bla->ic, buf);
207        g_free(buf);
208        g_free(bla->handle);
209        g_free(bla);
210}
211
212static void skype_call_ask_no(void *data)
213{
214        struct skype_buddy_ask_data *bla = data;
215        char *buf = g_strdup_printf("SET CALL %s STATUS FINISHED",
216                bla->handle);
217        skype_write(bla->ic, buf);
218        g_free(buf);
219        g_free(bla->handle);
220        g_free(bla);
221}
222
223void skype_call_ask(struct im_connection *ic, char *call_id, char *message)
224{
225        struct skype_buddy_ask_data *bla = g_new0(struct skype_buddy_ask_data,
226                1);
227
228        bla->ic = ic;
229        bla->handle = g_strdup(call_id);
230
231        imcb_ask(ic, message, bla, skype_call_ask_yes, skype_call_ask_no);
232}
233struct groupchat *skype_chat_by_name(struct im_connection *ic, char *name)
234{
235        struct groupchat *ret;
236
237        for (ret = ic->groupchats; ret; ret = ret->next)
238                if (strcmp(name, ret->title) == 0)
239                        break;
240
241        return ret;
242}
243
244static char *skype_call_strerror(int err)
245{
246        switch (err) {
247        case 1:
248                return "Miscellaneous error";
249        case 2:
250                return "User or phone number does not exist.";
251        case 3:
252                return "User is offline";
253        case 4:
254                return "No proxy found";
255        case 5:
256                return "Session terminated.";
257        case 6:
258                return "No common codec found.";
259        case 7:
260                return "Sound I/O error.";
261        case 8:
262                return "Problem with remote sound device.";
263        case 9:
264                return "Call blocked by recipient.";
265        case 10:
266                return "Recipient not a friend.";
267        case 11:
268                return "Current user not authorized by recipient.";
269        case 12:
270                return "Sound recording error.";
271        default:
272                return "Unknown error";
273        }
274}
275
276static void skype_parse_users(struct im_connection *ic, char *line)
277{
278        char **i, **nicks, *ptr;
279
280        nicks = g_strsplit(line + 6, ", ", 0);
281        for (i = nicks; *i; i++) {
282                ptr = g_strdup_printf("GET USER %s ONLINESTATUS\n", *i);
283                skype_write(ic, ptr);
284                g_free(ptr);
285        }
286        g_strfreev(nicks);
287}
288
289static gboolean skype_read_callback(gpointer data, gint fd,
290                                    b_input_condition cond)
291{
292        struct im_connection *ic = data;
293        struct skype_data *sd = ic->proto_data;
294        char buf[1024];
295        int st;
296        char **lines, **lineptr, *line, *ptr;
297
298        if (!sd || sd->fd == -1)
299                return FALSE;
300        /* Read the whole data. */
301        st = ssl_read(sd->ssl, buf, sizeof(buf));
302        if (st > 0) {
303                buf[st] = '\0';
304                /* Then split it up to lines. */
305                lines = g_strsplit(buf, "\n", 0);
306                lineptr = lines;
307                while ((line = *lineptr)) {
308                        if (!strlen(line))
309                                break;
310                        if (set_getbool(&ic->acc->set, "skypeconsole_receive"))
311                                imcb_buddy_msg(ic, "skypeconsole", line, 0, 0);
312                        if (!strncmp(line, "USERS ", 6))
313                                skype_parse_users(ic, line);
314                        else if (!strncmp(line, "USER ", 5)) {
315                                int flags = 0;
316                                char *status = strrchr(line, ' ');
317                                char *user = strchr(line, ' ');
318                                status++;
319                                ptr = strchr(++user, ' ');
320                                *ptr = '\0';
321                                ptr++;
322                                if (!strncmp(ptr, "ONLINESTATUS ", 13) &&
323                                                strcmp(user, sd->username) != 0
324                                                && strcmp(user, "echo123") != 0) {
325                                        ptr = g_strdup_printf("%s@skype.com", user);
326                                        imcb_add_buddy(ic, ptr, NULL);
327                                        if (strcmp(status, "OFFLINE") && (strcmp(status, "SKYPEOUT") || !set_getbool(&ic->acc->set, "skypeout_offline")))
328                                                flags |= OPT_LOGGED_IN;
329                                        if (strcmp(status, "ONLINE") != 0 && strcmp(status, "SKYPEME") != 0)
330                                                flags |= OPT_AWAY;
331                                        imcb_buddy_status(ic, ptr, flags, NULL, NULL);
332                                        g_free(ptr);
333                                } else if (!strncmp(ptr, "RECEIVEDAUTHREQUEST ", 20)) {
334                                        char *message = ptr + 20;
335                                        if (strlen(message))
336                                                skype_buddy_ask(ic, user, message);
337                                } else if (!strncmp(ptr, "BUDDYSTATUS ", 12)) {
338                                        char *st = ptr + 12;
339                                        if (!strcmp(st, "3")) {
340                                                char *buf = g_strdup_printf("%s@skype.com", user);
341                                                imcb_add_buddy(ic, buf, NULL);
342                                                g_free(buf);
343                                        }
344                                } else if (!strncmp(ptr, "FULLNAME ", 9))
345                                        sd->info_fullname = g_strdup_printf("%s", ptr + 9);
346                                else if (!strncmp(ptr, "PHONE_HOME ", 11))
347                                        sd->info_phonehome = g_strdup_printf("%s", ptr + 11);
348                                else if (!strncmp(ptr, "PHONE_OFFICE ", 13))
349                                        sd->info_phoneoffice = g_strdup_printf("%s", ptr + 13);
350                                else if (!strncmp(ptr, "PHONE_MOBILE ", 13))
351                                        sd->info_phonemobile = g_strdup_printf("%s", ptr + 13);
352                                else if (!strncmp(ptr, "NROF_AUTHED_BUDDIES ", 20))
353                                        sd->info_nrbuddies = g_strdup_printf("%s", ptr + 20);
354                                else if (!strncmp(ptr, "TIMEZONE ", 9))
355                                        sd->info_tz = g_strdup_printf("%s", ptr + 9);
356                                else if (!strncmp(ptr, "LASTONLINETIMESTAMP ", 20))
357                                        sd->info_seen = g_strdup_printf("%s", ptr + 20);
358                                else if (!strncmp(ptr, "BIRTHDAY ", 9))
359                                        sd->info_birthday = g_strdup_printf("%s", ptr + 9);
360                                else if (!strncmp(ptr, "SEX ", 4))
361                                        sd->info_sex = g_strdup_printf("%s", ptr + 4);
362                                else if (!strncmp(ptr, "LANGUAGE ", 9))
363                                        sd->info_language = g_strdup_printf("%s", ptr + 9);
364                                else if (!strncmp(ptr, "COUNTRY ", 8))
365                                        sd->info_country = g_strdup_printf("%s", ptr + 8);
366                                else if (!strncmp(ptr, "PROVINCE ", 9))
367                                        sd->info_province = g_strdup_printf("%s", ptr + 9);
368                                else if (!strncmp(ptr, "CITY ", 5))
369                                        sd->info_city = g_strdup_printf("%s", ptr + 5);
370                                else if (!strncmp(ptr, "HOMEPAGE ", 9))
371                                        sd->info_homepage = g_strdup_printf("%s", ptr + 9);
372                                else if (!strncmp(ptr, "ABOUT ", 6)) {
373                                        sd->info_about = g_strdup_printf("%s", ptr + 6);
374
375                                        GString *st = g_string_new("Contact Information\n");
376                                        g_string_append_printf(st, "Skype Name: %s\n", user);
377                                        if (sd->info_fullname) {
378                                                if (strlen(sd->info_fullname))
379                                                        g_string_append_printf(st, "Full Name: %s\n", sd->info_fullname);
380                                                g_free(sd->info_fullname);
381                                        }
382                                        if (sd->info_phonehome) {
383                                                if (strlen(sd->info_phonehome))
384                                                        g_string_append_printf(st, "Home Phone: %s\n", sd->info_phonehome);
385                                                g_free(sd->info_phonehome);
386                                        }
387                                        if (sd->info_phoneoffice) {
388                                                if (strlen(sd->info_phoneoffice))
389                                                        g_string_append_printf(st, "Office Phone: %s\n", sd->info_phoneoffice);
390                                                g_free(sd->info_phoneoffice);
391                                        }
392                                        if (sd->info_phonemobile) {
393                                                if (strlen(sd->info_phonemobile))
394                                                        g_string_append_printf(st, "Mobile Phone: %s\n", sd->info_phonemobile);
395                                                g_free(sd->info_phonemobile);
396                                        }
397                                        g_string_append_printf(st, "Personal Information\n");
398                                        if (sd->info_nrbuddies) {
399                                                if (strlen(sd->info_nrbuddies))
400                                                        g_string_append_printf(st, "Contacts: %s\n", sd->info_nrbuddies);
401                                                g_free(sd->info_nrbuddies);
402                                        }
403                                        if (sd->info_tz) {
404                                                if (strlen(sd->info_tz)) {
405                                                        char ib[256];
406                                                        time_t t = time(NULL);
407                                                        t += atoi(sd->info_tz)-(60*60*24);
408                                                        struct tm *gt = gmtime(&t);
409                                                        strftime(ib, 256, "%H:%M:%S", gt);
410                                                        g_string_append_printf(st, "Local Time: %s\n", ib);
411                                                }
412                                                g_free(sd->info_tz);
413                                        }
414                                        if (sd->info_seen) {
415                                                if (strlen(sd->info_seen)) {
416                                                        char ib[256];
417                                                        time_t it = atoi(sd->info_seen);
418                                                        struct tm *tm = localtime(&it);
419                                                        strftime(ib, 256, ("%Y. %m. %d. %H:%M"), tm);
420                                                        g_string_append_printf(st, "Last Seen: %s\n", ib);
421                                                }
422                                                g_free(sd->info_seen);
423                                        }
424                                        if (sd->info_birthday) {
425                                                if (strlen(sd->info_birthday) && strcmp(sd->info_birthday, "0")) {
426                                                        char ib[256];
427                                                        struct tm tm;
428                                                        strptime(sd->info_birthday, "%Y%m%d", &tm);
429                                                        strftime(ib, 256, "%B %d, %Y", &tm);
430                                                        g_string_append_printf(st, "Birthday: %s\n", ib);
431
432                                                        strftime(ib, 256, "%Y", &tm);
433                                                        int year = atoi(ib);
434                                                        time_t t = time(NULL);
435                                                        struct tm *lt = localtime(&t);
436                                                        g_string_append_printf(st, "Age: %d\n", lt->tm_year+1900-year);
437                                                }
438                                                g_free(sd->info_birthday);
439                                        }
440                                        if (sd->info_sex) {
441                                                if (strlen(sd->info_sex)) {
442                                                        char *iptr = sd->info_sex;
443                                                        while (*iptr++)
444                                                                *iptr = tolower(*iptr);
445                                                        g_string_append_printf(st, "Gender: %s\n", sd->info_sex);
446                                                }
447                                                g_free(sd->info_sex);
448                                        }
449                                        if (sd->info_language) {
450                                                if (strlen(sd->info_language)) {
451                                                        char *iptr = strchr(sd->info_language, ' ');
452                                                        if (iptr)
453                                                                iptr++;
454                                                        else
455                                                                iptr = sd->info_language;
456                                                        g_string_append_printf(st, "Language: %s\n", iptr);
457                                                }
458                                                g_free(sd->info_language);
459                                        }
460                                        if (sd->info_country) {
461                                                if (strlen(sd->info_country)) {
462                                                        char *iptr = strchr(sd->info_country, ' ');
463                                                        if (iptr)
464                                                                iptr++;
465                                                        else
466                                                                iptr = sd->info_country;
467                                                        g_string_append_printf(st, "Country: %s\n", iptr);
468                                                }
469                                                g_free(sd->info_country);
470                                        }
471                                        if (sd->info_province) {
472                                                if (strlen(sd->info_province))
473                                                        g_string_append_printf(st, "Region: %s\n", sd->info_province);
474                                                g_free(sd->info_province);
475                                        }
476                                        if (sd->info_city) {
477                                                if (strlen(sd->info_city))
478                                                        g_string_append_printf(st, "City: %s\n", sd->info_city);
479                                                g_free(sd->info_city);
480                                        }
481                                        if (sd->info_homepage) {
482                                                if (strlen(sd->info_homepage))
483                                                        g_string_append_printf(st, "Homepage: %s\n", sd->info_homepage);
484                                                g_free(sd->info_homepage);
485                                        }
486                                        if (sd->info_about) {
487                                                if (strlen(sd->info_about))
488                                                        g_string_append_printf(st, "%s\n", sd->info_about);
489                                                g_free(sd->info_about);
490                                        }
491                                        imcb_log(ic, "%s", st->str);
492                                        g_string_free(st, TRUE);
493                                }
494                        } else if (!strncmp(line, "CHATMESSAGE ", 12)) {
495                                char *id = strchr(line, ' ');
496                                if (++id) {
497                                        char *info = strchr(id, ' ');
498                                        *info = '\0';
499                                        info++;
500                                        if (!strcmp(info, "STATUS RECEIVED")) {
501                                                /* New message ID:
502                                                 * (1) Request its from field
503                                                 * (2) Request its body
504                                                 * (3) Request its type
505                                                 * (4) Query chatname
506                                                 */
507                                                g_snprintf(buf, 1024, "GET CHATMESSAGE %s FROM_HANDLE\n", id);
508                                                skype_write(ic, buf);
509                                                g_snprintf(buf, 1024, "GET CHATMESSAGE %s BODY\n", id);
510                                                skype_write(ic, buf);
511                                                g_snprintf(buf, 1024, "GET CHATMESSAGE %s TYPE\n", id);
512                                                skype_write(ic, buf);
513                                                g_snprintf(buf, 1024, "GET CHATMESSAGE %s CHATNAME\n", id);
514                                                skype_write(ic, buf);
515                                        } else if (!strncmp(info, "FROM_HANDLE ", 12)) {
516                                                info += 12;
517                                                /* New from field value. Store
518                                                 * it, then we can later use it
519                                                 * when we got the message's
520                                                 * body. */
521                                                g_free(sd->handle);
522                                                sd->handle = g_strdup_printf("%s@skype.com", info);
523                                        } else if (!strncmp(info, "EDITED_BY ", 10)) {
524                                                info += 10;
525                                                /* This is the same as
526                                                 * FROM_HANDLE, except that we
527                                                 * never request these lines
528                                                 * from Skype, we just get
529                                                 * them. */
530                                                g_free(sd->handle);
531                                                sd->handle = g_strdup_printf("%s@skype.com", info);
532                                        } else if (!strncmp(info, "BODY ", 5)) {
533                                                info += 5;
534                                                sd->body = g_list_append(sd->body, g_strdup(info));
535                                        }       else if (!strncmp(info, "TYPE ", 5)) {
536                                                info += 5;
537                                                g_free(sd->type);
538                                                sd->type = g_strdup(info);
539                                        } else if (!strncmp(info, "CHATNAME ", 9)) {
540                                                info += 9;
541                                                if (sd->handle && sd->body && sd->type) {
542                                                        struct groupchat *gc = skype_chat_by_name(ic, info);
543                                                        int i;
544                                                        for (i = 0; i < g_list_length(sd->body); i++) {
545                                                                char *body = g_list_nth_data(sd->body, i);
546                                                                if (!strcmp(sd->type, "SAID") || !strcmp(sd->type, "EMOTED")) {
547                                                                        char *st;
548                                                                        if (!strcmp(sd->type, "SAID"))
549                                                                                st = g_strdup(body);
550                                                                        else
551                                                                                st = g_strdup_printf("/me %s", body);
552                                                                        if (!gc)
553                                                                                /* Private message */
554                                                                                imcb_buddy_msg(ic, sd->handle, st, 0, 0);
555                                                                        else
556                                                                                /* Groupchat message */
557                                                                                imcb_chat_msg(gc, sd->handle, st, 0, 0);
558                                                                        g_free(st);
559                                                                } else if (!strcmp(sd->type, "SETTOPIC")) {
560                                                                        if (gc)
561                                                                                imcb_chat_topic(gc, sd->handle, body, 0);
562                                                                } else if (!strcmp(sd->type, "LEFT")) {
563                                                                        if (gc)
564                                                                                imcb_chat_remove_buddy(gc, sd->handle, NULL);
565                                                                }
566                                                        }
567                                                        g_list_free(sd->body);
568                                                        sd->body = NULL;
569                                                }
570                                        }
571                                }
572                        } else if (!strncmp(line, "CALL ", 5)) {
573                                char *id = strchr(line, ' ');
574                                if (++id) {
575                                        char *info = strchr(id, ' ');
576                                        *info = '\0';
577                                        info++;
578                                        if (!strncmp(info, "FAILUREREASON ", 14))
579                                                sd->failurereason = atoi(strchr(info, ' '));
580                                        else if (!strcmp(info, "STATUS RINGING")) {
581                                                if (sd->call_id)
582                                                        g_free(sd->call_id);
583                                                sd->call_id = g_strdup(id);
584                                                g_snprintf(buf, 1024, "GET CALL %s PARTNER_HANDLE\n", id);
585                                                skype_write(ic, buf);
586                                                sd->call_status = SKYPE_CALL_RINGING;
587                                        } else if (!strcmp(info, "STATUS MISSED")) {
588                                                g_snprintf(buf, 1024, "GET CALL %s PARTNER_HANDLE\n", id);
589                                                skype_write(ic, buf);
590                                                sd->call_status = SKYPE_CALL_MISSED;
591                                        } else if (!strcmp(info, "STATUS CANCELLED")) {
592                                                        g_snprintf(buf, 1024, "GET CALL %s PARTNER_HANDLE\n", id);
593                                                        skype_write(ic, buf);
594                                                        sd->call_status = SKYPE_CALL_CANCELLED;
595                                        } else if (!strcmp(info, "STATUS FINISHED")) {
596                                                g_snprintf(buf, 1024, "GET CALL %s PARTNER_HANDLE\n", id);
597                                                skype_write(ic, buf);
598                                                sd->call_status = SKYPE_CALL_FINISHED;
599                                        } else if (!strcmp(info, "STATUS REFUSED")) {
600                                                g_snprintf(buf, 1024, "GET CALL %s PARTNER_HANDLE\n", id);
601                                                skype_write(ic, buf);
602                                                sd->call_status = SKYPE_CALL_REFUSED;
603                                        } else if (!strcmp(info, "STATUS UNPLACED")) {
604                                                if (sd->call_id)
605                                                        g_free(sd->call_id);
606                                                /* Save the ID for later usage (Cancel/Finish). */
607                                                sd->call_id = g_strdup(id);
608                                                sd->call_out = TRUE;
609                                        } else if (!strcmp(info, "STATUS FAILED")) {
610                                                imcb_error(ic, "Call failed: %s", skype_call_strerror(sd->failurereason));
611                                                sd->call_id = NULL;
612                                        } else if (!strncmp(info, "DURATION ", 9)) {
613                                                if (sd->call_duration)
614                                                        g_free(sd->call_duration);
615                                                sd->call_duration = g_strdup(info+9);
616                                        } else if (!strncmp(info, "PARTNER_HANDLE ", 15)) {
617                                                info += 15;
618                                                if (sd->call_status) {
619                                                        switch (sd->call_status) {
620                                                        case SKYPE_CALL_RINGING:
621                                                                if (sd->call_out)
622                                                                        imcb_log(ic, "You are currently ringing the user %s.", info);
623                                                                else {
624                                                                        g_snprintf(buf, 1024, "The user %s is currently ringing you.", info);
625                                                                        skype_call_ask(ic, sd->call_id, buf);
626                                                                }
627                                                                break;
628                                                        case SKYPE_CALL_MISSED:
629                                                                imcb_log(ic, "You have missed a call from user %s.", info);
630                                                                break;
631                                                        case SKYPE_CALL_CANCELLED:
632                                                                imcb_log(ic, "You cancelled the call to the user %s.", info);
633                                                                sd->call_status = 0;
634                                                                sd->call_out = FALSE;
635                                                                break;
636                                                        case SKYPE_CALL_REFUSED:
637                                                                if (sd->call_out)
638                                                                        imcb_log(ic, "The user %s refused the call.", info);
639                                                                else
640                                                                        imcb_log(ic, "You refused the call from user %s.", info);
641                                                                sd->call_out = FALSE;
642                                                                break;
643                                                        case SKYPE_CALL_FINISHED:
644                                                                if (sd->call_duration)
645                                                                        imcb_log(ic, "You finished the call to the user %s (duration: %s seconds).", info, sd->call_duration);
646                                                                else
647                                                                        imcb_log(ic, "You finished the call to the user %s.", info);
648                                                                sd->call_out = FALSE;
649                                                                break;
650                                                        default:
651                                                                /* Don't be noisy, ignore other statuses for now. */
652                                                                break;
653                                                        }
654                                                        sd->call_status = 0;
655                                                }
656                                        }
657                                }
658                        } else if (!strncmp(line, "FILETRANSFER ", 13)) {
659                                char *id = strchr(line, ' ');
660                                if (++id) {
661                                        char *info = strchr(id, ' ');
662                                        *info = '\0';
663                                        info++;
664                                        if (!strcmp(info, "STATUS NEW")) {
665                                                g_snprintf(buf, 1024, "GET FILETRANSFER %s PARTNER_HANDLE\n", id);
666                                                skype_write(ic, buf);
667                                                sd->filetransfer_status = SKYPE_FILETRANSFER_NEW;
668                                        } else if (!strcmp(info, "STATUS FAILED")) {
669                                                g_snprintf(buf, 1024, "GET FILETRANSFER %s PARTNER_HANDLE\n", id);
670                                                skype_write(ic, buf);
671                                                sd->filetransfer_status = SKYPE_FILETRANSFER_FAILED;
672                                        } else if (!strncmp(info, "PARTNER_HANDLE ", 15)) {
673                                                info += 15;
674                                                if (sd->filetransfer_status) {
675                                                        switch (sd->filetransfer_status) {
676                                                        case SKYPE_FILETRANSFER_NEW:
677                                                                imcb_log(ic, "The user %s offered a new file for you.", info);
678                                                                break;
679                                                        case SKYPE_FILETRANSFER_FAILED:
680                                                                imcb_log(ic, "Failed to transfer file from user %s.", info);
681                                                                break;
682                                                        }
683                                                        sd->filetransfer_status = 0;
684                                                }
685                                        }
686                                }
687                        } else if (!strncmp(line, "CHAT ", 5)) {
688                                char *id = strchr(line, ' ');
689                                if (++id) {
690                                        char *info = strchr(id, ' ');
691                                        if (info)
692                                                *info = '\0';
693                                        info++;
694                                        /* Remove fake chat if we created one in skype_chat_with() */
695                                        struct groupchat *gc = skype_chat_by_name(ic, "");
696                                        if (gc)
697                                                imcb_chat_free(gc);
698                                        if (!strcmp(info, "STATUS MULTI_SUBSCRIBED")) {
699                                                imcb_chat_new(ic, id);
700                                                g_snprintf(buf, 1024, "GET CHAT %s ADDER\n", id);
701                                                skype_write(ic, buf);
702                                                g_snprintf(buf, 1024, "GET CHAT %s TOPIC\n", id);
703                                                skype_write(ic, buf);
704                                        } else if (!strcmp(info, "STATUS DIALOG") && sd->groupchat_with) {
705                                                gc = imcb_chat_new(ic, id);
706                                                /* According to the docs this
707                                                 * is necessary. However it
708                                                 * does not seem the situation
709                                                 * and it would open an extra
710                                                 * window on our client, so
711                                                 * just leave it out. */
712                                                /*g_snprintf(buf, 1024, "OPEN CHAT %s\n", id);
713                                                skype_write(ic, buf);*/
714                                                g_snprintf(buf, 1024, "%s@skype.com", sd->groupchat_with);
715                                                imcb_chat_add_buddy(gc, buf);
716                                                imcb_chat_add_buddy(gc, sd->username);
717                                                g_free(sd->groupchat_with);
718                                                sd->groupchat_with = NULL;
719                                                g_snprintf(buf, 1024, "GET CHAT %s ADDER\n", id);
720                                                skype_write(ic, buf);
721                                                g_snprintf(buf, 1024, "GET CHAT %s TOPIC\n", id);
722                                                skype_write(ic, buf);
723                                        } else if (!strcmp(info, "STATUS UNSUBSCRIBED")) {
724                                                gc = skype_chat_by_name(ic, id);
725                                                if (gc)
726                                                        gc->data = (void *)FALSE;
727                                        } else if (!strncmp(info, "ADDER ", 6)) {
728                                                info += 6;
729                                                g_free(sd->adder);
730                                                sd->adder = g_strdup_printf("%s@skype.com", info);
731                                        } else if (!strncmp(info, "TOPIC ", 6)) {
732                                                info += 6;
733                                                gc = skype_chat_by_name(ic, id);
734                                                if (gc && (sd->adder || sd->topic_wait)) {
735                                                        if (sd->topic_wait) {
736                                                                sd->adder = g_strdup(sd->username);
737                                                                sd->topic_wait = 0;
738                                                        }
739                                                        imcb_chat_topic(gc, sd->adder, info, 0);
740                                                        g_free(sd->adder);
741                                                        sd->adder = NULL;
742                                                }
743                                        } else if (!strncmp(info, "ACTIVEMEMBERS ", 14)) {
744                                                info += 14;
745                                                gc = skype_chat_by_name(ic, id);
746                                                /* Hack! We set ->data to TRUE
747                                                 * while we're on the channel
748                                                 * so that we won't rejoin
749                                                 * after a /part. */
750                                                if (gc && !gc->data) {
751                                                        char **members = g_strsplit(info, " ", 0);
752                                                        int i;
753                                                        for (i = 0; members[i]; i++) {
754                                                                if (!strcmp(members[i], sd->username))
755                                                                        continue;
756                                                                g_snprintf(buf, 1024, "%s@skype.com", members[i]);
757                                                                if (!g_list_find_custom(gc->in_room, buf, (GCompareFunc)strcmp))
758                                                                        imcb_chat_add_buddy(gc, buf);
759                                                        }
760                                                        imcb_chat_add_buddy(gc, sd->username);
761                                                        g_strfreev(members);
762                                                }
763                                        }
764                                }
765                        } else if (!strncmp(line, "PASSWORD ", 9)) {
766                                if (!strncmp(line+9, "OK", 2))
767                                        imcb_connected(ic);
768                                else {
769                                        imcb_error(ic, "Authentication Failed");
770                                        imc_logout(ic, TRUE);
771                                }
772                        } else if (!strncmp(line, "PROFILE PSTN_BALANCE ", 21))
773                                imcb_log(ic, "SkypeOut balance value is '%s'.", line+21);
774                        else if (!strncmp(line, "PING", 4)) {
775                                g_snprintf(buf, 1024, "PONG\n");
776                                skype_write(ic, buf);
777                        } else if (!strncmp(line, "CHATS ", 6)) {
778                                char **i;
779                                char **chats = g_strsplit(line + 6, ", ", 0);
780
781                                i = chats;
782                                while (*i) {
783                                        g_snprintf(buf, 1024, "GET CHAT %s STATUS\n", *i);
784                                        skype_write(ic, buf);
785                                        g_snprintf(buf, 1024, "GET CHAT %s ACTIVEMEMBERS\n", *i);
786                                        skype_write(ic, buf);
787                                        i++;
788                                }
789                                g_strfreev(chats);
790                        }
791                        lineptr++;
792                }
793                g_strfreev(lines);
794        } else if (st == 0 || (st < 0 && !sockerr_again())) {
795                closesocket(sd->fd);
796                sd->fd = -1;
797
798                imcb_error(ic, "Error while reading from server");
799                imc_logout(ic, TRUE);
800                return FALSE;
801        }
802        return TRUE;
803}
804
805gboolean skype_start_stream(struct im_connection *ic)
806{
807        struct skype_data *sd = ic->proto_data;
808        char *buf;
809        int st;
810
811        if (!sd)
812                return FALSE;
813
814        if (sd->bfd <= 0)
815                sd->bfd = b_input_add(sd->fd, GAIM_INPUT_READ,
816                        skype_read_callback, ic);
817
818        /* Log in */
819        buf = g_strdup_printf("USERNAME %s\n", ic->acc->user);
820        st = skype_write(ic, buf);
821        g_free(buf);
822        buf = g_strdup_printf("PASSWORD %s\n", ic->acc->pass);
823        st = skype_write(ic, buf);
824        g_free(buf);
825
826        /* This will download all buddies. */
827        buf = g_strdup_printf("SEARCH FRIENDS\n");
828        st = skype_write(ic, buf);
829        g_free(buf);
830        buf = g_strdup_printf("SET USERSTATUS ONLINE\n");
831        skype_write(ic, buf);
832        g_free(buf);
833
834        /* Auto join to bookmarked chats if requested.*/
835        if (set_getbool(&ic->acc->set, "auto_join")) {
836                buf = g_strdup_printf("SEARCH BOOKMARKEDCHATS\n");
837                skype_write(ic, buf);
838                g_free(buf);
839        }
840        return st;
841}
842
843gboolean skype_connected(gpointer data, void *source, b_input_condition cond)
844{
845        struct im_connection *ic = data;
846        struct skype_data *sd = ic->proto_data;
847        if (!source) {
848                sd->ssl = NULL;
849                imcb_error(ic, "Could not connect to server");
850                imc_logout(ic, TRUE);
851                return FALSE;
852        }
853        imcb_log(ic, "Connected to server, logging in");
854        return skype_start_stream(ic);
855}
856
857static void skype_login(account_t *acc)
858{
859        struct im_connection *ic = imcb_new(acc);
860        struct skype_data *sd = g_new0(struct skype_data, 1);
861
862        ic->proto_data = sd;
863
864        imcb_log(ic, "Connecting");
865        sd->ssl = ssl_connect(set_getstr(&acc->set, "server"),
866                set_getint(&acc->set, "port"), skype_connected, ic);
867        sd->fd = sd->ssl ? ssl_getfd(sd->ssl) : -1;
868        sd->username = g_strdup(acc->user);
869
870        sd->ic = ic;
871
872        if (set_getbool(&acc->set, "skypeconsole"))
873                imcb_add_buddy(ic, "skypeconsole", NULL);
874}
875
876static void skype_logout(struct im_connection *ic)
877{
878        struct skype_data *sd = ic->proto_data;
879        char *buf;
880
881        buf = g_strdup_printf("SET USERSTATUS OFFLINE\n");
882        skype_write(ic, buf);
883        g_free(buf);
884
885        g_free(sd->username);
886        g_free(sd->handle);
887        g_free(sd);
888        ic->proto_data = NULL;
889}
890
891static int skype_buddy_msg(struct im_connection *ic, char *who, char *message,
892                           int flags)
893{
894        char *buf, *ptr, *nick;
895        int st;
896
897        nick = g_strdup(who);
898        ptr = strchr(nick, '@');
899        if (ptr)
900                *ptr = '\0';
901
902        if (!strncmp(who, "skypeconsole", 12))
903                buf = g_strdup_printf("%s\n", message);
904        else
905                buf = g_strdup_printf("MESSAGE %s %s\n", nick, message);
906        g_free(nick);
907        st = skype_write(ic, buf);
908        g_free(buf);
909
910        return st;
911}
912
913const struct skype_away_state *skype_away_state_by_name(char *name)
914{
915        int i;
916
917        for (i = 0; skype_away_state_list[i].full_name; i++)
918                if (g_strcasecmp(skype_away_state_list[i].full_name, name) == 0)
919                        return skype_away_state_list + i;
920
921        return NULL;
922}
923
924static void skype_set_away(struct im_connection *ic, char *state_txt,
925                           char *message)
926{
927        const struct skype_away_state *state;
928        char *buf;
929
930        if (strcmp(state_txt, GAIM_AWAY_CUSTOM) == 0)
931                state = skype_away_state_by_name("Away");
932        else
933                state = skype_away_state_by_name(state_txt);
934        buf = g_strdup_printf("SET USERSTATUS %s\n", state->code);
935        skype_write(ic, buf);
936        g_free(buf);
937}
938
939static GList *skype_away_states(struct im_connection *ic)
940{
941        static GList *l;
942        int i;
943
944        if (l == NULL)
945                for (i = 0; skype_away_state_list[i].full_name; i++)
946                        l = g_list_append(l,
947                                (void *)skype_away_state_list[i].full_name);
948
949        return l;
950}
951
952static char *skype_set_display_name(set_t *set, char *value)
953{
954        account_t *acc = set->data;
955        struct im_connection *ic = acc->ic;
956        char *buf;
957
958        buf = g_strdup_printf("SET PROFILE FULLNAME %s", value);
959        skype_write(ic, buf);
960        g_free(buf);
961        return value;
962}
963
964static char *skype_set_balance(set_t *set, char *value)
965{
966        account_t *acc = set->data;
967        struct im_connection *ic = acc->ic;
968        char *buf;
969
970        buf = g_strdup_printf("GET PROFILE PSTN_BALANCE");
971        skype_write(ic, buf);
972        g_free(buf);
973        return value;
974}
975
976static char *skype_set_call(set_t *set, char *value)
977{
978        account_t *acc = set->data;
979        struct im_connection *ic = acc->ic;
980        struct skype_data *sd = ic->proto_data;
981        char *nick, *ptr, *buf;
982
983        if (value) {
984                user_t *u = user_find(acc->irc, value);
985                /* We are starting a call */
986                if (!u)
987                        nick = g_strdup(value);
988                else
989                        nick = g_strdup(u->handle);
990                ptr = strchr(nick, '@');
991                if (ptr)
992                        *ptr = '\0';
993
994                buf = g_strdup_printf("CALL %s", nick);
995                skype_write(ic, buf);
996                g_free(buf);
997                g_free(nick);
998        } else {
999                /* We are ending a call */
1000                if (sd->call_id) {
1001                        buf = g_strdup_printf("SET CALL %s STATUS FINISHED",
1002                                sd->call_id);
1003                        skype_write(ic, buf);
1004                        g_free(buf);
1005                        g_free(sd->call_id);
1006                        sd->call_id = NULL;
1007                } else
1008                        imcb_error(ic, "There are no active calls currently.");
1009        }
1010        return value;
1011}
1012
1013static void skype_add_buddy(struct im_connection *ic, char *who, char *group)
1014{
1015        char *buf, *nick, *ptr;
1016
1017        nick = g_strdup(who);
1018        ptr = strchr(nick, '@');
1019        if (ptr)
1020                *ptr = '\0';
1021        buf = g_strdup_printf("SET USER %s BUDDYSTATUS 2 Please authorize me\n",
1022                nick);
1023        skype_write(ic, buf);
1024        g_free(nick);
1025}
1026
1027static void skype_remove_buddy(struct im_connection *ic, char *who, char *group)
1028{
1029        char *buf, *nick, *ptr;
1030
1031        nick = g_strdup(who);
1032        ptr = strchr(nick, '@');
1033        if (ptr)
1034                *ptr = '\0';
1035        buf = g_strdup_printf("SET USER %s BUDDYSTATUS 1\n", nick);
1036        skype_write(ic, buf);
1037        g_free(nick);
1038}
1039
1040void skype_chat_msg(struct groupchat *gc, char *message, int flags)
1041{
1042        struct im_connection *ic = gc->ic;
1043        char *buf;
1044        buf = g_strdup_printf("CHATMESSAGE %s %s\n", gc->title, message);
1045        skype_write(ic, buf);
1046        g_free(buf);
1047}
1048
1049void skype_chat_leave(struct groupchat *gc)
1050{
1051        struct im_connection *ic = gc->ic;
1052        char *buf;
1053        buf = g_strdup_printf("ALTER CHAT %s LEAVE\n", gc->title);
1054        skype_write(ic, buf);
1055        g_free(buf);
1056        gc->data = (void *)TRUE;
1057}
1058
1059void skype_chat_invite(struct groupchat *gc, char *who, char *message)
1060{
1061        struct im_connection *ic = gc->ic;
1062        char *buf, *ptr, *nick;
1063        nick = g_strdup(message);
1064        ptr = strchr(nick, '@');
1065        if (ptr)
1066                *ptr = '\0';
1067        buf = g_strdup_printf("ALTER CHAT %s ADDMEMBERS %s\n", gc->title, nick);
1068        skype_write(ic, buf);
1069        g_free(buf);
1070        g_free(nick);
1071}
1072
1073void skype_chat_topic(struct groupchat *gc, char *message)
1074{
1075        struct im_connection *ic = gc->ic;
1076        struct skype_data *sd = ic->proto_data;
1077        char *buf;
1078        buf = g_strdup_printf("ALTER CHAT %s SETTOPIC %s\n",
1079                gc->title, message);
1080        skype_write(ic, buf);
1081        g_free(buf);
1082        sd->topic_wait = 1;
1083}
1084
1085struct groupchat *skype_chat_with(struct im_connection *ic, char *who)
1086{
1087        struct skype_data *sd = ic->proto_data;
1088        char *ptr, *nick, *buf;
1089        nick = g_strdup(who);
1090        ptr = strchr(nick, '@');
1091        if (ptr)
1092                *ptr = '\0';
1093        buf = g_strdup_printf("CHAT CREATE %s\n", nick);
1094        skype_write(ic, buf);
1095        g_free(buf);
1096        sd->groupchat_with = g_strdup(nick);
1097        g_free(nick);
1098        /* We create a fake chat for now. We will replace it with a real one in
1099         * the real callback. */
1100        return imcb_chat_new(ic, "");
1101}
1102
1103static void skype_get_info(struct im_connection *ic, char *who)
1104{
1105        char *ptr, *nick, *buf;
1106        nick = g_strdup(who);
1107        ptr = strchr(nick, '@');
1108        if (ptr)
1109                *ptr = '\0';
1110        buf = g_strdup_printf("GET USER %s FULLNAME\n", nick);
1111        skype_write(ic, buf);
1112        g_free(buf);
1113        buf = g_strdup_printf("GET USER %s PHONE_HOME\n", nick);
1114        skype_write(ic, buf);
1115        g_free(buf);
1116        buf = g_strdup_printf("GET USER %s PHONE_OFFICE\n", nick);
1117        skype_write(ic, buf);
1118        g_free(buf);
1119        buf = g_strdup_printf("GET USER %s PHONE_MOBILE\n", nick);
1120        skype_write(ic, buf);
1121        g_free(buf);
1122        buf = g_strdup_printf("GET USER %s NROF_AUTHED_BUDDIES\n", nick);
1123        skype_write(ic, buf);
1124        g_free(buf);
1125        buf = g_strdup_printf("GET USER %s TIMEZONE\n", nick);
1126        skype_write(ic, buf);
1127        g_free(buf);
1128        buf = g_strdup_printf("GET USER %s LASTONLINETIMESTAMP\n", nick);
1129        skype_write(ic, buf);
1130        g_free(buf);
1131        buf = g_strdup_printf("GET USER %s BIRTHDAY\n", nick);
1132        skype_write(ic, buf);
1133        g_free(buf);
1134        buf = g_strdup_printf("GET USER %s SEX\n", nick);
1135        skype_write(ic, buf);
1136        g_free(buf);
1137        buf = g_strdup_printf("GET USER %s LANGUAGE\n", nick);
1138        skype_write(ic, buf);
1139        g_free(buf);
1140        buf = g_strdup_printf("GET USER %s COUNTRY\n", nick);
1141        skype_write(ic, buf);
1142        g_free(buf);
1143        buf = g_strdup_printf("GET USER %s PROVINCE\n", nick);
1144        skype_write(ic, buf);
1145        g_free(buf);
1146        buf = g_strdup_printf("GET USER %s CITY\n", nick);
1147        skype_write(ic, buf);
1148        g_free(buf);
1149        buf = g_strdup_printf("GET USER %s HOMEPAGE\n", nick);
1150        skype_write(ic, buf);
1151        g_free(buf);
1152        buf = g_strdup_printf("GET USER %s ABOUT\n", nick);
1153        skype_write(ic, buf);
1154        g_free(buf);
1155}
1156
1157static void skype_set_my_name(struct im_connection *ic, char *info)
1158{
1159        skype_set_display_name(set_find(&ic->acc->set, "display_name"), info);
1160}
1161
1162static void skype_init(account_t *acc)
1163{
1164        set_t *s;
1165
1166        s = set_add(&acc->set, "server", SKYPE_DEFAULT_SERVER, set_eval_account,
1167                acc);
1168        s->flags |= ACC_SET_OFFLINE_ONLY;
1169
1170        s = set_add(&acc->set, "port", SKYPE_DEFAULT_PORT, set_eval_int, acc);
1171        s->flags |= ACC_SET_OFFLINE_ONLY;
1172
1173        s = set_add(&acc->set, "display_name", NULL, skype_set_display_name,
1174                acc);
1175        s->flags |= ACC_SET_NOSAVE | ACC_SET_ONLINE_ONLY;
1176
1177        s = set_add(&acc->set, "call", NULL, skype_set_call, acc);
1178        s->flags |= ACC_SET_NOSAVE | ACC_SET_ONLINE_ONLY;
1179
1180        s = set_add(&acc->set, "balance", NULL, skype_set_balance, acc);
1181        s->flags |= ACC_SET_NOSAVE | ACC_SET_ONLINE_ONLY;
1182
1183        s = set_add(&acc->set, "skypeout_offline", "true", set_eval_bool, acc);
1184
1185        s = set_add(&acc->set, "skypeconsole", "false", set_eval_bool, acc);
1186        s->flags |= ACC_SET_OFFLINE_ONLY;
1187
1188        s = set_add(&acc->set, "skypeconsole_receive", "false", set_eval_bool,
1189                acc);
1190        s->flags |= ACC_SET_OFFLINE_ONLY;
1191
1192        s = set_add(&acc->set, "auto_join", "false", set_eval_bool, acc);
1193        s->flags |= ACC_SET_OFFLINE_ONLY;
1194}
1195
1196void init_plugin(void)
1197{
1198        struct prpl *ret = g_new0(struct prpl, 1);
1199
1200        ret->name = "skype";
1201        ret->login = skype_login;
1202        ret->init = skype_init;
1203        ret->logout = skype_logout;
1204        ret->buddy_msg = skype_buddy_msg;
1205        ret->get_info = skype_get_info;
1206        ret->set_my_name = skype_set_my_name;
1207        ret->away_states = skype_away_states;
1208        ret->set_away = skype_set_away;
1209        ret->add_buddy = skype_add_buddy;
1210        ret->remove_buddy = skype_remove_buddy;
1211        ret->chat_msg = skype_chat_msg;
1212        ret->chat_leave = skype_chat_leave;
1213        ret->chat_invite = skype_chat_invite;
1214        ret->chat_with = skype_chat_with;
1215        ret->handle_cmp = g_strcasecmp;
1216        ret->chat_topic = skype_chat_topic;
1217        register_protocol(ret);
1218}
Note: See TracBrowser for help on using the repository browser.