* 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., 675 Mass Ave, Cambridge, MA 02139, USA.
- *
- * $Id$
*/
-#ifndef INCLUDED_config_h
-#include "config.h"
-#endif
+/** @file
+ * @brief Structures and APIs for G-line manipulation.
+ * @version $Id$
+ */
#ifndef INCLUDED_sys_types_h
#include <sys/types.h>
#define INCLUDED_sys_types_h
#endif
+#ifndef INCLUDED_res_h
+#include "res.h"
+#endif
struct Client;
+struct StatDesc;
-#define GLINE_MAX_EXPIRE 604800 /* max expire: 7 days */
+#define GLINE_MAX_EXPIRE 604800 /**< max expire: 7 days */
+/** Local state of a G-line. */
+enum GlineLocalState {
+ GLOCAL_GLOBAL, /**< G-line state unmodified locally. */
+ GLOCAL_ACTIVATED, /**< G-line state locally activated. */
+ GLOCAL_DEACTIVATED /**< G-line state locally deactivated. */
+};
+
+/** Description of a G-line. */
struct Gline {
- struct Gline *gl_next;
- struct Gline**gl_prev_p;
- char *gl_user;
- char *gl_host;
- char *gl_reason;
- time_t gl_expire;
- time_t gl_lastmod;
- unsigned int gl_flags;
+ struct Gline *gl_next; /**< Next G-line in linked list. */
+ struct Gline**gl_prev_p; /**< Previous pointer to this G-line. */
+ char *gl_user; /**< Username mask (or channel/realname mask). */
+ char *gl_host; /**< Host prtion of mask. */
+ char *gl_reason; /**< Reason for G-line. */
+ time_t gl_expire; /**< Expiration timestamp. */
+ time_t gl_lastmod; /**< Last modification timestamp. */
+ time_t gl_lifetime; /**< Record expiration timestamp. */
+ struct irc_in_addr gl_addr; /**< IP address (for IP-based G-lines). */
+ unsigned char gl_bits; /**< Usable bits in gl_addr. */
+ unsigned int gl_flags; /**< G-line status flags. */
+ enum GlineLocalState gl_state;/**< G-line local state. */
+};
+
+/** Action to perform on a G-line. */
+enum GlineAction {
+ GLINE_ACTIVATE, /**< G-line should be activated. */
+ GLINE_DEACTIVATE, /**< G-line should be deactivated. */
+ GLINE_LOCAL_ACTIVATE, /**< G-line should be locally activated. */
+ GLINE_LOCAL_DEACTIVATE, /**< G-line should be locally deactivated. */
+ GLINE_MODIFY /**< G-line should be modified. */
};
-#define GLINE_ACTIVE 0x0001
-#define GLINE_IPMASK 0x0002
-#define GLINE_BADCHAN 0x0004
-#define GLINE_LOCAL 0x0008
-#define GLINE_ANY 0x0010
-#define GLINE_FORCE 0x0020
+#define GLINE_ACTIVE 0x0001 /**< G-line is active. */
+#define GLINE_IPMASK 0x0002 /**< gl_addr and gl_bits fields are valid. */
+#define GLINE_BADCHAN 0x0004 /**< G-line prohibits users from joining a channel. */
+#define GLINE_LOCAL 0x0008 /**< G-line only applies to this server. */
+#define GLINE_ANY 0x0010 /**< Search flag: Find any G-line. */
+#define GLINE_FORCE 0x0020 /**< Override normal limits on G-lines. */
+#define GLINE_EXACT 0x0040 /**< Exact match only (no wildcards). */
+#define GLINE_LDEACT 0x0080 /**< Locally deactivated. */
+#define GLINE_GLOBAL 0x0100 /**< Find only global G-lines. */
+#define GLINE_LASTMOD 0x0200 /**< Find only G-lines with non-zero lastmod. */
+#define GLINE_OPERFORCE 0x0400 /**< Oper forcing G-line to be set. */
+#define GLINE_REALNAME 0x0800 /**< G-line matches only the realname field. */
-#define GLINE_MASK (GLINE_ACTIVE | GLINE_BADCHAN | GLINE_LOCAL)
+#define GLINE_EXPIRE 0x1000 /**< Expiration time update */
+#define GLINE_LIFETIME 0x2000 /**< Record lifetime update */
+#define GLINE_REASON 0x4000 /**< Reason update */
-#define GlineIsActive(g) ((g)->gl_flags & GLINE_ACTIVE)
+/** Controllable flags that can be set on an actual G-line. */
+#define GLINE_MASK (GLINE_ACTIVE | GLINE_BADCHAN | GLINE_LOCAL | GLINE_REALNAME)
+/** Mask for G-line activity flags. */
+#define GLINE_ACTMASK (GLINE_ACTIVE | GLINE_LDEACT)
+
+/** Mask for G-line update flags. */
+#define GLINE_UPDATE (GLINE_EXPIRE | GLINE_LIFETIME | GLINE_REASON)
+
+/** Test whether \a g is active. */
+#define GlineIsActive(g) ((((g)->gl_flags & GLINE_ACTIVE) && \
+ (g)->gl_state != GLOCAL_DEACTIVATED) || \
+ (g)->gl_state == GLOCAL_ACTIVATED)
+/** Test whether \a g is remotely (globally) active. */
+#define GlineIsRemActive(g) ((g)->gl_flags & GLINE_ACTIVE)
+/** Test whether \a g is an IP-based G-line. */
#define GlineIsIpMask(g) ((g)->gl_flags & GLINE_IPMASK)
+/** Test whether \a g is a realname-based G-line. */
+#define GlineIsRealName(g) ((g)->gl_flags & GLINE_REALNAME)
+/** Test whether \a g is a BADCHAN. */
#define GlineIsBadChan(g) ((g)->gl_flags & GLINE_BADCHAN)
+/** Test whether \a g is local to this server. */
#define GlineIsLocal(g) ((g)->gl_flags & GLINE_LOCAL)
+/** Return user mask of a G-line. */
#define GlineUser(g) ((g)->gl_user)
+/** Return host mask of a G-line. */
#define GlineHost(g) ((g)->gl_host)
+/** Return reason/message of a G-line. */
#define GlineReason(g) ((g)->gl_reason)
+/** Return last modification time of a G-line. */
#define GlineLastMod(g) ((g)->gl_lastmod)
extern int gline_add(struct Client *cptr, struct Client *sptr, char *userhost,
char *reason, time_t expire, time_t lastmod,
- unsigned int flags);
+ time_t lifetime, unsigned int flags);
extern int gline_activate(struct Client *cptr, struct Client *sptr,
- struct Gline *gline, time_t lastmod);
+ struct Gline *gline, time_t lastmod,
+ unsigned int flags);
extern int gline_deactivate(struct Client *cptr, struct Client *sptr,
- struct Gline *gline, time_t lastmod);
-extern struct Gline *gline_find(char *userhost);
-extern struct Gline *gline_lookup(struct Client *cptr);
+ struct Gline *gline, time_t lastmod,
+ unsigned int flags);
+extern int gline_modify(struct Client *cptr, struct Client *sptr,
+ struct Gline *gline, enum GlineAction action,
+ char *reason, time_t expire, time_t lastmod,
+ time_t lifetime, unsigned int flags);
+extern int gline_destroy(struct Client *cptr, struct Client *sptr,
+ struct Gline *gline);
+extern struct Gline *gline_find(char *userhost, unsigned int flags);
+extern struct Gline *gline_lookup(struct Client *cptr, unsigned int flags);
extern void gline_free(struct Gline *gline);
extern void gline_burst(struct Client *cptr);
extern int gline_resend(struct Client *cptr, struct Gline *gline);
extern int gline_list(struct Client *sptr, char *userhost);
-extern void gline_stats(struct Client *sptr);
-
-#ifdef 0 /* forget it! */
-#define SetActive(g) ((g)->gl_flags |= GLINE_ACTIVE)
-#define ClearActive(g) ((g)->gl_flags &= ~GLINE_ACTIVE)
-#define SetGlineIsIpMask(g) ((g)->gl_flags |= GLINE_IPMASK)
-#define SetGlineIsLocal(g) ((g)->gl_flags |= GLINE_LOCAL)
-
-extern struct Gline* GlobalGlineList;
-extern struct Gline* BadChanGlineList;
-
-extern void gline_remove_expired(time_t now);
-
-extern void add_gline(struct Client *sptr, int ip_mask,
- char *host, char *comment, char *user,
- time_t expire, int local);
-extern struct Gline* make_gline(int is_ipmask, char *host, char *reason,
- char *name, time_t expire);
-extern struct Gline* find_gline(struct Client *cptr, struct Gline **pgline);
-extern void free_gline(struct Gline *gline, struct Gline *prev);
-
-#ifdef BADCHAN
-extern int bad_channel(const char* name);
-extern void bad_channel_remove_expired(time_t now);
-#endif
-#endif /* 0 */
+extern void gline_stats(struct Client *sptr, const struct StatDesc *sd,
+ char *param);
+extern int gline_memory_count(size_t *gl_size);
#endif /* INCLUDED_gline_h */
projects / ircu2.10.12-pk.git / blobdiff