[solanum.git] / include / channel.h

/*
 *  ircd-ratbox: A slightly useful ircd.
 *  channel.h: The ircd channel header.
 *
 *  Copyright (C) 1990 Jarkko Oikarinen and University of Oulu, Co Center
 *  Copyright (C) 1996-2002 Hybrid Development Team
 *  Copyright (C) 2002-2004 ircd-ratbox development team
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307
 *  USA
 *
 *  $Id: channel.h 3580 2007-11-07 23:45:14Z jilles $
 */

#ifndef INCLUDED_channel_h
#define INCLUDED_channel_h

#define MODEBUFLEN      200

/* Maximum mode changes allowed per client, per server is different */
#define MAXMODEPARAMS   4
#define MAXMODEPARAMSSERV 10

struct Client;

/* mode structure for channels */
struct Mode
{
	unsigned int mode;
	int limit;
	char key[KEYLEN];
	unsigned int join_num;
	unsigned int join_time;
	char forward[LOC_CHANNELLEN + 1];
};

/* channel structure */
struct Channel
{
	rb_dlink_node node;
	struct Mode mode;
	char *mode_lock;
	char *topic;
	char *topic_info;
	time_t topic_time;
	time_t last_knock;	/* don't allow knock to flood */

	rb_dlink_list members;	/* channel members */
	rb_dlink_list locmembers;	/* local channel members */

	rb_dlink_list invites;
	rb_dlink_list banlist;
	rb_dlink_list exceptlist;
	rb_dlink_list invexlist;
	rb_dlink_list quietlist;

	time_t first_received_message_time;	/* channel flood control */
	int received_number_of_privmsgs;
	int flood_noticed;

	unsigned int join_count;  /* joins within delta */
	unsigned int join_delta;  /* last ts of join */

	unsigned long bants;
	time_t channelts;
	char *chname;

	struct Client *last_checked_client;
	time_t last_checked_ts;
	unsigned int last_checked_type;
	int last_checked_result;
};

struct membership
{
	rb_dlink_node channode;
	rb_dlink_node locchannode;
	rb_dlink_node usernode;

	struct Channel *chptr;
	struct Client *client_p;
	unsigned int flags;

	unsigned long bants;
};

#define BANLEN 195
struct Ban
{
	char *banstr;
	char *who;
	time_t when;
	char *forward;
	rb_dlink_node node;
};

struct mode_letter
{
	int mode;
	char letter;
};

struct ChModeChange
{
	char letter;
	const char *arg;
	const char *id;
	int dir;
	int mems;
};

typedef void (*ChannelModeFunc)(struct Client *source_p, struct Channel *chptr,
		int alevel, int parc, int *parn,
		const char **parv, int *errors, int dir, char c, long mode_type);

struct ChannelMode
{
	ChannelModeFunc set_func;
	long mode_type;
};

typedef int (*ExtbanFunc)(const char *data, struct Client *client_p,
		struct Channel *chptr, long mode_type);

/* can_send results */
#define CAN_SEND_NO	0
#define CAN_SEND_NONOP  1
#define CAN_SEND_OPV	2

/* channel status flags */
#define CHFL_PEON		0x0000	/* normal member of channel */
#define CHFL_VOICE      	0x0001	/* the power to speak */
#define CHFL_CHANOP	     	0x0002	/* Channel operator */

#define CHFL_BANNED		0x0008  /* cached as banned */
#define CHFL_QUIETED		0x0010  /* cached as being +q victim */
#define ONLY_SERVERS		0x0020
#define ALL_MEMBERS		CHFL_PEON
#define ONLY_CHANOPS		CHFL_CHANOP
#define ONLY_CHANOPSVOICED	(CHFL_CHANOP|CHFL_VOICE)

#define is_chanop(x)	((x) && (x)->flags & CHFL_CHANOP)
#define is_voiced(x)	((x) && (x)->flags & CHFL_VOICE)
#define is_chanop_voiced(x) ((x) && (x)->flags & (CHFL_CHANOP|CHFL_VOICE))
#define can_send_banned(x) ((x) && (x)->flags & (CHFL_BANNED|CHFL_QUIETED))

/* channel modes ONLY */
#define MODE_PRIVATE    0x0001
#define MODE_SECRET     0x0002
#define MODE_MODERATED  0x0004
#define MODE_TOPICLIMIT 0x0008
#define MODE_INVITEONLY 0x0010
#define MODE_NOPRIVMSGS 0x0020
#define MODE_REGONLY	0x0040
#define MODE_EXLIMIT	0x0100  /* exempt from list limits, +b/+e/+I/+q */
#define MODE_PERMANENT  0x0200  /* permanant channel, +P */
#define MODE_OPMODERATE 0x0400  /* send rejected messages to ops */
#define MODE_FREEINVITE 0x0800  /* allow free use of /invite */
#define MODE_FREETARGET 0x1000  /* can be forwarded to without authorization */
#define MODE_DISFORWARD 0x2000  /* disable channel forwarding */

