source: irc.h @ be999a5

Last change on this file since be999a5 was be999a5, checked in by Wilmer van der Gaast <wilmer@…>, at 2010-08-23T23:12:24Z

First step in this merge. Mostly a bzr merge and then a cleanup of conflicts
and parts I want to/have to redo (because of ui-fix).
  • Property mode set to 100644
File size: 9.6 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/* The IRC-based UI (for now the only one)                              */
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 _IRC_H
27#define _IRC_H
28
29#include "otr.h"
30
31#define IRC_MAX_LINE 512
32#define IRC_MAX_ARGS 16
33
34#define IRC_LOGIN_TIMEOUT 60
35#define IRC_PING_STRING "PinglBee"
36
37#define UMODES "abisw"     /* Allowed umodes (although they mostly do nothing) */
38#define UMODES_PRIV "Ro"   /* Allowed, but not by user directly */
39#define UMODES_KEEP "R"    /* Don't allow unsetting using /MODE */
40#define CMODES "ntC"       /* Allowed modes */
41#define CMODE "t"          /* Default mode */
42#define UMODE "s"          /* Default mode */
43
44#define CTYPES "&#"        /* Valid channel name prefixes */
45
46typedef enum
47{
48        USTATUS_OFFLINE = 0,
49        USTATUS_AUTHORIZED = 1, /* Gave the correct server password (PASS). */
50        USTATUS_LOGGED_IN = 2,  /* USER+NICK(+PASS) finished. */
51        USTATUS_IDENTIFIED = 4, /* To NickServ (root). */
52        USTATUS_SHUTDOWN = 8,   /* Now used to indicate we're shutting down.
53                                   Currently just blocks irc_vawrite(). */
54} irc_status_t;
55
56struct irc_user;
57
58typedef struct irc
59{
60        int fd;
61        irc_status_t status;
62        double last_pong;
63        int pinging;
64        char *sendbuffer;
65        char *readbuffer;
66        GIConv iconv, oconv;
67
68        struct irc_user *root;
69        struct irc_user *user;
70       
71        char *password; /* HACK: Used to save the user's password, but before
72                           logging in, this may contain a password we should
73                           send to identify after USER/NICK are received. */
74
75        char umode[8];
76       
77        struct query *queries;
78        GSList *file_transfers;
79       
80        GSList *users, *channels;
81        struct irc_channel *default_channel;
82        GHashTable *nick_user_hash;
83        GHashTable *watches; /* See irc_cmd_watch() */
84
85        gint r_watch_source_id;
86        gint w_watch_source_id;
87        gint ping_source_id;
88        gint login_source_id; /* To slightly delay some events at login time. */
89       
90        otr_t *otr;            /* OTR state and book keeping */
91       
92        struct bee *b;
93} irc_t;
94
95typedef enum
96{
97        /* Replaced with iu->last_channel IRC_USER_PRIVATE = 1, */
98        IRC_USER_AWAY = 2,
99} irc_user_flags_t;
100
101typedef struct irc_user
102{
103        irc_t *irc;
104       
105        char *nick;
106        char *user;
107        char *host;
108        char *fullname;
109       
110        /* Nickname in lowercase for case insensitive searches */
111        char *key;
112       
113        irc_user_flags_t flags;
114        struct irc_channel *last_channel;
115       
116        GString *pastebuf; /* Paste buffer (combine lines into a multiline msg). */
117        guint pastebuf_timer;
118        time_t away_reply_timeout; /* Only send a 301 if this time passed. */
119       
120        struct bee_user *bu;
121       
122        const struct irc_user_funcs *f;
123} irc_user_t;
124
125struct irc_user_funcs
126{
127        gboolean (*privmsg)( irc_user_t *iu, const char *msg );
128        gboolean (*ctcp)( irc_user_t *iu, char * const* ctcp );
129};
130
131extern const struct irc_user_funcs irc_user_root_funcs;
132extern const struct irc_user_funcs irc_user_self_funcs;
133
134typedef enum
135{
136        IRC_CHANNEL_JOINED = 1, /* The user is currently in the channel. */
137        IRC_CHANNEL_TEMP = 2,   /* Erase the channel when the user leaves,
138                                   and don't save it. */
139       
140        /* Hack: Set this flag right before jumping into IM when we expect
141           a call to imcb_chat_new(). */
142        IRC_CHANNEL_CHAT_PICKME = 0x10000,
143} irc_channel_flags_t;
144
145typedef struct irc_channel
146{
147        irc_t *irc;
148        char *name;
149        char mode[8];
150        int flags;
151       
152        char *topic;
153        char *topic_who;
154        time_t topic_time;
155       
156        GSList *users; /* struct irc_channel_user */
157        struct irc_user *last_target;
158        struct set *set;
159       
160        GString *pastebuf; /* Paste buffer (combine lines into a multiline msg). */
161        guint pastebuf_timer;
162       
163        const struct irc_channel_funcs *f;
164        void *data;
165} irc_channel_t;
166
167struct irc_channel_funcs
168{
169        gboolean (*privmsg)( irc_channel_t *ic, const char *msg );
170        gboolean (*join)( irc_channel_t *ic );
171        gboolean (*part)( irc_channel_t *ic, const char *msg );
172        gboolean (*topic)( irc_channel_t *ic, const char *new );
173        gboolean (*invite)( irc_channel_t *ic, irc_user_t *iu );
174       
175        gboolean (*_init)( irc_channel_t *ic );
176        gboolean (*_free)( irc_channel_t *ic );
177};
178
179typedef enum
180{
181        IRC_CHANNEL_USER_OP = 1,
182        IRC_CHANNEL_USER_HALFOP = 2,
183        IRC_CHANNEL_USER_VOICE = 4,
184        IRC_CHANNEL_USER_NONE = 8,
185} irc_channel_user_flags_t;
186
187typedef struct irc_channel_user
188{
189        irc_user_t *iu;
190        int flags;
191} irc_channel_user_t;
192
193typedef enum
194{
195        IRC_CC_TYPE_DEFAULT,
196        IRC_CC_TYPE_REST,
197        IRC_CC_TYPE_GROUP,
198        IRC_CC_TYPE_ACCOUNT,
199        IRC_CC_TYPE_PROTOCOL,
200} irc_control_channel_type_t;
201
202struct irc_control_channel
203{
204        irc_control_channel_type_t type;
205        struct bee_group *group;
206        struct account *account;
207        struct prpl *protocol;
208        char modes[4];
209};
210
211extern const struct bee_ui_funcs irc_ui_funcs;
212
213typedef enum
214{
215        IRC_CDU_SILENT,
216        IRC_CDU_PART,
217        IRC_CDU_KICK,
218} irc_channel_del_user_type_t;
219
220/* irc.c */
221extern GSList *irc_connection_list;
222
223irc_t *irc_new( int fd );
224void irc_abort( irc_t *irc, int immed, char *format, ... ) G_GNUC_PRINTF( 3, 4 );
225void irc_free( irc_t *irc );
226void irc_setpass (irc_t *irc, const char *pass);
227
228void irc_process( irc_t *irc );
229char **irc_parse_line( char *line );
230char *irc_build_line( char **cmd );
231
232void irc_write( irc_t *irc, char *format, ... ) G_GNUC_PRINTF( 2, 3 );
233void irc_write_all( int now, char *format, ... ) G_GNUC_PRINTF( 2, 3 );
234void irc_vawrite( irc_t *irc, char *format, va_list params );
235
236void irc_flush( irc_t *irc );
237void irc_switch_fd( irc_t *irc, int fd );
238void irc_sync( irc_t *irc );
239void irc_desync( irc_t *irc );
240
241int irc_check_login( irc_t *irc );
242
243void irc_umode_set( irc_t *irc, const char *s, gboolean allow_priv );
244
245/* irc_channel.c */
246irc_channel_t *irc_channel_new( irc_t *irc, const char *name );
247irc_channel_t *irc_channel_by_name( irc_t *irc, const char *name );
248irc_channel_t *irc_channel_get( irc_t *irc, char *id );
249int irc_channel_free( irc_channel_t *ic );
250void irc_channel_free_soon( irc_channel_t *ic );
251int irc_channel_add_user( irc_channel_t *ic, irc_user_t *iu );
252int irc_channel_del_user( irc_channel_t *ic, irc_user_t *iu, irc_channel_del_user_type_t type, const char *msg );
253irc_channel_user_t *irc_channel_has_user( irc_channel_t *ic, irc_user_t *iu );
254int irc_channel_set_topic( irc_channel_t *ic, const char *topic, const irc_user_t *who );
255void irc_channel_user_set_mode( irc_channel_t *ic, irc_user_t *iu, irc_channel_user_flags_t flags );
256void irc_channel_set_mode( irc_channel_t *ic, const char *s );
257void irc_channel_auto_joins( irc_t *irc, struct account *acc );
258void irc_channel_printf( irc_channel_t *ic, char *format, ... );
259gboolean irc_channel_name_ok( const char *name );
260void irc_channel_name_strip( char *name );
261int irc_channel_name_cmp( const char *a_, const char *b_ );
262void irc_channel_update_ops( irc_channel_t *ic, char *value );
263char *set_eval_irc_channel_ops( struct set *set, char *value );
264gboolean irc_channel_wants_user( irc_channel_t *ic, irc_user_t *iu );
265
266/* irc_commands.c */
267void irc_exec( irc_t *irc, char **cmd );
268
269/* irc_send.c */
270void irc_send_num( irc_t *irc, int code, char *format, ... ) G_GNUC_PRINTF( 3, 4 );
271void irc_send_login( irc_t *irc );
272void irc_send_motd( irc_t *irc );
273void irc_usermsg( irc_t *irc, char *format, ... );
274void irc_send_join( irc_channel_t *ic, irc_user_t *iu );
275void irc_send_part( irc_channel_t *ic, irc_user_t *iu, const char *reason );
276void irc_send_quit( irc_user_t *iu, const char *reason );
277void irc_send_kick( irc_channel_t *ic, irc_user_t *iu, irc_user_t *kicker, const char *reason );
278void irc_send_names( irc_channel_t *ic );
279void irc_send_topic( irc_channel_t *ic, gboolean topic_change );
280void irc_send_whois( irc_user_t *iu );
281void irc_send_who( irc_t *irc, GSList *l, const char *channel );
282void irc_send_msg( irc_user_t *iu, const char *type, const char *dst, const char *msg, const char *prefix );
283void irc_send_msg_raw( irc_user_t *iu, const char *type, const char *dst, const char *msg );
284void irc_send_msg_f( irc_user_t *iu, const char *type, const char *dst, const char *format, ... ) G_GNUC_PRINTF( 4, 5 );
285void irc_send_nick( irc_user_t *iu, const char *new );
286void irc_send_channel_user_mode_diff( irc_channel_t *ic, irc_user_t *iu,
287                                      irc_channel_user_flags_t old, irc_channel_user_flags_t new );
288
289/* irc_user.c */
290irc_user_t *irc_user_new( irc_t *irc, const char *nick );
291int irc_user_free( irc_t *irc, irc_user_t *iu );
292irc_user_t *irc_user_by_name( irc_t *irc, const char *nick );
293int irc_user_set_nick( irc_user_t *iu, const char *new );
294gint irc_user_cmp( gconstpointer a_, gconstpointer b_ );
295const char *irc_user_get_away( irc_user_t *iu );
296void irc_user_quit( irc_user_t *iu, const char *msg );
297
298/* irc_util.c */
299char *set_eval_timezone( struct set *set, char *value );
300char *irc_format_timestamp( irc_t *irc, time_t msg_ts );
301
302/* irc_im.c */
303void bee_irc_channel_update( irc_t *irc, irc_channel_t *ic, irc_user_t *iu );
304
305#endif
Note: See TracBrowser for help on using the repository browser.