source: irc.h @ 65016a6

Last change on this file since 65016a6 was 65016a6, checked in by Wilmer van der Gaast <wilmer@…>, at 2010-08-04T19:45:18Z

Set channel mode +C for control channels.

  • Property mode set to 100644
File size: 9.4 KB
RevLine 
[b7d3cc34]1  /********************************************************************\
2  * BitlBee -- An IRC to other IM-networks gateway                     *
3  *                                                                    *
[2fe5eb9]4  * Copyright 2002-2010 Wilmer van der Gaast and others                *
[b7d3cc34]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 */
[65016a6]38#define CMODES "ntC"       /* Allowed modes */
[b919363]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,
[f6f5eee]47        USTATUS_AUTHORIZED = 1, /* Gave the correct server password (PASS). */
48        USTATUS_LOGGED_IN = 2,  /* USER+NICK(+PASS) finished. */
49        USTATUS_IDENTIFIED = 4, /* To NickServ (root). */
50        USTATUS_SHUTDOWN = 8,   /* Now used to indicate we're shutting down.
51                                   Currently just blocks irc_vawrite(). */
[b7d3cc34]52} irc_status_t;
53
[3ddb7477]54struct irc_user;
55
[b7d3cc34]56typedef struct irc
57{
58        int fd;
59        irc_status_t status;
60        double last_pong;
61        int pinging;
62        char *sendbuffer;
63        char *readbuffer;
[f9756bd]64        GIConv iconv, oconv;
[b7d3cc34]65
[3ddb7477]66        struct irc_user *root;
67        struct irc_user *user;
[74f1cde]68       
[a199d33]69        char *password; /* HACK: Used to save the user's password, but before
70                           logging in, this may contain a password we should
71                           send to identify after USER/NICK are received. */
[b7d3cc34]72
73        char umode[8];
74       
75        struct query *queries;
[2c2df7d]76        GSList *file_transfers;
[b7d3cc34]77       
[4be8239]78        GSList *users, *channels;
[fd45e1d1]79        struct irc_channel *default_channel;
[3ddb7477]80        GHashTable *nick_user_hash;
[92c8d41]81        GHashTable *watches; /* See irc_cmd_watch() */
[b7d3cc34]82
83        gint r_watch_source_id;
84        gint w_watch_source_id;
85        gint ping_source_id;
[6c2404e]86        gint login_source_id; /* To slightly delay some events at login time. */
[3ddb7477]87       
88        struct bee *b;
[b7d3cc34]89} irc_t;
90
[74f1cde]91typedef enum
92{
[92c8d41]93        /* Replaced with iu->last_channel IRC_USER_PRIVATE = 1, */
[eb50495]94        IRC_USER_AWAY = 2,
[74f1cde]95} irc_user_flags_t;
96
[3ddb7477]97typedef struct irc_user
98{
[b95932e]99        irc_t *irc;
100       
[3ddb7477]101        char *nick;
102        char *user;
103        char *host;
104        char *fullname;
105       
[2fe5eb9]106        /* Nickname in lowercase for case insensitive searches */
[3ddb7477]107        char *key;
108       
[74f1cde]109        irc_user_flags_t flags;
[92c8d41]110        struct irc_channel *last_channel;
[3ddb7477]111       
[1c8e5f7]112        GString *pastebuf; /* Paste buffer (combine lines into a multiline msg). */
[619dd18]113        guint pastebuf_timer;
[1c8e5f7]114        time_t away_reply_timeout; /* Only send a 301 if this time passed. */
[3ddb7477]115       
[d860a8d]116        struct bee_user *bu;
[280c56a]117       
118        const struct irc_user_funcs *f;
[3ddb7477]119} irc_user_t;
120
[280c56a]121struct irc_user_funcs
122{
123        gboolean (*privmsg)( irc_user_t *iu, const char *msg );
[24b8bbb]124        gboolean (*ctcp)( irc_user_t *iu, char * const* ctcp );
[280c56a]125};
126
127extern const struct irc_user_funcs irc_user_root_funcs;
128extern const struct irc_user_funcs irc_user_self_funcs;
129
[4be8239]130typedef enum
131{
[1c40aa7]132        IRC_CHANNEL_JOINED = 1, /* The user is currently in the channel. */
133        IRC_CHANNEL_TEMP = 2,   /* Erase the channel when the user leaves,
134                                   and don't save it. */
[eb37735]135       
136        /* Hack: Set this flag right before jumping into IM when we expect
137           a call to imcb_chat_new(). */
138        IRC_CHANNEL_CHAT_PICKME = 0x10000,
[4be8239]139} irc_channel_flags_t;
140
141typedef struct irc_channel
142{
143        irc_t *irc;
144        char *name;
[280c56a]145        char mode[8];
146        int flags;
147       
[4be8239]148        char *topic;
[83e92bf]149        char *topic_who;
150        time_t topic_time;
[280c56a]151       
[1c8e5f7]152        GSList *users; /* struct irc_channel_user */
[f7ca587]153        struct irc_user *last_target;
[4be8239]154        struct set *set;
[280c56a]155       
[1c8e5f7]156        GString *pastebuf; /* Paste buffer (combine lines into a multiline msg). */
[619dd18]157        guint pastebuf_timer;
158       
[280c56a]159        const struct irc_channel_funcs *f;
[aea8b68]160        void *data;
[4be8239]161} irc_channel_t;
162
[280c56a]163struct irc_channel_funcs
164{
[a87754b]165        gboolean (*privmsg)( irc_channel_t *ic, const char *msg );
[bfb99ee]166        gboolean (*join)( irc_channel_t *ic );
167        gboolean (*part)( irc_channel_t *ic, const char *msg );
168        gboolean (*topic)( irc_channel_t *ic, const char *new );
[66b9e36a]169        gboolean (*invite)( irc_channel_t *ic, irc_user_t *iu );
[9ac3ed1]170       
171        gboolean (*_init)( irc_channel_t *ic );
172        gboolean (*_free)( irc_channel_t *ic );
[280c56a]173};
174
[e54112f]175typedef enum
176{
177        IRC_CHANNEL_USER_OP = 1,
178        IRC_CHANNEL_USER_HALFOP = 2,
179        IRC_CHANNEL_USER_VOICE = 4,
[94d5da9c]180        IRC_CHANNEL_USER_NONE = 8,
[e54112f]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,
[7a6ba50]195        IRC_CC_TYPE_PROTOCOL,
[9ac3ed1]196} irc_control_channel_type_t;
197
198struct irc_control_channel
199{
200        irc_control_channel_type_t type;
201        struct bee_group *group;
[a067771]202        struct account *account;
[7a6ba50]203        struct prpl *protocol;
[94d5da9c]204        char modes[4];
[9ac3ed1]205};
206
[d860a8d]207extern const struct bee_ui_funcs irc_ui_funcs;
208
[006a84f]209typedef enum
210{
211        IRC_CDU_SILENT,
212        IRC_CDU_PART,
213        IRC_CDU_KICK,
214} irc_channel_del_user_type_t;
215
[3ddb7477]216/* irc.c */
[b7d3cc34]217extern GSList *irc_connection_list;
218
219irc_t *irc_new( int fd );
[a9ca7dd]220void irc_abort( irc_t *irc, int immed, char *format, ... ) G_GNUC_PRINTF( 3, 4 );
[b7d3cc34]221void irc_free( irc_t *irc );
[1f92a58]222void irc_setpass (irc_t *irc, const char *pass);
[b7d3cc34]223
[f73b969]224void irc_process( irc_t *irc );
[0431ea1]225char **irc_parse_line( char *line );
[74c119d]226char *irc_build_line( char **cmd );
[b7d3cc34]227
[a9ca7dd]228void irc_write( irc_t *irc, char *format, ... ) G_GNUC_PRINTF( 2, 3 );
229void irc_write_all( int now, char *format, ... ) G_GNUC_PRINTF( 2, 3 );
[3ddb7477]230void irc_vawrite( irc_t *irc, char *format, va_list params );
[b7d3cc34]231
[f1c2b21]232void irc_flush( irc_t *irc );
233void irc_switch_fd( irc_t *irc, int fd );
234void irc_sync( irc_t *irc );
235void irc_desync( irc_t *irc );
236
[edf9657]237int irc_check_login( irc_t *irc );
[3ddb7477]238
[b919363]239void irc_umode_set( irc_t *irc, const char *s, gboolean allow_priv );
240
[4be8239]241/* irc_channel.c */
242irc_channel_t *irc_channel_new( irc_t *irc, const char *name );
[b9e020a]243irc_channel_t *irc_channel_by_name( irc_t *irc, const char *name );
[36562b0]244irc_channel_t *irc_channel_get( irc_t *irc, char *id );
[83e92bf]245int irc_channel_free( irc_channel_t *ic );
[ab6006c]246void irc_channel_free_soon( irc_channel_t *ic );
[4be8239]247int irc_channel_add_user( irc_channel_t *ic, irc_user_t *iu );
[006a84f]248int irc_channel_del_user( irc_channel_t *ic, irc_user_t *iu, irc_channel_del_user_type_t type, const char *msg );
[e54112f]249irc_channel_user_t *irc_channel_has_user( irc_channel_t *ic, irc_user_t *iu );
[83e92bf]250int irc_channel_set_topic( irc_channel_t *ic, const char *topic, const irc_user_t *who );
[6a9d068]251void irc_channel_user_set_mode( irc_channel_t *ic, irc_user_t *iu, irc_channel_user_flags_t flags );
[65016a6]252void irc_channel_set_mode( irc_channel_t *ic, const char *s );
[c8eeadd]253void irc_channel_auto_joins( irc_t *irc, struct account *acc );
[9893da3]254void irc_channel_printf( irc_channel_t *ic, char *format, ... );
[b919363]255gboolean irc_channel_name_ok( const char *name );
[134a02c]256void irc_channel_name_strip( char *name );
[6b90431]257int irc_channel_name_cmp( const char *a_, const char *b_ );
[c5aefa4]258void irc_channel_update_ops( irc_channel_t *ic, char *value );
259char *set_eval_irc_channel_ops( struct set *set, char *value );
[4be8239]260
[3ddb7477]261/* irc_commands.c */
262void irc_exec( irc_t *irc, char **cmd );
263
264/* irc_send.c */
265void irc_send_num( irc_t *irc, int code, char *format, ... ) G_GNUC_PRINTF( 3, 4 );
266void irc_send_login( irc_t *irc );
267void irc_send_motd( irc_t *irc );
[4be8239]268void irc_usermsg( irc_t *irc, char *format, ... );
269void irc_send_join( irc_channel_t *ic, irc_user_t *iu );
270void irc_send_part( irc_channel_t *ic, irc_user_t *iu, const char *reason );
[1f0224c]271void irc_send_quit( irc_user_t *iu, const char *reason );
[006a84f]272void irc_send_kick( irc_channel_t *ic, irc_user_t *iu, irc_user_t *kicker, const char *reason );
[4be8239]273void irc_send_names( irc_channel_t *ic );
[83e92bf]274void irc_send_topic( irc_channel_t *ic, gboolean topic_change );
[b95932e]275void irc_send_whois( irc_user_t *iu );
[2f53ada]276void irc_send_who( irc_t *irc, GSList *l, const char *channel );
[6761a40]277void irc_send_msg( irc_user_t *iu, const char *type, const char *dst, const char *msg, const char *prefix );
278void irc_send_msg_raw( irc_user_t *iu, const char *type, const char *dst, const char *msg );
[7b59872]279void irc_send_msg_f( irc_user_t *iu, const char *type, const char *dst, const char *format, ... ) G_GNUC_PRINTF( 4, 5 );
[0b5cc72]280void irc_send_nick( irc_user_t *iu, const char *new );
[6a9d068]281void irc_send_channel_user_mode_diff( irc_channel_t *ic, irc_user_t *iu,
282                                      irc_channel_user_flags_t old, irc_channel_user_flags_t new );
[3ddb7477]283
284/* irc_user.c */
285irc_user_t *irc_user_new( irc_t *irc, const char *nick );
[eabc9d2]286int irc_user_free( irc_t *irc, irc_user_t *iu );
[280c56a]287irc_user_t *irc_user_by_name( irc_t *irc, const char *nick );
[57c96f7]288int irc_user_set_nick( irc_user_t *iu, const char *new );
[ebaebfe]289gint irc_user_cmp( gconstpointer a_, gconstpointer b_ );
[003a12b]290const char *irc_user_get_away( irc_user_t *iu );
[0bd948e]291void irc_user_quit( irc_user_t *iu, const char *msg );
[b7d3cc34]292
[21c87a7]293/* irc_util.c */
294char *set_eval_timezone( struct set *set, char *value );
295char *irc_format_timestamp( irc_t *irc, time_t msg_ts );
[b7d3cc34]296
[13c1a9f]297/* irc_im.c */
298void bee_irc_channel_update( irc_t *irc, irc_channel_t *ic, irc_user_t *iu );
299
[b7d3cc34]300#endif
Note: See TracBrowser for help on using the repository browser.