#define CHFL_BAN        0x10000000	/* ban channel flag */
#define CHFL_EXCEPTION  0x20000000	/* exception to ban channel flag */
#define CHFL_INVEX      0x40000000
#define CHFL_QUIET      0x80000000

/* mode flags for direction indication */
#define MODE_QUERY     0
#define MODE_ADD       1
#define MODE_DEL       -1

#define SecretChannel(x)        ((x) && ((x)->mode.mode & MODE_SECRET))
#define HiddenChannel(x)        ((x) && ((x)->mode.mode & MODE_PRIVATE))
#define PubChannel(x)           ((!x) || ((x)->mode.mode &\
                                 (MODE_PRIVATE | MODE_SECRET)) == 0)

/* channel visible */
#define ShowChannel(v,c)        (PubChannel(c) || IsMember((v),(c)))

#define IsMember(who, chan) ((who && who->user && \
                find_channel_membership(chan, who)) ? 1 : 0)

#define IsChannelName(name) ((name) && (*(name) == '#' || *(name) == '&'))

/* extban function results */
#define EXTBAN_INVALID -1  /* invalid mask, false even if negated */
#define EXTBAN_NOMATCH  0  /* valid mask, no match */
#define EXTBAN_MATCH    1  /* matches */

extern rb_dlink_list global_channel_list;
void init_channels(void);

struct Channel *allocate_channel(const char *chname);
void free_channel(struct Channel *chptr);
struct Ban *allocate_ban(const char *, const char *, const char *);
void free_ban(struct Ban *bptr);


extern void destroy_channel(struct Channel *);

extern int can_send(struct Channel *chptr, struct Client *who,
		    struct membership *);
extern int flood_attack_channel(int p_or_n, struct Client *source_p,
				struct Channel *chptr, char *chname);
extern int is_banned(struct Channel *chptr, struct Client *who,
		    struct membership *msptr, const char *, const char *, const char **);
extern int is_quieted(struct Channel *chptr, struct Client *who,
		     struct membership *msptr, const char *, const char *);
extern int can_join(struct Client *source_p, struct Channel *chptr,
		    const char *key, const char **forward);

extern struct membership *find_channel_membership(struct Channel *, struct Client *);
extern const char *find_channel_status(struct membership *msptr, int combine);
extern void add_user_to_channel(struct Channel *, struct Client *, int flags);
extern void remove_user_from_channel(struct membership *);
extern void remove_user_from_channels(struct Client *);
extern void invalidate_bancache_user(struct Client *);

extern void free_channel_list(rb_dlink_list *);

extern int check_channel_name(const char *name);

extern void channel_member_names(struct Channel *chptr, struct Client *,
				 int show_eon);

extern void del_invite(struct Channel *chptr, struct Client *who);

const char *channel_modes(struct Channel *chptr, struct Client *who);

extern struct Channel *find_bannickchange_channel(struct Client *client_p);

extern void check_spambot_warning(struct Client *source_p, const char *name);

extern void check_splitmode(void *);

void set_channel_topic(struct Channel *chptr, const char *topic,
		       const char *topic_info, time_t topicts);

extern void init_chcap_usage_counts(void);
extern void set_chcap_usage_counts(struct Client *serv_p);
extern void unset_chcap_usage_counts(struct Client *serv_p);
extern void send_cap_mode_changes(struct Client *client_p, struct Client *source_p,
				  struct Channel *chptr, struct ChModeChange foo[], int);

void resv_chan_forcepart(const char *name, const char *reason, int temp_time);

extern void set_channel_mode(struct Client *client_p, struct Client *source_p,
            	struct Channel *chptr, struct membership *msptr, int parc, const char *parv[]);
extern void set_channel_mlock(struct Client *client_p, struct Client *source_p,
            	struct Channel *chptr, const char *newmlock, int propagate);

extern struct ChannelMode chmode_table[256];

extern int add_id(struct Client *source_p, struct Channel *chptr, const char *banid,
	const char *forward, rb_dlink_list * list, long mode_type);

extern struct Ban * del_id(struct Channel *chptr, const char *banid, rb_dlink_list * list,
	long mode_type);

extern ExtbanFunc extban_table[256];

extern int match_extban(const char *banstr, struct Client *client_p, struct Channel *chptr, long mode_type);
extern int valid_extban(const char *banstr, struct Client *client_p, struct Channel *chptr, long mode_type);
const char * get_extban_string(void);

extern int get_channel_access(struct Client *source_p, struct membership *msptr, int dir, const char *modestr);

extern void send_channel_join(struct Channel *chptr, struct Client *client_p);

#endif /* INCLUDED_channel_h */
Commit	Line	Data
212380e3 AC	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	*
83294285	24	* $Id: channel.h 3580 2007-11-07 23:45:14Z jilles $
212380e3 AC	25	*/
	26
	27	#ifndef INCLUDED_channel_h
	28	#define INCLUDED_channel_h
