include/channel.h

   1 /*
   2  *  ircd-ratbox: A slightly useful ircd.
   3  *  channel.h: The ircd channel header.
   4  *
   5  *  Copyright (C) 1990 Jarkko Oikarinen and University of Oulu, Co Center
   6  *  Copyright (C) 1996-2002 Hybrid Development Team
   7  *  Copyright (C) 2002-2004 ircd-ratbox development team
   8  *
   9  *  This program is free software; you can redistribute it and/or modify
  10  *  it under the terms of the GNU General Public License as published by
  11  *  the Free Software Foundation; either version 2 of the License, or
  12  *  (at your option) any later version.
  13  *
  14  *  This program is distributed in the hope that it will be useful,
  15  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  *  GNU General Public License for more details.
  18  *
  19  *  You should have received a copy of the GNU General Public License
  20  *  along with this program; if not, write to the Free Software
  21  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307
  22  *  USA
  23  *
  24  *  $Id: channel.h 3580 2007-11-07 23:45:14Z jilles $
  25  */
  26
  27 #ifndef INCLUDED_channel_h
  28 #define INCLUDED_channel_h
  29
  30 #define MODEBUFLEN      200
  31
  32 /* Maximum mode changes allowed per client, per server is different */
  33 #define MAXMODEPARAMS   4
  34 #define MAXMODEPARAMSSERV 10
  35
  36 struct Client;
  37
  38 /* mode structure for channels */
  39 struct Mode
  40 {
  41         unsigned int mode;
  42         int limit;
  43         char key[KEYLEN];
  44         unsigned int join_num;
  45         unsigned int join_time;
  46         char forward[LOC_CHANNELLEN + 1];
  47 };
  48
  49 /* channel structure */
  50 struct Channel
  51 {
  52         rb_dlink_node node;
  53         struct Mode mode;
  54         char *mode_lock;
  55         char *topic;
  56         char *topic_info;
  57         time_t topic_time;
  58         time_t last_knock;      /* don't allow knock to flood */
  59
  60         rb_dlink_list members;  /* channel members */
  61         rb_dlink_list locmembers;       /* local channel members */
  62
  63         rb_dlink_list invites;
  64         rb_dlink_list banlist;
  65         rb_dlink_list exceptlist;
  66         rb_dlink_list invexlist;
  67         rb_dlink_list quietlist;
  68
  69         time_t first_received_message_time;     /* channel flood control */
  70         int received_number_of_privmsgs;
  71         int flood_noticed;
  72
  73         unsigned int join_count;  /* joins within delta */
  74         unsigned int join_delta;  /* last ts of join */
  75
  76         unsigned long bants;
  77         time_t channelts;
  78         char *chname;
  79
  80         struct Client *last_checked_client;
  81         time_t last_checked_ts;
  82         unsigned int last_checked_type;
  83         int last_checked_result;
  84 };
  85
  86 struct membership
  87 {
  88         rb_dlink_node channode;
  89         rb_dlink_node locchannode;
  90         rb_dlink_node usernode;
  91
  92         struct Channel *chptr;
  93         struct Client *client_p;
  94         unsigned int flags;
  95
  96         unsigned long bants;
  97 };
  98
  99 #define BANLEN 195
 100 struct Ban
 101 {
 102         char *banstr;
 103         char *who;
 104         time_t when;
 105         char *forward;
 106         rb_dlink_node node;
 107 };
 108
 109 struct mode_letter
 110 {
 111         int mode;
 112         char letter;
 113 };
 114
 115 struct ChModeChange
 116 {
 117         char letter;
 118         const char *arg;
 119         const char *id;
 120         int dir;
 121         int mems;
 122 };
 123
 124 typedef void (*ChannelModeFunc)(struct Client *source_p, struct Channel *chptr,
 125                 int alevel, int parc, int *parn,
 126                 const char **parv, int *errors, int dir, char c, long mode_type);
 127
 128 struct ChannelMode
 129 {
 130         ChannelModeFunc set_func;
 131         long mode_type;
 132 };
 133
 134 typedef int (*ExtbanFunc)(const char *data, struct Client *client_p,
 135                 struct Channel *chptr, long mode_type);
 136
 137 /* can_send results */
 138 #define CAN_SEND_NO     0
 139 #define CAN_SEND_NONOP  1
 140 #define CAN_SEND_OPV    2
 141
 142 /* channel status flags */
 143 #define CHFL_PEON               0x0000  /* normal member of channel */
 144 #define CHFL_VOICE              0x0001  /* the power to speak */
 145 #define CHFL_CHANOP             0x0002  /* Channel operator */
 146
 147 #define CHFL_BANNED             0x0008  /* cached as banned */
 148 #define CHFL_QUIETED            0x0010  /* cached as being +q victim */
 149 #define ONLY_SERVERS            0x0020
 150 #define ALL_MEMBERS             CHFL_PEON
 151 #define ONLY_CHANOPS            CHFL_CHANOP
 152 #define ONLY_CHANOPSVOICED      (CHFL_CHANOP|CHFL_VOICE)
 153
 154 #define is_chanop(x)    ((x) && (x)->flags & CHFL_CHANOP)
 155 #define is_voiced(x)    ((x) && (x)->flags & CHFL_VOICE)
 156 #define is_chanop_voiced(x) ((x) && (x)->flags & (CHFL_CHANOP|CHFL_VOICE))
 157 #define can_send_banned(x) ((x) && (x)->flags & (CHFL_BANNED|CHFL_QUIETED))
 158
 159 /* channel modes ONLY */
 160 #define MODE_PRIVATE    0x0001
 161 #define MODE_SECRET     0x0002
 162 #define MODE_MODERATED  0x0004
 163 #define MODE_TOPICLIMIT 0x0008
 164 #define MODE_INVITEONLY 0x0010
 165 #define MODE_NOPRIVMSGS 0x0020
 166 #define MODE_REGONLY    0x0040
 167 #define MODE_EXLIMIT    0x0100  /* exempt from list limits, +b/+e/+I/+q */
 168 #define MODE_PERMANENT  0x0200  /* permanant channel, +P */
 169 #define MODE_OPMODERATE 0x0400  /* send rejected messages to ops */
 170 #define MODE_FREEINVITE 0x0800  /* allow free use of /invite */
 171 #define MODE_FREETARGET 0x1000  /* can be forwarded to without authorization */
 172 #define MODE_DISFORWARD 0x2000  /* disable channel forwarding */
 173
 174 #define CHFL_BAN        0x10000000      /* ban channel flag */
 175 #define CHFL_EXCEPTION  0x20000000      /* exception to ban channel flag */
 176 #define CHFL_INVEX      0x40000000
 177 #define CHFL_QUIET      0x80000000
 178
 179 /* mode flags for direction indication */
 180 #define MODE_QUERY     0
 181 #define MODE_ADD       1
 182 #define MODE_DEL       -1
 183
 184 #define SecretChannel(x)        ((x) && ((x)->mode.mode & MODE_SECRET))
 185 #define HiddenChannel(x)        ((x) && ((x)->mode.mode & MODE_PRIVATE))
 186 #define PubChannel(x)           ((!x) || ((x)->mode.mode &\
 187                                  (MODE_PRIVATE | MODE_SECRET)) == 0)
 188
 189 /* channel visible */
 190 #define ShowChannel(v,c)        (PubChannel(c) || IsMember((v),(c)))
 191
 192 #define IsMember(who, chan) ((who && who->user && \
 193                 find_channel_membership(chan, who)) ? 1 : 0)
 194
 195 #define IsChannelName(name) ((name) && (*(name) == '#' || *(name) == '&'))
 196
 197 /* extban function results */
 198 #define EXTBAN_INVALID -1  /* invalid mask, false even if negated */
 199 #define EXTBAN_NOMATCH  0  /* valid mask, no match */
 200 #define EXTBAN_MATCH    1  /* matches */
 201
 202 extern rb_dlink_list global_channel_list;
 203 void init_channels(void);
 204
 205 struct Channel *allocate_channel(const char *chname);
 206 void free_channel(struct Channel *chptr);
 207 struct Ban *allocate_ban(const char *, const char *, const char *);
 208 void free_ban(struct Ban *bptr);
 209
 210
 211 extern void destroy_channel(struct Channel *);
 212
 213 extern int can_send(struct Channel *chptr, struct Client *who,
 214                     struct membership *);
 215 extern int flood_attack_channel(int p_or_n, struct Client *source_p,
 216                                 struct Channel *chptr, char *chname);
 217 extern int is_banned(struct Channel *chptr, struct Client *who,
 218                     struct membership *msptr, const char *, const char *, const char **);
 219 extern int is_quieted(struct Channel *chptr, struct Client *who,
 220                      struct membership *msptr, const char *, const char *);
 221 extern int can_join(struct Client *source_p, struct Channel *chptr,
 222                     const char *key, const char **forward);
 223
 224 extern struct membership *find_channel_membership(struct Channel *, struct Client *);
 225 extern const char *find_channel_status(struct membership *msptr, int combine);
 226 extern void add_user_to_channel(struct Channel *, struct Client *, int flags);
 227 extern void remove_user_from_channel(struct membership *);
 228 extern void remove_user_from_channels(struct Client *);
 229 extern void invalidate_bancache_user(struct Client *);
 230
 231 extern void free_channel_list(rb_dlink_list *);
 232
 233 extern int check_channel_name(const char *name);
 234
 235 extern void channel_member_names(struct Channel *chptr, struct Client *,
 236                                  int show_eon);
 237
 238 extern void del_invite(struct Channel *chptr, struct Client *who);
 239
 240 const char *channel_modes(struct Channel *chptr, struct Client *who);
 241
 242 extern struct Channel *find_bannickchange_channel(struct Client *client_p);
 243
 244 extern void check_spambot_warning(struct Client *source_p, const char *name);
 245
 246 extern void check_splitmode(void *);
 247
 248 void set_channel_topic(struct Channel *chptr, const char *topic,
 249                        const char *topic_info, time_t topicts);
 250
 251 extern void init_chcap_usage_counts(void);
 252 extern void set_chcap_usage_counts(struct Client *serv_p);
 253 extern void unset_chcap_usage_counts(struct Client *serv_p);
 254 extern void send_cap_mode_changes(struct Client *client_p, struct Client *source_p,
 255                                   struct Channel *chptr, struct ChModeChange foo[], int);
 256
 257 void resv_chan_forcepart(const char *name, const char *reason, int temp_time);
 258
 259 extern void set_channel_mode(struct Client *client_p, struct Client *source_p,
 260                 struct Channel *chptr, struct membership *msptr, int parc, const char *parv[]);
 261 extern void set_channel_mlock(struct Client *client_p, struct Client *source_p,
 262                 struct Channel *chptr, const char *newmlock, int propagate);
 263
 264 extern struct ChannelMode chmode_table[256];
 265
 266 extern int add_id(struct Client *source_p, struct Channel *chptr, const char *banid,
 267         const char *forward, rb_dlink_list * list, long mode_type);
 268
 269 extern struct Ban * del_id(struct Channel *chptr, const char *banid, rb_dlink_list * list,
 270         long mode_type);
 271
 272 extern ExtbanFunc extban_table[256];
 273
 274 extern int match_extban(const char *banstr, struct Client *client_p, struct Channel *chptr, long mode_type);
 275 extern int valid_extban(const char *banstr, struct Client *client_p, struct Channel *chptr, long mode_type);
 276 const char * get_extban_string(void);
 277
 278 extern int get_channel_access(struct Client *source_p, struct membership *msptr, int dir);
 279
 280 extern void send_channel_join(struct Channel *chptr, struct Client *client_p);
 281
 282 #endif /* INCLUDED_channel_h */