source: protocols/bee.h @ 231b08b

Last change on this file since 231b08b was fb117aee, checked in by Wilmer van der Gaast <wilmer@…>, at 2010-04-02T02:29:45Z

Cleaned lots of compiler warnings so I can get some signal again.

  • Property mode set to 100644
File size: 3.2 KB
Line 
1  /********************************************************************\
2  * BitlBee -- An IRC to other IM-networks gateway                     *
3  *                                                                    *
4  * Copyright 2002-2010 Wilmer van der Gaast and others                *
5  \********************************************************************/
6
7/* Stuff to handle, save and search buddies                             */
8
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 with
21  the Debian GNU/Linux distribution in /usr/share/common-licenses/GPL;
22  if not, write to the Free Software Foundation, Inc., 59 Temple Place,
23  Suite 330, Boston, MA  02111-1307  USA
24*/
25
26#ifndef __BEE_H__
27#define __BEE_H__
28
29struct bee_ui_funcs;
30
31typedef struct bee
32{
33        struct set *set;
34       
35        GSList *users;
36        struct account *accounts; /* TODO(wilmer): Use GSList here too? */
37       
38        const struct bee_ui_funcs *ui;
39        void *ui_data;
40} bee_t;
41
42bee_t *bee_new();
43void bee_free( bee_t *b );
44
45typedef enum
46{
47        BEE_USER_ONLINE = 1,    /* Compatibility with old OPT_LOGGED_IN flag */
48        BEE_USER_AWAY = 4,      /* Compatibility with old OPT_AWAY flag */
49} bee_user_flags_t;
50
51typedef struct bee_user
52{
53        struct im_connection *ic;
54        char *handle;
55        char *fullname;
56        char *group;
57
58        bee_user_flags_t flags;
59        char *status;
60        char *status_msg;
61       
62        bee_t *bee;
63        void *ui_data;
64} bee_user_t;
65
66typedef struct bee_ui_funcs
67{
68        gboolean (*user_new)( bee_t *bee, struct bee_user *bu );
69        gboolean (*user_free)( bee_t *bee, struct bee_user *bu );
70        gboolean (*user_status)( bee_t *bee, struct bee_user *bu, struct bee_user *old );
71} bee_ui_funcs_t;
72
73
74/* bee.c */
75bee_t *bee_new();
76void bee_free( bee_t *b );
77
78/* bee_user.c */
79bee_user_t *bee_user_new( bee_t *bee, struct im_connection *ic, const char *handle );
80int bee_user_free( bee_t *bee, struct im_connection *ic, const char *handle );
81bee_user_t *bee_user_by_handle( bee_t *bee, struct im_connection *ic, const char *handle );
82int bee_user_msg( bee_t *bee, bee_user_t *bu, const char *msg, int flags );
83
84/* Callbacks from IM modules to core: */
85/* Buddy activity */
86/* To manipulate the status of a handle.
87 * - flags can be |='d with OPT_* constants. You will need at least:
88 *   OPT_LOGGED_IN and OPT_AWAY.
89 * - 'state' and 'message' can be NULL */
90G_MODULE_EXPORT void imcb_buddy_status( struct im_connection *ic, const char *handle, int flags, const char *state, const char *message );
91/* Not implemented yet! */ G_MODULE_EXPORT void imcb_buddy_times( struct im_connection *ic, const char *handle, time_t login, time_t idle );
92/* Call when a handle says something. 'flags' and 'sent_at may be just 0. */
93G_MODULE_EXPORT void imcb_buddy_msg( struct im_connection *ic, const char *handle, char *msg, guint32 flags, time_t sent_at );
94
95#endif /* __BEE_H__ */
Note: See TracBrowser for help on using the repository browser.