212380e3 AC	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	{
5b96d9a6	52	rb_dlink_node node;
212380e3	53	struct Mode mode;
78e6b731	54	char *mode_lock;
212380e3 AC	55	char *topic;
	56	char *topic_info;
	57	time_t topic_time;
212380e3 AC	58	time_t last_knock; /* don't allow knock to flood */
212380e3 AC	59
5b96d9a6 AC	60	rb_dlink_list members; /* channel members */
5b96d9a6 AC	61	rb_dlink_list locmembers; /* local channel members */
212380e3	62
8aabb973	63	rb_dlink_list invites;
5b96d9a6 AC	64	rb_dlink_list banlist;
	65	rb_dlink_list exceptlist;
	66	rb_dlink_list invexlist;
	67	rb_dlink_list quietlist;
212380e3 AC	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;
2f9687c4 AC	79
	80	struct Client *last_checked_client;
	81	time_t last_checked_ts;
	82	unsigned int last_checked_type;
	83	int last_checked_result;
212380e3 AC	84	};
	85
	86	struct membership
	87	{
5b96d9a6 AC	88	rb_dlink_node channode;
	89	rb_dlink_node locchannode;
	90	rb_dlink_node usernode;
212380e3 AC	91
	92	struct Channel *chptr;
	93	struct Client *client_p;
	94	unsigned int flags;
	95
	96	unsigned long bants;
	97	};
	98
83294285	99	#define BANLEN 195
212380e3 AC	100	struct Ban
	101	{
	102	char *banstr;
	103	char *who;
	104	time_t when;
765d839d	105	char *forward;
5b96d9a6	106	rb_dlink_node node;
212380e3 AC	107	};
212380e3 AC	108
7d1f9131 JT	109	struct mode_letter
	110	{
	111	int mode;
	112	char letter;
	113	};
	114
212380e3 AC	115	struct ChModeChange
	116	{
	117	char letter;
	118	const char *arg;
	119	const char *id;
	120	int dir;
212380e3	121	int mems;
212380e3 AC	122	};
212380e3 AC	123
19716b9f JT	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
212380e3 AC	128	struct ChannelMode
212380e3 AC	129	{
19716b9f	130	ChannelModeFunc set_func;
212380e3 AC	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 */
a0626e7c AC	144	#define CHFL_VOICE 0x0001 /* the power to speak */
	145	#define CHFL_CHANOP 0x0002 /* Channel operator */
	146
212380e3 AC	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))
212380e3 AC	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
212380e3 AC	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
5b96d9a6	202	extern rb_dlink_list global_channel_list;
212380e3 AC	203	void init_channels(void);
	204
	205	struct Channel allocate_channel(const char chname);
	206	void free_channel(struct Channel *chptr);
765d839d	207	struct Ban allocate_ban(const char , const char , const char );
212380e3 AC	208	void free_ban(struct Ban *bptr);
	209
	210
	211	extern void destroy_channel(struct Channel *);
	212
55abcbb2	213	extern int can_send(struct Channel chptr, struct Client who,
212380e3	214	struct membership *);
15484f02 BG	215	extern int flood_attack_channel(int p_or_n, struct Client *source_p,
15484f02 BG	216	struct Channel chptr, char chname);
212380e3	217	extern int is_banned(struct Channel chptr, struct Client who,
765d839d	218	struct membership msptr, const char , const char , const char *);
212380e3 AC	219	extern int is_quieted(struct Channel chptr, struct Client who,
212380e3 AC	220	struct membership msptr, const char , const char *);
fe74401b JT	221	extern int can_join(struct Client source_p, struct Channel chptr,
fe74401b JT	222	const char key, const char *forward);
212380e3 AC	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
5b96d9a6	231	extern void free_channel_list(rb_dlink_list *);
212380e3 AC	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
3b8a6350	240	const char channel_modes(struct Channel chptr, struct Client *who);
212380e3 AC	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
dca9e552 JT	257	void resv_chan_forcepart(const char name, const char reason, int temp_time);
dca9e552 JT	258
212380e3 AC	259	extern void set_channel_mode(struct Client client_p, struct Client source_p,
212380e3 AC	260	struct Channel chptr, struct membership msptr, int parc, const char *parv[]);
8727cbe8	261	extern void set_channel_mlock(struct Client client_p, struct Client source_p,
6fb6bd15	262	struct Channel chptr, const char newmlock, int propagate);
212380e3 AC	263
	264	extern struct ChannelMode chmode_table[256];
	265
	266	extern int add_id(struct Client source_p, struct Channel chptr, const char *banid,
765d839d	267	const char forward, rb_dlink_list list, long mode_type);
212380e3	268
765d839d EM	269	extern struct Ban * del_id(struct Channel chptr, const char banid, rb_dlink_list * list,
765d839d EM	270	long mode_type);
212380e3 AC	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
b870a5f8	278	extern int get_channel_access(struct Client source_p, struct membership msptr, int dir, const char *modestr);
212380e3	279
27912fd4 AC	280	extern void send_channel_join(struct Channel chptr, struct Client client_p);
27912fd4 AC	281
212380e3	282	#endif /* INCLUDED_channel_h */