include/whowas.h

   1 /*
   2  *  ircd-ratbox: A slightly useful ircd.
   3  *  whowas.h: Header for the whowas functions.
   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: whowas.h 1717 2006-07-04 14:41:11Z jilles $
  25  */
  26 #ifndef INCLUDED_whowas_h
  27 #define INCLUDED_whowas_h
  28
  29 #include "ircd_defs.h"
  30 #include "client.h"
  31
  32 #include "setup.h"
  33
  34 /*
  35  * Whowas hash table size
  36  *
  37  */
  38 #define WW_MAX_BITS 16
  39 #define WW_MAX 65536
  40
  41 struct User;
  42 struct Client;
  43
  44 /*
  45   lets speed this up...
  46   also removed away information. *tough*
  47   - Dianora
  48  */
  49 struct Whowas
  50 {
  51         int hashv;
  52         char name[NICKLEN + 1];
  53         char username[USERLEN + 1];
  54         char hostname[HOSTLEN + 1];
  55         char sockhost[HOSTIPLEN + 1];
  56         char realname[REALLEN + 1];
  57         char suser[NICKLEN + 1];
  58         unsigned char flags;
  59         const char *servername;
  60         time_t logoff;
  61         struct Client *online;  /* Pointer to new nickname for chasing or NULL */
  62         struct Whowas *next;    /* for hash table... */
  63         struct Whowas *prev;    /* for hash table... */
  64         struct Whowas *cnext;   /* for client struct linked list */
  65         struct Whowas *cprev;   /* for client struct linked list */
  66 };
  67
  68 /* Flags */
  69 #define WHOWAS_IP_SPOOFING      0x1
  70 #define WHOWAS_DYNSPOOF         0x2
  71
  72 /*
  73 ** initwhowas
  74 */
  75 extern void initwhowas(void);
  76
  77 /*
  78 ** add_history
  79 **      Add the currently defined name of the client to history.
  80 **      usually called before changing to a new name (nick).
  81 **      Client must be a fully registered user (specifically,
  82 **      the user structure must have been allocated).
  83 */
  84 void add_history(struct Client *, int);
  85
  86 /*
  87 ** off_history
  88 **      This must be called when the client structure is about to
  89 **      be released. History mechanism keeps pointers to client
  90 **      structures and it must know when they cease to exist. This
  91 **      also implicitly calls AddHistory.
  92 */
  93 void off_history(struct Client *);
  94
  95 /*
  96 ** get_history
  97 **      Return the current client that was using the given
  98 **      nickname within the timelimit. Returns NULL, if no
  99 **      one found...
 100 */
 101 struct Client *get_history(const char *, time_t);
 102                                         /* Nick name */
 103                                         /* Time limit in seconds */
 104
 105 /*
 106 ** for debugging...counts related structures stored in whowas array.
 107 */
 108 void count_whowas_memory(size_t *, size_t *);
 109
 110 /* XXX m_whowas.c in modules needs these */
 111 extern struct Whowas WHOWAS[];
 112 extern struct Whowas *WHOWASHASH[];
 113 extern unsigned int hash_whowas_name(const char *name);
 114
 115 #endif /* INCLUDED_whowas_h */