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 | |
---|
46 | typedef 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 | |
---|
56 | struct irc_user; |
---|
57 | |
---|
58 | typedef 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 | |
---|
95 | typedef enum |
---|
96 | { |
---|
97 | /* Replaced with iu->last_channel IRC_USER_PRIVATE = 1, */ |
---|
98 | IRC_USER_AWAY = 2, |
---|
99 | } irc_user_flags_t; |
---|
100 | |
---|
101 | typedef 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 | |
---|
125 | struct 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 | |
---|
131 | extern const struct irc_user_funcs irc_user_root_funcs; |
---|
132 | extern const struct irc_user_funcs irc_user_self_funcs; |
---|
133 | |
---|
134 | typedef 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 | |
---|
145 | typedef 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 | |
---|
167 | struct 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 | |
---|
179 | typedef 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 | |
---|
187 | typedef struct irc_channel_user |
---|
188 | { |
---|
189 | irc_user_t *iu; |
---|
190 | int flags; |
---|
191 | } irc_channel_user_t; |
---|
192 | |
---|
193 | typedef 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 | |
---|
202 | struct 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 | |
---|
211 | extern const struct bee_ui_funcs irc_ui_funcs; |
---|
212 | |
---|
213 | typedef 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 */ |
---|
221 | extern GSList *irc_connection_list; |
---|
222 | |
---|
223 | irc_t *irc_new( int fd ); |
---|
224 | void irc_abort( irc_t *irc, int immed, char *format, ... ) G_GNUC_PRINTF( 3, 4 ); |
---|
225 | void irc_free( irc_t *irc ); |
---|
226 | void irc_setpass (irc_t *irc, const char *pass); |
---|
227 | |
---|
228 | void irc_process( irc_t *irc ); |
---|
229 | char **irc_parse_line( char *line ); |
---|
230 | char *irc_build_line( char **cmd ); |
---|
231 | |
---|
232 | void irc_write( irc_t *irc, char *format, ... ) G_GNUC_PRINTF( 2, 3 ); |
---|
233 | void irc_write_all( int now, char *format, ... ) G_GNUC_PRINTF( 2, 3 ); |
---|
234 | void irc_vawrite( irc_t *irc, char *format, va_list params ); |
---|
235 | |
---|
236 | void irc_flush( irc_t *irc ); |
---|
237 | void irc_switch_fd( irc_t *irc, int fd ); |
---|
238 | void irc_sync( irc_t *irc ); |
---|
239 | void irc_desync( irc_t *irc ); |
---|
240 | |
---|
241 | int irc_check_login( irc_t *irc ); |
---|
242 | |
---|
243 | void irc_umode_set( irc_t *irc, const char *s, gboolean allow_priv ); |
---|
244 | |
---|
245 | /* irc_channel.c */ |
---|
246 | irc_channel_t *irc_channel_new( irc_t *irc, const char *name ); |
---|
247 | irc_channel_t *irc_channel_by_name( irc_t *irc, const char *name ); |
---|
248 | irc_channel_t *irc_channel_get( irc_t *irc, char *id ); |
---|
249 | int irc_channel_free( irc_channel_t *ic ); |
---|
250 | void irc_channel_free_soon( irc_channel_t *ic ); |
---|
251 | int irc_channel_add_user( irc_channel_t *ic, irc_user_t *iu ); |
---|
252 | int irc_channel_del_user( irc_channel_t *ic, irc_user_t *iu, irc_channel_del_user_type_t type, const char *msg ); |
---|
253 | irc_channel_user_t *irc_channel_has_user( irc_channel_t *ic, irc_user_t *iu ); |
---|
254 | int irc_channel_set_topic( irc_channel_t *ic, const char *topic, const irc_user_t *who ); |
---|
255 | void irc_channel_user_set_mode( irc_channel_t *ic, irc_user_t *iu, irc_channel_user_flags_t flags ); |
---|
256 | void irc_channel_set_mode( irc_channel_t *ic, const char *s ); |
---|
257 | void irc_channel_auto_joins( irc_t *irc, struct account *acc ); |
---|
258 | void irc_channel_printf( irc_channel_t *ic, char *format, ... ); |
---|
259 | gboolean irc_channel_name_ok( const char *name ); |
---|
260 | void irc_channel_name_strip( char *name ); |
---|
261 | int irc_channel_name_cmp( const char *a_, const char *b_ ); |
---|
262 | void irc_channel_update_ops( irc_channel_t *ic, char *value ); |
---|
263 | char *set_eval_irc_channel_ops( struct set *set, char *value ); |
---|
264 | gboolean irc_channel_wants_user( irc_channel_t *ic, irc_user_t *iu ); |
---|
265 | |
---|
266 | /* irc_commands.c */ |
---|
267 | void irc_exec( irc_t *irc, char **cmd ); |
---|
268 | |
---|
269 | /* irc_send.c */ |
---|
270 | void irc_send_num( irc_t *irc, int code, char *format, ... ) G_GNUC_PRINTF( 3, 4 ); |
---|
271 | void irc_send_login( irc_t *irc ); |
---|
272 | void irc_send_motd( irc_t *irc ); |
---|
273 | void irc_usermsg( irc_t *irc, char *format, ... ); |
---|
274 | void irc_send_join( irc_channel_t *ic, irc_user_t *iu ); |
---|
275 | void irc_send_part( irc_channel_t *ic, irc_user_t *iu, const char *reason ); |
---|
276 | void irc_send_quit( irc_user_t *iu, const char *reason ); |
---|
277 | void irc_send_kick( irc_channel_t *ic, irc_user_t *iu, irc_user_t *kicker, const char *reason ); |
---|
278 | void irc_send_names( irc_channel_t *ic ); |
---|
279 | void irc_send_topic( irc_channel_t *ic, gboolean topic_change ); |
---|
280 | void irc_send_whois( irc_user_t *iu ); |
---|
281 | void irc_send_who( irc_t *irc, GSList *l, const char *channel ); |
---|
282 | void irc_send_msg( irc_user_t *iu, const char *type, const char *dst, const char *msg, const char *prefix ); |
---|
283 | void irc_send_msg_raw( irc_user_t *iu, const char *type, const char *dst, const char *msg ); |
---|
284 | void irc_send_msg_f( irc_user_t *iu, const char *type, const char *dst, const char *format, ... ) G_GNUC_PRINTF( 4, 5 ); |
---|
285 | void irc_send_nick( irc_user_t *iu, const char *new ); |
---|
286 | void 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 */ |
---|
290 | irc_user_t *irc_user_new( irc_t *irc, const char *nick ); |
---|
291 | int irc_user_free( irc_t *irc, irc_user_t *iu ); |
---|
292 | irc_user_t *irc_user_by_name( irc_t *irc, const char *nick ); |
---|
293 | int irc_user_set_nick( irc_user_t *iu, const char *new ); |
---|
294 | gint irc_user_cmp( gconstpointer a_, gconstpointer b_ ); |
---|
295 | const char *irc_user_get_away( irc_user_t *iu ); |
---|
296 | void irc_user_quit( irc_user_t *iu, const char *msg ); |
---|
297 | |
---|
298 | /* irc_util.c */ |
---|
299 | char *set_eval_timezone( struct set *set, char *value ); |
---|
300 | char *irc_format_timestamp( irc_t *irc, time_t msg_ts ); |
---|
301 | |
---|
302 | /* irc_im.c */ |
---|
303 | void bee_irc_channel_update( irc_t *irc, irc_channel_t *ic, irc_user_t *iu ); |
---|
304 | |
---|
305 | #endif |
---|