source: irc.h @ ab6006c

Last change on this file since ab6006c was ab6006c, checked in by Wilmer van der Gaast <wilmer@…>, at 2010-06-28T09:03:39Z

Callers shouldn't have to expect that irc_channel_del_user() frees the channel
so if it wants to (temporary channels), do it via a timer.

  • Property mode set to 100644
File size: 8.7 KB
RevLine 
[b7d3cc34]1  /********************************************************************\
2  * BitlBee -- An IRC to other IM-networks gateway                     *
3  *                                                                    *
4  * Copyright 2002-2004 Wilmer van der Gaast and others                *
5  \********************************************************************/
6
[3ddb7477]7/* The IRC-based UI (for now the only one)                              */
[b7d3cc34]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#define IRC_MAX_LINE 512
30#define IRC_MAX_ARGS 8
31
32#define IRC_LOGIN_TIMEOUT 60
33#define IRC_PING_STRING "PinglBee"
34
[b919363]35#define UMODES "abisw"     /* Allowed umodes (although they mostly do nothing) */
36#define UMODES_PRIV "Ro"   /* Allowed, but not by user directly */
37#define UMODES_KEEP "R"    /* Don't allow unsetting using /MODE */
38#define CMODES "nt"        /* Allowed modes */
39#define CMODE "t"          /* Default mode */
40#define UMODE "s"          /* Default mode */
41
42#define CTYPES "&#"        /* Valid channel name prefixes */
[b7d3cc34]43
44typedef enum
45{
[bd9b00f]46        USTATUS_OFFLINE = 0,
[79e826a]47        USTATUS_AUTHORIZED = 1,
48        USTATUS_LOGGED_IN = 2,
49        USTATUS_IDENTIFIED = 4,
50        USTATUS_SHUTDOWN = 8
[b7d3cc34]51} irc_status_t;
52
[3ddb7477]53struct irc_user;
54
[b7d3cc34]55typedef struct irc
56{
57        int fd;
58        irc_status_t status;
59        double last_pong;
60        int pinging;
61        char *sendbuffer;
62        char *readbuffer;
[f9756bd]63        GIConv iconv, oconv;
[b7d3cc34]64
[3ddb7477]65        struct irc_user *root;
66        struct irc_user *user;
[74f1cde]67       
[92c8d41]68        char *last_root_cmd; /* Either the nickname from which the last root
69                                msg came, or the last channel root was talked
70                                to. */
[b7d3cc34]71
[a199d33]72        char *password; /* HACK: Used to save the user's password, but before
73                           logging in, this may contain a password we should
74                           send to identify after USER/NICK are received. */
[b7d3cc34]75
76        char umode[8];
77       
78        struct query *queries;
[2c2df7d]79        GSList *file_transfers;
[b7d3cc34]80       
[4be8239]81        GSList *users, *channels;
[fd45e1d1]82        struct irc_channel *default_channel;
[3ddb7477]83        GHashTable *nick_user_hash;
[92c8d41]84        GHashTable *watches; /* See irc_cmd_watch() */
[b7d3cc34]85
86        gint r_watch_source_id;
87        gint w_watch_source_id;
88        gint ping_source_id;
[3ddb7477]89       
90        struct bee *b;
[b7d3cc34]91} irc_t;
92
[74f1cde]93typedef enum
94{
[92c8d41]95        /* Replaced with iu->last_channel IRC_USER_PRIVATE = 1, */
[eb50495]96        IRC_USER_AWAY = 2,
[74f1cde]97} irc_user_flags_t;
98
[3ddb7477]99typedef struct irc_user
100{
[b95932e]101        irc_t *irc;
102       
[3ddb7477]103        char *nick;
104        char *user;
105        char *host;
106        char *fullname;
107       
108        /* Nickname in lowercase for case sensitive searches */
109        char *key;
110       
[74f1cde]111        irc_user_flags_t flags;
[92c8d41]112        struct irc_channel *last_channel;
[3ddb7477]113       
[1c8e5f7]114        GString *pastebuf; /* Paste buffer (combine lines into a multiline msg). */
[619dd18]115        guint pastebuf_timer;
[1c8e5f7]116        time_t away_reply_timeout; /* Only send a 301 if this time passed. */
[3ddb7477]117       
[d860a8d]118        struct bee_user *bu;
[280c56a]119       
120        const struct irc_user_funcs *f;
[3ddb7477]121} irc_user_t;
122
[280c56a]123struct irc_user_funcs
124{
125        gboolean (*privmsg)( irc_user_t *iu, const char *msg );
[24b8bbb]126        gboolean (*ctcp)( irc_user_t *iu, char * const* ctcp );
[280c56a]127};
128
129extern const struct irc_user_funcs irc_user_root_funcs;
130extern const struct irc_user_funcs irc_user_self_funcs;
131
[4be8239]132typedef enum
133{
[1c40aa7]134        IRC_CHANNEL_JOINED = 1, /* The user is currently in the channel. */
135        IRC_CHANNEL_TEMP = 2,   /* Erase the channel when the user leaves,
136                                   and don't save it. */
[eb37735]137       
138        /* Hack: Set this flag right before jumping into IM when we expect
139           a call to imcb_chat_new(). */
140        IRC_CHANNEL_CHAT_PICKME = 0x10000,
[4be8239]141} irc_channel_flags_t;
142
143typedef struct irc_channel
144{
145        irc_t *irc;
146        char *name;
[280c56a]147        char mode[8];
148        int flags;
149       
[4be8239]150        char *topic;
[83e92bf]151        char *topic_who;
152        time_t topic_time;
[280c56a]153       
[1c8e5f7]154        GSList *users; /* struct irc_channel_user */
[4be8239]155        struct set *set;
[280c56a]156       
[1c8e5f7]157        GString *pastebuf; /* Paste buffer (combine lines into a multiline msg). */
[619dd18]158        guint pastebuf_timer;
159       
[280c56a]160        const struct irc_channel_funcs *f;
[aea8b68]161        void *data;
[4be8239]162} irc_channel_t;
163
[280c56a]164struct irc_channel_funcs
165{
[a87754b]166        gboolean (*privmsg)( irc_channel_t *ic, const char *msg );
[bfb99ee]167        gboolean (*join)( irc_channel_t *ic );
168        gboolean (*part)( irc_channel_t *ic, const char *msg );
169        gboolean (*topic)( irc_channel_t *ic, const char *new );
[66b9e36a]170        gboolean (*invite)( irc_channel_t *ic, irc_user_t *iu );
[9ac3ed1]171       
172        gboolean (*_init)( irc_channel_t *ic );
173        gboolean (*_free)( irc_channel_t *ic );
[280c56a]174};
175
[e54112f]176typedef enum
177{
178        IRC_CHANNEL_USER_OP = 1,
179        IRC_CHANNEL_USER_HALFOP = 2,
180        IRC_CHANNEL_USER_VOICE = 4,
181} irc_channel_user_flags_t;
182
183typedef struct irc_channel_user
184{
185        irc_user_t *iu;
186        int flags;
187} irc_channel_user_t;
188
[9ac3ed1]189typedef enum
190{
191        IRC_CC_TYPE_DEFAULT,
192        IRC_CC_TYPE_REST,
193        IRC_CC_TYPE_GROUP,
194        IRC_CC_TYPE_ACCOUNT,
195} irc_control_channel_type_t;
196
197struct irc_control_channel
198{
199        irc_control_channel_type_t type;
200        struct bee_group *group;
[a067771]201        struct account *account;
[9ac3ed1]202};
203
[d860a8d]204extern const struct bee_ui_funcs irc_ui_funcs;
205
[3ddb7477]206/* irc.c */
[b7d3cc34]207extern GSList *irc_connection_list;
208
209irc_t *irc_new( int fd );
[a9ca7dd]210void irc_abort( irc_t *irc, int immed, char *format, ... ) G_GNUC_PRINTF( 3, 4 );
[b7d3cc34]211void irc_free( irc_t *irc );
[1f92a58]212void irc_setpass (irc_t *irc, const char *pass);
[b7d3cc34]213
[f73b969]214void irc_process( irc_t *irc );
[0431ea1]215char **irc_parse_line( char *line );
[74c119d]216char *irc_build_line( char **cmd );
[b7d3cc34]217
[a9ca7dd]218void irc_write( irc_t *irc, char *format, ... ) G_GNUC_PRINTF( 2, 3 );
219void irc_write_all( int now, char *format, ... ) G_GNUC_PRINTF( 2, 3 );
[3ddb7477]220void irc_vawrite( irc_t *irc, char *format, va_list params );
[b7d3cc34]221
[edf9657]222int irc_check_login( irc_t *irc );
[3ddb7477]223
[b919363]224void irc_umode_set( irc_t *irc, const char *s, gboolean allow_priv );
225
[4be8239]226/* irc_channel.c */
227irc_channel_t *irc_channel_new( irc_t *irc, const char *name );
[b9e020a]228irc_channel_t *irc_channel_by_name( irc_t *irc, const char *name );
[36562b0]229irc_channel_t *irc_channel_get( irc_t *irc, char *id );
[83e92bf]230int irc_channel_free( irc_channel_t *ic );
[ab6006c]231void irc_channel_free_soon( irc_channel_t *ic );
[4be8239]232int irc_channel_add_user( irc_channel_t *ic, irc_user_t *iu );
[18da20b]233int irc_channel_del_user( irc_channel_t *ic, irc_user_t *iu, gboolean silent, const char *msg );
[e54112f]234irc_channel_user_t *irc_channel_has_user( irc_channel_t *ic, irc_user_t *iu );
[83e92bf]235int irc_channel_set_topic( irc_channel_t *ic, const char *topic, const irc_user_t *who );
[6a9d068]236void irc_channel_user_set_mode( irc_channel_t *ic, irc_user_t *iu, irc_channel_user_flags_t flags );
[9893da3]237void irc_channel_printf( irc_channel_t *ic, char *format, ... );
[b919363]238gboolean irc_channel_name_ok( const char *name );
[134a02c]239void irc_channel_name_strip( char *name );
[6b90431]240int irc_channel_name_cmp( const char *a_, const char *b_ );
[c5aefa4]241void irc_channel_update_ops( irc_channel_t *ic, char *value );
242char *set_eval_irc_channel_ops( struct set *set, char *value );
[4be8239]243
[3ddb7477]244/* irc_commands.c */
245void irc_exec( irc_t *irc, char **cmd );
246
247/* irc_send.c */
248void irc_send_num( irc_t *irc, int code, char *format, ... ) G_GNUC_PRINTF( 3, 4 );
249void irc_send_login( irc_t *irc );
250void irc_send_motd( irc_t *irc );
[4be8239]251void irc_usermsg( irc_t *irc, char *format, ... );
252void irc_send_join( irc_channel_t *ic, irc_user_t *iu );
253void irc_send_part( irc_channel_t *ic, irc_user_t *iu, const char *reason );
[1f0224c]254void irc_send_quit( irc_user_t *iu, const char *reason );
[4be8239]255void irc_send_names( irc_channel_t *ic );
[83e92bf]256void irc_send_topic( irc_channel_t *ic, gboolean topic_change );
[b95932e]257void irc_send_whois( irc_user_t *iu );
[2f53ada]258void irc_send_who( irc_t *irc, GSList *l, const char *channel );
[6761a40]259void irc_send_msg( irc_user_t *iu, const char *type, const char *dst, const char *msg, const char *prefix );
260void irc_send_msg_raw( irc_user_t *iu, const char *type, const char *dst, const char *msg );
[7b59872]261void irc_send_msg_f( irc_user_t *iu, const char *type, const char *dst, const char *format, ... ) G_GNUC_PRINTF( 4, 5 );
[0b5cc72]262void irc_send_nick( irc_user_t *iu, const char *new );
[6a9d068]263void irc_send_channel_user_mode_diff( irc_channel_t *ic, irc_user_t *iu,
264                                      irc_channel_user_flags_t old, irc_channel_user_flags_t new );
[3ddb7477]265
266/* irc_user.c */
267irc_user_t *irc_user_new( irc_t *irc, const char *nick );
[eabc9d2]268int irc_user_free( irc_t *irc, irc_user_t *iu );
[280c56a]269irc_user_t *irc_user_by_name( irc_t *irc, const char *nick );
[57c96f7]270int irc_user_set_nick( irc_user_t *iu, const char *new );
[ebaebfe]271gint irc_user_cmp( gconstpointer a_, gconstpointer b_ );
[003a12b]272const char *irc_user_get_away( irc_user_t *iu );
[b7d3cc34]273
[21c87a7]274/* irc_util.c */
275char *set_eval_timezone( struct set *set, char *value );
276char *irc_format_timestamp( irc_t *irc, time_t msg_ts );
[b7d3cc34]277
[13c1a9f]278/* irc_im.c */
279void bee_irc_channel_update( irc_t *irc, irc_channel_t *ic, irc_user_t *iu );
280
[b7d3cc34]281#endif
Note: See TracBrowser for help on using the repository browser.