include/gline.h

   1 #ifndef INCLUDED_gline_h
   2 #define INCLUDED_gline_h
   3 /*
   4  * IRC - Internet Relay Chat, include/gline.h
   5  * Copyright (C) 1990 Jarkko Oikarinen and
   6  *                    University of Oulu, Computing Center
   7  * Copyright (C) 1996 -1997 Carlo Wood
   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, or (at your option)
  12  * 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., 675 Mass Ave, Cambridge, MA 02139, USA.
  22  */
  23 /** @file
  24  * @brief Structures and APIs for G-line manipulation.
  25  * @version $Id$
  26  */
  27 #ifndef INCLUDED_sys_types_h
  28 #include <sys/types.h>
  29 #define INCLUDED_sys_types_h
  30 #endif
  31
  32 #ifndef INCLUDED_res_h
  33 #include "res.h"
  34 #endif
  35
  36 struct Client;
  37 struct StatDesc;
  38
  39 #define GLINE_MAX_EXPIRE 604800 /**< max expire: 7 days */
  40
  41 /** Description of a G-line. */
  42 struct Gline {
  43   struct Gline *gl_next;      /**< Next G-line in linked list. */
  44   struct Gline**gl_prev_p;    /**< Previous pointer to this G-line. */
  45   char         *gl_user;      /**< Username mask (or channel/realname mask). */
  46   char         *gl_host;      /**< Host prtion of mask. */
  47   char         *gl_reason;    /**< Reason for G-line. */
  48   time_t        gl_expire;    /**< Expiration timestamp. */
  49   time_t        gl_lastmod;   /**< Last modification timestamp. */
  50   struct irc_in_addr gl_addr; /**< IP address (for IP-based G-lines). */
  51   unsigned char gl_bits;      /**< Usable bits in gl_addr. */
  52   unsigned int  gl_flags;     /**< G-line status flags. */
  53 };
  54
  55 #define GLINE_ACTIVE    0x0001  /**< G-line is active. */
  56 #define GLINE_IPMASK    0x0002  /**< gl_addr and gl_bits fields are valid. */
  57 #define GLINE_BADCHAN   0x0004  /**< G-line prohibits users from joining a channel. */
  58 #define GLINE_LOCAL     0x0008  /**< G-line only applies to this server. */
  59 #define GLINE_ANY       0x0010  /**< Search flag: Find any G-line. */
  60 #define GLINE_FORCE     0x0020  /**< Override normal limits on G-lines. */
  61 #define GLINE_EXACT     0x0040  /**< Exact match only (no wildcards). */
  62 #define GLINE_LDEACT    0x0080  /**< Locally deactivated. */
  63 #define GLINE_GLOBAL    0x0100  /**< Find only global G-lines. */
  64 #define GLINE_LASTMOD   0x0200  /**< Find only G-lines with non-zero lastmod. */
  65 #define GLINE_OPERFORCE 0x0400  /**< Oper forcing G-line to be set. */
  66 #define GLINE_REALNAME  0x0800  /**< G-line matches only the realname field. */
  67
  68 /** Controllable flags that can be set on an actual G-line. */
  69 #define GLINE_MASK      (GLINE_ACTIVE | GLINE_BADCHAN | GLINE_LOCAL | GLINE_REALNAME)
  70 /** Mask for G-line activity flags. */
  71 #define GLINE_ACTMASK   (GLINE_ACTIVE | GLINE_LDEACT)
  72
  73 /** Test whether \a g is active. */
  74 #define GlineIsActive(g)        (((g)->gl_flags & GLINE_ACTMASK) == \
  75                                  GLINE_ACTIVE)
  76 /** Test whether \a g is remotely (globally) active. */
  77 #define GlineIsRemActive(g)     ((g)->gl_flags & GLINE_ACTIVE)
  78 /** Test whether \a g is an IP-based G-line. */
  79 #define GlineIsIpMask(g)        ((g)->gl_flags & GLINE_IPMASK)
  80 /** Test whether \a g is a realname-based G-line. */
  81 #define GlineIsRealName(g)      ((g)->gl_flags & GLINE_REALNAME)
  82 /** Test whether \a g is a BADCHAN. */
  83 #define GlineIsBadChan(g)       ((g)->gl_flags & GLINE_BADCHAN)
  84 /** Test whether \a g is local to this server. */
  85 #define GlineIsLocal(g)         ((g)->gl_flags & GLINE_LOCAL)
  86
  87 /** Return user mask of a G-line. */
  88 #define GlineUser(g)            ((g)->gl_user)
  89 /** Return host mask of a G-line. */
  90 #define GlineHost(g)            ((g)->gl_host)
  91 /** Return reason/message of a G-line. */
  92 #define GlineReason(g)          ((g)->gl_reason)
  93 /** Return last modification time of a G-line. */
  94 #define GlineLastMod(g)         ((g)->gl_lastmod)
  95
  96 extern int gline_propagate(struct Client *cptr, struct Client *sptr,
  97                            struct Gline *gline);
  98 extern int gline_add(struct Client *cptr, struct Client *sptr, char *userhost,
  99                      char *reason, time_t expire, time_t lastmod,
 100                      unsigned int flags);
 101 extern int gline_activate(struct Client *cptr, struct Client *sptr,
 102                           struct Gline *gline, time_t lastmod,
 103                           unsigned int flags);
 104 extern int gline_deactivate(struct Client *cptr, struct Client *sptr,
 105                             struct Gline *gline, time_t lastmod,
 106                             unsigned int flags);
 107 extern struct Gline *gline_find(char *userhost, unsigned int flags);
 108 extern struct Gline *gline_lookup(struct Client *cptr, unsigned int flags);
 109 extern void gline_free(struct Gline *gline);
 110 extern void gline_burst(struct Client *cptr);
 111 extern int gline_resend(struct Client *cptr, struct Gline *gline);
 112 extern int gline_list(struct Client *sptr, char *userhost);
 113 extern void gline_stats(struct Client *sptr, const struct StatDesc *sd,
 114                         char *param);
 115 extern int gline_memory_count(size_t *gl_size);
 116
 117 #endif /* INCLUDED_gline_h */